@ambitresearch/genie 1.3.1

package/dist/tools/get_project.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { PROJECT_ID_PATTERN, ProjectStoreError, projectScreenShape, projectSummaryShape, } from "./create_project.js";
+export const GET_PROJECT_TOOL_NAME = "mcp__genie__get_project";
+/** Error code raised when `projectId` does not resolve to an existing project. */
+export const ERR_PROJECT_NOT_FOUND = "ERR_PROJECT_NOT_FOUND";
+const projectIdSchema = z
+    .string()
+    .regex(PROJECT_ID_PATTERN, "projectId must be a 3-64 character slug containing only lowercase letters, numbers, and hyphens.");
+const getProjectArgsSchema = z
+    .object({
+    projectId: projectIdSchema,
+})
+    .strict();
+/** Raw shape (not a constructed ZodObject) — matches how every other tool in this
+ * repo declares `outputSchema` (see get_kit.ts, delete_project.ts, list_files.ts). */
+const projectDetailShape = {
+    ...projectSummaryShape,
+    screens: z.array(z.object(projectScreenShape).strict()),
+    sourceBlueprintId: z.string().optional(),
+};
+const projectDetailSchema = z.object(projectDetailShape).strict();
+/**
+ * Validate args and fetch project detail. Exported standalone (bypassing the MCP
+ * transport) so programmatic/direct callers get the same validation defense-in-depth
+ * as `list_files`' `listFiles()` and `get_kit`'s `getKit()`.
+ */
+export async function getProject(store, args) {
+    const { projectId } = getProjectArgsSchema.parse(args);
+    const detail = await store.getProject(projectId);
+    return projectDetailSchema.parse(detail);
+}
+export function registerGetProjectTool(server, store) {
+    server.registerTool(GET_PROJECT_TOOL_NAME, {
+        title: "Get project",
+        description: "Return metadata for one genie workspace or blueprint project, including its " +
+            "kit bindings, recorded screens, and canEdit status. Blueprints use the same " +
+            'shape as workspaces (kind: "blueprint") — there is no separate tool family. ' +
+            "Typically follows list_projects; check kitBindings here before bind_kit or conjure_screen.",
+        inputSchema: {
+            projectId: projectIdSchema,
+        },
+        outputSchema: projectDetailShape,
+    }, async (args) => {
+        try {
+            const result = await getProject(store, args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            if (error instanceof ProjectStoreError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                code: error.code,
+                                message: error.message,
+                                ...(error.projectId ? { projectId: error.projectId } : {}),
+                            }),
+                        },
+                    ],
+                };
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=get_project.js.map

package/dist/tools/get_project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_project.js","sourceRoot":"","sources":["../../src/tools/get_project.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE/D,kFAAkF;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AAEtE,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,KAAK,CACJ,kBAAkB,EAClB,kGAAkG,CACnG,CAAC;AAEJ,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,SAAS,EAAE,eAAe;CAC3B,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ;sFACsF;AACtF,MAAM,kBAAkB,GAAG;IACzB,GAAG,mBAAmB;IACtB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,MAAM,EAAE,CAAC;IACvD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,MAAM,EAAE,CAAC;AAWlE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAsB,EACtB,IAAa;IAEb,MAAM,EAAE,SAAS,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,KAAsB;IAC9E,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,8EAA8E;YAC9E,8EAA8E;YAC9E,8EAA8E;YAC9E,4FAA4F;QAC9F,WAAW,EAAE;YACX,SAAS,EAAE,eAAe;SAC3B;QACD,YAAY,EAAE,kBAAkB;KACjC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,iBAAiB,EAAE,MAAM;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,IAAI,EAAE,KAAK,CAAC,IAAI;gCAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gCACtB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;6BAC3D,CAAC;yBACH;qBACF;iBACF,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_components.d.ts

@@ -0,0 +1,42 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ComponentEntry, KitStore } from "../store/interface.js";
+export declare const LIST_COMPONENTS_TOOL_NAME = "mcp__genie__list_components";
+/**
+ * Shared pagination cap (AC7): the same 256-result ceiling `list_files` and
+ * `list_kits` honour. A page never exceeds this many entries; the rest are
+ * reachable by re-calling with the returned `_meta.nextCursor`.
+ */
+export declare const MAX_COMPONENTS = 256;
+export declare const LIST_COMPONENTS_DESCRIPTION: string;
+export interface ListComponentsResult {
+    components: ComponentEntry[];
+    nextCursor?: string;
+}
+/** Keyset cursor payload — the sort key of the last entry on the prior page. */
+interface CursorKey {
+    g: string;
+    n: string;
+    p: string;
+}
+/**
+ * Encode a keyset cursor from the last entry of a page. The cursor carries the
+ * (group, name, path) sort key — NOT a numeric offset — so it stays correct
+ * even if the manifest gains or loses entries between calls: the next page
+ * resumes at the first component strictly after this key in the AC6 total
+ * order, rather than at a byte offset that a mutation would shift.
+ */
+export declare function encodeCursor(entry: ComponentEntry): string;
+/** Decode + validate a keyset cursor. Throws on tampered / malformed input. */
+export declare function decodeCursor(cursor: string): CursorKey;
+/**
+ * Slice one ≤256-entry page out of a deterministically-sorted component list
+ * (AC7). `components` MUST already be sorted by {@link compareComponents} — the
+ * store guarantees this. Keyset semantics: with no cursor, return the first
+ * page; with a cursor, return the page beginning at the first entry strictly
+ * greater than the cursor key. `nextCursor` is set only when more entries
+ * remain past the returned page.
+ */
+export declare function paginateComponents(components: ComponentEntry[], cursor?: string): ListComponentsResult;
+export declare function registerListComponents(server: McpServer, store: KitStore): void;
+export {};
+//# sourceMappingURL=list_components.d.ts.map

package/dist/tools/list_components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_components.d.ts","sourceRoot":"","sources":["../../src/tools/list_components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtE,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,eAAO,MAAM,2BAA2B,QAQ+D,CAAC;AAYxG,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gFAAgF;AAChF,UAAU,SAAS;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAG1D;AAaD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAoBtD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,cAAc,EAAE,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,CActB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CA4C/E"}

package/dist/tools/list_components.js

@@ -0,0 +1,125 @@
+import { z } from "zod";
+import { compareComponents } from "../store/manifest.js";
+export const LIST_COMPONENTS_TOOL_NAME = "mcp__genie__list_components";
+/**
+ * Shared pagination cap (AC7): the same 256-result ceiling `list_files` and
+ * `list_kits` honour. A page never exceeds this many entries; the rest are
+ * reachable by re-calling with the returned `_meta.nextCursor`.
+ */
+export const MAX_COMPONENTS = 256;
+export const LIST_COMPONENTS_DESCRIPTION = "List components within a kit, optionally filtered by group. Returns an array of component metadata " +
+    "(name, group, path, viewport, hash, lastModified) sorted by group ASC, then name ASC, then path ASC " +
+    "for deterministic ordering. When group is omitted, returns every component across all groups. Returns " +
+    "[] when the kit has no components or the group filter matches nothing. Results are capped at 256 per " +
+    "call; when more remain, an opaque cursor is returned in _meta.nextCursor — pass it back as `cursor` to " +
+    "fetch the next page. Reads the compiled manifest, so results reflect components as of the last " +
+    "compile. Calling mcp__genie__preview recompiles before it returns, regardless of whether the " +
+    "host renders ui:// inline or opens a browser — call preview first after recent writes or deletions.";
+/** Zod shape for a single component entry — reused by `outputSchema`. */
+const componentEntryShape = {
+    name: z.string(),
+    group: z.string(),
+    path: z.string(),
+    viewport: z.string(),
+    hash: z.string(),
+    lastModified: z.string(),
+};
+/**
+ * Encode a keyset cursor from the last entry of a page. The cursor carries the
+ * (group, name, path) sort key — NOT a numeric offset — so it stays correct
+ * even if the manifest gains or loses entries between calls: the next page
+ * resumes at the first component strictly after this key in the AC6 total
+ * order, rather than at a byte offset that a mutation would shift.
+ */
+export function encodeCursor(entry) {
+    const key = { g: entry.group, n: entry.name, p: entry.path };
+    return Buffer.from(JSON.stringify(key), "utf-8").toString("base64url");
+}
+/**
+ * Truncated, safe preview of an untrusted cursor for error messages. Echoing
+ * the full caller-supplied string would let an oversized/opaque token bloat
+ * logs and responses (and reflect tokens back to callers); we cap it hard and
+ * mark elision with an ellipsis so the message stays diagnostic but bounded.
+ */
+const CURSOR_PREVIEW_MAX = 16;
+function cursorPreview(cursor) {
+    return cursor.length <= CURSOR_PREVIEW_MAX ? cursor : `${cursor.slice(0, CURSOR_PREVIEW_MAX)}…`;
+}
+/** Decode + validate a keyset cursor. Throws on tampered / malformed input. */
+export function decodeCursor(cursor) {
+    let parsed;
+    try {
+        parsed = JSON.parse(Buffer.from(cursor, "base64url").toString("utf-8"));
+    }
+    catch {
+        throw new Error(`Invalid cursor: "${cursorPreview(cursor)}" is not a decodable list_components cursor.`);
+    }
+    if (typeof parsed !== "object" ||
+        parsed === null ||
+        typeof parsed.g !== "string" ||
+        typeof parsed.n !== "string" ||
+        typeof parsed.p !== "string") {
+        throw new Error(`Invalid cursor: "${cursorPreview(cursor)}" has the wrong shape.`);
+    }
+    const { g, n, p } = parsed;
+    return { g, n, p };
+}
+/**
+ * Slice one ≤256-entry page out of a deterministically-sorted component list
+ * (AC7). `components` MUST already be sorted by {@link compareComponents} — the
+ * store guarantees this. Keyset semantics: with no cursor, return the first
+ * page; with a cursor, return the page beginning at the first entry strictly
+ * greater than the cursor key. `nextCursor` is set only when more entries
+ * remain past the returned page.
+ */
+export function paginateComponents(components, cursor) {
+    let start = 0;
+    if (cursor !== undefined) {
+        const key = decodeCursor(cursor);
+        const sortKey = { group: key.g, name: key.n, path: key.p };
+        const idx = components.findIndex((c) => compareComponents(c, sortKey) > 0);
+        start = idx === -1 ? components.length : idx;
+    }
+    const page = components.slice(start, start + MAX_COMPONENTS);
+    const hasMore = start + MAX_COMPONENTS < components.length;
+    const nextCursor = hasMore && page.length > 0 ? encodeCursor(page[page.length - 1]) : undefined;
+    return nextCursor === undefined ? { components: page } : { components: page, nextCursor };
+}
+export function registerListComponents(server, store) {
+    server.registerTool(LIST_COMPONENTS_TOOL_NAME, {
+        title: "List components",
+        description: LIST_COMPONENTS_DESCRIPTION,
+        inputSchema: z
+            .object({
+            kitId: z
+                .string()
+                .regex(/^[a-z0-9-]{3,64}$/)
+                .describe("The ID of the kit to list components from"),
+            group: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Optional group filter. When specified, returns only components in that group. Empty string rejected."),
+            cursor: z
+                .string()
+                .optional()
+                .describe("Opaque pagination cursor from a prior call's _meta.nextCursor. Fetches the next page of results."),
+        })
+            .strict(),
+        outputSchema: {
+            components: z.array(z.object(componentEntryShape).strict()),
+        },
+    }, async ({ kitId, group, cursor }) => {
+        const all = await store.listComponents({ kitId, group });
+        const { components, nextCursor } = paginateComponents(all, cursor);
+        return {
+            content: [{ type: "text", text: JSON.stringify(components) }],
+            structuredContent: { components },
+            // AC7 — surface the continuation cursor out-of-band in _meta (only when
+            // the result was truncated) so the `components` payload stays a clean,
+            // schema-validated array.
+            ...(nextCursor === undefined ? {} : { _meta: { nextCursor } }),
+        };
+    });
+}
+//# sourceMappingURL=list_components.js.map

package/dist/tools/list_components.js.map

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

package/dist/tools/list_files.d.ts

@@ -0,0 +1,32 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { KitStore } from "../store/interface.js";
+export declare const LIST_FILES_TOOL_NAME = "mcp__genie__list_files";
+declare const listFilesArgsSchema: z.ZodObject<{
+    kitId: z.ZodString;
+}, z.core.$strict>;
+declare const fileEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodNumber;
+    hash: z.ZodString;
+    lastModified: z.ZodString;
+}, z.core.$strict>;
+export type ListFilesArgs = z.infer<typeof listFilesArgsSchema>;
+export type ListedFile = z.infer<typeof fileEntrySchema>;
+export declare class ListFilesError extends Error {
+    readonly code: "ERR_KIT_NOT_FOUND" | "ERR_INVALID_KIT_ID" | "ERR_INVALID_ARGS";
+    constructor(code: "ERR_KIT_NOT_FOUND" | "ERR_INVALID_KIT_ID" | "ERR_INVALID_ARGS", message: string);
+}
+/**
+ * List a kit's files as rich entries (path + size + SRI hash + lastModified),
+ * through the injected `KitStore` (M1-14a-1a / DRO-540). The store owns the
+ * walk, SHA-256 SRI hashing, size/mtime, and the `.genieignore` + default-dir
+ * exclusion — so the SAME verb runs against `LocalFsKitStore` (disk) or
+ * `GitHostKitStore` (git host). This function owns only arg-shape validation,
+ * the kitId guard, and mapping the store's `NotFoundError` onto the tool's
+ * `ERR_KIT_NOT_FOUND`.
+ */
+export declare function listFiles(store: KitStore, args: ListFilesArgs): Promise<ListedFile[]>;
+export declare function registerListFilesTool(server: McpServer, store: KitStore): void;
+export {};
+//# sourceMappingURL=list_files.d.ts.map

package/dist/tools/list_files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_files.d.ts","sourceRoot":"","sources":["../../src/tools/list_files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAE7D,QAAA,MAAM,mBAAmB;;kBAId,CAAC;AAEZ,QAAA,MAAM,eAAe;;;;;kBAOV,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEzD,qBAAa,cAAe,SAAQ,KAAK;IAErC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,kBAAkB;gBAArE,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,kBAAkB,EAC9E,OAAO,EAAE,MAAM;CAKlB;AAgBD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA2B3F;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAuC9E"}

package/dist/tools/list_files.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { NotFoundError } from "../store/interface.js";
+import { isSafeKitId } from "../store/kit-files.js";
+export const LIST_FILES_TOOL_NAME = "mcp__genie__list_files";
+const listFilesArgsSchema = z
+    .object({
+    kitId: z.string().min(1),
+})
+    .strict();
+const fileEntrySchema = z
+    .object({
+    path: z.string(),
+    size: z.number().int().nonnegative(),
+    hash: z.string().startsWith("sha256-"),
+    lastModified: z.string(),
+})
+    .strict();
+export class ListFilesError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ListFilesError";
+    }
+}
+/**
+ * Reject path-shaped kit ids up front (the store also guards, but this keeps the
+ * tool's `ERR_INVALID_KIT_ID` contract). Delegates to the shared `isSafeKitId`
+ * rule (`store/kit-files.ts`) — the SAME predicate `read_file` and both stores
+ * use — so the two tools' kitId defenses cannot silently drift (AC1). The rule
+ * rejects the empty string, `.`/`..`, and any `/`/`\\` separator; ids that
+ * merely embed dots (`my..kit`) stay a valid single-segment child.
+ */
+function assertValidKitId(kitId) {
+    if (!isSafeKitId(kitId)) {
+        throw new ListFilesError("ERR_INVALID_KIT_ID", `Invalid kitId "${kitId}".`);
+    }
+}
+/**
+ * List a kit's files as rich entries (path + size + SRI hash + lastModified),
+ * through the injected `KitStore` (M1-14a-1a / DRO-540). The store owns the
+ * walk, SHA-256 SRI hashing, size/mtime, and the `.genieignore` + default-dir
+ * exclusion — so the SAME verb runs against `LocalFsKitStore` (disk) or
+ * `GitHostKitStore` (git host). This function owns only arg-shape validation,
+ * the kitId guard, and mapping the store's `NotFoundError` onto the tool's
+ * `ERR_KIT_NOT_FOUND`.
+ */
+export async function listFiles(store, args) {
+    let parsed;
+    try {
+        parsed = listFilesArgsSchema.parse(args);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const issue = error.issues[0];
+            throw new ListFilesError("ERR_INVALID_ARGS", issue?.message ?? "Invalid arguments: expected { kitId: string }.");
+        }
+        throw error;
+    }
+    assertValidKitId(parsed.kitId);
+    let entries;
+    try {
+        entries = await store.listFiles(parsed.kitId);
+    }
+    catch (error) {
+        if (error instanceof NotFoundError) {
+            throw new ListFilesError("ERR_KIT_NOT_FOUND", `Kit "${parsed.kitId}" not found.`);
+        }
+        throw error;
+    }
+    return z.array(fileEntrySchema).parse(entries);
+}
+export function registerListFilesTool(server, store) {
+    server.registerTool(LIST_FILES_TOOL_NAME, {
+        title: "List files",
+        description: "Return the UI kit file tree with kit-root-relative paths, byte sizes, SHA-256 SRI hashes, and modification times. " +
+            "Reads the raw on-disk tree (unlike list_components, which reads the compiled manifest) — " +
+            "reach for this before read_file, or to see exactly which paths a delete_files plan needs to cover.",
+        inputSchema: {
+            kitId: z.string().min(1),
+        },
+        outputSchema: {
+            files: z.array(fileEntrySchema),
+        },
+    }, async (args) => {
+        try {
+            const result = await listFiles(store, args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: { files: result },
+            };
+        }
+        catch (error) {
+            if (error instanceof ListFilesError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ code: error.code, message: error.message }),
+                        },
+                    ],
+                };
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=list_files.js.map

package/dist/tools/list_files.js.map

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

package/dist/tools/list_kits.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { KitStore } from "../store/interface.js";
+export declare const LIST_KITS_TOOL_NAME = "mcp__genie__list_kits";
+export declare const LIST_KITS_DESCRIPTION = "List the user's writable UI kits. Returns every genie-native kit visible to the current store as an array of { id, name, owner, updatedAt, canEdit }. Filters out records whose stored type is not GENIE_KIT; interop adapters map Anthropic project types separately. Reach for this as the discovery step before conjure, plan, or bind_kit \u2014 each needs a valid kitId from here (or from create_kit for a brand-new kit).";
+export interface ListKitsEntry extends Record<string, unknown> {
+    id: string;
+    name: string;
+    owner: string;
+    updatedAt: string;
+    canEdit: boolean;
+}
+export declare function listWritableKits(store: KitStore): Promise<ListKitsEntry[]>;
+export declare function registerListKits(server: McpServer, store: KitStore): void;
+//# sourceMappingURL=list_kits.d.ts.map

package/dist/tools/list_kits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_kits.d.ts","sourceRoot":"","sources":["../../src/tools/list_kits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAG/D,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D,eAAO,MAAM,qBAAqB,saAC8X,CAAC;AAEja,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAiBD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAWhF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAmBzE"}

package/dist/tools/list_kits.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { KIT_TYPE } from "../store/interface.js";
+export const LIST_KITS_TOOL_NAME = "mcp__genie__list_kits";
+export const LIST_KITS_DESCRIPTION = "List the user's writable UI kits. Returns every genie-native kit visible to the current store as an array of { id, name, owner, updatedAt, canEdit }. Filters out records whose stored type is not GENIE_KIT; interop adapters map Anthropic project types separately. Reach for this as the discovery step before conjure, plan, or bind_kit — each needs a valid kitId from here (or from create_kit for a brand-new kit).";
+/** Zod shape for a single `list_kits` entry — reused by `outputSchema`. */
+const listKitsEntryShape = {
+    id: z.string(),
+    name: z.string(),
+    owner: z.string(),
+    updatedAt: z.string(),
+    canEdit: z.boolean(),
+};
+export async function listWritableKits(store) {
+    const kits = (await store.listKits());
+    return kits
+        .filter((kit) => kit.type === KIT_TYPE)
+        .map((kit) => ({
+        id: kit.id,
+        name: kit.name,
+        owner: kit.owner ?? "local",
+        updatedAt: kit.updatedAt ?? kit.createdAt,
+        canEdit: kit.canEdit ?? true,
+    }));
+}
+export function registerListKits(server, store) {
+    server.registerTool(LIST_KITS_TOOL_NAME, {
+        title: "List kits",
+        description: LIST_KITS_DESCRIPTION,
+        inputSchema: z.object({}).strict(),
+        outputSchema: {
+            kits: z.array(z.object(listKitsEntryShape).strict()),
+        },
+    }, async () => {
+        const kits = await listWritableKits(store);
+        return {
+            content: [{ type: "text", text: JSON.stringify(kits) }],
+            structuredContent: { kits },
+        };
+    });
+}
+//# sourceMappingURL=list_kits.js.map

package/dist/tools/list_kits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_kits.js","sourceRoot":"","sources":["../../src/tools/list_kits.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAE3D,MAAM,CAAC,MAAM,qBAAqB,GAChC,8ZAA8Z,CAAC;AAUja,2EAA2E;AAC3E,MAAM,kBAAkB,GAAG;IACzB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC;AAQF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAe;IACpD,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAsB,CAAC;IAC3D,OAAO,IAAI;SACR,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;SACtC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,OAAO;QAC3B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS;QACzC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;KAC7B,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,KAAe;IACjE,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;QAClC,YAAY,EAAE;YACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,MAAM,EAAE,CAAC;SACrD;KACF,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,iBAAiB,EAAE,EAAE,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_projects.d.ts

@@ -0,0 +1,23 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ProjectSummary } from "./create_project.js";
+export declare const LIST_PROJECTS_TOOL_NAME = "mcp__genie__list_projects";
+export interface ProjectListStore {
+    listProjects(): Promise<ProjectSummary[]>;
+}
+export interface ProjectListBackend extends ProjectListStore {
+    name: string;
+}
+export interface ProjectListWarning extends Record<string, unknown> {
+    code: "ERR_BACKEND_UNREACHABLE";
+    message: string;
+    backend: string;
+}
+export interface ListProjectsResult extends Record<string, unknown> {
+    projects: ProjectSummary[];
+}
+export declare class ProjectBackendUnreachableError extends Error {
+    readonly code: "ERR_BACKEND_UNREACHABLE";
+    constructor(code: "ERR_BACKEND_UNREACHABLE", message: string);
+}
+export declare function registerListProjectsTool(server: McpServer, localStore: ProjectListStore, additionalBackends?: ProjectListBackend[]): void;
+//# sourceMappingURL=list_projects.d.ts.map

package/dist/tools/list_projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_projects.d.ts","sourceRoot":"","sources":["../../src/tools/list_projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAID,qBAAa,8BAA+B,SAAQ,KAAK;IAErD,QAAQ,CAAC,IAAI,EAAE,yBAAyB;gBAA/B,IAAI,EAAE,yBAAyB,EACxC,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,gBAAgB,EAC5B,kBAAkB,GAAE,kBAAkB,EAAO,GAC5C,IAAI,CAkCN"}

package/dist/tools/list_projects.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+import { projectSummaryShape } from "./create_project.js";
+export const LIST_PROJECTS_TOOL_NAME = "mcp__genie__list_projects";
+const listProjectsArgsSchema = z.object({}).strict();
+export class ProjectBackendUnreachableError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ProjectBackendUnreachableError";
+    }
+}
+export function registerListProjectsTool(server, localStore, additionalBackends = []) {
+    server.registerTool(LIST_PROJECTS_TOOL_NAME, {
+        title: "List projects",
+        description: "List genie workspace and blueprint projects visible to this server. " +
+            "Read-only and idempotent; returns local results even if an optional git-host backend is unreachable. " +
+            "Reach for this as the discovery step before get_project, bind_kit, or conjure_screen.",
+        inputSchema: listProjectsArgsSchema,
+        outputSchema: {
+            projects: z.array(z.object(projectSummaryShape).strict()),
+        },
+    }, async (args) => {
+        listProjectsArgsSchema.parse(args);
+        const projects = [...(await localStore.listProjects())];
+        const warnings = [];
+        for (const backend of additionalBackends) {
+            try {
+                projects.push(...(await backend.listProjects()));
+            }
+            catch (error) {
+                warnings.push(toBackendWarning(backend.name, error));
+            }
+        }
+        const result = { projects: sortProjects(projects) };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+            structuredContent: result,
+            ...(warnings.length > 0 ? { _meta: { warnings } } : {}),
+        };
+    });
+}
+function sortProjects(projects) {
+    return [...projects].sort((a, b) => compareText(a.kind, b.kind) || compareText(a.name, b.name) || compareText(a.id, b.id));
+}
+function compareText(a, b) {
+    const aNorm = a.normalize("NFC").toLowerCase();
+    const bNorm = b.normalize("NFC").toLowerCase();
+    return aNorm < bNorm ? -1 : aNorm > bNorm ? 1 : a < b ? -1 : a > b ? 1 : 0;
+}
+function toBackendWarning(backend, error) {
+    if (error instanceof ProjectBackendUnreachableError) {
+        return {
+            code: error.code,
+            message: error.message,
+            backend,
+        };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        code: "ERR_BACKEND_UNREACHABLE",
+        message: `Project backend "${backend}" unreachable; showing local projects only. ${message}`,
+        backend,
+    };
+}
+//# sourceMappingURL=list_projects.js.map

package/dist/tools/list_projects.js.map

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

package/dist/tools/plan.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP tool: plan (M1-07).
+ *
+ * The single user-visible permission grant that locks `writes`, `deletes`,
+ * and `localDir`. Returns a `planId` that downstream write/delete calls must
+ * present. Without a valid `planId`, those verbs are rejected.
+ *
+ * Input:  { kitId: string, writes: string[], deletes?: string[], localDir?: string }
+ * Output: { planId: string }
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register the `mcp__genie__plan` tool on the given MCP server.
+ */
+export declare function registerPlan(server: McpServer): void;
+//# sourceMappingURL=plan.d.ts.map

package/dist/tools/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4CzE;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuHpD"}