@descryy/mcp 0.11.3 → 0.11.5

package/dist/tools/refusal-fetch.js

@@ -1,103 +0,0 @@
-/**
- * `refusal_fetch` — §4 technique 4: summarise, never enumerate (count, exemplar,
- * handle). No `handle` → fresh summary; `handle` → redeem a page (mirrors
- * `questions.ts`). Always reads `{classified: false}` — the default `true` would
- * silently drop unclassified rows (DEC-243). No `limit`: the population must stay stable. */
-import { fetchRefusalPage, summariseRefusals } from "@descryy/core";
-import { answer, optionalInteger, optionalString, } from "./kit.js";
-const SCHEMA = {
-    type: "object",
-    properties: {
-        handle: {
-            type: "string",
-            description: "Redeem a handle from a prior refusal_fetch call to fetch the next page of rows. Omit for " +
-                "a fresh summary — count, one exemplar reason, and a handle to start paging.",
-        },
-        pageSize: {
-            type: "integer",
-            minimum: 1,
-            description: "Rows per page when minting a fresh handle (a summary call). Default 50. Ignored on a paged call — the page size travels inside the handle itself.",
-        },
-    },
-    additionalProperties: false,
-};
-function brief(ref) {
-    return {
-        fromNodeId: ref.fromNodeId,
-        edgeType: ref.edgeType,
-        rawTarget: ref.rawTarget,
-        file: ref.file,
-        line: ref.line,
-        producedBy: ref.producedBy,
-        reason: ref.reason,
-    };
-}
-async function run(args, ctx) {
-    const handle = optionalString(args, "handle");
-    const pageSize = optionalInteger(args, "pageSize", 1);
-    const base = ctx.session.provider().baseStamp();
-    ctx.progress("Reading the unresolved-reference ledger");
-    const { refs } = ctx.session.provider().unresolvedRefs({ classified: false });
-    const envelopeBase = {
-        resolutionFloor: 0, // a ledger read, not a graph traversal claim — same convention as similar_incidents' R0 floor
-        commitSha: base.commitSha,
-        graphBuiltAt: base.graphBuiltAt,
-        irSchemaVersion: base.irSchemaVersion,
-        commitSpread: base.commitSpread,
-        repoCount: base.repoCount,
-        nameLevel: true,
-    };
-    if (handle === undefined) {
-        ctx.progress(`Summarising ${refs.length} unresolved reference(s)`);
-        const summary = summariseRefusals(refs, pageSize);
-        return answer({
-            ...envelopeBase,
-            state: summary.count === 0 ? "empty" : "ok",
-            headline: summary.count === 0
-                ? "No unresolved references are recorded — nothing for refusal_fetch to page through."
-                : `${summary.count} unresolved reference(s) recorded. Exemplar: "${summary.exemplar}". Call again with { "handle": "${summary.handle}" } to page through the rest.`,
-            notes: summary.count === 0
-                ? ["The graph has no unresolved-reference rows at all — every edge either resolved or was never attempted."]
-                : [],
-            data: { kind: "summary", count: summary.count, exemplar: summary.exemplar, handle: summary.handle },
-        });
-    }
-    ctx.progress("Redeeming the refusal_fetch handle");
-    const page = fetchRefusalPage(refs, handle);
-    if (page.state === "refused") {
-        return answer({
-            ...envelopeBase,
-            state: "refused",
-            headline: "This refusal_fetch handle could not be redeemed.",
-            notes: [page.reason],
-            data: { kind: "page", items: [], total: 0, nextHandle: null },
-        });
-    }
-    return answer({
-        ...envelopeBase,
-        headline: `Page of ${page.items.length} unresolved reference(s), of ${page.total} total.`,
-        notes: [],
-        data: {
-            kind: "page",
-            items: page.items.map(brief),
-            total: page.total,
-            nextHandle: page.nextHandle,
-        },
-    });
-}
-export const refusalFetchTool = {
-    name: "refusal_fetch",
-    class: "read",
-    tier: "evidence",
-    version: "1.0.0",
-    title: "Page through the graph's recorded refusals",
-    description: "The graph's full ledger of unresolved references — edges an adapter could not resolve, with " +
-        "the reason recorded rather than guessed. Call with no arguments for a one-line summary (count, " +
-        "one exemplar reason, a handle); call again with that handle to page through every row. Never " +
-        "enumerates in full on the first call — §4 technique 4: summarise, don't enumerate. A handle " +
-        "issued against a population that has since changed (a re-analyse ran) refuses rather than " +
-        "silently returning a wrong page.",
-    inputSchema: SCHEMA,
-    run,
-};
-//# sourceMappingURL=refusal-fetch.js.map

package/dist/tools/refusal-fetch.js.map

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

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

@@ -1,33 +0,0 @@
-/**
- * Mints an `INCIDENT` from `observe_runtime`'s process exit/signal, never
- * from `EXCEPTION` events (a caught, provoked error isn't a failure).
- * Correlates to files an exception named — "implicated", not "caused". See `DEC-NEXT-incident-minting-beyond-explicit-reverts`.
- */
-import type { ConfirmedIncident } from "@descryy/ir";
-/** One observed service, in the shape `observe_runtime` already reports. */
-export interface ObservedProcessOutcome {
-    readonly service: string;
-    readonly started: boolean;
-    readonly exitCode: number | null;
-    readonly signal: string | null;
-}
-/** An exception's own source location, as the runtime adapter parsed it. */
-export interface ObservedExceptionLocation {
-    readonly file: string | null;
-}
-export interface RuntimeIncidentInput {
-    readonly repo: string;
-    readonly repoRoot: string;
-    readonly runId: string;
-    readonly services: readonly ObservedProcessOutcome[];
-    /** Every exception source location seen during the run, in observation order. */
-    readonly exceptionLocations: readonly ObservedExceptionLocation[];
-    /** The first line of each exception's text, for the message-similarity signal. */
-    readonly exceptionTexts: readonly string[];
-    readonly now?: () => Date;
-}
-/** Whether this service's exit is a failure rather than Descry stopping it. */
-export declare function died(outcome: ObservedProcessOutcome): boolean;
-/** The incident a run witnessed, or null when every service exited cleanly (the common case, not a finding). One record per run, not per dead service — two deaths are one system failure, not two. */
-export declare function runtimeObservedIncident(input: RuntimeIncidentInput): ConfirmedIncident | null;
-//# sourceMappingURL=runtime-incident.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-incident.d.ts","sourceRoot":"","sources":["../../src/tools/runtime-incident.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAYrD,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACrD,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAClE,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,+EAA+E;AAC/E,wBAAgB,IAAI,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAI7D;AAWD,uMAAuM;AACvM,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,IAAI,CAkC7F"}

package/dist/tools/runtime-incident.js

@@ -1,67 +0,0 @@
-/**
- * Mints an `INCIDENT` from `observe_runtime`'s process exit/signal, never
- * from `EXCEPTION` events (a caught, provoked error isn't a failure).
- * Correlates to files an exception named — "implicated", not "caused". See `DEC-NEXT-incident-minting-beyond-explicit-reverts`.
- */
-import { isAbsolute, relative } from "node:path";
-/** Signals a process takes when it dies on its own; SIGTERM/SIGINT excluded on purpose — Descry's own teardown sends SIGTERM, and counting it would mint an incident on every successful run. */
-const FATAL_SIGNALS = new Set([
-    "SIGSEGV",
-    "SIGABRT",
-    "SIGBUS",
-    "SIGFPE",
-    "SIGILL",
-    "SIGKILL",
-]);
-/** Whether this service's exit is a failure rather than Descry stopping it. */
-export function died(outcome) {
-    if (!outcome.started)
-        return false;
-    if (outcome.exitCode !== null && outcome.exitCode !== 0)
-        return true;
-    return outcome.signal !== null && FATAL_SIGNALS.has(outcome.signal);
-}
-/** Repo-relative path, only when truly inside the repo — a `node_modules`/runtime-internal frame names code the developer can't change, so correlating to it would misattribute the failure. */
-function insideRepo(repoRoot, file) {
-    if (!isAbsolute(file))
-        return file.includes("node_modules") ? null : file;
-    const rel = relative(repoRoot, file);
-    if (rel === "" || rel.startsWith("..") || isAbsolute(rel))
-        return null;
-    if (rel.split("/").includes("node_modules"))
-        return null;
-    return rel;
-}
-/** The incident a run witnessed, or null when every service exited cleanly (the common case, not a finding). One record per run, not per dead service — two deaths are one system failure, not two. */
-export function runtimeObservedIncident(input) {
-    const dead = input.services.filter(died);
-    if (dead.length === 0)
-        return null;
-    const files = [
-        ...new Set(input.exceptionLocations
-            .map((location) => (location.file === null ? null : insideRepo(input.repoRoot, location.file)))
-            .filter((path) => path !== null && path !== "")),
-    ].sort();
-    // No owned file means nothing to attach to, and an unfindable record is
-    // worse than none — the death is still reported in the tool's own counts.
-    if (files.length === 0)
-        return null;
-    const names = dead.map((d) => d.service).sort();
-    const how = dead
-        .map((d) => `${d.service} ${d.exitCode !== null ? `exited ${String(d.exitCode)}` : `took ${String(d.signal)}`}`)
-        .join(", ");
-    return {
-        repo: input.repo,
-        // States only what was witnessed: the crash happened, not what's wrong.
-        summary: `observed run: ${how}`,
-        files,
-        // Input to the message-similarity signal — matches a future failure with the same error text.
-        ...(input.exceptionTexts.length === 0
-            ? {}
-            : { errorText: [...new Set(input.exceptionTexts)].slice(0, 5).join(" | ").slice(0, 2_000) }),
-        confirmedBy: `observe_runtime (${names.join(", ")})`,
-        confirmedAt: (input.now?.() ?? new Date()).toISOString(),
-        observedInRun: input.runId,
-    };
-}
-//# sourceMappingURL=runtime-incident.js.map

package/dist/tools/runtime-incident.js.map

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

package/dist/tools/runtime-journey-drive.d.ts

@@ -1,102 +0,0 @@
-/**
- * RG-4 — both halves in the MCP layer, and RG-6's MCP half (video).
- *
- * `runInstrumentedExecution`'s `onReady` fires after every declared service's
- * readiness has succeeded and before the observation window's sleep — the one
- * moment in a run when the application is provably up and still alive. The
- * desktop already composes exactly this way (`descry-desktop/packages/session/
- * src/pipeline/browser-drive.ts`, invoked from `runtime-execution.ts`'s own
- * `onReady`), so that browser evidence lands in the **same `EvidenceStore`
- * under the same `executionId`** as the backend's. `observe_runtime` here
- * never did: it passed no `onReady` and never drove a browser, so an MCP
- * client got two calls with two lifetimes and nothing to prove they were the
- * same run.
- *
- * This module is the MCP equivalent of the desktop's `browser-drive.ts` —
- * same collectors, same package, same "never fabricate a step" discipline —
- * built as its own file because `packages/mcp/src/browser/driver.ts` and
- * `playwright-driver.ts` are lane identity's (a session-scoped, interactive
- * `BrowserDriver` port for the `browser_*` tools' own lifetime) and this is a
- * different lifetime entirely: one drive, bound to one execution's readiness
- * window, torn down before that execution's observation window even starts.
- * Composing through the identity lane's port would mean threading a whole
- * interactive session through a callback that must complete before
- * `onReady` returns — the wrong shape for what is, structurally, a single
- * batch replay. `@descryy/runtime-browser`'s own collectors compose directly
- * instead, the same way the desktop does it.
- *
- * ## The journey comes from the caller, projected by the ONE shared format
- *
- * `DEC-NEXT-runtime-journey-is-one-declared-format` (Q1) settled this: a
- * saved `Scenario` and a driveable step list are two views of one format,
- * and lane journey built the single projection both directions go through —
- * `../scenarios/browser-run-plan-projection.ts`'s `projectScenarioToRunPlan`.
- * This module calls that function and nothing else invents a second
- * translation of the same scenario. Its own header explains exactly what
- * projects and what refuses (seven shared verbs; `fill`, whole-page
- * assertions and anything outside those seven are refused by name, never
- * silently narrowed), and secret references are resolved inside it before
- * this module ever sees a step — see that module's own doc.
- *
- * A `Scenario` with no steps drives to `startUrl` and observes, same as an
- * empty step list does anywhere else in this codebase. No step is ever
- * synthesized here.
- *
- * `@descryy/runtime-browser`'s `BrowserActionCollector` happens to support
- * more than the shared projection's seven verbs (`assertVisible`/`assertText`
- * included) — this module drives every one of the seven the projection
- * can produce, which is a strict superset of what the desktop's narrower
- * `BrowserStep` union can act on. `fill` is not among them: the shared
- * projection refuses it because `BrowserStep` (the format's other consumer)
- * has no counterpart for it, a decision this module does not own and does
- * not work around — see the projection's own header for why collapsing it
- * into `type` would be exactly the kind of silent narrowing rule 2 forbids.
- */
-import { type BrowserSession, type BrowserSessionOptions } from "@descryy/runtime-browser";
-import type { ExecutionConfiguration, SourceRootResolver } from "@descryy/runtime-contracts";
-import type { StackTraceParser } from "@descryy/runtime-backend-observation";
-import type { EvidenceStore } from "@descryy/runtime-evidence-store";
-import { projectScenarioToRunPlan, type ProjectedStep, type ScenarioProjection } from "../scenarios/browser-run-plan-projection.ts";
-export type { ProjectedStep, ScenarioProjection };
-export { projectScenarioToRunPlan };
-/** The one shared journey step type — lane journey's `ProjectedStep`, re-exported here so a
- *  caller of this module never has to import the projection module directly. */
-export type JourneyStep = ProjectedStep;
-export interface JourneyStepRefusal {
-    readonly index: number;
-    readonly kind: string;
-    readonly reason: string;
-}
-export interface JourneyDriveOutcome {
-    /** True once a real page existed and was navigated. False means `disclosure` covers the whole drive. */
-    readonly ran: boolean;
-    readonly startUrl: string;
-    readonly stepsCompleted: number;
-    readonly stepsRefused: readonly JourneyStepRefusal[];
-    /** Byte length of the captured video, or null when video was not requested / not produced. */
-    readonly videoBytes: number | null;
-    readonly disclosure: string | null;
-}
-export interface JourneyDriveInput {
-    readonly store: EvidenceStore;
-    readonly executionId: string;
-    readonly configuration: ExecutionConfiguration;
-    readonly resolveSourceRoot?: SourceRootResolver;
-    readonly stackTraceParser?: StackTraceParser;
-}
-export type DriveJourney = (input: JourneyDriveInput) => Promise<JourneyDriveOutcome>;
-export interface JourneyPlan {
-    readonly startUrl: string;
-    readonly service?: string;
-    readonly steps?: readonly JourneyStep[];
-    readonly recordVideo?: boolean;
-    readonly headless?: boolean;
-    readonly settleForMs?: number;
-    /** Test seam only — see this module's header. Production callers must not pass it. */
-    readonly launchSession?: (options: BrowserSessionOptions) => Promise<BrowserSession>;
-}
-export declare function createRuntimeJourneyDrive(plan: JourneyPlan): DriveJourney;
-/** This module's own collector version, distinct from `@descryy/runtime-browser`'s — these rows
- *  are the composition lane's own harness reports about driving, not the browser package's. */
-export declare const RUNTIME_JOURNEY_DRIVE_VERSION = "descry-mcp-runtime-journey-drive@1";
-//# sourceMappingURL=runtime-journey-drive.d.ts.map

package/dist/tools/runtime-journey-drive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-journey-drive.d.ts","sourceRoot":"","sources":["../../src/tools/runtime-journey-drive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAEpI,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAEpC;gFACgF;AAChF,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,wGAAwG;IACxG,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrD,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACtF;AAID,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CA4GzE;AA+FD;+FAC+F;AAC/F,eAAO,MAAM,6BAA6B,uCAAuC,CAAC"}

package/dist/tools/runtime-journey-drive.js

@@ -1,247 +0,0 @@
-/**
- * RG-4 — both halves in the MCP layer, and RG-6's MCP half (video).
- *
- * `runInstrumentedExecution`'s `onReady` fires after every declared service's
- * readiness has succeeded and before the observation window's sleep — the one
- * moment in a run when the application is provably up and still alive. The
- * desktop already composes exactly this way (`descry-desktop/packages/session/
- * src/pipeline/browser-drive.ts`, invoked from `runtime-execution.ts`'s own
- * `onReady`), so that browser evidence lands in the **same `EvidenceStore`
- * under the same `executionId`** as the backend's. `observe_runtime` here
- * never did: it passed no `onReady` and never drove a browser, so an MCP
- * client got two calls with two lifetimes and nothing to prove they were the
- * same run.
- *
- * This module is the MCP equivalent of the desktop's `browser-drive.ts` —
- * same collectors, same package, same "never fabricate a step" discipline —
- * built as its own file because `packages/mcp/src/browser/driver.ts` and
- * `playwright-driver.ts` are lane identity's (a session-scoped, interactive
- * `BrowserDriver` port for the `browser_*` tools' own lifetime) and this is a
- * different lifetime entirely: one drive, bound to one execution's readiness
- * window, torn down before that execution's observation window even starts.
- * Composing through the identity lane's port would mean threading a whole
- * interactive session through a callback that must complete before
- * `onReady` returns — the wrong shape for what is, structurally, a single
- * batch replay. `@descryy/runtime-browser`'s own collectors compose directly
- * instead, the same way the desktop does it.
- *
- * ## The journey comes from the caller, projected by the ONE shared format
- *
- * `DEC-NEXT-runtime-journey-is-one-declared-format` (Q1) settled this: a
- * saved `Scenario` and a driveable step list are two views of one format,
- * and lane journey built the single projection both directions go through —
- * `../scenarios/browser-run-plan-projection.ts`'s `projectScenarioToRunPlan`.
- * This module calls that function and nothing else invents a second
- * translation of the same scenario. Its own header explains exactly what
- * projects and what refuses (seven shared verbs; `fill`, whole-page
- * assertions and anything outside those seven are refused by name, never
- * silently narrowed), and secret references are resolved inside it before
- * this module ever sees a step — see that module's own doc.
- *
- * A `Scenario` with no steps drives to `startUrl` and observes, same as an
- * empty step list does anywhere else in this codebase. No step is ever
- * synthesized here.
- *
- * `@descryy/runtime-browser`'s `BrowserActionCollector` happens to support
- * more than the shared projection's seven verbs (`assertVisible`/`assertText`
- * included) — this module drives every one of the seven the projection
- * can produce, which is a strict superset of what the desktop's narrower
- * `BrowserStep` union can act on. `fill` is not among them: the shared
- * projection refuses it because `BrowserStep` (the format's other consumer)
- * has no counterpart for it, a decision this module does not own and does
- * not work around — see the projection's own header for why collapsing it
- * into `type` would be exactly the kind of silent narrowing rule 2 forbids.
- */
-import { createBrowserActionCollector, createBrowserConsoleCollector, createBrowserNetworkCollector, launchBrowserSession, } from "@descryy/runtime-browser";
-import { projectScenarioToRunPlan } from "../scenarios/browser-run-plan-projection.js";
-export { projectScenarioToRunPlan };
-const DEFAULT_SETTLE_FOR_MS = 1_000;
-export function createRuntimeJourneyDrive(plan) {
-    const launch = plan.launchSession ?? launchBrowserSession;
-    const steps = plan.steps ?? [];
-    return async (input) => {
-        const harnessError = (detail) => {
-            input.store.write({
-                executionId: input.executionId,
-                timestamp: new Date().toISOString(),
-                source: "harness",
-                service: plan.service ?? null,
-                process: null,
-                eventType: "COLLECTOR_ERROR",
-                payload: { raw: detail, error: detail, collectorId: "runtime-journey-drive" },
-                traceId: null,
-                requestId: null,
-                correlationId: null,
-                graphNodeId: null,
-                sourceLocation: null,
-                stackTrace: null,
-                confidence: 1,
-                collectorVersion: RUNTIME_JOURNEY_DRIVE_VERSION,
-            });
-        };
-        let session;
-        try {
-            session = await launch({
-                headless: plan.headless ?? true,
-                ...(plan.recordVideo === true ? { recordVideo: true } : {}),
-            });
-        }
-        catch (error) {
-            const cause = describe(error);
-            const disclosure = `No browser was driven for this run: the browser session could not be launched (${cause}). ` +
-                `Backend evidence is unaffected — this drive runs inside the readiness window and never blocks it.`;
-            harnessError(disclosure);
-            return { ran: false, startUrl: plan.startUrl, stepsCompleted: 0, stepsRefused: [], videoBytes: null, disclosure };
-        }
-        const actions = createBrowserActionCollector({ session, ...(plan.service === undefined ? {} : { service: plan.service }) });
-        const consoleCollector = createBrowserConsoleCollector({
-            session,
-            ...(plan.service === undefined ? {} : { service: plan.service }),
-            ...(input.stackTraceParser === undefined ? {} : { stackTraceParser: input.stackTraceParser }),
-        });
-        const networkCollector = createBrowserNetworkCollector({
-            session,
-            ...(plan.service === undefined ? {} : { service: plan.service }),
-            ...(input.stackTraceParser === undefined ? {} : { stackTraceParser: input.stackTraceParser }),
-        });
-        const context = {
-            executionId: input.executionId,
-            configuration: input.configuration,
-            emit: (evidence) => {
-                input.store.write({ ...evidence, executionId: input.executionId });
-            },
-            ...(input.resolveSourceRoot === undefined ? {} : { resolveSourceRoot: input.resolveSourceRoot }),
-        };
-        const refusals = [];
-        const unavailable = [];
-        let completed = 0;
-        let videoBytes = null;
-        try {
-            for (const [name, collector] of [
-                ["browser-console", consoleCollector],
-                ["browser-network", networkCollector],
-                ["browser-action", actions],
-            ]) {
-                try {
-                    const started = await collector.start(context);
-                    if (!started.available)
-                        unavailable.push(`${name} (${started.reason ?? "no reason given"})`);
-                }
-                catch (error) {
-                    unavailable.push(`${name} (start() threw: ${describe(error)})`);
-                    harnessError(`browser collector "${name}" threw during start(): ${describe(error)}`);
-                }
-            }
-            await actions.navigate(plan.startUrl);
-            for (const [index, step] of steps.entries()) {
-                try {
-                    await runStep(actions, step);
-                    completed += 1;
-                }
-                catch (error) {
-                    const reason = describe(error);
-                    refusals.push({ index, kind: step.kind, reason });
-                    harnessError(`journey step ${String(index + 1)} (${step.kind}) could not be performed: ${reason}`);
-                }
-            }
-            await sleep(plan.settleForMs ?? DEFAULT_SETTLE_FOR_MS);
-        }
-        catch (error) {
-            const cause = describe(error);
-            harnessError(`the journey drive stopped early: ${cause}`);
-            refusals.push({ index: completed, kind: "navigate", reason: cause });
-        }
-        // Same ordering constraint as the desktop's browser-drive.ts: captureVideo() must run
-        // after session.close() (Playwright only finalizes recordVideo once the context closes)
-        // and before actions.stop() (which clears the emit channel it writes into).
-        videoBytes = await finish(consoleCollector, networkCollector, actions, session, input, harnessError);
-        const disclosure = describeShortfall(unavailable, refusals, plan);
-        return { ran: true, startUrl: plan.startUrl, stepsCompleted: completed, stepsRefused: refusals, videoBytes, disclosure };
-    };
-}
-async function finish(consoleCollector, networkCollector, actions, session, input, harnessError) {
-    const before = countVideoBytes(input);
-    for (const [name, stop] of [
-        ["browser-console", () => consoleCollector.stop()],
-        ["browser-network", () => networkCollector.stop()],
-        ["browser-session", () => session.close()],
-        ["browser-video", () => actions.captureVideo()],
-        ["browser-action", () => actions.stop()],
-    ]) {
-        try {
-            await stop();
-        }
-        catch (error) {
-            harnessError(`journey drive teardown step "${name}" failed: ${describe(error)}`);
-        }
-    }
-    const after = countVideoBytes(input);
-    return after === before ? null : after;
-}
-function countVideoBytes(input) {
-    for (const evidence of input.store.getByExecution(input.executionId)) {
-        if (evidence.eventType !== "VIDEO")
-            continue;
-        const payload = evidence.payload;
-        if (typeof payload?.videoBase64 !== "string")
-            continue;
-        return Buffer.from(payload.videoBase64, "base64").length;
-    }
-    return null;
-}
-/** Never throws on a step this module cannot resolve to an action — that would surface as a
- *  bare refusal with a useless reason; a `ProjectedStep` naming no target/text for a kind that
- *  needs one is a defect in the projection this module trusts rather than something to re-check
- *  here, so those are stated plainly rather than re-validated. */
-async function runStep(actions, step) {
-    switch (step.kind) {
-        case "navigate":
-            if (step.url === null)
-                throw new Error(`"navigate" step carries no url`);
-            return actions.navigate(step.url);
-        case "click":
-            return actions.click(requireSelector(step));
-        case "type":
-            return actions.type(requireSelector(step), requireText(step));
-        case "select":
-            return actions.select(requireSelector(step), requireText(step));
-        case "submit":
-            return actions.submit(requireSelector(step));
-        case "assertVisible":
-            return actions.assertVisible(requireSelector(step));
-        case "assertText":
-            return actions.assertText(requireSelector(step), requireText(step));
-    }
-}
-function requireSelector(step) {
-    if (step.target === null)
-        throw new Error(`"${step.kind}" step carries no target`);
-    return step.target.selector;
-}
-function requireText(step) {
-    if (step.text === null)
-        throw new Error(`"${step.kind}" step carries no text`);
-    return step.text;
-}
-function describeShortfall(unavailable, refusals, plan) {
-    const parts = [];
-    if (unavailable.length > 0) {
-        parts.push(`These browser collectors reported themselves unavailable and observed nothing: ${unavailable.join("; ")}.`);
-    }
-    if (refusals.length > 0) {
-        parts.push(`${String(refusals.length)} of ${String((plan.steps ?? []).length)} declared journey step(s) could not be performed: ` +
-            refusals.map((r) => `step ${String(r.index + 1)} (${r.kind}): ${r.reason}`).join("; ") +
-            ".");
-    }
-    return parts.length === 0 ? null : parts.join(" ");
-}
-function describe(error) {
-    return error instanceof Error ? `${error.name}: ${error.message}` : String(error);
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/** This module's own collector version, distinct from `@descryy/runtime-browser`'s — these rows
- *  are the composition lane's own harness reports about driving, not the browser package's. */
-export const RUNTIME_JOURNEY_DRIVE_VERSION = "descry-mcp-runtime-journey-drive@1";
-//# sourceMappingURL=runtime-journey-drive.js.map

package/dist/tools/runtime-journey-drive.js.map

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

package/dist/tools/scope.d.ts

@@ -1,45 +0,0 @@
-/**
- * `scope` — §12.5 diff scoping: what else does this change touch? Expansion stops
- * on score, not hop count — a payment gateway 4 hops out matters, a logging import
- * 1 hop out doesn't. A file the graph never heard of has two causes (not analysable,
- * or stale graph) — both disclosed, never reported as "0 affected" (§20.2's collapse). */
-import { type ScopeTier } from "@descryy/core";
-import type { EdgeType } from "@descryy/ir";
-import { type BriefNode, type ToolDefinition } from "./kit.ts";
-/** A node in the scope, with why it is in it. */
-export interface ScopedNodeReport extends BriefNode {
-    readonly score: number;
-    readonly tier: ScopeTier;
-    readonly depth: number;
-    /** The edge type this node was reached through. Absent for a seed. */
-    readonly via?: EdgeType;
-}
-/** Tier 1 is the changed set itself; 2-4 are the scoring bands beneath it. */
-export interface ScopeTierCount {
-    readonly tier: number;
-    readonly count: number;
-}
-export interface ScopeReport {
-    /** Capped by `limit`; `changedTotal` is the uncapped count. Every seed is
-     *  traversed either way — the cap shortens the listing, not the analysis. */
-    readonly changed: readonly ScopedNodeReport[];
-    readonly changedTotal: number;
-    /** Capped by `limit`; `affectedTotal` is the uncapped count. */
-    readonly affected: readonly ScopedNodeReport[];
-    readonly affectedTotal: number;
-    readonly droppedForBudget: number;
-    readonly budget: number;
-    readonly budgetUsed: number;
-    readonly byTier: readonly ScopeTierCount[];
-}
-/** Nothing named resolved into the graph, so the traversal never ran — a different
- *  shape, not a zeroed `ScopeReport`: no `budget`/`affectedTotal` because nothing ran.
- *  Narrow on `"seeds" in data`. */
-export interface ScopeNotSeeded {
-    readonly changed: readonly ScopedNodeReport[];
-    readonly affected: readonly ScopedNodeReport[];
-    readonly seeds: number;
-}
-export type ScopeData = ScopeReport | ScopeNotSeeded;
-export declare const scopeTool: ToolDefinition;
-//# sourceMappingURL=scope.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/tools/scope.ts"],"names":[],"mappings":"AAAA;;;;0FAI0F;AAE1F,OAAO,EAA8C,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAOL,KAAK,SAAS,EAEd,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAIlB,iDAAiD;AACjD,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;CACzB;AAED,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B;iFAC6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED;;mCAEmC;AACnC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;AAoMrD,eAAO,MAAM,SAAS,EAAE,cAavB,CAAC"}