@archmax-ai/harness 0.0.0

package/dist/assembly/delegation-registry.js

@@ -0,0 +1,118 @@
+/**
+ * Child compositions, composed lazily and memoized by workflow slug **and
+ * delegation chain**: the denials a child inherits are every ancestor's, so the
+ * same slug reached through two different callers is two compositions.
+ *
+ * Lazy so a workflow nothing delegates to costs nothing; memoized on the
+ * **promise** so concurrent dispatches of one slug under one chain compose it
+ * once. Every failure here is a *dispatch* failure, never an assembly failure: a
+ * parent must still assemble when a workflow it might delegate to is broken.
+ */
+import { loadMachineSpec } from "../machine/load-spec.js";
+import { WorkflowMachine } from "../machine/machine.js";
+import { MANUAL_TRIGGER } from "../machine/triggers.js";
+import { workflowPaths } from "../workflow/paths.js";
+import { SubWorkflowError, } from "../workflow/sub-workflow.js";
+import { rubricsAsSubagents, rubricsFromSpec } from "../rubrics/rubrics.js";
+import { composeGoverned, inheritedDenials, renderSystemPrompt } from "./compose.js";
+/** Build the registry the root composition and every child dispatch through. */
+export function createDelegationRegistry(ctx, root) {
+    const composed = new Map();
+    /**
+     * The child's *machine*, without its agent, so a dispatch can be refused on
+     * the target's `requires` for the price of a spec read. Shared with
+     * `resolve`, so an accepted dispatch never loads the spec twice.
+     */
+    const loads = new Map();
+    function load(target) {
+        let loading = loads.get(target);
+        if (!loading) {
+            // A failed load is not cached: a spec fixed between dispatches should be
+            // picked up rather than remembered as broken forever.
+            loading = loadSpec(target).catch((err) => {
+                loads.delete(target);
+                throw err;
+            });
+            loads.set(target, loading);
+        }
+        return loading;
+    }
+    async function loadSpec(target) {
+        const paths = workflowPaths(target);
+        const loaded = await loadMachineSpec(ctx.authoring, paths);
+        if (!loaded.usable || !loaded.spec) {
+            const detail = loaded.issues.some((i) => i.kind === "missing")
+                ? `no '${paths.workflowYaml}' found`
+                : loaded.issues.map((i) => i.message).join("; ") || "no valid machine spec";
+            throw new SubWorkflowError("unknown-workflow", target, `Cannot run sub-workflow '${target}': ${detail}.`);
+        }
+        // Rubrics are deliberately *not* inherited: a child is graded by the
+        // standards its own spec declares, so its registry comes from `loaded.spec`
+        // when the child runtime is composed, never from the caller's.
+        const machine = WorkflowMachine.fromSpec(loaded.spec, ctx.params.essentialTools);
+        // A caller enters where a host would: the `manual` entry. A machine with
+        // none cannot be started at all (fail-closed, as at the host ingress).
+        if (!machine.startStateForTrigger(MANUAL_TRIGGER)) {
+            throw new SubWorkflowError("not-delegatable", target, `Cannot run sub-workflow '${target}': it declares no '${MANUAL_TRIGGER}' trigger ` +
+                `entry, so it has no state to start in. Add ` +
+                `"trigger: ${MANUAL_TRIGGER}" to the state a session should start in.`);
+        }
+        return { body: loaded.body, machine };
+    }
+    async function compose(target, caller) {
+        const { body, machine } = await load(target);
+        const systemPrompt = await renderSystemPrompt(ctx, machine, body, { workflow: target });
+        // The child's graders are its own: a rubric declared in one `workflow.yaml`
+        // is not resolvable from another, so a sub-run is held to the standards its
+        // own machine declares — and its `task` tool is registered with those.
+        const rubrics = rubricsFromSpec(machine.spec);
+        const childCtx = {
+            ...ctx,
+            rubrics,
+            subagents: rubricsAsSubagents(rubrics, ctx.rubricModel),
+        };
+        const child = await composeGoverned(childCtx, {
+            machine,
+            workflow: target,
+            systemPrompt,
+            trigger: { id: MANUAL_TRIGGER },
+            // Denials compose downward and accumulate: the caller hands down what it
+            // inherited plus its own policy, so the child may narrow what is permitted
+            // but never re-grant what any ancestor forbade. A caller-less resolve (a
+            // direct child of the root) inherits the root's alone.
+            inheritedPolicyRules: caller?.inheritedPolicyRules ?? inheritedDenials(ctx, root),
+            registry,
+        });
+        // A child is driven exactly as the top-level agent drives itself: through
+        // its turn runner, which binds the child's own session and streams its text.
+        return { graph: { invoke: child.driver.invoke }, machine };
+    }
+    const registry = {
+        resolve(target, caller) {
+            const key = [...(caller?.chain ?? []), target].join(" > ");
+            let composing = composed.get(key);
+            if (!composing) {
+                composing = compose(target, caller).catch((err) => {
+                    composed.delete(key);
+                    throw err;
+                });
+                composed.set(key, composing);
+            }
+            return composing;
+        },
+        async signature(target) {
+            const { machine } = await load(target);
+            const title = machine.spec.title?.trim();
+            return {
+                requires: machine.requiresForTrigger(MANUAL_TRIGGER),
+                returns: machine.returnsForTrigger(MANUAL_TRIGGER),
+                ...(title ? { title } : {}),
+                // Reported, not enforced here: a disabled target still binds a tool so
+                // disabling a leaf does not fail every caller; the dispatcher refuses.
+                ...(machine.disabled ? { disabled: true } : {}),
+            };
+        },
+    };
+    return registry;
+}
+//# sourceMappingURL=delegation-registry.js.map

package/dist/assembly/delegation-registry.js.map

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

package/dist/assembly/index.d.ts

@@ -0,0 +1,192 @@
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { StructuredTool } from "@langchain/core/tools";
+import type { BaseCheckpointSaver } from "@langchain/langgraph";
+import type { AgentMiddleware } from "langchain";
+import type { BackendProtocolV2, CreateDeepAgentParams } from "deepagents";
+import { type Agent } from "../agent.js";
+import { type WorkflowEventHandler } from "../core/events.js";
+import type { MountSpec } from "../core/mounts.js";
+import type { SessionStore } from "../core/session-store.js";
+import { type PricingTable } from "../core/usage.js";
+import { type ModelFactory } from "../env.js";
+import type { GovernanceRule } from "../kernel/kernel.js";
+import type { HookExecutor } from "../lifecycle/runner.js";
+import { type TriggerInput } from "../machine/triggers.js";
+import type { SandboxRuntime } from "../sandbox/runtime.js";
+import type { PromptCacheOptions } from "../workflow/prompt-cache.js";
+/**
+ * Workspace composition, grouped. `rootDir`, `mounts` and `sessionStore` all
+ * answer one question — where this agent's files come from and where its
+ * sessions go — and none of them exists in Deep Agents.
+ */
+export interface AgentWorkspaceParams {
+    /**
+     * Agent workspace root used by the default filesystem backend. Defaults to
+     * the consumer's current working directory (the repository's
+     * `examples/customer-support` is the reference workspace).
+     */
+    rootDir?: string;
+    /**
+     * Authored mounts as a `CompositeBackend` route table: key → backend, or
+     * `{ backend, readOnly }`. A key ending in `/` is a directory mount; a key
+     * without one (`"/AGENTS.md"`) is an exact-path file mount. Mounts are
+     * read-only unless declared otherwise. Omitted on the default filesystem
+     * backend, `defaultMounts(rootDir)` is applied — a convention, not a
+     * constraint; spread it to extend. Omitted with a custom `backend`, nothing
+     * authored is served: exposing it is an explicit act
+     * (`mountSubtree(backend, "skills")`).
+     */
+    mounts?: Record<string, MountSpec>;
+    /**
+     * Physical storage for sessions — checkpoints, artifacts, scratchpad and
+     * offloaded context. Build one with `createFilesystemSessionStore({ dir })`,
+     * `createBackendSessionStore({ backend, prefix? })` or
+     * `createMemorySessionStore()`. With the default backend this defaults to a
+     * filesystem store at `<rootDir>/sessions`; with a custom `backend` it is
+     * required — assembly throws `SessionStoreRequiredError` rather than inferring
+     * storage.
+     */
+    sessionStore?: SessionStore;
+}
+/**
+ * Parameters for {@link createAgent}.
+ *
+ * Every concept shared with LangChain Deep Agents keeps **Deep Agents' own name
+ * and meaning** — `model`, `tools`, `systemPrompt`, `middleware`,
+ * `backend`, `skills`, `checkpointer`, `store`, `interruptOn`, `name` — so a
+ * `createDeepAgent` call ports by changing only the import, with one recorded
+ * exception: there is no `subagents` parameter. An agent-facing subagent is not
+ * a concept the archmax harness offers — grading is a **rubric** declared in `workflow.yaml`
+ * and delegating work is a **sub-workflow** — so `task` is disclosed to no
+ * state. The harness's concerns are otherwise strictly additive: `workflow`
+ * (governance), `workspace` (file composition), `authoring` (the
+ * governance-plane backend), and the extension points below.
+ */
+export interface CreateAgentParams {
+    /** Chat model; defaults to the env-configured OpenAI-compatible model. */
+    model?: BaseChatModel;
+    /**
+     * Extra tools bound to the agent alongside the built-in sandbox and control
+     * tools — e.g. resolved connector/MCP capabilities (see `toolsFromMap`).
+     * Workflow governance still gates which of these the agent may call at any
+     * given point; this only makes them exist as invokable functions.
+     */
+    tools?: StructuredTool[];
+    /** Appended after the workspace's `AGENTS.md` in the system prompt. */
+    systemPrompt?: string;
+    /** Extra middleware appended after the runtime's own — the workflow instrumentation when governed (e.g. test mocks). Honoured on both paths. */
+    middleware?: AgentMiddleware[];
+    /**
+     * Declares that authored content comes from somewhere other than the local
+     * filesystem root — a store, sandbox, or remote Deep Agents backend. This
+     * backend reaches the workspace only through `workspace.mounts`, and its
+     * presence withdraws every zero-config default, so `workspace.sessionStore`
+     * becomes required.
+     */
+    backend?: BackendProtocolV2;
+    /**
+     * Where the workspace's skills live, as **sources** read through the backend
+     * — a parent directory of bundles (`"skills/"`) or a single bundle. Defaults
+     * to `DEFAULT_SKILL_SOURCES` (`["skills/"]`). Pass `[]` for a workspace with
+     * no skills.
+     */
+    skills?: string[];
+    /**
+     * LangGraph checkpointer — the custom-adapter escape hatch. Defaults to a
+     * `BackendCheckpointSaver` that persists each session durably through the
+     * session store (`<sessionId>/checkpoints/`), so sessions survive restarts
+     * and can be listed and resumed. Supply a `MemorySaver` for ephemeral runs.
+     */
+    checkpointer?: BaseCheckpointSaver;
+    /** LangGraph store, passed through to the framework untouched. */
+    store?: CreateDeepAgentParams["store"];
+    /**
+     * Framework-level interrupt configuration, passed through untouched. Distinct
+     * from a workflow `type: human` state, which parks through the machine.
+     */
+    interruptOn?: CreateDeepAgentParams["interruptOn"];
+    /** Agent name, passed through for tracing and display. */
+    name?: string;
+    /** Human-readable description, passed through to graph compilation. */
+    description?: string;
+    /**
+     * The governance layer: a named workflow under `workflows/<slug>/`. Omit it
+     * and the result is a plain Deep Agent — no machine, no `archmax_advance`, no
+     * per-state gating — and `agent.workflow` is `undefined`. A named workflow
+     * with no loadable spec throws {@link WorkflowLoadError} rather than silently
+     * returning an ungoverned agent.
+     *
+     * Omitted, the default workflow (`DEFAULT_WORKFLOW`) is still *looked for* on
+     * the authoring backend, and governs the agent when found. Pass `false` for an
+     * agent that is ungoverned **by declaration**: no spec is read and no rubric
+     * discovered, so a stray `workflows/` tree under the resolved root cannot
+     * govern it.
+     */
+    workflow?: string | false;
+    /** Where files come from and where sessions go. See {@link AgentWorkspaceParams}. */
+    workspace?: AgentWorkspaceParams;
+    /**
+     * Backend serving the **authored governance plane** — machine specs,
+     * `WORKFLOW.md` prose, lifecycle hook scripts, and cases. The agent's
+     * workspace composite has no route to them. Defaults to `backend` when one is
+     * supplied, else a filesystem backend over the resolved root. Handing it to a
+     * *writable* mount fails assembly (`AuthoringPlaneExposedError`).
+     */
+    authoring?: BackendProtocolV2;
+    /** How a session is started when a turn names no trigger. Defaults to `{ id: "manual" }`. */
+    trigger?: TriggerInput;
+    /**
+     * Variables seeded before any turn, keyed by name. Every seed is **locked**:
+     * a host-supplied fact is exactly what a `${{name}}` guard should bind to. The
+     * same seeds a delivery carries, the CLI takes (`--variables`) and a delegation
+     * hands a child — one concept, one name.
+     */
+    variables?: Record<string, unknown>;
+    /**
+     * Where a firing's session id lives, as a dotted path over the variables
+     * (`triggers.-1.conversationId`) — the same form a `triggers` entry declares,
+     * applied to every firing this assembly resolves.
+     */
+    sessionPath?: string;
+    /**
+     * Supplies the chat model per role (`agent`, `judge`, `subagent`) so the
+     * runtime can run against any LangChain `BaseChatModel`. When both `model`
+     * and `modelFactory` are given, `model` wins for the agent role.
+     */
+    modelFactory?: ModelFactory;
+    /**
+     * Tool names to treat as always-on: disclosed and permitted in every state,
+     * like the file tools. A per-state `tools.allow` entry naming one still
+     * narrows it, and the safety/policy rules still bind.
+     */
+    essentialTools?: string[];
+    /**
+     * Custom governance rules inserted after the non-overridable safety rules and
+     * the workflow `policy` rules, before the per-state `allow` defaults. A custom
+     * rule may block a call a state would permit; it cannot loosen a safety rule.
+     */
+    policyRules?: GovernanceRule[];
+    /**
+     * Custom lifecycle hook-kind executors, registered alongside `script` and
+     * `subagent`. Registering one under a built-in kind fails assembly.
+     */
+    hookExecutors?: Record<string, HookExecutor>;
+    /** Script-execution backend for the sandbox tools and lifecycle scripts. Defaults to QuickJS. */
+    sandboxRuntime?: SandboxRuntime;
+    /**
+     * Lifecycle event subscriber. When supplied, every runtime diagnostic is
+     * delivered here as a typed event and the runtime writes nothing to the
+     * console; when omitted, a default console subscriber renders them.
+     */
+    onEvent?: WorkflowEventHandler;
+    /** Provider prompt caching for the stable prompt prefix (on by default, 5-minute lifetime). */
+    promptCache?: PromptCacheOptions;
+    /**
+     * Token prices in USD per 1M tokens, keyed by model id (`default` applies to
+     * any). Makes `costUsd` appear on usage events, in artifacts and in the CLI
+     * footer; without pricing, cost is omitted — never guessed.
+     */
+    pricing?: PricingTable;
+}
+/** Assemble an agent. See the module note. */
+export declare function createAgent(params?: CreateAgentParams): Promise<Agent>;

package/dist/assembly/index.js

@@ -0,0 +1,265 @@
+/**
+ * Assembly: `createAgent` and its parameters.
+ *
+ * Takes Deep Agents' parameters verbatim and adds `workflow`: omit it for a
+ * plain Deep Agent, supply it and the same agent is governed by that machine.
+ * Every file the assembly reads — machine spec, system prompt, hook scripts,
+ * scripts — is served through a configured backend, never via direct `fs`, and
+ * the authored governance plane is served by a *separate* backend the agent's
+ * workspace has no route to.
+ */
+import { randomUUID } from "node:crypto";
+import { mergeConfigs } from "@langchain/core/runnables";
+import { AGENT_DEFAULT_CONFIG, ArchmaxAgent, } from "../agent.js";
+import { consoleEventHandler, createWorkflowEventEmitter } from "../core/events.js";
+import { DEFAULT_SKILL_SOURCES, discoverSkills, skillPrefixes } from "../core/skills.js";
+import { createUsageTracker } from "../core/usage.js";
+import { createWorkspaceContext } from "../core/workspace-context.js";
+import { createChatModel, loadDotenv, loadEnv, loadPricingEnv, } from "../env.js";
+import { loadMachineSpec, WorkflowDisabledError, WorkflowLoadError, } from "../machine/load-spec.js";
+import { WorkflowMachine } from "../machine/machine.js";
+import { assertNoReservedToolNames } from "../machine/tool-names.js";
+import { DEFAULT_TRIGGER_ID, resolveTrigger } from "../machine/triggers.js";
+import { buildSeededVariables } from "../machine/variables.js";
+import { isRuntimeContractSupported, resolveRuntimeContract, UnsupportedRuntimeContractError, } from "../runtime/contract.js";
+import { rubricsAsSubagents, rubricsFromSpec } from "../rubrics/rubrics.js";
+import { createArtifactEmitter, createSessionOperations, createSpecSnapshotReader, } from "../sessions/operations.js";
+import { resolveSession } from "../sessions/resolve.js";
+import { decide, deliver, EmptyMessageError, outcomeOf, reply, resume, settle } from "../sessions/resume.js";
+import { BackendCheckpointSaver } from "../workflow/checkpointer.js";
+import { DEFAULT_WORKFLOW, workflowPaths } from "../workflow/paths.js";
+import { createPlainTurnRunner } from "../workflow/turn-runner.js";
+import { composeGoverned, renderSystemPrompt, sessionBinder } from "./compose.js";
+import { createDelegationRegistry } from "./delegation-registry.js";
+import { composePlain } from "./plain.js";
+/** Assemble an agent. See the module note. */
+export async function createAgent(params = {}) {
+    const workspaceParams = params.workspace ?? {};
+    loadDotenv(workspaceParams.rootDir);
+    // The namespace is a guarantee, not a convention: a host tool wearing it is
+    // refused before anything is assembled, on both paths.
+    assertNoReservedToolNames(params.tools);
+    // `false` declares the agent ungoverned: nothing is looked for. Otherwise a
+    // named workflow — or the default — is read off the authoring backend.
+    const governed = params.workflow !== false;
+    const workflowName = params.workflow === false ? "" : (params.workflow ?? DEFAULT_WORKFLOW);
+    const paths = workflowPaths(workflowName);
+    // Root resolution and backend selection (session store as the workspace root +
+    // read-only authored mounts) are the shared context's. A custom backend without a session store fails here.
+    const { backend, workspace, authoring, sessionZone, sessionStore, mountPrefixes } = createWorkspaceContext({
+        rootDir: workspaceParams.rootDir,
+        backend: params.backend,
+        ...(workspaceParams.mounts ? { mounts: workspaceParams.mounts } : {}),
+        ...(workspaceParams.sessionStore ? { sessionStore: workspaceParams.sessionStore } : {}),
+        ...(params.authoring ? { authoring: params.authoring } : {}),
+    });
+    // Sessions are durable by default: the checkpointer writes through the
+    // session zone, so a session survives restarts and can be listed and resumed.
+    const checkpointer = params.checkpointer ?? new BackendCheckpointSaver(workspace);
+    // The usage tracker sits in the event chain so a session's totals are known
+    // where artifacts are written; every event still reaches `onEvent` (or the
+    // console).
+    const usage = createUsageTracker({ onEvent: params.onEvent ?? consoleEventHandler });
+    const emit = createWorkflowEventEmitter((event) => usage.handler(event));
+    // Load the machine spec once from workflow.yaml (the sole spec source).
+    const loaded = governed
+        ? await loadMachineSpec(authoring, paths)
+        : { spec: null, issues: [], lint: [], body: "", specFile: paths.workflowYaml, usable: false };
+    for (const issue of [...loaded.issues, ...loaded.lint]) {
+        if (issue.kind !== "missing")
+            emit({ type: "warning", scope: "workflow", message: issue.message });
+    }
+    // Grading rubrics come from the spec that was just loaded — no directory to
+    // list, no file format to parse, and nothing to merge: a grader is declared on
+    // the hook that applies it, so it arrives with the machine and is scoped to it.
+    const rubrics = rubricsFromSpec(loaded.spec ?? { states: {} });
+    // Skills are discovered once; the resolved registry is the single input to
+    // what the kernel refuses, what the prompt names, and what a listing returns.
+    const skillSources = params.skills ?? [...DEFAULT_SKILL_SOURCES];
+    const skillRegistry = await discoverSkills(workspace, skillSources, emit);
+    const machine = loaded.usable && loaded.spec
+        ? WorkflowMachine.fromSpec(loaded.spec, params.essentialTools)
+        : null;
+    // Fail closed when governance was requested but cannot be loaded. The plain
+    // agent remains for the unrequested-default case with no definition, and for
+    // `workflow: false`.
+    if (!machine && governed) {
+        const fileMissing = loaded.issues.some((i) => i.kind === "missing");
+        if (!fileMissing)
+            throw new WorkflowLoadError(workflowName, loaded.specFile, "no valid machine spec");
+        if (params.workflow !== undefined) {
+            throw new WorkflowLoadError(workflowName, paths.workflowYaml, "no workflow.yaml found");
+        }
+    }
+    // Enforce the runtime contract before any model-driven work.
+    const runtimeContract = resolveRuntimeContract(machine?.spec.runtime);
+    if (machine && !isRuntimeContractSupported(runtimeContract)) {
+        throw new UnsupportedRuntimeContractError(runtimeContract);
+    }
+    // Models per role. `env` is a thunk, so `.env` variables are required only by
+    // what actually reads them: a caller supplying an explicit `model` never loads it.
+    let cachedEnv;
+    const env = () => (cachedEnv ??= loadEnv());
+    const model = params.model ?? (params.modelFactory ? params.modelFactory("agent", env) : createChatModel());
+    // The model a *state* runs on: a workflow may name an id at either position
+    // (`settings.model`, a state's `model`), resolved through the same factory seam
+    // as every other model and memoized per distinct id, so one model is built per
+    // id per assembly however many turns run on it.
+    //
+    // An explicit `model` outranks every declared id: a host that constructed an
+    // instance means it, and the SDK cannot rebuild that instance under another id
+    // without guessing at its provider. The composition says so once (see
+    // `resolveStateModels`) rather than ignoring the declaration in silence.
+    const agentModels = new Map([["", model]]);
+    const agentModel = (id) => {
+        const key = params.model !== undefined ? "" : (id ?? "");
+        let resolved = agentModels.get(key);
+        if (!resolved) {
+            resolved = params.modelFactory
+                ? params.modelFactory("agent", env, key)
+                : createChatModel({ ...env(), model: key });
+            agentModels.set(key, resolved);
+        }
+        return resolved;
+    };
+    // Pricing feeds `costUsd` on usage events (host option first, then env).
+    const pricing = params.pricing ?? loadPricingEnv();
+    // The grader's model: a rubric may name its own id, resolved through the same
+    // factory seam as every other model, and memoized per distinct id so one model
+    // is built per id per assembly.
+    const rubricModels = new Map();
+    const rubricModel = (rubric) => {
+        const key = rubric.model ?? "";
+        if (!rubricModels.has(key)) {
+            rubricModels.set(key, params.modelFactory
+                ? params.modelFactory("rubric", env, rubric.model)
+                : rubric.model !== undefined
+                    ? createChatModel({ ...env(), model: rubric.model })
+                    : undefined);
+        }
+        return rubricModels.get(key);
+    };
+    const ctx = {
+        params,
+        workflowName,
+        workspace,
+        authoring,
+        backend,
+        sessionZone,
+        sessionStore,
+        mountPrefixes,
+        checkpointer,
+        emit,
+        usage,
+        model,
+        agentModel,
+        honoursDeclaredModels: params.model === undefined,
+        rubrics,
+        rubricModel,
+        subagents: rubricsAsSubagents(rubrics, rubricModel),
+        skillSources,
+        skillRegistry,
+        skillTable: skillPrefixes(skillRegistry),
+        runtimeContract,
+        ...(pricing ? { pricing } : {}),
+    };
+    const systemPrompt = await renderSystemPrompt(ctx, machine, loaded.body, { workflow: workflowName });
+    if (skillRegistry.size > 0)
+        emit({ type: "skills-loaded", names: [...skillRegistry.keys()] });
+    // The session-level members every agent carries, governed or plain.
+    const members = (graph, dispose, toolMocks) => ({
+        dispose,
+        runtimeContract,
+        toolMocks,
+        emitRunArtifacts: createArtifactEmitter({ graph, machine, workspace, workflowName, runtimeContract, usage, emit }),
+        sessions: createSessionOperations({ checkpointer, sessionStore, workspace, mountPrefixes, dispose }),
+        getSpecSnapshot: createSpecSnapshotReader(workspace),
+    });
+    if (!machine) {
+        const plain = composePlain(ctx, systemPrompt);
+        // Bound like a governed session: `configurable.thread_id` names the session
+        // whose zone the agent's id-free paths resolve in.
+        const driver = createPlainTurnRunner({ graph: plain.graph, bindSession: sessionBinder(ctx) });
+        return new ArchmaxAgent({
+            graph: plain.graph,
+            members: members(plain.graph, () => { }, plain.toolMocks),
+            driver,
+        });
+    }
+    const registry = createDelegationRegistry(ctx, machine);
+    const composed = await composeGoverned(ctx, {
+        machine,
+        workflow: workflowName,
+        systemPrompt,
+        ...(params.trigger ? { trigger: params.trigger } : {}),
+        ...(params.variables ? { variables: params.variables } : {}),
+        registry,
+    });
+    const agentMembers = members(composed.graph, composed.dispose, composed.toolMocks);
+    const { resumable, driver } = composed;
+    const workflow = {
+        name: workflowName,
+        machine,
+        resolveTrigger: (trigger) => resolveTrigger(machine, trigger),
+        decide: (sessionId, resolution) => decide(resumable, sessionId, resolution),
+        reply: (sessionId, message) => reply(resumable, sessionId, message),
+        respond: (sessionId, message) => reply(resumable, sessionId, message),
+        deliver: (sessionId, delivery) => deliver(resumable, sessionId, delivery),
+        resolveSession: (input) => resolveSession(machine, {
+            // The id *is* the address: one direct projection, no mapping step.
+            findSession: (sessionId) => agentMembers.sessions.get(sessionId),
+            mintSessionId: () => `session-${randomUUID()}`,
+        }, { ...(params.sessionPath ? { sessionPath: params.sessionPath } : {}), ...input }, (message) => emit({ type: "warning", scope: "session", message })),
+        send: async (sessionId, input, config) => {
+            if ("decision" in input)
+                return outcomeOf(await resume(resumable, sessionId, input, config), "decide");
+            if ("delivery" in input)
+                return outcomeOf(await resume(resumable, sessionId, input, config), "deliver");
+            // A turn: the session's disposition decides whether it is a fresh turn, a
+            // reply to a person's hold, or a delivery to a waiting park.
+            const turn = input;
+            const resolved = await workflow.resolveSession({
+                sessionId,
+                ...(turn.trigger ? { trigger: turn.trigger } : {}),
+                ...(turn.variables ? { variables: turn.variables } : {}),
+                ...(turn.sessionPath ? { sessionPath: turn.sessionPath } : {}),
+            });
+            if (resolved.disposition === "reply") {
+                return outcomeOf(await resume(resumable, sessionId, { message: turn.message }, config), "reply");
+            }
+            if (resolved.disposition === "resume") {
+                // The person's message travels with the firing rather than being dropped.
+                const delivery = {
+                    trigger: turn.trigger ?? { id: DEFAULT_TRIGGER_ID },
+                    ...(turn.variables ? { variables: turn.variables } : {}),
+                    ...(turn.message?.trim() ? { message: turn.message } : {}),
+                };
+                return outcomeOf(await resume(resumable, sessionId, { delivery }, config), "deliver");
+            }
+            if (machine.disabled)
+                throw new WorkflowDisabledError(workflowName);
+            const message = (turn.message ?? "").trim();
+            if (!message)
+                throw new EmptyMessageError(sessionId);
+            const trigger = { id: resolveTrigger(machine, turn.trigger).id };
+            const turnConfig = mergeConfigs(AGENT_DEFAULT_CONFIG, config, {
+                configurable: { thread_id: sessionId },
+            });
+            const result = await driver.invoke({
+                messages: [{ role: "user", content: message }],
+                trigger,
+                // Seeded per turn, locked, like a delivery's seeds; the channel's
+                // merge keeps the first lock, so a later seed cannot overwrite it.
+                ...(turn.variables ? { variables: buildSeededVariables(turn.variables) } : {}),
+            }, turnConfig);
+            return outcomeOf(settle(result, sessionId), "turn");
+        },
+    };
+    return new ArchmaxAgent({
+        graph: composed.graph,
+        members: agentMembers,
+        driver,
+        workflow,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/assembly/index.js.map

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

package/dist/assembly/plain.d.ts

@@ -0,0 +1,7 @@
+import { type CompiledAgentGraph } from "../core/deepagents.js";
+import { type AssemblyContext } from "./compose.js";
+/** Compose the plain agent: its graph, and whether the host's tool-mock middleware is among its middleware. */
+export declare function composePlain(ctx: AssemblyContext, systemPrompt: string): {
+    graph: CompiledAgentGraph;
+    toolMocks: boolean;
+};