@asermax/tachikoma 2.0.0

package/dist/extensions/git/sync.js

@@ -0,0 +1,189 @@
+import { access, readFile, stat } from "node:fs/promises";
+import { isAbsolute, join, resolve } from "node:path";
+import { hasUncommittedChanges, runGit, runGitCapture } from "./git.js";
+export const DIVERGENCE_STATUS = {
+    upToDate: "UP_TO_DATE",
+    ahead: "AHEAD",
+    behind: "BEHIND",
+    diverged: "DIVERGED",
+};
+export const PUSH_RESULT = {
+    pushed: "PUSHED",
+    nothingToPush: "NOTHING_TO_PUSH",
+    rebaseSucceeded: "REBASE_SUCCEEDED",
+    pushFailed: "PUSH_FAILED",
+    rebaseFailed: "REBASE_FAILED",
+};
+export const SYNC_RESULT = {
+    upToDate: "UP_TO_DATE",
+    fastForwarded: "FAST_FORWARDED",
+    rebaseSucceeded: "REBASE_SUCCEEDED",
+    syncFailed: "SYNC_FAILED",
+    dirtySkipped: "DIRTY_SKIPPED",
+};
+export const PUSH_SUCCESS = new Set([
+    PUSH_RESULT.pushed,
+    PUSH_RESULT.rebaseSucceeded,
+]);
+const exists = async (path) => access(path).then(() => true, () => false);
+/**
+ * Resolve the real .git directory, following a gitlink file if present.
+ * Submodules and worktrees store `.git` as a file containing `gitdir: <path>`
+ * rather than a directory — reading it keeps rebase-state checks working there.
+ */
+const resolveGitDir = async (cwd) => {
+    const gitPath = join(cwd, ".git");
+    try {
+        const stats = await stat(gitPath);
+        if (stats.isFile()) {
+            const content = (await readFile(gitPath, "utf8")).trim();
+            const prefix = "gitdir:";
+            if (content.startsWith(prefix)) {
+                const target = content.slice(prefix.length).trim();
+                return isAbsolute(target) ? target : resolve(cwd, target);
+            }
+        }
+    }
+    catch {
+        return gitPath;
+    }
+    return gitPath;
+};
+const rebaseInProgress = async (cwd) => {
+    const gitDir = await resolveGitDir(cwd);
+    return ((await exists(join(gitDir, "rebase-merge"))) || (await exists(join(gitDir, "rebase-apply"))));
+};
+const abortStaleRebase = async (cwd, log) => {
+    if (!(await rebaseInProgress(cwd)))
+        return;
+    log.warn({ path: cwd }, "stale rebase detected — aborting");
+    try {
+        await runGit(cwd, ["rebase", "--abort"]);
+    }
+    catch (error) {
+        log.warn({ path: cwd, err: error }, "failed to abort stale rebase");
+    }
+};
+/**
+ * Resolve "HEAD" to the actual local branch name. Remotes don't always have a
+ * `refs/remotes/<remote>/HEAD` symbolic ref — repos created via `git init`
+ * (rather than cloned) never get one — so passing "HEAD" through to
+ * `<remote>/HEAD` breaks the rebase ref and false-positives the
+ * `merge-base --is-ancestor` checks into DIVERGED.
+ */
+const resolveBranch = async (cwd, branch) => {
+    if (branch !== "HEAD")
+        return branch;
+    const result = await runGitCapture(cwd, ["symbolic-ref", "--short", "HEAD"]);
+    if (result.code === 0 && result.stdout !== "")
+        return result.stdout;
+    return branch;
+};
+/**
+ * Classify the relationship between local HEAD and `<remote>/<branch>`.
+ * Precondition: `git fetch <remote>` has already run.
+ */
+export const detectDivergence = async (cwd, remote = "origin", branch = "HEAD") => {
+    const remoteRef = `${remote}/${branch}`;
+    const remoteIsAncestor = (await runGitCapture(cwd, ["merge-base", "--is-ancestor", remoteRef, "HEAD"])).code === 0;
+    const headIsAncestor = (await runGitCapture(cwd, ["merge-base", "--is-ancestor", "HEAD", remoteRef])).code === 0;
+    if (remoteIsAncestor && headIsAncestor)
+        return DIVERGENCE_STATUS.upToDate;
+    if (remoteIsAncestor)
+        return DIVERGENCE_STATUS.ahead;
+    if (headIsAncestor)
+        return DIVERGENCE_STATUS.behind;
+    return DIVERGENCE_STATUS.diverged;
+};
+/**
+ * Attempt a naive rebase with --autostash. On conflict, aborts the rebase to
+ * restore a clean state and returns false.
+ */
+const tryNaiveRebase = async (cwd, remoteBranch, log) => {
+    const result = await runGitCapture(cwd, ["rebase", "--autostash", remoteBranch]);
+    if (result.code === 0)
+        return true;
+    if (await rebaseInProgress(cwd)) {
+        try {
+            await runGit(cwd, ["rebase", "--abort"]);
+        }
+        catch (error) {
+            log.warn({ path: cwd, err: error }, "failed to abort rebase after conflict");
+        }
+    }
+    else {
+        log.warn({ path: cwd }, "rebase failed without starting (no conflicts)");
+    }
+    return false;
+};
+/**
+ * Push local commits with divergence recovery: abort stale rebase → fetch →
+ * detect divergence → push directly when ahead, or rebase-then-push when
+ * diverged. Conflicting rebases are aborted (local commits preserved) and
+ * surface as REBASE_FAILED.
+ */
+export const smartPush = async (cwd, remote, branch, log) => {
+    try {
+        await abortStaleRebase(cwd, log);
+        await runGit(cwd, ["fetch", remote]);
+        const resolved = await resolveBranch(cwd, branch);
+        const divergence = await detectDivergence(cwd, remote, resolved);
+        if (divergence === DIVERGENCE_STATUS.upToDate || divergence === DIVERGENCE_STATUS.behind) {
+            return PUSH_RESULT.nothingToPush;
+        }
+        if (divergence === DIVERGENCE_STATUS.ahead) {
+            await runGit(cwd, ["push", remote, "HEAD"]);
+            return PUSH_RESULT.pushed;
+        }
+        const remoteBranch = `${remote}/${resolved}`;
+        if (!(await tryNaiveRebase(cwd, remoteBranch, log)))
+            return PUSH_RESULT.rebaseFailed;
+        try {
+            await runGit(cwd, ["push", remote, "HEAD"]);
+            return PUSH_RESULT.rebaseSucceeded;
+        }
+        catch (error) {
+            log.warn({ path: cwd, err: error }, "push failed after successful rebase");
+            return PUSH_RESULT.pushFailed;
+        }
+    }
+    catch (error) {
+        log.warn({ path: cwd, err: error }, "smart push failed");
+        return PUSH_RESULT.rebaseFailed;
+    }
+};
+/**
+ * Pull remote changes with divergence recovery: skip when dirty, abort stale
+ * rebase → fetch → detect divergence → fast-forward when behind, or naive
+ * rebase when diverged. Conflicting rebases are aborted and surface as
+ * SYNC_FAILED.
+ */
+export const smartPull = async (cwd, remote, branch, log) => {
+    try {
+        if (await hasUncommittedChanges(cwd)) {
+            log.warn({ path: cwd }, "working tree has uncommitted changes — skipping sync");
+            return SYNC_RESULT.dirtySkipped;
+        }
+        await abortStaleRebase(cwd, log);
+        await runGit(cwd, ["fetch", remote]);
+        const resolved = await resolveBranch(cwd, branch);
+        const divergence = await detectDivergence(cwd, remote, resolved);
+        if (divergence === DIVERGENCE_STATUS.upToDate)
+            return SYNC_RESULT.upToDate;
+        if (divergence === DIVERGENCE_STATUS.ahead)
+            return SYNC_RESULT.upToDate;
+        const remoteBranch = `${remote}/${resolved}`;
+        if (divergence === DIVERGENCE_STATUS.behind) {
+            await runGit(cwd, ["rebase", remoteBranch]);
+            return SYNC_RESULT.fastForwarded;
+        }
+        if (await tryNaiveRebase(cwd, remoteBranch, log))
+            return SYNC_RESULT.rebaseSucceeded;
+        return SYNC_RESULT.syncFailed;
+    }
+    catch (error) {
+        log.warn({ path: cwd, err: error }, "smart pull failed");
+        return SYNC_RESULT.syncFailed;
+    }
+};
+//# sourceMappingURL=sync.js.map

package/dist/extensions/git/sync.js.map

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

package/dist/extensions/git/tools.d.ts

@@ -0,0 +1,21 @@
+import { type ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import { type Static, Type } from "typebox";
+import type { Logger } from "../../log.ts";
+import { type Completer } from "./commit.ts";
+export interface GitToolDeps {
+    workspaceRoot: string;
+    side: Completer;
+    log: Logger;
+}
+export declare const QueryGitStatusParams: Type.TObject<{}>;
+export declare const ListRecentCommitsParams: Type.TObject<{
+    limit: Type.TOptional<Type.TNumber>;
+}>;
+export declare const CommitWorkspaceParams: Type.TObject<{
+    message: Type.TOptional<Type.TString>;
+}>;
+export declare const handleQueryGitStatus: ({ workspaceRoot }: GitToolDeps) => Promise<string>;
+export declare const handleListRecentCommits: ({ workspaceRoot }: GitToolDeps, args: Static<typeof ListRecentCommitsParams>) => Promise<string>;
+export declare const handleCommitWorkspace: ({ workspaceRoot, side, log }: GitToolDeps, args: Static<typeof CommitWorkspaceParams>) => Promise<string>;
+/** pi extension factory exposing the workspace git tools to the agent. */
+export declare const createGitToolsFactory: (deps: GitToolDeps) => ExtensionFactory;

package/dist/extensions/git/tools.js

@@ -0,0 +1,101 @@
+import { truncateTail } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { commitAll } from "./commit.js";
+import { runGitCapture } from "./git.js";
+import { workspaceFallbackMessage } from "./processor.js";
+export const QueryGitStatusParams = Type.Object({});
+export const ListRecentCommitsParams = Type.Object({
+    limit: Type.Optional(Type.Number({ description: "Maximum number of commits to return (default 10)" })),
+});
+export const CommitWorkspaceParams = Type.Object({
+    message: Type.Optional(Type.String({
+        description: "Commit message to use; when omitted, a message is generated from the changes",
+    })),
+});
+export const handleQueryGitStatus = async ({ workspaceRoot }) => {
+    const branch = await runGitCapture(workspaceRoot, ["symbolic-ref", "--short", "HEAD"]);
+    const header = branch.code === 0 && branch.stdout !== ""
+        ? `On branch ${branch.stdout}`
+        : "Detached HEAD or unborn branch";
+    const status = await runGitCapture(workspaceRoot, ["status", "--porcelain"]);
+    if (status.code !== 0) {
+        throw new Error(`git status failed: ${status.stderr || `exit code ${status.code}`}`);
+    }
+    if (status.stdout === "")
+        return `${header}\n\nWorking tree is clean.`;
+    const { content } = truncateTail(status.stdout);
+    return `${header}\n\nUncommitted changes:\n${content}`;
+};
+export const handleListRecentCommits = async ({ workspaceRoot }, args) => {
+    const limit = args.limit ?? 10;
+    const result = await runGitCapture(workspaceRoot, [
+        "log",
+        "-n",
+        String(limit),
+        "--date=short",
+        "--format=%h %ad %s",
+    ]);
+    if (result.code !== 0 || result.stdout === "")
+        return "No commits found.";
+    const { content } = truncateTail(result.stdout);
+    return `Recent commits:\n${content}`;
+};
+export const handleCommitWorkspace = async ({ workspaceRoot, side, log }, args) => {
+    const message = await commitAll({
+        cwd: workspaceRoot,
+        side,
+        fallbackMessage: workspaceFallbackMessage(),
+        ...(args.message != null ? { message: args.message } : {}),
+        log,
+    });
+    if (message == null)
+        return "Nothing to commit — the working tree is clean.";
+    return `Committed workspace changes: ${message}`;
+};
+const textResult = (text) => ({
+    content: [{ type: "text", text }],
+    details: undefined,
+});
+/** pi extension factory exposing the workspace git tools to the agent. */
+export const createGitToolsFactory = (deps) => (pi) => {
+    pi.registerTool({
+        name: "query_git_status",
+        label: "Query Git Status",
+        description: "Show the workspace git status: current branch and any uncommitted changes (modified, added, deleted, untracked files).",
+        promptSnippet: "Inspect uncommitted changes in the workspace git repo",
+        promptGuidelines: [
+            "Use query_git_status to check for pending workspace changes before committing.",
+        ],
+        parameters: QueryGitStatusParams,
+        async execute() {
+            return textResult(await handleQueryGitStatus(deps));
+        },
+    });
+    pi.registerTool({
+        name: "list_recent_commits",
+        label: "List Recent Commits",
+        description: "List the most recent commits in the workspace git repo (hash, date, and subject), newest first.",
+        promptSnippet: "Review recent workspace commit history",
+        promptGuidelines: [
+            "Use list_recent_commits when the user asks what changed in the workspace recently.",
+        ],
+        parameters: ListRecentCommitsParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleListRecentCommits(deps, params));
+        },
+    });
+    pi.registerTool({
+        name: "commit_workspace",
+        label: "Commit Workspace",
+        description: "Stage and commit all pending workspace changes in a single commit. A descriptive message is generated from the changes unless one is provided. Changes are also committed automatically at session end — use this only when an immediate commit matters.",
+        promptSnippet: "Commit pending workspace changes on demand",
+        promptGuidelines: [
+            "Use commit_workspace when the user explicitly asks to save or commit workspace changes now.",
+        ],
+        parameters: CommitWorkspaceParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleCommitWorkspace(deps, params));
+        },
+    });
+};
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/extensions/git/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAG5C,OAAO,EAAkB,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAQ1D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC,CACjF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,8EAA8E;KAC5F,CAAC,CACH;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,EAAE,aAAa,EAAe,EAAmB,EAAE;IAC5F,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,aAAa,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACvF,MAAM,MAAM,GACV,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;QACvC,CAAC,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE;QAC9B,CAAC,CAAC,gCAAgC,CAAC;IAEvC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAE7E,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,MAAM,IAAI,aAAa,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,GAAG,MAAM,4BAA4B,CAAC;IAEvE,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEhD,OAAO,GAAG,MAAM,6BAA6B,OAAO,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,EAAE,aAAa,EAAe,EAC9B,IAA4C,EAC3B,EAAE;IACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,aAAa,EAAE;QAChD,KAAK;QACL,IAAI;QACJ,MAAM,CAAC,KAAK,CAAC;QACb,cAAc;QACd,oBAAoB;KACrB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,mBAAmB,CAAC;IAE1E,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEhD,OAAO,oBAAoB,OAAO,EAAE,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAe,EACzC,IAA0C,EACzB,EAAE;IACnB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC;QAC9B,GAAG,EAAE,aAAa;QAClB,IAAI;QACJ,eAAe,EAAE,wBAAwB,EAAE;QAC3C,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG;KACJ,CAAC,CAAC;IAEH,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,gDAAgD,CAAC;IAE7E,OAAO,gCAAgC,OAAO,EAAE,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;IAC1C,OAAO,EAAE,SAAS;CACnB,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAChC,CAAC,IAAiB,EAAoB,EAAE,CACxC,CAAC,EAAE,EAAE,EAAE;IACL,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,wHAAwH;QAC1H,aAAa,EAAE,uDAAuD;QACtE,gBAAgB,EAAE;YAChB,gFAAgF;SACjF;QACD,UAAU,EAAE,oBAAoB;QAChC,KAAK,CAAC,OAAO;YACX,OAAO,UAAU,CAAC,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;KACF,CAAC,CAAC;IAEH,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,iGAAiG;QACnG,aAAa,EAAE,wCAAwC;QACvD,gBAAgB,EAAE;YAChB,oFAAoF;SACrF;QACD,UAAU,EAAE,uBAAuB;QACnC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;YAC/B,OAAO,UAAU,CAAC,MAAM,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACjE,CAAC;KACF,CAAC,CAAC;IAEH,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,0PAA0P;QAC5P,aAAa,EAAE,4CAA4C;QAC3D,gBAAgB,EAAE;YAChB,6FAA6F;SAC9F;QACD,UAAU,EAAE,qBAAqB;QACjC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;YAC/B,OAAO,UAAU,CAAC,MAAM,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/extensions/host.d.ts

@@ -0,0 +1,31 @@
+import type { AgentManager } from "../agent/manager.ts";
+import type { Config } from "../config/schema.ts";
+import type { Coordinator } from "../coordinator.ts";
+import type { AppDatabase } from "../db/index.ts";
+import type { EventBus } from "../events.ts";
+import { type Logger } from "../log.ts";
+import type { Scheduler } from "../scheduler.ts";
+import type { SessionRegistry } from "../sessions/registry.ts";
+import type { Workspace } from "../workspace.ts";
+import type { TachikomaExtension } from "./api.ts";
+import type { Registrations } from "./registrations.ts";
+export interface HostServices {
+    config: Config;
+    workspace: Workspace;
+    log: Logger;
+    db: AppDatabase;
+    events: EventBus;
+    scheduler: Scheduler;
+    agent: AgentManager;
+    registry: SessionRegistry;
+    coordinator: Coordinator;
+    regs: Registrations;
+}
+export declare class ExtensionHost {
+    private readonly services;
+    constructor(services: HostServices);
+    private readonly queue;
+    load(extensions: TachikomaExtension<never>[]): Promise<void>;
+    bootstrap(): Promise<void>;
+    private buildContext;
+}

package/dist/extensions/host.js

@@ -0,0 +1,75 @@
+import { SideRunner } from "../agent/side-run.js";
+import { parseWithSchema } from "../config/parse.js";
+import { KeyValueState } from "../db/state.js";
+import { componentLogger } from "../log.js";
+export class ExtensionHost {
+    services;
+    constructor(services) {
+        this.services = services;
+    }
+    queue = [];
+    async load(extensions) {
+        this.queue.push(...extensions);
+        // Extensions may enqueue further extensions (plugins) while loading.
+        for (let index = 0; index < this.queue.length; index += 1) {
+            const extension = this.queue[index];
+            const app = this.buildContext(extension);
+            await extension.setup(app);
+            this.services.log.debug({ extension: extension.name }, "extension loaded");
+        }
+    }
+    async bootstrap() {
+        for (const { name, hook } of this.services.regs.bootstrapHooks) {
+            this.services.log.debug({ hook: name }, "bootstrap hook");
+            await hook();
+        }
+    }
+    buildContext(extension) {
+        const { services } = this;
+        const log = componentLogger(services.log, extension.name);
+        const rawSection = services.config.extensions[extension.name] ?? {};
+        const extensionConfig = extension.configSchema != null
+            ? parseWithSchema(extension.configSchema, rawSection, `extensions.${extension.name}`)
+            : rawSection;
+        return {
+            config: services.config,
+            extensionConfig,
+            workspace: services.workspace,
+            log,
+            db: services.db,
+            state: new KeyValueState(services.db, extension.name),
+            events: services.events,
+            scheduler: services.scheduler,
+            sessions: {
+                current: () => services.coordinator.current(),
+                get: (id) => services.registry.get(id),
+                update: (id, patch) => services.registry.update(id, patch),
+                listResumable: () => services.registry.listResumable(services.config.sessions.resumeWindowSeconds),
+                close: () => services.coordinator.closeActiveSession(),
+                closeIfIdle: () => services.coordinator.closeActiveSessionIfIdle(),
+                abortExchange: () => services.coordinator.abortExchange(),
+                onOpen: (hook) => services.regs.sessionOpenHooks.push(hook),
+                onExchange: (processor) => services.regs.exchangeProcessors.push(processor),
+                registerProcessor: (processor) => services.regs.postProcessors.push(processor),
+            },
+            channels: {
+                register: (channel) => services.regs.channels.set(channel.name, channel),
+                deliver: (delivery) => services.coordinator.deliver(delivery),
+            },
+            agent: {
+                use: (factory) => services.regs.piFactories.push(factory),
+                systemPrompt: (builder) => services.regs.systemPromptBuilders.push(builder),
+                provideContext: (provider) => services.regs.contextProviders.push(provider),
+                models: services.agent.tiers,
+                side: new SideRunner(services.agent, log),
+            },
+            inbound: {
+                use: (middleware) => services.regs.inboundMiddleware.push(middleware),
+            },
+            bootstrap: (name, hook) => services.regs.bootstrapHooks.push({ name: `${extension.name}:${name}`, hook }),
+            status: (text) => services.coordinator.status(text),
+            registerExtension: (nested) => this.queue.push(nested),
+        };
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/extensions/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/extensions/host.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAe,MAAM,WAAW,CAAC;AAoBzD,MAAM,OAAO,aAAa;IACP,QAAQ,CAAe;IAExC,YAAY,QAAsB;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEgB,KAAK,GAAgC,EAAE,CAAC;IAEzD,KAAK,CAAC,IAAI,CAAC,UAAuC;QAChD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAE/B,qEAAqE;QACrE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA8B,CAAC;YACjE,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAEzC,MAAM,SAAS,CAAC,KAAK,CAAC,GAAwB,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS;QACb,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;YAC1D,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,SAAoC;QACvD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAC1B,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAE1D,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,eAAe,GACnB,SAAS,CAAC,YAAY,IAAI,IAAI;YAC5B,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,EAAE,cAAc,SAAS,CAAC,IAAI,EAAE,CAAC;YACrF,CAAC,CAAC,UAAU,CAAC;QAEjB,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,eAAe;YACf,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,GAAG;YACH,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,KAAK,EAAE,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC;YACrD,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAE7B,QAAQ,EAAE;gBACR,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE;gBAC7C,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC;gBAC1D,aAAa,EAAE,GAAG,EAAE,CAClB,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAC/E,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,kBAAkB,EAAE;gBACtD,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,wBAAwB,EAAE;gBAClE,aAAa,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,aAAa,EAAE;gBACzD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3D,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC3E,iBAAiB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC;aAC/E;YAED,QAAQ,EAAE;gBACR,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;gBACxE,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;aAC9D;YAED,KAAK,EAAE;gBACL,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;gBACzD,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC3E,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC3E,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;gBAC5B,IAAI,EAAE,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;aAC1C;YAED,OAAO,EAAE;gBACP,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC;aACtE;YAED,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CACxB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;YAEhF,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;YAEnD,iBAAiB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;SACvD,CAAC;IACJ,CAAC;CACF"}

package/dist/extensions/index.d.ts

@@ -0,0 +1,3 @@
+import type { TachikomaExtension } from "./api.ts";
+/** First-party extensions, in load order. */
+export declare const firstPartyExtensions: TachikomaExtension<never>[];

package/dist/extensions/index.js

@@ -0,0 +1,32 @@
+import boundary from "./boundary/index.js";
+import commands from "./commands/index.js";
+import context from "./context/index.js";
+import detachedProcesses from "./detached-processes/index.js";
+import external from "./external/index.js";
+import git from "./git/index.js";
+import memory from "./memory/index.js";
+import notifications from "./notifications/index.js";
+import projects from "./projects/index.js";
+import repl from "./repl/index.js";
+import skills from "./skills/index.js";
+import tasks from "./tasks/index.js";
+import telegram from "./telegram/index.js";
+import workflows from "./workflows/index.js";
+/** First-party extensions, in load order. */
+export const firstPartyExtensions = [
+    commands,
+    context,
+    memory,
+    projects,
+    git,
+    boundary,
+    skills,
+    workflows,
+    tasks,
+    detachedProcesses,
+    notifications,
+    repl,
+    telegram,
+    external,
+];
+//# sourceMappingURL=index.js.map

package/dist/extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,OAAO,MAAM,oBAAoB,CAAC;AACzC,OAAO,iBAAiB,MAAM,+BAA+B,CAAC;AAC9D,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,GAAG,MAAM,gBAAgB,CAAC;AACjC,OAAO,MAAM,MAAM,mBAAmB,CAAC;AACvC,OAAO,aAAa,MAAM,0BAA0B,CAAC;AACrD,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,IAAI,MAAM,iBAAiB,CAAC;AACnC,OAAO,MAAM,MAAM,mBAAmB,CAAC;AACvC,OAAO,KAAK,MAAM,kBAAkB,CAAC;AACrC,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAE7C,6CAA6C;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;IACR,GAAG;IACH,QAAQ;IACR,MAAM;IACN,SAAS;IACT,KAAK;IACL,iBAAiB;IACjB,aAAa;IACb,IAAI;IACJ,QAAQ;IACR,QAAQ;CACsB,CAAC"}

package/dist/extensions/memory/archive.d.ts

@@ -0,0 +1,8 @@
+import type { PostProcessor } from "../api.ts";
+/**
+ * Copies the pi session JSONL into the workspace so transcripts are
+ * git-versioned alongside the memories extracted from them. Named after the
+ * pi session id from the JSONL header, falling back to the source filename.
+ * Never throws — a failed archive must not block the rest of finalization.
+ */
+export declare const createTranscriptArchiveProcessor: (workspaceRoot: string) => PostProcessor;

package/dist/extensions/memory/archive.js

@@ -0,0 +1,46 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { transcriptsDir } from "./layout.js";
+const headerSessionId = (raw) => {
+    const newline = raw.indexOf("\n");
+    const firstLine = newline === -1 ? raw : raw.slice(0, newline);
+    try {
+        const header = JSON.parse(firstLine);
+        if (header.type === "session" && typeof header.id === "string" && header.id !== "") {
+            return header.id;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+};
+/**
+ * Copies the pi session JSONL into the workspace so transcripts are
+ * git-versioned alongside the memories extracted from them. Named after the
+ * pi session id from the JSONL header, falling back to the source filename.
+ * Never throws — a failed archive must not block the rest of finalization.
+ */
+export const createTranscriptArchiveProcessor = (workspaceRoot) => ({
+    name: "transcript-archive",
+    phase: "finalize",
+    async process({ transcriptPath, log }) {
+        if (transcriptPath == null) {
+            log.debug("no transcript — skipping archive");
+            return;
+        }
+        try {
+            const raw = await readFile(transcriptPath, "utf8");
+            const sessionId = headerSessionId(raw);
+            const name = sessionId != null ? `${sessionId}.jsonl` : basename(transcriptPath);
+            const dest = join(transcriptsDir(workspaceRoot), name);
+            await mkdir(transcriptsDir(workspaceRoot), { recursive: true });
+            await writeFile(dest, raw, "utf8");
+            log.info({ dest }, "archived transcript");
+        }
+        catch (error) {
+            log.warn({ err: error, src: transcriptPath }, "transcript archive failed");
+        }
+    },
+});
+//# sourceMappingURL=archive.js.map

package/dist/extensions/memory/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../../src/extensions/memory/archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,eAAe,GAAG,CAAC,GAAW,EAAiB,EAAE;IACrD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAoC,CAAC;QAExE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACnF,OAAO,MAAM,CAAC,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,aAAqB,EAAiB,EAAE,CAAC,CAAC;IACzF,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,UAAU;IAEjB,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE;QACnC,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;YAEvD,MAAM,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YAEnC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,qBAAqB,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,2BAA2B,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/memory/dates.d.ts

@@ -0,0 +1,2 @@
+/** Local-timezone YYYY-MM-DD — memory filenames follow the user's day, not UTC. */
+export declare const localIsoDate: (date?: Date) => string;

package/dist/extensions/memory/dates.js

@@ -0,0 +1,7 @@
+/** Local-timezone YYYY-MM-DD — memory filenames follow the user's day, not UTC. */
+export const localIsoDate = (date = new Date()) => {
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${date.getFullYear()}-${month}-${day}`;
+};
+//# sourceMappingURL=dates.js.map

package/dist/extensions/memory/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../../src/extensions/memory/dates.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAa,IAAI,IAAI,EAAE,EAAU,EAAE;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEpD,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;AACjD,CAAC,CAAC"}

package/dist/extensions/memory/extraction.d.ts

@@ -0,0 +1,17 @@
+import type { SideRunner } from "../../agent/side-run.ts";
+import type { PostProcessor } from "../api.ts";
+import { type MemoryStore } from "./layout.ts";
+export declare const MEMORY_FILE_TOOLS: string[];
+export type Runner = Pick<SideRunner, "run">;
+export interface ExtractionDeps {
+    side: Runner;
+    workspaceRoot: string;
+    maxTranscriptChars: number;
+}
+export declare const extractionSystemPrompt: (store: MemoryStore, workspaceRoot: string) => string;
+export declare const conversationPrompt: (conversation: string) => string;
+/**
+ * Session-close extraction: re-reads the session transcript and runs a headless
+ * agent with file tools to fold the conversation into one memory store.
+ */
+export declare const createExtractionProcessor: (store: MemoryStore, { side, workspaceRoot, maxTranscriptChars }: ExtractionDeps) => PostProcessor;