praxis-agent 0.54.0 → 0.55.0

package/README.md

@@ -253,11 +253,16 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
   recovery for malformed streamed tool arguments without tool execution or
   lost resumability, one default-on bounded Anthropic non-streaming replay for
   eligible stream/idle failures without exposing failed-attempt output, and
-  token-only/no-API-dollar accounting for subscription runs. For each main user
-  turn, failed provider attempts stay buffered; the first successful route,
-  whether primary or fallback, is sticky and sealed through that turn's tool
-  continuations; incompatible fallback routes fail closed, and each new main
-  user turn starts from primary.
+  token-only/no-API-dollar accounting for subscription runs. Each main user
+  Turn and independent auxiliary Agent, Workflow, Team, recovery, or memory
+  Turn receives its own provider client. Session-memory requests reuse a
+  completion-scoped client but restart routing from primary for each request;
+  auto-mode critic and eval-judge requests remain independently constructed
+  one-shot clients. Failed attempts stay buffered, and the first successful
+  route, whether primary or fallback, stays sticky only through that logical
+  Turn's tool continuations; incompatible routes fail closed, and the next
+  independent Turn starts from primary. Recovery may persist only an optional
+  selected model, never provider route or wire state.
 - **Transactional self-update** — `praxis update` verifies the package before
   installing it, rejects concurrent updates, and can roll back after an
   interruption or crash.

package/dist/application/native-sidechain-transcript.d.ts

@@ -7,6 +7,8 @@ export interface NativeSidechainMetadata {
     readonly spawnDepth: number;
     readonly cwd: string;
     readonly promptId: string;
+    /** Provider-neutral selected model identifier for recovery. */
+    readonly model?: string;
     readonly name?: string;
     readonly permissionMode?: NativeSidechainPermissionMode;
     readonly isolation?: 'worktree';

package/dist/application/native-sidechain-transcript.js

@@ -19,6 +19,7 @@ const requiredKeys = [
     'promptId',
 ];
 const optionalKeys = [
+    'model',
     'name',
     'permissionMode',
     'isolation',
@@ -74,6 +75,8 @@ function validateMetadata(value) {
         throw new Error('native sidechain metadata cwd is invalid');
     if (!nonBlank(record.promptId))
         throw new Error('native sidechain metadata promptId is invalid');
+    if (record.model !== undefined && !nonBlank(record.model))
+        throw new Error('native sidechain metadata model is invalid');
     if (record.name !== undefined && !nonBlank(record.name))
         throw new Error('native sidechain metadata name is invalid');
     if (record.permissionMode !== undefined &&

package/dist/application/session-service.js

@@ -1117,6 +1117,9 @@ export class ClaudeSessionService {
                 ...(this.options.providerForModel
                     ? { providerForModel: this.options.providerForModel }
                     : {}),
+                ...(this.options.providerForTurn
+                    ? { providerForTurn: this.options.providerForTurn }
+                    : {}),
                 baseTools: wrappedBase,
                 ...(this.options.deferMcpTools === undefined
                     ? {}
@@ -2858,6 +2861,9 @@ export class ClaudeSessionService {
                         ...(this.options.providerForModel
                             ? { providerForModel: this.options.providerForModel }
                             : {}),
+                        ...(this.options.providerForTurn
+                            ? { providerForTurn: this.options.providerForTurn }
+                            : {}),
                         baseTools,
                         ...(this.options.deferMcpTools === undefined
                             ? {}

package/dist/application/subagent-service.d.ts

@@ -76,6 +76,7 @@ export interface ClaudeSubagentExecutorOptions {
     maxCalls?: number;
     maxOutputBytes?: number;
     providerForModel?: (model: string) => ModelProvider;
+    providerForTurn?: (model?: string) => ModelProvider;
     toolNames?: readonly string[];
     backgroundTaskNotifications?: (waitForRunning: boolean) => Promise<string[]>;
     notificationDelivered?: (notification: {
@@ -117,6 +118,7 @@ export declare class ClaudeSubagentExecutor {
     sendBackgroundMessage(agentId: string, message: string, summary: string | undefined, toolUseId: string): string;
     stopAllBackgroundTasks(): readonly string[];
     private cwd;
+    private providerForTurn;
     private agentDefinition;
     private resolveAgentInput;
     registry(sessionId: string, depth: number, promptIdForCall: (callId: string) => string | null, parentAgentId?: string): ToolRegistry;

package/dist/application/subagent-service.js

@@ -586,6 +586,15 @@ export class ClaudeSubagentExecutor {
     cwd() {
         return this.options.cwdProvider?.() ?? this.options.cwd;
     }
+    providerForTurn(model) {
+        if (this.options.providerForTurn) {
+            return this.options.providerForTurn(model);
+        }
+        if (model !== undefined) {
+            return this.options.providerForModel?.(model) ?? this.options.provider;
+        }
+        return this.options.provider;
+    }
     agentDefinition(input) {
         return this.options.extensions?.agent(input.subagentType) ?? null;
     }
@@ -753,7 +762,9 @@ export class ClaudeSubagentExecutor {
             !this.options.extensions?.agent(input.subagentType)) {
             throw new Error(`Unknown Claude agent ${input.subagentType}`);
         }
-        if (input.model && !this.options.providerForModel) {
+        if (input.model &&
+            !this.options.providerForModel &&
+            !this.options.providerForTurn) {
             throw new Error('Agent model overrides are unavailable for this provider');
         }
         if (input.permissionMode &&
@@ -850,6 +861,7 @@ export class ClaudeSubagentExecutor {
                 ...(input.permissionMode
                     ? { permissionMode: input.permissionMode }
                     : {}),
+                ...(input.model ? { model: input.model } : {}),
                 ...(input.isolation ? { isolation: input.isolation } : {}),
                 ...(parentAgentId ? { parentAgentId } : {}),
                 ...(initialIsolation ? { worktreePath: initialIsolation.cwd } : {}),
@@ -863,9 +875,7 @@ export class ClaudeSubagentExecutor {
         catch (error) {
             return settleInitialSetupFailure(error, initialIsolation);
         }
-        const provider = input.model
-            ? (this.options.providerForModel?.(input.model) ?? this.options.provider)
-            : this.options.provider;
+        const provider = this.providerForTurn(input.model);
         const backgroundRun = this.createBackgroundAgentRun({
             input,
             parentCwd,
@@ -874,11 +884,14 @@ export class ClaudeSubagentExecutor {
             ...(initialIsolation ? { initialIsolation } : {}),
             createIsolation: () => this.createAgentWorktree(paths.praxisRoot, sessionId, agentId, parentCwd),
             execute: async (cwd, message, signal, continuation) => {
+                const turnProvider = continuation
+                    ? this.providerForTurn(input.model)
+                    : provider;
                 const run = (lease) => this.runSidechain({
                     ...lease,
                     sessionId,
                     input,
-                    provider,
+                    provider: turnProvider,
                     agentId,
                     spawnDepth,
                     promptId,
@@ -1346,13 +1359,12 @@ export class ClaudeSubagentExecutor {
             !this.options.extensions?.agent(options.agentType)) {
             throw new Error(`Unknown Claude agent ${options.agentType}`);
         }
-        if (options.model && !this.options.providerForModel) {
+        if (options.model &&
+            !this.options.providerForModel &&
+            !this.options.providerForTurn) {
             throw new Error('Workflow agent model overrides are unavailable for this provider');
         }
-        const provider = options.model
-            ? (this.options.providerForModel?.(options.model) ??
-                this.options.provider)
-            : this.options.provider;
+        const provider = this.providerForTurn(options.model);
         const input = {
             description: options.label ?? 'Workflow agent',
             prompt: options.prompt,
@@ -1395,6 +1407,7 @@ export class ClaudeSubagentExecutor {
                 spawnDepth: 1,
                 cwd: agentCwd,
                 promptId: options.promptId,
+                ...(input.model ? { model: input.model } : {}),
                 ...(options.isolation ? { isolation: options.isolation } : {}),
                 ...(isolation ? { worktreePath: isolation.cwd } : {}),
             });
@@ -1716,11 +1729,11 @@ export class ClaudeSubagentExecutor {
             prompt,
             subagentType: agentType,
             ...(name ? { name } : {}),
+            ...(metadata?.model ? { model: metadata.model } : {}),
             ...(permissionMode ? { permissionMode } : {}),
             ...(isolation ? { isolation } : {}),
             runInBackground: true,
         };
-        const provider = this.options.provider;
         const recoveredPromptId = metadata?.promptId ?? randomUUID();
         const backgroundRun = this.createBackgroundAgentRun({
             input,
@@ -1731,6 +1744,9 @@ export class ClaudeSubagentExecutor {
             ...(restoredIsolation ? { initialIsolation: restoredIsolation } : {}),
             createIsolation: () => this.createAgentWorktree(paths.praxisRoot, sessionId, agentId, parentCwd),
             execute: async (cwd, message, signal, continuation) => {
+                // Recovery never restores provider-native route state. Each recovered
+                // execution, including every later follow-up, gets a fresh turn.
+                const provider = this.providerForTurn(input.model);
                 const run = (lease) => this.runSidechain({
                     ...lease,
                     sessionId,
@@ -1757,7 +1773,7 @@ export class ClaudeSubagentExecutor {
             prompt,
             toolUseId,
             outputFile: sidechainPaths.transcriptFile,
-            resolvedModel: provider.model ?? 'praxis/provider',
+            resolvedModel: metadata?.model ?? this.options.provider.model ?? 'praxis/provider',
             lifecycle: backgroundRun.lifecycle,
             run: backgroundRun.run,
             markBackground: backgroundRun.markBackground,

package/dist/application/team-agent-runtime.d.ts

@@ -14,6 +14,7 @@ export interface ClaudeTeamAgentRuntimeOptions {
     readonly hooks?: ClaudeHookRunner;
     readonly contextAssembler?: ContextAssembler;
     readonly providerForModel?: (model: string) => ModelProvider;
+    readonly providerForTurn?: (model?: string) => ModelProvider;
     readonly permissionResolverForMode?: (mode: AgentPermissionMode) => PermissionResolver;
     readonly eventSink?: RuntimeEventSink;
     readonly approveTool?: (call: ModelToolCall, originalCall?: ModelToolCall, decision?: PermissionDecision) => PermissionApproval | Promise<PermissionApproval>;

package/dist/application/team-agent-runtime.js

@@ -79,6 +79,9 @@ export class ClaudeTeamAgentRuntime {
             ...(this.options.providerForModel
                 ? { providerForModel: this.options.providerForModel }
                 : {}),
+            ...(this.options.providerForTurn
+                ? { providerForTurn: this.options.providerForTurn }
+                : {}),
             ...(this.options.permissionResolverForMode
                 ? {
                     permissionResolverForMode: this.options.permissionResolverForMode,

package/dist/cli-runtime.js

@@ -1477,9 +1477,11 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
         });
     if (memoryDirectory)
         await mkdir(memoryDirectory, { recursive: true });
-    const projectMemoryProviderFactory = providerForMainModel && model
-        ? () => providerForMainModel(model)
-        : undefined;
+    const projectMemoryProviderFactory = providerForTurn
+        ? () => providerForTurn()
+        : providerForMainModel && model
+            ? () => providerForMainModel(model)
+            : undefined;
     const projectMemoryRecall = projectMemoryPolicy.recall &&
         memoryDirectory &&
         projectMemoryProviderFactory
@@ -1911,6 +1913,7 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
                     ...(hooks ? { hooks } : {}),
                     ...(contextAssembler ? { contextAssembler } : {}),
                     ...(providerForModel ? { providerForModel } : {}),
+                    ...(providerForTurn ? { providerForTurn } : {}),
                     permissionResolverForMode,
                     eventSink: runtimeEventSink,
                 }),

package/package.json

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