CherryHQ/cherry-studio · error · Error

Channel not found

Error message

Channel not found: ${channelId}

What it means

Thrown by AgentJobsService.assertChannelsBelongToAgent when a referenced channel either does not exist (agentChannelService.getChannel returns falsy) or exists but its agentId does not match the expected agent. Each iteration of the channel list is checked; the first invalid channel throws. Like the agent-not-found guard, this is a plain Error because no renderer branch needs a specific not-found code.

Solutions

1. Confirm each channelId exists and belongs to the target agent before submitting (refresh the channel list for that agent).
2. Remove or rebind triggers/schedules that reference deleted or reassigned channels.
3. Invalidate UI-cached channel references when a channel is deleted or reassigned.
4. Validate the channel list against the agent's current channels at form-submit time.

// Confirm each channel exists and belongs to the agent before submitting
for (const id of channelIds) {
  const ch = agentChannelService.getChannel(id)
  if (!ch || ch.agentId !== agentId) {
    throw new Error(`Channel '${id}' is missing or belongs to a different agent`)
  }
}

const channelBelongsToAgent = (channelId: string, agentId: string): boolean => {
  const ch = agentChannelService.getChannel(channelId)
  return !!ch && ch.agentId === agentId
}

When it happens

Trigger: Submitting a schedule/trigger that references a channelId which was deleted, never existed, or was reassigned to a different agent. The check is channel && channel.agentId === agentId, so a channel belonging to another agent also fails.

Common situations: Channel deleted while triggers still reference it; cross-agent contamination (channelId copied from a different agent's config); reassigning a channel to a new agent without updating existing triggers; stale channelId cached in the UI.

Related errors

• Agent not found
• Unsupported agent runtime type
• Agent storage path escapes its root
• Agent storage path parent is not a directory
• Agent storage root must be a real directory

AI-assisted analysis of CherryHQ/cherry-studio@726446b54c (2026-08-12). Data as JSON: /api/errors/fa31a1e63a2916c3. Report an issue: GitHub.

Appendix: source

Thrown at src/main/ai/agents/AgentJobsService.ts:277

    if (bound) agentTaskService.notifyReadModelChange([params.scheduleId])
    return bound
  }

  // Plain Errors on purpose: no renderer branch consumes an agent/channel
  // not-found code (the message reaches the toast through INTERNAL either
  // way), so no AI-domain IpcError code is minted for them — unlike trigger
  // validation, where the form must branch on the code.
  private assertAgentExists(agentId: string): void {
    if (!agentService.getAgent(agentId)) {
      throw new Error(`Agent not found: ${agentId}`)
    }
  }

  private assertChannelsBelongToAgent(agentId: string, channelIds: readonly string[]): void {
    for (const channelId of channelIds) {
      const channel = agentChannelService.getChannel(channelId)
      if (!channel || channel.agentId !== agentId) {
        throw new Error(`Channel not found: ${channelId}`)
      }
    }
  }
}

View on GitHub (pinned to 726446b54c)