@parlor/chat 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { Author, AuthorOf, ChatItemBody, ChatItemKind, HostItemDraft, HostI
 export { type AppliedFrame, applyFrame } from "./open-turns.js";
 export { isPromptTooLong, MAX_PROMPT_CHARS, PROMPT_LIMIT_MESSAGE } from "./limits.js";
 export type { AgentInfo, AgentOption, AgentOptionValue, AgentRef, AgentUsage, AgentUsageWindow, AnswerToSign, ChatOwner, ChatSnapshot, ClaimedDevice, ClaimedTurn, HostSummary, OpenItem, OpenTurn, PromptToSign, ThreadHistory, ThreadList, ThreadPage, ThreadSummary, TurnFailure, TurnOutcome, TurnSignals, TurnState, TurnStatus, } from "./model.js";
-export { CHAT_CHANNEL, CHAT_PLUGIN, type ChatFrame, HOST_PROTOCOL, type HostFrame, type HostHello, type HostStreamBatch, type HostWelcome, parseChatFrame, type ProtocolRange, type StreamingKind, } from "./protocol.js";
-export { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG } from "./tags.js";
+export { CHAT_CHANNEL, CHAT_PLUGIN, type ChatFrame, HOST_PROTOCOL, type HostFrame, type HostHello, type HostStreamBatch, type HostWelcome, parseChatFrame, PUSHED_TURNS_PROTOCOL, type PushedTurn, type ProtocolRange, type StreamingKind, } from "./protocol.js";
+export { CHAT_ACTIVITY_TAG, CHAT_AGENTS_CHECK_TAG, CHAT_TAG, HOSTS_TAG } from "./tags.js";
 export { type AskState, type ChatItem, type FoldedKind, type FoldInput, foldThread, type ItemFolders, type ThreadConfirmation, } from "./view.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EACV,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,SAAS,EACd,aAAa,EACb,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,SAAS,EACd,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EACV,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,SAAS,EACd,aAAa,EACb,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,cAAc,EACd,qBAAqB,EACrB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,SAAS,EACd,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 export { CHAT_EVENTS } from "./events.js";
 export { applyFrame } from "./open-turns.js";
 export { isPromptTooLong, MAX_PROMPT_CHARS, PROMPT_LIMIT_MESSAGE } from "./limits.js";
-export { CHAT_CHANNEL, CHAT_PLUGIN, HOST_PROTOCOL, parseChatFrame, } from "./protocol.js";
-export { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG } from "./tags.js";
+export { CHAT_CHANNEL, CHAT_PLUGIN, HOST_PROTOCOL, parseChatFrame, PUSHED_TURNS_PROTOCOL, } from "./protocol.js";
+export { CHAT_ACTIVITY_TAG, CHAT_AGENTS_CHECK_TAG, CHAT_TAG, HOSTS_TAG } from "./tags.js";
 export { foldThread, } from "./view.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAY1D,OAAO,EAAqB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA2BtF,OAAO,EACL,YAAY,EACZ,WAAW,EAEX,aAAa,EAKb,cAAc,GAGf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAKL,UAAU,GAGX,MAAM,WAAW,CAAC","sourcesContent":["export { CHAT_EVENTS, type ChatEvent } from \"./events.js\";\nexport type {\n  Author,\n  AuthorOf,\n  ChatItemBody,\n  ChatItemKind,\n  HostItemDraft,\n  HostItemKind,\n  ItemSignature,\n  LoggedItem,\n  UserItemKind,\n} from \"./items.js\";\nexport { type AppliedFrame, applyFrame } from \"./open-turns.js\";\nexport { isPromptTooLong, MAX_PROMPT_CHARS, PROMPT_LIMIT_MESSAGE } from \"./limits.js\";\nexport type {\n  AgentInfo,\n  AgentOption,\n  AgentOptionValue,\n  AgentRef,\n  AgentUsage,\n  AgentUsageWindow,\n  AnswerToSign,\n  ChatOwner,\n  ChatSnapshot,\n  ClaimedDevice,\n  ClaimedTurn,\n  HostSummary,\n  OpenItem,\n  OpenTurn,\n  PromptToSign,\n  ThreadHistory,\n  ThreadList,\n  ThreadPage,\n  ThreadSummary,\n  TurnFailure,\n  TurnOutcome,\n  TurnSignals,\n  TurnState,\n  TurnStatus,\n} from \"./model.js\";\nexport {\n  CHAT_CHANNEL,\n  CHAT_PLUGIN,\n  type ChatFrame,\n  HOST_PROTOCOL,\n  type HostFrame,\n  type HostHello,\n  type HostStreamBatch,\n  type HostWelcome,\n  parseChatFrame,\n  type ProtocolRange,\n  type StreamingKind,\n} from \"./protocol.js\";\nexport { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG } from \"./tags.js\";\nexport {\n  type AskState,\n  type ChatItem,\n  type FoldedKind,\n  type FoldInput,\n  foldThread,\n  type ItemFolders,\n  type ThreadConfirmation,\n} from \"./view.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAY1D,OAAO,EAAqB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA2BtF,OAAO,EACL,YAAY,EACZ,WAAW,EAEX,aAAa,EAKb,cAAc,EACd,qBAAqB,GAItB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EAKL,UAAU,GAGX,MAAM,WAAW,CAAC","sourcesContent":["export { CHAT_EVENTS, type ChatEvent } from \"./events.js\";\nexport type {\n  Author,\n  AuthorOf,\n  ChatItemBody,\n  ChatItemKind,\n  HostItemDraft,\n  HostItemKind,\n  ItemSignature,\n  LoggedItem,\n  UserItemKind,\n} from \"./items.js\";\nexport { type AppliedFrame, applyFrame } from \"./open-turns.js\";\nexport { isPromptTooLong, MAX_PROMPT_CHARS, PROMPT_LIMIT_MESSAGE } from \"./limits.js\";\nexport type {\n  AgentInfo,\n  AgentOption,\n  AgentOptionValue,\n  AgentRef,\n  AgentUsage,\n  AgentUsageWindow,\n  AnswerToSign,\n  ChatOwner,\n  ChatSnapshot,\n  ClaimedDevice,\n  ClaimedTurn,\n  HostSummary,\n  OpenItem,\n  OpenTurn,\n  PromptToSign,\n  ThreadHistory,\n  ThreadList,\n  ThreadPage,\n  ThreadSummary,\n  TurnFailure,\n  TurnOutcome,\n  TurnSignals,\n  TurnState,\n  TurnStatus,\n} from \"./model.js\";\nexport {\n  CHAT_CHANNEL,\n  CHAT_PLUGIN,\n  type ChatFrame,\n  HOST_PROTOCOL,\n  type HostFrame,\n  type HostHello,\n  type HostStreamBatch,\n  type HostWelcome,\n  parseChatFrame,\n  PUSHED_TURNS_PROTOCOL,\n  type PushedTurn,\n  type ProtocolRange,\n  type StreamingKind,\n} from \"./protocol.js\";\nexport { CHAT_ACTIVITY_TAG, CHAT_AGENTS_CHECK_TAG, CHAT_TAG, HOSTS_TAG } from \"./tags.js\";\nexport {\n  type AskState,\n  type ChatItem,\n  type FoldedKind,\n  type FoldInput,\n  foldThread,\n  type ItemFolders,\n  type ThreadConfirmation,\n} from \"./view.js\";\n"]}

package/dist/model.d.ts

@@ -27,6 +27,11 @@ export interface HostSummary {
      * (epoch ms); a device it never asks is missing.
      */
     readonly presenceDue?: Readonly<Record<string, number>> | undefined;
+    /**
+     * When this computer last looked for the agents installed on it, by the server's clock;
+     * absent on a computer too old to look again when asked.
+     */
+    readonly agentsCheckedAt?: number | undefined;
 }
 export interface AgentInfo {
     readonly id: string;

package/dist/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}

package/dist/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"","sourcesContent":["import type { HostId, ItemId, ThreadId, TurnId, UserId } from \"@parlor/core\";\nimport type { Delegation, DeviceKeys } from \"@parlor/server\";\n\nimport type { ChatItemBody, LoggedItem, UserItemKind } from \"./items.js\";\n\nexport interface AgentRef {\n  readonly hostId: HostId;\n  /** A profile id on that host (`claude`, `codex`), not an entity. */\n  readonly agentId: string;\n}\n\n/**\n * Whose chat a row is. Every thread, turn and host row carries both and every chat query\n * filters by both, so members of one organization scope never see each other's chats.\n */\nexport interface ChatOwner {\n  readonly scope: string;\n  readonly userId: UserId;\n}\n\nexport interface HostSummary {\n  readonly id: HostId;\n  readonly name: string;\n  readonly platform: string;\n  readonly online: boolean;\n  readonly agents: readonly AgentInfo[];\n  /** The devices this computer runs prompts from; absent when it is too old to say. */\n  readonly devices?: readonly string[] | undefined;\n  /**\n   * When each of those devices must sign its next prompt with Face ID or Touch ID again\n   * (epoch ms); a device it never asks is missing.\n   */\n  readonly presenceDue?: Readonly<Record<string, number>> | undefined;\n}\n\nexport interface AgentInfo {\n  readonly id: string;\n  readonly name: string;\n  readonly version?: string | undefined;\n  readonly ready: boolean;\n  /** Why a not-ready agent cannot run yet (\"run `claude` to log in\"). */\n  readonly problem?: string | undefined;\n  /** What a prompt may choose for its turn, as the agent last offered it; absent until it has. */\n  readonly options?: readonly AgentOption[] | undefined;\n  /** The account's allowance, as the agent last reported it; absent until it has. */\n  readonly usage?: AgentUsage | undefined;\n  /**\n   * The name this agent knows the app by outside the sidebar, when the user let it use the\n   * app there: \"use coursekit to ...\" in Claude Code.\n   */\n  readonly outsideName?: string | undefined;\n}\n\n/**\n * One setting a prompt may choose, such as the model or how hard it thinks. Never the\n * permission mode: that is the computer's to set.\n */\nexport interface AgentOption {\n  readonly id: string;\n  readonly name: string;\n  /** `model` and `thought_level` as the agent tags them; any other the agent names. */\n  readonly category?: string | undefined;\n  /** The agent's own default, the value a prompt that chooses nothing runs with. */\n  readonly current: string;\n  readonly values: readonly AgentOptionValue[];\n}\n\nexport interface AgentOptionValue {\n  readonly id: string;\n  readonly name: string;\n  readonly description?: string | undefined;\n}\n\nexport interface AgentUsage {\n  /** Account-wide windows first, each set shortest first. */\n  readonly windows: readonly AgentUsageWindow[];\n  /** When the agent reported it (epoch ms). */\n  readonly at: number;\n}\n\nexport interface AgentUsageWindow {\n  /** The vendor's name for it: `five_hour`, `seven_day`, `seven_day_opus`. */\n  readonly id: string;\n  readonly minutes: number;\n  /** Share of the window used, 0 to 1. */\n  readonly used: number;\n  /** When the window rolls over (epoch ms). */\n  readonly resetsAt?: number | undefined;\n}\n\nexport interface ThreadSummary {\n  readonly id: ThreadId;\n  readonly title: string;\n  readonly agent: AgentRef | undefined;\n  readonly updatedAt: number;\n  readonly lastSeq: number;\n}\n\nexport type TurnState = \"queued\" | \"running\" | \"done\" | \"failed\" | \"cancelled\";\n\nexport type TurnFailure =\n  | \"agent_exited\"\n  | \"agent_unavailable\"\n  | \"device_rejected\"\n  | \"signature_invalid\"\n  | \"prompt_expired\"\n  | \"host_lost\";\n\nexport type TurnOutcome =\n  | { readonly state: \"done\"; readonly stopReason: string }\n  | { readonly state: \"cancelled\" }\n  | { readonly state: \"failed\"; readonly reason: TurnFailure };\n\n/** Still being produced: only in memory, on the instance the host posts to. */\nexport type OpenItem =\n  | { readonly id: ItemId; readonly kind: \"reply\" | \"reasoning\"; readonly text: string }\n  | {\n      readonly id: ItemId;\n      readonly kind: \"tool\";\n      readonly title: string;\n      readonly status: \"pending\" | \"running\";\n    }\n  | {\n      readonly id: ItemId;\n      readonly kind: \"plan\";\n      readonly entries: ChatItemBody<\"plan\">[\"entries\"];\n    };\n\nexport interface OpenTurn {\n  readonly turnId: TurnId;\n  readonly threadId: ThreadId;\n  readonly items: readonly OpenItem[];\n}\n\nexport interface TurnStatus {\n  readonly turnId: TurnId;\n  readonly state: TurnState;\n  readonly agent: AgentRef;\n  readonly failure?: TurnFailure | undefined;\n}\n\nexport interface ThreadPage {\n  readonly thread: ThreadSummary | undefined;\n  readonly items: readonly LoggedItem[];\n  readonly open: readonly OpenTurn[];\n  readonly turns: readonly TurnStatus[];\n  readonly hasMore: boolean;\n}\n\nexport interface ChatSnapshot {\n  readonly threads: readonly ThreadSummary[];\n  /** `threads` was cut at its limit; `threadsBefore` reads on from its last one. */\n  readonly moreThreads?: boolean | undefined;\n  readonly hosts: readonly HostSummary[];\n  readonly page: ThreadPage;\n}\n\n/** What `history` returns: earlier items of a thread, oldest first, with their turns. */\nexport interface ThreadHistory {\n  readonly items: readonly LoggedItem[];\n  readonly turns: readonly TurnStatus[];\n  readonly hasMore: boolean;\n}\n\n/** What `threadsBefore` returns: the next older threads, newest first. */\nexport interface ThreadList {\n  readonly threads: readonly ThreadSummary[];\n  readonly hasMore: boolean;\n}\n\n/** The device's keys as the account has them; the host compares them with its own pins. */\nexport type ClaimedDevice = DeviceKeys;\n\nexport interface ClaimedTurn {\n  /** The thread id; every chat write returns it as `id`, which becomes its sync tag. */\n  readonly id: ThreadId;\n  readonly turnId: TurnId;\n  readonly agent: AgentRef;\n  /** The client the prompt came from; the turn token binds `ui_*` to it. */\n  readonly clientId: string;\n  readonly prompt: LoggedItem<\"prompt\">;\n  readonly device: ClaimedDevice | undefined;\n  /** The `<parlor-context>` block for a fresh agent session. */\n  readonly context: string;\n  readonly token: Delegation;\n  readonly leaseUntil: number;\n}\n\nexport interface TurnSignals {\n  readonly turnId: TurnId;\n  readonly items: readonly LoggedItem<Exclude<UserItemKind, \"prompt\">>[];\n  /** The keys of each device that answered, as the account lists them; revoked ones are left out. */\n  readonly devices?: readonly DeviceKeys[];\n}\n\n/** What a device signs for a prompt; the host rebuilds the same statement from the item. */\nexport interface PromptToSign {\n  readonly threadId: ThreadId;\n  readonly turnId: TurnId;\n  readonly agent: AgentRef;\n  readonly text: string;\n}\n\nexport interface AnswerToSign {\n  readonly threadId: ThreadId;\n  readonly askId: ItemId;\n  readonly choice: string;\n  readonly values?: ChatItemBody<\"answer\">[\"values\"];\n}\n"]}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"","sourcesContent":["import type { HostId, ItemId, ThreadId, TurnId, UserId } from \"@parlor/core\";\nimport type { Delegation, DeviceKeys } from \"@parlor/server\";\n\nimport type { ChatItemBody, LoggedItem, UserItemKind } from \"./items.js\";\n\nexport interface AgentRef {\n  readonly hostId: HostId;\n  /** A profile id on that host (`claude`, `codex`), not an entity. */\n  readonly agentId: string;\n}\n\n/**\n * Whose chat a row is. Every thread, turn and host row carries both and every chat query\n * filters by both, so members of one organization scope never see each other's chats.\n */\nexport interface ChatOwner {\n  readonly scope: string;\n  readonly userId: UserId;\n}\n\nexport interface HostSummary {\n  readonly id: HostId;\n  readonly name: string;\n  readonly platform: string;\n  readonly online: boolean;\n  readonly agents: readonly AgentInfo[];\n  /** The devices this computer runs prompts from; absent when it is too old to say. */\n  readonly devices?: readonly string[] | undefined;\n  /**\n   * When each of those devices must sign its next prompt with Face ID or Touch ID again\n   * (epoch ms); a device it never asks is missing.\n   */\n  readonly presenceDue?: Readonly<Record<string, number>> | undefined;\n  /**\n   * When this computer last looked for the agents installed on it, by the server's clock;\n   * absent on a computer too old to look again when asked.\n   */\n  readonly agentsCheckedAt?: number | undefined;\n}\n\nexport interface AgentInfo {\n  readonly id: string;\n  readonly name: string;\n  readonly version?: string | undefined;\n  readonly ready: boolean;\n  /** Why a not-ready agent cannot run yet (\"run `claude` to log in\"). */\n  readonly problem?: string | undefined;\n  /** What a prompt may choose for its turn, as the agent last offered it; absent until it has. */\n  readonly options?: readonly AgentOption[] | undefined;\n  /** The account's allowance, as the agent last reported it; absent until it has. */\n  readonly usage?: AgentUsage | undefined;\n  /**\n   * The name this agent knows the app by outside the sidebar, when the user let it use the\n   * app there: \"use coursekit to ...\" in Claude Code.\n   */\n  readonly outsideName?: string | undefined;\n}\n\n/**\n * One setting a prompt may choose, such as the model or how hard it thinks. Never the\n * permission mode: that is the computer's to set.\n */\nexport interface AgentOption {\n  readonly id: string;\n  readonly name: string;\n  /** `model` and `thought_level` as the agent tags them; any other the agent names. */\n  readonly category?: string | undefined;\n  /** The agent's own default, the value a prompt that chooses nothing runs with. */\n  readonly current: string;\n  readonly values: readonly AgentOptionValue[];\n}\n\nexport interface AgentOptionValue {\n  readonly id: string;\n  readonly name: string;\n  readonly description?: string | undefined;\n}\n\nexport interface AgentUsage {\n  /** Account-wide windows first, each set shortest first. */\n  readonly windows: readonly AgentUsageWindow[];\n  /** When the agent reported it (epoch ms). */\n  readonly at: number;\n}\n\nexport interface AgentUsageWindow {\n  /** The vendor's name for it: `five_hour`, `seven_day`, `seven_day_opus`. */\n  readonly id: string;\n  readonly minutes: number;\n  /** Share of the window used, 0 to 1. */\n  readonly used: number;\n  /** When the window rolls over (epoch ms). */\n  readonly resetsAt?: number | undefined;\n}\n\nexport interface ThreadSummary {\n  readonly id: ThreadId;\n  readonly title: string;\n  readonly agent: AgentRef | undefined;\n  readonly updatedAt: number;\n  readonly lastSeq: number;\n}\n\nexport type TurnState = \"queued\" | \"running\" | \"done\" | \"failed\" | \"cancelled\";\n\nexport type TurnFailure =\n  | \"agent_exited\"\n  | \"agent_unavailable\"\n  | \"device_rejected\"\n  | \"signature_invalid\"\n  | \"prompt_expired\"\n  | \"host_lost\";\n\nexport type TurnOutcome =\n  | { readonly state: \"done\"; readonly stopReason: string }\n  | { readonly state: \"cancelled\" }\n  | { readonly state: \"failed\"; readonly reason: TurnFailure };\n\n/** Still being produced: only in memory, on the instance the host posts to. */\nexport type OpenItem =\n  | { readonly id: ItemId; readonly kind: \"reply\" | \"reasoning\"; readonly text: string }\n  | {\n      readonly id: ItemId;\n      readonly kind: \"tool\";\n      readonly title: string;\n      readonly status: \"pending\" | \"running\";\n    }\n  | {\n      readonly id: ItemId;\n      readonly kind: \"plan\";\n      readonly entries: ChatItemBody<\"plan\">[\"entries\"];\n    };\n\nexport interface OpenTurn {\n  readonly turnId: TurnId;\n  readonly threadId: ThreadId;\n  readonly items: readonly OpenItem[];\n}\n\nexport interface TurnStatus {\n  readonly turnId: TurnId;\n  readonly state: TurnState;\n  readonly agent: AgentRef;\n  readonly failure?: TurnFailure | undefined;\n}\n\nexport interface ThreadPage {\n  readonly thread: ThreadSummary | undefined;\n  readonly items: readonly LoggedItem[];\n  readonly open: readonly OpenTurn[];\n  readonly turns: readonly TurnStatus[];\n  readonly hasMore: boolean;\n}\n\nexport interface ChatSnapshot {\n  readonly threads: readonly ThreadSummary[];\n  /** `threads` was cut at its limit; `threadsBefore` reads on from its last one. */\n  readonly moreThreads?: boolean | undefined;\n  readonly hosts: readonly HostSummary[];\n  readonly page: ThreadPage;\n}\n\n/** What `history` returns: earlier items of a thread, oldest first, with their turns. */\nexport interface ThreadHistory {\n  readonly items: readonly LoggedItem[];\n  readonly turns: readonly TurnStatus[];\n  readonly hasMore: boolean;\n}\n\n/** What `threadsBefore` returns: the next older threads, newest first. */\nexport interface ThreadList {\n  readonly threads: readonly ThreadSummary[];\n  readonly hasMore: boolean;\n}\n\n/** The device's keys as the account has them; the host compares them with its own pins. */\nexport type ClaimedDevice = DeviceKeys;\n\nexport interface ClaimedTurn {\n  /** The thread id; every chat write returns it as `id`, which becomes its sync tag. */\n  readonly id: ThreadId;\n  readonly turnId: TurnId;\n  readonly agent: AgentRef;\n  /** The client the prompt came from; the turn token binds `ui_*` to it. */\n  readonly clientId: string;\n  readonly prompt: LoggedItem<\"prompt\">;\n  readonly device: ClaimedDevice | undefined;\n  /** The `<parlor-context>` block for a fresh agent session. */\n  readonly context: string;\n  readonly token: Delegation;\n  readonly leaseUntil: number;\n}\n\nexport interface TurnSignals {\n  readonly turnId: TurnId;\n  readonly items: readonly LoggedItem<Exclude<UserItemKind, \"prompt\">>[];\n  /** The keys of each device that answered, as the account lists them; revoked ones are left out. */\n  readonly devices?: readonly DeviceKeys[];\n}\n\n/** What a device signs for a prompt; the host rebuilds the same statement from the item. */\nexport interface PromptToSign {\n  readonly threadId: ThreadId;\n  readonly turnId: TurnId;\n  readonly agent: AgentRef;\n  readonly text: string;\n}\n\nexport interface AnswerToSign {\n  readonly threadId: ThreadId;\n  readonly askId: ItemId;\n  readonly choice: string;\n  readonly values?: ChatItemBody<\"answer\">[\"values\"];\n}\n"]}

package/dist/protocol.d.ts

@@ -1,5 +1,5 @@
 import { type ItemId, type ThreadId, type TurnId } from "@parlor/core";
-import type { AgentInfo, OpenItem } from "./model.js";
+import type { AgentInfo, ClaimedTurn, OpenItem } from "./model.js";
 export declare const CHAT_CHANNEL = "chat";
 /** The plugin name, so its routes live under `/_parlor/chat/`. */
 export declare const CHAT_PLUGIN = "chat";
@@ -41,8 +41,20 @@ export interface HostStreamBatch {
 /**
  * The versioned contract between an app's backend and Parlor Host: host actions, item
  * kinds, frames and cursor rules. Bumped on any change an older peer could misread.
+ * 3: the server may claim a turn for the computer and push it on the `chat` channel.
  */
-export declare const HOST_PROTOCOL = 2;
+export declare const HOST_PROTOCOL = 3;
+/** The first protocol whose computers take a turn pushed to them. */
+export declare const PUSHED_TURNS_PROTOCOL = 3;
+/**
+ * Server to one computer, on the `chat` channel: a turn claimed for it, as `hostClaim` would
+ * answer. The computer confirms it by calling about the turn; one it never confirms goes
+ * back to the queue, for `hostClaim`.
+ */
+export interface PushedTurn {
+    readonly type: "claimed";
+    readonly turn: ClaimedTurn;
+}
 export interface ProtocolRange {
     readonly min: number;
     readonly max: number;

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,MAAM,EACZ,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,YAAY,SAAS,CAAC;AACnC,kEAAkE;AAClE,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,WAAW,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,oGAAoG;AACpG,MAAM,MAAM,SAAS,GAAG,SAAS,SAAS,MAAM,CAAC,GAC7C,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,GAC3C,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC,GAC9B,KAAK,GACP,KAAK,CAAC;AAEV,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC,CAAC;AAwCN,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CA8BlE"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js

@@ -5,8 +5,11 @@ export const CHAT_PLUGIN = "chat";
 /**
  * The versioned contract between an app's backend and Parlor Host: host actions, item
  * kinds, frames and cursor rules. Bumped on any change an older peer could misread.
+ * 3: the server may claim a turn for the computer and push it on the `chat` channel.
  */
-export const HOST_PROTOCOL = 2;
+export const HOST_PROTOCOL = 3;
+/** The first protocol whose computers take a turn pushed to them. */
+export const PUSHED_TURNS_PROTOCOL = 3;
 function isFields(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/dist/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  asId,\n  type Id,\n  type IdKind,\n  type ItemId,\n  type ThreadId,\n  type TurnId,\n} from \"@parlor/core\";\n\nimport type { ChatItemBody } from \"./items.js\";\nimport type { AgentInfo, OpenItem } from \"./model.js\";\n\nexport const CHAT_CHANNEL = \"chat\";\n/** The plugin name, so its routes live under `/_parlor/chat/`. */\nexport const CHAT_PLUGIN = \"chat\";\n\nexport type StreamingKind = \"reply\" | \"reasoning\";\n\n/**\n * Server to browser on the `chat` channel; never persisted. `offset` makes a duplicate\n * delta skippable and a gap detectable, after which the client waits for the durable\n * item. `settled` drops a turn's open items: durable now, or gone.\n */\nexport type ChatFrame =\n  | {\n      readonly type: \"delta\";\n      readonly threadId: ThreadId;\n      readonly turnId: TurnId;\n      readonly itemId: ItemId;\n      readonly kind: StreamingKind;\n      readonly offset: number;\n      readonly text: string;\n    }\n  | {\n      readonly type: \"item\";\n      readonly threadId: ThreadId;\n      readonly turnId: TurnId;\n      readonly item: Extract<OpenItem, { kind: \"tool\" | \"plan\" }>;\n    }\n  | { readonly type: \"settled\"; readonly threadId: ThreadId; readonly turnId: TurnId };\n\n/** Host to server: the same frames minus what the batch's turn implies. Only the server settles. */\nexport type HostFrame = ChatFrame extends infer F\n  ? F extends { readonly type: \"delta\" | \"item\" }\n    ? Omit<F, \"threadId\" | \"turnId\">\n    : never\n  : never;\n\n/** `POST /_parlor/chat/stream` */\nexport interface HostStreamBatch {\n  readonly turnId: TurnId;\n  readonly frames: readonly HostFrame[];\n}\n\n/**\n * The versioned contract between an app's backend and Parlor Host: host actions, item\n * kinds, frames and cursor rules. Bumped on any change an older peer could misread.\n */\nexport const HOST_PROTOCOL = 2;\n\nexport interface ProtocolRange {\n  readonly min: number;\n  readonly max: number;\n}\n\nexport interface HostHello {\n  readonly protocols: ProtocolRange;\n  readonly hostVersion: string;\n  readonly name: string;\n  readonly platform: string;\n  readonly agents: readonly AgentInfo[];\n}\n\nexport type HostWelcome =\n  | {\n      readonly accepted: true;\n      readonly protocol: number;\n      readonly leaseMs: number;\n      readonly heartbeatMs: number;\n      readonly userActivity?: true;\n    }\n  | {\n      readonly accepted: false;\n      readonly reason: \"host_too_old\" | \"app_too_old\";\n      readonly protocols: ProtocolRange;\n    };\n\ntype Fields = Readonly<Record<string, unknown>>;\n\nfunction isFields(value: unknown): value is Fields {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction oneOf<T extends string>(values: readonly T[], value: unknown): T | undefined {\n  return values.find((candidate) => candidate === value);\n}\n\nfunction idOf<K extends IdKind>(kind: K, value: unknown): Id<K> | undefined {\n  return typeof value === \"string\" && value.length > 0 ? asId(kind, value) : undefined;\n}\n\nfunction openItemOf(\n  value: unknown,\n): Extract<OpenItem, { kind: \"tool\" | \"plan\" }> | undefined {\n  if (!isFields(value)) return undefined;\n  const id = idOf(\"item\", value.id);\n  if (!id) return undefined;\n  if (value.kind === \"tool\") {\n    const status = oneOf([\"pending\", \"running\"], value.status);\n    if (typeof value.title !== \"string\" || !status) return undefined;\n    return { id, kind: \"tool\", title: value.title, status };\n  }\n  if (value.kind === \"plan\" && Array.isArray(value.entries)) {\n    const entries: ChatItemBody<\"plan\">[\"entries\"][number][] = [];\n    for (const entry of value.entries as unknown[]) {\n      if (!isFields(entry) || typeof entry.content !== \"string\") return undefined;\n      const status = oneOf([\"pending\", \"in_progress\", \"completed\"], entry.status);\n      if (!status) return undefined;\n      entries.push({ content: entry.content, status });\n    }\n    return { id, kind: \"plan\", entries };\n  }\n  return undefined;\n}\n\nexport function parseChatFrame(data: string): ChatFrame | undefined {\n  let value: unknown;\n  try {\n    value = JSON.parse(data);\n  } catch {\n    return undefined;\n  }\n  if (!isFields(value)) return undefined;\n  const threadId = idOf(\"thread\", value.threadId);\n  const turnId = idOf(\"turn\", value.turnId);\n  if (!threadId || !turnId) return undefined;\n  switch (value.type) {\n    case \"settled\":\n      return { type: \"settled\", threadId, turnId };\n    case \"item\": {\n      const item = openItemOf(value.item);\n      return item ? { type: \"item\", threadId, turnId, item } : undefined;\n    }\n    case \"delta\": {\n      const itemId = idOf(\"item\", value.itemId);\n      const kind = oneOf([\"reply\", \"reasoning\"], value.kind);\n      const { offset, text } = value;\n      if (!itemId || !kind || typeof text !== \"string\") return undefined;\n      if (typeof offset !== \"number\" || !Number.isInteger(offset) || offset < 0)\n        return undefined;\n      return { type: \"delta\", threadId, turnId, itemId, kind, offset, text };\n    }\n    default:\n      return undefined;\n  }\n}\n"]}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  asId,\n  type Id,\n  type IdKind,\n  type ItemId,\n  type ThreadId,\n  type TurnId,\n} from \"@parlor/core\";\n\nimport type { ChatItemBody } from \"./items.js\";\nimport type { AgentInfo, ClaimedTurn, OpenItem } from \"./model.js\";\n\nexport const CHAT_CHANNEL = \"chat\";\n/** The plugin name, so its routes live under `/_parlor/chat/`. */\nexport const CHAT_PLUGIN = \"chat\";\n\nexport type StreamingKind = \"reply\" | \"reasoning\";\n\n/**\n * Server to browser on the `chat` channel; never persisted. `offset` makes a duplicate\n * delta skippable and a gap detectable, after which the client waits for the durable\n * item. `settled` drops a turn's open items: durable now, or gone.\n */\nexport type ChatFrame =\n  | {\n      readonly type: \"delta\";\n      readonly threadId: ThreadId;\n      readonly turnId: TurnId;\n      readonly itemId: ItemId;\n      readonly kind: StreamingKind;\n      readonly offset: number;\n      readonly text: string;\n    }\n  | {\n      readonly type: \"item\";\n      readonly threadId: ThreadId;\n      readonly turnId: TurnId;\n      readonly item: Extract<OpenItem, { kind: \"tool\" | \"plan\" }>;\n    }\n  | { readonly type: \"settled\"; readonly threadId: ThreadId; readonly turnId: TurnId };\n\n/** Host to server: the same frames minus what the batch's turn implies. Only the server settles. */\nexport type HostFrame = ChatFrame extends infer F\n  ? F extends { readonly type: \"delta\" | \"item\" }\n    ? Omit<F, \"threadId\" | \"turnId\">\n    : never\n  : never;\n\n/** `POST /_parlor/chat/stream` */\nexport interface HostStreamBatch {\n  readonly turnId: TurnId;\n  readonly frames: readonly HostFrame[];\n}\n\n/**\n * The versioned contract between an app's backend and Parlor Host: host actions, item\n * kinds, frames and cursor rules. Bumped on any change an older peer could misread.\n * 3: the server may claim a turn for the computer and push it on the `chat` channel.\n */\nexport const HOST_PROTOCOL = 3;\n\n/** The first protocol whose computers take a turn pushed to them. */\nexport const PUSHED_TURNS_PROTOCOL = 3;\n\n/**\n * Server to one computer, on the `chat` channel: a turn claimed for it, as `hostClaim` would\n * answer. The computer confirms it by calling about the turn; one it never confirms goes\n * back to the queue, for `hostClaim`.\n */\nexport interface PushedTurn {\n  readonly type: \"claimed\";\n  readonly turn: ClaimedTurn;\n}\n\nexport interface ProtocolRange {\n  readonly min: number;\n  readonly max: number;\n}\n\nexport interface HostHello {\n  readonly protocols: ProtocolRange;\n  readonly hostVersion: string;\n  readonly name: string;\n  readonly platform: string;\n  readonly agents: readonly AgentInfo[];\n}\n\nexport type HostWelcome =\n  | {\n      readonly accepted: true;\n      readonly protocol: number;\n      readonly leaseMs: number;\n      readonly heartbeatMs: number;\n      readonly userActivity?: true;\n    }\n  | {\n      readonly accepted: false;\n      readonly reason: \"host_too_old\" | \"app_too_old\";\n      readonly protocols: ProtocolRange;\n    };\n\ntype Fields = Readonly<Record<string, unknown>>;\n\nfunction isFields(value: unknown): value is Fields {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction oneOf<T extends string>(values: readonly T[], value: unknown): T | undefined {\n  return values.find((candidate) => candidate === value);\n}\n\nfunction idOf<K extends IdKind>(kind: K, value: unknown): Id<K> | undefined {\n  return typeof value === \"string\" && value.length > 0 ? asId(kind, value) : undefined;\n}\n\nfunction openItemOf(\n  value: unknown,\n): Extract<OpenItem, { kind: \"tool\" | \"plan\" }> | undefined {\n  if (!isFields(value)) return undefined;\n  const id = idOf(\"item\", value.id);\n  if (!id) return undefined;\n  if (value.kind === \"tool\") {\n    const status = oneOf([\"pending\", \"running\"], value.status);\n    if (typeof value.title !== \"string\" || !status) return undefined;\n    return { id, kind: \"tool\", title: value.title, status };\n  }\n  if (value.kind === \"plan\" && Array.isArray(value.entries)) {\n    const entries: ChatItemBody<\"plan\">[\"entries\"][number][] = [];\n    for (const entry of value.entries as unknown[]) {\n      if (!isFields(entry) || typeof entry.content !== \"string\") return undefined;\n      const status = oneOf([\"pending\", \"in_progress\", \"completed\"], entry.status);\n      if (!status) return undefined;\n      entries.push({ content: entry.content, status });\n    }\n    return { id, kind: \"plan\", entries };\n  }\n  return undefined;\n}\n\nexport function parseChatFrame(data: string): ChatFrame | undefined {\n  let value: unknown;\n  try {\n    value = JSON.parse(data);\n  } catch {\n    return undefined;\n  }\n  if (!isFields(value)) return undefined;\n  const threadId = idOf(\"thread\", value.threadId);\n  const turnId = idOf(\"turn\", value.turnId);\n  if (!threadId || !turnId) return undefined;\n  switch (value.type) {\n    case \"settled\":\n      return { type: \"settled\", threadId, turnId };\n    case \"item\": {\n      const item = openItemOf(value.item);\n      return item ? { type: \"item\", threadId, turnId, item } : undefined;\n    }\n    case \"delta\": {\n      const itemId = idOf(\"item\", value.itemId);\n      const kind = oneOf([\"reply\", \"reasoning\"], value.kind);\n      const { offset, text } = value;\n      if (!itemId || !kind || typeof text !== \"string\") return undefined;\n      if (typeof offset !== \"number\" || !Number.isInteger(offset) || offset < 0)\n        return undefined;\n      return { type: \"delta\", threadId, turnId, itemId, kind, offset, text };\n    }\n    default:\n      return undefined;\n  }\n}\n"]}

package/dist/server/actions.d.ts

@@ -1,14 +1,16 @@
-import { type ActionContext, type HostId, type ThreadId } from "@parlor/core";
+import { type HostId, type ThreadId, type TurnId } from "@parlor/core";
 import { type ActionsOf } from "@parlor/core/registry";
 import { type AuthProvider, type Delegation, HOST_GRANTS_TAG } from "@parlor/server";
 import { z } from "zod";
 import { idSchema } from "../id-schemas.js";
 import { type LoggedItem } from "../items.js";
-import type { ChatOwner, ChatSnapshot, ThreadHistory, ThreadList, ClaimedTurn, HostSummary, TurnSignals } from "../model.js";
+import type { AgentInfo, ChatOwner, ChatSnapshot, ThreadHistory, ThreadList, ClaimedTurn, HostSummary, TurnSignals } from "../model.js";
 import { type HostWelcome } from "../protocol.js";
 import { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG } from "../tags.js";
 import type { LiveRelay } from "./live.js";
-import { type ChatDb, type ChatStore } from "./store.js";
+import { type ChatHost } from "./party.js";
+import type { TurnPush } from "./push.js";
+import { type ChatDb, type ChatStore, type StoredHost } from "./store.js";
 export { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG, HOST_GRANTS_TAG };
 export interface Written<T> {
     readonly result: T;
@@ -35,7 +37,9 @@ export interface ChatActionDeps {
     readonly maxQueued: number;
     readonly instructions: string | undefined;
     readonly appName: string;
-    readonly appOrigin: (ctx: ActionContext) => string;
+    readonly appOrigin: () => string;
+    /** Hands a queued turn straight to its computer; without it computers only claim. */
+    readonly pushed?: TurnPush | undefined;
 }
 export declare function userChatActions(deps: ChatActionDeps): {
     open: import("@parlor/core").ActionDefinition<z.ZodObject<{
@@ -136,9 +140,32 @@ export declare function userChatActions(deps: ChatActionDeps): {
     userActive: import("@parlor/core").ActionDefinition<z.ZodObject<{}, z.core.$strip>, {
         readonly ok: true;
     }>;
+    checkAgents: import("@parlor/core").ActionDefinition<z.ZodObject<{}, z.core.$strip>, {
+        readonly askedAt: number;
+    }>;
 };
+/**
+ * What the server keeps about the computers it serves: which said hello, their agents'
+ * names, and how a turn is claimed for one, by `hostClaim` or pushed to it.
+ */
+export declare function hostSession(deps: ChatActionDeps): {
+    welcome: (host: ChatHost, db: ChatDb) => Promise<StoredHost>;
+    requireWelcome: (host: ChatHost, db: ChatDb) => Promise<void>;
+    learnAgents: (hostId: HostId, agents: readonly AgentInfo[]) => void;
+    agentNameOf: (host: ChatHost, db: ChatDb, agentId: string) => Promise<string>;
+    mint: (host: ChatHost, db: ChatDb, turn: {
+        threadId: ThreadId;
+        turnId: TurnId;
+        clientId: string;
+        agentId: string;
+    }) => Promise<Delegation>;
+    claim: (host: ChatHost, db: ChatDb) => Promise<ClaimedTurn | undefined>;
+    release: (host: ChatHost, thread: ThreadId, turn: TurnId) => Promise<boolean>;
+    welcomed: Set<HostId>;
+};
+export type HostSession = ReturnType<typeof hostSession>;
 /** What the user's computers call; `hostHello` first on every link. */
-export declare function hostChatActions(deps: ChatActionDeps): {
+export declare function hostChatActions(deps: ChatActionDeps, session?: HostSession): {
     hostHello: import("@parlor/core").ActionDefinition<z.ZodObject<{
         protocols: z.ZodObject<{
             min: z.ZodNumber;
@@ -212,6 +239,7 @@ export declare function hostChatActions(deps: ChatActionDeps): {
         }, z.core.$strip>>;
         devices: z.ZodOptional<z.ZodArray<z.ZodString>>;
         presenceDue: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        agentsChecked: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>, {
         readonly id: string;
         readonly onlineUntil: number;
@@ -346,7 +374,7 @@ export declare function hostChatActions(deps: ChatActionDeps): {
  * The chat's actions at `/_parlor/chat/actions/<name>`: plugin actions, so never on MCP
  * and never callable by an agent. Writes return the thread or host id as `id`.
  */
-export declare function chatActions(deps: ChatActionDeps): import("@parlor/core/registry").ActionRegistry<{
+export declare function chatActions(deps: ChatActionDeps, session?: HostSession): import("@parlor/core/registry").ActionRegistry<{
     open: import("@parlor/core").ActionDefinition<z.ZodObject<{
         threadId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@parlor/core").Id<"thread">, string>>>;
         limit: z.ZodDefault<z.ZodNumber>;
@@ -445,6 +473,9 @@ export declare function chatActions(deps: ChatActionDeps): import("@parlor/core/
     userActive: import("@parlor/core").ActionDefinition<z.ZodObject<{}, z.core.$strip>, {
         readonly ok: true;
     }>;
+    checkAgents: import("@parlor/core").ActionDefinition<z.ZodObject<{}, z.core.$strip>, {
+        readonly askedAt: number;
+    }>;
     hostHello: import("@parlor/core").ActionDefinition<z.ZodObject<{
         protocols: z.ZodObject<{
             min: z.ZodNumber;
@@ -518,6 +549,7 @@ export declare function chatActions(deps: ChatActionDeps): import("@parlor/core/
         }, z.core.$strip>>;
         devices: z.ZodOptional<z.ZodArray<z.ZodString>>;
         presenceDue: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        agentsChecked: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>, {
         readonly id: string;
         readonly onlineUntil: number;

package/dist/server/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/server/actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/server/actions.ts"],"names":[],"mappings":"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"}

package/dist/server/actions.js

@@ -4,8 +4,8 @@ import { HOST_GRANTS_TAG } from "@parlor/server";
 import { z } from "zod";
 import { idSchema } from "../id-schemas.js";
 import { chatItemBodies, hostItemDraft } from "../items.js";
-import { HOST_PROTOCOL } from "../protocol.js";
-import { CHAT_ACTIVITY_TAG, CHAT_TAG, HOSTS_TAG } from "../tags.js";
+import { HOST_PROTOCOL, PUSHED_TURNS_PROTOCOL } from "../protocol.js";
+import { CHAT_ACTIVITY_TAG, CHAT_AGENTS_CHECK_TAG, CHAT_TAG, HOSTS_TAG, } from "../tags.js";
 import { turnContext } from "./context.js";
 import { chatAction } from "./party.js";
 import { agentInfoSchema, TURN_FAILURES } from "./rows.js";
@@ -130,7 +130,7 @@ export function userChatActions(deps) {
                 const host = hosts.find((candidate) => candidate.id === input.prompt.agent.hostId);
                 if (!host)
                     throw new ActionError("not_found", "Computer not found");
-                return deps.transact(user, async (tx) => {
+                const sent = await deps.transact(user, async (tx) => {
                     await deps.store.appendUserItems(tx, user, {
                         threadId: input.threadId,
                         turnId: input.turnId,
@@ -148,6 +148,9 @@ export function userChatActions(deps) {
                         threadId: input.threadId,
                     };
                 });
+                if (host.protocol >= PUSHED_TURNS_PROTOCOL)
+                    deps.pushed?.offer(user, host.id);
+                return sent;
             },
         }),
         answer: chatAction("user", enforcing, {
@@ -190,11 +193,19 @@ export function userChatActions(deps) {
             writes: [CHAT_ACTIVITY_TAG],
             run: () => ({ ok: true }),
         }),
+        checkAgents: chatAction("user", enforcing, {
+            description: "Ask the user's computers to look again for the coding agents installed on them; each reports what it found, stamped `agentsCheckedAt`. Answers when it asked, by the same clock.",
+            input: z.object({}),
+            writes: [CHAT_AGENTS_CHECK_TAG],
+            run: () => ({ askedAt: Date.now() }),
+        }),
     };
 }
-/** What the user's computers call; `hostHello` first on every link. */
-export function hostChatActions(deps) {
-    const { enforcing } = deps;
+/**
+ * What the server keeps about the computers it serves: which said hello, their agents'
+ * names, and how a turn is claimed for one, by `hostClaim` or pushed to it.
+ */
+export function hostSession(deps) {
     const welcomed = new Set();
     const welcome = async (host, db) => {
         const hosts = await deps.store.listHosts(db, host);
@@ -236,6 +247,64 @@ export function hostChatActions(deps) {
             ttlMs: deps.leaseMs,
         });
     };
+    /** The next turn waiting for `host`, claimed for it with its token and context; undefined when none waits. */
+    const claim = async (host, db) => {
+        await requireWelcome(host, db);
+        await deps.reconcile(host);
+        const claimed = await deps.transact(host, async (tx) => {
+            const taken = await deps.store.claimTurn(tx, host, host.host, deps.leaseMs);
+            return { result: taken, threadId: taken?.id };
+        });
+        if (!claimed)
+            return undefined;
+        try {
+            const deviceId = claimed.prompt.body.signed?.deviceId;
+            const [token, device, account, page] = await Promise.all([
+                mint(host, db, {
+                    threadId: claimed.id,
+                    turnId: claimed.turnId,
+                    clientId: claimed.clientId,
+                    agentId: claimed.agent.agentId,
+                }),
+                deviceId ? deps.auth.device?.(host.userId, deviceId) : undefined,
+                deps.auth.account?.(host.userId),
+                deps.store.readPage(db, host, claimed.id, CONTEXT_HISTORY_ITEMS),
+            ]);
+            const context = turnContext({
+                appName: deps.appName,
+                appOrigin: deps.appOrigin(),
+                account,
+                device,
+                instructions: deps.instructions,
+                history: page.items.filter((item) => item.seq < claimed.prompt.seq),
+            });
+            return { ...claimed, device, context, token };
+        }
+        catch (error) {
+            await release(host, claimed.id, claimed.turnId).catch(() => false);
+            throw error;
+        }
+    };
+    /** Puts a claimed turn back in the queue, waking the computer to claim it again. */
+    const release = (host, thread, turn) => deps.transact(host, async (tx) => {
+        const released = await deps.store.releaseClaim(tx, host, host.host, turn);
+        return { result: released, threadId: thread };
+    });
+    return {
+        welcome,
+        requireWelcome,
+        learnAgents,
+        agentNameOf,
+        mint,
+        claim,
+        release,
+        welcomed,
+    };
+}
+/** What the user's computers call; `hostHello` first on every link. */
+export function hostChatActions(deps, session = hostSession(deps)) {
+    const { enforcing } = deps;
+    const { welcome, requireWelcome, learnAgents, mint, welcomed } = session;
     return {
         hostHello: chatAction("host", enforcing, {
             description: "A link's first call: agree on the host protocol and report this computer online with its agents.",
@@ -288,12 +357,13 @@ export function hostChatActions(deps) {
             },
         }),
         hostReport: chatAction("host", enforcing, {
-            description: "This computer went offline or changed its agents.",
+            description: "This computer went offline, changed its agents, or looked for them again (`agentsChecked`).",
             input: z.object({
                 online: z.boolean(),
                 agents: z.array(agentInfoSchema).max(32),
                 devices: z.array(z.string().min(1).max(64)).max(256).optional(),
                 presenceDue: presenceDueSchema.optional(),
+                agentsChecked: z.literal(true).optional(),
             }),
             writes: [HOSTS_TAG],
             run: async (input, host, ctx) => {
@@ -306,6 +376,7 @@ export function hostChatActions(deps) {
                     agents: input.agents,
                     devices: input.devices,
                     presenceDue: input.presenceDue,
+                    agentsCheckedAt: input.agentsChecked ? Date.now() : undefined,
                     online: input.online,
                     ttlMs: 2 * deps.heartbeatMs,
                 });
@@ -328,53 +399,18 @@ export function hostChatActions(deps) {
             description: "Take the next turn addressed to this computer with its turn token; not_found when none waits.",
             input: z.object({}),
             run: async (_input, host, ctx) => {
-                const db = dbOf(ctx);
-                await requireWelcome(host, db);
-                await deps.reconcile(host);
-                const claimed = await deps.transact(host, async (tx) => {
-                    const taken = await deps.store.claimTurn(tx, host, host.host, deps.leaseMs);
-                    if (!taken)
-                        throw new ActionError("not_found", "No turn is waiting.");
-                    return { result: taken, threadId: taken.id };
-                });
-                try {
-                    const token = await mint(host, db, {
-                        threadId: claimed.id,
-                        turnId: claimed.turnId,
-                        clientId: claimed.clientId,
-                        agentId: claimed.agent.agentId,
-                    });
-                    const deviceId = claimed.prompt.body.signed?.deviceId;
-                    const [device, account, page] = await Promise.all([
-                        deviceId ? deps.auth.device?.(host.userId, deviceId) : undefined,
-                        deps.auth.account?.(host.userId),
-                        deps.store.readPage(db, host, claimed.id, CONTEXT_HISTORY_ITEMS),
-                    ]);
-                    const context = turnContext({
-                        appName: deps.appName,
-                        appOrigin: deps.appOrigin(ctx),
-                        account,
-                        device,
-                        instructions: deps.instructions,
-                        history: page.items.filter((item) => item.seq < claimed.prompt.seq),
-                    });
-                    return { ...claimed, device, context, token };
-                }
-                catch (error) {
-                    await deps
-                        .transact(host, async (tx) => {
-                        const released = await deps.store.releaseClaim(tx, host, host.host, claimed.turnId);
-                        return { result: released, threadId: claimed.id };
-                    })
-                        .catch(() => false);
-                    throw error;
-                }
+                const claimed = await session.claim(host, dbOf(ctx));
+                if (!claimed)
+                    throw new ActionError("not_found", "No turn is waiting.");
+                return claimed;
             },
         }),
         hostSignals: chatAction("host", enforcing, {
             description: "Answers and stop requests for the turns this computer runs.",
             input: z.object({ turns: z.array(z.object({ turnId, afterSeq })).max(16) }),
             run: async (input, host, ctx) => {
+                for (const turn of input.turns)
+                    deps.pushed?.confirm(turn.turnId);
                 const db = dbOf(ctx);
                 await requireWelcome(host, db);
                 const signals = await deps.store.readSignals(db, host, host.host, input.turns);
@@ -391,6 +427,7 @@ export function hostChatActions(deps) {
             description: "Append finished items of a running turn and extend its lease; no items only renews it.",
             input: z.object({ turnId, items: z.array(hostItemDraft).max(64) }),
             run: async (input, host, ctx) => {
+                deps.pushed?.confirm(input.turnId);
                 await requireWelcome(host, dbOf(ctx));
                 const appended = await deps.transact(host, async (tx) => {
                     const result = await deps.store.appendHostItems(tx, host, host.host, input.turnId, input.items, deps.leaseMs);
@@ -414,6 +451,7 @@ export function hostChatActions(deps) {
                 ]),
             }),
             run: async (input, host, ctx) => {
+                deps.pushed?.confirm(input.turnId);
                 await requireWelcome(host, dbOf(ctx));
                 const finished = await deps.transact(host, async (tx) => {
                     const result = await deps.store.finishTurn(tx, host, host.host, input.turnId, input.outcome);
@@ -429,7 +467,7 @@ export function hostChatActions(deps) {
  * The chat's actions at `/_parlor/chat/actions/<name>`: plugin actions, so never on MCP
  * and never callable by an agent. Writes return the thread or host id as `id`.
  */
-export function chatActions(deps) {
-    return createRegistry({ ...userChatActions(deps), ...hostChatActions(deps) });
+export function chatActions(deps, session = hostSession(deps)) {
+    return createRegistry({ ...userChatActions(deps), ...hostChatActions(deps, session) });
 }
 //# sourceMappingURL=actions.js.map