praxis-agent 0.45.3 → 0.46.0

package/dist/core/runtime.js

@@ -255,13 +255,58 @@ export class AgentRuntime {
         this.options = options;
     }
     async run(request) {
+        const steering = request.steering;
+        const rejectSteering = (reason) => {
+            for (const item of steering?.close() ?? []) {
+                this.emit({
+                    type: 'user-input-rejected',
+                    id: item.id,
+                    content: item.content,
+                    reason,
+                });
+            }
+        };
+        const cancelWithSteering = () => {
+            rejectSteering('cancelled');
+            return this.cancel();
+        };
+        const deliverSteering = async (item) => {
+            try {
+                if (!request.observer?.userInputDelivered) {
+                    throw new Error('Active-turn steering requires a durable delivery observer');
+                }
+                await request.observer.userInputDelivered(item);
+            }
+            catch (error) {
+                this.emit({
+                    type: 'user-input-rejected',
+                    id: item.id,
+                    content: item.content,
+                    reason: 'failed',
+                });
+                throw error;
+            }
+            messages.push({ role: 'user', content: item.content });
+            this.emit({
+                type: 'user-input-delivered',
+                id: item.id,
+                content: item.content,
+            });
+        };
+        const deliverNextSteering = async () => {
+            const item = steering?.take();
+            if (!item)
+                return false;
+            await deliverSteering(item);
+            return true;
+        };
         const failurePresentationDeferred = (kind) => request.deferFailureKinds === true ||
             request.deferFailureKinds?.includes(kind) === true;
         if (this.options.emitInitialContextState !== false) {
             this.emit({ type: 'state', state: 'assembling-context' });
         }
         if (request.signal?.aborted)
-            return this.cancel();
+            return cancelWithSteering();
         const messages = [...request.messages];
         let usage = emptyUsage();
         let modelUsage = emptyUsage();
@@ -295,7 +340,7 @@ export class AgentRuntime {
                 activeAttemptHasPresentation = false;
                 activeAttemptDiscarded = false;
                 if (request.signal?.aborted)
-                    return this.cancel();
+                    return cancelWithSteering();
                 if (maxModelTurns !== undefined && modelTurns >= maxModelTurns) {
                     throw new Error(`Maximum model turns of ${maxModelTurns} exceeded`);
                 }
@@ -399,7 +444,7 @@ export class AgentRuntime {
                 try {
                     for await (const event of this.provider.complete(providerRequest)) {
                         if (request.signal?.aborted)
-                            return this.cancel();
+                            return cancelWithSteering();
                         if (terminalReason !== undefined) {
                             throw new ModelProviderError(`Provider emitted ${event.type} after terminal reason ${terminalReason}`, { retryable: false });
                         }
@@ -499,7 +544,7 @@ export class AgentRuntime {
                     }
                     await toolScheduler.settle().catch(() => undefined);
                     if (request.signal?.aborted)
-                        return this.cancel();
+                        return cancelWithSteering();
                     throw error;
                 }
                 finally {
@@ -582,6 +627,11 @@ export class AgentRuntime {
                 messages.push(assistantMessage);
                 toolScheduler.releaseExclusiveTools();
                 if (toolCalls.length === 0) {
+                    const preStopSteering = steering?.take();
+                    if (preStopSteering !== undefined) {
+                        await deliverSteering(preStopSteering);
+                        continue;
+                    }
                     const stopResult = (await request.onStop?.(text)) ?? [];
                     const stopBatch = Array.isArray(stopResult)
                         ? null
@@ -617,11 +667,16 @@ export class AgentRuntime {
                         if (request.reloadMessages) {
                             const reloadedMessages = await request.reloadMessages();
                             if (request.signal?.aborted)
-                                return this.cancel();
+                                return cancelWithSteering();
                             messages.splice(0, messages.length, ...reloadedMessages);
                         }
                         continue;
                     }
+                    const completionInput = steering?.takeOrSeal();
+                    if (completionInput !== undefined) {
+                        await deliverSteering(completionInput);
+                        continue;
+                    }
                     this.emit({ type: 'state', state: 'completed' });
                     const modelUsage = modelUsageByModel.size === 0
                         ? undefined
@@ -709,14 +764,18 @@ export class AgentRuntime {
                 if (request.reloadMessages) {
                     const reloadedMessages = await request.reloadMessages();
                     if (request.signal?.aborted)
-                        return this.cancel();
+                        return cancelWithSteering();
                     messages.splice(0, messages.length, ...reloadedMessages);
                 }
+                await deliverNextSteering();
             }
         }
         catch (error) {
-            if (request.signal?.aborted)
+            if (request.signal?.aborted) {
+                rejectSteering('cancelled');
                 return this.cancel();
+            }
+            rejectSteering('failed');
             const message = error instanceof Error ? error.message : String(error);
             const retryable = error instanceof ModelProviderError ? error.retryable : false;
             const kind = error instanceof ModelProviderError

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "praxis-agent",
-  "version": "0.45.3",
+  "version": "0.46.0",
   "description": "Local-first, single-user general agent for the command line.",
   "license": "MIT",
   "author": "wuqisen",