@descryy/mcp 0.11.3 → 0.11.5

package/dist/scenarios/storage.js

@@ -1,103 +0,0 @@
-/**
- * Scenario storage — `DEC-383` §1. Lives in committed `descry/scenarios/`,
- * never `.descry/` (gitignored, regenerable): §7 needs agent-free runs on
- * a fresh CI checkout, where `.descry/` would vanish and fail silently. One file per scenario avoids merge conflicts.
- */
-import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
-import { join, resolve, sep } from "node:path";
-import { parseScenario, serializeScenario } from "./parse.js";
-const SCENARIO_SUFFIX = ".scenario.json";
-export function scenariosDirectory(repoPath) {
-    return join(repoPath, "descry", "scenarios");
-}
-/** Not the disk-safe path — `readScenario`/`writeScenario` go through `confinedScenarioPath` below. This one is for display messages naming even a refused name. */
-export function scenarioPath(repoPath, name) {
-    return join(scenariosDirectory(repoPath), `${name}${SCENARIO_SUFFIX}`);
-}
-/** Thrown when the scenarios directory exists but can't be read (permission error, not-a-directory, ...) — a fact about Descry's ability to look, never about count. Must not collapse to `[]` (C-F2): that would teach a false "nothing saved". */
-export class ScenarioListError extends Error {
-    constructor(dir, cause) {
-        const detail = cause instanceof Error ? cause.message : String(cause);
-        super(`could not read ${dir} (${detail})`);
-        this.name = "ScenarioListError";
-        this.cause = cause;
-    }
-}
-/** A-F4: name comes straight from tool args; `join` silently normalises `..`, so an unchecked `"../../../etc/passwd"` (or absolute path) escapes `descry/scenarios/`. Reject the shape here, then `confinedScenarioPath` re-checks containment on the resolved path — belt-and-braces, mirroring descry-desktop's write-finding-export. */
-function invalidScenarioNameReason(name) {
-    if (name === "")
-        return "a scenario name cannot be empty";
-    if (name.includes("/") || name.includes("\\")) {
-        return `"${name}" is not a valid scenario name — a name may not contain a path separator`;
-    }
-    if (name === "." || name === "..") {
-        return `"${name}" is not a valid scenario name`;
-    }
-    return null;
-}
-function confinedScenarioPath(repoPath, name) {
-    const invalid = invalidScenarioNameReason(name);
-    if (invalid !== null)
-        throw new Error(invalid);
-    const dir = scenariosDirectory(repoPath);
-    const path = join(dir, `${name}${SCENARIO_SUFFIX}`);
-    const resolvedDir = resolve(dir) + sep;
-    // Belt and braces: if this ever resolves outside the scenarios directory, refuse rather than touch it.
-    if (!resolve(path).startsWith(resolvedDir)) {
-        throw new Error(`refusing to use a scenario path outside ${dir}`);
-    }
-    return path;
-}
-/** Every saved scenario's name. ENOENT means "nothing has ever been saved" → `[]`; any other read error (permission, not-a-directory) throws `ScenarioListError` instead — the five-reply-states distinction, one layer down. */
-export async function listScenarios(repoPath) {
-    const dir = scenariosDirectory(repoPath);
-    let entries;
-    try {
-        entries = await readdir(dir);
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return [];
-        throw new ScenarioListError(dir, error);
-    }
-    return entries.filter((e) => e.endsWith(SCENARIO_SUFFIX)).map((e) => e.slice(0, -SCENARIO_SUFFIX.length));
-}
-/** Reads one scenario; never throws — missing file, unreadable text, malformed document are all refusals carrying the path, so a CI replay can report which file was wrong rather than die on the first. */
-export async function readScenario(repoPath, name) {
-    let path;
-    try {
-        path = confinedScenarioPath(repoPath, name);
-    }
-    catch (error) {
-        return { valid: false, problems: [error.message] };
-    }
-    let text;
-    try {
-        text = await readFile(path, "utf8");
-    }
-    catch {
-        return { valid: false, problems: [`no scenario named "${name}" — nothing at ${path}`] };
-    }
-    let decoded;
-    try {
-        decoded = JSON.parse(text);
-    }
-    catch (error) {
-        return { valid: false, problems: [`${path} is not readable as stored data: ${String(error)}`] };
-    }
-    const result = parseScenario(decoded);
-    if (result.valid)
-        return result;
-    return { valid: false, problems: result.problems.map((p) => `${path}: ${p}`) };
-}
-/** Writes one scenario, refusing anything this reader couldn't read back. Validating on the way out isn't redundant — a fault saved today surfaces during a push check, long after the session that could explain it is gone. */
-export async function writeScenario(repoPath, scenario) {
-    const check = parseScenario(scenario);
-    if (!check.valid) {
-        throw new Error(`refusing to save scenario "${scenario.name}": ${check.problems.join("; ")}`);
-    }
-    const path = confinedScenarioPath(repoPath, scenario.name);
-    await mkdir(scenariosDirectory(repoPath), { recursive: true });
-    await writeFile(path, serializeScenario(scenario), "utf8");
-}
-//# sourceMappingURL=storage.js.map

package/dist/scenarios/storage.js.map

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

package/dist/server.d.ts

@@ -1,61 +0,0 @@
-/**
- * The MCP server: handshake, tool listing, tool calls, streaming narration.
- *
- * ## The layering that makes this testable without a pipe
- *
- * `dispatch` takes a line of text and a `send`, and that is the whole surface.
- * The stdio transport is a loop around it; a test is a call to it. So the
- * handshake, the error frames and the progress notifications are all covered by
- * ordinary unit tests rather than by spawning a process and hoping.
- *
- * ## Streaming narration — §22.2's primary UX, at the protocol level
- *
- * A developer asking a question in their editor and watching the work happen is
- * the most-used delivery path in the architecture. MCP's mechanism is
- * `notifications/progress`, sent only when the request carried a
- * `_meta.progressToken`. Tools call `ctx.progress(...)` unconditionally and this
- * layer decides whether anyone is listening — the alternative, tools checking
- * first, is how narration ends up in some code paths and not others.
- *
- * ## Every tool failure is a *tool* result, not a protocol error
- *
- * The spec is explicit and the reason is practical: a JSON-RPC error is for a
- * malformed request, and an agent that receives one has nothing to reason about.
- * A bad argument, a missing graph, an unreadable repository — those come back as
- * content with `isError`, which the model can read and act on. Only genuinely
- * broken protocol produces an error frame.
- */
-import type { Session } from "./session.ts";
-import { type ToolDefinition } from "./tools/index.ts";
-import type { Transport } from "./transport.ts";
-export interface McpServerOptions {
-    readonly session: Session;
-    readonly name?: string;
-    readonly version?: string;
-    /**
-     * Overrides the registry. Exists for tests of *this* layer: the cancellation
-     * path needs a call that is still running when the notification arrives, and
-     * of the thirty-three registered tools exactly one reads `ctx.signal` at all, so
-     * driving the mechanism through the real registry would test that one tool's
-     * plumbing rather than the server's dispatch.
-     */
-    readonly tools?: readonly ToolDefinition[];
-}
-/**
- * Does this frame have to jump the transport's ordering queue?
- *
- * True for `notifications/cancelled` and nothing else. Exported because the
- * stdio runner needs the answer and the knowledge of what MCP methods mean
- * belongs here, not in a module that otherwise only knows about bytes. Never
- * throws — a line that will not parse is the dispatcher's to reject, with the
- * error frame it already knows how to build.
- */
-export declare function isOutOfBand(line: string): boolean;
-export interface McpServer {
-    /** Handle one newline-delimited frame. Never throws; every failure becomes a frame. */
-    dispatch(line: string, transport: Transport): Promise<void>;
-    /** True once the client has completed the handshake. */
-    readonly initialized: boolean;
-}
-export declare function createMcpServer(options: McpServerOptions): McpServer;
-//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAiCH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAkDhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYjD;AAED,MAAM,WAAW,SAAS;IACxB,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AA8ED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAmZpE"}