@antelopejs/dms-ai 0.0.1

package/sidecar/dist/mcp/tools/builder.d.ts

@@ -0,0 +1,259 @@
+import { z } from "zod";
+import type { BuilderClient } from "../../builder/builder-client.js";
+export interface BuilderToolsDeps {
+    builderClient: BuilderClient;
+}
+export declare function buildBuilderTools(deps: BuilderToolsDeps): (import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    pageRef: z.ZodString;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    category: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    pageRef: z.ZodString;
+    patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    page: z.ZodString;
+    parent: z.ZodOptional<z.ZodString>;
+    slot: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    type: z.ZodString;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    controller: z.ZodOptional<z.ZodString>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    path: z.ZodString;
+    patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    replace: z.ZodOptional<z.ZodBoolean>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    path: z.ZodString;
+    parent: z.ZodString;
+    slot: z.ZodOptional<z.ZodString>;
+    index: z.ZodNumber;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    path: z.ZodString;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    parent: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    ref: z.ZodString;
+    patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    ref: z.ZodString;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    pageRef: z.ZodOptional<z.ZodString>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    name: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        dataType: z.ZodObject<{
+            $dataType: z.ZodString;
+            config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        }, {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        listable: z.ZodOptional<z.ZodBoolean>;
+        searchable: z.ZodOptional<z.ZodBoolean>;
+        sortable: z.ZodOptional<z.ZodBoolean>;
+        filterable: z.ZodOptional<z.ZodBoolean>;
+        access: z.ZodOptional<z.ZodEnum<["read", "readwrite"]>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        indexed: z.ZodOptional<z.ZodBoolean>;
+        order: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        dataType: {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        };
+        label?: string | undefined;
+        listable?: boolean | undefined;
+        searchable?: boolean | undefined;
+        sortable?: boolean | undefined;
+        filterable?: boolean | undefined;
+        access?: "read" | "readwrite" | undefined;
+        required?: boolean | undefined;
+        indexed?: boolean | undefined;
+        order?: number | undefined;
+    }, {
+        name: string;
+        dataType: {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        };
+        label?: string | undefined;
+        listable?: boolean | undefined;
+        searchable?: boolean | undefined;
+        sortable?: boolean | undefined;
+        filterable?: boolean | undefined;
+        access?: "read" | "readwrite" | undefined;
+        required?: boolean | undefined;
+        indexed?: boolean | undefined;
+        order?: number | undefined;
+    }>, "many">;
+    seeds: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    location: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        category: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        category: string;
+    }, {
+        category: string;
+    }>, z.ZodObject<{
+        page: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        page: string;
+    }, {
+        page: string;
+    }>]>>;
+    routes: z.ZodOptional<z.ZodArray<z.ZodEnum<["list", "get", "create", "edit", "delete", "select", "archive", "export"]>, "many">>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    ref: z.ZodString;
+    keepData: z.ZodOptional<z.ZodBoolean>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    ref: z.ZodString;
+    field: z.ZodObject<{
+        dataType: z.ZodObject<{
+            $dataType: z.ZodString;
+            config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        }, {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        listable: z.ZodOptional<z.ZodBoolean>;
+        searchable: z.ZodOptional<z.ZodBoolean>;
+        sortable: z.ZodOptional<z.ZodBoolean>;
+        filterable: z.ZodOptional<z.ZodBoolean>;
+        access: z.ZodOptional<z.ZodEnum<["read", "readwrite"]>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        indexed: z.ZodOptional<z.ZodBoolean>;
+        order: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        dataType: {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        };
+        label?: string | undefined;
+        listable?: boolean | undefined;
+        searchable?: boolean | undefined;
+        sortable?: boolean | undefined;
+        filterable?: boolean | undefined;
+        access?: "read" | "readwrite" | undefined;
+        required?: boolean | undefined;
+        indexed?: boolean | undefined;
+        order?: number | undefined;
+    }, {
+        name: string;
+        dataType: {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        };
+        label?: string | undefined;
+        listable?: boolean | undefined;
+        searchable?: boolean | undefined;
+        sortable?: boolean | undefined;
+        filterable?: boolean | undefined;
+        access?: "read" | "readwrite" | undefined;
+        required?: boolean | undefined;
+        indexed?: boolean | undefined;
+        order?: number | undefined;
+    }>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    path: z.ZodString;
+    patch: z.ZodObject<{
+        dataType: z.ZodOptional<z.ZodObject<{
+            $dataType: z.ZodString;
+            config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        }, {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        }>>;
+        label: z.ZodOptional<z.ZodString>;
+        listable: z.ZodOptional<z.ZodBoolean>;
+        searchable: z.ZodOptional<z.ZodBoolean>;
+        sortable: z.ZodOptional<z.ZodBoolean>;
+        filterable: z.ZodOptional<z.ZodBoolean>;
+        access: z.ZodOptional<z.ZodEnum<["read", "readwrite"]>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        indexed: z.ZodOptional<z.ZodBoolean>;
+        order: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        label?: string | undefined;
+        dataType?: {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        } | undefined;
+        listable?: boolean | undefined;
+        searchable?: boolean | undefined;
+        sortable?: boolean | undefined;
+        filterable?: boolean | undefined;
+        access?: "read" | "readwrite" | undefined;
+        required?: boolean | undefined;
+        indexed?: boolean | undefined;
+        order?: number | undefined;
+    }, {
+        label?: string | undefined;
+        dataType?: {
+            $dataType: string;
+            config?: Record<string, unknown> | undefined;
+        } | undefined;
+        listable?: boolean | undefined;
+        searchable?: boolean | undefined;
+        sortable?: boolean | undefined;
+        filterable?: boolean | undefined;
+        access?: "read" | "readwrite" | undefined;
+        required?: boolean | undefined;
+        indexed?: boolean | undefined;
+        order?: number | undefined;
+    }>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    resourceType: z.ZodOptional<z.ZodString>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    page: z.ZodString;
+    name: z.ZodString;
+    resource: z.ZodString;
+    template: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    endpoint: z.ZodOptional<z.ZodString>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    query: z.ZodString;
+    patch: z.ZodObject<{
+        resource: z.ZodOptional<z.ZodString>;
+        template: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        endpoint: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        params?: Record<string, unknown> | undefined;
+        resource?: string | undefined;
+        template?: string | undefined;
+        endpoint?: string | undefined;
+    }, {
+        params?: Record<string, unknown> | undefined;
+        resource?: string | undefined;
+        template?: string | undefined;
+        endpoint?: string | undefined;
+    }>;
+}> | import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    query: z.ZodString;
+}>)[];

package/sidecar/dist/mcp/tools/builder.js

@@ -0,0 +1,216 @@
+import { tool } from "@anthropic-ai/claude-agent-sdk";
+import { z } from "zod";
+import { BUILDER_ESCALATION_NOTE, BUILDER_EXPR_REFUSAL, BUILDER_REF_NOTE, } from "../../prompts/builder.js";
+function content(text) {
+    return { content: [{ type: "text", text }] };
+}
+function note(description) {
+    return `${description}\n\n${BUILDER_ESCALATION_NOTE}`;
+}
+function hasExprSentinel(value) {
+    if (Array.isArray(value)) {
+        return value.some(hasExprSentinel);
+    }
+    if (value !== null && typeof value === "object") {
+        const record = value;
+        if (typeof record.$expr === "string") {
+            return true;
+        }
+        return Object.values(record).some(hasExprSentinel);
+    }
+    return false;
+}
+function exprRefusal() {
+    return content(JSON.stringify({
+        ok: false,
+        error: { code: "unsupported", detail: BUILDER_EXPR_REFUSAL },
+    }));
+}
+const CONFIG = z.record(z.unknown());
+const BLOCK_PATH_FORMAT = "A block path from BuilderPageStructure: `<pageRef>#<block>` for a top-level block, then `/<child>` per nesting level (e.g. `/dashboard#grid/row/kpi`). Separators: `#` after the page, `/` between blocks.";
+const BLOCK_PATH = z.string().describe(BLOCK_PATH_FORMAT);
+const PARENT_PATH = z
+    .string()
+    .describe(`Container block to nest under. ${BLOCK_PATH_FORMAT}`);
+const FIELD_PATH_FORMAT = "A field path `<resourceRef>#<fieldName>` (the `ref` from BuilderListResources plus the field name).";
+const FIELD_PATH = z.string().describe(FIELD_PATH_FORMAT);
+const DATA_TYPE_VALUE = z.object({
+    $dataType: z
+        .string()
+        .describe("A `dataTypes` id from BuilderCatalog, e.g. `string`, `select`."),
+    config: z
+        .record(z.unknown())
+        .optional()
+        .describe(`That DataType's own config, per BuilderCatalog. ${BUILDER_REF_NOTE}`),
+});
+const FIELD_ASPECTS = {
+    dataType: DATA_TYPE_VALUE,
+    label: z
+        .string()
+        .optional()
+        .describe("Column header. Defaults to the field name."),
+    listable: z
+        .boolean()
+        .optional()
+        .describe("Show in list/table responses. Default true."),
+    searchable: z.boolean().optional().describe("Include in free-text search."),
+    sortable: z.boolean().optional().describe("Allow sorting by this field."),
+    filterable: z.boolean().optional().describe("Allow filtering by this field."),
+    access: z
+        .enum(["read", "readwrite"])
+        .optional()
+        .describe("`read` makes it write-protected. Default `readwrite`."),
+    required: z.boolean().optional().describe("Reject writes omitting it."),
+    indexed: z.boolean().optional().describe("Add a database index."),
+    order: z
+        .number()
+        .optional()
+        .describe("Position among the resource's fields."),
+};
+const RESOURCE_LOCATION = z
+    .union([
+    z.string(),
+    z.object({ category: z.string() }),
+    z.object({ page: z.string() }),
+])
+    .describe("Where the resource folder goes: a `dir` string relative to src root, `{ category: <CategoryRef> }` (mirrors page placement), or `{ page: <PageRef> }` (nests beside that page). Omit for `src/<name>/`.");
+const RESOURCE_ROUTE = z
+    .enum([
+    "list",
+    "get",
+    "create",
+    "edit",
+    "delete",
+    "select",
+    "archive",
+    "export",
+])
+    .describe("A DataAPI route: `list` (paginated listing), `get` (read one), `create`, `edit`, `delete`, `select` (relation-picker options), `archive` (soft delete + undo), `export` (CSV).");
+const FIELD_SPEC = z.object({
+    name: z
+        .string()
+        .describe("Field name. Must not be one of BuilderCatalog's `reservedFieldNames` (they collide with a generated route or Model member) — e.g. use `itemCount`, not `count`."),
+    ...FIELD_ASPECTS,
+});
+const QUERY_REF = z
+    .string()
+    .describe("A query ref `<pageRef>@<queryName>` (e.g. `/catalog/books@inStockCount`), as reported in BuilderPageStructure's `queries`.");
+const QUERY_ENDPOINT = z
+    .string()
+    .describe('Route path relative to the page\'s slug, e.g. `/stats/in-stock`. Must start with `/` and not collide with another route the page serves. Omit for `/stats/<kebab-name>`. A `$param` bound with `in: "param"` reads a path segment, so include a matching `:name` (e.g. `/stats/by-author/:author`).');
+const QUERY_PARAMS = z
+    .record(z.unknown())
+    .describe("The template's parameters, keyed exactly as the `params` schema BuilderQueryTemplates reports for it — that schema documents every key and value shape, and an unrecognised key is rejected.");
+const FIELD_ASPECTS_PATCH = z.object({
+    ...FIELD_ASPECTS,
+    dataType: DATA_TYPE_VALUE.optional(),
+});
+export function buildBuilderTools(deps) {
+    const run = async (op, args) => content(JSON.stringify(await deps.builderClient.call(op, args)));
+    return [
+        tool("BuilderCatalog", note("Lists every block type and DataType the page builder can emit, with their config schemas. Call this before adding blocks so you use valid types and options. For a config field whose schema is marked `x-dataType` (e.g. a Form field's `type`), pass a DataType value `{ $dataType: \"<id>\", config: {…} }` using an id and config from this catalog's `dataTypes` — never a raw `$expr`."), {}, () => run("GetCatalog", [])),
+        tool("BuilderListPages", note("Lists all builder-editable pages (route, id, category, file)."), {}, () => run("ListPages", [])),
+        tool("BuilderPageStructure", note(`Returns a page's block tree (each block's path, type, editability, config) plus a version hash for optimistic concurrency. ${BLOCK_PATH_FORMAT}`), { pageRef: z.string() }, ({ pageRef }) => run("GetPageStructure", [pageRef])),
+        tool("BuilderCreatePage", note("Creates a new page under an existing category and wires it into the barrel so it registers."), {
+            name: z.string(),
+            displayName: z.string(),
+            category: z.string(),
+            icon: z.string().optional(),
+            order: z.number().optional(),
+            description: z.string().optional(),
+        }, (input) => run("CreatePage", [input])),
+        tool("BuilderConfigurePage", note("Updates a page's metadata (displayName, icon, order, description)."), { pageRef: z.string(), patch: CONFIG }, async ({ pageRef, patch }) => hasExprSentinel(patch)
+            ? exprRefusal()
+            : run("ConfigurePage", [pageRef, patch])),
+        tool("BuilderDeletePage", note("Deletes a page file and removes its barrel import."), { pageRef: z.string() }, ({ pageRef }) => run("DeletePage", [pageRef])),
+        tool("BuilderAddBlock", note("Adds a block. Omit `parent` for a top-level block, or pass a container block's path to nest. `type` and `config` must match the catalog. Block types the catalog marks `controllerArg: true` (e.g. `TableView`) bind to a data resource: pass `controller` = the resource `ref` from BuilderListResources (its DataAPI class becomes the block's leading argument) and put the display options in `config`."), {
+            page: z.string(),
+            parent: PARENT_PATH.optional(),
+            slot: z.string().optional(),
+            index: z.number().optional(),
+            name: z.string(),
+            type: z.string(),
+            config: CONFIG,
+            controller: z
+                .string()
+                .optional()
+                .describe("Resource ref (from BuilderListResources) for a controller-leading block such as TableView. Required for those types; rejected for others."),
+        }, async (input) => hasExprSentinel(input.config)
+            ? exprRefusal()
+            : run("AddBlock", [input])),
+        tool("BuilderConfigureBlock", note("Merges (or replaces, with replace:true) options into a block's config. Children are managed with Add/Move/Remove, not here."), { path: BLOCK_PATH, patch: CONFIG, replace: z.boolean().optional() }, async ({ path, patch, replace, }) => hasExprSentinel(patch)
+            ? exprRefusal()
+            : run("ConfigureBlock", [path, patch, { replace }])),
+        tool("BuilderMoveBlock", note("Moves a child block to a new position within a container."), {
+            path: BLOCK_PATH,
+            parent: PARENT_PATH,
+            slot: z.string().optional(),
+            index: z.number(),
+        }, ({ path, parent, slot, index, }) => run("MoveBlock", [path, { parent, slot, index }])),
+        tool("BuilderRemoveBlock", note("Removes a block and its whole subtree."), { path: BLOCK_PATH }, ({ path }) => run("RemoveBlock", [path])),
+        tool("BuilderCreateCategory", note("Creates a navigation category (optionally under a parent category)."), {
+            name: z.string(),
+            displayName: z.string(),
+            parent: z.string().optional(),
+            icon: z.string().optional(),
+            order: z.number().optional(),
+        }, (input) => run("CreateCategory", [input])),
+        tool("BuilderConfigureCategory", note("Updates a category's metadata (displayName, icon, order)."), { ref: z.string(), patch: CONFIG }, async ({ ref, patch }) => hasExprSentinel(patch)
+            ? exprRefusal()
+            : run("ConfigureCategory", [ref, patch])),
+        tool("BuilderDeleteCategory", note("Deletes a category. Refused with referential_integrity if any page still references it."), { ref: z.string() }, ({ ref }) => run("DeleteCategory", [ref])),
+        tool("BuilderRefresh", note("Reconciles the builder's source index with disk after out-of-band edits (e.g. a vibe-mode excursion)."), { pageRef: z.string().optional() }, ({ pageRef }) => run("RefreshSourceIndex", pageRef ? [{ page: pageRef }] : [])),
+        tool("BuilderListResources", note("Lists every data resource (its ref, class/table names, /api route, field count, files). A resource is a Database Table+Model paired with a DataAPI controller."), {}, () => run("ListResources", [])),
+        tool("BuilderResourceStructure", note("Returns a resource's fields with their semantic aspects, its `routes` (absent when it serves the full set), and a version hash for optimistic concurrency. Hand-edited or relation fields come back marked `opaque` — safe mode cannot reconfigure those."), { ref: z.string() }, ({ ref }) => run("GetResourceStructure", [ref])),
+        tool("BuilderCreateResource", note("Creates a data resource — a Database Table+Model plus a matching DataAPI controller at /api/<name> — as a folder wired into the nearest barrel. Every resource auto-manages its own `_id`. When you limit `routes`, keep the view in sync: drop the TableView rowActions whose routes you left out, or bind a Form instead."), {
+            name: z.string(),
+            displayName: z.string().optional(),
+            schema: z.string().optional(),
+            fields: z.array(FIELD_SPEC),
+            seeds: z.array(z.record(z.unknown())).optional(),
+            location: RESOURCE_LOCATION.optional(),
+            routes: z.array(RESOURCE_ROUTE).min(1).optional(),
+        }, async (input) => hasExprSentinel(input) ? exprRefusal() : run("CreateResource", [input])),
+        tool("BuilderDeleteResource", note("Deletes a resource: removes its database.ts/data-api.ts/index.ts files, unwires the barrel export, and (by default) clears the resource's database table so a later resource reusing the name re-seeds cleanly instead of inheriting stale rows. Pass keepData: true to leave the table data in place. Does not detect pages whose TableView references its /api route."), { ref: z.string(), keepData: z.boolean().optional() }, ({ ref, keepData }) => run("DeleteResource", keepData === undefined ? [ref] : [ref, { keepData }])),
+        tool("BuilderAddField", note("Adds a field to a resource, editing the Table and DataAPI classes together in one atomic op."), { ref: z.string(), field: FIELD_SPEC }, async ({ ref, field }) => hasExprSentinel(field) ? exprRefusal() : run("AddField", [ref, field])),
+        tool("BuilderConfigureField", note("Reconfigures a field by merging the patch over its current aspects and re-deriving the whole decorator stack on both classes (no drift). Field name is immutable — rename via BuilderRemoveField + BuilderAddField."), { path: FIELD_PATH, patch: FIELD_ASPECTS_PATCH }, async ({ path, patch }) => hasExprSentinel(patch)
+            ? exprRefusal()
+            : run("ConfigureField", [path, patch])),
+        tool("BuilderRemoveField", note("Removes a field from a resource's Table and DataAPI classes in one atomic op. Leaves seed rows untouched."), { path: FIELD_PATH }, ({ path }) => run("RemoveField", [path])),
+        tool("BuilderQueryTemplates", note("Lists the query templates BuilderAddQuery can compile, each with its id, what it computes, its `output` kind, and the JSON Schema for its `params`. Call this before adding a query — the schema is the reference for every parameter and value shape."), {
+            resourceType: z
+                .string()
+                .optional()
+                .describe("Filter to templates for one resource type (v1 has only `database-table`). Omit for all."),
+        }, ({ resourceType }) => run("ListQueryTemplates", resourceType ? [resourceType] : [])),
+        tool("BuilderAddQuery", note("Adds a query — a page-hosted GET route serving one computed number that the DataAPI cannot give you. Compiles the template into a method on the resource's model and a route on the page, atomically. Returns `{ query, route }`; `route` is the full URL to pass as a KpiCard's `fetchUrl`, and it serves `{ \"value\": <number> }`."), {
+            page: z
+                .string()
+                .describe("PageRef the query is served from — the page that displays it, not the resource's page."),
+            name: z
+                .string()
+                .describe("camelCase identifier, unique among the page's members. Names the route; the model method it compiles into may differ, since queries wanting the identical chain share one."),
+            resource: z
+                .string()
+                .describe("Resource ref to read, from BuilderListResources."),
+            template: z
+                .string()
+                .describe("A template id from BuilderQueryTemplates."),
+            params: QUERY_PARAMS.optional(),
+            endpoint: QUERY_ENDPOINT.optional(),
+        }, async ({ page, ...input }) => hasExprSentinel(input) ? exprRefusal() : run("AddQuery", [page, input])),
+        tool("BuilderConfigureQuery", note("Recompiles a query, replacing both its route and its chain. Only the keys you pass change; the rest are re-read from the query. A query BuilderPageStructure reports as `opaque` is refused with opaque_target, leaving the hand-edit intact. Renaming is not supported — remove and re-add. Never affects another page's query, even one sharing the same model method."), {
+            query: QUERY_REF,
+            patch: z.object({
+                resource: z.string().optional(),
+                template: z.string().optional(),
+                params: QUERY_PARAMS.optional(),
+                endpoint: QUERY_ENDPOINT.optional(),
+            }),
+        }, async ({ query, patch }) => hasExprSentinel(patch)
+            ? exprRefusal()
+            : run("ConfigureQuery", [query, patch])),
+        tool("BuilderRemoveQuery", note("Removes a query's route from the page, and its model method too once no route on any page still calls it. Works on an opaque query as well — the builder can always remove what it cannot edit. Does not detect blocks whose fetchUrl points at the removed route: fix those in the same turn."), { query: QUERY_REF }, ({ query }) => run("RemoveQuery", [query])),
+    ];
+}
+//# sourceMappingURL=builder.js.map

package/sidecar/dist/mcp/tools/builder.js.map

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

package/sidecar/dist/mcp/tools/find-pages-using.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import type { ImportsScanner, ScanResult } from "../../pages/imports-scanner.js";
+import type { RegistryClient } from "../../pages/registry-client.js";
+import type { PageCandidate, PagesRegistryEntry } from "../../pages/types.js";
+import type { CurrentPage } from "../../state/host-state.js";
+export interface FindPagesUsingDeps {
+    registry: RegistryClient;
+    scanner: ImportsScanner;
+    hostProjectRoot: string;
+    getCurrentPage: () => CurrentPage;
+}
+export declare function computeCandidates(filepath: string, pages: readonly PagesRegistryEntry[], scan: ScanResult, rootDir: string, currentPage: CurrentPage): PageCandidate[];
+export declare function buildFindPagesUsingTool(deps: FindPagesUsingDeps): import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    readonly filepath: z.ZodString;
+}>;

package/sidecar/dist/mcp/tools/find-pages-using.js

@@ -0,0 +1,108 @@
+import path from "node:path";
+import { tool } from "@anthropic-ai/claude-agent-sdk";
+import { z } from "zod";
+import { FIND_PAGES_TOOL_DESCRIPTION, FIND_PAGES_TOOL_NAME, MAX_BFS_DEPTH, } from "../../constants/pages.js";
+const INPUT_SCHEMA = { filepath: z.string() };
+function toAbsolute(rootDir, filepath) {
+    if (path.isAbsolute(filepath))
+        return filepath;
+    return path.resolve(rootDir, filepath);
+}
+function buildPageFilepathSet(rootDir, pages) {
+    const map = new Map();
+    for (const page of pages) {
+        if (page.filepath === undefined)
+            continue;
+        const absolute = toAbsolute(rootDir, page.filepath);
+        map.set(absolute, page);
+    }
+    return map;
+}
+function buildDirectCandidate(page, rootDir) {
+    return {
+        pagePath: page.path,
+        pageFilepath: toAbsolute(rootDir, page.filepath ?? ""),
+        distance: 0,
+    };
+}
+function findDirectPage(absoluteFilepath, pageMap, rootDir) {
+    const page = pageMap.get(absoluteFilepath);
+    if (page === undefined)
+        return null;
+    return buildDirectCandidate(page, rootDir);
+}
+function pushImporters(state, importers, nextDepth) {
+    for (const importer of importers) {
+        if (state.visited.has(importer))
+            continue;
+        state.visited.add(importer);
+        state.queue.push({ file: importer, depth: nextDepth });
+    }
+}
+function recordHitIfPage(state, file, depth, pageMap, rootDir) {
+    const page = pageMap.get(file);
+    if (page === undefined)
+        return;
+    state.hits.push({
+        pagePath: page.path,
+        pageFilepath: toAbsolute(rootDir, page.filepath ?? ""),
+        distance: depth,
+    });
+}
+function bfsToPages(startFile, scan, pageMap, rootDir) {
+    const state = {
+        visited: new Set([startFile]),
+        queue: [{ file: startFile, depth: 0 }],
+        hits: [],
+    };
+    while (state.queue.length > 0) {
+        const node = state.queue.shift();
+        if (node === undefined)
+            break;
+        if (node.depth > 0) {
+            recordHitIfPage(state, node.file, node.depth, pageMap, rootDir);
+        }
+        if (node.depth >= MAX_BFS_DEPTH)
+            continue;
+        const importers = scan.importersByFile.get(node.file) ?? [];
+        pushImporters(state, importers, node.depth + 1);
+    }
+    return state.hits;
+}
+function comparatorFor(currentPagePath) {
+    return (a, b) => {
+        const aIsCurrent = currentPagePath !== undefined && a.pagePath === currentPagePath;
+        const bIsCurrent = currentPagePath !== undefined && b.pagePath === currentPagePath;
+        if (aIsCurrent && !bIsCurrent)
+            return -1;
+        if (!aIsCurrent && bIsCurrent)
+            return 1;
+        return a.distance - b.distance;
+    };
+}
+function sortCandidates(candidates, currentPagePath) {
+    return [...candidates].sort(comparatorFor(currentPagePath));
+}
+export function computeCandidates(filepath, pages, scan, rootDir, currentPage) {
+    const absolute = toAbsolute(rootDir, filepath);
+    const pageMap = buildPageFilepathSet(rootDir, pages);
+    const direct = findDirectPage(absolute, pageMap, rootDir);
+    if (direct !== null)
+        return sortCandidates([direct], currentPage.path);
+    const hits = bfsToPages(absolute, scan, pageMap, rootDir);
+    return sortCandidates(hits, currentPage.path);
+}
+function buildContent(candidates) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(candidates) }],
+    };
+}
+export function buildFindPagesUsingTool(deps) {
+    return tool(FIND_PAGES_TOOL_NAME, FIND_PAGES_TOOL_DESCRIPTION, INPUT_SCHEMA, async ({ filepath }) => {
+        const pages = await deps.registry.getRegistry();
+        const scan = await deps.scanner.scan(deps.hostProjectRoot);
+        const candidates = computeCandidates(filepath, pages, scan, deps.hostProjectRoot, deps.getCurrentPage());
+        return buildContent(candidates);
+    });
+}
+//# sourceMappingURL=find-pages-using.js.map

package/sidecar/dist/mcp/tools/find-pages-using.js.map

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

package/sidecar/dist/mcp/tools/get-current-page.d.ts

@@ -0,0 +1,4 @@
+import type { CurrentPage } from "../../state/host-state.js";
+type GetCurrentPage = () => CurrentPage;
+export declare function buildGetCurrentPageTool(getCurrentPage: GetCurrentPage): import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{}>;
+export {};

package/sidecar/dist/mcp/tools/get-current-page.js

@@ -0,0 +1,12 @@
+import { tool } from "@anthropic-ai/claude-agent-sdk";
+import { GET_CURRENT_PAGE_TOOL_DESCRIPTION, GET_CURRENT_PAGE_TOOL_NAME, } from "../../constants/mcp.js";
+const EMPTY_INPUT_SCHEMA = {};
+function buildContent(page) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(page) }],
+    };
+}
+export function buildGetCurrentPageTool(getCurrentPage) {
+    return tool(GET_CURRENT_PAGE_TOOL_NAME, GET_CURRENT_PAGE_TOOL_DESCRIPTION, EMPTY_INPUT_SCHEMA, async () => buildContent(getCurrentPage()));
+}
+//# sourceMappingURL=get-current-page.js.map