keywordgraph-mcp-server 1.7.4 → 1.8.5

package/dist/tools/analyzeTextSignature.js

@@ -0,0 +1,82 @@
+import { brand } from "../config/brand.js";
+import { AnalyzeTextSignatureSchemaBase, } from "../schemas/index.js";
+import { makeInfraNodusRequest } from "../api/client.js";
+import { resolveGraphInput } from "../utils/graphInput.js";
+import { buildTextSignature } from "../utils/textSignature.js";
+function errorContent(message) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify({ error: message }) },
+        ],
+        isError: true,
+    };
+}
+export const analyzeTextSignatureTool = {
+    name: "analyze_text_signature",
+    definition: {
+        title: "Text Signature: structure, rhythm, and AI-likeness of a text",
+        description: `Structural and rhythmic signature of a text, URL, or YouTube transcript: how the discourse moves through its ${brand.name} concept network (burstiness, fractal scaling, multifractality, topic crossings), how its topics are distributed (modularity, diversity, entropy), and the sentence-length rhythm of the source. Every number comes with a plain-language reading, the profile gets a name (essay, digest, anthology, notes...), and a final layer weighs the rhythm evidence into a hedged AI-likeness estimate. Use to compare writing styles, characterise an author or genre, and flag flat, uniformly paced text typical of generated content. Not a detector on its own.`,
+        inputSchema: AnalyzeTextSignatureSchemaBase.shape,
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+    },
+    handler: async (params) => {
+        try {
+            // The amplitude and sentence measures need the raw graph (node
+            // positions and communities) and the raw statements (their
+            // graphCoordinates, statementHashtags and content), so the compaction
+            // flags are off. No AI topics, no summary: the tool is numeric.
+            const queryParams = new URLSearchParams({
+                doNotSave: "true",
+                addStats: "true",
+                ...(params.multifractal ? { multifractal: "true" } : {}),
+                includeStatements: "true",
+                includeGraph: "true",
+                compactGraph: "false",
+                compactStatements: "false",
+                includeGraphSummary: "false",
+            });
+            if (params.maxNodes && params.maxNodes > 0) {
+                queryParams.set("maxnodes", String(params.maxNodes));
+            }
+            const endpoint = `/graphAndStatements?${queryParams.toString()}`;
+            const input = await resolveGraphInput(params);
+            if (!input.ok)
+                return errorContent(input.error);
+            const response = await makeInfraNodusRequest(endpoint, {
+                ...input.payload,
+                modifyAnalyzedText: params.modifyAnalyzedText ?? "none",
+            });
+            if (response.error)
+                return errorContent(response.error);
+            // The raw (non-compacted) graph carries more than the typed
+            // GraphResponse declares: node keys and positions, statement
+            // hashtags and coordinates.
+            const graph = response.graph?.graphologyGraph;
+            const attributes = graph?.attributes ?? {};
+            if (!attributes.fractal_variability && !attributes.diversity_stats) {
+                return errorContent("The API returned no network statistics for this text (too short, or a backend without fractal_variability).");
+            }
+            const output = buildTextSignature({
+                modularity: attributes.modularity,
+                diversity: attributes.diversity_stats,
+                fractal: attributes.fractal_variability,
+                degreeDistribution: attributes.degree_distribution ?? null,
+                nodes: graph?.nodes ?? [],
+                statements: response.statements ?? [],
+            });
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(output, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return errorContent(error instanceof Error ? error.message : String(error));
+        }
+    },
+};
+//# sourceMappingURL=analyzeTextSignature.js.map

package/dist/tools/analyzeTextSignature.js.map

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

package/dist/tools/createKnowledgeGraph.d.ts

@@ -11,6 +11,7 @@ export declare const createKnowledgeGraphTool: {
             url: z.ZodOptional<z.ZodString>;
             statements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             categories: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">>;
+            categoriesAsNodes: z.ZodDefault<z.ZodBoolean>;
             timestamps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             includeStatements: z.ZodDefault<z.ZodBoolean>;
             includeGraph: z.ZodDefault<z.ZodBoolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"createKnowledgeGraph.d.ts","sourceRoot":"","sources":["../../src/tools/createKnowledgeGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAcxD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;sBAaZ,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;;;;;;;CAiGzD,CAAC"}
+{"version":3,"file":"createKnowledgeGraph.d.ts","sourceRoot":"","sources":["../../src/tools/createKnowledgeGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAcxD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAaZ,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;;;;;;;CAiGzD,CAAC"}

package/dist/tools/deleteGraph.d.ts

@@ -0,0 +1,43 @@
+/**
+ * delete_graph — remove one graph from the caller's own account entirely:
+ * statements, revisions, settings, and URL. The companion of
+ * delete_statements (which keeps the graph) for the case where the graph
+ * itself should go.
+ *
+ * Same safety shape: the graph must exist in this account, a dry run is
+ * the default, and the write only happens with `confirm: true` or an
+ * elicitation form the user accepts. Ownership is enforced by the app
+ * (the graph is resolved from the API key's own contexts list; userName
+ * is refused) and again by the backend, which scopes the delete to the
+ * same user.
+ */
+import { z } from "zod";
+import { DeleteGraphSchema } from "../schemas/index.js";
+import type { ToolExtra } from "../types/index.js";
+type Params = z.infer<typeof DeleteGraphSchema>;
+export declare const deleteGraphTool: {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        inputSchema: {
+            graphName: z.ZodString;
+            confirm: z.ZodDefault<z.ZodBoolean>;
+        };
+        annotations: {
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            idempotentHint: boolean;
+            openWorldHint: boolean;
+        };
+    };
+    handler: (params: Params, extra?: ToolExtra) => Promise<{
+        isError?: boolean | undefined;
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export {};
+//# sourceMappingURL=deleteGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deleteGraph.d.ts","sourceRoot":"","sources":["../../src/tools/deleteGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAgFhD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;sBAiBH,MAAM,UAAU,SAAS;;;;;;;CAwEjD,CAAC"}

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"}