@parlor/agent-host 0.3.0 → 0.3.1

package/dist/agent-options.d.ts

@@ -9,6 +9,11 @@ export declare function optionChanges(options: readonly AgentOption[], chosen: R
  * CLI names under `unifiedWindows`, or the one window an event is about.
  */
 export declare function agentUsageOf(meta: Readonly<Record<string, unknown>> | null | undefined, at: number): AgentUsage | undefined;
+/**
+ * Codex's rate limit, from `account/rateLimits/read` on its app-server: two windows it calls
+ * `primary` and `secondary`, each carrying its own length, so neither is taken to be the short one.
+ */
+export declare function codexUsageOf(result: unknown, at: number): AgentUsage | undefined;
 /**
  * `next` laid over `held` window by window: an event names one window, and the others it
  * leaves out still stand until they roll over.

package/dist/agent-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-options.d.ts","sourceRoot":"","sources":["../src/agent-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAE9E,qFAAqF;AACrF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACnD;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAQnD;AAiCD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1D,EAAE,EAAE,MAAM,GACT,UAAU,GAAG,SAAS,CAmBxB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAQrF"}
+{"version":3,"file":"agent-options.d.ts","sourceRoot":"","sources":["../src/agent-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAE9E,qFAAqF;AACrF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACnD;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAQnD;AAiCD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1D,EAAE,EAAE,MAAM,GACT,UAAU,GAAG,SAAS,CAmBxB;AAQD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CA2BhF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAQrF"}

package/dist/agent-options.js

@@ -51,6 +51,36 @@ export function agentUsageOf(meta, at) {
     });
     return windows.length === 0 ? undefined : { windows: ordered(windows), at };
 }
+/**
+ * Codex's rate limit, from `account/rateLimits/read` on its app-server: two windows it calls
+ * `primary` and `secondary`, each carrying its own length, so neither is taken to be the short one.
+ */
+export function codexUsageOf(result, at) {
+    const limits = result?.rateLimits;
+    if (!limits || typeof limits !== "object")
+        return undefined;
+    const windows = ["primary", "secondary"].flatMap((id) => {
+        const slot = limits[id];
+        const used = slot?.usedPercent;
+        const minutes = slot?.windowDurationMins;
+        if (typeof used !== "number" || !Number.isFinite(used))
+            return [];
+        if (typeof minutes !== "number" || !(minutes > 0))
+            return [];
+        const resetsAt = typeof slot?.resetsAt === "number" && Number.isFinite(slot.resetsAt)
+            ? slot.resetsAt * 1000
+            : undefined;
+        return [
+            {
+                id,
+                minutes,
+                used: Math.min(1, Math.max(0, used / 100)),
+                ...(resetsAt === undefined ? {} : { resetsAt }),
+            },
+        ];
+    });
+    return windows.length === 0 ? undefined : { windows: ordered(windows), at };
+}
 /**
  * `next` laid over `held` window by window: an event names one window, and the others it
  * leaves out still stand until they roll over.
@@ -69,5 +99,7 @@ function ordered(windows) {
 const ACCOUNT_WINDOWS = {
     five_hour: true,
     seven_day: true,
+    primary: true,
+    secondary: true,
 };
 //# sourceMappingURL=agent-options.js.map

package/dist/agent-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-options.js","sourceRoot":"","sources":["../src/agent-options.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentOption, AgentUsage, AgentUsageWindow } from \"@parlor/chat\";\n\n/** The values `chosen` names that `options` offers and does not already run with. */\nexport function optionChanges(\n  options: readonly AgentOption[],\n  chosen: Readonly<Record<string, string>> | undefined,\n): { readonly id: string; readonly value: string }[] {\n  return Object.entries(chosen ?? {}).flatMap(([id, value]) => {\n    const option = options.find((candidate) => candidate.id === id);\n    if (!option || option.current === value) return [];\n    return option.values.some((candidate) => candidate.id === value)\n      ? [{ id, value }]\n      : [];\n  });\n}\n\nconst RATE_LIMIT_META = \"_claude/rateLimit\";\nconst WINDOW_MINUTES: Readonly<Record<string, number>> = {\n  five_hour: 5 * 60,\n  seven_day: 7 * 24 * 60,\n  seven_day_opus: 7 * 24 * 60,\n  seven_day_sonnet: 7 * 24 * 60,\n};\n\ninterface RateLimitSlot {\n  readonly utilization?: unknown;\n  readonly resetsAt?: unknown;\n}\n\nfunction windowOf(id: string, slot: RateLimitSlot): AgentUsageWindow | undefined {\n  const minutes = WINDOW_MINUTES[id];\n  const used = slot.utilization;\n  if (minutes === undefined || typeof used !== \"number\" || !Number.isFinite(used)) {\n    return undefined;\n  }\n  const resetsAt =\n    typeof slot.resetsAt === \"number\" && Number.isFinite(slot.resetsAt)\n      ? slot.resetsAt * 1000\n      : undefined;\n  return {\n    id,\n    minutes,\n    used: Math.min(1, Math.max(0, used)),\n    ...(resetsAt === undefined ? {} : { resetsAt }),\n  };\n}\n\n/**\n * Claude Code's rate limit, which rides on a `usage_update`'s `_meta`: every window a newer\n * CLI names under `unifiedWindows`, or the one window an event is about.\n */\nexport function agentUsageOf(\n  meta: Readonly<Record<string, unknown>> | null | undefined,\n  at: number,\n): AgentUsage | undefined {\n  const info = meta?.[RATE_LIMIT_META] as\n    | (RateLimitSlot & {\n        readonly rateLimitType?: unknown;\n        readonly unifiedWindows?: Readonly<Record<string, RateLimitSlot>>;\n      })\n    | undefined;\n  if (!info || typeof info !== \"object\") return undefined;\n  const slots: [string, RateLimitSlot][] =\n    info.unifiedWindows && typeof info.unifiedWindows === \"object\"\n      ? Object.entries(info.unifiedWindows)\n      : typeof info.rateLimitType === \"string\"\n        ? [[info.rateLimitType, info]]\n        : [];\n  const windows = slots.flatMap(([id, slot]) => {\n    const window = windowOf(id, slot);\n    return window ? [window] : [];\n  });\n  return windows.length === 0 ? undefined : { windows: ordered(windows), at };\n}\n\n/**\n * `next` laid over `held` window by window: an event names one window, and the others it\n * leaves out still stand until they roll over.\n */\nexport function mergeUsage(held: AgentUsage | undefined, next: AgentUsage): AgentUsage {\n  const named = new Set(next.windows.map((window) => window.id));\n  const kept = (held?.windows ?? []).filter(\n    (window) =>\n      !named.has(window.id) &&\n      (window.resetsAt === undefined || window.resetsAt > next.at),\n  );\n  return { windows: ordered([...next.windows, ...kept]), at: next.at };\n}\n\n/** The account's own windows before a model's, each set shortest first. */\nfunction ordered(windows: readonly AgentUsageWindow[]): AgentUsageWindow[] {\n  const perModel = (window: AgentUsageWindow) => (window.id in ACCOUNT_WINDOWS ? 0 : 1);\n  return [...windows].sort(\n    (a, b) =>\n      perModel(a) - perModel(b) || a.minutes - b.minutes || a.id.localeCompare(b.id),\n  );\n}\n\nconst ACCOUNT_WINDOWS: Readonly<Record<string, true>> = {\n  five_hour: true,\n  seven_day: true,\n};\n"]}
+{"version":3,"file":"agent-options.js","sourceRoot":"","sources":["../src/agent-options.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentOption, AgentUsage, AgentUsageWindow } from \"@parlor/chat\";\n\n/** The values `chosen` names that `options` offers and does not already run with. */\nexport function optionChanges(\n  options: readonly AgentOption[],\n  chosen: Readonly<Record<string, string>> | undefined,\n): { readonly id: string; readonly value: string }[] {\n  return Object.entries(chosen ?? {}).flatMap(([id, value]) => {\n    const option = options.find((candidate) => candidate.id === id);\n    if (!option || option.current === value) return [];\n    return option.values.some((candidate) => candidate.id === value)\n      ? [{ id, value }]\n      : [];\n  });\n}\n\nconst RATE_LIMIT_META = \"_claude/rateLimit\";\nconst WINDOW_MINUTES: Readonly<Record<string, number>> = {\n  five_hour: 5 * 60,\n  seven_day: 7 * 24 * 60,\n  seven_day_opus: 7 * 24 * 60,\n  seven_day_sonnet: 7 * 24 * 60,\n};\n\ninterface RateLimitSlot {\n  readonly utilization?: unknown;\n  readonly resetsAt?: unknown;\n}\n\nfunction windowOf(id: string, slot: RateLimitSlot): AgentUsageWindow | undefined {\n  const minutes = WINDOW_MINUTES[id];\n  const used = slot.utilization;\n  if (minutes === undefined || typeof used !== \"number\" || !Number.isFinite(used)) {\n    return undefined;\n  }\n  const resetsAt =\n    typeof slot.resetsAt === \"number\" && Number.isFinite(slot.resetsAt)\n      ? slot.resetsAt * 1000\n      : undefined;\n  return {\n    id,\n    minutes,\n    used: Math.min(1, Math.max(0, used)),\n    ...(resetsAt === undefined ? {} : { resetsAt }),\n  };\n}\n\n/**\n * Claude Code's rate limit, which rides on a `usage_update`'s `_meta`: every window a newer\n * CLI names under `unifiedWindows`, or the one window an event is about.\n */\nexport function agentUsageOf(\n  meta: Readonly<Record<string, unknown>> | null | undefined,\n  at: number,\n): AgentUsage | undefined {\n  const info = meta?.[RATE_LIMIT_META] as\n    | (RateLimitSlot & {\n        readonly rateLimitType?: unknown;\n        readonly unifiedWindows?: Readonly<Record<string, RateLimitSlot>>;\n      })\n    | undefined;\n  if (!info || typeof info !== \"object\") return undefined;\n  const slots: [string, RateLimitSlot][] =\n    info.unifiedWindows && typeof info.unifiedWindows === \"object\"\n      ? Object.entries(info.unifiedWindows)\n      : typeof info.rateLimitType === \"string\"\n        ? [[info.rateLimitType, info]]\n        : [];\n  const windows = slots.flatMap(([id, slot]) => {\n    const window = windowOf(id, slot);\n    return window ? [window] : [];\n  });\n  return windows.length === 0 ? undefined : { windows: ordered(windows), at };\n}\n\ninterface CodexWindow {\n  readonly usedPercent?: unknown;\n  readonly windowDurationMins?: unknown;\n  readonly resetsAt?: unknown;\n}\n\n/**\n * Codex's rate limit, from `account/rateLimits/read` on its app-server: two windows it calls\n * `primary` and `secondary`, each carrying its own length, so neither is taken to be the short one.\n */\nexport function codexUsageOf(result: unknown, at: number): AgentUsage | undefined {\n  const limits = (\n    result as { readonly rateLimits?: Readonly<Record<string, CodexWindow>> }\n  )?.rateLimits;\n  if (!limits || typeof limits !== \"object\") return undefined;\n  const windows = ([\"primary\", \"secondary\"] as const).flatMap(\n    (id): AgentUsageWindow[] => {\n      const slot = limits[id];\n      const used = slot?.usedPercent;\n      const minutes = slot?.windowDurationMins;\n      if (typeof used !== \"number\" || !Number.isFinite(used)) return [];\n      if (typeof minutes !== \"number\" || !(minutes > 0)) return [];\n      const resetsAt =\n        typeof slot?.resetsAt === \"number\" && Number.isFinite(slot.resetsAt)\n          ? slot.resetsAt * 1000\n          : undefined;\n      return [\n        {\n          id,\n          minutes,\n          used: Math.min(1, Math.max(0, used / 100)),\n          ...(resetsAt === undefined ? {} : { resetsAt }),\n        },\n      ];\n    },\n  );\n  return windows.length === 0 ? undefined : { windows: ordered(windows), at };\n}\n\n/**\n * `next` laid over `held` window by window: an event names one window, and the others it\n * leaves out still stand until they roll over.\n */\nexport function mergeUsage(held: AgentUsage | undefined, next: AgentUsage): AgentUsage {\n  const named = new Set(next.windows.map((window) => window.id));\n  const kept = (held?.windows ?? []).filter(\n    (window) =>\n      !named.has(window.id) &&\n      (window.resetsAt === undefined || window.resetsAt > next.at),\n  );\n  return { windows: ordered([...next.windows, ...kept]), at: next.at };\n}\n\n/** The account's own windows before a model's, each set shortest first. */\nfunction ordered(windows: readonly AgentUsageWindow[]): AgentUsageWindow[] {\n  const perModel = (window: AgentUsageWindow) => (window.id in ACCOUNT_WINDOWS ? 0 : 1);\n  return [...windows].sort(\n    (a, b) =>\n      perModel(a) - perModel(b) || a.minutes - b.minutes || a.id.localeCompare(b.id),\n  );\n}\n\nconst ACCOUNT_WINDOWS: Readonly<Record<string, true>> = {\n  five_hour: true,\n  seven_day: true,\n  primary: true,\n  secondary: true,\n};\n"]}

package/dist/agent-survey.d.ts

@@ -0,0 +1,15 @@
+import type { AgentOption, AgentUsage } from "@parlor/chat";
+import type { AgentLauncher } from "./acp.js";
+import type { AgentProfile } from "./agents.js";
+/**
+ * The options `profile` offers, from a session opened in a scratch directory only to read
+ * them and then closed: no prompt, so no model turn. Lets the sidebar offer a model before
+ * the agent's first turn. Undefined when the agent cannot be started or is not logged in.
+ */
+export declare function surveyOptions(profile: AgentProfile, launcher: AgentLauncher, env: Readonly<Record<string, string>>, stop?: AbortSignal): Promise<readonly AgentOption[] | undefined>;
+/**
+ * The account's allowance from the agent's own CLI, for an agent whose ACP adapter does not
+ * carry it: `codex-acp` drops Codex's rate limits. Claude Code sends its own over ACP.
+ */
+export declare function readUsage(profile: AgentProfile, env: Readonly<Record<string, string>>, now: number): Promise<AgentUsage | undefined>;
+//# sourceMappingURL=agent-survey.d.ts.map

package/dist/agent-survey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-survey.d.ts","sourceRoot":"","sources":["../src/agent-survey.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACrC,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,SAAS,WAAW,EAAE,GAAG,SAAS,CAAC,CAyB7C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAMjC"}

package/dist/agent-survey.js

@@ -0,0 +1,51 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { codexUsageOf } from "./agent-options.js";
+import { askCodex } from "./codex-app-server.js";
+const SURVEY_TIMEOUT_MS = 60_000;
+/**
+ * The options `profile` offers, from a session opened in a scratch directory only to read
+ * them and then closed: no prompt, so no model turn. Lets the sidebar offer a model before
+ * the agent's first turn. Undefined when the agent cannot be started or is not logged in.
+ */
+export async function surveyOptions(profile, launcher, env, stop) {
+    const cwd = await mkdtemp(join(tmpdir(), "parlor-survey-"));
+    const timeout = AbortSignal.timeout(SURVEY_TIMEOUT_MS);
+    const signal = stop ? AbortSignal.any([stop, timeout]) : timeout;
+    try {
+        const connection = await launcher.launch(profile, { cwd, env, signal });
+        const end = () => void connection.kill();
+        signal.addEventListener("abort", end, { once: true });
+        try {
+            if (!connection.capabilities.ready)
+                return undefined;
+            const session = await connection.openSession({
+                cwd,
+                mcpServers: [],
+                pinAskMode: true,
+            });
+            return session.options;
+        }
+        finally {
+            signal.removeEventListener("abort", end);
+            await connection.kill();
+        }
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+}
+/**
+ * The account's allowance from the agent's own CLI, for an agent whose ACP adapter does not
+ * carry it: `codex-acp` drops Codex's rate limits. Claude Code sends its own over ACP.
+ */
+export async function readUsage(profile, env, now) {
+    if (profile.id !== "codex")
+        return undefined;
+    return codexUsageOf(await askCodex(profile.binary, "account/rateLimits/read", null, env), now);
+}
+//# sourceMappingURL=agent-survey.js.map

package/dist/agent-survey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-survey.js","sourceRoot":"","sources":["../src/agent-survey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAqB,EACrB,QAAuB,EACvB,GAAqC,EACrC,IAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,UAAU,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAC;YACrD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC;gBAC3C,GAAG;gBACH,UAAU,EAAE,EAAE;gBACd,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,OAAO,CAAC;QACzB,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACzC,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAqB,EACrB,GAAqC,EACrC,GAAW;IAEX,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,YAAY,CACjB,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,yBAAyB,EAAE,IAAI,EAAE,GAAG,CAAC,EACpE,GAAG,CACJ,CAAC;AACJ,CAAC","sourcesContent":["import { mkdtemp, rm } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport type { AgentOption, AgentUsage } from \"@parlor/chat\";\n\nimport type { AgentLauncher } from \"./acp.js\";\nimport { codexUsageOf } from \"./agent-options.js\";\nimport type { AgentProfile } from \"./agents.js\";\nimport { askCodex } from \"./codex-app-server.js\";\n\nconst SURVEY_TIMEOUT_MS = 60_000;\n\n/**\n * The options `profile` offers, from a session opened in a scratch directory only to read\n * them and then closed: no prompt, so no model turn. Lets the sidebar offer a model before\n * the agent's first turn. Undefined when the agent cannot be started or is not logged in.\n */\nexport async function surveyOptions(\n  profile: AgentProfile,\n  launcher: AgentLauncher,\n  env: Readonly<Record<string, string>>,\n  stop?: AbortSignal,\n): Promise<readonly AgentOption[] | undefined> {\n  const cwd = await mkdtemp(join(tmpdir(), \"parlor-survey-\"));\n  const timeout = AbortSignal.timeout(SURVEY_TIMEOUT_MS);\n  const signal = stop ? AbortSignal.any([stop, timeout]) : timeout;\n  try {\n    const connection = await launcher.launch(profile, { cwd, env, signal });\n    const end = () => void connection.kill();\n    signal.addEventListener(\"abort\", end, { once: true });\n    try {\n      if (!connection.capabilities.ready) return undefined;\n      const session = await connection.openSession({\n        cwd,\n        mcpServers: [],\n        pinAskMode: true,\n      });\n      return session.options;\n    } finally {\n      signal.removeEventListener(\"abort\", end);\n      await connection.kill();\n    }\n  } catch {\n    return undefined;\n  } finally {\n    await rm(cwd, { recursive: true, force: true });\n  }\n}\n\n/**\n * The account's allowance from the agent's own CLI, for an agent whose ACP adapter does not\n * carry it: `codex-acp` drops Codex's rate limits. Claude Code sends its own over ACP.\n */\nexport async function readUsage(\n  profile: AgentProfile,\n  env: Readonly<Record<string, string>>,\n  now: number,\n): Promise<AgentUsage | undefined> {\n  if (profile.id !== \"codex\") return undefined;\n  return codexUsageOf(\n    await askCodex(profile.binary, \"account/rateLimits/read\", null, env),\n    now,\n  );\n}\n"]}

package/dist/codex-app-server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * One JSON-RPC call to a Codex app-server of its own, started for it and stopped after. For
+ * what Codex keeps but `codex-acp` drops, such as the account's rate limits; it costs no
+ * model turn. Undefined when anything goes wrong: Codex is missing, slow, or answers oddly.
+ */
+export declare function askCodex(binary: string, method: string, params: unknown, env: Readonly<Record<string, string>>): Promise<unknown>;
+//# sourceMappingURL=codex-app-server.d.ts.map

package/dist/codex-app-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-app-server.d.ts","sourceRoot":"","sources":["../src/codex-app-server.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACpC,OAAO,CAAC,OAAO,CAAC,CA+BlB"}

package/dist/codex-app-server.js

@@ -0,0 +1,46 @@
+import { spawn } from "node:child_process";
+import { onLines } from "./lines.js";
+const INITIALIZE = 1;
+const CALL = 2;
+const TIMEOUT_MS = 30_000;
+/** Codex only echoes it back inside a user agent. */
+const CLIENT_INFO = { name: "parlor-host", version: "1" };
+/**
+ * One JSON-RPC call to a Codex app-server of its own, started for it and stopped after. For
+ * what Codex keeps but `codex-acp` drops, such as the account's rate limits; it costs no
+ * model turn. Undefined when anything goes wrong: Codex is missing, slow, or answers oddly.
+ */
+export function askCodex(binary, method, params, env) {
+    return new Promise((resolve) => {
+        let answer;
+        const child = spawn(binary, ["app-server"], {
+            env,
+            stdio: ["pipe", "pipe", "ignore"],
+        });
+        const timer = setTimeout(() => child.kill("SIGKILL"), TIMEOUT_MS);
+        const send = (message) => child.stdin.write(`${JSON.stringify({ jsonrpc: "2.0", ...message })}\n`);
+        onLines(child.stdout, (line) => {
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                return;
+            }
+            if (message.id === INITIALIZE)
+                send({ id: CALL, method, params });
+            else if (message.id === CALL) {
+                answer = message.result;
+                child.kill();
+            }
+        });
+        child.stdin.on("error", () => undefined);
+        child.once("error", () => resolve(undefined));
+        child.once("close", () => {
+            clearTimeout(timer);
+            resolve(answer);
+        });
+        send({ id: INITIALIZE, method: "initialize", params: { clientInfo: CLIENT_INFO } });
+    });
+}
+//# sourceMappingURL=codex-app-server.js.map

package/dist/codex-app-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-app-server.js","sourceRoot":"","sources":["../src/codex-app-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,qDAAqD;AACrD,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAc,EACd,MAAc,EACd,MAAe,EACf,GAAqC;IAErC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,MAAe,CAAC;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE;YAC1C,GAAG;YACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE,CAC/B,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3E,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC7B,IAAI,OAA6D,CAAC;YAClE,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,IAAI,OAAO,CAAC,EAAE,KAAK,UAAU;gBAAE,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;iBAC7D,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC7B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBACxB,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { spawn } from \"node:child_process\";\n\nimport { onLines } from \"./lines.js\";\n\nconst INITIALIZE = 1;\nconst CALL = 2;\nconst TIMEOUT_MS = 30_000;\n/** Codex only echoes it back inside a user agent. */\nconst CLIENT_INFO = { name: \"parlor-host\", version: \"1\" };\n\n/**\n * One JSON-RPC call to a Codex app-server of its own, started for it and stopped after. For\n * what Codex keeps but `codex-acp` drops, such as the account's rate limits; it costs no\n * model turn. Undefined when anything goes wrong: Codex is missing, slow, or answers oddly.\n */\nexport function askCodex(\n  binary: string,\n  method: string,\n  params: unknown,\n  env: Readonly<Record<string, string>>,\n): Promise<unknown> {\n  return new Promise((resolve) => {\n    let answer: unknown;\n    const child = spawn(binary, [\"app-server\"], {\n      env,\n      stdio: [\"pipe\", \"pipe\", \"ignore\"],\n    });\n    const timer = setTimeout(() => child.kill(\"SIGKILL\"), TIMEOUT_MS);\n    const send = (message: object) =>\n      child.stdin.write(`${JSON.stringify({ jsonrpc: \"2.0\", ...message })}\\n`);\n    onLines(child.stdout, (line) => {\n      let message: { readonly id?: unknown; readonly result?: unknown };\n      try {\n        message = JSON.parse(line) as typeof message;\n      } catch {\n        return;\n      }\n      if (message.id === INITIALIZE) send({ id: CALL, method, params });\n      else if (message.id === CALL) {\n        answer = message.result;\n        child.kill();\n      }\n    });\n    child.stdin.on(\"error\", () => undefined);\n    child.once(\"error\", () => resolve(undefined));\n    child.once(\"close\", () => {\n      clearTimeout(timer);\n      resolve(answer);\n    });\n    send({ id: INITIALIZE, method: \"initialize\", params: { clientInfo: CLIENT_INFO } });\n  });\n}\n"]}

package/dist/daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAU9C,OAAO,EAA8B,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAQ/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAI9D,OAAO,EAAE,KAAK,WAAW,EAAoC,MAAM,cAAc,CAAC;AAElF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,6GAA6G;IAC7G,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,kFAAkF;IAClF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAChE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACnE,kFAAkF;IAClF,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAChF,4EAA4E;IAC5E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAiBD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,GAAG,SAAuB,GACtC,OAAO,CAAC,IAAI,CAAC,CAqBf;AAWD,6FAA6F;AAC7F,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,cAEC;CACF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAsoBhE"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAW9C,OAAO,EAA8B,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAQ/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAI9D,OAAO,EAAE,KAAK,WAAW,EAAoC,MAAM,cAAc,CAAC;AAElF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,6GAA6G;IAC7G,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,kFAAkF;IAClF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAChE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACnE,kFAAkF;IAClF,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAChF,4EAA4E;IAC5E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAiBD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,GAAG,SAAuB,GACtC,OAAO,CAAC,IAAI,CAAC,CAqBf;AAWD,6FAA6F;AAC7F,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,cAEC;CACF;AAKD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAssBhE"}

package/dist/daemon.js

@@ -3,6 +3,7 @@ import { createServer } from "node:net";
 import { basename, delimiter, dirname, join } from "node:path";
 import { HOST_PROTOCOL, } from "@parlor/chat";
 import { ActionError, asId, DEV_USER_ID } from "@parlor/core";
+import { readUsage, surveyOptions } from "./agent-survey.js";
 import { agentNames, registerAgentTools, unregisterAgentTools, } from "./agent-tools.js";
 import { detectAgents, loadProfiles } from "./agents.js";
 import { connectControl } from "./control.js";
@@ -63,6 +64,8 @@ export class HostAlreadyRunning extends Error {
         super("Parlor Host is already running on this computer.");
     }
 }
+/** Codex's own CLI throttles its rate-limit reports on the same interval. */
+const USAGE_READ_FLOOR_MS = 30_000;
 export function createHostDaemon(deps) {
     const { paths } = deps;
     const links = new Map();
@@ -89,14 +92,75 @@ export function createHostDaemon(deps) {
             return undefined;
         }
     };
+    /** What an agent said about itself, told to every linked app when it changes what they show. */
+    const learn = (agentId, news) => {
+        void learned
+            .learn(agentId, news)
+            .then((changed) => {
+            if (!changed)
+                return;
+            for (const linked of links.values())
+                void report(linked).catch(() => undefined);
+        })
+            .catch(() => undefined);
+    };
+    /** Ends the reads below on stop or handover, so nothing outlives the daemon. */
+    const stopping = new AbortController();
+    const usageReadAt = new Map();
+    /** The allowance from the agent's own CLI where ACP carries none, at most every 30s per agent. */
+    const refreshUsage = async (agentId) => {
+        const profile = profiles.find((candidate) => candidate.id === agentId);
+        const now = Date.now();
+        if (!profile || stopping.signal.aborted)
+            return;
+        if (now - (usageReadAt.get(agentId) ?? 0) < USAGE_READ_FLOOR_MS)
+            return;
+        usageReadAt.set(agentId, now);
+        const usage = await readUsage(profile, await agentEnvironment(), now).catch(() => undefined);
+        if (usage && !stopping.signal.aborted)
+            learn(agentId, { usage });
+    };
+    let surveyed = false;
+    /**
+     * Options for every agent that has not run a turn yet, so the sidebar can offer a model first.
+     * Once per run, when an app first links: a computer no app uses never starts its agents.
+     */
+    const surveyAgents = async () => {
+        if (surveyed)
+            return;
+        surveyed = true;
+        const env = await agentEnvironment();
+        for (const agent of agents) {
+            const profile = profiles.find((candidate) => candidate.id === agent.id);
+            if (!profile || stopping.signal.aborted)
+                continue;
+            void refreshUsage(agent.id);
+            if (learned.knows(agent.id))
+                continue;
+            const options = await surveyOptions(profile, deps.launcher, env, stopping.signal);
+            if (stopping.signal.aborted)
+                return;
+            logEvent("agent_surveyed", { agentId: agent.id, options: options?.length ?? 0 });
+            if (options && options.length > 0)
+                learn(agent.id, { options });
+        }
+    };
     const running = new Set();
     let handedOver = false;
     let finishing = false;
     let finishHandover = () => undefined;
     const drained = new Promise((resolve) => (finishHandover = resolve));
-    const run = (state, claimed) => {
+    /** A turn runs once here, even when a pushed turn its app took back is claimed again. */
+    const runningTurns = new Set();
+    const run = (state, claimed, how = "claimed") => {
         const { link } = state;
-        logEvent("turn_claimed", { appOrigin: link.grant.appOrigin, turnId: claimed.turnId });
+        if (runningTurns.has(claimed.turnId))
+            return;
+        runningTurns.add(claimed.turnId);
+        logEvent(how === "pushed" ? "turn_pushed" : "turn_claimed", {
+            appOrigin: link.grant.appOrigin,
+            turnId: claimed.turnId,
+        });
         state.turns += 1;
         const turn = (link.grant.dev ? Promise.resolve(DEV_POLICY) : loadPolicy(paths.policy, deps.policy))
             .then((policy) => runTurn(claimed, {
@@ -119,17 +183,7 @@ export function createHostDaemon(deps) {
             policy,
             prompter: deps.prompter,
             now: Date.now,
-            learned: (agentId, news) => {
-                void learned
-                    .learn(agentId, news)
-                    .then((changed) => {
-                    if (!changed)
-                        return;
-                    for (const linked of links.values())
-                        void report(linked).catch(() => undefined);
-                })
-                    .catch(() => undefined);
-            },
+            learned: learn,
             pairing: {
                 secret: async () => (await deps.grants.get(link.grant.appOrigin))?.pairingSecret,
                 forget: async () => {
@@ -143,6 +197,8 @@ export function createHostDaemon(deps) {
         }))
             .then((outcome) => logEvent("turn_finished", { turnId: claimed.turnId, outcome }), (error) => logEvent("turn_finished", { turnId: claimed.turnId, error: String(error) }))
             .finally(() => {
+            runningTurns.delete(claimed.turnId);
+            void refreshUsage(claimed.agent.agentId);
             state.turns -= 1;
             running.delete(turn);
             settleHandover();
@@ -256,6 +312,7 @@ export function createHostDaemon(deps) {
         await deps.pool.forget(grant);
     };
     const open = (grant, keys) => {
+        void surveyAgents().catch(() => undefined);
         const origin = grant.appOrigin;
         latest.set(origin, grant);
         let state;
@@ -266,6 +323,13 @@ export function createHostDaemon(deps) {
             platform,
             fetch: (input, init) => fetch(input, init),
             onWake: () => wake(state),
+            onPushed: (_link, turn) => {
+                // Tells the app this computer has the turn, while it already starts on it.
+                void link.api.calls
+                    .call("hostAppend", { turnId: turn.turnId, items: [] })
+                    .catch(() => undefined);
+                run(state, turn, "pushed");
+            },
             busy: () => state.turns > 0,
             onRevoked: () => {
                 if (links.get(origin) !== state)
@@ -485,6 +549,7 @@ export function createHostDaemon(deps) {
             if (handedOver)
                 return;
             handedOver = true;
+            stopping.abort();
             for (const state of links.values())
                 state.link.drain();
             await Promise.all([...links.values()].map((state) => state.claiming));
@@ -495,6 +560,7 @@ export function createHostDaemon(deps) {
             logEvent("handover_started", { version: deps.release.version });
         },
         async stop() {
+            stopping.abort();
             if (!handedOver) {
                 await Promise.all([...links.values()].map((state) => Promise.race([
                     state.link.api.calls.call("hostReport", {