@archmax-ai/harness 0.0.0

package/dist/testing/target.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Building the agent an offline suite drives.
+ *
+ * A module of its own, deliberately: `runTests` reaches its target through this
+ * builder, and a host replaces it (`createTarget`) to drive a workflow agent it
+ * assembled itself. Folded into `runner.ts` the call would be intra-module and
+ * therefore unreplaceable — the seam would exist in the type and not in fact.
+ */
+import type { GovernedAgent } from "../agent.js";
+import type { WorkflowEventHandler } from "../core/events.js";
+import type { SandboxRuntime } from "../sandbox/runtime.js";
+import type { ModelFactory } from "../env.js";
+export interface CaseTargetOptions {
+    workflow: string;
+    rootDir?: string;
+    onEvent?: WorkflowEventHandler;
+    /** Script-execution backend forwarded to the agent under test. */
+    sandboxRuntime?: SandboxRuntime;
+    /** Model factory forwarded to the agent under test. */
+    modelFactory?: ModelFactory;
+}
+/**
+ * Build the agent under test for an offline case run. The tool-mock middleware
+ * is always wired: a case's declared `mocks:` must intercept the agent's own
+ * calls as well as scripts' PTC calls, or interception would be partial.
+ */
+export declare function createCaseTarget(opts: CaseTargetOptions): Promise<GovernedAgent>;

package/dist/testing/target.js

@@ -0,0 +1,21 @@
+import { createAgent } from "../assembly/index.js";
+import { createToolMockMiddleware } from "./mock-middleware.js";
+import { assertWorkflowGovernedTarget } from "./runner.js";
+/**
+ * Build the agent under test for an offline case run. The tool-mock middleware
+ * is always wired: a case's declared `mocks:` must intercept the agent's own
+ * calls as well as scripts' PTC calls, or interception would be partial.
+ */
+export async function createCaseTarget(opts) {
+    const agent = await createAgent({
+        workflow: opts.workflow,
+        ...(opts.rootDir !== undefined ? { workspace: { rootDir: opts.rootDir } } : {}),
+        middleware: [createToolMockMiddleware()],
+        onEvent: opts.onEvent,
+        ...(opts.sandboxRuntime ? { sandboxRuntime: opts.sandboxRuntime } : {}),
+        ...(opts.modelFactory ? { modelFactory: opts.modelFactory } : {}),
+    });
+    assertWorkflowGovernedTarget(agent, opts.workflow);
+    return agent;
+}
+//# sourceMappingURL=target.js.map

package/dist/testing/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/testing/target.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAInD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAY3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAuB;IAC5D,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,UAAU,EAAE,CAAC,wBAAwB,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC,CAAC;IACH,4BAA4B,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/validate/validate.d.ts

@@ -0,0 +1,41 @@
+import { type MountSpec } from "../core/mounts.js";
+import type { Diagnostic } from "../machine/diagnostic.js";
+export type { Diagnostic, DiagnosticSeverity } from "../machine/diagnostic.js";
+export interface ValidationResult {
+    /** False if any `error`-severity diagnostic was produced. */
+    valid: boolean;
+    workflow: string;
+    /** Resolved absolute workspace root the scaffold was validated against; absent when every source was supplied and none was built over a root. */
+    rootDir?: string;
+    diagnostics: Diagnostic[];
+}
+export interface ValidateWorkflowOptions {
+    /** Workspace root; defaults to the consumer's current working directory. */
+    rootDir?: string;
+    /** Named workflow under `workflows/<name>/`; defaults to {@link DEFAULT_WORKFLOW}. */
+    workflow?: string;
+    /**
+     * Skill sources, matching the harness's `skills` option (default
+     * `["skills/"]`). Validation resolves the registry from the same sources the
+     * runtime would, so "this slug exists" means the same thing in both.
+     */
+    skills?: string[];
+    /**
+     * The mount table, matching the harness's `workspace.mounts` option. The
+     * `mounts` diagnostics are about names and governance the **host** declares,
+     * so without the host's table there is nothing to check a `mounts` list
+     * against: the zero-config default governs nothing, and every mounts
+     * diagnostic stays silent. A host that governs mounts passes the same table it
+     * assembles with, so "this mount exists and is governed" means the same thing
+     * in both.
+     */
+    mounts?: Record<string, MountSpec>;
+}
+/**
+ * Statically validate a workflow scaffold (`workflow.yaml` plus referenced
+ * skills, lifecycle scripts, sibling workflows and test cases) by
+ * reading it through the same backends the runtime uses. Performs only file
+ * reads and parsing — "valid" means the runtime can load the scaffold, not that
+ * a run will succeed.
+ */
+export declare function validateWorkflow(options?: ValidateWorkflowOptions): Promise<ValidationResult>;