@asermax/tachikoma 2.0.0

package/dist/extensions/workflows/tools.js

@@ -0,0 +1,285 @@
+import { randomUUID } from "node:crypto";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+import { STEP_STATES } from "./model.js";
+export const UpdateActionSchema = StringEnum(["start", "complete", "skip"], {
+    description: "Transition to apply to the step",
+});
+export const EndActionSchema = StringEnum(["complete", "abort"], {
+    description: "Whether the workflow ended successfully or was abandoned",
+});
+const ACTION_PAST_TENSE = {
+    start: "started",
+    complete: "completed",
+    skip: "skipped",
+};
+// ---- helpers ------------------------------------------------------------------
+export const deleteScratchpad = (path) => {
+    try {
+        rmSync(path, { force: true });
+    }
+    catch {
+        // Best-effort cleanup — a leftover scratchpad never blocks the workflow.
+    }
+};
+const stepToSnapshot = (step) => ({
+    id: step.id,
+    title: step.title,
+    required: step.required,
+    path: dirname(step.instructionsPath),
+});
+const findNextPendingStep = (stepStates, snapshot) => snapshot.find((step) => (stepStates[step.id] ?? STEP_STATES.pending) === "pending") ?? null;
+const getSnapshotStep = (snapshot, stepId) => snapshot.find((step) => step.id === stepId) ?? null;
+const readStepInstructions = (step) => {
+    try {
+        return readFileSync(join(step.path, "instructions.md"), "utf8");
+    }
+    catch {
+        return null;
+    }
+};
+const buildStepResponse = (step, prefix) => {
+    const instructions = readStepInstructions(step);
+    return [
+        prefix,
+        ...(instructions != null ? [instructions] : []),
+        `---\n*Step path: \`${step.path}\`*`,
+    ].join("\n\n");
+};
+const formatUtc = (date) => `${date.toISOString().slice(0, 16).replace("T", " ")} UTC`;
+/**
+ * Validate a step transition against the current states and the frozen definition.
+ * Returns null when valid, an error message otherwise.
+ */
+export const validateTransition = (stepStates, stepId, action, snapshot) => {
+    const step = getSnapshotStep(snapshot, stepId);
+    if (step == null) {
+        const validIds = snapshot.map((candidate) => candidate.id).join(", ");
+        return `Invalid step '${stepId}'. Valid steps: ${validIds}`;
+    }
+    const currentState = stepStates[stepId] ?? STEP_STATES.pending;
+    if (currentState === "completed" || currentState === "skipped") {
+        return `Step '${stepId}' is already ${currentState}. Cannot change a completed or skipped step.`;
+    }
+    if (action === "start" && currentState !== "pending") {
+        return `Step '${stepId}' is already ${currentState}. Can only start a pending step.`;
+    }
+    if (action === "complete" && currentState !== "started") {
+        return `Step '${stepId}' is ${currentState}. Must start a step before completing it.`;
+    }
+    if (action === "skip") {
+        if (step.required)
+            return `Step '${stepId}' is required and cannot be skipped.`;
+        if (currentState !== "pending") {
+            return `Step '${stepId}' is ${currentState}. Can only skip a pending step.`;
+        }
+    }
+    return null;
+};
+// ---- handlers (testable without pi) ---------------------------------------------
+export const handleStartWorkflow = (deps, skillName, workflowName) => {
+    const definition = deps.findWorkflow(skillName, workflowName);
+    if (definition == null) {
+        throw new Error(`Workflow '${workflowName}' not found in skill '${skillName}'. ` +
+            "Check that the skill exists and contains this workflow.");
+    }
+    if (definition.steps.length === 0) {
+        throw new Error(`Workflow '${workflowName}' has no steps. Add step directories with instructions.md files.`);
+    }
+    const existing = deps.repository.getActive(skillName, workflowName);
+    if (existing != null) {
+        throw new Error(`Workflow '${workflowName}' is already active for skill '${skillName}'. ` +
+            `Existing workflow ID: ${existing.id}. ` +
+            "Use end_workflow to complete or abort it before starting a new one.");
+    }
+    const workflowId = randomUUID();
+    const scratchpadPath = join(deps.scratchpadDir, `workflow-${workflowId}.md`);
+    mkdirSync(deps.scratchpadDir, { recursive: true });
+    writeFileSync(scratchpadPath, `# Workflow: ${workflowName}\n\nWorkflow ID: ${workflowId}\n`);
+    const definitionSnapshot = definition.steps.map(stepToSnapshot);
+    const stepStates = Object.fromEntries(definition.steps.map((step) => [step.id, STEP_STATES.pending]));
+    try {
+        deps.repository.create({
+            id: workflowId,
+            skillName,
+            workflowName,
+            stepStates,
+            definitionSnapshot,
+            scratchpadPath,
+        });
+    }
+    catch (error) {
+        deleteScratchpad(scratchpadPath);
+        throw error;
+    }
+    const stepLines = definition.steps.map((step, index) => {
+        const skipMarker = step.required ? "" : " (skippable)";
+        return `${index + 1}. **${step.title}** (\`${step.id}\`)${skipMarker}`;
+    });
+    return [
+        `Workflow started: **${workflowName}**`,
+        `## Steps\n\n${stepLines.join("\n")}`,
+        "## Getting Started",
+        `1. Call \`update_workflow_state\` with \`workflow_id="${workflowId}", ` +
+            `step="${definition.steps[0]?.id}", action="start"\` to begin the first step\n` +
+            `2. Read the scratchpad file at \`${scratchpadPath}\` first, then keep it updated ` +
+            `with your workflow ID (\`${workflowId}\`) and progress notes`,
+        "## Progressing",
+        '- Use `action="start"` to begin the first step (returns its instructions)\n' +
+            '- Use `action="complete"` to finish a started step — this **auto-starts** the next ' +
+            "step and returns its instructions (no separate start call needed)\n" +
+            '- Use `action="skip"` to skip a skippable step — also auto-starts the next step\n' +
+            "- When the last step is completed, the workflow is **auto-finalized** " +
+            "(no need to call `end_workflow`)",
+        "## Recovery",
+        "If you lose context, call `query_workflow()` without arguments to find your workflow, " +
+            "then `query_workflow(workflow_id=...)` to resume.",
+    ].join("\n\n");
+};
+export const handleUpdateWorkflowState = (deps, workflowId, stepId, action) => {
+    const state = deps.repository.get(workflowId);
+    if (state == null)
+        throw new Error(`Workflow '${workflowId}' not found or no longer active.`);
+    const transitionError = validateTransition(state.stepStates, stepId, action, state.definitionSnapshot);
+    if (transitionError != null)
+        throw new Error(transitionError);
+    const stepStates = { ...state.stepStates };
+    // Present after a passing validation; narrows the type without a cast.
+    const step = getSnapshotStep(state.definitionSnapshot, stepId);
+    if (step == null)
+        throw new Error(`Invalid step '${stepId}'.`);
+    if (action === "start") {
+        stepStates[stepId] = STEP_STATES.started;
+        deps.repository.update(workflowId, { stepStates, currentStep: stepId });
+        return buildStepResponse(step, `Step **${step.title}** (\`${stepId}\`) started.`);
+    }
+    stepStates[stepId] = action === "complete" ? STEP_STATES.completed : STEP_STATES.skipped;
+    const next = findNextPendingStep(stepStates, state.definitionSnapshot);
+    if (next == null) {
+        deps.repository.update(workflowId, { stepStates, currentStep: null });
+        deps.repository.softDelete(workflowId);
+        deleteScratchpad(state.scratchpadPath);
+        const states = Object.values(stepStates);
+        const completed = states.filter((value) => value === "completed").length;
+        const skipped = states.filter((value) => value === "skipped").length;
+        return ("Workflow complete and finalized! " +
+            `All steps finished (${completed} completed, ${skipped} skipped).`);
+    }
+    stepStates[next.id] = STEP_STATES.started;
+    deps.repository.update(workflowId, { stepStates, currentStep: next.id });
+    return buildStepResponse(next, `Step \`${stepId}\` ${ACTION_PAST_TENSE[action]}. ` +
+        `Next step **${next.title}** (\`${next.id}\`) started.`);
+};
+const renderStateView = (state) => {
+    const stepLines = state.definitionSnapshot.map((step) => `- **${step.title}** (\`${step.id}\`): ${state.stepStates[step.id] ?? STEP_STATES.pending}`);
+    return [
+        "## Workflow State",
+        `- **ID**: ${state.id}\n` +
+            `- **Skill**: ${state.skillName}\n` +
+            `- **Workflow**: ${state.workflowName}\n` +
+            `- **Current Step**: ${state.currentStep ?? "none"}\n` +
+            `- **Scratchpad**: \`${state.scratchpadPath}\`\n` +
+            `- **Created**: ${formatUtc(state.createdAt)}\n` +
+            `- **Updated**: ${formatUtc(state.updatedAt)}`,
+        `### Steps\n\n${stepLines.join("\n")}`,
+    ].join("\n\n");
+};
+export const handleQueryWorkflow = (deps, workflowId) => {
+    if (workflowId != null) {
+        const state = deps.repository.get(workflowId);
+        if (state == null)
+            throw new Error(`Workflow '${workflowId}' not found or no longer active.`);
+        return renderStateView(state);
+    }
+    const active = deps.repository.listActive();
+    if (active.length === 0)
+        return "No active workflows.";
+    const lines = active.map((state) => `- **${state.workflowName}** (skill: \`${state.skillName}\`) — ID: \`${state.id}\`, ` +
+        `current step: \`${state.currentStep ?? "none"}\`, started: ${formatUtc(state.createdAt)}`);
+    return `## Active Workflows\n\n${lines.join("\n")}`;
+};
+export const handleEndWorkflow = (deps, workflowId, action) => {
+    const state = deps.repository.get(workflowId);
+    if (state == null)
+        throw new Error(`Workflow '${workflowId}' not found or no longer active.`);
+    if (!deps.repository.softDelete(workflowId)) {
+        throw new Error(`Failed to end workflow '${workflowId}'.`);
+    }
+    deleteScratchpad(state.scratchpadPath);
+    const label = action === "complete" ? "completed" : "aborted";
+    return `Workflow **${state.workflowName}** ${label}. State cleaned up.`;
+};
+// ---- pi tool registration -------------------------------------------------------
+const text = (value) => ({
+    content: [{ type: "text", text: value }],
+    details: undefined,
+});
+const WORKFLOW_ID_PARAM = Type.String({ description: "The workflow instance ID" });
+export const registerWorkflowTools = (pi, deps) => {
+    pi.registerTool({
+        name: "start_workflow",
+        label: "Start workflow",
+        description: "Start a new instance of a workflow defined by a skill. Creates a tracked instance " +
+            "with a unique ID and returns the step list, scratchpad path, and guidance for " +
+            "progressing through the steps.",
+        promptSnippet: "start_workflow: begin a tracked multi-step workflow defined by a skill",
+        promptGuidelines: [
+            "When a skill defines a workflow for the task at hand, drive it with start_workflow and update_workflow_state instead of improvising the steps.",
+        ],
+        parameters: Type.Object({
+            skill_name: Type.String({ description: "Name of the skill containing the workflow" }),
+            workflow_name: Type.String({ description: "Name of the workflow to start" }),
+        }),
+        async execute(_toolCallId, params) {
+            return text(handleStartWorkflow(deps, params.skill_name, params.workflow_name));
+        },
+    });
+    pi.registerTool({
+        name: "update_workflow_state",
+        label: "Update workflow state",
+        description: "Update a workflow step's state. Validates the transition and returns step " +
+            "instructions. Completing or skipping a step auto-starts the next pending step and " +
+            "returns its instructions. When all steps are done, the workflow is auto-finalized " +
+            "(cleaned up).",
+        promptSnippet: "update_workflow_state: start, complete, or skip a workflow step",
+        parameters: Type.Object({
+            workflow_id: WORKFLOW_ID_PARAM,
+            step: Type.String({ description: "The step identifier (directory name)" }),
+            action: UpdateActionSchema,
+        }),
+        async execute(_toolCallId, params) {
+            return text(handleUpdateWorkflowState(deps, params.workflow_id, params.step, params.action));
+        },
+    });
+    pi.registerTool({
+        name: "query_workflow",
+        label: "Query workflow",
+        description: "Query workflow state for recovery after context loss. With workflow_id, returns the " +
+            "full state including all step statuses; without it, lists all active workflows.",
+        promptSnippet: "query_workflow: inspect active workflows and their step states",
+        parameters: Type.Object({
+            workflow_id: Type.Optional(Type.String({ description: "Workflow instance ID. Omit to list all active workflows." })),
+        }),
+        async execute(_toolCallId, params) {
+            return text(handleQueryWorkflow(deps, params.workflow_id));
+        },
+    });
+    pi.registerTool({
+        name: "end_workflow",
+        label: "End workflow",
+        description: "End a workflow instance. Primarily used to abort a workflow in progress — normal " +
+            "completion happens automatically when the last step is completed. Removes the " +
+            "workflow state and its scratchpad file.",
+        promptSnippet: "end_workflow: abort or close out a workflow instance",
+        parameters: Type.Object({
+            workflow_id: WORKFLOW_ID_PARAM,
+            action: EndActionSchema,
+        }),
+        async execute(_toolCallId, params) {
+            return text(handleEndWorkflow(deps, params.workflow_id, params.action));
+        },
+    });
+};
+//# sourceMappingURL=tools.js.map

package/dist/extensions/workflows/tools.js.map

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

package/dist/log.d.ts

@@ -0,0 +1,8 @@
+import pino from "pino";
+export type Logger = ReturnType<typeof pino>;
+export interface LogOptions {
+    level: string;
+    pretty: boolean;
+}
+export declare const createRootLogger: ({ level, pretty }: LogOptions) => Logger;
+export declare const componentLogger: (root: Logger, component: string) => Logger;

package/dist/log.js

@@ -0,0 +1,15 @@
+import pino from "pino";
+// Logs always go to stderr so channel output on stdout (REPL) stays clean.
+export const createRootLogger = ({ level, pretty }) => {
+    // Legacy configs used uppercase levels ("INFO"); pino requires lowercase,
+    // and this runs before config migration gets a chance to translate.
+    const normalized = level.toLowerCase();
+    return pretty
+        ? pino({
+            level: normalized,
+            transport: { target: "pino-pretty", options: { destination: 2, colorize: true } },
+        })
+        : pino({ level: normalized }, pino.destination(2));
+};
+export const componentLogger = (root, component) => root.child({ component });
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAc,EAAU,EAAE;IACxE,0EAA0E;IAC1E,oEAAoE;IACpE,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,OAAO,MAAM;QACX,CAAC,CAAC,IAAI,CAAC;YACH,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;SAClF,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAU,EAAE,CACzE,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { runApp } from "./app.js";
+const { values } = parseArgs({
+    options: {
+        channel: { type: "string", short: "c" },
+        config: { type: "string" },
+        help: { type: "boolean", short: "h" },
+    },
+});
+if (values.help === true) {
+    console.log(`tachikoma — proactive personal assistant
+
+Usage: tachikoma [options]
+
+Options:
+  -c, --channel <name>   Channel to run (default: from config, usually "repl")
+      --config <path>    Config file (default: ~/.config/tachikoma/config.toml)
+  -h, --help             Show this help
+`);
+    process.exit(0);
+}
+runApp({ channel: values.channel, configPath: values.config }).catch((error) => {
+    console.error(error instanceof Error ? (error.stack ?? error.message) : error);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE;QACP,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;QACvC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;KACtC;CACF,CAAC,CAAC;AAEH,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC;;;;;;;;CAQb,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC7E,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/migration/ask.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from "../log.ts";
+export type Ask = (question: string) => Promise<boolean>;
+/**
+ * Yes/no startup prompt. Interactive only on a TTY; otherwise every question
+ * resolves to its safe default (no) with a warning. Prompts run before any
+ * channel starts, so there is no stdin contention with the REPL.
+ */
+export declare const createAsk: (log: Logger) => Ask;

package/dist/migration/ask.js

@@ -0,0 +1,24 @@
+import { createInterface } from "node:readline/promises";
+/**
+ * Yes/no startup prompt. Interactive only on a TTY; otherwise every question
+ * resolves to its safe default (no) with a warning. Prompts run before any
+ * channel starts, so there is no stdin contention with the REPL.
+ */
+export const createAsk = (log) => {
+    return async (question) => {
+        if (process.stdin.isTTY !== true) {
+            log.warn({ question }, "non-interactive startup — answering no");
+            return false;
+        }
+        // Prompt on stderr so channel output on stdout (REPL) stays clean.
+        const readline = createInterface({ input: process.stdin, output: process.stderr });
+        try {
+            const answer = await readline.question(`${question} [y/N] `);
+            return /^y(es)?$/i.test(answer.trim());
+        }
+        finally {
+            readline.close();
+        }
+    };
+};
+//# sourceMappingURL=ask.js.map

package/dist/migration/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/migration/ask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAMzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAO,EAAE;IAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE;QACxB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACjC,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,wCAAwC,CAAC,CAAC;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mEAAmE;QACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAEnF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,SAAS,CAAC,CAAC;YAC7D,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/migration/config.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from "../config/schema.ts";
+import type { Logger } from "../log.ts";
+import { type Ask } from "./ask.ts";
+export declare const isOldShapeConfig: (raw: Record<string, unknown>) => boolean;
+/**
+ * Detect a config.toml written by a legacy install, back it up to
+ * `<path>.legacy-backup`, write a translated new-layout file, and return the
+ * reloaded Config. Returns null when the file is absent or already new-shape.
+ */
+export declare const adaptConfig: (path: string, log: Logger, ask?: Ask) => Promise<Config | null>;

package/dist/migration/config.js

@@ -0,0 +1,122 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
+import { loadConfig } from "../config/load.js";
+import { createAsk } from "./ask.js";
+const OLD_ROLE_KEYS = {
+    model: "main",
+    searcher_model: "searcher",
+    processor_model: "processor",
+    classifier_model: "classifier",
+};
+const asTable = (value) => typeof value === "object" && value != null && !Array.isArray(value)
+    ? value
+    : null;
+export const isOldShapeConfig = (raw) => {
+    const agent = asTable(raw.agent);
+    return (asTable(raw.telegram) != null ||
+        typeof raw.channel === "string" ||
+        (agent != null && Object.keys(OLD_ROLE_KEYS).some((key) => key in agent)));
+};
+const translateOldConfig = async (raw, log, ask) => {
+    const result = {};
+    const oldWorkspace = asTable(raw.workspace);
+    if (typeof oldWorkspace?.path === "string")
+        result.workspace = { path: oldWorkspace.path };
+    const oldAgent = asTable(raw.agent);
+    const agent = {};
+    if (oldAgent != null) {
+        for (const [oldKey, role] of Object.entries(OLD_ROLE_KEYS)) {
+            const value = oldAgent[oldKey];
+            if (typeof value !== "string" || value === "")
+                continue;
+            // Legacy values were bare model aliases ("opus"); pi needs "provider/model-id".
+            const candidate = value.includes("/") ? value : `anthropic/${value}`;
+            if (await ask(`Set agent ${role} model to "${candidate}" (was "${value}")?`)) {
+                agent[role] = candidate;
+            }
+            else {
+                log.warn({ role, value }, "agent role left unset — configure it under [agent] in the new config if needed");
+            }
+        }
+    }
+    if (Object.keys(agent).length > 0)
+        result.agent = agent;
+    const oldLogging = asTable(raw.logging);
+    if (oldLogging != null) {
+        const logging = {};
+        if (typeof oldLogging.level === "string")
+            logging.level = oldLogging.level.toLowerCase();
+        if (typeof oldLogging.console === "boolean")
+            logging.pretty = oldLogging.console;
+        if (Object.keys(logging).length > 0)
+            result.logging = logging;
+    }
+    if (typeof raw.channel === "string")
+        result.channels = { default: raw.channel };
+    const resumeWindow = oldAgent?.session_resume_window;
+    if (typeof resumeWindow === "number")
+        result.sessions = { resumeWindowSeconds: resumeWindow };
+    const timezone = asTable(raw.tasks)?.timezone;
+    if (typeof timezone === "string" && timezone !== "")
+        result.scheduler = { timezone };
+    const oldTelegram = asTable(raw.telegram);
+    if (oldTelegram != null) {
+        const telegram = {};
+        if (typeof oldTelegram.bot_token === "string")
+            telegram.botToken = oldTelegram.bot_token;
+        if (typeof oldTelegram.authorized_chat_id === "number") {
+            telegram.chatId = oldTelegram.authorized_chat_id;
+        }
+        if (typeof oldTelegram.push_notifications === "boolean") {
+            telegram.pushNotifications = oldTelegram.push_notifications;
+        }
+        const extraRoots = asTable(oldTelegram.send_file)?.extra_roots;
+        if (Array.isArray(extraRoots)) {
+            telegram.extraFileRoots = extraRoots.filter((root) => typeof root === "string");
+        }
+        if (oldTelegram.inbound_reactions != null) {
+            log.info("telegram inbound_reactions has no pi equivalent — dropped");
+        }
+        result.extensions = { telegram };
+    }
+    const carried = new Set(["workspace", "agent", "logging", "channel", "telegram"]);
+    const dropped = Object.keys(raw).filter((key) => !carried.has(key));
+    if (dropped.length > 0) {
+        log.info({ sections: dropped }, "config sections without a pi equivalent were not migrated (except tasks.timezone → scheduler.timezone); originals preserved in the backup");
+    }
+    return result;
+};
+/**
+ * Detect a config.toml written by a legacy install, back it up to
+ * `<path>.legacy-backup`, write a translated new-layout file, and return the
+ * reloaded Config. Returns null when the file is absent or already new-shape.
+ */
+export const adaptConfig = async (path, log, ask = createAsk(log)) => {
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = parseToml(raw);
+    }
+    catch (error) {
+        log.warn({ path, error }, "could not parse config for legacy-shape detection — leaving it untouched");
+        return null;
+    }
+    if (!isOldShapeConfig(parsed))
+        return null;
+    log.warn({ path }, "legacy config detected — translating to the new layout");
+    const translated = await translateOldConfig(parsed, log, ask);
+    const backupPath = `${path}.legacy-backup`;
+    await writeFile(backupPath, raw, "utf8");
+    const header = `# Tachikoma configuration\n# Translated from the legacy config; the original is preserved at\n# ${backupPath}\n\n`;
+    await writeFile(path, `${header}${stringifyToml(translated)}\n`, "utf8");
+    log.info({ path, backupPath }, "config translated — continuing with the new layout");
+    const { config } = await loadConfig(path);
+    return config;
+};
+//# sourceMappingURL=config.js.map

package/dist/migration/config.js.map

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

package/dist/migration/context.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "../log.ts";
+import type { Workspace } from "../workspace.ts";
+export declare const adaptContextFiles: (workspace: Workspace, log: Logger) => Promise<void>;

package/dist/migration/context.js

@@ -0,0 +1,24 @@
+import { rename, rmdir } from "node:fs/promises";
+import { join } from "node:path";
+import { pathExists } from "./fs.js";
+// Legacy workspaces kept these under {workspace}/context/; pi reads
+// SOUL.md/USER.md from the workspace root and discovers AGENTS.md natively.
+const CONTEXT_FILES = ["SOUL.md", "USER.md", "AGENTS.md"];
+export const adaptContextFiles = async (workspace, log) => {
+    const oldDir = workspace.resolve("context");
+    for (const name of CONTEXT_FILES) {
+        const oldPath = join(oldDir, name);
+        const newPath = workspace.resolve(name);
+        if (!(await pathExists(oldPath)))
+            continue;
+        if (await pathExists(newPath)) {
+            log.warn({ file: name }, "context file exists in both context/ and the workspace root — keeping the root file, old copy left in context/");
+            continue;
+        }
+        await rename(oldPath, newPath);
+        log.info({ file: name }, "moved legacy context file to the workspace root");
+    }
+    // Tidy up the old directory when nothing is left; rmdir refuses non-empty dirs.
+    await rmdir(oldDir).catch(() => undefined);
+};
+//# sourceMappingURL=context.js.map

package/dist/migration/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/migration/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,oEAAoE;AACpE,4EAA4E;AAC5E,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,SAAoB,EAAE,GAAW,EAAiB,EAAE;IAC1F,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YAAE,SAAS;QAE3C,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CACN,EAAE,IAAI,EAAE,IAAI,EAAE,EACd,gHAAgH,CACjH,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,gFAAgF;IAChF,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC,CAAC"}

package/dist/migration/database.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from "../log.ts";
+import type { Workspace } from "../workspace.ts";
+export declare const LEGACY_BACKUP_DB = "tachikoma.legacy-backup.db";
+/**
+ * Detect a database written by a legacy install and rename it to a backup so
+ * drizzle starts from a fresh file. The backup is never deleted.
+ */
+export declare const adaptLegacyDatabase: (workspace: Workspace, log: Logger) => Promise<void>;