@hunterzhu/pulse-runtime 0.1.5 → 0.1.7

package/dist/scheduler/worker.d.ts

@@ -85,6 +85,8 @@ export declare class WorkerCoordinator implements WorkerCoordinatorContract {
     private readonly persistenceBackend;
     private persistenceDigest;
     private persistencePending;
+    private persistenceDirty;
+    private persistenceScheduled;
     private sequence;
     constructor(options?: WorkerCoordinatorOptions);
     static restore(snapshot: WorkerCoordinatorSnapshot, options?: WorkerCoordinatorOptions): WorkerCoordinator;

package/dist/scheduler/worker.js

@@ -173,6 +173,8 @@ export class WorkerCoordinator {
     persistenceBackend;
     persistenceDigest;
     persistencePending = Promise.resolve();
+    persistenceDirty = false;
+    persistenceScheduled = false;
     sequence = 1;
     constructor(options = {}) { this.persistenceBackend = options.persistenceBackend; }
     static restore(snapshot, options = {}) {
@@ -349,10 +351,28 @@ export class WorkerCoordinator {
     schedulePersistence() {
         if (!this.persistenceBackend)
             return;
+        this.persistenceDirty = true;
+        if (this.persistenceScheduled)
+            return;
+        this.persistenceScheduled = true;
         const operation = this.persistencePending.catch(() => undefined).then(async () => {
-            const snapshot = this.snapshot();
-            await this.persistenceBackend.save(snapshot, this.persistenceDigest);
-            this.persistenceDigest = snapshot.integrity?.digest;
+            while (this.persistenceDirty) {
+                this.persistenceDirty = false;
+                const snapshot = this.snapshot();
+                const digest = snapshot.integrity?.digest;
+                if (digest === this.persistenceDigest)
+                    continue;
+                try {
+                    await this.persistenceBackend.save(snapshot, this.persistenceDigest);
+                    this.persistenceDigest = digest;
+                }
+                catch (cause) {
+                    this.persistenceDirty = true;
+                    throw cause;
+                }
+            }
+        }).finally(() => {
+            this.persistenceScheduled = false;
         });
         this.persistencePending = operation;
     }
@@ -668,7 +688,7 @@ export class SqliteDistributedWorkerCoordinator {
                 result.reject(task.error ?? { code: 'WORKER_FAILED', message: 'WORKER_FAILED' });
             else
                 result.reject(new Error('WORKER_CANCELLED'));
-        }, 10);
+        }, 50);
         watcher.unref();
         this.watchers.set(taskId, watcher);
     }

package/dist/storage/session.d.ts

@@ -1,4 +1,4 @@
-import type { AgentRecord, ArtifactRecord, EffectRecord, JsonValue, LaneRecord, MergeProposal, PrivacyLabel, PrivacyMetadata, ResultRecord, RuntimeEvent, RuntimeState, WaitRecord, ToolCallCorrelation } from '../core/types.js';
+import type { AgentRecord, ArtifactRecord, EffectRecord, JsonValue, LaneRecord, MergeProposal, PrivacyLabel, PrivacyMetadata, ResultRecord, RuntimeEvent, RuntimeState, WaitRecord, ToolCallCorrelation, HumanInputRecord } from '../core/types.js';
 export interface SessionSnapshot {
     schemaVersion: 1;
     state: {
@@ -18,6 +18,7 @@ export interface SessionSnapshot {
         artifacts?: Array<[string, ArtifactRecord]>;
         toolCallCorrelations?: Array<[string, ToolCallCorrelation]>;
         mergeProposals: Array<[string, MergeProposal]>;
+        humanInputs?: Array<[string, HumanInputRecord]>;
         events: RuntimeEvent[];
         eventsCompactedThrough?: number;
         nextIds: RuntimeState['nextIds'];

package/dist/storage/session.js

@@ -304,6 +304,17 @@ function validateStateConfiguration(value) {
         throw new Error('INVALID_SESSION_SNAPSHOT');
     if (value.trustedSanitizerIds !== undefined && (!Array.isArray(value.trustedSanitizerIds) || new Set(value.trustedSanitizerIds).size !== value.trustedSanitizerIds.length || value.trustedSanitizerIds.some((id) => typeof id !== 'string' || id.length === 0)))
         throw new Error('INVALID_SESSION_SNAPSHOT');
+    if (value.humanInputs !== undefined) {
+        const ids = new Set();
+        for (const entry of value.humanInputs) {
+            if (!Array.isArray(entry) || entry.length !== 2 || typeof entry[0] !== 'string' || entry[0].length === 0 || ids.has(entry[0]))
+                throw new Error('INVALID_SESSION_SNAPSHOT');
+            const input = entry[1];
+            if (!input || input.id !== entry[0] || typeof input.agentId !== 'string' || input.agentId.length === 0 || !['pending', 'consumed', 'deferred'].includes(input.status) || typeof input.receivedAt !== 'number' || !Number.isFinite(input.receivedAt))
+                throw new Error('INVALID_SESSION_SNAPSHOT');
+            ids.add(entry[0]);
+        }
+    }
 }
 export function exportRuntimeState(state) {
     return {
@@ -318,6 +329,7 @@ export function exportRuntimeState(state) {
             artifacts: [...state.artifacts.entries()].map(([ref, artifact]) => [ref, structuredClone(artifact)]),
             toolCallCorrelations: [...state.toolCallCorrelations.entries()].map(([id, correlation]) => [id, structuredClone(correlation)]),
             mergeProposals: [...state.mergeProposals.entries()].map(([id, proposal]) => [id, structuredClone(proposal)]),
+            humanInputs: [...state.humanInputs.entries()].map(([id, input]) => [id, structuredClone(input)]),
             events: state.events.map((event) => normalizeRuntimeEvent(event, event.seq, { sessionId: event.sessionId, timestamp: event.timestamp })),
             ...(state.eventsCompactedThrough === undefined ? {} : { eventsCompactedThrough: state.eventsCompactedThrough }),
             nextIds: { ...state.nextIds },
@@ -440,6 +452,8 @@ export function importRuntimeState(snapshot) {
         state.toolCallCorrelations.set(id, structuredClone(correlation));
     for (const [id, proposal] of value.state.mergeProposals ?? [])
         state.mergeProposals.set(id, structuredClone(proposal));
+    for (const [id, input] of value.state.humanInputs ?? [])
+        state.humanInputs.set(id, structuredClone(input));
     state.events = value.state.events.map((event) => normalizeRuntimeEvent(event, event.seq, { sessionId: event.sessionId, timestamp: event.timestamp }));
     if (value.state.eventsCompactedThrough !== undefined)
         state.eventsCompactedThrough = value.state.eventsCompactedThrough;

package/dist/transitions/validate.js

@@ -7,7 +7,7 @@ import { ContextBuilder, contentHash, estimateHistoryTokens, hasUnsafePathSegmen
 const isLocal = (value) => 'local' in value;
 const clone = (value) => structuredClone(value);
 const resultMetadata = (value) => ({ sizeBytes: Buffer.byteLength(stableSerialize(value), 'utf8'), contentHash: contentHash(value) });
-const laneCopy = (lane) => ({ ...lane, resume: clone(lane.resume), context: clone(lane.context), ...(lane.visibleResultRefs === undefined ? {} : { visibleResultRefs: new Set(lane.visibleResultRefs) }), children: new Set(lane.children), ownedEffectIds: new Set(lane.ownedEffectIds), ...(lane.pendingResumeInput === undefined ? {} : { pendingResumeInput: clone(lane.pendingResumeInput) }), ...(lane.pendingControlProposals === undefined ? {} : { pendingControlProposals: clone(lane.pendingControlProposals) }), ...(lane.pendingOutcome === undefined ? {} : { pendingOutcome: clone(lane.pendingOutcome) }) });
+const laneCopy = (lane) => ({ ...lane, resume: clone(lane.resume), context: clone(lane.context), ...(lane.visibleResultRefs === undefined ? {} : { visibleResultRefs: new Set(lane.visibleResultRefs) }), children: new Set(lane.children), ownedEffectIds: new Set(lane.ownedEffectIds), ...(lane.pendingResumeInput === undefined ? {} : { pendingResumeInput: clone(lane.pendingResumeInput) }), ...(lane.pendingHumanInputs === undefined ? {} : { pendingHumanInputs: clone(lane.pendingHumanInputs) }), ...(lane.pendingControlProposals === undefined ? {} : { pendingControlProposals: clone(lane.pendingControlProposals) }), ...(lane.pendingOutcome === undefined ? {} : { pendingOutcome: clone(lane.pendingOutcome) }) });
 function isRuntimeJsonValue(value, seen = new Set()) {
     if (value === null || typeof value === 'string' || typeof value === 'boolean')
         return true;
@@ -614,7 +614,12 @@ function prepareLLMInput(state, lane, submission) {
     const rejectedInputs = readRefs('rejectedOutputRefs');
     const artifactInputs = readRefs('artifacts');
     const eventInputs = readRefs('events');
-    const inputError = resultInputs.error ?? findingInputs.error ?? rejectedInputs.error ?? artifactInputs.error ?? eventInputs.error;
+    const rawConversation = rawInputs.conversation;
+    const conversation = rawConversation === undefined ? [] : Array.isArray(rawConversation) && rawConversation.every((item) => item && typeof item === 'object' && !Array.isArray(item) && item.role !== undefined && ['system', 'user', 'assistant'].includes(String(item.role)) && typeof item.content === 'string')
+        ? rawConversation
+        : undefined;
+    const conversationError = rawConversation !== undefined && conversation === undefined ? 'INVALID_LLM_CONVERSATION' : undefined;
+    const inputError = resultInputs.error ?? findingInputs.error ?? rejectedInputs.error ?? artifactInputs.error ?? eventInputs.error ?? conversationError;
     if (inputError)
         return { error: inputError };
     const resultRefs = [...new Set([...(resultInputs.refs ?? []), ...(findingInputs.refs ?? []), ...(rejectedInputs.refs ?? [])])];
@@ -623,7 +628,7 @@ function prepareLLMInput(state, lane, submission) {
         const agent = state.agents.get(lane.agentId);
         if (!agent)
             return { error: 'UNKNOWN_AGENT' };
-        const projection = new ContextBuilder(state).build({ agent, lane, resultRefs, ...(artifactRefs.length ? { artifactRefs } : {}), eventIds: eventInputs.refs ?? [], instruction, ...(typeof input.system === 'string' ? { system: input.system } : {}), ...(input.policy === undefined ? {} : { policy: input.policy }), ...(input.tools === undefined ? {} : { tools: input.tools }), toolSetId: typeof input.toolSetId === 'string' ? input.toolSetId : 'default' });
+        const projection = new ContextBuilder(state).build({ agent, lane, resultRefs, ...(artifactRefs.length ? { artifactRefs } : {}), eventIds: eventInputs.refs ?? [], ...(conversation === undefined || conversation.length === 0 ? {} : { conversation }), instruction, ...(typeof input.system === 'string' ? { system: input.system } : {}), ...(input.policy === undefined ? {} : { policy: input.policy }), ...(input.tools === undefined ? {} : { tools: input.tools }), toolSetId: typeof input.toolSetId === 'string' ? input.toolSetId : 'default' });
         return { input: { ...input, request: projection } };
     }
     catch (cause) {
@@ -708,8 +713,13 @@ export function validateStep(state, laneId, output) {
     else if (output.adoptCommittedContext)
         return { rejection: error('INVALID_ADOPT_COMMITTED_CONTEXT', 'adoptCommittedContext requires a ContextDelta') };
     const compactRequested = output.contextDelta?.target === 'lane' && output.contextDelta.ops.some((op) => op.op === 'compact_history');
+    // ReAct can discover pressure only after consuming a model result. Permit
+    // the two-step compaction handoff and its summary request to cross the hard
+    // threshold; the following compact_history delta removes the old records.
+    const compactionHandoff = output.next.step === '$compact:summarize' && actions.length === 0;
+    const compactionSummarySubmission = actions.some((action) => action.type === 'submit_effects' && action.effects.some((effect) => effect.key === '$compact-summary'));
     const nextHistoryTokens = estimateHistoryTokens(workingLane.context.history);
-    if (nextHistoryTokens > state.historyHardTokens && !compactRequested)
+    if (nextHistoryTokens > state.historyHardTokens && !compactRequested && !compactionHandoff && !compactionSummarySubmission)
         return { rejection: error('CONTEXT_TOO_LARGE', 'Lane history exceeded hardTokens and must be compacted before another Step can commit.', { historyTokens: nextHistoryTokens, softTokens: state.historySoftTokens, hardTokens: state.historyHardTokens }) };
     const pressure = historyPressure(workingLane.context.history, state.historySoftTokens, state.historyHardTokens);
     if (pressure)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunterzhu/pulse-runtime",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "repository": {
     "type": "git",
     "url": "https://github.com/zhuhengtan/Pulse"