pi-subagents 0.69.0 → 0.70.0

package/src/shared/session-tokens.d.ts

@@ -0,0 +1,3 @@
+import type { TokenUsage } from "./types.ts";
+export declare function parseSessionTokens(sessionDir: string): TokenUsage | null;
+//# sourceMappingURL=session-tokens.d.ts.map

package/src/shared/session-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tokens.d.ts","sourceRoot":"","sources":["../../../src/shared/session-tokens.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgB7C,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAoCxE"}

package/src/shared/session-tokens.js

@@ -0,0 +1,59 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+function findLatestSessionFile(sessionDir) {
+    try {
+        const files = fs.readdirSync(sessionDir)
+            .filter((f) => f.endsWith(".jsonl"))
+            .map((f) => path.join(sessionDir, f));
+        if (files.length === 0)
+            return null;
+        files.sort((a, b) => fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs);
+        return files[0] ?? null;
+    }
+    catch {
+        // Session token lookup is optional metadata.
+        return null;
+    }
+}
+export function parseSessionTokens(sessionDir) {
+    const sessionFile = findLatestSessionFile(sessionDir);
+    if (!sessionFile)
+        return null;
+    try {
+        const content = fs.readFileSync(sessionFile, "utf-8");
+        let input = 0;
+        let output = 0;
+        let window;
+        let windowPeak;
+        for (const line of content.split("\n")) {
+            if (!line.trim())
+                continue;
+            try {
+                const entry = JSON.parse(line);
+                const usage = entry.usage ?? entry.message?.usage;
+                if (usage) {
+                    const inputValue = usage.inputTokens ?? usage.input;
+                    const outputValue = usage.outputTokens ?? usage.output;
+                    const cacheReadValue = usage.cacheReadTokens ?? usage.cacheRead;
+                    const turnInput = typeof inputValue === "number" && Number.isFinite(inputValue) ? inputValue : 0;
+                    const turnOutput = typeof outputValue === "number" && Number.isFinite(outputValue) ? outputValue : 0;
+                    const cacheRead = typeof cacheReadValue === "number" && Number.isFinite(cacheReadValue) ? cacheReadValue : 0;
+                    const turnWindow = turnInput + cacheRead;
+                    input += turnInput;
+                    output += turnOutput;
+                    window = turnWindow;
+                    windowPeak = Math.max(windowPeak ?? 0, turnWindow);
+                }
+            }
+            catch {
+                // Ignore malformed lines while scanning usage entries.
+            }
+        }
+        return { input, output, total: input + output, ...(window !== undefined ? { window, windowPeak } : {}) };
+    }
+    catch {
+        // Usage extraction should not fail the run.
+        return null;
+    }
+}
+//# sourceMappingURL=session-tokens.js.map

package/src/shared/session-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tokens.js","sourceRoot":"","sources":["../../../src/shared/session-tokens.ts"],"names":[],"mappings":"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"}

package/src/shared/settings.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Chain behavior, template resolution, and directory management
+ */
+import { type AgentConfig, type AgentScope, type UnknownAgentDiagnosticContext } from "../agents/agents.ts";
+import { type OutputOverrideInput, type ResolvedStepBehavior } from "../runs/shared/child-launch-plan.ts";
+import { type AcceptanceInput, type AgentContract, type ChainGateLayer, type JsonSchemaObject, type OutputMode, type ToolBudgetConfig } from "./types.ts";
+export { planChildLaunch, resolveStepBehavior, resolveTaskTextForFileUpdatePolicy, suppressProgressForReadOnlyTask, taskDisallowsFileUpdates, } from "../runs/shared/child-launch-plan.ts";
+export type { ChildLaunchPlan, ChildLaunchPlanInput, OutputOverrideInput, ResolvedStepBehavior, StepOverrides } from "../runs/shared/child-launch-plan.ts";
+/** Sequential step: single agent execution */
+export interface SequentialStep {
+    agent: string;
+    task?: string;
+    phase?: string;
+    label?: string;
+    as?: string;
+    outputSchema?: JsonSchemaObject | false;
+    cwd?: string;
+    machine?: string;
+    output?: OutputOverrideInput;
+    outputMode?: OutputMode;
+    reads?: string[] | false;
+    progress?: boolean;
+    skill?: string | string[] | false;
+    model?: string;
+    fast?: boolean;
+    toolBudget?: ToolBudgetConfig;
+    acceptance?: AcceptanceInput;
+    agentContract?: AgentContract;
+    gateOn?: ChainGateLayer;
+    /** Internal workflow child isolation; public workflowScript supplies this on runs.run. */
+    worktree?: boolean;
+}
+/** Parallel task item within a parallel step */
+export interface ParallelTaskItem {
+    agent: string;
+    task?: string;
+    phase?: string;
+    label?: string;
+    as?: string;
+    outputSchema?: JsonSchemaObject | false;
+    cwd?: string;
+    machine?: string;
+    count?: number;
+    output?: OutputOverrideInput;
+    outputMode?: OutputMode;
+    reads?: string[] | false;
+    progress?: boolean;
+    skill?: string | string[] | false;
+    model?: string;
+    fast?: boolean;
+    toolBudget?: ToolBudgetConfig;
+    acceptance?: AcceptanceInput;
+    agentContract?: AgentContract;
+    gateOn?: ChainGateLayer;
+}
+export interface DynamicExpandSpec {
+    from: {
+        output: string;
+        path: string;
+    };
+    item?: string;
+    key?: string;
+    maxItems?: number;
+    onEmpty?: "skip" | "fail";
+}
+export type DynamicParallelTemplate = Omit<ParallelTaskItem, "as" | "count">;
+export interface DynamicCollectSpec {
+    as: string;
+    outputSchema?: JsonSchemaObject;
+}
+export interface DynamicParallelStep {
+    expand: DynamicExpandSpec;
+    parallel: DynamicParallelTemplate;
+    collect: DynamicCollectSpec;
+    concurrency?: number;
+    failFast?: boolean;
+    phase?: string;
+    label?: string;
+    acceptance?: AcceptanceInput;
+    agentContract?: AgentContract;
+    gateOn?: ChainGateLayer;
+}
+/** Parallel step: multiple agents running concurrently */
+export interface ParallelStep {
+    parallel: ParallelTaskItem[];
+    concurrency?: number;
+    failFast?: boolean;
+    worktree?: boolean;
+    cwd?: string;
+    machine?: string;
+    agentContract?: AgentContract;
+    gateOn?: ChainGateLayer;
+}
+/** Union type for chain steps */
+export type ChainStep = SequentialStep | ParallelStep | DynamicParallelStep;
+export declare function isParallelStep(step: ChainStep): step is ParallelStep;
+export declare function isDynamicParallelStep(step: ChainStep): step is DynamicParallelStep;
+/** Get all agent names in a step (single for sequential, multiple for parallel) */
+export declare function getStepAgents(step: ChainStep): string[];
+export declare function createChainDir(runId: string, baseDir?: string): string;
+export declare function removeChainDir(chainDir: string): void;
+export declare function cleanupOldChainDirs(): void;
+/** Resolved templates for a chain - string for sequential, string[] for parallel */
+export type ResolvedTemplates = (string | string[])[];
+/**
+ * Resolve templates for a chain with parallel step support.
+ * Returns string for sequential steps, string[] for parallel steps.
+ */
+export declare function resolveChainTemplates(steps: ChainStep[]): ResolvedTemplates;
+/**
+ * Expand a leading `~`/`~/` to the user's home directory. Other forms (relative,
+ * absolute, `~user/`) pass through unchanged.
+ */
+export declare function expandHomePath(filePath: string): string;
+/**
+ * Resolve a file path: `~`/`~/` expand to home first, then absolute paths pass
+ * through and relative paths get chainDir prepended.
+ */
+export declare function resolveChainPath(filePath: string, chainDir: string): string;
+export declare function resolveExistingReadInstructionPaths(reads: readonly string[], instructionCwd: string, existenceCwd?: string): string[];
+export declare function resolveExistingReadPaths(reads: readonly string[], cwd: string): string[];
+/**
+ * Build chain instructions from resolved behavior.
+ * These are appended to the task to tell the agent what to read/write.
+ */
+export declare function writeInitialProgressFile(progressDir: string): void;
+export declare function buildChainInstructions(behavior: ResolvedStepBehavior, chainDir: string, isFirstProgressAgent: boolean, previousSummary?: string, readExistenceDir?: string): {
+    prefix: string;
+    suffix: string;
+};
+/**
+ * Resolve behaviors for all tasks in a parallel step.
+ * Creates namespaced output paths to avoid collisions.
+ */
+/** Exact discovery context, or explicit input for defensive fallback discovery. */
+export type ParallelBehaviorDiagnostics = UnknownAgentDiagnosticContext | {
+    cwd: string;
+    scope?: AgentScope;
+};
+export declare function resolveParallelBehaviors(tasks: ParallelTaskItem[], agentConfigs: AgentConfig[], stepIndex: number, chainSkills?: string[], diagnostics?: ParallelBehaviorDiagnostics): ResolvedStepBehavior[];
+/**
+ * Create subdirectories for parallel step outputs
+ */
+export declare function createParallelDirs(chainDir: string, stepIndex: number, taskCount: number, agentNames: string[]): void;
+export type { ParallelTaskResult } from "../runs/shared/parallel-utils.ts";
+export { aggregateParallelOutputs } from "../runs/shared/parallel-utils.ts";
+//# sourceMappingURL=settings.d.ts.map

package/src/shared/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/shared/settings.ts"],"names":[],"mappings":"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"}

package/src/shared/settings.js

@@ -0,0 +1,248 @@
+/**
+ * Chain behavior, template resolution, and directory management
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { discoverAgents, formatUnknownAgentError, unknownAgentDiagnosticContext } from "../agents/agents.js";
+import { normalizeSkillInput } from "../agents/skills.js";
+import { normalizeOutputOverride } from "../runs/shared/child-launch-plan.js";
+import { CHAIN_RUNS_DIR } from "./types.js";
+const CHAIN_DIR_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24 hours
+const INITIAL_PROGRESS_CONTENT = "# Progress\n\n## Status\nIn Progress\n\n## Tasks\n\n## Files Changed\n\n## Notes\n";
+export { planChildLaunch, resolveStepBehavior, resolveTaskTextForFileUpdatePolicy, suppressProgressForReadOnlyTask, taskDisallowsFileUpdates, } from "../runs/shared/child-launch-plan.js";
+// =============================================================================
+// Type Guards
+// =============================================================================
+export function isParallelStep(step) {
+    return "parallel" in step && Array.isArray(step.parallel);
+}
+export function isDynamicParallelStep(step) {
+    return "expand" in step && "collect" in step && "parallel" in step && !Array.isArray(step.parallel);
+}
+/** Get all agent names in a step (single for sequential, multiple for parallel) */
+export function getStepAgents(step) {
+    if (isParallelStep(step)) {
+        return step.parallel.map((t) => t.agent);
+    }
+    if (isDynamicParallelStep(step)) {
+        return [step.parallel.agent];
+    }
+    return [step.agent];
+}
+// =============================================================================
+// Chain Directory Management
+// =============================================================================
+export function createChainDir(runId, baseDir) {
+    const chainDir = path.join(baseDir ? path.resolve(baseDir) : CHAIN_RUNS_DIR, runId);
+    fs.mkdirSync(chainDir, { recursive: true });
+    return chainDir;
+}
+export function removeChainDir(chainDir) {
+    try {
+        fs.rmSync(chainDir, { recursive: true });
+    }
+    catch {
+        // Chain cleanup is best-effort. Runs can already have cleaned their temp dir.
+    }
+}
+export function cleanupOldChainDirs() {
+    if (!fs.existsSync(CHAIN_RUNS_DIR))
+        return;
+    const now = Date.now();
+    let dirs;
+    try {
+        dirs = fs.readdirSync(CHAIN_RUNS_DIR);
+    }
+    catch {
+        // Startup cleanup is best-effort. If the scoped temp root is unreadable,
+        // skip cleanup instead of failing extension startup.
+        return;
+    }
+    for (const dir of dirs) {
+        try {
+            const dirPath = path.join(CHAIN_RUNS_DIR, dir);
+            const stat = fs.statSync(dirPath);
+            if (stat.isDirectory() && now - stat.mtimeMs > CHAIN_DIR_MAX_AGE_MS) {
+                fs.rmSync(dirPath, { recursive: true });
+            }
+        }
+        catch {
+            // Skip directories that can't be processed; continue with others
+        }
+    }
+}
+/**
+ * Resolve templates for a chain with parallel step support.
+ * Returns string for sequential steps, string[] for parallel steps.
+ */
+export function resolveChainTemplates(steps) {
+    return steps.map((step, i) => {
+        if (isParallelStep(step)) {
+            // Parallel step: resolve each task's template
+            return step.parallel.map((task) => {
+                if (task.task)
+                    return task.task;
+                // Default for parallel tasks is {previous}
+                return "{previous}";
+            });
+        }
+        if (isDynamicParallelStep(step)) {
+            return step.parallel.task ?? "{previous}";
+        }
+        // Sequential step: existing logic
+        const seq = step;
+        if (seq.task)
+            return seq.task;
+        // Default: first step uses {task}, others use {previous}
+        return i === 0 ? "{task}" : "{previous}";
+    });
+}
+// =============================================================================
+// Chain Instruction Injection
+// =============================================================================
+/**
+ * Expand a leading `~`/`~/` to the user's home directory. Other forms (relative,
+ * absolute, `~user/`) pass through unchanged.
+ */
+export function expandHomePath(filePath) {
+    if (filePath === "~")
+        return os.homedir();
+    if (filePath.startsWith("~/"))
+        return path.join(os.homedir(), filePath.slice(2));
+    return filePath;
+}
+/**
+ * Resolve a file path: `~`/`~/` expand to home first, then absolute paths pass
+ * through and relative paths get chainDir prepended.
+ */
+export function resolveChainPath(filePath, chainDir) {
+    const expanded = expandHomePath(filePath);
+    return path.isAbsolute(expanded) ? expanded : path.join(chainDir, expanded);
+}
+export function resolveExistingReadInstructionPaths(reads, instructionCwd, existenceCwd = instructionCwd) {
+    return reads.flatMap((filePath) => {
+        const instructionPath = resolveChainPath(filePath, instructionCwd);
+        const existencePath = resolveChainPath(filePath, existenceCwd);
+        return fs.existsSync(existencePath) ? [instructionPath] : [];
+    });
+}
+export function resolveExistingReadPaths(reads, cwd) {
+    return resolveExistingReadInstructionPaths(reads, cwd);
+}
+/**
+ * Build chain instructions from resolved behavior.
+ * These are appended to the task to tell the agent what to read/write.
+ */
+export function writeInitialProgressFile(progressDir) {
+    fs.mkdirSync(progressDir, { recursive: true });
+    fs.writeFileSync(path.join(progressDir, "progress.md"), INITIAL_PROGRESS_CONTENT);
+}
+export function buildChainInstructions(behavior, chainDir, isFirstProgressAgent, previousSummary, readExistenceDir = chainDir) {
+    const prefixParts = [];
+    const suffixParts = [];
+    // READS - prepend to override any hardcoded filenames in task text
+    if (behavior.reads && behavior.reads.length > 0) {
+        const files = resolveExistingReadInstructionPaths(behavior.reads, chainDir, readExistenceDir);
+        if (files.length > 0)
+            prefixParts.push(`[Read from: ${files.join(", ")}]`);
+    }
+    // OUTPUT - prepend so agent knows where to write
+    if (behavior.output) {
+        const outputPath = resolveChainPath(behavior.output, chainDir);
+        prefixParts.push(`[Write to: ${outputPath}]`);
+    }
+    // Progress instructions in suffix (less critical)
+    if (behavior.progress) {
+        const progressPath = path.join(chainDir, "progress.md");
+        if (isFirstProgressAgent) {
+            suffixParts.push(`Create and maintain progress at: ${progressPath}`);
+        }
+        else {
+            suffixParts.push(`Update progress at: ${progressPath}`);
+        }
+    }
+    // Include previous step's summary in suffix if available
+    if (previousSummary && previousSummary.trim()) {
+        suffixParts.push(`Previous step output:\n${previousSummary.trim()}`);
+    }
+    const prefix = prefixParts.length > 0
+        ? prefixParts.join("\n") + "\n\n"
+        : "";
+    const suffix = suffixParts.length > 0
+        ? "\n\n---\n" + suffixParts.join("\n")
+        : "";
+    return { prefix, suffix };
+}
+export function resolveParallelBehaviors(tasks, agentConfigs, stepIndex, chainSkills, diagnostics) {
+    return tasks.map((task, taskIndex) => {
+        const config = agentConfigs.find((a) => a.name === task.agent);
+        if (!config) {
+            if (!diagnostics)
+                throw new Error("resolveParallelBehaviors requires unknown-agent diagnostic context or fallback discovery input.");
+            const context = "directories" in diagnostics
+                ? diagnostics
+                : unknownAgentDiagnosticContext(discoverAgents(path.resolve(diagnostics.cwd), diagnostics.scope ?? "both"));
+            throw new Error(formatUnknownAgentError(task.agent, context));
+        }
+        // Build subdirectory path for this parallel task
+        const subdir = path.join(`parallel-${stepIndex}`, `${taskIndex}-${task.agent}`);
+        // Output: task override > agent default (namespaced) > false
+        // Absolute paths pass through unchanged; relative paths get namespaced under subdir
+        let output = false;
+        const taskOutput = normalizeOutputOverride(task.output);
+        const configOutput = normalizeOutputOverride(config.output);
+        if (taskOutput !== undefined) {
+            if (taskOutput === false) {
+                output = false;
+            }
+            else if (path.isAbsolute(taskOutput)) {
+                output = taskOutput; // Absolute path: use as-is
+            }
+            else {
+                output = path.join(subdir, taskOutput); // Relative: namespace under subdir
+            }
+        }
+        else if (configOutput) {
+            // Agent defaults are always relative, so namespace them
+            output = path.join(subdir, configOutput);
+        }
+        // Reads: task override > agent default > false
+        const reads = task.reads !== undefined ? task.reads : config.defaultReads ?? false;
+        // Progress: task override > agent default > false
+        const progress = task.progress !== undefined
+            ? task.progress
+            : config.defaultProgress ?? false;
+        const taskSkillInput = normalizeSkillInput(task.skill);
+        let skills;
+        if (taskSkillInput === false) {
+            skills = false;
+        }
+        else if (taskSkillInput !== undefined) {
+            skills = [...taskSkillInput];
+            if (chainSkills && chainSkills.length > 0) {
+                skills = [...new Set([...skills, ...chainSkills])];
+            }
+        }
+        else {
+            skills = config.skills ? [...config.skills] : [];
+            if (chainSkills && chainSkills.length > 0) {
+                skills = [...new Set([...skills, ...chainSkills])];
+            }
+        }
+        const outputMode = task.outputMode ?? config.outputMode ?? "inline";
+        const model = task.model ?? config.model;
+        return { output, outputMode, reads, progress, skills, model };
+    });
+}
+/**
+ * Create subdirectories for parallel step outputs
+ */
+export function createParallelDirs(chainDir, stepIndex, taskCount, agentNames) {
+    for (let i = 0; i < taskCount; i++) {
+        const subdir = path.join(chainDir, `parallel-${stepIndex}`, `${i}-${agentNames[i]}`);
+        fs.mkdirSync(subdir, { recursive: true });
+    }
+}
+export { aggregateParallelOutputs } from "../runs/shared/parallel-utils.js";
+//# sourceMappingURL=settings.js.map

package/src/shared/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/shared/settings.ts"],"names":[],"mappings":"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"}

package/src/shared/shortcuts.d.ts

@@ -0,0 +1,2 @@
+export declare function formatShortcutLabel(shortcut: string): string;
+//# sourceMappingURL=shortcuts.d.ts.map

package/src/shared/shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.d.ts","sourceRoot":"","sources":["../../../src/shared/shortcuts.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY5D"}

package/src/shared/shortcuts.js

@@ -0,0 +1,18 @@
+export function formatShortcutLabel(shortcut) {
+    return shortcut
+        .split("+")
+        .map((part) => {
+        const normalized = part.trim().toLowerCase();
+        if (normalized === "ctrl")
+            return "Ctrl";
+        if (normalized === "alt")
+            return "Alt";
+        if (normalized === "shift")
+            return "Shift";
+        if (normalized === "super")
+            return "Super";
+        return normalized.length === 1 ? normalized.toUpperCase() : part.trim();
+    })
+        .join("+");
+}
+//# sourceMappingURL=shortcuts.js.map

package/src/shared/shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.js","sourceRoot":"","sources":["../../../src/shared/shortcuts.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IACnD,OAAO,QAAQ;SACb,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,UAAU,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC;QACzC,IAAI,UAAU,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QACvC,IAAI,UAAU,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QAC3C,IAAI,UAAU,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QAC3C,OAAO,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACzE,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC"}

package/src/shared/status-format.d.ts

@@ -0,0 +1,10 @@
+import type { ActivityState, AsyncJobStep } from "./types.ts";
+type StepStatusLike = Pick<AsyncJobStep, "status">;
+export declare function formatActivityLabel(lastActivityAt: number | undefined, activityState?: ActivityState, now?: number): string | undefined;
+export declare function aggregateStepStatus(steps: StepStatusLike[]): AsyncJobStep["status"];
+export declare function formatAgentRunningLabel(count: number): string;
+export declare function formatParallelOutcome(steps: StepStatusLike[], total: number, options?: {
+    showRunning?: boolean;
+}): string;
+export {};
+//# sourceMappingURL=status-format.d.ts.map

package/src/shared/status-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-format.d.ts","sourceRoot":"","sources":["../../../src/shared/status-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,KAAK,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AAQnD,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,aAAa,CAAC,EAAE,aAAa,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,SAAS,CAa3I;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAOnF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAY7H"}

package/src/shared/status-format.js

@@ -0,0 +1,61 @@
+function formatActivityAge(ms) {
+    if (ms < 1000)
+        return "now";
+    if (ms < 60000)
+        return `${Math.floor(ms / 1000)}s`;
+    return `${Math.floor(ms / 60000)}m`;
+}
+export function formatActivityLabel(lastActivityAt, activityState, now = Date.now()) {
+    if (lastActivityAt === undefined) {
+        if (activityState === "needs_attention")
+            return "needs attention";
+        if (activityState === "active_long_running")
+            return "active but long-running";
+        return undefined;
+    }
+    const age = formatActivityAge(Math.max(0, now - lastActivityAt));
+    if (activityState === "needs_attention")
+        return `no activity for ${age}`;
+    if (activityState === "active_long_running") {
+        const activityAge = age === "now" ? "now" : `${age} ago`;
+        return `active but long-running · last activity ${activityAge}`;
+    }
+    return age === "now" ? "active now" : `active ${age} ago`;
+}
+function isCompletedStepStatus(status) {
+    return status === "complete" || status === "completed";
+}
+export function aggregateStepStatus(steps) {
+    if (steps.some((step) => step.status === "running"))
+        return "running";
+    if (steps.some((step) => step.status === "failed"))
+        return "failed";
+    if (steps.some((step) => step.status === "stopped"))
+        return "stopped";
+    if (steps.some((step) => step.status === "paused"))
+        return "paused";
+    if (steps.length > 0 && steps.every((step) => isCompletedStepStatus(step.status)))
+        return "complete";
+    return "pending";
+}
+export function formatAgentRunningLabel(count) {
+    return count === 1 ? "1 agent running" : `${count} agents running`;
+}
+export function formatParallelOutcome(steps, total, options = {}) {
+    const running = steps.filter((step) => step.status === "running").length;
+    const done = steps.filter((step) => isCompletedStepStatus(step.status)).length;
+    const failed = steps.filter((step) => step.status === "failed").length;
+    const stopped = steps.filter((step) => step.status === "stopped").length;
+    const paused = steps.filter((step) => step.status === "paused").length;
+    const parts = [`${done}/${total} done`];
+    if (options.showRunning !== false && running > 0)
+        parts.unshift(formatAgentRunningLabel(running));
+    if (failed > 0)
+        parts.push(`${failed} failed`);
+    if (stopped > 0)
+        parts.push(`${stopped} stopped`);
+    if (paused > 0)
+        parts.push(`${paused} paused`);
+    return parts.join(" · ");
+}
+//# sourceMappingURL=status-format.js.map

package/src/shared/status-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-format.js","sourceRoot":"","sources":["../../../src/shared/status-format.ts"],"names":[],"mappings":"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"}

package/src/shared/thinking-ceiling.d.ts

@@ -0,0 +1,14 @@
+import { type ThinkingLevel } from "./model-info.ts";
+export type { ThinkingLevel } from "./model-info.ts";
+export declare function parseThinkingLevel(value: unknown, field?: string): ThinkingLevel;
+export declare function compareThinkingLevels(left: ThinkingLevel, right: ThinkingLevel): number;
+export declare function intersectThinkingCeilings(...ceilings: Array<ThinkingLevel | undefined>): ThinkingLevel | undefined;
+export interface ThinkingCeilingCheck {
+    model?: string;
+    configThinking?: string | false;
+    ceiling?: ThinkingLevel;
+    agent?: string;
+    runId?: string;
+}
+export declare function assertThinkingWithinCeiling(input: ThinkingCeilingCheck): void;
+//# sourceMappingURL=thinking-ceiling.d.ts.map

package/src/shared/thinking-ceiling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-ceiling.d.ts","sourceRoot":"","sources":["../../../src/shared/thinking-ceiling.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChG,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAmB,GAAG,aAAa,CAM1F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAKvF;AAED,wBAAgB,yBAAyB,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,aAAa,GAAG,SAAS,CAIlH;AAGD,MAAM,WAAW,oBAAoB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAU7E"}