@archmax-ai/harness 0.0.0

package/dist/workflow/turn-runner.js

@@ -0,0 +1,122 @@
+import { INTERRUPT } from "@langchain/langgraph";
+import { contentToString, isAiMessage } from "../core/messages.js";
+import { currentWorkflowState } from "./state.js";
+import { DEFAULT_SESSION_ID } from "../sessions/scope.js";
+export function sessionIdOfConfig(config) {
+    const id = config?.configurable?.thread_id;
+    return typeof id === "string" && id ? id : DEFAULT_SESSION_ID;
+}
+/** Bind every step of an async iterable to the session: `next()` runs in the caller's context, so the binding is per step. */
+async function* boundIterable(sessionId, bind, open) {
+    const iterator = (await bind(sessionId, open))[Symbol.asyncIterator]();
+    for (;;) {
+        const step = await bind(sessionId, () => iterator.next());
+        if (step.done)
+            return;
+        yield step.value;
+    }
+}
+export function createTurnRunner(opts) {
+    const { graph, emit, bindSession } = opts;
+    /**
+     * Drive one turn via LangGraph streaming (`["values", "messages"]`): each AI
+     * chunk with text is an `agent-text-delta` attributed to the current state (a
+     * non-streaming model yields one chunk, so deltas flow regardless); the result
+     * is the last `values` chunk. A turn that fails mid-stream finalizes the text
+     * streamed so far as `agent-text` events flagged `partial`, since the
+     * governance hooks that emit the final `agent-text` never ran for it.
+     */
+    async function drive(input, config) {
+        const stream = await graph.stream(input, {
+            ...(config ?? {}),
+            streamMode: ["values", "messages"],
+        });
+        let state = opts.entryState;
+        const streamedText = new Map();
+        let result;
+        // A parked turn ends with an interrupt chunk; reported the way `Pregel.invoke`
+        // does — the last state with the interrupts under `__interrupt__`.
+        const interrupts = [];
+        try {
+            for await (const item of stream) {
+                const [mode, payload] = item;
+                if (mode === "messages") {
+                    const [chunk] = payload;
+                    if (!isAiMessage(chunk))
+                        continue;
+                    const msg = chunk;
+                    const text = contentToString(msg.content);
+                    if (!text)
+                        continue;
+                    const id = typeof msg.id === "string" && msg.id ? msg.id : undefined;
+                    const bucket = streamedText.get(id ?? "");
+                    if (bucket)
+                        bucket.text += text;
+                    else
+                        streamedText.set(id ?? "", { text, ...(id ? { messageId: id } : {}) });
+                    emit({ type: "agent-text-delta", state, text, ...(id ? { messageId: id } : {}) });
+                }
+                else if (mode === "values") {
+                    const values = payload;
+                    const interrupted = values[INTERRUPT];
+                    if (Array.isArray(interrupted)) {
+                        interrupts.push(...interrupted);
+                        continue;
+                    }
+                    result = values;
+                    state = currentWorkflowState(result, state);
+                }
+            }
+            if (result === undefined) {
+                if (interrupts.length > 0)
+                    return { [INTERRUPT]: interrupts };
+                throw new Error("the turn's stream ended without a final state");
+            }
+            return interrupts.length > 0 ? { ...result, [INTERRUPT]: interrupts } : result;
+        }
+        catch (err) {
+            // The one `agent-text` that may carry no id: nothing was committed.
+            for (const { text, messageId } of streamedText.values()) {
+                emit({ type: "agent-text", state, text, partial: true, ...(messageId ? { messageId } : {}) });
+            }
+            throw err;
+        }
+    }
+    return {
+        // `async`, so a refused session id is a rejection like every other failure of
+        // the call, never a synchronous throw out of `invoke`.
+        async invoke(input, config) {
+            return bindSession(sessionIdOfConfig(config), () => drive(input, config));
+        },
+        stream(input, config) {
+            return boundIterable(sessionIdOfConfig(config), bindSession, () => graph.stream(input, config));
+        },
+        streamEvents(input, config, options) {
+            return boundIterable(sessionIdOfConfig(config), bindSession, async () => graph.streamEvents(input, config, options));
+        },
+    };
+}
+/**
+ * The runner a **plain** (ungoverned) agent drives its graph through: the graph's
+ * own `invoke`/`stream`/`streamEvents`, each bound to the session named by
+ * `configurable.thread_id`. No machine means no state to attribute text deltas
+ * to and no park to settle, so nothing here reshapes the graph's results; what
+ * the binding buys is that the agent's `scratchpad/…` and offload paths land
+ * under `<sessionId>/` in the session store exactly as a governed session's do,
+ * and that a reserved or escaping id is refused before anything is written.
+ */
+export function createPlainTurnRunner(opts) {
+    const { graph, bindSession } = opts;
+    return {
+        async invoke(input, config) {
+            return bindSession(sessionIdOfConfig(config), () => graph.invoke(input, config));
+        },
+        stream(input, config) {
+            return boundIterable(sessionIdOfConfig(config), bindSession, () => graph.stream(input, config));
+        },
+        streamEvents(input, config, options) {
+            return boundIterable(sessionIdOfConfig(config), bindSession, async () => graph.streamEvents(input, config, options));
+        },
+    };
+}
+//# sourceMappingURL=turn-runner.js.map

package/dist/workflow/turn-runner.js.map

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

package/dist/workflow/workflow-tools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Delegation tools: one per sibling workflow a machine is permitted to call. A
+ * workflow's declared signature is its call signature: the `sub-workflow`
+ * trigger's `requires:` becomes the tool's parameters and `returns:` the shape
+ * of the result, so delegating is an ordinary governed tool call.
+ *
+ * Unlike the other `archmax_*` tools, the body is real: a delegation tool is the
+ * only runtime tool a script may call through the PTC gateway (which runs the
+ * kernel verdict by name before the body). One call starts one sub-run; fan-out
+ * is parallel tool calls or a script's `Promise.all`, bounded by the dispatcher.
+ */
+import type { StructuredTool } from "@langchain/core/tools";
+import type { SubWorkflowDispatcher, SubWorkflowResult } from "./sub-workflow.js";
+/** What a target declares about itself, as the tool needs to render and enforce it. */
+export interface DelegationTarget {
+    /** The `workflows/<slug>/` directory name — the tool's identity. */
+    workflow: string;
+    /** The target's human label; prose for the description only. */
+    title?: string;
+    /** Run variables a dispatch must supply. */
+    requires?: string[];
+    /** Run variables the target guarantees on completion. */
+    returns?: string[];
+}
+/**
+ * The model-facing description, built from the target's own spec: what the
+ * runtime enforces and no more. The target's `instructions` are absent — that is
+ * the child's brief, and the caller's agent must not act on it.
+ */
+export declare function delegationToolDescription(target: DelegationTarget): string;
+/** The JSON Schema for a call: the target's `requires`, and nothing else named. */
+export declare function delegationToolSchema(target: DelegationTarget): Record<string, unknown>;
+/**
+ * How a completed sub-run is handed to its caller: the declared returns and the
+ * closing message as two channels (values read by name, prose read by the
+ * model), or the message alone for an unsigned target.
+ */
+export declare function delegationCallResult(result: SubWorkflowResult): string | {
+    message: string;
+    returns: Record<string, unknown>;
+};
+/**
+ * Build the callable tool for one target. A call's arguments are values the
+ * caller already produced, so nothing is resolved against the run's variables.
+ */
+export declare function createDelegationTool(target: DelegationTarget, dispatcher: SubWorkflowDispatcher, entryState: string): StructuredTool;

package/dist/workflow/workflow-tools.js

@@ -0,0 +1,90 @@
+/**
+ * Delegation tools: one per sibling workflow a machine is permitted to call. A
+ * workflow's declared signature is its call signature: the `sub-workflow`
+ * trigger's `requires:` becomes the tool's parameters and `returns:` the shape
+ * of the result, so delegating is an ordinary governed tool call.
+ *
+ * Unlike the other `archmax_*` tools, the body is real: a delegation tool is the
+ * only runtime tool a script may call through the PTC gateway (which runs the
+ * kernel verdict by name before the body). One call starts one sub-run; fan-out
+ * is parallel tool calls or a script's `Promise.all`, bounded by the dispatcher.
+ */
+import { tool } from "langchain";
+import { workflowToolName } from "../machine/tool-names.js";
+import { callingStateFrom } from "../sessions/scope.js";
+/**
+ * The model-facing description, built from the target's own spec: what the
+ * runtime enforces and no more. The target's `instructions` are absent — that is
+ * the child's brief, and the caller's agent must not act on it.
+ */
+export function delegationToolDescription(target) {
+    const parts = [];
+    const label = target.title?.trim();
+    parts.push(`Run the '${target.workflow}' workflow${label ? ` (${label})` : ""} to completion and ` +
+        `return its result. It runs as its own governed machine with its own states and tools; ` +
+        `your run stays where it is and continues when the call answers.`);
+    if (target.requires?.length) {
+        parts.push(`It requires ${quoteList(target.requires)}, which the call must supply.`);
+    }
+    parts.push(target.returns?.length
+        ? `The result carries ${quoteList(target.returns)} under 'returns', alongside the ` +
+            `workflow's closing message under 'message'.`
+        : `The result is the workflow's closing message.`);
+    parts.push(`One call runs it once; call it again (in the same turn) to run several at once.`);
+    return parts.join(" ");
+}
+/** The JSON Schema for a call: the target's `requires`, and nothing else named. */
+export function delegationToolSchema(target) {
+    const required = target.requires ?? [];
+    return {
+        type: "object",
+        properties: Object.fromEntries(required.map((name) => [
+            name,
+            { description: `Required input '${name}', seeded as a locked run variable.` },
+        ])),
+        required: [...required],
+        // Open: `requires` states only what is mandatory, and nothing declares the full accepted set.
+        additionalProperties: true,
+    };
+}
+/**
+ * How a completed sub-run is handed to its caller: the declared returns and the
+ * closing message as two channels (values read by name, prose read by the
+ * model), or the message alone for an unsigned target.
+ */
+export function delegationCallResult(result) {
+    return result.returns ? { message: result.result, returns: result.returns } : result.result;
+}
+/**
+ * Build the callable tool for one target. A call's arguments are values the
+ * caller already produced, so nothing is resolved against the run's variables.
+ */
+export function createDelegationTool(target, dispatcher, entryState) {
+    return tool(async (input, runtimeConfig) => {
+        const result = await dispatcher.dispatch({
+            workflow: target.workflow,
+            ...(Object.keys(input ?? {}).length ? { params: input } : {}),
+            variables: {},
+            config: runtimeConfig,
+            state: callingStateFrom(runtimeConfig) ?? entryState,
+            ...(callIdOf(runtimeConfig) ? { toolCallId: callIdOf(runtimeConfig) } : {}),
+        });
+        return delegationCallResult(result);
+    }, {
+        name: workflowToolName(target.workflow),
+        description: delegationToolDescription(target),
+        schema: delegationToolSchema(target),
+    });
+}
+/** The id of the tool call being serviced; absent when a script invokes the tool through the PTC bridge. */
+function callIdOf(runtime) {
+    const id = runtime?.toolCallId;
+    return typeof id === "string" && id ? id : undefined;
+}
+function quoteList(names) {
+    const quoted = names.map((n) => `'${n}'`);
+    if (quoted.length <= 1)
+        return quoted.join("");
+    return `${quoted.slice(0, -1).join(", ")} and ${quoted[quoted.length - 1]}`;
+}
+//# sourceMappingURL=workflow-tools.js.map

package/dist/workflow/workflow-tools.js.map

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

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@archmax-ai/harness",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "archmax harness - a generic, backend-driven agent runtime built on LangChain Deep Agents, governed by a declarative workflow machine.",
+  "keywords": [
+    "agent",
+    "agents",
+    "ai",
+    "langchain",
+    "deepagents",
+    "llm",
+    "state-machine",
+    "workflow",
+    "governance",
+    "guardrails",
+    "typescript"
+  ],
+  "homepage": "https://archmax-ai.github.io/harness",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/archmax-ai/harness.git"
+  },
+  "bugs": {
+    "url": "https://github.com/archmax-ai/harness/issues"
+  },
+  "author": "Archmax AI",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./sandbox": {
+      "types": "./dist/public/sandbox.d.ts",
+      "import": "./dist/public/sandbox.js"
+    },
+    "./testing": {
+      "types": "./dist/public/testing.d.ts",
+      "import": "./dist/public/testing.js"
+    },
+    "./cli": {
+      "types": "./dist/public/cli.d.ts",
+      "import": "./dist/public/cli.js"
+    },
+    "./spec": {
+      "types": "./dist/public/spec.d.ts",
+      "import": "./dist/public/spec.js"
+    },
+    "./messages": {
+      "types": "./dist/public/messages.d.ts",
+      "import": "./dist/public/messages.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "archmax": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "clean": "rm -rf dist",
+    "build": "npm run clean && npm run generate:prompt && tsc -p tsconfig.build.json && npm run copy:assets && chmod +x dist/cli.js",
+    "generate:prompt": "node scripts/generate-platform-prompt.mjs",
+    "copy:assets": "mkdir -p dist/sandbox/assets && cp -R src/sandbox/assets/parts dist/sandbox/assets/parts && mkdir -p dist/authoring-skill && cp -R skills/archmax-harness dist/authoring-skill/archmax-harness",
+    "check:no-secrets": "test -z \"$(find dist -type f -name '.env*' ! -name '.env.example')\" || { echo 'refusing to pack: dist contains an .env file' >&2; exit 1; }",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "docs:dev": "npm --prefix docs run dev",
+    "docs:build": "npm --prefix docs run build",
+    "hooks:install": "git config core.hooksPath .githooks",
+    "prepare": "git config core.hooksPath .githooks || true",
+    "prepack": "npm run check:no-secrets",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@langchain/core": "^1.2.11",
+    "@langchain/langgraph": "^1.4.15",
+    "@langchain/langgraph-checkpoint": "^1.1.3",
+    "@langchain/openai": "^1.5.13",
+    "@langchain/quickjs": "^0.6.3",
+    "deepagents": "^1.11.1",
+    "dotenv": "^17.4.2",
+    "gray-matter": "^4.0.3",
+    "just-bash": "^3.4.2",
+    "langchain": "^1.5.4",
+    "picomatch": "^4.0.7",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.5.1",
+    "@types/picomatch": "^4.0.3",
+    "eslint": "^10.10.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.13",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.70.0",
+    "vitest": "^5.0.0"
+  }
+}