@archmax-ai/harness 0.0.0

package/dist/workflow/paths.js

@@ -0,0 +1,108 @@
+import { SESSION_INTERNAL_DIRS, SESSION_OFFLOAD_DIRS, SESSION_OPEN_DIR, SESSION_AGNOSTIC_PREFIX, } from "../core/zones.js";
+/** Default workflow slug when none is supplied. */
+export const DEFAULT_WORKFLOW = "order-lookup";
+/**
+ * Where a workspace may override the platform system prompt. Nothing needs to be
+ * served there: the runtime ships the default prompt in its code.
+ */
+export const PLATFORM_PROMPT_PATH = ".platform/system/GRAPH_STATE.md";
+export { PLATFORM_PROMPT_PATH as PLATFORM_BACKEND_PROMPT_PATH };
+/** Workspace-relative paths for a named workflow (the read-only authored zone). */
+export function workflowPaths(workflow) {
+    const base = `workflows/${workflow}`;
+    return {
+        platformPrompt: PLATFORM_PROMPT_PATH,
+        agentsPrompt: "AGENTS.md",
+        /** The machine spec: a pure YAML mapping. */
+        workflowYaml: `${base}/workflow.yaml`,
+        /** Optional prose addendum, appended after the spec-rendered prompt section. Never a machine source. */
+        workflow: `${base}/WORKFLOW.md`,
+        testsDir: `${base}/tests`,
+        /** Lifecycle hook scripts: the runtime's code, which the agent can neither read nor execute. */
+        hooksDir: `${base}/hooks`,
+    };
+}
+/** Where a hook script must live, relative to its workflow directory. */
+export const HOOKS_DIR = "hooks";
+/**
+ * Resolve a hook's declared `script:` to an authoring-backend path. A hook path
+ * is workflow-relative and confined to the workflow's own `hooks/`; anything
+ * leaving it is refused with a reason. This keeps the two script classes
+ * disjoint: a hook can never be an `archmax_run` target.
+ */
+export function resolveHookScript(workflow, declared) {
+    const raw = declared.trim();
+    if (raw === "")
+        return { ok: false, reason: "hook script path is empty" };
+    if (raw.startsWith("/")) {
+        return {
+            ok: false,
+            reason: `hook script '${declared}' is an absolute path; a hook script path is relative to its ` +
+                `workflow directory (e.g. '${HOOKS_DIR}/check.js')`,
+        };
+    }
+    const segments = [];
+    for (const segment of raw.split("/")) {
+        if (segment === "" || segment === ".")
+            continue;
+        // A `..` climb that leaves `hooks/` is caught by the prefix check below.
+        if (segment === "..")
+            segments.pop();
+        else
+            segments.push(segment);
+    }
+    const rel = segments.join("/");
+    if (rel !== HOOKS_DIR && !rel.startsWith(`${HOOKS_DIR}/`)) {
+        return {
+            ok: false,
+            reason: `hook script '${declared}' resolves outside '${HOOKS_DIR}/'; hook scripts live in ` +
+                `'workflows/${workflow}/${HOOKS_DIR}/' and are wired workflow-relative ` +
+                `(e.g. '${HOOKS_DIR}/check.js').`,
+        };
+    }
+    if (rel === HOOKS_DIR) {
+        return { ok: false, reason: `hook script '${declared}' names the '${HOOKS_DIR}/' directory, not a file` };
+    }
+    return { ok: true, path: `workflows/${workflow}/${rel}` };
+}
+/**
+ * The runtime-internal layout of one session's folder. These paths carry the
+ * session id explicitly (`<sessionId>/…`) because internal writers run both
+ * inside and outside a bound turn; the agent addresses the same folders id-free.
+ */
+export function sessionPaths(sessionId) {
+    const base = sessionId;
+    return {
+        base,
+        /** Durable checkpoint and pending-write records, one immutable file each. */
+        checkpointsDir: `${base}/${SESSION_INTERNAL_DIRS[0]}`,
+        artifactsDir: `${base}/${SESSION_INTERNAL_DIRS[1]}`,
+        /** The run's working area (`scratchpad/…` to the agent). Durable; nothing cleans it up. */
+        scratchpadDir: `${base}/${SESSION_OPEN_DIR}`,
+        /** Deep Agents' context-offload areas: agent-readable, never agent-writable. */
+        largeToolResultsDir: `${base}/${SESSION_OFFLOAD_DIRS[0]}`,
+        conversationHistoryDir: `${base}/${SESSION_OFFLOAD_DIRS[1]}`,
+    };
+}
+/** Paths of a session's observability artifacts under `<sessionId>/artifacts/`. */
+export function runArtifactPaths(sessionId) {
+    const runDir = sessionPaths(sessionId).artifactsDir;
+    return {
+        runDir,
+        graphJson: `${runDir}/graph.json`,
+        graphMermaid: `${runDir}/graph.mmd`,
+        trajectoryJson: `${runDir}/trajectory.json`,
+        metadataJson: `${runDir}/metadata.json`,
+        trailJson: `${runDir}/trail.json`,
+        variablesJson: `${runDir}/variables.json`,
+    };
+}
+/**
+ * Path of a content-addressed spec snapshot, keyed by `specHash`. Lives under
+ * the session-agnostic `_specs/` prefix so every session sharing a spec version
+ * shares one file; the run-zone router passes this prefix through unprefixed.
+ */
+export function specSnapshotPath(hash) {
+    return `${SESSION_AGNOSTIC_PREFIX}/${hash}.json`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/workflow/paths.js.map

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

package/dist/workflow/prompt-cache.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Provider prompt caching for the stable prompt prefix (tool schemas and the
+ * static system prompt, re-sent on every model call of a turn).
+ *
+ * LangChain owns the provider mechanics where it has them: a native
+ * `ChatAnthropic` or `ChatBedrockConverse` gets LangChain's own caching
+ * middleware. The one case with no built-in is the default — Claude reached
+ * through an OpenAI-compatible endpoint — where the workflow middleware places
+ * an explicit `cache_control` breakpoint on the static system block. Anything
+ * else is a no-op (OpenAI and Gemini cache prefixes automatically).
+ */
+import { type AgentMiddleware } from "langchain";
+export declare const CACHE_TTLS: readonly ["5m", "1h"];
+export type CacheTtl = (typeof CACHE_TTLS)[number];
+export declare const DEFAULT_CACHE_TTL: CacheTtl;
+export declare function isCacheTtl(value: unknown): value is CacheTtl;
+/**
+ * How caching is applied: `anthropic-native` / `bedrock-native` via LangChain's
+ * middlewares; `anthropic-compat` via an explicit marker on the static system
+ * block; `unsupported` when requested for a model with no known mechanism; `off`.
+ */
+export type PromptCacheStrategy = "anthropic-native" | "bedrock-native" | "anthropic-compat" | "off" | "unsupported";
+/**
+ * The strategies LangChain implements as graph-level provider middleware. They
+ * cannot vary per model call, which is why a state whose model wants a different
+ * one is reported at assembly rather than silently mis-cached.
+ */
+export declare const NATIVE_CACHE_STRATEGIES: ReadonlySet<PromptCacheStrategy>;
+export interface PromptCacheConfig {
+    enabled: boolean;
+    ttl: CacheTtl;
+}
+export interface PromptCacheOptions {
+    enabled?: boolean;
+    ttl?: string;
+}
+/** A `cache_control` marker as Anthropic and its gateways accept it. */
+export interface CacheControlMarker {
+    type: "ephemeral";
+    ttl: CacheTtl;
+}
+export declare function cacheControl(ttl: CacheTtl): CacheControlMarker;
+/** The provider's model id, however the client exposes it. */
+export declare function modelIdOf(model: unknown): string;
+/**
+ * Pick the mechanism for `model`, with the same client/provider tests LangChain's
+ * middlewares apply, so a `*-native` strategy is exactly one that middleware acts on.
+ */
+export declare function resolveCacheStrategy(model: unknown, enabled: boolean): PromptCacheStrategy;
+/**
+ * The LangChain provider middleware for `strategy`, or `null` when none is
+ * needed. `minMessagesToCache: 1` because the prefix is large from the first
+ * call; `unsupportedModelBehavior: "ignore"` because the strategy was already
+ * reported through `onEvent`.
+ */
+export declare function createProviderCacheMiddleware(strategy: PromptCacheStrategy, ttl: CacheTtl): AgentMiddleware | null;
+/** The assembly-time diagnostic for an unsupported model. */
+export declare function unsupportedCacheMessage(model: unknown): string;
+/** Precedence host option → workflow spec → env → default (on, 5m). A bad `ttl` falls back rather than failing a run. */
+export declare function resolvePromptCacheConfig(sources: {
+    option?: PromptCacheOptions | undefined;
+    spec?: {
+        enabled?: boolean;
+        ttl?: string;
+    } | undefined;
+    env?: {
+        enabled?: boolean;
+        ttl?: string;
+    } | undefined;
+}): PromptCacheConfig;

package/dist/workflow/prompt-cache.js

@@ -0,0 +1,103 @@
+/**
+ * Provider prompt caching for the stable prompt prefix (tool schemas and the
+ * static system prompt, re-sent on every model call of a turn).
+ *
+ * LangChain owns the provider mechanics where it has them: a native
+ * `ChatAnthropic` or `ChatBedrockConverse` gets LangChain's own caching
+ * middleware. The one case with no built-in is the default — Claude reached
+ * through an OpenAI-compatible endpoint — where the workflow middleware places
+ * an explicit `cache_control` breakpoint on the static system block. Anything
+ * else is a no-op (OpenAI and Gemini cache prefixes automatically).
+ */
+import { anthropicPromptCachingMiddleware, bedrockPromptCachingMiddleware, } from "langchain";
+export const CACHE_TTLS = ["5m", "1h"];
+export const DEFAULT_CACHE_TTL = "5m";
+export function isCacheTtl(value) {
+    return typeof value === "string" && CACHE_TTLS.includes(value);
+}
+/**
+ * The strategies LangChain implements as graph-level provider middleware. They
+ * cannot vary per model call, which is why a state whose model wants a different
+ * one is reported at assembly rather than silently mis-cached.
+ */
+export const NATIVE_CACHE_STRATEGIES = new Set([
+    "anthropic-native",
+    "bedrock-native",
+]);
+export function cacheControl(ttl) {
+    return { type: "ephemeral", ttl };
+}
+function modelName(model) {
+    const named = model;
+    try {
+        return typeof named?.getName === "function" ? named.getName() : "";
+    }
+    catch {
+        return "";
+    }
+}
+/** The provider's model id, however the client exposes it. */
+export function modelIdOf(model) {
+    const candidate = model;
+    for (const value of [candidate?.model, candidate?.modelName, candidate?._defaultConfig?.model]) {
+        if (typeof value === "string" && value.trim())
+            return value;
+    }
+    return "";
+}
+const ANTHROPIC_MODEL_ID = /claude|anthropic/i;
+/** Bedrock caches only these model families (mirrors LangChain's own check). */
+const BEDROCK_CACHEABLE_ID = /anthropic\.claude|amazon\.nova/i;
+/**
+ * Pick the mechanism for `model`, with the same client/provider tests LangChain's
+ * middlewares apply, so a `*-native` strategy is exactly one that middleware acts on.
+ */
+export function resolveCacheStrategy(model, enabled) {
+    if (!enabled || !model)
+        return "off";
+    const name = modelName(model);
+    const provider = model?._defaultConfig
+        ?.modelProvider;
+    const id = modelIdOf(model);
+    if (name === "ChatAnthropic" || (name === "ConfigurableModel" && provider === "anthropic")) {
+        return "anthropic-native";
+    }
+    const isBedrock = name === "ChatBedrockConverse" ||
+        (name === "ConfigurableModel" && (provider === "bedrock" || provider === "aws"));
+    if (isBedrock)
+        return BEDROCK_CACHEABLE_ID.test(id) ? "bedrock-native" : "unsupported";
+    if (ANTHROPIC_MODEL_ID.test(id) || ANTHROPIC_MODEL_ID.test(name))
+        return "anthropic-compat";
+    return "unsupported";
+}
+/**
+ * The LangChain provider middleware for `strategy`, or `null` when none is
+ * needed. `minMessagesToCache: 1` because the prefix is large from the first
+ * call; `unsupportedModelBehavior: "ignore"` because the strategy was already
+ * reported through `onEvent`.
+ */
+export function createProviderCacheMiddleware(strategy, ttl) {
+    const options = { ttl, minMessagesToCache: 1, unsupportedModelBehavior: "ignore" };
+    if (strategy === "anthropic-native") {
+        return anthropicPromptCachingMiddleware(options);
+    }
+    if (strategy === "bedrock-native") {
+        return bedrockPromptCachingMiddleware(options);
+    }
+    return null;
+}
+/** The assembly-time diagnostic for an unsupported model. */
+export function unsupportedCacheMessage(model) {
+    const id = modelIdOf(model) || modelName(model) || "the configured model";
+    return (`prompt caching is inactive for '${id}': no cache-breakpoint mechanism is known for it ` +
+        `(supported: Anthropic natively or over an OpenAI-compatible endpoint, and Bedrock Converse ` +
+        `Claude/Nova). Providers with automatic prefix caching still benefit from the stable prefix.`);
+}
+/** Precedence host option → workflow spec → env → default (on, 5m). A bad `ttl` falls back rather than failing a run. */
+export function resolvePromptCacheConfig(sources) {
+    const { option, spec, env } = sources;
+    const enabled = option?.enabled ?? spec?.enabled ?? env?.enabled ?? true;
+    const ttlCandidate = option?.ttl ?? spec?.ttl ?? env?.ttl;
+    return { enabled, ttl: isCacheTtl(ttlCandidate) ? ttlCandidate : DEFAULT_CACHE_TTL };
+}
+//# sourceMappingURL=prompt-cache.js.map

package/dist/workflow/prompt-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.js","sourceRoot":"","sources":["../../src/workflow/prompt-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,gCAAgC,EAChC,8BAA8B,GAE/B,MAAM,WAAW,CAAC;AAEnB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC;AAGhD,MAAM,CAAC,MAAM,iBAAiB,GAAa,IAAI,CAAC;AAEhD,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxF,CAAC;AAcD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAqC,IAAI,GAAG,CAAC;IAC/E,kBAAkB;IAClB,gBAAgB;CACjB,CAAC,CAAC;AAkBH,MAAM,UAAU,YAAY,CAAC,GAAa;IACxC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,KAAK,GAAG,KAAmC,CAAC;IAClD,IAAI,CAAC;QACH,OAAO,OAAO,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,SAAS,GAAG,KAIjB,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC;QAC/F,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAC/C,gFAAgF;AAChF,MAAM,oBAAoB,GAAG,iCAAiC,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,OAAgB;IACnE,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAI,KAA0D,EAAE,cAAc;QAC1F,EAAE,aAAa,CAAC;IAClB,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAE5B,IAAI,IAAI,KAAK,eAAe,IAAI,CAAC,IAAI,KAAK,mBAAmB,IAAI,QAAQ,KAAK,WAAW,CAAC,EAAE,CAAC;QAC3F,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,MAAM,SAAS,GACb,IAAI,KAAK,qBAAqB;QAC9B,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC;IACnF,IAAI,SAAS;QAAE,OAAO,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC;IAEvF,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAC5F,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAA6B,EAC7B,GAAa;IAEb,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC,EAAE,wBAAwB,EAAE,QAAQ,EAAW,CAAC;IAC5F,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;QACpC,OAAO,gCAAgC,CAAC,OAAO,CAA+B,CAAC;IACjF,CAAC;IACD,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QAClC,OAAO,8BAA8B,CAAC,OAAO,CAA+B,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,sBAAsB,CAAC;IAC1E,OAAO,CACL,mCAAmC,EAAE,mDAAmD;QACxF,6FAA6F;QAC7F,6FAA6F,CAC9F,CAAC;AACJ,CAAC;AAED,yHAAyH;AACzH,MAAM,UAAU,wBAAwB,CAAC,OAIxC;IACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,IAAI,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;IACzE,MAAM,YAAY,GAAG,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC;IAC1D,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;AACvF,CAAC"}

package/dist/workflow/prompt-pruning.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pruning of upstream Deep Agents prompt guidance for built-in tools an
+ * assembly withholds: guidance for a tool the model cannot call only teaches it
+ * to try.
+ */
+/** The upstream headings that document `tool`'s guidance (empty when unknown). */
+export declare function upstreamSectionsFor(tool: string): readonly string[];
+export interface PruneResult {
+    /** The prompt text with matched sections removed. */
+    text: string;
+    /** Headings that were found and removed. */
+    removed: string[];
+    /**
+     * Tools whose guidance was found nowhere. A partial match is a successful
+     * prune (upstream may carry only some of a tool's sections).
+     */
+    missingTools?: string[];
+}
+/** Prune the upstream guidance for every tool in `undisclosed`; tools with no known sections are ignored. */
+export declare function pruneUndisclosedToolSections(text: string, undisclosed: readonly string[]): PruneResult;

package/dist/workflow/prompt-pruning.js

@@ -0,0 +1,83 @@
+/**
+ * Pruning of upstream Deep Agents prompt guidance for built-in tools an
+ * assembly withholds: guidance for a tool the model cannot call only teaches it
+ * to try.
+ */
+/**
+ * Upstream section headings owned by a built-in tool's guidance.
+ *
+ * `task`'s guidance is two sections, and both must be named: the spawner
+ * overview carries the bulk of it, and the notes section follows. A partial
+ * match counts as a successful prune, so listing only one of them silently ships
+ * the other.
+ */
+const SECTIONS_BY_TOOL = {
+    task: ["## `task` (subagent spawner)", "## Important Task Tool Usage Notes to Remember"],
+};
+/** The upstream headings that document `tool`'s guidance (empty when unknown). */
+export function upstreamSectionsFor(tool) {
+    return SECTIONS_BY_TOOL[tool] ?? [];
+}
+/** A section spans its heading line to the next heading of the same or higher level. */
+function sectionEnd(lines, start, level) {
+    for (let i = start + 1; i < lines.length; i++) {
+        const match = /^(#{1,6})\s/.exec(lines[i]);
+        if (match && match[1].length <= level)
+            return i;
+    }
+    return lines.length;
+}
+function headingLevel(heading) {
+    return /^(#{1,6})\s/.exec(heading)?.[1].length ?? 2;
+}
+/**
+ * Put a target heading on its own line when composition glued it to the end of
+ * the previous one.
+ *
+ * Upstream concatenates its prompt fragments without a separating newline, so a
+ * section can arrive as `…within files## \`task\` (subagent spawner)`. Matching is
+ * line-anchored (a `##` mid-sentence is prose, not a heading), so without this
+ * the section is silently kept and billed on every call. Narrow by construction:
+ * only a heading we were asked to remove is ever split out.
+ */
+function unglueHeadings(text, headings) {
+    let out = text;
+    for (const heading of headings) {
+        let at = out.indexOf(heading);
+        while (at > 0) {
+            if (out[at - 1] !== "\n") {
+                out = `${out.slice(0, at)}\n${out.slice(at)}`;
+                at += 1;
+            }
+            at = out.indexOf(heading, at + heading.length);
+        }
+    }
+    return out;
+}
+/** Remove each heading's section. Matching is exact on the trimmed heading line. */
+function pruneSections(text, headings) {
+    if (!text || headings.length === 0)
+        return { text, removed: [] };
+    const removed = [];
+    let lines = unglueHeadings(text, headings).split("\n");
+    for (const heading of headings) {
+        const index = lines.findIndex((line) => line.trim() === heading);
+        if (index === -1)
+            continue;
+        const end = sectionEnd(lines, index, headingLevel(heading));
+        lines = [...lines.slice(0, index), ...lines.slice(end)];
+        removed.push(heading);
+    }
+    // Collapse the blank runs left behind so the result is byte-stable however many sections were cut.
+    return { text: lines.join("\n").replace(/\n{3,}/g, "\n\n").trim(), removed };
+}
+/** Prune the upstream guidance for every tool in `undisclosed`; tools with no known sections are ignored. */
+export function pruneUndisclosedToolSections(text, undisclosed) {
+    const result = pruneSections(text, undisclosed.flatMap((tool) => [...upstreamSectionsFor(tool)]));
+    const missingTools = undisclosed.filter((tool) => {
+        const owned = upstreamSectionsFor(tool);
+        return owned.length > 0 && !owned.some((heading) => result.removed.includes(heading));
+    });
+    return { ...result, ...(missingTools.length > 0 ? { missingTools } : {}) };
+}
+//# sourceMappingURL=prompt-pruning.js.map

package/dist/workflow/prompt-pruning.js.map

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

package/dist/workflow/render-prompt.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Deterministic rendering of the two spec-derived prompt sections, both pure
+ * functions of the machine, so what the agent reads cannot drift from what the
+ * runtime enforces.
+ *
+ * The graph is disclosed the way the tool surface is — only from where the agent
+ * stands — which puts the two halves on opposite sides of the cache boundary:
+ *
+ *  - {@link renderWorkflowPrompt} is the **cacheable** half: the workflow's
+ *    `title` and root `instructions`, and no state of the graph. It is a
+ *    function of the header alone, so the prefix does not grow with the state
+ *    count. Authored `WORKFLOW.md` prose is appended after it by the caller.
+ *  - {@link renderStateGraph} is the **volatile** half, re-rendered per model
+ *    call for the state in force: its outgoing edges, its own markers and hooks,
+ *    and the run's trigger signature.
+ *
+ * No other state's slug, `title`, `summary`, hooks, budget or transitions is
+ * rendered anywhere, and neither is a count of the states: a state the agent
+ * cannot advance to is a state it cannot name. A state's `instructions` body is
+ * surfaced only for the active state, by the caller.
+ */
+import type { WorkflowMachine } from "../machine/machine.js";
+/** What {@link renderStateGraph} needs about the run, beyond the state it is in. */
+export interface StateGraphContext {
+    /** The id of the trigger this session was started by, when one is recorded. */
+    trigger?: string;
+}
+/**
+ * The active state's half of the graph: its hooks, the run's trigger signature,
+ * and either its outgoing edges or the statement that it has none.
+ *
+ * Terminality is stated rather than left to be inferred from an absent list —
+ * the old whole-graph section taught "a state listed with no transitions is
+ * terminal", and with the listing gone there is nothing to read that from.
+ * Returns `null` when the state discloses nothing at all.
+ */
+export declare function renderStateGraph(machine: WorkflowMachine, state: string, ctx?: StateGraphContext): string | null;
+/**
+ * The cacheable half: the workflow's `title` and its root `instructions`. No
+ * state is named — see the module docstring for why, and
+ * {@link renderStateGraph} for what the agent is told instead.
+ */
+export declare function renderWorkflowPrompt(machine: WorkflowMachine): string;
+/** Strip HTML comments from authored prose; the model would be charged for them on every call. */
+export declare function stripHtmlComments(text: string): string;

package/dist/workflow/render-prompt.js

@@ -0,0 +1,140 @@
+/**
+ * Deterministic rendering of the two spec-derived prompt sections, both pure
+ * functions of the machine, so what the agent reads cannot drift from what the
+ * runtime enforces.
+ *
+ * The graph is disclosed the way the tool surface is — only from where the agent
+ * stands — which puts the two halves on opposite sides of the cache boundary:
+ *
+ *  - {@link renderWorkflowPrompt} is the **cacheable** half: the workflow's
+ *    `title` and root `instructions`, and no state of the graph. It is a
+ *    function of the header alone, so the prefix does not grow with the state
+ *    count. Authored `WORKFLOW.md` prose is appended after it by the caller.
+ *  - {@link renderStateGraph} is the **volatile** half, re-rendered per model
+ *    call for the state in force: its outgoing edges, its own markers and hooks,
+ *    and the run's trigger signature.
+ *
+ * No other state's slug, `title`, `summary`, hooks, budget or transitions is
+ * rendered anywhere, and neither is a count of the states: a state the agent
+ * cannot advance to is a state it cannot name. A state's `instructions` body is
+ * surfaced only for the active state, by the caller.
+ */
+import { afterHookLabel, hookKind, normalizeHooks } from "../lifecycle/hook-shape.js";
+import { ADVANCE_TOOL, SET_VARIABLES_TOOL } from "../machine/tool-names.js";
+/**
+ * One outgoing edge: the target's slug (the exact token `archmax_advance` takes),
+ * its declared `type`, and the required `description` the agent routes on.
+ *
+ * The two markers a target may carry are disclosed because each changes what the
+ * call must carry or what follows it — `evidence` is accepted only when the
+ * target is a human state, and both markers mean *stop* rather than *continue*.
+ * They disclose the **consequence of taking the edge**, not the state on the
+ * other side of it: nothing of the target's own title, summary, instructions,
+ * hooks or transitions is rendered.
+ */
+function renderTransition(machine, edge) {
+    const notes = [];
+    if (edge.type && edge.type !== "none")
+        notes.push(edge.type);
+    if (machine.isHumanState(edge.to))
+        notes.push("human decision node");
+    if (machine.isTerminal(edge.to))
+        notes.push("terminal");
+    const suffix = notes.length ? ` (${notes.join(", ")})` : "";
+    return `- to \`${edge.to}\`${suffix} — ${edge.description.trim()}`;
+}
+/**
+ * The active state's hooks, by phase. A **rubric** hook renders as its bare kind
+ * — never the rubric's name, and never any of its declaration.
+ *
+ * Presence is disclosed because it is actionable: a graded exit can come back
+ * with a correction the agent must act on. Identity is withheld because it is
+ * not: no disclosed tool takes a rubric name, and the name is a handle into
+ * content the agent may not read. Nothing here can reach the criteria, the
+ * budget or the model — they live in a block this renderer never reads.
+ */
+function renderHooks(state) {
+    const parts = [];
+    for (const phase of ["before", "after"]) {
+        const hooks = normalizeHooks(state[phase]);
+        if (hooks.length === 0)
+            continue;
+        const labels = hooks.map((hook, index) => hookKind(hook) === "rubric" ? "rubric" : afterHookLabel(hook, index));
+        parts.push(`${phase}: ${labels.join(", ")}`);
+    }
+    return parts.length ? parts.join("; ") : null;
+}
+/**
+ * The signature of the trigger this run was started by — and only that one. The
+ * triggers of states this run did not enter are not disclosed, and the id needs
+ * no label: there is one trigger and it is this run's.
+ */
+function renderSignature(machine, trigger) {
+    if (!trigger)
+        return [];
+    const lines = [];
+    const requires = machine.requiresForTrigger(trigger) ?? [];
+    const returns = machine.returnsForTrigger(trigger) ?? [];
+    if (requires.length > 0) {
+        lines.push(`This run was started with: ${requires.join(", ")}.`);
+    }
+    if (returns.length > 0) {
+        lines.push(`This run must set ${returns.join(", ")} with \`${SET_VARIABLES_TOOL}\` — it does not ` +
+            `complete until every one is set.`);
+    }
+    return lines;
+}
+/**
+ * The active state's half of the graph: its hooks, the run's trigger signature,
+ * and either its outgoing edges or the statement that it has none.
+ *
+ * Terminality is stated rather than left to be inferred from an absent list —
+ * the old whole-graph section taught "a state listed with no transitions is
+ * terminal", and with the listing gone there is nothing to read that from.
+ * Returns `null` when the state discloses nothing at all.
+ */
+export function renderStateGraph(machine, state, ctx = {}) {
+    const declared = machine.spec.states[state];
+    if (!declared)
+        return null;
+    const sections = [];
+    const hooks = renderHooks(declared);
+    if (hooks)
+        sections.push(`Hooks: ${hooks}`);
+    sections.push(...renderSignature(machine, ctx.trigger));
+    const transitions = declared.transitions ?? [];
+    sections.push(transitions.length > 0
+        ? [
+            `Transitions — choose one with \`${ADVANCE_TOOL}\` when this state's work is done:`,
+            ...transitions.map((edge) => renderTransition(machine, edge)),
+        ].join("\n")
+        : `This state is terminal: no transition leads out of it. Finish its work and stop.`);
+    return sections.length > 0 ? sections.join("\n\n") : null;
+}
+/**
+ * The cacheable half: the workflow's `title` and its root `instructions`. No
+ * state is named — see the module docstring for why, and
+ * {@link renderStateGraph} for what the agent is told instead.
+ */
+export function renderWorkflowPrompt(machine) {
+    const { spec } = machine;
+    const lines = [];
+    const title = spec.title?.trim();
+    lines.push(`# Workflow${title ? `: ${title}` : ""}`);
+    // Standing instructions apply to every turn, so they belong in the static, cacheable prefix.
+    if (spec.instructions?.trim()) {
+        lines.push("", "## Instructions", "", spec.instructions.trim());
+    }
+    return lines.join("\n");
+}
+/** Strip HTML comments from authored prose; the model would be charged for them on every call. */
+export function stripHtmlComments(text) {
+    if (!text.includes("<!--"))
+        return text;
+    return text
+        .replace(/<!--[\s\S]*?-->/g, "")
+        .replace(/[ \t]+$/gm, "")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+//# sourceMappingURL=render-prompt.js.map

package/dist/workflow/render-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-prompt.js","sourceRoot":"","sources":["../../src/workflow/render-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG5E;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CAAC,OAAwB,EAAE,IAAuB;IACzE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,OAAO,UAAU,IAAI,CAAC,EAAE,KAAK,MAAM,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,KAAmB;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAU,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACvC,QAAQ,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CACrE,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,OAAwB,EAAE,OAA2B;IAC5E,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACzD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,8BAA8B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,kBAAkB,mBAAmB;YACrF,kCAAkC,CACrC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAQD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAwB,EACxB,KAAa,EACb,MAAyB,EAAE;IAE3B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAExD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/C,QAAQ,CAAC,IAAI,CACX,WAAW,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC;YACE,mCAAmC,YAAY,oCAAoC;YACnF,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;SAC9D,CAAC,IAAI,CAAC,IAAI,CAAC;QACd,CAAC,CAAC,kFAAkF,CACvF,CAAC;IAEF,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,6FAA6F;IAC7F,IAAI,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,IAAI;SACR,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/workflow/runtime-config.d.ts

@@ -0,0 +1,7 @@
+import type { RunnableConfig } from "@langchain/core/runnables";
+/** The runnable config a hook's or request's runtime stands for. */
+export declare function buildRunnableConfig(runtime: {
+    configurable?: Record<string, unknown>;
+    signal?: AbortSignal;
+    store?: unknown;
+}): RunnableConfig;

package/dist/workflow/runtime-config.js

@@ -0,0 +1,9 @@
+/** The runnable config a hook's or request's runtime stands for. */
+export function buildRunnableConfig(runtime) {
+    return {
+        configurable: runtime?.configurable ?? {},
+        signal: runtime?.signal,
+        ...(runtime?.store !== undefined ? { store: runtime.store } : {}),
+    };
+}
+//# sourceMappingURL=runtime-config.js.map

package/dist/workflow/runtime-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.js","sourceRoot":"","sources":["../../src/workflow/runtime-config.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,MAAM,UAAU,mBAAmB,CAAC,OAInC;IACC,OAAO;QACL,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,EAAE;QACzC,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,GAAG,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC"}