@sapiom/harness 0.1.5 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sapiom/harness",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "Sapiom Harness — a CLI-launched local web app that runs your coding agent (Claude Code, Codex) in a Sapiom-configured environment: MCP pre-wired, workflows tracked, one-click deploy/run, and a live canvas for previews.",
   "keywords": [
     "sapiom",
@@ -47,13 +47,15 @@
     "open": "^10.1.0",
     "ws": "^8.18.0",
     "zod": "^3.25.0",
-    "@sapiom/agent": "^0.6.4",
-    "@sapiom/agent-core": "^0.9.5",
+    "@sapiom/agent": "^0.7.0",
+    "@sapiom/agent-core": "^0.9.10",
     "@sapiom/analytics-core": "^0.2.1",
     "@sapiom/mcp": "^0.11.3"
   },
   "devDependencies": {
     "@playwright/test": "^1.61.0",
+    "@stryker-mutator/core": "^9.6.1",
+    "@stryker-mutator/vitest-runner": "^9.6.1",
     "@types/express": "^4.17.21",
     "@types/node": "^20.11.30",
     "@types/react": "^19.0.0",
@@ -85,8 +87,10 @@
     "dev": "tsx src/cli/bin.ts --dev",
     "dev:web": "vite --config web/vite.config.ts",
     "start": "node dist/cli/bin.js",
-    "test": "vitest run",
+    "test": "vitest run && vitest run --config vitest.perf.config.ts",
+    "test:perf": "vitest run --config vitest.perf.config.ts",
     "test:watch": "vitest",
+    "test:mutation": "stryker run",
     "test:ui": "playwright test --config web/e2e/playwright.config.ts",
     "test:canvas": "playwright test --config e2e/playwright.config.ts",
     "typecheck": "tsc --noEmit && tsc --noEmit -p web/tsconfig.json",

package/dist/core/canvas-enrich.d.ts

@@ -1,115 +0,0 @@
-/**
- * The AI enrichment runner: spawns ONE bounded, headless agent task per
- * workflow (via TaskManager) that reads the workflow's step bodies and
- * returns the JSON `CanvasEnrichment` contract — never HTML, never a file
- * write. On success the validated enrichment is persisted to the workflow's
- * cache file and the render file is rebuilt with it merged in; on any
- * parse/validation failure the enrichment is discarded whole and the base
- * render stands (core/canvas-enrichment.ts's contract). Task-process
- * failures surface through the task record itself (the pane's error state +
- * Retry), never as HTML on disk.
- *
- * Triggering (see server/index.ts):
- * - bind / session create → `ensureFresh`: spawn only when no cache entry
- *   matches the current source fingerprint; every skip reason is silent.
- * - the visualize macro → `forceRefresh`: drop the extraction + enrichment
- *   caches, re-render the base immediately, re-enrich; refusals propagate
- *   (an already-running enrichment for this workflow → 409 via the macros
- *   router, exactly like any other double-fired background macro).
- *
- * Dedupe is per WORKFLOW, not per session: TaskManager refuses a second
- * running task with the same macroId + workflowPath regardless of which
- * session asked (see TaskAlreadyRunningError) — two panes bound to the same
- * workflow can never race its cache/render files.
- */
-import type { BackgroundTask, HarnessKind } from "../shared/types.js";
-import { type CachedExtraction } from "./canvas-cache.js";
-import type { CanvasGraph } from "./canvas-graph.js";
-import { type RenderableWorkflow } from "./canvas-render.js";
-import type { RunTaskRequest } from "./task-manager.js";
-/** The macro identity enrichment tasks run under — the pane's Retry re-fires
- *  this macro, which routes back through forceRefresh. */
-export declare const ENRICHMENT_MACRO_ID = "visualize";
-/** Model the enrichment task runs on — overridable per install. */
-export declare function enrichmentModel(env?: NodeJS.ProcessEnv): string;
-/**
- * Builds the one-shot enrichment prompt: the extracted graph inline (the AI
- * annotates THIS structure — it never invents nodes), pointed at the step
- * sources for semantics, with the JSON contract and its hard limits stated
- * verbatim so a well-behaved run needs no retry.
- */
-export declare function buildEnrichmentPrompt(graph: CanvasGraph, workflowDir: string): string;
-/**
- * Pulls the JSON object out of a task's final result text — either fenced
- * (\`\`\`json ... \`\`\`) or raw, tolerating prose around it by falling back to
- * the outermost {...} span. Null when nothing parses.
- */
-export declare function extractEnrichmentJson(text: string): unknown | null;
-/** The slice of TaskManager the runner uses — injectable for tests. */
-export interface EnrichmentTaskRunner {
-    run(req: RunTaskRequest): Promise<BackgroundTask>;
-    onStatusChange(listener: (task: BackgroundTask) => void): () => void;
-    /** Returns true when an enrichment task for this workflow is currently
-     *  running — checked before cache destruction in forceRefresh so a
-     *  double-click Visualize is a true no-op, not a half-destroyed cache. */
-    isRunning(macroId: string, workflowPath: string): boolean;
-}
-/** The session shape the coordinator needs — satisfied by HarnessSession. */
-export interface EnrichmentSession {
-    id: string;
-    cwd: string;
-    harness: HarnessKind;
-    boundWorkflowPath: string | null;
-}
-export interface EnrichmentCoordinatorOptions {
-    tasks: EnrichmentTaskRunner;
-    /** Rebuilds the workflow's render file (with the just-persisted enrichment
-     *  merged) after a successful run — the write alone hot-reloads any open
-     *  pane via the canvas watcher. */
-    rerender?: (cwd: string, workflow: RenderableWorkflow) => Promise<void>;
-    /** Injectable for tests — defaults to the real cached extraction. */
-    extractCached?: (dir: string) => Promise<CachedExtraction>;
-    env?: NodeJS.ProcessEnv;
-    now?: () => string;
-    onError?: (message: string) => void;
-}
-export declare class CanvasEnrichmentCoordinator {
-    private readonly tasks;
-    private readonly rerender;
-    private readonly extractCached;
-    private readonly env;
-    private readonly now;
-    private readonly onError;
-    constructor(options: EnrichmentCoordinatorOptions);
-    /**
-     * The bind/create trigger: spawn an enrichment task unless a cached
-     * enrichment already matches the workflow's current sources. Silent on
-     * every expected refusal — unbound session, failed extraction, fresh
-     * cache, an enrichment already in flight for this workflow, a harness
-     * with no headless mode, even a spawn failure (logged) — because nothing
-     * here was user-initiated and a bind must never fail on enrichment's
-     * account.
-     */
-    ensureFresh(session: EnrichmentSession, workflows: readonly RenderableWorkflow[]): Promise<void>;
-    /**
-     * The visualize macro: invalidate both caches, re-render the base diagram
-     * immediately (instant feedback, honest content — no leftover enrichment
-     * from sources that may have changed), then re-enrich. Refusals propagate
-     * to the macros router (TaskAlreadyRunningError → 409,
-     * TaskNotSupportedError → 400). Unbound session: just a no-op, matching
-     * the deterministic render's own unbound contract.
-     *
-     * The already-running check happens BEFORE any cache destruction so that a
-     * double-click Visualize is a true no-op: the second call rejects with
-     * TaskAlreadyRunningError and the caches and render are left exactly as
-     * the still-running enrichment will need them.
-     */
-    forceRefresh(session: EnrichmentSession, workflows: readonly RenderableWorkflow[]): Promise<void>;
-    private resolveBound;
-    private spawn;
-    /** Completed task → parse → validate → cache file → re-render. Any parse
-     *  or validation failure discards the enrichment whole; the base render
-     *  already on disk stands untouched. */
-    private persist;
-}
-//# sourceMappingURL=canvas-enrich.d.ts.map

package/dist/core/canvas-enrich.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"canvas-enrich.d.ts","sourceRoot":"","sources":["../../src/core/canvas-enrich.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAyD,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASrD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD;0DAC0D;AAC1D,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAO/C,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAuBrF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAgBlE;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAClD,cAAc,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE;;8EAE0E;IAC1E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3D;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,oBAAoB,CAAC;IAC5B;;uCAEmC;IACnC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,qEAAqE;IACrE,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+D;IACxF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6C;IAC3E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,OAAO,EAAE,4BAA4B;IASjD;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAetG;;;;;;;;;;;;OAYG;IACG,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvG,OAAO,CAAC,YAAY;YAON,KAAK;IA+BnB;;4CAEwC;YAC1B,OAAO;CAqBtB"}

package/dist/core/canvas-enrich.js

@@ -1,186 +0,0 @@
-import { extractWorkflowGraphCached, invalidateExtractionCache } from "./canvas-cache.js";
-import { ENRICHMENT_LIMITS, normalizeCanvasEnrichmentCandidate, parseCanvasEnrichment, readEnrichmentCacheFile, removeEnrichmentCacheFile, writeEnrichmentCacheFile, } from "./canvas-enrichment.js";
-import { enrichmentCacheFileFor, renderWorkflowRenderFile, } from "./canvas-render.js";
-import { TaskAlreadyRunningError, TaskNotSupportedError } from "./task-manager.js";
-/** The macro identity enrichment tasks run under — the pane's Retry re-fires
- *  this macro, which routes back through forceRefresh. */
-export const ENRICHMENT_MACRO_ID = "visualize";
-const ENRICHMENT_TASK_LABEL = "Visualize";
-/** Hard turn cap: read a few step files, answer. A run that needs more than
- *  this is off the rails, not thorough. */
-const ENRICHMENT_MAX_TURNS = 8;
-const DEFAULT_ENRICHMENT_MODEL = "sonnet";
-/** Model the enrichment task runs on — overridable per install. */
-export function enrichmentModel(env = process.env) {
-    return env.SAPIOM_HARNESS_VISUALIZE_MODEL || DEFAULT_ENRICHMENT_MODEL;
-}
-/**
- * Builds the one-shot enrichment prompt: the extracted graph inline (the AI
- * annotates THIS structure — it never invents nodes), pointed at the step
- * sources for semantics, with the JSON contract and its hard limits stated
- * verbatim so a well-behaved run needs no retry.
- */
-export function buildEnrichmentPrompt(graph, workflowDir) {
-    const L = ENRICHMENT_LIMITS;
-    return `You are annotating an already-rendered workflow diagram. The diagram's structure below is fixed — you only supply short text annotations, as one JSON object.
-
-Extracted workflow graph:
-${JSON.stringify(graph, null, 2)}
-
-Read the step run() bodies in ${workflowDir} to understand what each step actually does (what it calls, what it decides, why it branches), then RETURN ONLY a JSON object matching this schema — no prose before or after, no markdown required, and DO NOT write or modify any files:
-
-{
-  "summary": "what this workflow does, one line (max ${L.summary} chars)",
-  "nodeDetails": { "<nodeId>": { "sublabel": "short annotation shown in the node (max ${L.sublabel} chars)", "description": "one sentence, shown on hover (max ${L.description} chars)" } },
-  "edgeLabels": { "<fromNodeId>-><toNodeId>": "intent/condition name (max ${L.edgeLabel} chars)" },
-  "notes": ["up to ${L.noteCount} facts worth knowing, each max ${L.note} chars"],
-  "layoutHints": { "groups": [{ "label": "group name (max ${L.groupLabel} chars)", "nodeIds": ["..."] }], "laneOrder": { "<layerIndex>": ["nodeId", "..."] } },
-  "crossWorkflow": "how this workflow ties into the project's other workflows, if it does (max ${L.crossWorkflow} chars)"
-}
-
-Rules:
-- Every field is optional — omit what you have nothing useful for (omit, don't write null). Empty strings are worse than omissions.
-- Use ONLY node ids that appear in the graph above.
-- Length limits are hard caps and oversize strings get truncated mid-sentence — aim comfortably under each limit.
-- Your final message must be exactly the JSON object.`;
-}
-/**
- * Pulls the JSON object out of a task's final result text — either fenced
- * (\`\`\`json ... \`\`\`) or raw, tolerating prose around it by falling back to
- * the outermost {...} span. Null when nothing parses.
- */
-export function extractEnrichmentJson(text) {
-    const fenced = /```(?:json)?\s*([\s\S]*?)```/.exec(text);
-    const candidates = [fenced?.[1], text];
-    const first = text.indexOf("{");
-    const last = text.lastIndexOf("}");
-    if (first !== -1 && last > first)
-        candidates.push(text.slice(first, last + 1));
-    for (const candidate of candidates) {
-        if (!candidate)
-            continue;
-        try {
-            const parsed = JSON.parse(candidate.trim());
-            if (typeof parsed === "object" && parsed !== null)
-                return parsed;
-        }
-        catch {
-            // Try the next candidate shape.
-        }
-    }
-    return null;
-}
-export class CanvasEnrichmentCoordinator {
-    constructor(options) {
-        this.tasks = options.tasks;
-        this.rerender = options.rerender ?? (async (cwd, workflow) => void (await renderWorkflowRenderFile(cwd, workflow)));
-        this.extractCached = options.extractCached ?? extractWorkflowGraphCached;
-        this.env = options.env ?? process.env;
-        this.now = options.now ?? (() => new Date().toISOString());
-        this.onError = options.onError ?? ((message) => console.error(`[harness] ${message}`));
-    }
-    /**
-     * The bind/create trigger: spawn an enrichment task unless a cached
-     * enrichment already matches the workflow's current sources. Silent on
-     * every expected refusal — unbound session, failed extraction, fresh
-     * cache, an enrichment already in flight for this workflow, a harness
-     * with no headless mode, even a spawn failure (logged) — because nothing
-     * here was user-initiated and a bind must never fail on enrichment's
-     * account.
-     */
-    async ensureFresh(session, workflows) {
-        const bound = this.resolveBound(session, workflows);
-        if (!bound)
-            return;
-        try {
-            const { result, fingerprint } = await this.extractCached(bound.path);
-            if (!result.ok)
-                return;
-            const entry = await readEnrichmentCacheFile(enrichmentCacheFileFor(session.cwd, bound.path));
-            if (entry && entry.sourceFingerprint === fingerprint)
-                return;
-            await this.spawn(session, bound, result.graph, fingerprint);
-        }
-        catch (err) {
-            if (err instanceof TaskAlreadyRunningError || err instanceof TaskNotSupportedError)
-                return;
-            this.onError(`canvas enrichment (auto) failed to start: ${err.message}`);
-        }
-    }
-    /**
-     * The visualize macro: invalidate both caches, re-render the base diagram
-     * immediately (instant feedback, honest content — no leftover enrichment
-     * from sources that may have changed), then re-enrich. Refusals propagate
-     * to the macros router (TaskAlreadyRunningError → 409,
-     * TaskNotSupportedError → 400). Unbound session: just a no-op, matching
-     * the deterministic render's own unbound contract.
-     *
-     * The already-running check happens BEFORE any cache destruction so that a
-     * double-click Visualize is a true no-op: the second call rejects with
-     * TaskAlreadyRunningError and the caches and render are left exactly as
-     * the still-running enrichment will need them.
-     */
-    async forceRefresh(session, workflows) {
-        const bound = this.resolveBound(session, workflows);
-        if (!bound)
-            return;
-        if (this.tasks.isRunning(ENRICHMENT_MACRO_ID, bound.path)) {
-            throw new TaskAlreadyRunningError(ENRICHMENT_TASK_LABEL);
-        }
-        invalidateExtractionCache(bound.path);
-        await removeEnrichmentCacheFile(enrichmentCacheFileFor(session.cwd, bound.path));
-        await this.rerender(session.cwd, bound);
-        const { result, fingerprint } = await this.extractCached(bound.path);
-        if (!result.ok)
-            return;
-        await this.spawn(session, bound, result.graph, fingerprint);
-    }
-    resolveBound(session, workflows) {
-        return session.boundWorkflowPath ? workflows.find((w) => w.path === session.boundWorkflowPath) : undefined;
-    }
-    async spawn(session, workflow, graph, fingerprint) {
-        const task = await this.tasks.run({
-            macroId: ENRICHMENT_MACRO_ID,
-            label: ENRICHMENT_TASK_LABEL,
-            harnessSessionId: session.id,
-            harness: session.harness,
-            cwd: session.cwd,
-            prompt: buildEnrichmentPrompt(graph, workflow.path),
-            workflowPath: workflow.path,
-            model: enrichmentModel(this.env),
-            maxTurns: ENRICHMENT_MAX_TURNS,
-        });
-        // Subscribed synchronously right after run() resolves — the process's
-        // exit can only arrive via a later event-loop turn, so the terminal
-        // status can't be missed.
-        const unsubscribe = this.tasks.onStatusChange((update) => {
-            if (update.id !== task.id || update.status === "running")
-                return;
-            unsubscribe();
-            if (update.status !== "completed")
-                return; // pane shows the failure; nothing to persist
-            void this.persist(session.cwd, workflow, graph, fingerprint, update.resultText).catch((err) => {
-                this.onError(`canvas enrichment persist failed: ${err.message}`);
-            });
-        });
-    }
-    /** Completed task → parse → validate → cache file → re-render. Any parse
-     *  or validation failure discards the enrichment whole; the base render
-     *  already on disk stands untouched. */
-    async persist(cwd, workflow, graph, fingerprint, resultText) {
-        const candidate = resultText ? extractEnrichmentJson(resultText) : null;
-        const enrichment = candidate ? parseCanvasEnrichment(normalizeCanvasEnrichmentCandidate(candidate)) : null;
-        if (!enrichment) {
-            this.onError(`canvas enrichment for ${workflow.path} returned invalid output — discarded, base render stands`);
-            return;
-        }
-        await writeEnrichmentCacheFile(enrichmentCacheFileFor(cwd, workflow.path), {
-            graph,
-            enrichment,
-            sourceFingerprint: fingerprint,
-            enrichedAt: this.now(),
-        });
-        await this.rerender(cwd, workflow);
-    }
-}
-//# sourceMappingURL=canvas-enrich.js.map

package/dist/core/canvas-enrich.js.map

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

package/dist/core/run-spend.d.ts

@@ -1,55 +0,0 @@
-/**
- * run-spend — fetches the cost/spend summary for a prod execution from the
- * core surface and maps it to a {@link RunSpend} the canvas can poll.
- *
- * WHY the core surface: the spend endpoint lives at
- * `GET /v1/workflows/executions/:id/spend` on api.sapiom.ai (the CORE
- * capability surface), which is distinct from the agents surface
- * (tools.sapiom.ai) that run-state.ts uses.  The same caveat applies:
- * env-consistency with the run's environment matters — both surfaces must be
- * overridden together when pointing at non-prod.
- *
- * WHY the key stays server-side: same rationale as run-state.ts — the Sapiom
- * API key is a harness credential that must never reach the browser.  The
- * harness server fetches on behalf of the canvas, so the SPA polls a local
- * `/api/runs/:id/spend` endpoint (no key in the request) rather than calling
- * the upstream surface directly.
- */
-import type { RunSpend } from "../shared/types.js";
-/**
- * Resolve the CORE surface base URL for the spend endpoint.
- *
- * The spend endpoint lives on the CORE host (`api.<env>`), distinct from the
- * agents host run-state.ts uses (`tools.<env>`). Crucially, a run lives in the
- * agents env, and its spend must be read from the MATCHING core env — otherwise
- * a prod run's spend queried against dev 401s. So we DERIVE the core host from
- * the agents host (`tools.<env>` → `api.<env>`) rather than reading
- * `SAPIOM_API_URL`, which in some setups points at a different env than the
- * agents surface. An explicit `SAPIOM_CORE_URL` still wins for full control.
- */
-export declare function resolveCoreBaseUrl(): string;
-export type RunSpendResult = {
-    ok: true;
-    spend: RunSpend;
-} | {
-    ok: false;
-    status: number;
-    error: string;
-};
-export interface RunSpendFetcherOpts {
-    apiKey: string | null;
-    baseUrl?: string;
-    /** Injectable fetch implementation — defaults to global fetch. Test seam. */
-    fetchImpl?: typeof fetch;
-}
-export interface RunSpendFetcher {
-    fetch(executionId: string): Promise<RunSpendResult>;
-}
-/**
- * Create a fetcher that resolves an execution's spend/cost from the core
- * surface. The fetcher is intentionally non-throwing: all error paths return
- * a typed {@link RunSpendResult} with `ok: false` so the router can forward
- * the appropriate HTTP status without a try/catch at the call site.
- */
-export declare function createRunSpendFetcher(opts: RunSpendFetcherOpts): RunSpendFetcher;
-//# sourceMappingURL=run-spend.d.ts.map

package/dist/core/run-spend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-spend.d.ts","sourceRoot":"","sources":["../../src/core/run-spend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAc3C;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,GACxB,eAAe,CAsEjB"}

package/dist/core/run-spend.js

@@ -1,109 +0,0 @@
-/**
- * run-spend — fetches the cost/spend summary for a prod execution from the
- * core surface and maps it to a {@link RunSpend} the canvas can poll.
- *
- * WHY the core surface: the spend endpoint lives at
- * `GET /v1/workflows/executions/:id/spend` on api.sapiom.ai (the CORE
- * capability surface), which is distinct from the agents surface
- * (tools.sapiom.ai) that run-state.ts uses.  The same caveat applies:
- * env-consistency with the run's environment matters — both surfaces must be
- * overridden together when pointing at non-prod.
- *
- * WHY the key stays server-side: same rationale as run-state.ts — the Sapiom
- * API key is a harness credential that must never reach the browser.  The
- * harness server fetches on behalf of the canvas, so the SPA polls a local
- * `/api/runs/:id/spend` endpoint (no key in the request) rather than calling
- * the upstream surface directly.
- */
-import { resolveAgentsBaseUrl } from "./run-state.js";
-/**
- * Resolve the CORE surface base URL for the spend endpoint.
- *
- * The spend endpoint lives on the CORE host (`api.<env>`), distinct from the
- * agents host run-state.ts uses (`tools.<env>`). Crucially, a run lives in the
- * agents env, and its spend must be read from the MATCHING core env — otherwise
- * a prod run's spend queried against dev 401s. So we DERIVE the core host from
- * the agents host (`tools.<env>` → `api.<env>`) rather than reading
- * `SAPIOM_API_URL`, which in some setups points at a different env than the
- * agents surface. An explicit `SAPIOM_CORE_URL` still wins for full control.
- */
-export function resolveCoreBaseUrl() {
-    const override = process.env.SAPIOM_CORE_URL;
-    if (override)
-        return override;
-    const agents = resolveAgentsBaseUrl();
-    try {
-        const url = new URL(agents);
-        if (url.hostname.startsWith("tools.")) {
-            url.hostname = `api.${url.hostname.slice("tools.".length)}`;
-            return url.origin;
-        }
-    }
-    catch {
-        // Unparseable agents URL — fall through to the prod default.
-    }
-    return "https://api.sapiom.ai";
-}
-/**
- * Create a fetcher that resolves an execution's spend/cost from the core
- * surface. The fetcher is intentionally non-throwing: all error paths return
- * a typed {@link RunSpendResult} with `ok: false` so the router can forward
- * the appropriate HTTP status without a try/catch at the call site.
- */
-export function createRunSpendFetcher(opts) {
-    const { apiKey, baseUrl = resolveCoreBaseUrl(), fetchImpl = fetch } = opts;
-    return {
-        async fetch(executionId) {
-            // No API key — do not touch the network; the harness is not signed in.
-            if (!apiKey) {
-                return {
-                    ok: false,
-                    status: 503,
-                    error: "harness is not signed in to Sapiom",
-                };
-            }
-            let res;
-            try {
-                res = await fetchImpl(`${baseUrl}/v1/workflows/executions/${encodeURIComponent(executionId)}/spend`, { headers: { "x-api-key": apiKey } });
-            }
-            catch {
-                return { ok: false, status: 502, error: "gateway unreachable" };
-            }
-            if (res.status === 404) {
-                return { ok: false, status: 404, error: "spend not found" };
-            }
-            if (!res.ok) {
-                return {
-                    ok: false,
-                    status: 502,
-                    error: `gateway responded ${res.status}`,
-                };
-            }
-            try {
-                const raw = (await res.json());
-                // The response is ExecutionSpendDto — we map the capability sub-object
-                // fields to RunSpend, falling back to top-level totalUsd when needed.
-                const capability = raw.capability;
-                const totalUsd = capability?.totalUsd ??
-                    raw.totalUsd ??
-                    "0";
-                const settleState = capability?.settleState ?? "pending";
-                const rawByStep = capability?.byStep ?? [];
-                const byStep = rawByStep.map((s) => {
-                    const step = s;
-                    return {
-                        name: step.stepName,
-                        totalUsd: step.totalUsd,
-                        entryCount: step.entryCount,
-                    };
-                });
-                const spend = { executionId, totalUsd, settleState, byStep };
-                return { ok: true, spend };
-            }
-            catch {
-                return { ok: false, status: 502, error: "could not decode spend" };
-            }
-        },
-    };
-}
-//# sourceMappingURL=run-spend.js.map

package/dist/core/run-spend.js.map

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

package/dist/core/run-transactions.d.ts

@@ -1,60 +0,0 @@
-/**
- * run-transactions — fetches the per-call cost drill-down for an execution
- * from the core surface and maps it to a {@link RunCall}[] the canvas shows
- * when a user clicks a step and asks "why is this costly".
- *
- * WHY this exists alongside run-spend: `/spend` gives per-STEP aggregates
- * (totalUsd + entryCount). This endpoint itemises the individual billable
- * capability calls that make up that total (e.g. "renderPdfs $7.95 = 1 sandbox
- * call"), which is what makes the debug macros actionable.
- *
- * WHY provider-agnostic: the raw upstream service name (the provider) is mapped
- * to a generic capability label here, server-side, so the browser never
- * receives — and this open-source file never hard-codes — a provider or model
- * name. See the capability-label heuristic below (keyed on generic op/resource
- * tokens, never a brand).
- *
- * WHY the key stays server-side: identical rationale to run-state / run-spend —
- * the Sapiom API key is a harness credential that must never reach the browser.
- */
-import type { RunCall } from "../shared/types.js";
-export type RunCallsResult = {
-    ok: true;
-    calls: RunCall[];
-} | {
-    ok: false;
-    status: number;
-    error: string;
-};
-export interface RunTransactionsFetcherOpts {
-    apiKey: string | null;
-    /** Override the core base URL (resolved from env by default). Test seam. */
-    baseUrl?: string;
-    /** Injectable fetch implementation — defaults to global fetch. Test seam. */
-    fetchImpl?: typeof fetch;
-}
-export interface RunTransactionsFetcher {
-    fetch(executionId: string): Promise<RunCallsResult>;
-}
-/**
- * Map a raw upstream operation/resource to a provider-agnostic capability
- * label. Keyed ONLY on generic tokens (message / sandbox / search) and the
- * operation verb — deliberately never on a provider/brand name, so this file
- * stays clean of internal service names and the label is stable if the
- * underlying provider is swapped. Unknown shapes fall back to the operation
- * verb, which is itself generic ("create", "execute", …).
- */
-export declare function capabilityLabel(op: string, resource: string): string;
-/**
- * Create a fetcher that resolves an execution's per-call cost breakdown from
- * the core transactions endpoint. Like the spend fetcher, it is intentionally
- * non-throwing: every error path returns a typed {@link RunCallsResult} with
- * `ok: false` so the router forwards the status without a try/catch.
- *
- * Only BILLABLE calls are returned (active captured USD > 0) — the free
- * `workflows` orchestration rows are dropped as noise. Each call is attributed
- * to `metadata.workflowStepName ?? actionName` so the canvas can match it to a
- * step node.
- */
-export declare function createRunTransactionsFetcher(opts: RunTransactionsFetcherOpts): RunTransactionsFetcher;
-//# sourceMappingURL=run-transactions.d.ts.map

package/dist/core/run-transactions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-transactions.d.ts","sourceRoot":"","sources":["../../src/core/run-transactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQpE;AAeD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,0BAA0B,GAC/B,sBAAsB,CAyExB"}