keywordgraph-mcp-server 1.7.3 → 1.8.4

package/dist/tools/deleteGraph.js

@@ -0,0 +1,145 @@
+import { brand } from "../config/brand.js";
+import { DeleteGraphSchema } from "../schemas/index.js";
+import { makeInfraNodusRequest } from "../api/client.js";
+import { errorText, findGraphByName } from "../utils/graphLookup.js";
+import { describeRequestError } from "./deleteStatements.js";
+function textResult(payload, isError = false) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(payload, null, 2) },
+        ],
+        ...(isError ? { isError: true } : {}),
+    };
+}
+async function requestGraphDeletion(graphName, dryRun) {
+    try {
+        const data = (await makeInfraNodusRequest("/deleteGraph", {
+            name: graphName,
+            dryRun,
+        }));
+        if (!data || typeof data !== "object") {
+            return { ok: false, error: "Unexpected response from /deleteGraph." };
+        }
+        if (data.error)
+            return { ok: false, error: errorText(data.error) };
+        return { ok: true, data };
+    }
+    catch (error) {
+        return { ok: false, error: describeRequestError(error) };
+    }
+}
+/**
+ * Ask the user directly through MCP elicitation: a plain Accept / Decline
+ * (the spec defines "accept" as explicit approval; no extra form field, see
+ * delete_statements). A dismissed dialog or a client without the capability
+ * is "unavailable": the caller then returns the dry run so the question can
+ * be asked in chat.
+ */
+async function elicitApproval(extra, graphName, plan) {
+    if (!extra?.elicit || !extra.clientCapabilities?.elicitation) {
+        return { kind: "unavailable", detail: "client does not support elicitation" };
+    }
+    const lines = [
+        `Permanently delete the graph "${graphName}" from ${brand.name}, with all of its statements? This cannot be undone.`,
+        ...(plan.isLive ? ["It is a live graph: its scheduled imports will stop."] : []),
+        ...(plan.graphUrl ? ["", plan.graphUrl] : []),
+    ];
+    try {
+        const result = await extra.elicit({
+            message: lines.join("\n"),
+            requestedSchema: { type: "object", properties: {} },
+        });
+        if (result.action === "accept")
+            return { kind: "accepted" };
+        if (result.action === "decline")
+            return { kind: "declined" };
+        return { kind: "unavailable", detail: "the user dismissed the dialog without answering" };
+    }
+    catch (error) {
+        return {
+            kind: "unavailable",
+            detail: `elicitation failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+export const deleteGraphTool = {
+    name: "delete_graph",
+    definition: {
+        title: `Delete a ${brand.name} Graph`,
+        description: `Delete one graph from the user's own ${brand.name} account entirely — all of its statements, revisions, settings, and its URL; the name becomes free again. IRREVERSIBLE once confirmed. ` +
+            `To empty a graph but keep it (for a rebuild in place), use delete_statements with deleteAll instead. ` +
+            `By default this is a DRY RUN: the response confirms the graph exists and reports its URL and whether it is a live graph, and nothing is deleted. Show that to the user; only if they agree, call again with the SAME graphName and confirm: true. If the client supports elicitation the user is asked directly and the deletion happens in the same call. ` +
+            `Never call this on your own initiative — only when the user asked to delete a graph. Only graphs in the user's own account can be targeted (there is no userName parameter); a name that is not in the account is an error and nothing is deleted.`,
+        inputSchema: DeleteGraphSchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    },
+    handler: async (params, extra) => {
+        try {
+            const graphName = params.graphName.trim();
+            // 1. The graph must exist in this account.
+            const graph = await findGraphByName(graphName);
+            if (!graph) {
+                return textResult({
+                    error: `No graph named "${graphName}" in this ${brand.name} account. Nothing was deleted. Use list_graphs to check the exact name.`,
+                }, true);
+            }
+            // 2. Preview: the app resolves the same graph it will delete.
+            const preview = await requestGraphDeletion(graphName, true);
+            if (!preview.ok) {
+                return textResult({ error: `Dry run failed — nothing was deleted. ${preview.error}` }, true);
+            }
+            const plan = preview.data;
+            const graphUrl = plan.graphUrl ?? graph.defaultRevisionUrl ?? undefined;
+            // 3. Consent: confirm: true from the caller, or an accepted form.
+            let approved = params.confirm === true;
+            let elicitationDetail;
+            if (!approved) {
+                const answer = await elicitApproval(extra, graphName, plan);
+                if (answer.kind === "accepted") {
+                    approved = true;
+                }
+                else if (answer.kind === "declined") {
+                    return textResult({
+                        deleted: false,
+                        declined: true,
+                        graphName,
+                        message: "The user declined the deletion. Nothing was deleted. Do not retry.",
+                    });
+                }
+                else {
+                    elicitationDetail = answer.detail;
+                }
+            }
+            if (!approved) {
+                return textResult({
+                    deleted: false,
+                    dryRun: true,
+                    graphName,
+                    ...(graphUrl ? { graphUrl } : {}),
+                    isLive: plan.isLive === true,
+                    ...(elicitationDetail ? { elicitation: elicitationDetail } : {}),
+                    nextStep: "Nothing was deleted. Ask the user to confirm; if they agree, call delete_graph again with the SAME graphName and confirm: true.",
+                });
+            }
+            // 4. Delete.
+            const write = await requestGraphDeletion(graphName, false);
+            if (!write.ok) {
+                return textResult({ error: `Deletion failed. ${write.error}` }, true);
+            }
+            return textResult({
+                deleted: write.data.deleted === true,
+                graphName: write.data.graphName ?? graphName,
+                message: `The graph "${graphName}" and all of its statements were deleted.`,
+            });
+        }
+        catch (error) {
+            return textResult({ error: error instanceof Error ? error.message : String(error) }, true);
+        }
+    },
+};
+//# sourceMappingURL=deleteGraph.js.map

package/dist/tools/deleteGraph.js.map

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

package/dist/tools/deleteStatements.d.ts

@@ -0,0 +1,106 @@
+/**
+ * delete_statements — remove statements from a graph in the caller's own
+ * account by a filter the app resolves (see docs/drafts/delete-statements-tool.md).
+ *
+ * The first destructive tool in this server. Its safety comes from the
+ * shape of the call, not from trust in the model: exactly one selector, the
+ * graph must already exist, a dry run is the default, and the write only
+ * happens with `confirm: true` or an elicitation form the user accepts.
+ * The same filter is sent for the preview and for the write, so what the
+ * user approved is what gets removed.
+ */
+import { z } from "zod";
+import { DeleteStatementsSchema } from "../schemas/index.js";
+import type { ToolExtra } from "../types/index.js";
+type Params = z.infer<typeof DeleteStatementsSchema>;
+/** How many matched statements the dry run echoes back to the model. */
+export declare const MATCHED_SHOWN = 50;
+/** The filter part of the /deleteStatements body (everything but name/dryRun). */
+export type Selector = {
+    categories: string[];
+} | {
+    statements: string[];
+} | {
+    query: string;
+} | {
+    before?: string;
+    after?: string;
+} | {
+    all: true;
+} | {
+    statementIds: number[];
+};
+export type SelectorResult = {
+    ok: true;
+    selector: Selector;
+    kind: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** The selector fields shared by delete_statements and update_statements. */
+export interface SelectorParams {
+    categories?: string[];
+    statements?: string[];
+    query?: string;
+    before?: string;
+    after?: string;
+    deleteAll?: boolean;
+    all?: boolean;
+    statementIds?: number[];
+}
+/**
+ * Resolve exactly one selector from the parameters. Empty arrays, blank
+ * strings and `deleteAll: false` count as "not given". `before` and `after`
+ * are one selector together (a time window). Pure; no network.
+ *
+ * `allField` names the whole-graph flag: `deleteAll` for delete_statements,
+ * `all` for update_statements (both are sent to the app as `all: true`).
+ */
+export declare function buildSelector(params: SelectorParams, allField?: "deleteAll" | "all"): SelectorResult;
+export interface MatchedStatement {
+    id: number;
+    content: string;
+    categories?: string[];
+    timestamp?: string;
+}
+/**
+ * makeInfraNodusRequest throws `API request failed (status): body` on a
+ * non-2xx; the body is `{ error }`. Turn that into one readable line, with
+ * the status-specific meaning the model needs to act on it. Shared with
+ * update_statements, whose endpoint answers the same status codes.
+ */
+export declare function describeRequestError(error: unknown): string;
+export declare const deleteStatementsTool: {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            graphName: z.ZodString;
+            categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            statements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            query: z.ZodOptional<z.ZodString>;
+            before: z.ZodOptional<z.ZodString>;
+            after: z.ZodOptional<z.ZodString>;
+            deleteAll: z.ZodOptional<z.ZodBoolean>;
+            statementIds: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            confirm: z.ZodDefault<z.ZodBoolean>;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            idempotentHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+    };
+    handler: (params: Params, extra?: ToolExtra) => Promise<{
+        isError?: boolean | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export {};
+//# sourceMappingURL=deleteStatements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deleteStatements.d.ts","sourceRoot":"","sources":["../../src/tools/deleteStatements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAI7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAWrD,wEAAwE;AACxE,eAAO,MAAM,aAAa,KAAK,CAAC;AAShC,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GACjB;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GACxB;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GACxB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,GAAG,EAAE,IAAI,CAAA;CAAE,GACb;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE9B,MAAM,MAAM,cAAc,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhC,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,cAAc,EACtB,QAAQ,GAAE,WAAW,GAAG,KAAmB,GACzC,cAAc,CAkDhB;AAMD,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAgBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAqB3D;AAwFD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;sBAkBR,MAAM,UAAU,SAAS;;;;;;;CAyGjD,CAAC"}

package/dist/tools/deleteStatements.js

@@ -0,0 +1,288 @@
+import { brand } from "../config/brand.js";
+import { DeleteStatementsSchema } from "../schemas/index.js";
+import { makeInfraNodusRequest } from "../api/client.js";
+import { errorText, findGraphByName } from "../utils/graphLookup.js";
+import { timestampIsParsable } from "../utils/graphInput.js";
+function textResult(payload, isError = false) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(payload, null, 2) },
+        ],
+        ...(isError ? { isError: true } : {}),
+    };
+}
+/** How many matched statements the dry run echoes back to the model. */
+export const MATCHED_SHOWN = 50;
+/** How many matched statements the elicitation prompt quotes. */
+const SAMPLE_IN_PROMPT = 5;
+const SAMPLE_LENGTH = 160;
+/**
+ * Resolve exactly one selector from the parameters. Empty arrays, blank
+ * strings and `deleteAll: false` count as "not given". `before` and `after`
+ * are one selector together (a time window). Pure; no network.
+ *
+ * `allField` names the whole-graph flag: `deleteAll` for delete_statements,
+ * `all` for update_statements (both are sent to the app as `all: true`).
+ */
+export function buildSelector(params, allField = "deleteAll") {
+    const given = [];
+    if (Array.isArray(params.categories) && params.categories.length > 0) {
+        given.push({ kind: "categories", selector: { categories: params.categories } });
+    }
+    if (Array.isArray(params.statements) && params.statements.length > 0) {
+        given.push({ kind: "statements", selector: { statements: params.statements } });
+    }
+    const query = params.query?.trim();
+    if (query)
+        given.push({ kind: "query", selector: { query } });
+    const before = params.before?.trim();
+    const after = params.after?.trim();
+    if (before || after) {
+        for (const [label, value] of [
+            ["before", before],
+            ["after", after],
+        ]) {
+            if (value && !timestampIsParsable(value)) {
+                return {
+                    ok: false,
+                    error: `${label} must be an ISO 8601 date or datetime (e.g. 2026-08-01 or 2026-08-01T12:00:00Z); got "${value}". Ambiguous formats such as 03.05.2026 are refused because the server could misread the month and day.`,
+                };
+            }
+        }
+        given.push({
+            kind: before && after ? "before/after" : before ? "before" : "after",
+            selector: { ...(before ? { before } : {}), ...(after ? { after } : {}) },
+        });
+    }
+    if (params[allField] === true)
+        given.push({ kind: allField, selector: { all: true } });
+    if (Array.isArray(params.statementIds) && params.statementIds.length > 0) {
+        given.push({ kind: "statementIds", selector: { statementIds: params.statementIds } });
+    }
+    if (given.length === 0) {
+        return {
+            ok: false,
+            error: `No selector given. Provide exactly one of: categories, statements, query, before/after, ${allField}: true, or statementIds.`,
+        };
+    }
+    if (given.length > 1) {
+        return {
+            ok: false,
+            error: `Exactly one selector per call; got ${given.map((g) => g.kind).join(" and ")}. Split the ${allField === "all" ? "update" : "deletion"} into separate calls.`,
+        };
+    }
+    return { ok: true, selector: given[0].selector, kind: given[0].kind };
+}
+/**
+ * makeInfraNodusRequest throws `API request failed (status): body` on a
+ * non-2xx; the body is `{ error }`. Turn that into one readable line, with
+ * the status-specific meaning the model needs to act on it. Shared with
+ * update_statements, whose endpoint answers the same status codes.
+ */
+export function describeRequestError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const match = /^API request failed \((\d+)\): ([\s\S]*)$/.exec(message);
+    if (!match)
+        return message;
+    const status = Number(match[1]);
+    let detail = match[2].trim();
+    try {
+        const parsed = JSON.parse(detail);
+        detail = errorText(parsed.error ?? parsed.message ?? parsed);
+    }
+    catch {
+        // plain-text body; keep as is
+    }
+    const hint = status === 400
+        ? "The request was rejected."
+        : status === 403
+            ? "The graph is not in this account (or the request was anonymous); only your own graphs can be edited."
+            : status === 404
+                ? "The graph was not found in this account."
+                : "";
+    return [`${status}: ${detail}`, hint].filter(Boolean).join(" ");
+}
+async function requestDeletion(graphName, selector, dryRun) {
+    try {
+        const data = (await makeInfraNodusRequest("/deleteStatements", {
+            name: graphName,
+            ...selector,
+            dryRun,
+        }));
+        if (!data || typeof data !== "object") {
+            return { ok: false, error: "Unexpected response from /deleteStatements." };
+        }
+        if (data.error)
+            return { ok: false, error: errorText(data.error) };
+        return { ok: true, data };
+    }
+    catch (error) {
+        return { ok: false, error: describeRequestError(error) };
+    }
+}
+function sampleLine(statement, index) {
+    const content = (statement.content ?? "").replace(/\s+/g, " ").trim();
+    const shown = content.length > SAMPLE_LENGTH ? `${content.slice(0, SAMPLE_LENGTH - 1)}…` : content;
+    const labels = statement.categories?.length
+        ? ` [${statement.categories.join(", ")}]`
+        : "";
+    return `${index + 1}. ${shown}${labels}`;
+}
+/**
+ * Ask the user directly through MCP elicitation. The dialog is a plain
+ * Accept / Decline: the spec defines "accept" as the user's explicit
+ * approval, so no extra checkbox is asked for (a checkbox defaulting to
+ * false made a plain Accept read as a decline in Claude Code). "decline"
+ * is a real no. A dismissed dialog, a client without the capability, or a
+ * transport error is "unavailable": the caller then returns the dry run so
+ * the question can be asked in chat.
+ */
+async function elicitApproval(extra, graphName, plan) {
+    if (!extra?.elicit || !extra.clientCapabilities?.elicitation) {
+        return { kind: "unavailable", detail: "client does not support elicitation" };
+    }
+    const matchedCount = plan.matchedCount ?? 0;
+    const sample = (plan.matched ?? []).slice(0, SAMPLE_IN_PROMPT).map(sampleLine);
+    const more = matchedCount - sample.length;
+    const lines = [
+        `Permanently delete ${matchedCount} statement(s) from "${graphName}" in ${brand.name}? This cannot be undone.`,
+        "",
+        ...sample,
+        ...(more > 0 ? [`… and ${more} more`] : []),
+    ];
+    try {
+        const result = await extra.elicit({
+            message: lines.join("\n"),
+            requestedSchema: { type: "object", properties: {} },
+        });
+        if (result.action === "accept")
+            return { kind: "accepted" };
+        if (result.action === "decline")
+            return { kind: "declined" };
+        return { kind: "unavailable", detail: "the user dismissed the dialog without answering" };
+    }
+    catch (error) {
+        return {
+            kind: "unavailable",
+            detail: `elicitation failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Tool
+// ---------------------------------------------------------------------------
+export const deleteStatementsTool = {
+    name: "delete_statements",
+    definition: {
+        title: `Delete Statements from a ${brand.name} Graph`,
+        description: `Delete statements from a graph in the user's own ${brand.name} account, selected by a filter the server resolves. IRREVERSIBLE once confirmed: deleted statements cannot be recovered. ` +
+            `Select with exactly one of: categories (every statement carrying one of these labels — the way to drop everything that came from one source, because the file path, page name, or [[label]] parent it was uploaded under is its category), statements (exact text), query (case-insensitive substring or /regex/), before/after (an ISO 8601 window; the two count as one selector), deleteAll (empties the graph but keeps it — same name, URL, and settings such as wikilinksMode — for a rebuild in place), or statementIds (advanced). ` +
+            `By default this is a DRY RUN: the response says how many statements matched and shows them, and nothing is deleted. Show that to the user; only if they agree, call again with the SAME filter and confirm: true. If the client supports elicitation the user is asked directly and the deletion happens in the same call. A filter that matches nothing returns deleted: 0 without asking. ` +
+            `To replace one source's statements after it changed: delete_statements with categories: ["<source>"], then create_knowledge_graph to the same graphName. To rebuild a whole graph in place: deleteAll, then create_knowledge_graph to the same graphName. ` +
+            `Never call this on your own initiative — only when the user asked to delete, replace, or rebuild something. The graph must already exist in the user's account (there is no userName parameter; other users' graphs cannot be targeted) and this tool never creates one.`,
+        inputSchema: DeleteStatementsSchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+    },
+    handler: async (params, extra) => {
+        try {
+            // 1. Exactly one selector — no network until this holds.
+            const resolved = buildSelector(params);
+            if (!resolved.ok)
+                return textResult({ error: resolved.error }, true);
+            const { selector, kind } = resolved;
+            const graphName = params.graphName.trim();
+            // 2. The graph must exist in this account. Never create.
+            const graph = await findGraphByName(graphName);
+            if (!graph) {
+                return textResult({
+                    error: `No graph named "${graphName}" in this ${brand.name} account. Nothing was deleted. Use list_graphs to check the exact name; this tool never creates graphs.`,
+                }, true);
+            }
+            // 3. Preview with the same filter that the write will use.
+            const preview = await requestDeletion(graphName, selector, true);
+            if (!preview.ok) {
+                return textResult({ error: `Dry run failed — nothing was deleted. ${preview.error}` }, true);
+            }
+            const plan = preview.data;
+            const matchedCount = plan.matchedCount ?? plan.matched?.length ?? 0;
+            const graphUrl = plan.graphUrl ?? graph.defaultRevisionUrl ?? undefined;
+            if (matchedCount === 0) {
+                return textResult({
+                    deleted: 0,
+                    matchedCount: 0,
+                    graphName,
+                    ...(graphUrl ? { graphUrl } : {}),
+                    filter: selector,
+                    message: "Nothing matched — no deletion performed.",
+                });
+            }
+            // 4. Consent: confirm: true from the caller, or an accepted form.
+            let approved = params.confirm === true;
+            let elicitationDetail;
+            if (!approved) {
+                const answer = await elicitApproval(extra, graphName, plan);
+                if (answer.kind === "accepted") {
+                    approved = true;
+                }
+                else if (answer.kind === "declined") {
+                    return textResult({
+                        deleted: 0,
+                        declined: true,
+                        matchedCount,
+                        graphName,
+                        message: "The user declined the deletion. Nothing was deleted. Do not retry.",
+                    });
+                }
+                else {
+                    elicitationDetail = answer.detail;
+                }
+            }
+            if (!approved) {
+                const matched = plan.matched ?? [];
+                return textResult({
+                    deleted: 0,
+                    dryRun: true,
+                    matchedCount,
+                    matchedShown: Math.min(matched.length, MATCHED_SHOWN),
+                    matched: matched.slice(0, MATCHED_SHOWN),
+                    ...(plan.matchedByCategory ? { matchedByCategory: plan.matchedByCategory } : {}),
+                    graphName,
+                    ...(graphUrl ? { graphUrl } : {}),
+                    selector: kind,
+                    filter: selector,
+                    ...(elicitationDetail ? { elicitation: elicitationDetail } : {}),
+                    nextStep: "Nothing was deleted. Show these to the user; if they agree, call delete_statements again with the SAME filter and confirm: true.",
+                });
+            }
+            // 5. Write with the identical filter.
+            const write = await requestDeletion(graphName, selector, false);
+            if (!write.ok) {
+                return textResult({ error: `Deletion failed. ${write.error}` }, true);
+            }
+            const result = write.data;
+            const deleted = result.removedCount ?? result.removedIds?.length ?? 0;
+            return textResult({
+                deleted,
+                removedIds: result.removedIds ?? [],
+                ...(result.ignoredIds?.length ? { ignoredIds: result.ignoredIds } : {}),
+                ...(typeof result.remaining === "number" ? { remaining: result.remaining } : {}),
+                graphName: result.graphName ?? graphName,
+                ...(result.graphUrl ?? graphUrl ? { graphUrl: result.graphUrl ?? graphUrl } : {}),
+                ...(deleted !== matchedCount
+                    ? {
+                        note: `The dry run matched ${matchedCount} statement(s) but ${deleted} were removed — the graph changed between preview and deletion.`,
+                    }
+                    : {}),
+            });
+        }
+        catch (error) {
+            return textResult({ error: error instanceof Error ? error.message : String(error) }, true);
+        }
+    },
+};
+//# sourceMappingURL=deleteStatements.js.map

package/dist/tools/deleteStatements.js.map

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

package/dist/tools/developConceptualBridges.d.ts

@@ -13,7 +13,7 @@ export declare const developConceptualBridgesTool: {
             timestamps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             graphName: z.ZodOptional<z.ZodString>;
             requestMode: z.ZodDefault<z.ZodEnum<["question", "transcend"]>>;
-            modelToUse: z.ZodDefault<z.ZodEnum<["claude-opus-4.6", "claude-sonnet-4.6", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-4.1-fast-non-reasoning", "grok-4.1-fast-reasoning", "gpt-4o", "gpt-4o-mini", "gpt-5.4", "gpt-5.4-mini"]>>;
+            modelToUse: z.ZodDefault<z.ZodEnum<["claude-opus-5", "claude-sonnet-5", "claude-fable-5", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-4.1-fast-non-reasoning", "grok-4.1-fast-reasoning", "gpt-4o", "gpt-4o-mini", "gpt-5.4", "gpt-5.4-mini", "gpt-5.6-terra", "gpt-5.6-sol"]>>;
         };
         annotations: {
             readOnlyHint: boolean;

package/dist/tools/developLatentTopics.d.ts

@@ -13,7 +13,7 @@ export declare const developLatentTopicsTool: {
             timestamps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             graphName: z.ZodOptional<z.ZodString>;
             requestMode: z.ZodDefault<z.ZodEnum<["question", "transcend"]>>;
-            modelToUse: z.ZodDefault<z.ZodEnum<["claude-opus-4.6", "claude-sonnet-4.6", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-4.1-fast-non-reasoning", "grok-4.1-fast-reasoning", "gpt-4o", "gpt-4o-mini", "gpt-5.4", "gpt-5.4-mini"]>>;
+            modelToUse: z.ZodDefault<z.ZodEnum<["claude-opus-5", "claude-sonnet-5", "claude-fable-5", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-4.1-fast-non-reasoning", "grok-4.1-fast-reasoning", "gpt-4o", "gpt-4o-mini", "gpt-5.4", "gpt-5.4-mini", "gpt-5.6-terra", "gpt-5.6-sol"]>>;
         };
         annotations: {
             readOnlyHint: boolean;

package/dist/tools/developTextTool.d.ts

@@ -15,7 +15,7 @@ export declare const developTextTool: {
             useSeveralGaps: z.ZodDefault<z.ZodBoolean>;
             gapDepth: z.ZodDefault<z.ZodNumber>;
             transcendDiscourse: z.ZodDefault<z.ZodBoolean>;
-            modelToUse: z.ZodDefault<z.ZodEnum<["claude-opus-4.6", "claude-sonnet-4.6", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-4.1-fast-non-reasoning", "grok-4.1-fast-reasoning", "gpt-4o", "gpt-4o-mini", "gpt-5.4", "gpt-5.4-mini"]>>;
+            modelToUse: z.ZodDefault<z.ZodEnum<["claude-opus-5", "claude-sonnet-5", "claude-fable-5", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-4.1-fast-non-reasoning", "grok-4.1-fast-reasoning", "gpt-4o", "gpt-4o-mini", "gpt-5.4", "gpt-5.4-mini", "gpt-5.6-terra", "gpt-5.6-sol"]>>;
         };
         annotations: {
             readOnlyHint: boolean;

package/dist/tools/enableProjectLearnings.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { EnableProjectLearningsSchema } from "../schemas/index.js";
+import type { ToolExtra } from "../types/index.js";
+export declare const enableProjectLearningsTool: {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            project: z.ZodString;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            idempotentHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+    };
+    handler: (params: z.infer<typeof EnableProjectLearningsSchema>, extra?: ToolExtra) => Promise<{
+        isError?: boolean | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=enableProjectLearnings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enableProjectLearnings.d.ts","sourceRoot":"","sources":["../../src/tools/enableProjectLearnings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAOnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAWnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;sBAkB7B,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,UAC5C,SAAS;;;;;;;CAiDlB,CAAC"}