glasspane-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jingzhao-l
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# glasspane-mcp
+
+GlassPane 的 MCP 服务器（stdio）：把 AI 客户端的 `gp_*` 工具调用转发给本机
+GlassPane 后台服务，并把每一次界面操作的证据带回给你。
+
+## 用法
+
+```bash
+npm i -g glasspane-mcp
+glasspane-mcp            # 默认连接 ~/.glasspane/engine.sock
+GLASSPANE_ENGINE_SOCK=/path/to/engine.sock glasspane-mcp
+```
+
+MCP 客户端配置：
+
+```json
+{ "mcpServers": { "glasspane": { "command": "glasspane-mcp" } } }
+```
+
+后台服务未运行或权限未就绪时，工具调用会返回带补救步骤的结构化错误——
+按错误里的命令执行即可，无需查阅其它文档。
+
+工具清单与语义以 `gp_*` 运行时 `tools/list` 返回为准。
+License: MIT.

package/dist/audit-session.d.ts

@@ -0,0 +1,22 @@
+/**
+ * In-memory session trail of operationIds seen by this MCP server process.
+ * The daemon's method table is frozen (P1 spec v1.3 §10.3), so `gp_recent_reports`
+ * cannot ask the daemon to enumerate its history — this shell tracks the
+ * operationIds returned by act/assert/diagnose/restore/last_evidence itself,
+ * mirroring the daemon's bounded-memory semantics.
+ *
+ * Lifecycle: cleared on every successful `gp_attach` (the daemon invalidates
+ * its evidence history when the attached app changes; re-attach is idempotent
+ * and simply restarts the trail). Does not persist across process restarts.
+ */
+export declare const AUDIT_HISTORY_LIMIT = 20;
+export declare class EvidenceAuditSession {
+    private ids;
+    /** Record every operationId/evidenceId found in an engine result frame. */
+    record(result: unknown): void;
+    /** Clear the trail (called after a successful attach). */
+    reset(): void;
+    /** The most recent `limit` recorded operationIds, oldest first. */
+    recentIds(limit: number): string[];
+}
+//# sourceMappingURL=audit-session.d.ts.map

package/dist/audit-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-session.d.ts","sourceRoot":"","sources":["../src/audit-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,GAAG,CAAgB;IAE3B,2EAA2E;IAC3E,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAW7B,0DAA0D;IAC1D,KAAK,IAAI,IAAI;IAIb,mEAAmE;IACnE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAGnC"}

package/dist/audit-session.js

@@ -0,0 +1,64 @@
+/**
+ * In-memory session trail of operationIds seen by this MCP server process.
+ * The daemon's method table is frozen (P1 spec v1.3 §10.3), so `gp_recent_reports`
+ * cannot ask the daemon to enumerate its history — this shell tracks the
+ * operationIds returned by act/assert/diagnose/restore/last_evidence itself,
+ * mirroring the daemon's bounded-memory semantics.
+ *
+ * Lifecycle: cleared on every successful `gp_attach` (the daemon invalidates
+ * its evidence history when the attached app changes; re-attach is idempotent
+ * and simply restarts the trail). Does not persist across process restarts.
+ */
+export const AUDIT_HISTORY_LIMIT = 20;
+export class EvidenceAuditSession {
+    ids = [];
+    /** Record every operationId/evidenceId found in an engine result frame. */
+    record(result) {
+        for (const id of collectOperationIds(result)) {
+            if (!this.ids.includes(id)) {
+                this.ids.push(id);
+                if (this.ids.length > AUDIT_HISTORY_LIMIT) {
+                    this.ids.splice(0, this.ids.length - AUDIT_HISTORY_LIMIT);
+                }
+            }
+        }
+    }
+    /** Clear the trail (called after a successful attach). */
+    reset() {
+        this.ids = [];
+    }
+    /** The most recent `limit` recorded operationIds, oldest first. */
+    recentIds(limit) {
+        return this.ids.slice(-limit);
+    }
+}
+/**
+ * Bounded recursive walk (depth ≤ 3) that collects string-valued
+ * `operationId` / `evidenceId` fields — from act/assert/diagnose/restore
+ * results and from nested `evidencePack` frames. Depth is capped so an
+ * adversarial frame cannot force an unbounded descent.
+ */
+function collectOperationIds(value, depth = 0) {
+    const out = [];
+    if (depth > 3 || value === null || typeof value !== "object") {
+        return out;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            out.push(...collectOperationIds(item, depth + 1));
+        }
+        return out;
+    }
+    const record = value;
+    for (const key of Object.keys(record)) {
+        const entry = record[key];
+        if ((key === "operationId" || key === "evidenceId") && typeof entry === "string") {
+            out.push(entry);
+        }
+        else {
+            out.push(...collectOperationIds(entry, depth + 1));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=audit-session.js.map

package/dist/audit-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-session.js","sourceRoot":"","sources":["../src/audit-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,MAAM,OAAO,oBAAoB;IACvB,GAAG,GAAa,EAAE,CAAC;IAE3B,2EAA2E;IAC3E,MAAM,CAAC,MAAe;QACpB,KAAK,MAAM,EAAE,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAClB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;oBAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,KAAK;QACH,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,mEAAmE;IACnE,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IACpD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7D,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,YAAY,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjF,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/canonical.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Canonical JSON serialization: object keys sorted, no insignificant
+ * whitespace. Mirrors the cross-language convention used by the kernel C35
+ * roundtrips so engine results and evidence packs stay byte-stable.
+ */
+export declare function canonicalJson(value: unknown): string;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/canonical.js

@@ -0,0 +1,23 @@
+/**
+ * Canonical JSON serialization: object keys sorted, no insignificant
+ * whitespace. Mirrors the cross-language convention used by the kernel C35
+ * roundtrips so engine results and evidence packs stay byte-stable.
+ */
+export function canonicalJson(value) {
+    return JSON.stringify(sortKeys(value));
+}
+function sortKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => sortKeys(entry));
+    }
+    if (value !== null && typeof value === "object") {
+        const record = value;
+        const sorted = {};
+        for (const key of Object.keys(record).sort()) {
+            sorted[key] = sortKeys(record[key]);
+        }
+        return sorted;
+    }
+    return value;
+}
+//# sourceMappingURL=canonical.js.map

package/dist/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/dispatch.d.ts

@@ -0,0 +1,47 @@
+import { EngineJsonRpcClient } from "./engine-client.js";
+import { ToolSpec } from "./tools.js";
+import { EvidenceAuditSession } from "./audit-session.js";
+export declare const JSONRPC: "2.0";
+/** MCP protocol version echoed on initialize (spec §6.1). */
+export declare const MCP_PROTOCOL_VERSION: "2025-06-18";
+export declare const SERVER_INFO: {
+    readonly name: "glasspane-mcp";
+    readonly version: "0.1.0";
+};
+export declare const PARSE_ERROR = -32700;
+export declare const INVALID_REQUEST = -32600;
+export declare const METHOD_NOT_FOUND = -32601;
+export declare const INVALID_PARAMS = -32602;
+export declare const INTERNAL_ERROR = -32603;
+export interface RpcErrorBody {
+    code: number;
+    message: string;
+}
+export interface RpcResponse {
+    jsonrpc: typeof JSONRPC;
+    id: number | string | null;
+    result?: unknown;
+    error?: RpcErrorBody;
+}
+export interface McpServerDeps {
+    engine: EngineJsonRpcClient;
+    specs?: readonly ToolSpec[];
+    /** Overridable audit session (per-server operationId trail, spec v1.3 §10.3). */
+    session?: EvidenceAuditSession;
+}
+export declare class McpServer {
+    private readonly deps;
+    private readonly specs;
+    private readonly session;
+    constructor(deps: McpServerDeps);
+    /** Handle a single newline-delimited frame; returns a response or null. */
+    handleLine(line: string): Promise<RpcResponse | null>;
+    private handleNotification;
+    private dispatch;
+    private callTool;
+    private asParams;
+    private isRequestBody;
+    private result;
+    private error;
+}
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAA2B,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM1D,eAAO,MAAM,OAAO,EAAG,KAAc,CAAC;AACtC,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,EAAG,YAAqB,CAAC;AAC1D,eAAO,MAAM,WAAW;;;CAAuD,CAAC;AAEhF,eAAO,MAAM,WAAW,SAAS,CAAC;AAClC,eAAO,MAAM,eAAe,SAAS,CAAC;AACtC,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAaD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,iFAAiF;IACjF,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAElB,IAAI,EAAE,aAAa;IAKhD,2EAA2E;IACrE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;YAkC7C,kBAAkB;YAIlB,QAAQ;YA6BR,QAAQ;IAkBtB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,KAAK;CAGd"}

package/dist/dispatch.js

@@ -0,0 +1,122 @@
+import { executeTool, TOOL_SPECS } from "./tools.js";
+import { EvidenceAuditSession } from "./audit-session.js";
+/* ------------------------------------------------------------------ *
+ * JSON-RPC 2.0 message shapes (spec §6.1).
+ * ------------------------------------------------------------------ */
+export const JSONRPC = "2.0";
+/** MCP protocol version echoed on initialize (spec §6.1). */
+export const MCP_PROTOCOL_VERSION = "2025-06-18";
+export const SERVER_INFO = { name: "glasspane-mcp", version: "0.1.0" };
+export const PARSE_ERROR = -32700;
+export const INVALID_REQUEST = -32600;
+export const METHOD_NOT_FOUND = -32601;
+export const INVALID_PARAMS = -32602;
+export const INTERNAL_ERROR = -32603;
+export class McpServer {
+    deps;
+    specs;
+    session;
+    constructor(deps) {
+        this.deps = deps;
+        this.specs = deps.specs ?? TOOL_SPECS;
+        this.session = deps.session ?? new EvidenceAuditSession();
+    }
+    /** Handle a single newline-delimited frame; returns a response or null. */
+    async handleLine(line) {
+        if (line.trim() === "") {
+            return null; // blank frame — no response per protocol §6.1
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            return this.error(PARSE_ERROR, "Parse error", null);
+        }
+        if (!this.isRequestBody(parsed)) {
+            return this.error(INVALID_REQUEST, "Invalid Request", null);
+        }
+        const request = parsed;
+        if (request.id === undefined) {
+            // Notification: process but never answer. Unknown notifications are
+            // ignored rather than rejected (spec §6.1).
+            await this.handleNotification(request);
+            return null;
+        }
+        if (typeof request.id !== "number" && typeof request.id !== "string") {
+            return this.error(INVALID_REQUEST, "Invalid Request", null);
+        }
+        try {
+            return await this.dispatch(request, request.id);
+        }
+        catch (error) {
+            return this.error(INTERNAL_ERROR, `Internal error: ${String(error)}`, request.id);
+        }
+    }
+    async handleNotification(request) {
+        // no-op: only `notifications/initialized` is expected at P0; nothing to do.
+    }
+    async dispatch(request, id) {
+        if (typeof request.method !== "string") {
+            return this.error(INVALID_REQUEST, "Invalid Request", id);
+        }
+        switch (request.method) {
+            case "initialize":
+                return this.result(id, {
+                    protocolVersion: MCP_PROTOCOL_VERSION,
+                    capabilities: { tools: { listChanged: false } },
+                    serverInfo: SERVER_INFO,
+                });
+            case "ping":
+                return this.result(id, {});
+            case "tools/list":
+                return this.result(id, {
+                    tools: this.specs.map((spec) => ({
+                        name: spec.name,
+                        description: spec.description,
+                        inputSchema: spec.inputSchema,
+                    })),
+                });
+            case "tools/call":
+                return this.callTool(id, request.params);
+            default:
+                return this.error(METHOD_NOT_FOUND, `Method not found: ${request.method}`, id);
+        }
+    }
+    async callTool(id, rawParams) {
+        const params = this.asParams(rawParams);
+        if (!params) {
+            return this.error(INVALID_PARAMS, "tools/call requires an object params", id);
+        }
+        const name = params.name;
+        if (typeof name !== "string") {
+            return this.error(INVALID_PARAMS, "tools/call requires a string name", id);
+        }
+        const spec = this.specs.find((candidate) => candidate.name === name);
+        if (!spec) {
+            return this.error(INVALID_PARAMS, `Unknown tool: ${name}`, id);
+        }
+        const outcome = await executeTool(spec, params.arguments, this.deps.engine, this.session);
+        return this.result(id, { content: outcome.content, isError: outcome.isError });
+    }
+    asParams(rawParams) {
+        if (typeof rawParams !== "object" || rawParams === null || Array.isArray(rawParams)) {
+            return null;
+        }
+        return rawParams;
+    }
+    isRequestBody(value) {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            return false;
+        }
+        const candidate = value;
+        return candidate.jsonrpc === JSONRPC;
+    }
+    result(id, result) {
+        return { jsonrpc: JSONRPC, id, result };
+    }
+    error(code, message, id) {
+        return { jsonrpc: JSONRPC, id, error: { code, message } };
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

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

package/dist/engine-client.d.ts

@@ -0,0 +1,54 @@
+import { LineIo } from "./io.js";
+/**
+ * Agent-actionable remedy for an unreachable daemon (P6 §11 audit items ④/⑥:
+ * a remedy must be an executable command, not a prose hint). When the repo
+ * installer is present next to this build, hand over the machine-verified
+ * restore command: it detects a boot-out'd launchd job, bootstraps it, and
+ * verifies the daemon's hello self-report — the only remaining human action
+ * (TCC checkbox) stays honest. Falls back to generic wording otherwise.
+ */
+export declare function daemonUnreachableRemedy(): string;
+/** Env override for the daemon socket path (default below). */
+export declare const ENGINE_SOCKET_ENV = "GLASSPANE_ENGINE_SOCK";
+/** Connection/response timeout, per spec §6.2. */
+export declare const ENGINE_TIMEOUT_MS = 10000;
+/** The daemon listens here by default (spec §3.1). */
+export declare function defaultSocketPath(): string;
+/** Error frame returned by the daemon (spec §3.2.1) or raised by the shell. */
+export interface EngineErrorBody {
+    code: string;
+    message: string;
+    remedy: string;
+}
+export declare class EngineCallError extends Error {
+    readonly code: string;
+    readonly message: string;
+    readonly remedy: string;
+    constructor(code: string, message: string, remedy: string);
+    toBody(): EngineErrorBody;
+}
+/**
+ * Request/response association over a line transport. Kept independent of
+ * the transport so tests inject a fake LineIo (spec §7.1 "fake engine
+ * transport").
+ */
+export declare class EngineJsonRpcClient {
+    private readonly io;
+    private readonly timeoutMs;
+    private nextId;
+    private readonly pending;
+    constructor(io: LineIo, timeoutMs?: number);
+    /** Send a request and await its matching response frame. */
+    call(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    close(): void;
+    private handleMessage;
+    private failAll;
+}
+/** Production client bound to a Unix socket path (lazy connect on first call). */
+export declare function unixSocketEngineClient(socketPath: string): EngineJsonRpcClient;
+/**
+ * Build a client over an existing LineIo (used by tests with a fake
+ * transport and by non-socket connectivity).
+ */
+export declare function engineClientOver(io: LineIo, timeoutMs?: number): EngineJsonRpcClient;
+//# sourceMappingURL=engine-client.d.ts.map

package/dist/engine-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-client.d.ts","sourceRoot":"","sources":["../src/engine-client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAgB,MAAM,SAAS,CAAC;AAG/C;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAOhD;AAED,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AACzD,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,sDAAsD;AACtD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAkB,OAAO,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAQzD,MAAM,IAAI,eAAe;CAG1B;AAaD;;;;GAIG;AACH,qBAAa,mBAAmB;IAK5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAGnC,EAAE,EAAE,MAAM,EACV,SAAS,GAAE,MAA0B;IAexD,4DAA4D;IAC5D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAiCxE,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,OAAO;CAMhB;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAI9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAEpF"}

package/dist/engine-client.js

@@ -0,0 +1,135 @@
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+import { StreamLineIo } from "./io.js";
+import { GP_E_ENGINE_UNREACHABLE } from "./errors.js";
+/**
+ * Agent-actionable remedy for an unreachable daemon (P6 §11 audit items ④/⑥:
+ * a remedy must be an executable command, not a prose hint). When the repo
+ * installer is present next to this build, hand over the machine-verified
+ * restore command: it detects a boot-out'd launchd job, bootstraps it, and
+ * verifies the daemon's hello self-report — the only remaining human action
+ * (TCC checkbox) stays honest. Falls back to generic wording otherwise.
+ */
+export function daemonUnreachableRemedy() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const installerCli = path.resolve(here, "..", "..", "installer", "cli.js");
+    if (fs.existsSync(installerCli)) {
+        return `run "node ${installerCli} --restore-launchd" (auto-restores and verifies the launchd-managed daemon), then retry`;
+    }
+    return "ensure the glasspane daemon is running (launchd job com.glasspane.daemon; in a repo checkout run `node installer/cli.js --restore-launchd`), then retry";
+}
+/** Env override for the daemon socket path (default below). */
+export const ENGINE_SOCKET_ENV = "GLASSPANE_ENGINE_SOCK";
+/** Connection/response timeout, per spec §6.2. */
+export const ENGINE_TIMEOUT_MS = 10_000;
+/** The daemon listens here by default (spec §3.1). */
+export function defaultSocketPath() {
+    return process.env[ENGINE_SOCKET_ENV] ?? path.join(os.homedir(), ".glasspane", "engine.sock");
+}
+export class EngineCallError extends Error {
+    code;
+    message;
+    remedy;
+    constructor(code, message, remedy) {
+        super(`${code}: ${message}`);
+        this.name = "EngineCallError";
+        this.code = code;
+        this.message = message;
+        this.remedy = remedy;
+    }
+    toBody() {
+        return { code: this.code, message: this.message, remedy: this.remedy };
+    }
+}
+/**
+ * Request/response association over a line transport. Kept independent of
+ * the transport so tests inject a fake LineIo (spec §7.1 "fake engine
+ * transport").
+ */
+export class EngineJsonRpcClient {
+    io;
+    timeoutMs;
+    nextId = 0;
+    pending = new Map();
+    constructor(io, timeoutMs = ENGINE_TIMEOUT_MS) {
+        this.io = io;
+        this.timeoutMs = timeoutMs;
+        this.io.onMessage((line) => this.handleMessage(line));
+        this.io.onError((error) => this.failAll(new EngineCallError(GP_E_ENGINE_UNREACHABLE, `engine transport error: ${error.message}`, daemonUnreachableRemedy())));
+        this.io.onClose(() => this.failAll(new EngineCallError(GP_E_ENGINE_UNREACHABLE, "engine transport closed", daemonUnreachableRemedy())));
+    }
+    /** Send a request and await its matching response frame. */
+    call(method, params) {
+        const id = this.nextId++;
+        const frame = { id, method, ...(params === undefined ? {} : { params }) };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new EngineCallError(GP_E_ENGINE_UNREACHABLE, `engine request timed out after ${this.timeoutMs}ms (method ${method})`, daemonUnreachableRemedy()));
+            }, this.timeoutMs);
+            // Deliberately NOT `timer.unref()`. An unreferenced timer does not keep
+            // the event loop alive, so when a pending call is the only outstanding
+            // work Node exits and the timeout is never delivered — the caller waits
+            // on a promise that is settled by process death, not by a diagnosis.
+            // The timeout is this client's only guarantee that every request settles,
+            // so it must be a ref'd handle. It can never hold the loop past
+            // `timeoutMs`: it either fires (and settles the call) or is cleared by
+            // the response / transport-close path below.
+            this.pending.set(id, {
+                resolve,
+                reject: (reason) => {
+                    clearTimeout(timer);
+                    reject(reason);
+                },
+            });
+            this.io.writeLine(JSON.stringify(frame));
+        });
+    }
+    close() {
+        this.io.close();
+    }
+    handleMessage(line) {
+        let frame;
+        try {
+            frame = JSON.parse(line);
+        }
+        catch {
+            // Non-JSON response is not attributable to a request id; drop.
+            return;
+        }
+        const entry = this.pending.get(frame.id);
+        if (!entry) {
+            return; // late/unsolicited frame — drop
+        }
+        this.pending.delete(frame.id);
+        if (frame.error) {
+            entry.reject(new EngineCallError(frame.error.code, frame.error.message, frame.error.remedy));
+        }
+        else {
+            entry.resolve(frame.result);
+        }
+    }
+    failAll(reason) {
+        for (const entry of this.pending.values()) {
+            entry.reject(reason);
+        }
+        this.pending.clear();
+    }
+}
+/** Production client bound to a Unix socket path (lazy connect on first call). */
+export function unixSocketEngineClient(socketPath) {
+    const socket = net.createConnection(socketPath);
+    const io = new StreamLineIo(socket, socket);
+    return new EngineJsonRpcClient(io);
+}
+/**
+ * Build a client over an existing LineIo (used by tests with a fake
+ * transport and by non-socket connectivity).
+ */
+export function engineClientOver(io, timeoutMs) {
+    return new EngineJsonRpcClient(io, timeoutMs);
+}
+//# sourceMappingURL=engine-client.js.map

package/dist/engine-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-client.js","sourceRoot":"","sources":["../src/engine-client.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAU,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC3E,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,OAAO,aAAa,YAAY,yFAAyF,CAAC;IAC5H,CAAC;IACD,OAAO,yJAAyJ,CAAC;AACnK,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AACzD,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC,sDAAsD;AACtD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAChG,CAAC;AASD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACJ,OAAO,CAAS;IACzB,MAAM,CAAS;IAExB,YAAY,IAAY,EAAE,OAAe,EAAE,MAAc;QACvD,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACzE,CAAC;CACF;AAaD;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAKX;IACA;IALX,MAAM,GAAG,CAAC,CAAC;IACF,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEtD,YACmB,EAAU,EACV,YAAoB,iBAAiB;QADrC,OAAE,GAAF,EAAE,CAAQ;QACV,cAAS,GAAT,SAAS,CAA4B;QAEtD,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,eAAe,CACzD,uBAAuB,EACvB,2BAA2B,KAAK,CAAC,OAAO,EAAE,EAC1C,uBAAuB,EAAE,CAC1B,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,eAAe,CACpD,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EAAE,CAC1B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC,MAAc,EAAE,MAAgC;QACnD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAE1E,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,eAAe,CACxB,uBAAuB,EACvB,kCAAkC,IAAI,CAAC,SAAS,cAAc,MAAM,GAAG,EACvE,uBAAuB,EAAE,CAC1B,CAAC,CAAC;YACL,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACnB,wEAAwE;YACxE,uEAAuE;YACvE,wEAAwE;YACxE,qEAAqE;YACrE,0EAA0E;YAC1E,gEAAgE;YAChE,uEAAuE;YACvE,6CAA6C;YAE7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,OAAO;gBACP,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;oBACjB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CAAC,MAAM,CAAC,CAAC;gBACjB,CAAC;aACF,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAEO,aAAa,CAAC,IAAY;QAChC,IAAI,KAAgB,CAAC;QACrB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;YAC/D,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,gCAAgC;QAC1C,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,MAAuB;QACrC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED,kFAAkF;AAClF,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,SAAkB;IAC7D,OAAO,IAAI,mBAAmB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * GP_E failure-mode codes surfaced to the agent (P0 spec §3.4 / §6.2).
+ * Engine-side codes are defined by the daemon; the shell only adds the
+ * codes that arise between the shell and the engine connection.
+ */
+export declare const GP_E_ENGINE_UNREACHABLE = "GP_E_ENGINE_UNREACHABLE";
+export declare const GP_E_BAD_PARAMS = "GP_E_BAD_PARAMS";
+export declare const GP_E_NO_EVIDENCE = "GP_E_NO_EVIDENCE";
+export declare const GP_E_INTERNAL = "GP_E_INTERNAL";
+export declare const GP_E_PROJECT_LIMIT = "GP_E_PROJECT_LIMIT";
+export declare const GP_E_NOT_FOUND = "GP_E_NOT_FOUND";
+export interface ToolErrorText {
+    code: string;
+    message: string;
+    remedy: string;
+}
+/**
+ * Wire text shape consumed by the agent (spec §6.2):
+ * `GP_E_XXX: message | remedy: <guidance>` — the prefix is greppable.
+ */
+export declare function formatToolError(code: string, message: string, remedy: string): string;
+export declare function formatToolErrorShape(error: ToolErrorText): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AACjE,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEjE"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+/**
+ * GP_E failure-mode codes surfaced to the agent (P0 spec §3.4 / §6.2).
+ * Engine-side codes are defined by the daemon; the shell only adds the
+ * codes that arise between the shell and the engine connection.
+ */
+export const GP_E_ENGINE_UNREACHABLE = "GP_E_ENGINE_UNREACHABLE";
+export const GP_E_BAD_PARAMS = "GP_E_BAD_PARAMS";
+export const GP_E_NO_EVIDENCE = "GP_E_NO_EVIDENCE";
+export const GP_E_INTERNAL = "GP_E_INTERNAL";
+export const GP_E_PROJECT_LIMIT = "GP_E_PROJECT_LIMIT";
+export const GP_E_NOT_FOUND = "GP_E_NOT_FOUND";
+/**
+ * Wire text shape consumed by the agent (spec §6.2):
+ * `GP_E_XXX: message | remedy: <guidance>` — the prefix is greppable.
+ */
+export function formatToolError(code, message, remedy) {
+    return `${code}: ${message} | remedy: ${remedy}`;
+}
+export function formatToolErrorShape(error) {
+    return formatToolError(error.code, error.message, error.remedy);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAQ/C;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe,EAAE,MAAc;IAC3E,OAAO,GAAG,IAAI,KAAK,OAAO,cAAc,MAAM,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAoB;IACvD,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC"}