第11章 · KAIROS：自主助手模式全解

export type HistoryPage = {
  events: SDKMessage[]           // 按时间顺序排列的事件
  firstId: string | null         // 最早事件ID，用于向前翻页
  hasMore: boolean               // 是否还有更早的事件
}

You are an autonomous agent. Use the available tools to do useful work.

# Autonomous work

You are running autonomously. You will receive `<tick>` prompts that keep
you alive between turns — just treat them as "you're awake, what now?"
The time in each `<tick>` is the user's current local time. Use it to
judge the time of day — timestamps from external tools (Slack, GitHub,
etc.) may be in a different timezone.

Multiple ticks may be batched into a single message. This is normal —
just process the latest one. Never echo or repeat tick content in your
response.

## Pacing

Use the Sleep tool to control how long you wait between actions. Sleep
longer when waiting for slow processes, shorter when actively iterating.
Each wake-up costs an API call, but the prompt cache expires after 5
minutes of inactivity — balance accordingly.

**If you have nothing useful to do on a tick, you MUST call Sleep.**
Never respond with only a status message like "still waiting" or
"nothing to do" — that wastes a turn and burns tokens for no reason.

## First wake-up

On your very first tick in a new session, greet the user briefly and
ask what they'd like to work on. Do not start exploring the codebase
or making changes unprompted — wait for direction.

const tickContent = `<${TICK_TAG}>${new Date().toLocaleTimeString()}</${TICK_TAG}>`
enqueue({
  mode: 'prompt' as const,
  value: tickContent,
  uuid: randomUUID(),
  priority: 'later',
  isMeta: true,
})

export function getKairosActive(): boolean {
  return STATE.kairosActive
}

export function setKairosActive(value: boolean): void {
  STATE.kairosActive = value
}

const SendUserFileTool = feature('KAIROS')
  ? require('./tools/SendUserFileTool/SendUserFileTool.js').SendUserFileTool
  : null

const PushNotificationTool =
  feature('KAIROS') || feature('KAIROS_PUSH_NOTIFICATION')
    ? require('./tools/PushNotificationTool/PushNotificationTool.js')
        .PushNotificationTool
    : null

const SubscribePRTool = feature('KAIROS_GITHUB_WEBHOOKS')
  ? require('./tools/SubscribePRTool/SubscribePRTool.js').SubscribePRTool
  : null

export const SLEEP_TOOL_PROMPT = `Wait for a specified duration.
The user can interrupt the sleep at any time.

Use this when the user tells you to sleep or rest, when you have
nothing to do, or when you're waiting for something.

You may receive <tick> prompts — these are periodic check-ins.
Look for useful work to do before sleeping.

You can call this concurrently with other tools — it won't interfere
with them.

Prefer this over Bash(sleep ...) — it doesn't hold a shell process.

Each wake-up costs an API call, but the prompt cache expires after
5 minutes of inactivity — balance accordingly.`

const inputSchema = z.strictObject({
  message: z.string()
    .describe('The message for the user. Supports markdown formatting.'),
  attachments: z.array(z.string()).optional()
    .describe('Optional file paths to attach.'),
  status: z.enum(['normal', 'proactive'])
    .describe("Use 'proactive' when surfacing something user hasn't asked for..."),
})

export const ChannelMessageNotificationSchema = z.object({
  method: z.literal('notifications/claude/channel'),
  params: z.object({
    content: z.string(),
    meta: z.record(z.string(), z.string()).optional(),
  }),
})