glasspane-mcp 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EACL,iBAAiB,EAEjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAOrC,SAAS,SAAS,CAAC,IAAuB;IACxC,MAAM,OAAO,GAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IAAI,GAAG,KAAK,eAAe,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC;YAC3B,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,KAAK,GAAG;;;;;CAKb,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU;IACN,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEhD,IAAI,CAAC,GAAwB;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;CACF;AAED,SAAS,IAAI;IACX,IAAI,OAAmB,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;IAE/B,IAAI,MAA2B,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qCAAqC,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAC9E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;QAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;gBACpB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,KAAK,WAAW,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEhE,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,YAAY,GAAG,IAAI,CAAC;QACpB,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,51 @@
+import { Readable, Writable } from "node:stream";
+/** Single-frame cap shared with the engine protocol (P0 spec §3.1). */
+export declare const MAX_FRAME_BYTES: number;
+export interface LineSink {
+    onLine(line: string): void;
+    onOversize(bytes: number): void;
+}
+/**
+ * Splits a byte-or-string stream on line boundaries. Keeps the current
+ * partial line until a newline arrives (so a JSON message split across
+ * chunks still reassembles correctly), mirrors engine FrameCodec.
+ */
+export declare class LineReader {
+    private readonly sink;
+    private buffer;
+    constructor(sink: LineSink);
+    /** @param chunk UTF-8 text fragment received from the stream. */
+    push(chunk: string): void;
+    /** Unconsumed partial line (tests / graceful close inspection). */
+    pendingText(): string;
+}
+/**
+ * Low-level line I/O boundary used by the engine client. Production uses
+ * a Unix socket; tests inject an in-memory fake transport.
+ */
+export interface LineIo {
+    writeLine(line: string): void;
+    onMessage(handler: (line: string) => void): void;
+    onClose(handler: () => void): void;
+    onError(handler: (error: Error) => void): void;
+    close(): void;
+}
+/**
+ * Wraps a Node Stream as a line-oriented transport. Calls encode the plain
+ * newline-delimited frames the daemon speaks (Section 3.1).
+ */
+export declare class StreamLineIo implements LineIo {
+    readonly input: Readable;
+    private readonly output;
+    private readonly reader;
+    private messageHandler;
+    private closeHandler;
+    private errorHandler;
+    constructor(input: Readable, output: Writable);
+    writeLine(line: string): void;
+    onMessage(handler: (line: string) => void): void;
+    onClose(handler: () => void): void;
+    onError(handler: (error: Error) => void): void;
+    close(): void;
+}
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjD,uEAAuE;AACvE,eAAO,MAAM,eAAe,QAAkB,CAAC;AAE/C,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,MAAM,CAAM;gBAES,IAAI,EAAE,QAAQ;IAE3C,iEAAiE;IACjE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAezB,mEAAmE;IACnE,WAAW,IAAI,MAAM;CAGtB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACjD,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/C,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,MAAM;IAOvC,QAAQ,CAAC,KAAK,EAAE,QAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAyC;gBAGlD,KAAK,EAAE,QAAQ,EACP,MAAM,EAAE,QAAQ;IAcnC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIhD,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIlC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI9C,KAAK,IAAI,IAAI;CAGd"}

package/dist/io.js

@@ -0,0 +1,74 @@
+/** Single-frame cap shared with the engine protocol (P0 spec §3.1). */
+export const MAX_FRAME_BYTES = 4 * 1024 * 1024;
+/**
+ * Splits a byte-or-string stream on line boundaries. Keeps the current
+ * partial line until a newline arrives (so a JSON message split across
+ * chunks still reassembles correctly), mirrors engine FrameCodec.
+ */
+export class LineReader {
+    sink;
+    buffer = "";
+    constructor(sink) {
+        this.sink = sink;
+    }
+    /** @param chunk UTF-8 text fragment received from the stream. */
+    push(chunk) {
+        this.buffer += chunk;
+        let nl;
+        while ((nl = this.buffer.indexOf("\n")) !== -1) {
+            const line = this.buffer.slice(0, nl);
+            this.buffer = this.buffer.slice(nl + 1);
+            const bytes = Buffer.byteLength(line, "utf8");
+            if (bytes > MAX_FRAME_BYTES) {
+                this.sink.onOversize(bytes);
+            }
+            else {
+                this.sink.onLine(line);
+            }
+        }
+    }
+    /** Unconsumed partial line (tests / graceful close inspection). */
+    pendingText() {
+        return this.buffer;
+    }
+}
+/**
+ * Wraps a Node Stream as a line-oriented transport. Calls encode the plain
+ * newline-delimited frames the daemon speaks (Section 3.1).
+ */
+export class StreamLineIo {
+    input;
+    output;
+    reader;
+    messageHandler = null;
+    closeHandler = null;
+    errorHandler = null;
+    constructor(input, output) {
+        this.input = input;
+        this.output = output;
+        this.reader = new LineReader({
+            onLine: (line) => this.messageHandler?.(line),
+            onOversize: () => this.errorHandler?.(new Error("frame exceeds " + MAX_FRAME_BYTES + " bytes")),
+        });
+        input.setEncoding("utf8");
+        input.on("data", (chunk) => this.reader.push(chunk));
+        input.on("close", () => this.closeHandler?.());
+        input.on("error", (error) => this.errorHandler?.(error));
+    }
+    writeLine(line) {
+        this.output.write(line + "\n");
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    onClose(handler) {
+        this.closeHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+    close() {
+        this.input.destroy();
+    }
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

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

package/dist/project-registry.d.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+export interface ProjectEntry {
+    projectId: string;
+    displayName: string;
+    bundleId?: string;
+    pid?: number;
+    recipeConfigPath?: string;
+    calibrationAssetsPath?: string;
+    evidenceStoragePath?: string;
+    createdAt: string;
+}
+export declare const ProjectListArgs: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export type ProjectListArgs = z.infer<typeof ProjectListArgs>;
+export declare const ProjectGetArgs: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export type ProjectGetArgs = z.infer<typeof ProjectGetArgs>;
+export declare const ProjectSetArgs: z.ZodEffects<z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodString;
+    bundleId: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    recipeConfigPath: z.ZodOptional<z.ZodString>;
+    calibrationAssetsPath: z.ZodOptional<z.ZodString>;
+    evidenceStoragePath: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    displayName: string;
+    projectId?: string | undefined;
+    bundleId?: string | undefined;
+    pid?: number | undefined;
+    recipeConfigPath?: string | undefined;
+    calibrationAssetsPath?: string | undefined;
+    evidenceStoragePath?: string | undefined;
+}, {
+    displayName: string;
+    projectId?: string | undefined;
+    bundleId?: string | undefined;
+    pid?: number | undefined;
+    recipeConfigPath?: string | undefined;
+    calibrationAssetsPath?: string | undefined;
+    evidenceStoragePath?: string | undefined;
+}>, {
+    displayName: string;
+    projectId?: string | undefined;
+    bundleId?: string | undefined;
+    pid?: number | undefined;
+    recipeConfigPath?: string | undefined;
+    calibrationAssetsPath?: string | undefined;
+    evidenceStoragePath?: string | undefined;
+}, {
+    displayName: string;
+    projectId?: string | undefined;
+    bundleId?: string | undefined;
+    pid?: number | undefined;
+    recipeConfigPath?: string | undefined;
+    calibrationAssetsPath?: string | undefined;
+    evidenceStoragePath?: string | undefined;
+}>;
+export type ProjectSetArgs = z.infer<typeof ProjectSetArgs>;
+export declare function projectList(): ProjectEntry[];
+export declare function projectGet(projectId: string): ProjectEntry | undefined;
+/**
+ * Create or update a project.  If `projectId` is undefined, a new entry is
+ * created; otherwise the existing entry is updated (GP_E_NOT_FOUND on miss).
+ */
+export declare function projectSet(args: ProjectSetArgs): ProjectEntry;
+/** Thrown for GP_E_PROJECT_LIMIT / GP_E_NOT_FOUND / GP_E_BAD_PARAMS. */
+export declare class ProjectRegistryError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=project-registry.d.ts.map

package/dist/project-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registry.d.ts","sourceRoot":"","sources":["../src/project-registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,eAAO,MAAM,eAAe,iDAAqB,CAAC;AAClD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,cAAc;;;;;;EAEzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW1B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAgC5D,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAE5C;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGtE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CA6C7D;AAsBD,wEAAwE;AACxE,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C"}

package/dist/project-registry.js

@@ -0,0 +1,144 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { z } from "zod";
+/* ------------------------------------------------------------------ *
+ * Project Registry — MCP-layer access (P1 spec v1.4 §4)
+ *
+ * This module operates directly on the shared projects.json file.
+ * The daemon's Swift ProjectRegistry writes this file; the MCP shell
+ * reads/writes the same file with mirrored validation constraints.
+ * No socket methods are added (spec 变更说明: "不改变 socket 协议方法表").
+ * ------------------------------------------------------------------ */
+const CROCKFORD_BODY_RE = "[0-9A-HJKMNP-TV-Z]{26}";
+const PROJECT_ID_RE = new RegExp(`^prj_${CROCKFORD_BODY_RE}$`);
+const MAX_PROJECTS = 128;
+const MAX_DISPLAY_NAME_LENGTH = 256;
+const MAX_FIELD_LENGTH = 1024;
+// ----- Zod schemas for MCP input validation -----
+export const ProjectListArgs = z.strictObject({});
+export const ProjectGetArgs = z.strictObject({
+    projectId: z.string().regex(PROJECT_ID_RE, "projectId must match prj_ + 26 Crockford chars"),
+});
+export const ProjectSetArgs = z.strictObject({
+    projectId: z.string().regex(PROJECT_ID_RE).optional(),
+    displayName: z.string().min(1).max(MAX_DISPLAY_NAME_LENGTH),
+    bundleId: z.string().max(256).optional(),
+    pid: z.number().int().nonnegative().optional(),
+    recipeConfigPath: z.string().max(MAX_FIELD_LENGTH).optional(),
+    calibrationAssetsPath: z.string().max(MAX_FIELD_LENGTH).optional(),
+    evidenceStoragePath: z.string().max(MAX_FIELD_LENGTH).optional(),
+}).refine((v) => (v.bundleId !== undefined) !== (v.pid !== undefined), { message: "exactly one of bundleId or pid is required" });
+// ----- File access -----
+function projectsPath() {
+    const envPath = process.env["GLASSPANE_PROJECTS_FILE"];
+    if (envPath)
+        return envPath;
+    return path.join(os.homedir(), ".glasspane", "projects.json");
+}
+function loadProjects(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed;
+    }
+    catch {
+        return [];
+    }
+}
+function saveProjects(filePath, entries) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    // Atomic write: tmp + rename.
+    const tmpPath = `${filePath}.tmp`;
+    fs.writeFileSync(tmpPath, JSON.stringify(entries, null, 2), "utf8");
+    fs.renameSync(tmpPath, filePath);
+}
+// ----- Public operations -----
+export function projectList() {
+    return loadProjects(projectsPath());
+}
+export function projectGet(projectId) {
+    const projects = loadProjects(projectsPath());
+    return projects.find((p) => p.projectId === projectId);
+}
+/**
+ * Create or update a project.  If `projectId` is undefined, a new entry is
+ * created; otherwise the existing entry is updated (GP_E_NOT_FOUND on miss).
+ */
+export function projectSet(args) {
+    const filePath = projectsPath();
+    const projects = loadProjects(filePath);
+    let entry;
+    const projectId = args.projectId;
+    if (projectId) {
+        // Update.
+        const idx = projects.findIndex((p) => p.projectId === projectId);
+        if (idx === -1) {
+            throw new ProjectRegistryError("GP_E_NOT_FOUND", `unknown projectId ${projectId}`);
+        }
+        const existing = projects[idx];
+        entry = {
+            ...existing,
+            displayName: args.displayName,
+            ...(args.bundleId !== undefined ? { bundleId: args.bundleId } : {}),
+            ...(args.pid !== undefined ? { pid: args.pid } : {}),
+            ...(args.recipeConfigPath !== undefined ? { recipeConfigPath: args.recipeConfigPath } : {}),
+            ...(args.calibrationAssetsPath !== undefined ? { calibrationAssetsPath: args.calibrationAssetsPath } : {}),
+            ...(args.evidenceStoragePath !== undefined ? { evidenceStoragePath: args.evidenceStoragePath } : {}),
+        };
+        projects[idx] = entry;
+    }
+    else {
+        // Create.
+        if (projects.length >= MAX_PROJECTS) {
+            throw new ProjectRegistryError("GP_E_PROJECT_LIMIT", `project limit reached (${MAX_PROJECTS})`);
+        }
+        const projectId = generateProjectId();
+        entry = {
+            projectId,
+            displayName: args.displayName,
+            bundleId: args.bundleId,
+            pid: args.pid,
+            recipeConfigPath: args.recipeConfigPath,
+            calibrationAssetsPath: args.calibrationAssetsPath,
+            evidenceStoragePath: args.evidenceStoragePath,
+            createdAt: new Date().toISOString(),
+        };
+        projects.push(entry);
+    }
+    saveProjects(filePath, projects);
+    return entry;
+}
+// ----- Helpers -----
+/** Crockford base32 ULID-shaped project ID (P1 spec v1.4 §1.1). */
+function generateProjectId() {
+    const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+    const body = [];
+    const bytes = new Uint8Array(26);
+    // Node 16+ crypto is safe; use globalThis for older runtimes.
+    if (typeof globalThis.crypto?.getRandomValues === "function") {
+        globalThis.crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < 26; i++)
+            bytes[i] = Math.floor(Math.random() * 256);
+    }
+    for (let i = 0; i < 26; i++) {
+        const byte = bytes[i];
+        body.push(CROCKFORD.charAt(byte % 32));
+    }
+    return `prj_${body.join("")}`;
+}
+/** Thrown for GP_E_PROJECT_LIMIT / GP_E_NOT_FOUND / GP_E_BAD_PARAMS. */
+export class ProjectRegistryError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ProjectRegistryError";
+        this.code = code;
+    }
+}
+//# sourceMappingURL=project-registry.js.map

package/dist/project-registry.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,255 @@
+import { z } from "zod";
+import { type Selector, type Action, type AssertionProperty } from "@iterate/kernel";
+import { EngineJsonRpcClient } from "./engine-client.js";
+import { EvidenceAuditSession } from "./audit-session.js";
+export declare const AttachArgs: z.ZodEffects<z.ZodObject<{
+    bundleId: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    projectId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    projectId?: string | undefined;
+    bundleId?: string | undefined;
+    pid?: number | undefined;
+}, {
+    projectId?: string | undefined;
+    bundleId?: string | undefined;
+    pid?: number | undefined;
+}>, {
+    projectId?: string | undefined;
+    bundleId?: string | undefined;
+    pid?: number | undefined;
+}, {
+    projectId?: string | undefined;
+    bundleId?: string | undefined;
+    pid?: number | undefined;
+}>;
+export type AttachArgs = z.infer<typeof AttachArgs>;
+export declare const ObserveArgs: z.ZodObject<{
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    role: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    role?: string | undefined;
+    maxDepth?: number | undefined;
+}, {
+    role?: string | undefined;
+    maxDepth?: number | undefined;
+}>;
+export type ObserveArgs = z.infer<typeof ObserveArgs>;
+export declare const ActArgs: z.ZodObject<{
+    selector: z.ZodObject<{
+        role: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        identifier: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        role: string;
+        title?: string | undefined;
+        identifier?: string | undefined;
+    }, {
+        role: string;
+        title?: string | undefined;
+        identifier?: string | undefined;
+    }>;
+    action: z.ZodEnum<["press", "increment", "decrement", "showMenu", "confirm", "cancel", "pick"]>;
+    degrade: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    selector: {
+        role: string;
+        title?: string | undefined;
+        identifier?: string | undefined;
+    };
+    action: "press" | "increment" | "decrement" | "showMenu" | "confirm" | "cancel" | "pick";
+    degrade?: boolean | undefined;
+}, {
+    selector: {
+        role: string;
+        title?: string | undefined;
+        identifier?: string | undefined;
+    };
+    action: "press" | "increment" | "decrement" | "showMenu" | "confirm" | "cancel" | "pick";
+    degrade?: boolean | undefined;
+}>;
+export type ActArgs = z.infer<typeof ActArgs>;
+export declare const AssertElementArgs: z.ZodObject<{
+    selector: z.ZodObject<{
+        role: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        identifier: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        role: string;
+        title?: string | undefined;
+        identifier?: string | undefined;
+    }, {
+        role: string;
+        title?: string | undefined;
+        identifier?: string | undefined;
+    }>;
+    property: z.ZodEnum<["title", "value", "role", "enabled", "focused"]>;
+    expected: z.ZodUnion<[z.ZodString, z.ZodBoolean]>;
+}, "strict", z.ZodTypeAny, {
+    expected: string | boolean;
+    selector: {
+        role: string;
+        title?: string | undefined;
+        identifier?: string | undefined;
+    };
+    property: "value" | "role" | "title" | "enabled" | "focused";
+}, {
+    expected: string | boolean;
+    selector: {
+        role: string;
+        title?: string | undefined;
+        identifier?: string | undefined;
+    };
+    property: "value" | "role" | "title" | "enabled" | "focused";
+}>;
+export type AssertElementArgs = z.infer<typeof AssertElementArgs>;
+export declare const DiagnoseArgs: z.ZodObject<{
+    operationId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    operationId?: string | undefined;
+}, {
+    operationId?: string | undefined;
+}>;
+export type DiagnoseArgs = z.infer<typeof DiagnoseArgs>;
+export declare const LastEvidenceArgs: z.ZodObject<{
+    operationId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    operationId?: string | undefined;
+}, {
+    operationId?: string | undefined;
+}>;
+export type LastEvidenceArgs = z.infer<typeof LastEvidenceArgs>;
+export declare const SnapshotArgs: z.ZodObject<{
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    maxDepth?: number | undefined;
+}, {
+    maxDepth?: number | undefined;
+}>;
+export type SnapshotArgs = z.infer<typeof SnapshotArgs>;
+export declare const RestoreArgs: z.ZodObject<{
+    snapshotId: z.ZodString;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        selector: z.ZodObject<{
+            role: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            identifier: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            role: string;
+            title?: string | undefined;
+            identifier?: string | undefined;
+        }, {
+            role: string;
+            title?: string | undefined;
+            identifier?: string | undefined;
+        }>;
+        action: z.ZodEnum<["press", "increment", "decrement", "showMenu", "confirm", "cancel", "pick"]>;
+    }, "strict", z.ZodTypeAny, {
+        selector: {
+            role: string;
+            title?: string | undefined;
+            identifier?: string | undefined;
+        };
+        action: "press" | "increment" | "decrement" | "showMenu" | "confirm" | "cancel" | "pick";
+    }, {
+        selector: {
+            role: string;
+            title?: string | undefined;
+            identifier?: string | undefined;
+        };
+        action: "press" | "increment" | "decrement" | "showMenu" | "confirm" | "cancel" | "pick";
+    }>, "many">>;
+    mode: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    snapshotId: string;
+    steps?: {
+        selector: {
+            role: string;
+            title?: string | undefined;
+            identifier?: string | undefined;
+        };
+        action: "press" | "increment" | "decrement" | "showMenu" | "confirm" | "cancel" | "pick";
+    }[] | undefined;
+    mode?: string | undefined;
+}, {
+    snapshotId: string;
+    steps?: {
+        selector: {
+            role: string;
+            title?: string | undefined;
+            identifier?: string | undefined;
+        };
+        action: "press" | "increment" | "decrement" | "showMenu" | "confirm" | "cancel" | "pick";
+    }[] | undefined;
+    mode?: string | undefined;
+}>;
+export type RestoreArgs = z.infer<typeof RestoreArgs>;
+/** P6 §5.4: probe connectivity query takes no arguments. */
+export declare const ProbeStatusArgs: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export type ProbeStatusArgs = z.infer<typeof ProbeStatusArgs>;
+export declare const ExportEvidenceArgs: z.ZodObject<{
+    operationId: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<["html", "markdown"]>>;
+}, "strict", z.ZodTypeAny, {
+    operationId: string;
+    format: "html" | "markdown";
+}, {
+    operationId: string;
+    format?: "html" | "markdown" | undefined;
+}>;
+export type ExportEvidenceArgs = z.infer<typeof ExportEvidenceArgs>;
+export declare const RecentReportsArgs: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    format: z.ZodDefault<z.ZodEnum<["html", "markdown"]>>;
+}, "strict", z.ZodTypeAny, {
+    format: "html" | "markdown";
+    limit: number;
+}, {
+    format?: "html" | "markdown" | undefined;
+    limit?: number | undefined;
+}>;
+export type RecentReportsArgs = z.infer<typeof RecentReportsArgs>;
+export interface ToolSpec {
+    name: string;
+    description: string;
+    /** Engine method forwarded after validation; pseudo-method for orchestrated tools. */
+    engineMethod: string;
+    /** JSON Schema emitted by tools/list (hand-written contract, spec §6.2). */
+    inputSchema: Record<string, unknown>;
+    validate: (args: unknown) => {
+        ok: true;
+        value: Record<string, unknown>;
+    } | {
+        ok: false;
+        issues: string;
+    };
+    /**
+     * Orchestrated tools (spec v1.3 §10.3) run their own logic instead of the
+     * default forward-then-relay path — e.g. the audit tools fetch evidence
+     * packs and render them through the report generator.
+     */
+    execute?: (args: Record<string, unknown>, context: ToolExecuteContext) => Promise<ToolResult>;
+}
+export interface ToolExecuteContext {
+    engine: EngineJsonRpcClient;
+    session: EvidenceAuditSession;
+}
+/** Tool result shape shared by the default path and custom executors. */
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: boolean;
+}
+export declare const TOOL_SPECS: readonly ToolSpec[];
+export declare const TOOL_BY_NAME: ReadonlyMap<string, ToolSpec>;
+/**
+ * Execute a tool against the engine client. Validates arguments against
+ * the tool's zod schema (isError + GP_E_BAD_PARAMS on failure), then either
+ * runs the tool's own `execute` (orchestrated tools) or forwards the method
+ * to the engine and maps engine/connection errors to agent-facing errors.
+ */
+export declare function executeTool(spec: ToolSpec, args: unknown, engine: EngineJsonRpcClient, session?: EvidenceAuditSession): Promise<ToolResult>;
+export type { Selector, Action, AssertionProperty };
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

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