praxis-agent 0.20.11 → 0.20.16

package/dist/application/scheduled-prompt-manager.d.ts

@@ -1,4 +1,9 @@
 import { type ClaudeScheduledTask } from '../persistence/claude-scheduled-task-store.js';
+export declare const MAX_JOBS = 50;
+export declare class ScheduledJobLimitError extends Error {
+    readonly maxJobs: number;
+    constructor(maxJobs: number);
+}
 export interface ScheduledPromptManagerOptions {
     filePath: string;
     lockFile: string;

package/dist/application/scheduled-prompt-manager.js

@@ -2,7 +2,7 @@ import { execFile } from 'node:child_process';
 import { randomBytes } from 'node:crypto';
 import { promisify } from 'node:util';
 import { CronExpressionParser } from 'cron-parser';
-import { ClaudeScheduledTaskStore, } from '../persistence/claude-scheduled-task-store.js';
+import { ClaudeScheduledTaskLimitError, ClaudeScheduledTaskStore, } from '../persistence/claude-scheduled-task-store.js';
 const execFileAsync = promisify(execFile);
 const RECURRING_LIFETIME_MS = 7 * 24 * 60 * 60 * 1_000;
 const MIN_DYNAMIC_WAKEUP_SECONDS = 60;
@@ -11,6 +11,15 @@ const DYNAMIC_CACHE_TTL_MS = 300_000;
 const DEFAULT_DYNAMIC_CACHE_LEAD_MS = 15_000;
 const MAX_TIMER_MS = 2_147_000_000;
 const DURABLE_REFRESH_MS = 5_000;
+export const MAX_JOBS = 50;
+export class ScheduledJobLimitError extends Error {
+    maxJobs;
+    constructor(maxJobs) {
+        super(`Scheduled job limit reached: at most ${maxJobs} active scheduled jobs. Delete or wait for an existing job before scheduling another.`);
+        this.maxJobs = maxJobs;
+        this.name = 'ScheduledJobLimitError';
+    }
+}
 function nextOccurrence(cron, after) {
     return CronExpressionParser.parse(cron, {
         currentDate: new Date(after),
@@ -131,7 +140,15 @@ export class ScheduledPromptManager {
         };
         let task;
         if (input.durable) {
-            task = await this.store.create(base);
+            try {
+                task = await this.store.create(base, { maxJobs: MAX_JOBS });
+            }
+            catch (error) {
+                if (error instanceof ClaudeScheduledTaskLimitError) {
+                    throw new ScheduledJobLimitError(MAX_JOBS);
+                }
+                throw error;
+            }
         }
         else {
             const occupied = new Set((await this.list()).map(({ id }) => id));

package/dist/cli/interactive.js

@@ -5626,7 +5626,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         }
         editComposer();
     });
-    return (_jsx(TuiThemeProvider, { settings: themeSettings, children: _jsx(Box, { flexDirection: "column", children: selectingSession ? (_jsx(SessionPicker, { sessions: filteredPickerChoices, selectedIndex: selectedIndex, screenReader: axScreenReader, query: sessionSearch })) : (_jsxs(_Fragment, { children: [!axScreenReader && history.length === 0 && !sessionId ? (_jsx(WelcomePanel, { display: runtimeDisplay, width: width })) : null, sessionId ? (_jsxs(Text, { dimColor: true, children: ["Session ", sessionId.slice(0, 8)] })) : null, _jsx(Transcript, { items: history, activeText: activeText, activeThinking: activeThinking, thinkingExpanded: thinkingExpanded, detailedTranscript: thinkingExpanded || runtimeSettings.verbose, screenReader: axScreenReader }), externalEditorRequest !== null ||
+    return (_jsx(TuiThemeProvider, { settings: themeSettings, children: _jsx(Box, { flexDirection: "column", children: selectingSession ? (_jsx(SessionPicker, { sessions: filteredPickerChoices, selectedIndex: selectedIndex, screenReader: axScreenReader, query: sessionSearch })) : (_jsxs(_Fragment, { children: [!axScreenReader && history.length === 0 && !sessionId ? (_jsx(WelcomePanel, { display: runtimeDisplay, width: width, showTips: runtimeSettings.tips })) : null, sessionId ? (_jsxs(Text, { dimColor: true, children: ["Session ", sessionId.slice(0, 8)] })) : null, _jsx(Transcript, { items: history, activeText: activeText, activeThinking: activeThinking, thinkingExpanded: thinkingExpanded, detailedTranscript: thinkingExpanded || runtimeSettings.verbose, screenReader: axScreenReader }), externalEditorRequest !== null ||
                         keybindingsEditing ||
                         memoryEditorRequest !== null ? (_jsx(ExternalEditorWait, { screenReader: axScreenReader })) : permission ? (permission.kind === 'tool' && toolPermissionModel ? (_jsx(ToolPermissionDialog, { model: toolPermissionModel, selection: permissionSelection, feedbackMode: permissionFeedbackMode, feedback: input, ruleEditor: permissionRuleEditor, screenReader: axScreenReader })) : (_jsxs(DialogFrame, { title: `Retry interrupted ${permission.call.name}?`, screenReader: axScreenReader, children: [_jsx(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: _jsx(Text, { bold: true, children: describeTool(permission.call, sensitiveValues) }) }), _jsx(Text, { children: "Do you want to proceed?" }), _jsxs(Text, { inverse: !axScreenReader && permissionSelection === 0, children: [selectionPrefix(permissionSelection === 0, axScreenReader), "1. Yes"] }), _jsxs(Text, { inverse: !axScreenReader && permissionSelection === 1, children: [selectionPrefix(permissionSelection === 1, axScreenReader), "2. No"] }), permissionFeedbackMode ? (_jsxs(Text, { children: ["\u203A", ' ', input ||
                                         (permissionSelection === 0

package/dist/cli/tui/claude-style.d.ts

@@ -71,10 +71,11 @@ export interface TuiBtwEntry {
     error?: string;
 }
 export declare function useTerminalWidth(override?: number): number;
-export declare function WelcomePanel({ display, width, }: {
+export declare function WelcomePanel({ display, width, showTips, }: {
     display: TuiDisplayMetadata;
     width: number;
-}): import("react").JSX.Element;
+    showTips: boolean;
+}): import("react").JSX.Element | null;
 export declare function MarkdownText({ text }: {
     text: string;
 }): ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;

package/dist/cli/tui/claude-style.js

@@ -49,17 +49,23 @@ function selectionPrefix(selected, screenReader) {
         return screenReader ? 'Selected: ' : '  ❯ ';
     return screenReader ? '' : '    ';
 }
-export function WelcomePanel({ display, width, }) {
+export function WelcomePanel({ display, width, showTips, }) {
     const palette = useTuiPalette();
+    if (!showTips)
+        return null;
     const panelWidth = Math.min(100, Math.max(32, width));
     const wide = panelWidth >= 68;
     const brand = 'Praxis';
-    // Claude 2.1.208 embeds the title in the top border row:
-    //   ╭───Claude Code v2.1.208 ───...───╮
-    // Title block = "╭" + "───" + "Praxis Code vX.Y.Z" + " " = 4 + title.length + 1 chars.
-    const title = `${brand} Code v${display.version}`;
-    const fill = Math.max(1, panelWidth - title.length - 6);
-    return (_jsxs(Box, { flexDirection: "column", width: panelWidth, children: [_jsxs(Text, { color: palette.muted, children: ['╭───', _jsx(Text, { color: palette.brand, bold: true, children: brand }), ` Code v${display.version} `, _jsx(Text, { dimColor: true, children: '─'.repeat(fill) }), '╮'] }), _jsx(Box, { borderStyle: "round", borderColor: palette.muted, borderTop: false, flexDirection: "column", width: panelWidth, paddingX: 1, children: _jsxs(Box, { flexDirection: wide ? 'row' : 'column', children: [_jsxs(Box, { alignItems: wide ? 'center' : undefined, flexDirection: "column", width: wide ? '50%' : '100%', children: [_jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Welcome back!" }), _jsx(Text, { children: " " }), _jsx(Text, { color: palette.brand, bold: true, children: "\u2590\u259B\u2588\u2588\u2588\u259C\u258C" }), _jsx(Text, { color: palette.brand, children: "\u259D\u259C\u2588\u2588\u2588\u2588\u2588\u259B\u2598" }), _jsx(Text, { color: palette.brand, children: " \u2598\u2598 \u259D\u259D" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [display.model ?? 'provider default', display.effort ? (_jsxs(Text, { dimColor: true, children: [" \u00B7 ", display.effort, " effort"] })) : null] }), _jsx(Text, { dimColor: true, children: compactPath(display.cwd) })] }), _jsxs(Box, { flexDirection: "column", width: wide ? '50%' : '100%', marginTop: wide ? 0 : 1, children: [_jsx(Text, { bold: true, children: "Tips for getting started" }), _jsx(Text, { children: "Run /init to create a CLAUDE.md file with instructions for Claude" }), _jsx(Text, { dimColor: true, children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" }), _jsx(Text, { bold: true, children: "What's new" }), _jsx(Text, { children: 'Subagent forking is now on by default: a `subagent_type: "fork"` subagent inherits the full conversation and prompt cache, and non-teammate agent spawns in interactive sessions now run in the background by default' }), _jsx(Text, { children: 'Type `@` in the prompt to mention another Claude session by name; Claude then uses `SendMessage` to reach that session directly' }), _jsx(Text, { children: '`SendMessage` now delivers to a bare name that exactly matches one live session, instead of asking to confirm with a ref first' }), _jsx(Text, { dimColor: true, children: "/release-notes for more" })] })] }) })] }));
+    const model = display.model ?? 'provider default';
+    const effort = display.effort ? ` · ${display.effort} effort` : '';
+    const cwd = compactPath(display.cwd);
+    // Title lives in the top border row:
+    //   ╭───Praxis Code vX.Y.Z ───...───╮
+    // Fixed prefix/suffix = "╭───"(4) + "Praxis"(6) + " Code vX.Y.Z "(8 + version)
+    // + "╮"(1), so the fill keeps the row exactly at panelWidth.
+    const fill = Math.max(1, panelWidth - display.version.length - 19);
+    const identity = `Welcome to ${brand} · ${model}${effort} · ${cwd}`;
+    return (_jsxs(Box, { flexDirection: "column", width: panelWidth, children: [_jsxs(Text, { color: palette.muted, children: ['╭───', _jsx(Text, { color: palette.brand, bold: true, children: brand }), ` Code v${display.version} `, _jsx(Text, { dimColor: true, children: '─'.repeat(fill) }), '╮'] }), wide ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: identity }), _jsx(Text, { children: "/init to create CLAUDE.md \u00B7 /config to open settings" })] })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["Welcome to ", brand] }), _jsxs(Text, { children: [model, effort] }), _jsx(Text, { children: cwd }), _jsx(Text, { children: "/init to create CLAUDE.md" }), _jsx(Text, { children: "/config to open settings" })] }))] }));
 }
 const INLINE_SEGMENT_CACHE_MAX = 4096;
 const inlineSegmentCache = new Map();

package/dist/cli-runtime.d.ts

@@ -7,6 +7,7 @@ import { type ModelDocument, type ModelImage, type ModelProvider, type ModelTool
 import type { InteractiveResumeOptions, InteractiveServiceFactory } from './cli/interactive.js';
 import type { TuiSlashCommand } from './cli/tui/slash-commands.js';
 import { type TuiHookConfiguration } from './cli/tui/hook-settings.js';
+import { type PraxisRuntimeSettings } from './cli/tui/runtime-settings.js';
 import { type ClaudePermissionMode } from './permissions/claude-permission-resolver.js';
 import { type ClaudeMcpServerStatus, type ClaudeMcpToolInspection } from './mcp/claude-mcp-tools.js';
 import { authenticateMcpServer } from './mcp/claude-mcp-oauth.js';
@@ -164,6 +165,14 @@ export interface CliDependencies extends InteractiveServiceFactory {
         force?: boolean;
     }) => Promise<SelfUpdateResult>;
 }
+/**
+ * Shared runtime model precedence used by every consumer (provider
+ * construction, status/doctor output, and the interactive display):
+ * explicit CLI selection > non-empty PRAXIS_MODEL > Praxis settings model,
+ * with the configured default (settings.model === 'default') falling through
+ * to the existing default behavior (undefined).
+ */
+export declare function resolveRuntimeModel(explicitModel: string | undefined, environment: NodeJS.ProcessEnv, settings: PraxisRuntimeSettings | undefined): string | undefined;
 export declare function createDefaultDependencies(entrypoint?: string): CliDependencies;
 export declare function createBackgroundWorkerRuntime(workerSink: RuntimeEventSink, dispatch: {
     argv: string[];

package/dist/cli-runtime.js

@@ -695,6 +695,20 @@ const consoleIO = {
     isTTY: Boolean(process.stdin.isTTY && process.stdout.isTTY),
     readStdinLines: () => process.stdin,
 };
+/**
+ * Shared runtime model precedence used by every consumer (provider
+ * construction, status/doctor output, and the interactive display):
+ * explicit CLI selection > non-empty PRAXIS_MODEL > Praxis settings model,
+ * with the configured default (settings.model === 'default') falling through
+ * to the existing default behavior (undefined).
+ */
+export function resolveRuntimeModel(explicitModel, environment, settings) {
+    const envModel = environment.PRAXIS_MODEL;
+    const settingsModel = settings && settings.model !== 'default' ? settings.model : undefined;
+    return (explicitModel ??
+        (envModel !== undefined && envModel.trim() !== '' ? envModel : undefined) ??
+        settingsModel);
+}
 const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = false, approveRecovery, approveTool, agent, model: interactiveModel, effort: interactiveEffort, permissionMode: interactivePermissionMode, isSessionActionApproved, controls = DEFAULT_CLI_CONTROLS, interactive = false, sessionKind, signal, exposeToolRegistry = false, onElicitation, askUser, approvePlan, emitToolUseSummaries = false, cwd: requestedCwd, sandboxOriginalCwd, configRoot: requestedConfigRoot, environment, providerEnvironment: requestedProviderEnvironment, }) => {
     const runtimeEnvironment = requestedProviderEnvironment ?? process.env;
     const sandboxEnvironment = { ...runtimeEnvironment, ...environment };
@@ -740,7 +754,7 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
     let providerForMainModel;
     const context = parseContextEnvironment(runtimeEnvironment);
     const apiKey = runtimeEnvironment.PRAXIS_API_KEY;
-    const model = cli.model ?? runtimeEnvironment.PRAXIS_MODEL;
+    const model = resolveRuntimeModel(interactiveModel ?? controls.model, runtimeEnvironment, runtimeSettings);
     const providerEnvironment = apiKey && model
         ? parseProviderEnvironment(runtimeEnvironment)
         : cli.fileResources.length > 0
@@ -1300,7 +1314,9 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
         ];
         const runtimeInfo = {
             cwd: workspace.cwd(),
-            model: provider?.model ?? runtimeEnvironment.PRAXIS_MODEL ?? 'unknown',
+            model: provider?.model ??
+                resolveRuntimeModel(interactiveModel ?? controls.model, runtimeEnvironment, runtimeSettings) ??
+                'unknown',
             ...(provider?.capabilities.contextWindowTokens === undefined
                 ? {}
                 : { contextWindowTokens: provider.capabilities.contextWindowTokens }),
@@ -1457,7 +1473,7 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
                     cwd: workspace.cwd(),
                     model: service.model() ??
                         provider?.model ??
-                        runtimeEnvironment.PRAXIS_MODEL ??
+                        resolveRuntimeModel(interactiveModel ?? controls.model, runtimeEnvironment, runtimeSettings) ??
                         'unknown',
                 };
                 delete staticInfo.contextWindowTokens;
@@ -1498,7 +1514,12 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
 };
 const createDefaultAutoModeCritic = async ({ model }) => {
     const apiKey = process.env.PRAXIS_API_KEY;
-    const selectedModel = model ?? process.env.PRAXIS_MODEL;
+    const configRoot = resolve(process.env.CLAUDE_CONFIG_DIR ?? resolve(homedir(), '.claude'));
+    const runtimeSettings = await loadRuntimeSettings({
+        configRoot,
+        statePath: join(configRoot, '.claude.json'),
+    });
+    const selectedModel = resolveRuntimeModel(model, process.env, runtimeSettings);
     if (!apiKey || !selectedModel) {
         throw new Error('PRAXIS_API_KEY and a model (--model or PRAXIS_MODEL) are required');
     }
@@ -1657,6 +1678,18 @@ export function createDefaultDependencies(entrypoint = fileURLToPath(import.meta
             const { runInteractive } = await import('./cli/interactive.js');
             const interactiveControls = controls ?? DEFAULT_CLI_CONTROLS;
             const initialAdditionalDirectories = interactiveControls.addDirectories.map((directory) => realpathSync(resolve(process.cwd(), directory)));
+            const configuredRoot = process.env.CLAUDE_CONFIG_DIR || undefined;
+            const interactiveConfigRoot = resolve(configuredRoot ?? resolve(homedir(), '.claude'));
+            const interactiveStatePath = configuredRoot
+                ? join(interactiveConfigRoot, '.claude.json')
+                : resolve(homedir(), '.claude.json');
+            const interactiveRuntimeSettings = interactiveControls.safeMode || interactiveControls.bare
+                ? undefined
+                : await loadRuntimeSettings({
+                    configRoot: interactiveConfigRoot,
+                    statePath: interactiveStatePath,
+                });
+            const effectiveModel = resolveRuntimeModel(interactiveControls.model, process.env, interactiveRuntimeSettings);
             return runInteractive({
                 factory: {
                     createService: ({ additionalDirectories, cwd, ...options }) => createDefaultService({
@@ -1670,8 +1703,7 @@ export function createDefaultDependencies(entrypoint = fileURLToPath(import.meta
                         },
                         interactive: true,
                     }),
-                    scheduledPrompts: Boolean(process.env.PRAXIS_API_KEY &&
-                        (interactiveControls.model ?? process.env.PRAXIS_MODEL)),
+                    scheduledPrompts: Boolean(process.env.PRAXIS_API_KEY && effectiveModel),
                 },
                 ...(signal ? { signal } : {}),
                 ...(initialPrompt === undefined ? {} : { initialPrompt }),
@@ -1686,11 +1718,7 @@ export function createDefaultDependencies(entrypoint = fileURLToPath(import.meta
                 display: {
                     version: VERSION,
                     cwd: process.cwd(),
-                    ...(controls?.model
-                        ? { model: controls.model }
-                        : process.env.PRAXIS_MODEL
-                            ? { model: process.env.PRAXIS_MODEL }
-                            : {}),
+                    ...(effectiveModel === undefined ? {} : { model: effectiveModel }),
                     effort: controls?.effort ?? 'high',
                     permissionMode: controls?.dangerouslySkipPermissions
                         ? 'bypassPermissions'
@@ -2090,6 +2118,7 @@ async function executeDoctorCommand(args, invocation, io) {
         configRoot,
         statePath: claudeStatePath,
     });
+    const effectiveModel = resolveRuntimeModel(invocation.model, process.env, runtimeSettings);
     const report = await runDoctor({
         version: VERSION,
         executablePath: fileURLToPath(import.meta.url),
@@ -2098,7 +2127,9 @@ async function executeDoctorCommand(args, invocation, io) {
         configRoot,
         claudeStatePath,
         cwd: process.cwd(),
-        environment: process.env,
+        environment: effectiveModel === undefined
+            ? process.env
+            : { ...process.env, PRAXIS_MODEL: effectiveModel },
         autoUpdateChannel: runtimeSettings.autoUpdatesChannel,
         ...(process.argv[1] === undefined
             ? {}
@@ -3159,12 +3190,18 @@ async function executeMcpCommand(args, invocation, io, dependencies, signal) {
 function eventSink(io, outputFormat, legacyJson = false) {
     const sensitiveValues = sensitiveEnvironmentValues(process.env);
     if (legacyJson) {
-        return (event) => writeJson(io, event.type === 'warning' || event.type === 'failed'
-            ? {
-                ...event,
-                message: redactSensitiveText(event.message, sensitiveValues),
+        return (event) => {
+            if (event.type === 'warning') {
+                io.stderr(`Warning: ${redactSensitiveText(event.message, sensitiveValues)}\n`);
+                return;
             }
-            : event);
+            writeJson(io, event.type === 'failed'
+                ? {
+                    ...event,
+                    message: redactSensitiveText(event.message, sensitiveValues),
+                }
+                : event);
+        };
     }
     if (outputFormat !== 'text')
         return () => undefined;
@@ -4047,6 +4084,10 @@ async function execute(argv, io, dependencies, signal) {
         const startedAt = Date.now();
         const sessionId = invocation.sessionId ?? randomUUID();
         const configRoot = resolve(process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), '.claude'));
+        const runtimeSettings = await loadRuntimeSettings({
+            configRoot,
+            statePath: join(configRoot, '.claude.json'),
+        });
         const text = dependencies.loadReleaseNotes
             ? await dependencies.loadReleaseNotes(configRoot)
             : await loadClaudeReleaseNotes({ configRoot });
@@ -4057,7 +4098,8 @@ async function execute(argv, io, dependencies, signal) {
         };
         const info = {
             cwd: process.cwd(),
-            model: invocation.model ?? process.env.PRAXIS_MODEL ?? 'unknown',
+            model: resolveRuntimeModel(invocation.model, process.env, runtimeSettings) ??
+                'unknown',
             tools: [],
             mcpServers: [],
             permissionMode: invocation.permissionMode,
@@ -4100,7 +4142,11 @@ async function execute(argv, io, dependencies, signal) {
     const service = await dependencies.createService({
         eventSink: outputFormat === 'stream-json' && !invocation.legacyJson
             ? (event) => {
-                const safeEvent = event.type === 'warning' || event.type === 'failed'
+                if (event.type === 'warning') {
+                    io.stderr(`Warning: ${redactSensitiveText(event.message, sensitiveEnvironmentValues(process.env))}\n`);
+                    return;
+                }
+                const safeEvent = event.type === 'failed'
                     ? {
                         ...event,
                         message: redactSensitiveText(event.message, sensitiveEnvironmentValues(process.env)),
@@ -4208,9 +4254,15 @@ async function execute(argv, io, dependencies, signal) {
                 io.stdout(transcript);
             return 0;
         }
+        const configRoot = resolve(process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), '.claude'));
+        const runtimeSettings = await loadRuntimeSettings({
+            configRoot,
+            statePath: join(configRoot, '.claude.json'),
+        });
         const runtimeInfo = service.runtimeInfo?.() ?? {
             cwd: process.cwd(),
-            model: process.env.PRAXIS_MODEL ?? 'unknown',
+            model: resolveRuntimeModel(invocation.model, process.env, runtimeSettings) ??
+                'unknown',
             tools: [],
             mcpServers: [],
             permissionMode: 'default',

package/dist/persistence/claude-scheduled-task-store.d.ts

@@ -14,12 +14,19 @@ export interface ClaudeScheduledTaskStoreOptions {
     lockFile?: string;
 }
 export type ClaudeScheduledTaskCreateInput = Pick<ClaudeScheduledTask, 'cron' | 'prompt' | 'createdAt' | 'recurring' | 'createdBySessionId' | 'createdByPid' | 'createdByProcStart'>;
+export interface ClaudeScheduledTaskCreateOptions {
+    maxJobs?: number;
+}
+export declare class ClaudeScheduledTaskLimitError extends Error {
+    readonly maxJobs: number;
+    constructor(maxJobs: number);
+}
 export declare class ClaudeScheduledTaskStore {
     private readonly filePath;
     private readonly lease;
     constructor(options: ClaudeScheduledTaskStoreOptions);
     list(): Promise<ClaudeScheduledTask[]>;
-    create(input: ClaudeScheduledTaskCreateInput): Promise<ClaudeScheduledTask>;
+    create(input: ClaudeScheduledTaskCreateInput, options?: ClaudeScheduledTaskCreateOptions): Promise<ClaudeScheduledTask>;
     delete(id: string): Promise<boolean>;
     private readRecord;
     private writeDocument;

package/dist/persistence/claude-scheduled-task-store.js

@@ -3,6 +3,14 @@ import { readFile, stat } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { writeFileAtomically } from '../platform/atomic-write.js';
 import { ExclusiveFileLease } from '../platform/exclusive-file-lease.js';
+export class ClaudeScheduledTaskLimitError extends Error {
+    maxJobs;
+    constructor(maxJobs) {
+        super(`Scheduled job limit reached: at most ${maxJobs} active scheduled jobs. Delete or wait for an existing job before scheduling another.`);
+        this.maxJobs = maxJobs;
+        this.name = 'ClaudeScheduledTaskLimitError';
+    }
+}
 const JOB_ID_PATTERN = /^[0-9a-f]{8}$/u;
 const LOCK_WAIT_MS = 5_000;
 const MAX_MUTATION_RETRIES = 16;
@@ -76,10 +84,14 @@ export class ClaudeScheduledTaskStore {
     async list() {
         return (await this.readRecord()).document.tasks.map((task) => ({ ...task }));
     }
-    async create(input) {
+    async create(input, options = {}) {
         return this.withLock(async () => {
             for (let attempt = 0; attempt < MAX_MUTATION_RETRIES; attempt += 1) {
                 const { document, fingerprint: expected } = await this.readRecord();
+                if (options.maxJobs !== undefined &&
+                    document.tasks.length >= options.maxJobs) {
+                    throw new ClaudeScheduledTaskLimitError(options.maxJobs);
+                }
                 const ids = new Set(document.tasks.map(({ id }) => id));
                 let id = randomBytes(4).toString('hex');
                 while (ids.has(id))

package/dist/persistence/claude-transcript-store.js

@@ -299,6 +299,7 @@ export class ClaudeTranscriptStore {
         let logicalTailUuid = tailLogicalUuid(expectedTail);
         const branchParentUuid = expectedTail.branchParentUuid;
         let advancedLogicalTail = false;
+        let staleLastPromptLeaf = false;
         const lines = [];
         for (const entry of entries) {
             if (this.writeProfile === 'sidechain') {
@@ -314,7 +315,8 @@ export class ClaudeTranscriptStore {
             }
             else if (entry.type === 'last-prompt') {
                 if (entry.leafUuid !== logicalTailUuid) {
-                    throw new Error('Entry leafUuid does not match transcript tail');
+                    staleLastPromptLeaf = true;
+                    continue;
                 }
             }
             else if (entry.type === 'system' &&
@@ -347,6 +349,9 @@ export class ClaudeTranscriptStore {
                 advancedLogicalTail = true;
             }
         }
+        if (staleLastPromptLeaf) {
+            return { status: 'conflict', reason: 'tail-changed' };
+        }
         const encodedLine = Buffer.from(`${lines.join('\n')}\n`);
         await mkdir(dirname(this.sessionFile), { recursive: true });
         const sessionHandle = await open(this.sessionFile, 'a');

package/dist/tools/claude-scheduled-tools.js

@@ -295,11 +295,10 @@ export class ClaudeScheduledToolRegistry {
                             : `Loop stopped — cancelled ${cancelledWakeups} pending wakeup(s); no further dynamic-loop wakeups scheduled. If you armed a Monitor for this loop, TaskStop it now; otherwise nothing more to do this turn.`,
                         isError: false,
                         nativeToolUseResult: {
-                            scheduledFor: 0,
-                            clampedDelaySeconds: 0,
-                            wasClamped: false,
                             stopped: true,
-                            cancelledWakeups,
+                            nextWakeupMs: 0,
+                            delaySeconds: 0,
+                            reason: '',
                         },
                     };
                 }
@@ -320,9 +319,10 @@ export class ClaudeScheduledToolRegistry {
                             content: `Next wakeup scheduled for ${scheduledTime} (in ${secondsUntilWakeup}s)${clampNotice}. Nothing more to do this turn — the harness re-invokes you when the wakeup fires or a task-notification arrives.`,
                             isError: false,
                             nativeToolUseResult: {
-                                scheduledFor: wakeup.scheduledFor,
-                                clampedDelaySeconds: wakeup.clampedDelaySeconds,
-                                wasClamped: wakeup.wasClamped,
+                                stopped: false,
+                                nextWakeupMs: wakeup.scheduledFor,
+                                delaySeconds: wakeup.clampedDelaySeconds,
+                                reason: String(call.input.reason),
                             },
                         };
                     }
@@ -331,9 +331,10 @@ export class ClaudeScheduledToolRegistry {
                     content: 'Wakeup not scheduled. Either the /loop dynamic runtime gate is off or the loop reached its maximum duration — the loop has ended; do not re-issue.',
                     isError: false,
                     nativeToolUseResult: {
-                        scheduledFor: 0,
-                        clampedDelaySeconds: 0,
-                        wasClamped: false,
+                        stopped: false,
+                        nextWakeupMs: 0,
+                        delaySeconds: 0,
+                        reason: String(call.input.reason),
                     },
                 };
             default:

package/package.json

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