@hunterzhu/pulse-server 0.1.5 → 0.1.6

package/dist/index.d.ts

@@ -61,6 +61,8 @@ export interface RunHandle {
     }>;
     cancel(reason?: string): Promise<void>;
     reply(effectId: string, value: JsonValue): Promise<void>;
+    /** Submit a human message while this run is active. */
+    submitHumanInput(text: string, targetEffectId?: string): Promise<void>;
 }
 export interface ConversationHandle {
     readonly id: string;
@@ -117,6 +119,7 @@ export declare class LocalHost {
     sendMessage(conversationId: string, input: UserMessageInput): Promise<RunHandle>;
     resumeRun(conversationId: string): Promise<RunHandle>;
     private resultText;
+    private interactionResultTexts;
     private toolSettlementObservation;
     private projectEvents;
     close(): Promise<void>;

package/dist/index.js

@@ -431,11 +431,34 @@ export class LocalHost {
     }
     makeRunHandle(conversationId, runId, runtime, session) {
         let finalized;
-        const finish = () => finalized ??= (async () => { const outcome = await session.outcome(); const text = this.resultText(runtime, outcome.resultRef); await this.appendMessage(conversationId, { id: `msg-${randomUUID()}`, role: 'assistant', text: text ?? '', runId, createdAt: new Date().toISOString() }); const current = await this.readManifest(conversationId); const artifacts = [...runtime.state.results.values()].flatMap((result) => { const value = result.value; if (!value || typeof value !== 'object' || Array.isArray(value))
-            return []; const record = value; if (typeof record.path !== 'string' || typeof record.hash !== 'string' || typeof record.bytes !== 'number')
-            return []; return [{ path: record.path, hash: record.hash, bytes: record.bytes, ...(typeof record.mediaType === 'string' ? { mediaType: record.mediaType } : {}), ...(typeof record.label === 'string' ? { label: record.label } : {}), runId }]; }); current.artifacts = [...(current.artifacts ?? []).filter((item) => item.runId !== runId), ...artifacts]; if (current.activeRunId === runId)
-            delete current.activeRunId; current.updatedAt = new Date().toISOString(); await writeFile(this.manifestPath(conversationId), JSON.stringify(current, null, 2)); this.active.delete(runId); this.approvedToolCalls.delete(runId); await runtime.flushPersistence(); await writeFile(join(this.runDir(conversationId, runId), 'outcome.json'), JSON.stringify({ schemaVersion: 1, ...outcome, ...(text === undefined ? {} : { text }), completedAt: new Date().toISOString() }, null, 2)); return { ...outcome, ...(text === undefined ? {} : { text }) }; })().finally(async () => { await this.releaseConversationLock(conversationId); });
-        const events = this.projectEvents(conversationId, runId, session, finish);
+        const finish = () => finalized ??= (async () => {
+            const outcome = await session.outcome();
+            const text = this.resultText(runtime, outcome.resultRef);
+            // A free-form human input runs as a detached child Agent. Its answer is
+            // part of the same user-visible run, but it is not the root Outcome.
+            // Persist each child answer before the root answer so a restored
+            // conversation has the same order the user saw in the event stream.
+            for (const child of this.interactionResultTexts(runtime, session.agentId)) {
+                await this.appendMessage(conversationId, { id: `msg-${randomUUID()}`, role: 'assistant', text: child.text, runId, createdAt: new Date().toISOString() });
+            }
+            if (text !== undefined)
+                await this.appendMessage(conversationId, { id: `msg-${randomUUID()}`, role: 'assistant', text, runId, createdAt: new Date().toISOString() });
+            const current = await this.readManifest(conversationId);
+            const artifacts = [...runtime.state.results.values()].flatMap((result) => { const value = result.value; if (!value || typeof value !== 'object' || Array.isArray(value))
+                return []; const record = value; if (typeof record.path !== 'string' || typeof record.hash !== 'string' || typeof record.bytes !== 'number')
+                return []; return [{ path: record.path, hash: record.hash, bytes: record.bytes, ...(typeof record.mediaType === 'string' ? { mediaType: record.mediaType } : {}), ...(typeof record.label === 'string' ? { label: record.label } : {}), runId }]; });
+            current.artifacts = [...(current.artifacts ?? []).filter((item) => item.runId !== runId), ...artifacts];
+            if (current.activeRunId === runId)
+                delete current.activeRunId;
+            current.updatedAt = new Date().toISOString();
+            await writeFile(this.manifestPath(conversationId), JSON.stringify(current, null, 2));
+            this.active.delete(runId);
+            this.approvedToolCalls.delete(runId);
+            await runtime.flushPersistence();
+            await writeFile(join(this.runDir(conversationId, runId), 'outcome.json'), JSON.stringify({ schemaVersion: 1, ...outcome, ...(text === undefined ? {} : { text }), completedAt: new Date().toISOString() }, null, 2));
+            return { ...outcome, ...(text === undefined ? {} : { text }) };
+        })().finally(async () => { await this.releaseConversationLock(conversationId); });
+        const events = this.projectEvents(conversationId, runId, runtime, session, finish);
         return { id: runId, conversationId, events, outcome: finish, cancel: async (reason = 'USER_REQUESTED') => { await session.cancel(reason); }, reply: async (effectId, value) => { const effect = runtime.state.effects.get(effectId); const approved = value && typeof value === 'object' && !Array.isArray(value) && value.approved === true; if (approved && effect?.kind === 'human' && effect.input && typeof effect.input === 'object' && !Array.isArray(effect.input)) {
                 const calls = effect.input.tools;
                 if (Array.isArray(calls)) {
@@ -445,7 +468,8 @@ export class LocalHost {
                         if (call && typeof call === 'object' && !Array.isArray(call) && typeof call.toolCallId === 'string')
                             approvedIds.add(call.toolCallId);
                 }
-            } await session.reply(effectId, value); } };
+            } await session.reply(effectId, value); }, submitHumanInput: async (text, targetEffectId) => { if (!text.trim())
+                throw new Error('MESSAGE_REQUIRED'); const inputId = `human-${randomUUID()}`; await this.appendMessage(conversationId, { id: `msg-${randomUUID()}`, role: 'user', text, runId, createdAt: new Date().toISOString() }); await session.submitHumanInput(inputId, { text }, targetEffectId); } };
     }
     async sendMessage(conversationId, input) {
         if (!input.text.trim())
@@ -474,6 +498,7 @@ export class LocalHost {
             const { runtime, registry } = this.runtimeFor(conversationId, runId, manifest.cwd);
             const program = buildProgram(registry.list().map((tool) => tool.name), manifest.cwd)(this.options.approvalMode ?? 'ask');
             runtime.register(program);
+            runtime.setHumanInputProgram(program);
             const { agentId } = runtime.createAgent({ goal, program });
             const session = runtime.start(agentId);
             this.active.set(runId, { runtime, session, conversationId, runId });
@@ -498,8 +523,10 @@ export class LocalHost {
             return this.makeRunHandle(conversationId, runId, existing.runtime, existing.session);
         await this.acquireConversationLock(conversationId, runId);
         try {
-            const { runtime } = await this.restoreRuntimeFor(conversationId, runId, manifest.cwd);
-            const agent = [...runtime.state.agents.values()][0];
+            const { runtime, registry } = await this.restoreRuntimeFor(conversationId, runId, manifest.cwd);
+            const interactionProgram = buildProgram(registry.list().map((tool) => tool.name), manifest.cwd)(this.options.approvalMode ?? 'ask');
+            runtime.setHumanInputProgram(interactionProgram);
+            const agent = [...runtime.state.agents.values()].find((candidate) => candidate.parentAgentId === undefined);
             if (!agent)
                 throw new Error('RESTORED_AGENT_NOT_FOUND');
             const session = runtime.start(agent.id);
@@ -525,6 +552,22 @@ export class LocalHost {
         return JSON.stringify(first); const firstRecord = first; const textRef = firstRecord.textRef; const value = typeof textRef === 'string' ? runtime.state.results.get(textRef)?.value : first; if (typeof value === 'string')
         return value; if (value && typeof value === 'object' && !Array.isArray(value) && typeof value.text === 'string')
         return value.text; return value === undefined ? undefined : JSON.stringify(value, null, 2); }
+    interactionResultTexts(runtime, rootAgentId) {
+        const descendants = new Set();
+        const visit = (parentId) => {
+            for (const agent of runtime.state.agents.values()) {
+                if (agent.parentAgentId !== parentId || descendants.has(agent.id))
+                    continue;
+                descendants.add(agent.id);
+                visit(agent.id);
+            }
+        };
+        visit(rootAgentId);
+        return [...runtime.state.agents.values()]
+            .filter((agent) => descendants.has(agent.id))
+            .map((agent) => ({ agentId: agent.id, text: this.resultText(runtime, runtime.state.lanes.get(agent.rootLaneId)?.resultRef) }))
+            .filter((item) => item.text !== undefined && item.text.length > 0);
+    }
     toolSettlementObservation(runId, effectId, data) {
         const effect = this.active.get(runId)?.runtime.state.effects.get(effectId);
         if (effect?.kind !== 'tool')
@@ -537,14 +580,18 @@ export class LocalHost {
         const args = input.arguments && typeof input.arguments === 'object' && !Array.isArray(input.arguments) ? input.arguments : {};
         return { tool: input.name, toolCallId: effect.toolCallId ?? effectId, args, status, ...(outcome.error === undefined ? {} : { result: outcome.error }) };
     }
-    async *projectEvents(conversationId, runId, session, finish) {
+    async *projectEvents(conversationId, runId, runtime, session, finish) {
         let seq = 0;
+        const textAgents = new Set();
         for await (const event of session.stream()) {
             seq++;
             if (event.kind === 'observation') {
                 const observation = event.observation;
-                if (observation.type === 'chunk')
+                if (observation.type === 'chunk') {
+                    if (typeof observation.agentId === 'string')
+                        textAgents.add(observation.agentId);
                     yield { schemaVersion: 1, type: 'text', conversationId, runId, seq, data: observation.data ?? '' };
+                }
                 else
                     yield { schemaVersion: 1, type: 'observation', conversationId, runId, seq, data: event.observation ?? null };
                 continue;
@@ -571,6 +618,21 @@ export class LocalHost {
         }
         try {
             const outcome = await finish();
+            // Some adapters only return a final LLM message and do not stream
+            // observations. Project that result here so CLI/web clients still get a
+            // visible answer. Child interaction Agents use the same fallback and
+            // are emitted before the root answer in creation order.
+            const agentTexts = [
+                ...this.interactionResultTexts(runtime, session.agentId),
+                ...(outcome.text === undefined ? [] : [{ agentId: session.agentId, text: outcome.text }]),
+            ];
+            for (const item of agentTexts) {
+                if (textAgents.has(item.agentId) || item.text.length === 0)
+                    continue;
+                seq++;
+                textAgents.add(item.agentId);
+                yield { schemaVersion: 1, type: 'text', conversationId, runId, seq, data: item.text };
+            }
             yield { schemaVersion: 1, type: 'complete', conversationId, runId, seq: seq + 1, data: { status: outcome.status } };
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunterzhu/pulse-server",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "repository": {
     "type": "git",
     "url": "https://github.com/zhuhengtan/Pulse"
@@ -16,9 +16,9 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@hunterzhu/pulse-adapters": "0.1.5",
-    "@hunterzhu/pulse-runtime": "0.1.5",
-    "@hunterzhu/pulse-tool-sdk": "0.1.5",
+    "@hunterzhu/pulse-adapters": "0.1.6",
+    "@hunterzhu/pulse-runtime": "0.1.6",
+    "@hunterzhu/pulse-tool-sdk": "0.1.6",
     "zod": "^3.24.1"
   }
 }