@descryy/mcp 0.11.4 → 0.11.5

package/dist/tools/kit.d.ts

@@ -1,165 +0,0 @@
-/** What every tool is handed and returns. A tool produces a `ToolAnswer`, never content —
- *  `render.ts` alone turns it into a reply, attaching the staleness stamp, reliability cap and
- *  disclosures. A tool cannot ship a result with the caveats stripped off. */
-import type { ResolutionLevel, ResultState, ToolClass } from "@descryy/ir";
-import type { ReplyFit, ToolAnswer, ToolTier, TruncationDetail, WitnessedEvidence } from "../render.ts";
-import type { Session } from "../session.ts";
-/** Streaming narration, §22.2. A no-op when the client sent no progress token; tools call it
- *  unconditionally and leave "is anyone listening" to the caller. */
-export type Progress = (message: string, current?: number, total?: number) => void;
-export interface ToolContext {
-    readonly session: Session;
-    readonly progress: Progress;
-    readonly signal: AbortSignal;
-}
-export interface ToolDefinition {
-    readonly name: string;
-    readonly title: string;
-    readonly description: string;
-    /** DEC-278's three classes (`ai-tool-contract.md` §8). Not "does it write bytes" but "can this
-     *  change a later finding unannounced" — twelve of the registry's 34 tools are `action`, gated
-     *  by §4's handshake, capped at reliability B by DEC-223. No default: unset silently treats
-     *  writes as pure. */
-    readonly class: ToolClass;
-    /** MK-5 — does the output state a conclusion, or just a graph fact? Required, undefaulted, same
-     *  reasoning as `class`. See `ToolTier` in `../render.ts` for why the type lives there. */
-    readonly tier: ToolTier;
-    /** Contract §6 rule 8. Starts at `"1.0.0"`; a future bump invalidates golden investigations
-     *  that depended on the old behaviour (`ai-layer-plan.md` §9 layer 4). */
-    readonly version: string;
-    readonly inputSchema: Record<string, unknown>;
-    run(args: Record<string, unknown>, ctx: ToolContext): Promise<ToolAnswer<unknown>>;
-    /** Required iff `class === "action"` (enforced in `action-handshake.ts` and
-     *  `tool-classes.test.ts`, not by the type). Returns the "willDo" text, or `undefined` when this
-     *  call has nothing to confirm (e.g. `questions` with no `answer`). */
-    describeAction?(args: Record<string, unknown>, ctx: ToolContext): string | undefined | Promise<string | undefined>;
-    /**
-     * The form of this call's arguments that may be kept — B1.
-     *
-     * `server.ts` records every completed call's arguments on the `Session` so
-     * `verify_claim` can check a citation against what a tool actually
-     * returned. That record lives for the life of the connection, and
-     * `browser_start_session` is the first tool whose arguments can carry a
-     * credential. A tool that takes one implements this and hands back a copy
-     * with the values replaced; every other tool leaves it undefined and is
-     * recorded verbatim, exactly as before.
-     *
-     * The tool's job rather than a generic pass in the server, deliberately:
-     * only the tool knows which of its arguments is a secret, and a
-     * server-side "looks sensitive" heuristic is the pattern-guessing this
-     * repo's own redactor already refuses to be.
-     */
-    redactArgs?(args: Record<string, unknown>): Record<string, unknown>;
-}
-/** An argument the caller can fix — distinct from a thrown `Error` (a bug here). This becomes an
- *  `isError` result the agent can read and retry from; a bug becomes an unreadable JSON-RPC error. */
-export declare class ToolInputError extends Error {
-    constructor(message: string);
-}
-export declare function optionalString(args: Record<string, unknown>, key: string): string | undefined;
-export declare function requiredString(args: Record<string, unknown>, key: string): string;
-export declare function optionalStringArray(args: Record<string, unknown>, key: string): readonly string[] | undefined;
-export declare function optionalInteger(args: Record<string, unknown>, key: string, min: number): number | undefined;
-export declare function optionalEnum<T extends string>(args: Record<string, unknown>, key: string, allowed: readonly T[]): T | undefined;
-export declare function optionalBoolean(args: Record<string, unknown>, key: string): boolean | undefined;
-/** Wraps data that did not come from the query layer in the same envelope — e.g. `analyze`, which
- *  writes rather than reads and has no `QueryResult`, so its reply still carries the same stamp. */
-export declare function answer<T>(options: {
-    readonly headline: string;
-    readonly data: T;
-    readonly resolutionFloor: ResolutionLevel;
-    readonly commitSha: string | null;
-    readonly graphBuiltAt: number | null;
-    readonly irSchemaVersion: number;
-    readonly commitSpread: number;
-    readonly repoCount: number;
-    readonly notes: readonly string[];
-    readonly truncated?: boolean;
-    readonly truncatedDetail?: TruncationDetail;
-    readonly nameLevel: boolean;
-    /** One of the five result states (`ai-tool-contract.md` §1). Omitted means `"ok"`. */
-    readonly state?: ResultState;
-    /** §5.4 — see `render.ts`'s `ToolAnswer.refusalSummary` doc for which callers have one. */
-    readonly refusalSummary?: {
-        readonly count: number;
-        readonly exemplar: string;
-        readonly handle: string;
-    };
-    /** See `render.ts`'s `ToolAnswer.fitToBudget` — how this tool shrinks to the reply ceiling. */
-    readonly fitToBudget?: (budgetBytes: number) => ReplyFit<T>;
-    /** See `render.ts`'s `ToolAnswer.runtimeEvidence`. Set only by a tool that actually watched a
-     *  running app; omitted everywhere else, including every refusal. */
-    readonly runtimeEvidence?: WitnessedEvidence;
-}): ToolAnswer<T>;
-/** An IR node as it appears in a reply. Optional fields are omitted, not `null`, keeping a
- *  1,000-node reply affordable — callers test for presence. `language` passes through verbatim;
- *  nothing here reads or branches on it (rule 1 — no language name above the IR boundary). */
-export interface BriefNode {
-    readonly id: string;
-    readonly type: string;
-    readonly name: string;
-    readonly file?: string;
-    /** Start line only — a reply carries where to look, not how much to read. */
-    readonly line?: number;
-    readonly language?: string;
-    readonly resolution: number;
-}
-/** Returned when a symbol/path/id resolved to nothing or to more than one thing (shared by
- *  `impact` and `propagation` via `resolveOneNode`): empty `candidates` means no match, two or
- *  more means ambiguous — one is impossible, that case resolves. */
-export interface NodeCandidates {
-    readonly candidates: readonly BriefNode[];
-}
-/** Trim an IR node down to what an agent needs, so a 1,000-node reply stays readable. */
-export declare function briefNode(node: {
-    id: string;
-    type: string;
-    name: string;
-    file: string | null;
-    range: {
-        startLine: number;
-        endLine: number;
-    } | null;
-    language: string | null;
-    resolution: number;
-}): BriefNode;
-/**
- * Descry's own state inside this repository, which is not the developer's
- * uncommitted change.
- *
- * ## Two paths, not one, and the second is the one that bit
- *
- * The first version derived this from the configured graph path alone. That is
- * right for a single repository, where the graph sits in this repo's own
- * `.descry/` — and wrong the moment two repositories share one graph, which is
- * exactly what `link_workspace` produces:
- *
- * ```json
- * // sherpa-backend/.descry/config.json
- * "graph": "/home/…/sherpa-frontend/.descry/graph.db"
- * ```
- *
- * The derived exclusion then pointed into the *other* repository, and this
- * repository's own `.descry/config.json` was excluded by nothing. Measured on a
- * real workspace: it was reported as the developer's uncommitted work. Not an
- * edge case — every shared-graph workspace has it.
- *
- * `.descry/evidence.db` escaped only because that repository's `.gitignore`
- * happened to carry `*.db`. **The exclusion must not depend on the user having
- * gitignored anything**, which is what that near-miss shows: a tool's own state
- * is excluded because it is the tool's, not because someone tidied up.
- *
- * ## Why the graph path is still consulted
- *
- * It is configurable, so it can be moved out of `.descry/` and stay inside the
- * repository. A path outside the repository costs nothing to list — it is not
- * in this working tree — and is kept rather than special-cased, because the
- * test for "is this path inside this repo" is the kind that is subtly wrong on
- * symlinks and relative paths.
- *
- * Returned as directory prefixes matched at a segment boundary by the git
- * helpers, so `.descry` excludes `.descry/config.json` and leaves
- * `src/.descryfile.py` alone.
- */
-export declare function descryOwnState(graphPath: string): readonly string[];
-//# sourceMappingURL=kit.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../src/tools/kit.ts"],"names":[],"mappings":"AAAA;;8EAE8E;AAO9E,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACxG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;qEACqE;AACrE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEnF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;0BAGsB;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B;+FAC2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;8EAC0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACnF;;2EAEuE;IACvE,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnH;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrE;AAED;sGACsG;AACtG,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK7F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,MAAM,GACV,SAAS,MAAM,EAAE,GAAG,SAAS,CAO/B;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,CAAC,GAAG,SAAS,CAOf;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAK/F;AAED;oGACoG;AACpG,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzG,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5D;yEACqE;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,iBAAiB,CAAC;CAC9C,GAAG,UAAU,CAAC,CAAC,CAAC,CAwBhB;AAED;;8FAE8F;AAC9F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;oEAEoE;AACpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;CAC3C;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,SAAS,CAUZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAWnE"}

package/dist/tools/kit.js

@@ -1,153 +0,0 @@
-/** What every tool is handed and returns. A tool produces a `ToolAnswer`, never content —
- *  `render.ts` alone turns it into a reply, attaching the staleness stamp, reliability cap and
- *  disclosures. A tool cannot ship a result with the caveats stripped off. */
-import { dirname } from "node:path";
-import { CONFIG_RELATIVE_PATH } from "../session.js";
-/** An argument the caller can fix — distinct from a thrown `Error` (a bug here). This becomes an
- *  `isError` result the agent can read and retry from; a bug becomes an unreadable JSON-RPC error. */
-export class ToolInputError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "ToolInputError";
-    }
-}
-// Hand-written, not schema-validated: a validator would be a second source of truth for the
-// schemas already declared to the client.
-export function optionalString(args, key) {
-    const value = args[key];
-    if (value === undefined || value === null)
-        return undefined;
-    if (typeof value !== "string")
-        throw new ToolInputError(`"${key}" must be a string`);
-    return value;
-}
-export function requiredString(args, key) {
-    const value = optionalString(args, key);
-    if (value === undefined || value === "")
-        throw new ToolInputError(`"${key}" is required`);
-    return value;
-}
-export function optionalStringArray(args, key) {
-    const value = args[key];
-    if (value === undefined || value === null)
-        return undefined;
-    if (!Array.isArray(value) || value.some((v) => typeof v !== "string")) {
-        throw new ToolInputError(`"${key}" must be an array of strings`);
-    }
-    return value;
-}
-export function optionalInteger(args, key, min) {
-    const value = args[key];
-    if (value === undefined || value === null)
-        return undefined;
-    if (typeof value !== "number" || !Number.isInteger(value) || value < min) {
-        throw new ToolInputError(`"${key}" must be an integer of at least ${min}`);
-    }
-    return value;
-}
-export function optionalEnum(args, key, allowed) {
-    const value = optionalString(args, key);
-    if (value === undefined)
-        return undefined;
-    if (!allowed.includes(value)) {
-        throw new ToolInputError(`"${key}" must be one of: ${allowed.join(", ")}`);
-    }
-    return value;
-}
-export function optionalBoolean(args, key) {
-    const value = args[key];
-    if (value === undefined || value === null)
-        return undefined;
-    if (typeof value !== "boolean")
-        throw new ToolInputError(`"${key}" must be a boolean`);
-    return value;
-}
-/** Wraps data that did not come from the query layer in the same envelope — e.g. `analyze`, which
- *  writes rather than reads and has no `QueryResult`, so its reply still carries the same stamp. */
-export function answer(options) {
-    const result = {
-        data: options.data,
-        stamp: {
-            commitSha: options.commitSha,
-            graphBuiltAt: options.graphBuiltAt,
-            irSchemaVersion: options.irSchemaVersion,
-            commitSpread: options.commitSpread,
-            repoCount: options.repoCount,
-            resolutionFloor: options.resolutionFloor,
-        },
-        truncated: options.truncated ?? false,
-        notes: options.notes,
-    };
-    return {
-        result,
-        nameLevel: options.nameLevel,
-        headline: options.headline,
-        ...(options.state === undefined ? {} : { state: options.state }),
-        ...(options.truncatedDetail === undefined ? {} : { truncatedDetail: options.truncatedDetail }),
-        ...(options.refusalSummary === undefined ? {} : { refusalSummary: options.refusalSummary }),
-        ...(options.fitToBudget === undefined ? {} : { fitToBudget: options.fitToBudget }),
-        ...(options.runtimeEvidence === undefined ? {} : { runtimeEvidence: options.runtimeEvidence }),
-    };
-}
-/** Trim an IR node down to what an agent needs, so a 1,000-node reply stays readable. */
-export function briefNode(node) {
-    return {
-        id: node.id,
-        type: node.type,
-        name: node.name,
-        ...(node.file === null ? {} : { file: node.file }),
-        ...(node.range === null ? {} : { line: node.range.startLine }),
-        ...(node.language === null ? {} : { language: node.language }),
-        resolution: node.resolution,
-    };
-}
-/**
- * Descry's own state inside this repository, which is not the developer's
- * uncommitted change.
- *
- * ## Two paths, not one, and the second is the one that bit
- *
- * The first version derived this from the configured graph path alone. That is
- * right for a single repository, where the graph sits in this repo's own
- * `.descry/` — and wrong the moment two repositories share one graph, which is
- * exactly what `link_workspace` produces:
- *
- * ```json
- * // sherpa-backend/.descry/config.json
- * "graph": "/home/…/sherpa-frontend/.descry/graph.db"
- * ```
- *
- * The derived exclusion then pointed into the *other* repository, and this
- * repository's own `.descry/config.json` was excluded by nothing. Measured on a
- * real workspace: it was reported as the developer's uncommitted work. Not an
- * edge case — every shared-graph workspace has it.
- *
- * `.descry/evidence.db` escaped only because that repository's `.gitignore`
- * happened to carry `*.db`. **The exclusion must not depend on the user having
- * gitignored anything**, which is what that near-miss shows: a tool's own state
- * is excluded because it is the tool's, not because someone tidied up.
- *
- * ## Why the graph path is still consulted
- *
- * It is configurable, so it can be moved out of `.descry/` and stay inside the
- * repository. A path outside the repository costs nothing to list — it is not
- * in this working tree — and is kept rather than special-cased, because the
- * test for "is this path inside this repo" is the kind that is subtly wrong on
- * symlinks and relative paths.
- *
- * Returned as directory prefixes matched at a segment boundary by the git
- * helpers, so `.descry` excludes `.descry/config.json` and leaves
- * `src/.descryfile.py` alone.
- */
-export function descryOwnState(graphPath) {
-    // This repository's own state directory, always — whatever the graph does.
-    const out = new Set([dirname(CONFIG_RELATIVE_PATH)]);
-    if (graphPath !== ":memory:" && graphPath !== "") {
-        const normalised = graphPath.replace(/\\/g, "/").replace(/^\.\//, "");
-        const slash = normalised.lastIndexOf("/");
-        // The directory, not the file: SQLite writes `-wal` and `-shm` beside it.
-        out.add(slash === -1 ? normalised : normalised.slice(0, slash));
-    }
-    return [...out];
-}
-//# sourceMappingURL=kit.js.map

package/dist/tools/kit.js.map

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

package/dist/tools/link-workspace.d.ts

@@ -1,24 +0,0 @@
-/** `link_workspace` — the agent-mediated door onto what `descry init` writes from the CLI
- *  (shared `writeConfig`). Closes `analyze`'s "no workspace configured" disclosure (DEC-054),
- *  previously a dead end. Never infers pairing — `repos` must come from the user's explicit
- *  confirmation, not the caller's guess (workspace.ts's rule: never infer, always declare).
- *  The only tool writing outside its session root; a path that fails to exist is disclosed, never silently skipped. */
-import { type ToolDefinition } from "./kit.ts";
-/** A repository the workspace id was actually written into. */
-export interface LinkedRepo {
-    /** Resolved to absolute. */
-    readonly path: string;
-    readonly repo: string;
-    /** The `.descry/config.json` that was written. */
-    readonly configPath: string;
-}
-export interface LinkWorkspaceData {
-    readonly workspace: string;
-    /** Only the repositories actually written. A path that didn't exist is absent from this
-     *  list and disclosed — a partial link that looks complete is the failure this exists to catch. */
-    readonly written: readonly LinkedRepo[];
-    /** How many were asked for. Compare against `written.length`. */
-    readonly requested: number;
-}
-export declare const linkWorkspaceTool: ToolDefinition;
-//# sourceMappingURL=link-workspace.d.ts.map

package/dist/tools/link-workspace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"link-workspace.d.ts","sourceRoot":"","sources":["../../src/tools/link-workspace.ts"],"names":[],"mappings":"AAAA;;;;uHAIuH;AAMvH,OAAO,EAA4D,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAGzG,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;uGACmG;IACnG,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAsID,eAAO,MAAM,iBAAiB,EAAE,cAe/B,CAAC"}

package/dist/tools/link-workspace.js

@@ -1,131 +0,0 @@
-/** `link_workspace` — the agent-mediated door onto what `descry init` writes from the CLI
- *  (shared `writeConfig`). Closes `analyze`'s "no workspace configured" disclosure (DEC-054),
- *  previously a dead end. Never infers pairing — `repos` must come from the user's explicit
- *  confirmation, not the caller's guess (workspace.ts's rule: never infer, always declare).
- *  The only tool writing outside its session root; a path that fails to exist is disclosed, never silently skipped. */
-import { existsSync, statSync } from "node:fs";
-import { resolve } from "node:path";
-import { writeConfig, writeWorkspaceRepos } from "../session.js";
-import { answer, requiredString, ToolInputError } from "./kit.js";
-const SCHEMA = {
-    type: "object",
-    properties: {
-        workspace: {
-            type: "string",
-            description: "The workspace id to write into every repository listed in `repos`, byte-identical. " +
-                "Choose a short, stable name — it becomes part of every workspace-scoped node id.",
-        },
-        repos: {
-            type: "array",
-            minItems: 2,
-            items: {
-                type: "object",
-                properties: {
-                    path: { type: "string", description: "Absolute path to the repository on disk." },
-                    repo: {
-                        type: "string",
-                        description: "This repository's identity, written explicitly rather than defaulted.",
-                    },
-                },
-                required: ["path", "repo"],
-                additionalProperties: false,
-            },
-            description: "Every repository that should share this workspace, INCLUDING the current one if it should " +
-                "join. Only call this with repositories the user has explicitly confirmed belong together " +
-                "— a directory sitting next to another is a suggestion to put in front of the user, never " +
-                "a decision this tool or the caller makes on its own (workspace.ts's pairing rule, one " +
-                "level up: never infer, always declare).",
-        },
-    },
-    required: ["workspace", "repos"],
-    additionalProperties: false,
-};
-function parseRepos(value) {
-    if (!Array.isArray(value) || value.length < 2) {
-        throw new ToolInputError('"repos" must be an array of at least two {path, repo} entries — a workspace of one ' +
-            "repository joins nothing, so linking one is never the right call.");
-    }
-    return value.map((entry, index) => {
-        if (typeof entry !== "object" || entry === null) {
-            throw new ToolInputError(`repos[${index}] must be an object`);
-        }
-        const path = requiredString(entry, "path");
-        const repo = requiredString(entry, "repo");
-        return { path, repo };
-    });
-}
-async function run(args, ctx) {
-    const workspace = requiredString(args, "workspace");
-    const repos = parseRepos(args["repos"]);
-    const seen = new Set();
-    for (const entry of repos) {
-        const absolute = resolve(entry.path);
-        if (seen.has(absolute)) {
-            throw new ToolInputError(`"${entry.path}" is listed more than once`);
-        }
-        seen.add(absolute);
-    }
-    const written = [];
-    const notes = [];
-    for (const entry of repos) {
-        const absolute = resolve(entry.path);
-        if (!existsSync(absolute) || !statSync(absolute).isDirectory()) {
-            notes.push(`"${entry.path}" does not exist or is not a directory — nothing was written there.`);
-            continue;
-        }
-        ctx.progress(`Writing .descry/config.json in ${entry.repo}`, written.length, repos.length);
-        const result = await writeConfig(absolute, { repo: entry.repo, workspace });
-        written.push({ path: absolute, repo: entry.repo, configPath: result.path });
-        if (result.previousWorkspace !== undefined && result.previousWorkspace !== workspace) {
-            notes.push(`${entry.repo}: replaced previous workspace "${result.previousWorkspace}" with "${workspace}".`);
-        }
-    }
-    // Membership list, written after the loop so it names repos the link actually reached, not
-    // what it was asked about. A workspace name alone doesn't say where siblings live on disk
-    // (DEC-NEXT-workspace-scoped-confirmed-facts). Still the caller's own list — nothing inferred.
-    const members = written.map((w) => ({ path: w.path, repo: w.repo }));
-    for (const member of members) {
-        await writeWorkspaceRepos(member.path, members);
-    }
-    if (written.length < repos.length) {
-        notes.push(`${repos.length - written.length} of ${repos.length} repositories were skipped. The workspace ` +
-            "id is only byte-identical where it was actually written — re-run for the skipped paths " +
-            "once they are correct.");
-    }
-    notes.push(`Run "analyze" again in each linked repository so its graph is rebuilt under the "${workspace}" ` +
-        "workspace — writing the config here does not itself rebuild anything.");
-    return answer({
-        headline: written.length === 0
-            ? `No repository was linked — every path in "repos" failed to resolve.`
-            : `Linked ${written.length} of ${repos.length} repositor${repos.length === 1 ? "y" : "ies"} ` +
-                `to workspace "${workspace}".`,
-        state: written.length === 0 ? "refused" : "ok",
-        nameLevel: true,
-        // Writing a config file is not evidence about code — R0, the same choice `analyze`
-        // makes when no code-reading source ran.
-        resolutionFloor: 0,
-        commitSha: null,
-        graphBuiltAt: null,
-        irSchemaVersion: ctx.session.provider().baseStamp().irSchemaVersion,
-        commitSpread: ctx.session.provider().baseStamp().commitSpread,
-        repoCount: ctx.session.provider().baseStamp().repoCount,
-        notes,
-        data: { workspace, written, requested: repos.length },
-    });
-}
-export const linkWorkspaceTool = {
-    name: "link_workspace",
-    class: "stateful-read",
-    tier: "evidence",
-    version: "1.0.0",
-    title: "Declare which repositories share a workspace",
-    description: "Write the workspace id that lets multiple repositories' graphs join (DEC-054) into each " +
-        "repository's .descry/config.json. Call this ONLY after the user has explicitly confirmed " +
-        "which repositories belong together — you may point out sibling directories you can see as a " +
-        "suggestion, but you must never decide on your own that they are related and call this " +
-        "unprompted. The same file `descry init` writes from the command line; this is the " +
-        "conversational door onto it.",
-    inputSchema: SCHEMA,
-    run,
-};
-//# sourceMappingURL=link-workspace.js.map

package/dist/tools/link-workspace.js.map

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

package/dist/tools/lookup.d.ts

@@ -1,19 +0,0 @@
-/** Turns what a developer typed into exactly one node, or refuses to. With no signal to pick
- *  between two nodes plausibly named `charge`, picking would be inventing evidence — so ambiguity
- *  returns with candidates and how to narrow, the same discipline the graph builder applies to an
- *  unresolvable edge (never stub a node) and adapters apply to an unreadable receiver. */
-import type { IRNode } from "@descryy/ir";
-import type { Session } from "../session.ts";
-export interface Lookup {
-    /** Null when nothing matched, or when more than one thing did. */
-    readonly node: IRNode | null;
-    readonly candidates: readonly IRNode[];
-    readonly headline: string;
-    readonly notes: readonly string[];
-}
-export declare function resolveOneNode(session: Session, criteria: {
-    readonly nodeId?: string | undefined;
-    readonly symbol?: string | undefined;
-    readonly file?: string | undefined;
-}): Lookup;
-//# sourceMappingURL=lookup.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/tools/lookup.ts"],"names":[],"mappings":"AAAA;;;0FAG0F;AAG1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,MAAM;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE;IACR,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GACA,MAAM,CA+DR"}

package/dist/tools/lookup.js

@@ -1,63 +0,0 @@
-/** Turns what a developer typed into exactly one node, or refuses to. With no signal to pick
- *  between two nodes plausibly named `charge`, picking would be inventing evidence — so ambiguity
- *  returns with candidates and how to narrow, the same discipline the graph builder applies to an
- *  unresolvable edge (never stub a node) and adapters apply to an unreadable receiver. */
-import { findNodes, getNode } from "@descryy/core";
-export function resolveOneNode(session, criteria) {
-    const driver = session.store().driver;
-    if (criteria.nodeId !== undefined) {
-        const node = getNode(driver, criteria.nodeId);
-        return node === undefined
-            ? {
-                node: null,
-                candidates: [],
-                headline: `No node with id ${criteria.nodeId} is in the graph.`,
-                notes: [
-                    "The id may be from an older graph. Node ids are hashes over the repository scope, " +
-                        "kind and qualified symbol path, so they survive file moves but not a change to the " +
-                        "configured repository name. Run analyze and use an id from its output.",
-                ],
-            }
-            : { node, candidates: [node], headline: node.name, notes: [] };
-    }
-    const matches = findNodes(driver, {
-        ...(criteria.symbol === undefined ? {} : { name: criteria.symbol }),
-        ...(criteria.file === undefined ? {} : { file: criteria.file }),
-    });
-    const named = criteria.symbol ?? criteria.file ?? "";
-    if (matches.length === 0) {
-        return {
-            node: null,
-            candidates: [],
-            headline: `Nothing named "${named}" is in the graph.`,
-            notes: [
-                "This does not mean it does not exist. It means no configured adapter read it, or the " +
-                    "graph predates it. Run analyze, and check its disclosures for languages that were not " +
-                    "analysable.",
-            ],
-        };
-    }
-    if (matches.length === 1) {
-        return { node: matches[0], candidates: matches, headline: matches[0].name, notes: [] };
-    }
-    // More than one. Only a file narrows it, and only if the caller did not already
-    // give one — in which case the file genuinely declares two things of that name.
-    const where = matches
-        .slice(0, 8)
-        .map((m) => `${m.type} ${m.name}${m.file === null ? "" : ` (${m.file})`}`)
-        .join(", ");
-    return {
-        node: null,
-        candidates: matches,
-        headline: `"${named}" is ambiguous — ${matches.length} nodes match.`,
-        notes: [
-            `Candidates: ${where}${matches.length > 8 ? ", …" : ""}. ` +
-                (criteria.file === undefined
-                    ? 'Narrow it with "file", or pass "nodeId" directly.'
-                    : "They are in the same file, so pass \"nodeId\" directly."),
-            "No answer was computed. Choosing one of these by a heuristic would produce a confident " +
-                "answer about a symbol you did not ask about.",
-        ],
-    };
-}
-//# sourceMappingURL=lookup.js.map

package/dist/tools/lookup.js.map

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

package/dist/tools/mark-incident.d.ts

@@ -1,28 +0,0 @@
-/** `mark_incident` — "that was a bug, I fixed it": the only incident-minting path with
- *  precision 1.0 (a person asserts it). Needed because automatic detection (reverts,
- *  `Fixes #123`) found zero incidents in 3 repos, and a fix-forward heuristic scored 25%
- *  against a 90% threshold and was refused. Stored in `.descry/config.json` (DEC-223,
- *  DEC-017 — derived tables don't survive rebuilds) and capped at class B; `action` class per DEC-278, gated by the `confirmToken` handshake. */
-import type { ConfirmedIncident } from "@descryy/ir";
-import { type ToolDefinition } from "./kit.ts";
-export interface MarkIncidentData {
-    /** The record as written. Read it back to see exactly what was stored. */
-    readonly recorded: ConfirmedIncident;
-    /** The `INCIDENT` node id, so a caller can query it immediately. */
-    readonly incidentNodeId: string;
-    /** Where the durable record lives — a file a person can read and correct. */
-    readonly configPath: string;
-    /** How many confirmed incidents this repository now has on record. */
-    readonly totalConfirmed: number;
-    /** Paths named that the graph has no node for. Still recorded and correlated — a
-     *  developer naming a file Descry can't read is a gap in Descry, not a mistake. */
-    readonly filesNotInGraph: readonly string[];
-    /** True when this call's content (same summary and error text) matched a record
-     *  already on file — merged into it rather than minting a second `INCIDENT` node
-     *  (UAT phase 5, F9). */
-    readonly merged: boolean;
-    /** How many times this exact content has now been reported, this call included. */
-    readonly occurrences: number;
-}
-export declare const markIncidentTool: ToolDefinition;
-//# sourceMappingURL=mark-incident.d.ts.map

package/dist/tools/mark-incident.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mark-incident.d.ts","sourceRoot":"","sources":["../../src/tools/mark-incident.ts"],"names":[],"mappings":"AAAA;;;;iJAIiJ;AAUjJ,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;uFACmF;IACnF,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C;;6BAEyB;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAkMD,eAAO,MAAM,gBAAgB,EAAE,cAkB9B,CAAC"}