@deepstrike/wasm 0.2.28 → 0.2.31

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { RuntimeRunner, collectText, InMemorySessionLog, LocalExecutionPlane, DEFAULT_NATIVE_ATTENTION_POLICY, DEFAULT_NATIVE_GOVERNANCE_POLICY, DEFAULT_SANDBOX_POLICY, assertNativeProfile, osProfile, validateDeclarativePolicy, ReplayProvider, extractRecordedMessages, judge, buildEvalMessages, parseVerdict, verdictOutputSchema, } from "./runtime/index.js";
+export { RuntimeRunner, collectText, runAgent, runFanout, InMemorySessionLog, LocalExecutionPlane, DEFAULT_NATIVE_ATTENTION_POLICY, DEFAULT_NATIVE_GOVERNANCE_POLICY, DEFAULT_SANDBOX_POLICY, assertNativeProfile, osProfile, validateDeclarativePolicy, ReplayProvider, extractRecordedMessages, judge, buildEvalMessages, parseVerdict, verdictOutputSchema, } from "./runtime/index.js";
 export type { ReplayProviderOpts, Criterion, Verdict, VerdictDetail, JudgeArgs, } from "./runtime/index.js";
 export type { NativeOsProfile, OsProfileId, MemoryPolicy, MemoryWriteRateLimit, ResourceQuota, RuntimeOptions, SchedulerBudget, SessionEvent, SessionLog, RunContext, ExecutionPlane, } from "./runtime/index.js";
 export { FilteredExecutionPlane } from "./runtime/filtered-plane.js";

package/dist/index.js

@@ -1,4 +1,4 @@
-export { RuntimeRunner, collectText, InMemorySessionLog, LocalExecutionPlane, DEFAULT_NATIVE_ATTENTION_POLICY, DEFAULT_NATIVE_GOVERNANCE_POLICY, DEFAULT_SANDBOX_POLICY, assertNativeProfile, osProfile, validateDeclarativePolicy, ReplayProvider, extractRecordedMessages, judge, buildEvalMessages, parseVerdict, verdictOutputSchema, } from "./runtime/index.js";
+export { RuntimeRunner, collectText, runAgent, runFanout, InMemorySessionLog, LocalExecutionPlane, DEFAULT_NATIVE_ATTENTION_POLICY, DEFAULT_NATIVE_GOVERNANCE_POLICY, DEFAULT_SANDBOX_POLICY, assertNativeProfile, osProfile, validateDeclarativePolicy, ReplayProvider, extractRecordedMessages, judge, buildEvalMessages, parseVerdict, verdictOutputSchema, } from "./runtime/index.js";
 export { FilteredExecutionPlane } from "./runtime/filtered-plane.js";
 export { SubAgentOrchestrator, defaultSubAgentOrchestrator, spawnStandalone } from "./runtime/sub-agent-orchestrator.js";
 export { workflowSpecToKernel, workflowNodeSpecToKernel, submitWorkflowNodesToKernel, submitWorkflowToKernel, submitWorkflowNodesTool, startWorkflowTool, fanoutSynthesize, generateAndFilter, verifyRules } from "./runtime/types/agent.js";

package/dist/runtime/facade.d.ts

@@ -0,0 +1,35 @@
+import type { ExecutionPlane } from "./execution-plane.js";
+import type { SessionLog } from "./session-log.js";
+import type { LLMProvider } from "../types.js";
+import type { RegisteredTool } from "../tools/index.js";
+import type { WorkflowTaskSpec, KernelAgentRole } from "./types/agent.js";
+export interface RunAgentOptions {
+    provider: LLMProvider;
+    goal: string;
+    systemPrompt?: string;
+    tools?: RegisteredTool[];
+    sessionId?: string;
+    maxTokens?: number;
+    maxTurns?: number;
+    sessionLog?: SessionLog;
+    executionPlane?: ExecutionPlane;
+}
+/** Run a single agent to completion and return its final text. */
+export declare function runAgent(opts: RunAgentOptions): Promise<string>;
+export interface RunFanoutOptions {
+    provider: LLMProvider;
+    tasks: WorkflowTaskSpec[];
+    synthesize: string;
+    workerRole?: KernelAgentRole;
+    synthesisRole?: KernelAgentRole;
+    sessionId?: string;
+    maxTokens?: number;
+    maxTurns?: number;
+    sessionLog?: SessionLog;
+    executionPlane?: ExecutionPlane;
+}
+/** Parallel fan-out → synthesize over the kernel-gated DAG (standalone runWorkflow). */
+export declare function runFanout(opts: RunFanoutOptions): Promise<{
+    synthesis: string;
+    outputs: Record<string, string>;
+}>;

package/dist/runtime/facade.js

@@ -0,0 +1,41 @@
+// High-level facades (parity with the Node SDK's runAgent/runFanout) so the common cases don't require
+// assembling RuntimeRunner + session log + execution plane + collectText by hand. Browser/edge-friendly.
+import { RuntimeRunner, collectText } from "./runner.js";
+import { LocalExecutionPlane } from "./execution-plane.js";
+import { InMemorySessionLog } from "./session-log.js";
+/** Run a single agent to completion and return its final text. */
+export async function runAgent(opts) {
+    const plane = opts.executionPlane ??
+        (opts.tools ?? []).reduce((p, t) => p.register(t), new LocalExecutionPlane());
+    const runner = new RuntimeRunner({
+        provider: opts.provider,
+        executionPlane: plane,
+        sessionLog: opts.sessionLog ?? new InMemorySessionLog(),
+        maxTokens: opts.maxTokens ?? 32_000,
+        ...(opts.maxTurns !== undefined ? { maxTurns: opts.maxTurns } : {}),
+        ...(opts.systemPrompt !== undefined ? { systemPrompt: opts.systemPrompt } : {}),
+    });
+    return collectText(runner.run({ sessionId: opts.sessionId ?? `agent-${crypto.randomUUID()}`, goal: opts.goal }));
+}
+/** Parallel fan-out → synthesize over the kernel-gated DAG (standalone runWorkflow). */
+export async function runFanout(opts) {
+    const runner = new RuntimeRunner({
+        provider: opts.provider,
+        executionPlane: opts.executionPlane ?? new LocalExecutionPlane(),
+        sessionLog: opts.sessionLog ?? new InMemorySessionLog(),
+        maxTokens: opts.maxTokens ?? 32_000,
+        ...(opts.maxTurns !== undefined ? { maxTurns: opts.maxTurns } : {}),
+    });
+    const workerRole = opts.workerRole ?? "explore";
+    const spec = {
+        nodes: [
+            ...opts.tasks.map(task => ({ task, role: workerRole })),
+            { task: opts.synthesize, role: opts.synthesisRole ?? "plan", dependsOn: opts.tasks.map((_, i) => i) },
+        ],
+    };
+    const outcome = await runner.runWorkflow(spec, opts.sessionId ? { sessionId: opts.sessionId } : undefined);
+    const synthesisId = `wf-node${opts.tasks.length}`;
+    const lastCompleted = outcome.completed[outcome.completed.length - 1];
+    const synthesis = outcome.outputs[synthesisId] ?? (lastCompleted ? outcome.outputs[lastCompleted] : undefined) ?? "";
+    return { synthesis, outputs: outcome.outputs };
+}

package/dist/runtime/index.d.ts

@@ -4,6 +4,8 @@ export type { RunContext, ExecutionPlane } from "./execution-plane.js";
 export { LocalExecutionPlane } from "./execution-plane.js";
 export type { MemoryPolicy, MemoryWriteRateLimit, ResourceQuota, RuntimeOptions, SchedulerBudget } from "./runner.js";
 export { RuntimeRunner, collectText } from "./runner.js";
+export { runAgent, runFanout } from "./facade.js";
+export type { RunAgentOptions, RunFanoutOptions } from "./facade.js";
 export { builtinReducers, resolveReducer } from "./reducers.js";
 export type { Reducer, ReducerRegistry, ReducerInput } from "./reducers.js";
 export { getKernel } from "./kernel.js";

package/dist/runtime/index.js

@@ -1,6 +1,7 @@
 export { InMemorySessionLog } from "./session-log.js";
 export { LocalExecutionPlane } from "./execution-plane.js";
 export { RuntimeRunner, collectText } from "./runner.js";
+export { runAgent, runFanout } from "./facade.js";
 export { builtinReducers, resolveReducer } from "./reducers.js";
 export { getKernel } from "./kernel.js";
 export { ReplayProvider } from "./replay-provider.js";

package/dist/runtime/runner.js

@@ -968,41 +968,27 @@ export class RuntimeRunner {
         const osProfile = assertNativeProfile(this.opts.osProfile ?? "native");
         const attentionPolicy = this.opts.attentionPolicy ?? osProfile.attentionPolicy;
         const governancePolicy = this.opts.governancePolicy ?? osProfile.governancePolicy;
-        kernelApply(runtime, this.pendingObservations, governancePolicyToKernelEvent(governancePolicy));
-        kernelApply(runtime, this.pendingObservations, {
-            kind: "set_attention_policy",
-            ...(attentionPolicy.maxQueueSize !== undefined
-                ? { max_queue_size: attentionPolicy.maxQueueSize }
-                : {}),
-        });
-        if (this.opts.schedulerBudget) {
-            kernelApply(runtime, this.pendingObservations, {
-                kind: "set_scheduler_budget",
-                ...(this.opts.schedulerBudget.maxWallMs !== undefined
-                    ? { max_wall_ms: this.opts.schedulerBudget.maxWallMs }
-                    : {}),
-            });
+        // K2: lower governance / attention / scheduler / quota in ONE `configure_run` event (the 0.2.30
+        // core applies each present field via its granular path). `set_memory_policy` stays separate below.
+        const { kind: _govKind, ...governance } = governancePolicyToKernelEvent(governancePolicy);
+        const config = { governance };
+        if (attentionPolicy.maxQueueSize !== undefined) {
+            config.attention_max_queue_size = attentionPolicy.maxQueueSize;
+        }
+        if (this.opts.schedulerBudget?.maxWallMs !== undefined) {
+            config.scheduler_max_wall_ms = this.opts.schedulerBudget.maxWallMs;
         }
         if (this.opts.resourceQuota) {
             const q = this.opts.resourceQuota;
-            kernelApply(runtime, this.pendingObservations, {
-                kind: "set_resource_quota",
-                quota: {
-                    ...(q.maxConcurrentSubagents !== undefined
-                        ? { max_concurrent_subagents: q.maxConcurrentSubagents }
-                        : {}),
-                    ...(q.maxSpawnDepth !== undefined ? { max_spawn_depth: q.maxSpawnDepth } : {}),
-                    ...(q.memoryWritesPerWindow !== undefined
-                        ? {
-                            memory_writes_per_window: [
-                                q.memoryWritesPerWindow.maxWrites,
-                                q.memoryWritesPerWindow.windowMs,
-                            ],
-                        }
-                        : {}),
-                },
-            });
+            config.resource_quota = {
+                ...(q.maxConcurrentSubagents !== undefined ? { max_concurrent_subagents: q.maxConcurrentSubagents } : {}),
+                ...(q.maxSpawnDepth !== undefined ? { max_spawn_depth: q.maxSpawnDepth } : {}),
+                ...(q.memoryWritesPerWindow !== undefined
+                    ? { memory_writes_per_window: [q.memoryWritesPerWindow.maxWrites, q.memoryWritesPerWindow.windowMs] }
+                    : {}),
+            };
         }
+        kernelApply(runtime, this.pendingObservations, { kind: "configure_run", config });
         if (this.opts.memoryPolicy) {
             const m = this.opts.memoryPolicy;
             kernelApply(runtime, this.pendingObservations, {
@@ -1044,7 +1030,9 @@ export class RuntimeRunner {
             ...(this.opts.agentId ? { agent_id: this.opts.agentId } : {}),
         })).catch(() => { });
         this.applyKernelPolicies(runtime);
-        kernelApply(runtime, this.pendingObservations, { kind: "start_run", task: { goal, criteria: [] } });
+        // K1: no explicit `start_run` — the host `load_workflow` (fired next by `runWorkflow`) self-bootstraps
+        // the run on the 0.2.30 core, matching the agent-reachable `submit_workflow` path.
+        void goal;
         return runtime;
     }
     async runWorkflow(spec, opts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstrike/wasm",
-  "version": "0.2.28",
+  "version": "0.2.31",
   "description": "DeepStrike WASM SDK — browser, Cloudflare Workers, Deno Deploy",
   "type": "module",
   "main": "dist/index.js",
@@ -15,7 +15,7 @@
     "test": "node --experimental-vm-modules node_modules/.bin/jest"
   },
   "dependencies": {
-    "@deepstrike/wasm-kernel": "0.2.28"
+    "@deepstrike/wasm-kernel": "0.2.31"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",