@parlor/agent-host 0.2.0 → 0.3.1

package/dist/agent-tools.js

@@ -0,0 +1,71 @@
+import { execFile } from "node:child_process";
+import { logEvent } from "./log.js";
+import { appServerOf } from "./naming.js";
+const LOCAL_HOSTS = new Set(["localhost", "127.0.0.1", "[::1]"]);
+/**
+ * The app's name, with its host and port when it is not a deployed site on the default
+ * port: `coursekit`, or `coursekit-localhost-7001` beside it.
+ */
+export function agentToolsName(appName, appOrigin) {
+    const url = new URL(appOrigin);
+    const base = appServerOf(appName);
+    if (!LOCAL_HOSTS.has(url.hostname) && url.port === "")
+        return base;
+    const where = url.host
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return `${base}-${where}`;
+}
+const REGISTRARS = {
+    claude: {
+        add: (name, command) => ["mcp", "add", "--scope", "user", name, "--", ...command],
+        remove: (name) => ["mcp", "remove", "--scope", "user", name],
+    },
+    codex: {
+        add: (name, command) => ["mcp", "add", name, "--", ...command],
+        remove: (name) => ["mcp", "remove", name],
+    },
+};
+function run(binary, args, env) {
+    return new Promise((resolve) => {
+        execFile(binary, [...args], { env, timeout: 30_000 }, (error) => resolve(!error));
+    });
+}
+/** Registers `appOrigin` with every installed agent that has a CLI for it; returns those that took it. */
+export async function registerAgentTools(deps, app) {
+    const name = agentToolsName(app.appName, app.appOrigin);
+    const command = [deps.hostCommand, "mcp-proxy", "--app", app.appOrigin];
+    const env = await deps.env();
+    const agents = [];
+    for (const profile of deps.profiles) {
+        const registrar = REGISTRARS[profile.id];
+        if (!registrar)
+            continue;
+        await run(profile.binary, registrar.remove(name), env);
+        if (await run(profile.binary, registrar.add(name, command), env))
+            agents.push(profile.id);
+    }
+    logEvent("agent_tools_registered", { appOrigin: app.appOrigin, name, agents });
+    return { name, agents };
+}
+/** Removes the app from the agents it was registered with; an agent already rid of it is fine. */
+export async function unregisterAgentTools(deps, tools) {
+    const env = await deps.env();
+    for (const id of tools.agents) {
+        const registrar = REGISTRARS[id];
+        const profile = deps.profiles.find((candidate) => candidate.id === id);
+        if (!registrar || !profile)
+            continue;
+        await run(profile.binary, registrar.remove(tools.name), env);
+    }
+    logEvent("agent_tools_removed", { name: tools.name, agents: tools.agents });
+}
+/** The agents an `AgentTools` names, as people know them: "Claude Code and Codex". */
+export function agentNames(profiles, tools) {
+    const names = tools.agents.map((id) => profiles.find((profile) => profile.id === id)?.name ?? id);
+    return names.length <= 1
+        ? (names[0] ?? "")
+        : `${names.slice(0, -1).join(", ")} and ${names.at(-1)}`;
+}
+//# sourceMappingURL=agent-tools.js.map

package/dist/agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.js","sourceRoot":"","sources":["../src/agent-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile } from \"node:child_process\";\n\nimport type { AgentProfile } from \"./agents.js\";\nimport { logEvent } from \"./log.js\";\nimport { appServerOf } from \"./naming.js\";\n\n/** What a grant hands the coding agents on this computer, outside the app's sidebar. */\nexport interface AgentTools {\n  /** The MCP server name the agents know the app by, and the name the user asks them with. */\n  readonly name: string;\n  /** The agents it is registered with, by profile id. */\n  readonly agents: readonly string[];\n}\n\nconst LOCAL_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"[::1]\"]);\n\n/**\n * The app's name, with its host and port when it is not a deployed site on the default\n * port: `coursekit`, or `coursekit-localhost-7001` beside it.\n */\nexport function agentToolsName(appName: string, appOrigin: string): string {\n  const url = new URL(appOrigin);\n  const base = appServerOf(appName);\n  if (!LOCAL_HOSTS.has(url.hostname) && url.port === \"\") return base;\n  const where = url.host\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return `${base}-${where}`;\n}\n\n/** How one coding agent's own CLI adds and removes a user-wide stdio MCP server. */\ninterface Registrar {\n  add(name: string, command: readonly string[]): readonly string[];\n  remove(name: string): readonly string[];\n}\n\nconst REGISTRARS: Readonly<Record<string, Registrar>> = {\n  claude: {\n    add: (name, command) => [\"mcp\", \"add\", \"--scope\", \"user\", name, \"--\", ...command],\n    remove: (name) => [\"mcp\", \"remove\", \"--scope\", \"user\", name],\n  },\n  codex: {\n    add: (name, command) => [\"mcp\", \"add\", name, \"--\", ...command],\n    remove: (name) => [\"mcp\", \"remove\", name],\n  },\n};\n\nexport interface AgentToolsDeps {\n  /** The installed agents; only those with a known CLI are registered with. */\n  readonly profiles: readonly AgentProfile[];\n  /** The absolute path of `parlor-host`, which the agents launch as the MCP server. */\n  readonly hostCommand: string;\n  readonly env: () => Promise<Record<string, string>>;\n}\n\nfunction run(\n  binary: string,\n  args: readonly string[],\n  env: Record<string, string>,\n): Promise<boolean> {\n  return new Promise((resolve) => {\n    execFile(binary, [...args], { env, timeout: 30_000 }, (error) => resolve(!error));\n  });\n}\n\n/** Registers `appOrigin` with every installed agent that has a CLI for it; returns those that took it. */\nexport async function registerAgentTools(\n  deps: AgentToolsDeps,\n  app: { readonly appName: string; readonly appOrigin: string },\n): Promise<AgentTools> {\n  const name = agentToolsName(app.appName, app.appOrigin);\n  const command = [deps.hostCommand, \"mcp-proxy\", \"--app\", app.appOrigin];\n  const env = await deps.env();\n  const agents: string[] = [];\n  for (const profile of deps.profiles) {\n    const registrar = REGISTRARS[profile.id];\n    if (!registrar) continue;\n    await run(profile.binary, registrar.remove(name), env);\n    if (await run(profile.binary, registrar.add(name, command), env))\n      agents.push(profile.id);\n  }\n  logEvent(\"agent_tools_registered\", { appOrigin: app.appOrigin, name, agents });\n  return { name, agents };\n}\n\n/** Removes the app from the agents it was registered with; an agent already rid of it is fine. */\nexport async function unregisterAgentTools(\n  deps: AgentToolsDeps,\n  tools: AgentTools,\n): Promise<void> {\n  const env = await deps.env();\n  for (const id of tools.agents) {\n    const registrar = REGISTRARS[id];\n    const profile = deps.profiles.find((candidate) => candidate.id === id);\n    if (!registrar || !profile) continue;\n    await run(profile.binary, registrar.remove(tools.name), env);\n  }\n  logEvent(\"agent_tools_removed\", { name: tools.name, agents: tools.agents });\n}\n\n/** The agents an `AgentTools` names, as people know them: \"Claude Code and Codex\". */\nexport function agentNames(profiles: readonly AgentProfile[], tools: AgentTools): string {\n  const names = tools.agents.map(\n    (id) => profiles.find((profile) => profile.id === id)?.name ?? id,\n  );\n  return names.length <= 1\n    ? (names[0] ?? \"\")\n    : `${names.slice(0, -1).join(\", \")} and ${names.at(-1)}`;\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/control.d.ts

@@ -32,6 +32,10 @@ export type ControlRequest = {
 } | {
     readonly op: "disconnect";
     readonly appOrigin: string;
+} | {
+    readonly op: "agent_tools";
+    readonly appOrigin: string;
+    readonly on: boolean;
 } | {
     readonly op: "dev_attach";
     readonly appOrigin: string;
@@ -46,6 +50,11 @@ export interface GrantSummary {
     readonly appName: string;
     readonly grantId: string;
 }
+/** The app's MCP server name in the coding agents on this computer, and which have it. */
+export interface AgentToolsSummary {
+    readonly name: string;
+    readonly agents: string;
+}
 export type ControlFailure = {
     readonly ok: false;
     readonly error: string;
@@ -68,6 +77,7 @@ interface ControlReplies {
     };
     readonly connect: {
         readonly ok: true;
+        readonly agentTools?: AgentToolsSummary;
     };
     readonly begin_local_pairing: {
         readonly ok: true;
@@ -87,6 +97,11 @@ interface ControlReplies {
     };
     readonly disconnect: {
         readonly ok: true;
+        readonly agentTools?: AgentToolsSummary;
+    };
+    readonly agent_tools: {
+        readonly ok: true;
+        readonly agentTools?: AgentToolsSummary;
     };
     readonly dev_attach: {
         readonly ok: true;

package/dist/control.d.ts.map

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

package/dist/control.js.map

@@ -1 +1 @@
-{"version":3,"file":"control.js","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAInC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAsElC,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB;IAElB,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACvD,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAA2C,EAAE,CAAC;IAC3D,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACtB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAChB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACpB,OAAO,CACL,IAAI,KAAK,SAAS;gBAChB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE;gBAC5D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CACrB,CACF,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC;QACJ,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE;KAC1B,CAAC;AACJ,CAAC","sourcesContent":["import { connect } from \"node:net\";\n\nimport type { HostPairing, LocalHostStatus, PairingDevice } from \"@parlor/capabilities\";\n\nimport { onLines } from \"./lines.js\";\nimport type { HostRelease, ServiceClient } from \"./service.js\";\n\nexport const CONTROL_PROTOCOL = 1;\n\n/**\n * Newline-delimited JSON on a 0600 Unix socket (a named pipe on Windows), spoken by the\n * `parlor-host` CLI and the desktop shell's Rust side. No TCP listener exists.\n */\nexport type ControlRequest =\n  | { readonly op: \"hello\"; readonly client: ServiceClient }\n  | { readonly op: \"handover\"; readonly binary: string; readonly signature: string }\n  | { readonly op: \"status\" }\n  | { readonly op: \"connect\"; readonly appOrigin: string }\n  | { readonly op: \"begin_local_pairing\"; readonly appOrigin: string }\n  | {\n      readonly op: \"finish_local_pairing\";\n      readonly appOrigin: string;\n      readonly code: string;\n    }\n  | {\n      readonly op: \"confirm_local_pairing\";\n      readonly appOrigin: string;\n      readonly connect: boolean;\n      readonly device?: PairingDevice;\n    }\n  | { readonly op: \"disconnect\"; readonly appOrigin: string }\n  | { readonly op: \"dev_attach\"; readonly appOrigin: string; readonly hostToken: string }\n  | { readonly op: \"dev_detach\"; readonly appOrigin: string };\n\nexport type ControlOp = ControlRequest[\"op\"];\n\nexport interface GrantSummary {\n  readonly appOrigin: string;\n  readonly appName: string;\n  readonly grantId: string;\n}\n\nexport type ControlFailure = { readonly ok: false; readonly error: string };\n\ninterface ControlReplies {\n  readonly hello: { readonly ok: true; readonly release: HostRelease };\n  readonly handover:\n    | { readonly ok: true }\n    | { readonly ok: false; readonly error: \"unsigned\" | \"downgrade\" };\n  readonly status: {\n    readonly ok: true;\n    readonly status: LocalHostStatus;\n    readonly grants: readonly GrantSummary[];\n  };\n  readonly connect: { readonly ok: true };\n  readonly begin_local_pairing: { readonly ok: true; readonly pairing: HostPairing };\n  readonly finish_local_pairing: {\n    readonly ok: true;\n    readonly account: string;\n    readonly appName: string;\n    readonly matchingCode: string;\n  };\n  readonly confirm_local_pairing:\n    | { readonly ok: true }\n    | { readonly ok: false; readonly error: \"declined_locally\" };\n  readonly disconnect: { readonly ok: true };\n  readonly dev_attach: { readonly ok: true };\n  readonly dev_detach: { readonly ok: true };\n}\n\nexport type ControlResponse<O extends ControlOp> = ControlReplies[O] | ControlFailure;\n\nexport interface ControlClient {\n  send<R extends ControlRequest>(request: R): Promise<ControlResponse<R[\"op\"]>>;\n  close(): void;\n}\n\n/** `undefined` when no daemon answers on the socket. */\nexport async function connectControl(\n  socketPath: string,\n): Promise<ControlClient | undefined> {\n  const socket = connect(socketPath);\n  const connected = await new Promise<boolean>((resolve) => {\n    socket.once(\"connect\", () => resolve(true));\n    socket.once(\"error\", () => resolve(false));\n  });\n  if (!connected) {\n    socket.destroy();\n    return undefined;\n  }\n  const waiting: ((line: string | undefined) => void)[] = [];\n  onLines(socket, (line) => waiting.shift()?.(line));\n  socket.on(\"close\", () => {\n    for (const reply of waiting.splice(0)) reply(undefined);\n  });\n  socket.on(\"error\", () => socket.destroy());\n  return {\n    send: (request) =>\n      new Promise((resolve) => {\n        waiting.push((line) =>\n          resolve(\n            line === undefined\n              ? { ok: false, error: \"Parlor Host closed the connection.\" }\n              : JSON.parse(line),\n          ),\n        );\n        socket.write(`${JSON.stringify(request)}\\n`);\n      }),\n    close: () => socket.end(),\n  };\n}\n"]}
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAInC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AA8ElC,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB;IAElB,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACvD,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAA2C,EAAE,CAAC;IAC3D,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACtB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAChB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACpB,OAAO,CACL,IAAI,KAAK,SAAS;gBAChB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE;gBAC5D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CACrB,CACF,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC;QACJ,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE;KAC1B,CAAC;AACJ,CAAC","sourcesContent":["import { connect } from \"node:net\";\n\nimport type { HostPairing, LocalHostStatus, PairingDevice } from \"@parlor/capabilities\";\n\nimport { onLines } from \"./lines.js\";\nimport type { HostRelease, ServiceClient } from \"./service.js\";\n\nexport const CONTROL_PROTOCOL = 1;\n\n/**\n * Newline-delimited JSON on a 0600 Unix socket (a named pipe on Windows), spoken by the\n * `parlor-host` CLI and the desktop shell's Rust side. No TCP listener exists.\n */\nexport type ControlRequest =\n  | { readonly op: \"hello\"; readonly client: ServiceClient }\n  | { readonly op: \"handover\"; readonly binary: string; readonly signature: string }\n  | { readonly op: \"status\" }\n  | { readonly op: \"connect\"; readonly appOrigin: string }\n  | { readonly op: \"begin_local_pairing\"; readonly appOrigin: string }\n  | {\n      readonly op: \"finish_local_pairing\";\n      readonly appOrigin: string;\n      readonly code: string;\n    }\n  | {\n      readonly op: \"confirm_local_pairing\";\n      readonly appOrigin: string;\n      readonly connect: boolean;\n      readonly device?: PairingDevice;\n    }\n  | { readonly op: \"disconnect\"; readonly appOrigin: string }\n  | { readonly op: \"agent_tools\"; readonly appOrigin: string; readonly on: boolean }\n  | { readonly op: \"dev_attach\"; readonly appOrigin: string; readonly hostToken: string }\n  | { readonly op: \"dev_detach\"; readonly appOrigin: string };\n\nexport type ControlOp = ControlRequest[\"op\"];\n\nexport interface GrantSummary {\n  readonly appOrigin: string;\n  readonly appName: string;\n  readonly grantId: string;\n}\n\n/** The app's MCP server name in the coding agents on this computer, and which have it. */\nexport interface AgentToolsSummary {\n  readonly name: string;\n  readonly agents: string;\n}\n\nexport type ControlFailure = { readonly ok: false; readonly error: string };\n\ninterface ControlReplies {\n  readonly hello: { readonly ok: true; readonly release: HostRelease };\n  readonly handover:\n    | { readonly ok: true }\n    | { readonly ok: false; readonly error: \"unsigned\" | \"downgrade\" };\n  readonly status: {\n    readonly ok: true;\n    readonly status: LocalHostStatus;\n    readonly grants: readonly GrantSummary[];\n  };\n  readonly connect: { readonly ok: true; readonly agentTools?: AgentToolsSummary };\n  readonly begin_local_pairing: { readonly ok: true; readonly pairing: HostPairing };\n  readonly finish_local_pairing: {\n    readonly ok: true;\n    readonly account: string;\n    readonly appName: string;\n    readonly matchingCode: string;\n  };\n  readonly confirm_local_pairing:\n    | { readonly ok: true }\n    | { readonly ok: false; readonly error: \"declined_locally\" };\n  readonly disconnect: { readonly ok: true; readonly agentTools?: AgentToolsSummary };\n  readonly agent_tools: { readonly ok: true; readonly agentTools?: AgentToolsSummary };\n  readonly dev_attach: { readonly ok: true };\n  readonly dev_detach: { readonly ok: true };\n}\n\nexport type ControlResponse<O extends ControlOp> = ControlReplies[O] | ControlFailure;\n\nexport interface ControlClient {\n  send<R extends ControlRequest>(request: R): Promise<ControlResponse<R[\"op\"]>>;\n  close(): void;\n}\n\n/** `undefined` when no daemon answers on the socket. */\nexport async function connectControl(\n  socketPath: string,\n): Promise<ControlClient | undefined> {\n  const socket = connect(socketPath);\n  const connected = await new Promise<boolean>((resolve) => {\n    socket.once(\"connect\", () => resolve(true));\n    socket.once(\"error\", () => resolve(false));\n  });\n  if (!connected) {\n    socket.destroy();\n    return undefined;\n  }\n  const waiting: ((line: string | undefined) => void)[] = [];\n  onLines(socket, (line) => waiting.shift()?.(line));\n  socket.on(\"close\", () => {\n    for (const reply of waiting.splice(0)) reply(undefined);\n  });\n  socket.on(\"error\", () => socket.destroy());\n  return {\n    send: (request) =>\n      new Promise((resolve) => {\n        waiting.push((line) =>\n          resolve(\n            line === undefined\n              ? { ok: false, error: \"Parlor Host closed the connection.\" }\n              : JSON.parse(line),\n          ),\n        );\n        socket.write(`${JSON.stringify(request)}\\n`);\n      }),\n    close: () => socket.end(),\n  };\n}\n"]}

package/dist/daemon.d.ts

@@ -27,12 +27,20 @@ export interface DaemonDeps {
  */
 export interface HostDaemon {
     start(): Promise<void>;
-    connect(appOrigin: string): Promise<void>;
-    disconnect(appOrigin: string): Promise<void>;
+    /** What the coding agents here know the app by, when the user let them use it. */
+    connect(appOrigin: string): Promise<ConnectedTools | undefined>;
+    disconnect(appOrigin: string): Promise<ConnectedTools | undefined>;
+    /** Lets the coding agents here use the app outside its sidebar, or stops them. */
+    agentTools(appOrigin: string, on: boolean): Promise<ConnectedTools | undefined>;
     /** Hands links over to a newer release; running turns finish here first. */
     handover(): Promise<void>;
     stop(): Promise<void>;
 }
+/** The app's MCP server name in the coding agents here, and which of them have it. */
+export interface ConnectedTools {
+    readonly name: string;
+    readonly agents: string;
+}
 /**
  * Agents start `parlor-host mcp-proxy` by name. An entry named otherwise, such as the
  * published `dist/main.js` that `parlor dev` runs with node, gets a shim instead of a link.

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;AAI9C,OAAO,EAA8B,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKzF,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;AAClF,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,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAeD;;;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,CA4fhE"}
+{"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"}