@fitchmultz/pi-subagents 0.49.1 → 0.50.0

package/dist/runs/background/subagent-runner.js

@@ -1,81 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { writeAtomicJson } from "../../shared/atomic-json.js";
-import { appendJsonl } from "../../shared/artifacts.js";
-import { saveRunStatus } from "../shared/supervisor-questions.js";
-import { parseSubagentRunConfig } from "./run-schemas.js";
-import { createRunnerStatus } from "./runner-initial-status.js";
-import { RunnerMonitor } from "./runner-monitor.js";
-import { RunnerLifecycle } from "./runner-lifecycle.js";
-import { RunnerWorkflow } from "./runner-workflow.js";
-import { completeRunner } from "./runner-completion.js";
-async function runSubagent(config) {
-    const startedAt = Date.now();
-    const status = createRunnerStatus(config, startedAt);
-    fs.mkdirSync(config.asyncDir, { recursive: true });
-    writeAtomicJson(path.join(config.asyncDir, "status.json"), status);
-    if (config.runtimeVersion !== 2) {
-        saveRunStatus(config.id, status);
-    }
-    const monitor = new RunnerMonitor(config, status, startedAt);
-    const lifecycle = new RunnerLifecycle(config, status, monitor);
-    lifecycle.start(startedAt);
-    appendJsonl(path.join(config.asyncDir, "events.jsonl"), JSON.stringify({
-        type: "subagent.run.started",
-        ts: startedAt,
-        runId: config.id,
-        mode: status.mode,
-        cwd: config.cwd,
-        pid: process.pid,
-    }));
-    try {
-        const evidence = await new RunnerWorkflow(config, monitor, lifecycle).run(startedAt);
-        await completeRunner(config, evidence, monitor, lifecycle);
-    }
-    finally {
-        lifecycle.dispose();
-    }
-}
-function runnerError(error) {
-    console.error("Subagent runner error:", error);
-    process.exit(1);
-}
-function launchConfig(text, file) {
-    const value = JSON.parse(text);
-    const config = parseSubagentRunConfig(value);
-    if (file !== undefined && config.runtimeVersion !== 2) {
-        try {
-            fs.unlinkSync(file);
-        }
-        catch {
-            /* Legacy temporary configuration cleanup is best effort. */
-        }
-    }
-    runSubagent(config).catch(runnerError);
-}
-const configArg = process.argv.at(2);
-if (configArg !== undefined && configArg.length > 0) {
-    try {
-        launchConfig(fs.readFileSync(configArg, "utf-8"), configArg);
-    }
-    catch (error) {
-        runnerError(error);
-    }
-}
-else {
-    let input = "";
-    process.stdin.setEncoding("utf-8");
-    process.stdin.on("data", (chunk) => {
-        if (typeof chunk === "string") {
-            input += chunk;
-        }
-    });
-    process.stdin.on("end", () => {
-        try {
-            launchConfig(input);
-        }
-        catch (error) {
-            runnerError(error);
-        }
-    });
-}

package/dist/runs/background/top-level-async.js

@@ -1,6 +0,0 @@
-export function applyForceTopLevelAsyncOverride(params, depth, forceTopLevelAsync) {
-    if (!(depth === 0 && forceTopLevelAsync)) {
-        return params;
-    }
-    return { ...params, async: true, clarify: false };
-}

package/dist/runs/foreground/chain-clarify.js

@@ -1,428 +0,0 @@
-import { matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
-import { ClarifyView } from "./clarify-view.js";
-import { findModelInfo, getSupportedThinkingLevels, } from "../../shared/model-info.js";
-import { resolveModelCandidate, splitThinkingSuffix } from "../shared/model-fallback.js";
-import { ClarifyTextEditor } from "./clarify-text-editor.js";
-import { ClarificationDraft } from "./clarification-draft.js";
-/** Owns one preview interaction. Edits replace local values; launch inputs are never mutated. */
-export class ChainClarifyComponent {
-    renderWidth = 84;
-    selectedStep = 0;
-    editingStep = null;
-    editMode = "template";
-    editor = new ClarifyTextEditor();
-    draft;
-    tui;
-    theme;
-    options;
-    done;
-    modelSearchQuery = "";
-    modelSelectedIndex = 0;
-    filteredModels;
-    thinkingSelectedIndex = 0;
-    skillSearchQuery = "";
-    skillSelectedNames = new Set();
-    skillCursorIndex = 0;
-    filteredSkills;
-    noticeMessage;
-    noticeMessageTimer;
-    runInBackground = false;
-    mode;
-    constructor(tui, theme, options, done) {
-        this.tui = tui;
-        this.theme = theme;
-        this.options = options;
-        this.done = done;
-        this.draft = new ClarificationDraft(options.templates, options.resolvedBehaviors);
-        this.filteredModels = options.availableModels;
-        this.filteredSkills = options.availableSkills;
-        this.mode = options.mode ?? "chain";
-    }
-    getEffectiveModel(index) {
-        const model = this.draft.behavior(index).model;
-        if (model === undefined || model.length === 0) {
-            return "default";
-        }
-        return (resolveModelCandidate(model, this.options.availableModels, this.options.preferredProvider) ??
-            model);
-    }
-    exitEditMode() {
-        this.editingStep = null;
-        this.editor.setText("");
-        this.tui.requestRender();
-    }
-    showNotice(text) {
-        this.noticeMessage = text;
-        if (this.noticeMessageTimer !== undefined) {
-            clearTimeout(this.noticeMessageTimer);
-        }
-        this.noticeMessageTimer = setTimeout(() => {
-            this.noticeMessage = undefined;
-            this.noticeMessageTimer = undefined;
-            this.tui.requestRender();
-        }, 2000);
-        this.tui.requestRender();
-    }
-    handleInput(data) {
-        if (this.editingStep !== null) {
-            this.handleEditingInput(data);
-            return;
-        }
-        if (matchesKey(data, "escape") || matchesKey(data, "ctrl+c")) {
-            this.done({ confirmed: false, templates: [], behaviorOverrides: [] });
-            return;
-        }
-        if (matchesKey(data, "return")) {
-            this.done({
-                confirmed: true,
-                templates: [...this.draft.templates],
-                behaviorOverrides: this.options.agentConfigs.map((_, index) => this.draft.override(index)),
-                runInBackground: this.runInBackground,
-            });
-            return;
-        }
-        if (matchesKey(data, "up") || matchesKey(data, "down")) {
-            const delta = matchesKey(data, "up") ? -1 : 1;
-            this.selectedStep = Math.max(0, Math.min(this.options.agentConfigs.length - 1, this.selectedStep + delta));
-        }
-        else {
-            this.handleShortcut(data);
-        }
-        this.tui.requestRender();
-    }
-    handleShortcut(data) {
-        switch (data) {
-            case "e":
-                this.enterEditMode("template");
-                break;
-            case "m":
-                this.enterModelSelector();
-                break;
-            case "t":
-                this.enterThinkingSelector();
-                break;
-            case "s":
-                this.enterSkillSelector();
-                break;
-            case "w":
-                if (this.mode !== "parallel") {
-                    this.enterEditMode("output");
-                }
-                break;
-            case "r":
-                if (this.mode === "chain") {
-                    this.enterEditMode("reads");
-                }
-                break;
-            case "p":
-                if (this.mode === "chain") {
-                    this.draft.toggleProgress();
-                }
-                break;
-            case "b":
-                this.runInBackground = !this.runInBackground;
-                break;
-        }
-    }
-    enterEditMode(mode) {
-        this.editingStep = this.selectedStep;
-        this.editMode = mode;
-        const behavior = this.draft.behavior(this.selectedStep);
-        let buffer = (this.draft.templates[this.selectedStep] ?? "").split("\n")[0] ?? "";
-        if (mode === "output") {
-            buffer = behavior.output === false ? "" : behavior.output;
-        }
-        if (mode === "reads") {
-            buffer = behavior.reads === false ? "" : behavior.reads.join(", ");
-        }
-        this.editor.setText(buffer);
-    }
-    enterModelSelector() {
-        this.editingStep = this.selectedStep;
-        this.editMode = "model";
-        this.modelSearchQuery = "";
-        this.filteredModels = this.options.availableModels;
-        const current = splitThinkingSuffix(this.getEffectiveModel(this.selectedStep)).baseModel;
-        this.modelSelectedIndex = Math.max(0, this.filteredModels.findIndex((model) => model.fullId === current || model.id === current));
-        this.tui.requestRender();
-    }
-    getAvailableThinkingLevels(index) {
-        return getSupportedThinkingLevels(findModelInfo(this.getEffectiveModel(index), this.options.availableModels, this.options.preferredProvider));
-    }
-    enterThinkingSelector() {
-        const model = this.draft.behavior(this.selectedStep).model;
-        if (model === undefined || model.length === 0) {
-            this.showNotice("Select a model first");
-            return;
-        }
-        this.editingStep = this.selectedStep;
-        this.editMode = "thinking";
-        const levels = this.getAvailableThinkingLevels(this.selectedStep);
-        const suffix = splitThinkingSuffix(this.getEffectiveModel(this.selectedStep)).thinkingSuffix.slice(1);
-        const index = levels.findIndex((level) => level === suffix);
-        this.thinkingSelectedIndex = index >= 0 ? index : Math.max(0, levels.indexOf("off"));
-        this.tui.requestRender();
-    }
-    applyThinkingLevel(level) {
-        if (this.editingStep === null) {
-            return;
-        }
-        const current = this.draft.behavior(this.editingStep).model;
-        if (current === undefined || current.length === 0) {
-            return;
-        }
-        const { baseModel } = splitThinkingSuffix(current);
-        this.draft.update(this.editingStep, {
-            model: level === "off" ? baseModel : `${baseModel}:${level}`,
-        });
-    }
-    enterSkillSelector() {
-        this.editingStep = this.selectedStep;
-        this.editMode = "skills";
-        this.skillSearchQuery = "";
-        this.skillCursorIndex = 0;
-        this.filteredSkills = this.options.availableSkills;
-        this.skillSelectedNames.clear();
-        const skills = this.draft.behavior(this.selectedStep).skills;
-        if (skills !== false) {
-            skills.forEach((skill) => {
-                this.skillSelectedNames.add(skill);
-            });
-        }
-    }
-    handleEditingInput(data) {
-        if (this.editMode === "model") {
-            this.handleModelSelectorInput(data);
-            return;
-        }
-        if (this.editMode === "thinking") {
-            this.handleThinkingSelectorInput(data);
-            return;
-        }
-        if (this.editMode === "skills") {
-            this.handleSkillSelectorInput(data);
-            return;
-        }
-        if (matchesKey(data, "escape")) {
-            this.saveEdit();
-            this.exitEditMode();
-            return;
-        }
-        if (matchesKey(data, "ctrl+c")) {
-            this.exitEditMode();
-            return;
-        }
-        this.editor.handleInput(data, this.renderWidth - 4);
-        this.tui.requestRender();
-    }
-    handleModelSelectorInput(data) {
-        if (matchesKey(data, "escape") || matchesKey(data, "ctrl+c")) {
-            this.exitEditMode();
-            return;
-        }
-        if (matchesKey(data, "return")) {
-            this.selectModel();
-            this.exitEditMode();
-            return;
-        }
-        const direction = navigationDirection(data);
-        if (direction !== 0) {
-            this.modelSelectedIndex = moveSelection(this.modelSelectedIndex, direction, this.filteredModels.length);
-        }
-        else {
-            this.modelSearchQuery = searchInput(this.modelSearchQuery, data);
-            const query = this.modelSearchQuery.toLowerCase();
-            this.filteredModels = this.options.availableModels.filter((model) => `${model.fullId} ${model.id} ${model.provider}`.toLowerCase().includes(query));
-            this.modelSelectedIndex = Math.min(this.modelSelectedIndex, Math.max(0, this.filteredModels.length - 1));
-        }
-        this.tui.requestRender();
-    }
-    selectModel() {
-        const selected = this.filteredModels.at(this.modelSelectedIndex);
-        if (!selected || this.editingStep === null) {
-            return;
-        }
-        const { thinkingSuffix } = splitThinkingSuffix(this.getEffectiveModel(this.editingStep));
-        const info = findModelInfo(selected.fullId, this.options.availableModels, this.options.preferredProvider);
-        const suffix = getSupportedThinkingLevels(info).some((level) => level === thinkingSuffix.slice(1))
-            ? thinkingSuffix
-            : "";
-        this.draft.update(this.editingStep, { model: `${selected.fullId}${suffix}` });
-    }
-    handleThinkingSelectorInput(data) {
-        if (matchesKey(data, "escape") || matchesKey(data, "ctrl+c")) {
-            this.exitEditMode();
-            return;
-        }
-        if (this.editingStep === null) {
-            return;
-        }
-        const levels = this.getAvailableThinkingLevels(this.editingStep);
-        if (levels.length === 0) {
-            return;
-        }
-        if (matchesKey(data, "return")) {
-            this.applyThinkingLevel(levels[this.thinkingSelectedIndex] ?? "off");
-            this.exitEditMode();
-            return;
-        }
-        this.thinkingSelectedIndex = moveSelection(this.thinkingSelectedIndex, navigationDirection(data), levels.length);
-        this.tui.requestRender();
-    }
-    handleSkillSelectorInput(data) {
-        if (matchesKey(data, "escape") || matchesKey(data, "ctrl+c")) {
-            this.exitEditMode();
-            return;
-        }
-        if (matchesKey(data, "return") && this.editingStep !== null) {
-            this.draft.update(this.editingStep, { skills: [...this.skillSelectedNames] });
-            this.exitEditMode();
-            return;
-        }
-        if (data === " ") {
-            this.toggleSkill();
-        }
-        else {
-            this.searchSkills(data);
-        }
-        this.tui.requestRender();
-    }
-    toggleSkill() {
-        const skill = this.filteredSkills.at(this.skillCursorIndex);
-        if (!skill) {
-            return;
-        }
-        if (this.skillSelectedNames.has(skill.name)) {
-            this.skillSelectedNames.delete(skill.name);
-        }
-        else {
-            this.skillSelectedNames.add(skill.name);
-        }
-    }
-    searchSkills(data) {
-        const direction = navigationDirection(data);
-        if (direction !== 0) {
-            this.skillCursorIndex = moveSelection(this.skillCursorIndex, direction, this.filteredSkills.length);
-            return;
-        }
-        this.skillSearchQuery = searchInput(this.skillSearchQuery, data);
-        const query = this.skillSearchQuery.toLowerCase();
-        this.filteredSkills = this.options.availableSkills.filter((skill) => `${skill.name} ${skill.description ?? ""}`.toLowerCase().includes(query));
-        this.skillCursorIndex = Math.min(this.skillCursorIndex, Math.max(0, this.filteredSkills.length - 1));
-    }
-    saveEdit() {
-        if (this.editingStep !== null) {
-            this.draft.save(this.editingStep, this.editMode, this.editor.getText());
-        }
-    }
-    stepLabel(index) {
-        const agent = this.options.agentConfigs[index]?.name ?? "unknown";
-        if (this.mode === "single") {
-            return agent;
-        }
-        return `${this.mode === "parallel" ? "Task" : "Step"} ${index + 1}: ${agent}`;
-    }
-    render(width) {
-        if (width < 40) {
-            return [truncateToWidth("Subagent clarify: widen terminal", width)];
-        }
-        this.renderWidth = Math.min(84, width);
-        if (this.editingStep !== null) {
-            return this.renderEditing();
-        }
-        return this.renderOverview();
-    }
-    renderEditing() {
-        if (this.editMode === "model") {
-            return this.renderModelSelector();
-        }
-        if (this.editMode === "thinking") {
-            return this.renderThinkingSelector();
-        }
-        if (this.editMode === "skills") {
-            return this.renderSkillSelector();
-        }
-        const name = this.editMode === "template" ? "task" : this.editMode;
-        const view = new ClarifyView(this.theme, this.renderWidth);
-        return view.editor(`Editing ${name} (${this.stepLabel(this.editingStep ?? 0)})`, this.editor.render(this.renderWidth - 4, 12));
-    }
-    renderModelSelector() {
-        const current = this.getEffectiveModel(this.editingStep ?? 0);
-        const base = splitThinkingSuffix(current).baseModel;
-        const choices = this.filteredModels.map((model) => `${model.id} [${model.provider}]${model.fullId === base || model.id === base ? " current" : ""}`);
-        return new ClarifyView(this.theme, this.renderWidth).selector({
-            title: `Select Model (${this.stepLabel(this.editingStep ?? 0)})`,
-            subtitles: [`Search: ${this.modelSearchQuery}\x1b[7m \x1b[27m`, `Current: ${current}`],
-            choices,
-            selected: this.modelSelectedIndex,
-            footer: "[Enter] Select • [Esc] Cancel • Type to search",
-        });
-    }
-    renderThinkingSelector() {
-        return new ClarifyView(this.theme, this.renderWidth).thinking({
-            step: this.stepLabel(this.editingStep ?? 0),
-            model: this.getEffectiveModel(this.editingStep ?? 0),
-            levels: this.getAvailableThinkingLevels(this.editingStep ?? 0),
-            selected: this.thinkingSelectedIndex,
-        });
-    }
-    renderSkillSelector() {
-        const selected = [...this.skillSelectedNames].join(", ");
-        const choices = this.filteredSkills.map((skill) => `${this.skillSelectedNames.has(skill.name) ? "[x]" : "[ ]"} ${skill.name} [${skill.source}] - ${truncateToWidth(skill.description ?? "", 25)}`);
-        return new ClarifyView(this.theme, this.renderWidth).selector({
-            title: `Select Skills (${this.stepLabel(this.editingStep ?? 0)})`,
-            subtitles: [
-                `Search: ${this.skillSearchQuery}\x1b[7m \x1b[27m`,
-                `Selected: ${selected.length > 0 ? selected : "(none)"}`,
-            ],
-            choices,
-            selected: this.skillCursorIndex,
-            footer: "[Enter] Confirm • [Space] Toggle • [Esc] Cancel",
-        });
-    }
-    renderOverview() {
-        const progress = this.options.agentConfigs.some((_, index) => this.draft.behavior(index).progress);
-        return new ClarifyView(this.theme, this.renderWidth).overview({
-            mode: this.mode,
-            selected: this.selectedStep,
-            background: this.runInBackground,
-            originalTask: this.options.originalTask,
-            chainDir: this.options.chainDir,
-            progress,
-            notice: this.noticeMessage,
-            steps: this.options.agentConfigs.map((agent, index) => ({
-                name: agent.name,
-                label: this.stepLabel(index),
-                template: (this.draft.templates[index] ?? "").split("\n")[0] ?? "",
-                model: this.getEffectiveModel(index),
-                modelOverridden: this.draft.override(index)?.model !== undefined,
-                behavior: this.draft.behavior(index),
-                nextUsesPrevious: (this.draft.templates[index + 1] ?? "").includes("{previous}"),
-            })),
-        });
-    }
-    invalidate() {
-        /* Rendering reads the current theme and owns no cache. */
-    }
-    dispose() {
-        if (this.noticeMessageTimer !== undefined) {
-            clearTimeout(this.noticeMessageTimer);
-        }
-        this.noticeMessageTimer = undefined;
-    }
-}
-function navigationDirection(data) {
-    if (matchesKey(data, "up")) {
-        return -1;
-    }
-    return matchesKey(data, "down") ? 1 : 0;
-}
-function moveSelection(index, direction, count) {
-    return count === 0 ? 0 : (index + direction + count) % count;
-}
-function searchInput(query, data) {
-    if (matchesKey(data, "backspace")) {
-        return query.slice(0, -1);
-    }
-    return data.length === 1 && data.charCodeAt(0) >= 32 ? query + data : query;
-}

package/dist/runs/foreground/clarification-draft.js

@@ -1,87 +0,0 @@
-/** Owns replace-only preview values and downstream output/read dependencies. */
-function resolveList(value) {
-    return value === false ? false : [...value];
-}
-export class ClarificationDraft {
-    templateValues;
-    get templates() {
-        return this.templateValues;
-    }
-    behaviors;
-    overrides = new Map();
-    constructor(templates, behaviors) {
-        this.templateValues = [...templates];
-        this.behaviors = behaviors;
-    }
-    behavior(index) {
-        const base = this.behaviors.at(index);
-        if (!base) {
-            throw new Error(`Missing clarification behavior for step ${index}.`);
-        }
-        const override = this.overrides.get(index);
-        return {
-            ...base,
-            ...override,
-            reads: resolveList(override?.reads ?? base.reads),
-            skills: resolveList(override?.skills ?? base.skills),
-        };
-    }
-    override(index) {
-        return this.overrides.get(index);
-    }
-    update(index, override) {
-        this.overrides.set(index, { ...this.overrides.get(index), ...override });
-    }
-    toggleProgress() {
-        const enabled = this.behaviors.some((_, index) => this.behavior(index).progress);
-        this.behaviors.forEach((_, index) => {
-            this.update(index, { progress: !enabled });
-        });
-    }
-    save(index, field, text) {
-        if (field === "template") {
-            const lines = (this.templateValues[index] ?? "").split("\n");
-            lines[0] = text;
-            this.templateValues[index] = lines.join("\n");
-            return;
-        }
-        if (field === "reads") {
-            const reads = text
-                .trim()
-                .split(",")
-                .map((file) => file.trim())
-                .filter((file) => file.length > 0);
-            this.update(index, { reads: reads.length > 0 ? reads : false });
-            return;
-        }
-        if (field === "output") {
-            this.saveOutput(index, text.trim());
-        }
-    }
-    saveOutput(index, text) {
-        const previous = this.behavior(index).output;
-        const output = text.length === 0 ? false : text;
-        this.update(index, { output });
-        if (typeof previous === "string" &&
-            previous.length > 0 &&
-            typeof output === "string" &&
-            previous !== output) {
-            this.propagateOutput(index, previous, output);
-        }
-    }
-    propagateOutput(index, previous, output) {
-        for (let next = index + 1; next < this.behaviors.length; next++) {
-            const reads = this.behavior(next).reads;
-            if (reads === false) {
-                continue;
-            }
-            const found = reads.indexOf(previous);
-            if (found < 0) {
-                continue;
-            }
-            const updated = [...reads];
-            updated[found] = output;
-            this.update(next, { reads: updated });
-        }
-    }
-}

package/dist/runs/foreground/clarify-contracts.js

@@ -1 +0,0 @@
-export {};