执行通道队列

普通 session 默认不启用队列。Lane queue 是显式的高级基础设施，独立于 task 和自动 subagent 委派。

不要把这层可选分发设施与始终启用的 Agent 级任务调度器混淆。任务调度器内部使用 a3s-lane 优先级队列，在不同 Session 之间共享本地执行容量；Lane queue 则把选中的工作交给本地、外部或混合 handler。

只有需要外部 worker、混合本地/远程执行、队列指标、死信或多机器分发时才启用 lane queue。

TypeScript

const session = agent.session('/repo', {
  queueConfig: {
    enableDlq: true,
    enableMetrics: true,
  },
});

await session.setLaneHandler('execute', {
  mode: 'external',
  timeoutMs: 300000,
});

lane 名称是 control、query、execute 和 generate。

外部 worker 完成任务时调用：

TypeScript

const pending = await session.pendingExternalTasks();

if (pending.length > 0) {
  await session.completeExternalTask(pending[0].id, {
    success: true,
    result: { summary: 'worker completed the task' },
  });
}

普通本地 agent session 不需要引入队列。

#执行通道队列

执行通道队列