@falkenslab/agent-kit 0.17.0 → 0.19.0

package/dist/{core → extensions/sources}/sources.js

@@ -5,10 +5,11 @@ import path from "node:path";
 /**
  * The sources folder's bookkeeping: originals stay files (ADR-024), and the kit keeps a
  * manifest next to them (`.agent-kit/sources.json`, inside `sourcesDir`, where the agent's
- * file tools can't write) with each original's hash, size and provenance, the version it
- * replaces, and the hash it had when a summary page first pointed to it. From that it tells
- * new, ingested, changed and missing originals apart, refuses duplicates, and retires an
- * original into `.agent-kit/retired/` instead of deleting it.
+ * file tools can't write) with each original's hash, size, provenance, the version it replaces
+ * and when its content last changed. From that it refuses duplicates, tells present, missing
+ * and retired originals apart, and retires an original into `.agent-kit/retired/` instead of
+ * deleting it. It knows nothing of the knowledge base: each owns its data, and the model
+ * connects them through their tools (#30). Hashes never leave it.
  */
 export const KIT_DIR = ".agent-kit";
 const MANIFEST = "sources.json";
@@ -70,41 +71,20 @@ export async function scanSources(sourcesDir) {
     await walk(sourcesDir);
     return found.sort();
 }
-/** An entry for `file`, reusing the recorded hash when its size and modification time haven't changed. */
+/**
+ * An entry for `file`, reusing the recorded hash when its size and modification time haven't
+ * changed; `changedAt` moves only when the content (its hash) did. Entries from before
+ * `changedAt` existed take their `addedAt`.
+ */
 async function freshEntry(file, known, origin) {
     const info = await stat(file);
-    if (known && known.size === info.size && known.mtimeMs === info.mtimeMs)
-        return known;
-    return { ...(known ?? { addedAt: now(), origin }), hash: await hashFile(file), size: info.size, mtimeMs: info.mtimeMs };
-}
-/** The original a frontmatter `file:` value points to (a relative path or a markdown link), resolved from the page's folder. */
-function linkedFile(value, pageDir) {
-    const link = /\]\(([^)]+)\)/.exec(value)?.[1] ?? value.trim().replace(/^["']|["']$/g, "");
-    if (!link || /^[a-z]+:\/\//i.test(link))
-        return undefined;
-    return path.resolve(pageDir, decodeURI(link));
-}
-/** The summary pages (knowledge base layout: `summaries/*.md`) by the absolute path of the original their frontmatter `file:` points to. */
-export async function summariesByOriginal(knowledgeDir) {
-    const byOriginal = new Map();
-    const dir = path.join(knowledgeDir, "summaries");
-    let names;
-    try {
-        names = await readdir(dir);
-    }
-    catch {
-        return byOriginal;
-    }
-    for (const name of names.filter((n) => n.endsWith(".md"))) {
-        const page = path.join(dir, name);
-        const text = await readFile(page, "utf8");
-        const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text)?.[1] ?? "";
-        const value = /^file:\s*(.+)$/m.exec(frontmatter)?.[1];
-        const original = value ? linkedFile(value, dir) : undefined;
-        if (original)
-            byOriginal.set(path.normalize(original), [...(byOriginal.get(path.normalize(original)) ?? []), page]);
-    }
-    return byOriginal;
+    const previous = known ? { ...known, changedAt: known.changedAt ?? known.addedAt } : undefined;
+    if (previous && previous.size === info.size && previous.mtimeMs === info.mtimeMs)
+        return previous;
+    const hash = await hashFile(file);
+    const stamp = now();
+    const base = previous ?? { addedAt: stamp, origin, changedAt: stamp };
+    return { ...base, hash, size: info.size, mtimeMs: info.mtimeMs, changedAt: previous && previous.hash === hash ? previous.changedAt : stamp };
 }
 /** Pages of a PDF, read from its page tree without a parser; undefined when it can't tell (e.g. compressed object streams). */
 export function pdfPageCount(bytes) {
@@ -124,31 +104,19 @@ export function pptxSlideCount(bytes) {
 }
 const typeOf = (file) => path.extname(file).slice(1).toLowerCase() || "file";
 /**
- * Every original with its status, recording in the manifest the ones copied in by hand and,
- * the first time a summary page points to one, its hash at ingest. Without a knowledge
- * folder there's no ingest to compare with: originals are "present".
+ * Every original with its status and when its content last changed, recording in the manifest
+ * the ones copied in by hand; then the missing ones and the retired ones.
  */
-export function listSources(sourcesDir, knowledgeDir, projectDir) {
-    return serialized(sourcesDir, () => listSourcesNow(sourcesDir, knowledgeDir, projectDir));
+export function listSources(sourcesDir) {
+    return serialized(sourcesDir, () => listSourcesNow(sourcesDir));
 }
-async function listSourcesNow(sourcesDir, knowledgeDir, projectDir) {
+async function listSourcesNow(sourcesDir) {
     const manifest = await loadManifest(sourcesDir);
-    const summaries = knowledgeDir ? await summariesByOriginal(knowledgeDir) : new Map();
     const files = await scanSources(sourcesDir);
     const listing = [];
     for (const rel of files) {
         const full = path.join(sourcesDir, rel);
         const entry = await freshEntry(full, manifest.files[rel], { kind: "manual" });
-        const pagesOf = summaries.get(path.normalize(full)) ?? [];
-        let status = "present";
-        if (knowledgeDir) {
-            if (pagesOf.length === 0)
-                status = "new";
-            else {
-                entry.ingestedHash ??= entry.hash;
-                status = entry.ingestedHash === entry.hash ? "ingested" : "changed";
-            }
-        }
         manifest.files[rel] = entry;
         const type = typeOf(rel);
         const counts = type === "pdf" || type === "pptx"
@@ -156,18 +124,28 @@ async function listSourcesNow(sourcesDir, knowledgeDir, projectDir) {
             : {};
         listing.push({
             path: rel,
-            status,
+            status: "present",
             type,
+            changedAt: entry.changedAt,
             size: entry.size,
             ...counts,
             origin: entry.origin,
             ...(entry.replaces ? { replaces: entry.replaces } : {}),
-            summaries: pagesOf.map((page) => posix(path.relative(projectDir, page))),
         });
     }
     for (const [rel, entry] of Object.entries(manifest.files)) {
         if (!files.includes(rel))
-            listing.push({ path: rel, status: "missing", type: typeOf(rel), origin: entry.origin, summaries: [] });
+            listing.push({ path: rel, status: "missing", type: typeOf(rel), origin: entry.origin });
+    }
+    for (const retired of manifest.retired) {
+        listing.push({
+            path: retired.path,
+            status: "retired",
+            type: typeOf(retired.path),
+            retiredAt: retired.retiredAt,
+            why: retired.why,
+            ...(retired.replacedBy ? { replacedBy: retired.replacedBy } : {}),
+        });
     }
     await saveManifest(sourcesDir, manifest);
     return listing;
@@ -219,11 +197,13 @@ async function addSourceNow(sourcesDir, file, destination, origin, extra) {
     }
     const rel = posix(path.relative(sourcesDir, target));
     const info = await stat(target);
+    const stamp = now();
     manifest.files[rel] = {
         hash,
         size: info.size,
         mtimeMs: info.mtimeMs,
-        addedAt: now(),
+        addedAt: stamp,
+        changedAt: stamp,
         origin,
         ...(extra.replaces ? { replaces: posix(path.relative(sourcesDir, resolveWithin(sourcesDir, extra.replaces))) } : {}),
         ...(extra.derivedFrom ? { derivedFrom: extra.derivedFrom } : {}),
@@ -231,26 +211,15 @@ async function addSourceNow(sourcesDir, file, destination, origin, extra) {
     await saveManifest(sourcesDir, manifest);
     return { path: rel };
 }
-/** Adds frontmatter fields and a notice under the frontmatter of a markdown page. */
-async function markPage(page, fields, notice) {
-    const text = await readFile(page, "utf8");
-    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(text);
-    const lines = Object.entries(fields).map(([key, value]) => `${key}: ${value}`);
-    const updated = match
-        ? `---\n${match[1].split(/\r?\n/).filter((line) => !Object.keys(fields).some((key) => line.startsWith(`${key}:`))).concat(lines).join("\n")}\n---\n\n> ${notice}\n\n${text.slice(match[0].length).replace(/^\s+/, "")}`
-        : `---\n${lines.join("\n")}\n---\n\n> ${notice}\n\n${text}`;
-    await writeFile(page, updated);
-}
 /**
- * Moves an original to `.agent-kit/retired/` (never deleted: the person empties that folder)
- * and records why. Its summary pages are marked: retired if the original was wrong (what it
- * taught was wrong), superseded if it was replaced, pointing to the replacement's summary
- * when there is one.
+ * Moves an original to `.agent-kit/retired/` (never deleted: the person empties that folder) and
+ * records why. What was built from it (summary pages) is the knowledge base's to update: the
+ * model does it with its tools.
  */
-export function retireSource(sourcesDir, knowledgeDir, projectDir, source, why, reason, replacedBy) {
-    return serialized(sourcesDir, () => retireSourceNow(sourcesDir, knowledgeDir, projectDir, source, why, reason, replacedBy));
+export function retireSource(sourcesDir, source, why, reason, replacedBy) {
+    return serialized(sourcesDir, () => retireSourceNow(sourcesDir, source, why, reason, replacedBy));
 }
-async function retireSourceNow(sourcesDir, knowledgeDir, projectDir, source, why, reason, replacedBy) {
+async function retireSourceNow(sourcesDir, source, why, reason, replacedBy) {
     const full = resolveWithin(sourcesDir, source);
     if (!full || !(await stat(full).catch(() => null))?.isFile())
         throw new Error(`"${source}" isn't an original in sources/.`);
@@ -260,7 +229,6 @@ async function retireSourceNow(sourcesDir, knowledgeDir, projectDir, source, why
     const replacement = replacedBy ? resolveWithin(sourcesDir, replacedBy) : undefined;
     if (replacedBy && (!replacement || !(await stat(replacement).catch(() => null))))
         throw new Error(`"${replacedBy}" isn't an original in sources/.`);
-    const summaries = knowledgeDir ? await summariesByOriginal(knowledgeDir) : new Map();
     const manifest = await loadManifest(sourcesDir);
     const stamp = now();
     const movedTo = posix(path.join(KIT_DIR, RETIRED_DIR, `${stamp.replace(/[:.]/g, "-")}-${path.basename(rel)}`));
@@ -277,36 +245,5 @@ async function retireSourceNow(sourcesDir, knowledgeDir, projectDir, source, why
     });
     delete manifest.files[rel];
     await saveManifest(sourcesDir, manifest);
-    const date = stamp.slice(0, 10);
-    const replacementSummary = replacement ? summaries.get(path.normalize(replacement))?.[0] : undefined;
-    const result = { movedTo, summaries: [] };
-    for (const page of summaries.get(path.normalize(full)) ?? []) {
-        if (why === "wrong") {
-            await markPage(page, { status: "retired", retired: date }, `Retired on ${date}: its original was wrong (${reason}). Don't rely on what it says.`);
-            result.summaries.push({ page: posix(path.relative(projectDir, page)), marked: "retired" });
-        }
-        else {
-            const link = replacementSummary ? posix(path.relative(path.dirname(page), replacementSummary)) : undefined;
-            await markPage(page, { status: "superseded", superseded: date, ...(link ? { superseded_by: link } : {}) }, `Superseded on ${date}: its original was replaced (${reason})${link ? `; see [the new summary](${link})` : ""}.`);
-            result.summaries.push({ page: posix(path.relative(projectDir, page)), marked: "superseded", ...(replacementSummary ? { supersededBy: posix(path.relative(projectDir, replacementSummary)) } : {}) });
-        }
-    }
-    return result;
-}
-/**
- * Records `source` (relative to `sourcesDir`) as ingested now, with its current hash: a
- * summary page was just written from it, so "changed" means changed after this.
- */
-export function recordIngest(sourcesDir, source) {
-    return serialized(sourcesDir, async () => {
-        const full = resolveWithin(sourcesDir, source);
-        if (!full || !(await stat(full).catch(() => null))?.isFile())
-            return;
-        const rel = posix(path.relative(sourcesDir, full));
-        const manifest = await loadManifest(sourcesDir);
-        const entry = await freshEntry(full, manifest.files[rel], { kind: "manual" });
-        entry.ingestedHash = entry.hash;
-        manifest.files[rel] = entry;
-        await saveManifest(sourcesDir, manifest);
-    });
+    return { movedTo };
 }

package/dist/{core/tools/saveToSources.d.ts → extensions/sources/tools.d.ts}

@@ -8,10 +8,14 @@ export declare const MAX_SOURCE_BYTES: number;
 export declare function htmlToMarkdown(html: string, url: string): Promise<string | null>;
 /** Downloads `url` into `file`, refusing other schemes and anything over `maxBytes`; returns its content type. */
 export declare function downloadToFile(url: string, file: string, maxBytes: number): Promise<string>;
+/**
+ * The "Sources" section appended to the system prompt whenever there's a sources folder, with or
+ * without a knowledge base: what the originals are and how they come and go. `projectDir` and
+ * `sourcesDir` give the folder's name as the model reads it.
+ */
+export declare function sourcesPromptSection(projectDir: string, sourcesDir: string): string;
 /** Options of `createSaveToSourcesServer()`. */
 export interface SourceToolsOptions {
-    /** The knowledge folder, to tell which originals have a summary page (`list_sources`). */
-    knowledgeDir?: string;
     /** The project root: paths in the tools' answers are relative to it. Defaults to the parent of `sourcesDir`. */
     projectDir?: string;
     /** A person can be asked (not autonomous): adds `request_file` and `retire_source`, which ask first. */
@@ -24,6 +28,6 @@ export interface SourceToolsOptions {
  * are scoped to the notes folder, see hooks/fileScopeGate.ts): `save_to_sources`,
  * `list_sources` and `download_to_sources`, plus `request_file` and `retire_source` when a
  * person can be asked. Nothing is ever overwritten or deleted; the bookkeeping is in
- * sources.ts.
+ * sources.ts (this extension's).
  */
 export declare function createSaveToSourcesServer(runDir: string, sourcesDir: string, description?: string, options?: SourceToolsOptions): import("@anthropic-ai/claude-agent-sdk").McpSdkServerConfigWithInstance;

package/dist/{core/tools/saveToSources.js → extensions/sources/tools.js}

@@ -2,10 +2,10 @@ import path from "node:path";
 import { mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
 import { z } from "zod";
-import { addSource, listSources, resolveWithin, retireSource } from "../sources.js";
-import { askForDecision, askForText } from "../hooks/humanInput.js";
-import { t } from "../messages/index.js";
-import { EXTRACTABLE, extractText } from "../extractText.js";
+import { addSource, listSources, resolveWithin, retireSource } from "./sources.js";
+import { askForDecision, askForText } from "../../core/hooks/humanInput.js";
+import { t } from "../../core/messages/index.js";
+import { EXTRACTABLE, extractText } from "./extractText.js";
 /**
  * `resolvedPath` as given if it exists; otherwise, a same-directory sibling whose
  * filename is Unicode-equal under NFC normalization. Needed because a file downloaded via
@@ -104,12 +104,22 @@ export async function downloadToFile(url, file, maxBytes) {
     await writeFile(file, Buffer.concat(chunks));
     return response.headers.get("content-type") ?? "";
 }
+/**
+ * The "Sources" section appended to the system prompt whenever there's a sources folder, with or
+ * without a knowledge base: what the originals are and how they come and go. `projectDir` and
+ * `sourcesDir` give the folder's name as the model reads it.
+ */
+export function sourcesPromptSection(projectDir, sourcesDir) {
+    const folder = `${path.relative(projectDir, sourcesDir).split(path.sep).join("/") || "."}/`;
+    return `## Sources
+- **Originals (read-only for you)**: \`${folder}\`. Never rewrite one; build on them. \`list_sources\` lists them with when each one's content last changed (\`changedAt\`), and the missing and retired ones; add a file only with \`save_to_sources\`, \`download_to_sources\` or by asking the person (\`request_file\`), and take out a wrong or superseded one only with \`retire_source\`. \`Read\` reads PDFs and images; \`extract_text\` reads DOCX, PPTX (with speaker notes) and XLSX.`;
+}
 /**
  * The tools that keep `sourcesDir`, the originals the agent reads but never edits (Write/Edit
  * are scoped to the notes folder, see hooks/fileScopeGate.ts): `save_to_sources`,
  * `list_sources` and `download_to_sources`, plus `request_file` and `retire_source` when a
  * person can be asked. Nothing is ever overwritten or deleted; the bookkeeping is in
- * sources.ts.
+ * sources.ts (this extension's).
  */
 export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFAULT_DESCRIPTION, options = {}) {
     const projectDir = options.projectDir ?? path.dirname(sourcesDir);
@@ -149,9 +159,9 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
             return fail(message(error));
         }
     });
-    const listSourcesTool = tool("list_sources", "List the originals in sources/ with their status: new (no summary page points to it: ingest it), ingested, changed (it changed after its ingest: update its summary), missing (deleted by hand) or present (no knowledge base to compare with); with type, size, pages of a PDF or slides of a PPTX (read long ones in parts), provenance, the version it replaces and its summary pages. Use it instead of listing the folder.", {}, async () => {
+    const listSourcesTool = tool("list_sources", "List the originals in sources/: present, missing (deleted by hand) or retired (when, why, what replaced it); with changedAt (when its content last changed, ISO 8601 in UTC: a later date sorts after as text, to compare with when something was built from it), type, size, pages of a PDF or slides of a PPTX (read long ones in parts), provenance and the version it replaces. Use it instead of listing the folder.", {}, async () => {
         try {
-            return ok(JSON.stringify(await listSources(sourcesDir, options.knowledgeDir, projectDir), null, 2));
+            return ok(JSON.stringify(await listSources(sourcesDir), null, 2));
         }
         catch (error) {
             return fail(message(error));
@@ -215,7 +225,7 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
         }
     });
     const requestFile = tool("request_file", "Ask the person for a file you need (a syllabus, a document they have) and copy it into sources/ with its provenance. They give a path or say they don't have it; never overwrites, and doesn't copy a file identical to one already there.", {
-        description: z.string().describe("What file you need and why, in one or two sentences, in the person's language"),
+        description: z.string().describe("What file you need and why, in one or two sentences, in the language you reply in"),
         destination: z.string().optional().describe("Path to save it under, relative to sources/; the file's own name if omitted"),
         replaces,
     }, async (args) => {
@@ -235,23 +245,18 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
             return fail(message(error));
         }
     });
-    const retire = tool("retire_source", 'Retire an original that was wrong ("wrong") or replaced by a better one ("replaced"), after the person approves it: it\'s moved to sources/.agent-kit/retired/ (never deleted), and its summary page is marked retired (wrong) or superseded, pointing to the replacement\'s summary (replaced). Afterwards, update the index and correct or re-ground the pages that cited it.', {
+    const retire = tool("retire_source", 'Retire an original that was wrong ("wrong") or replaced by a better one ("replaced"). It asks the person itself, with a panel: don\'t ask them first. Approved, it\'s moved to sources/.agent-kit/retired/ (never deleted), and list_sources shows it as retired. What you built from it is yours to review afterwards.', {
         source: z.string().describe("The original, relative to sources/"),
         why: z.enum(["wrong", "replaced"]),
-        reason: z.string().describe("Why, in one sentence, in the person's language"),
+        reason: z.string().describe("Why, in one sentence, in the language you reply in"),
         replacedBy: z.string().optional().describe('For "replaced": the original that replaces it, relative to sources/'),
     }, async (args) => {
         const answer = await askForDecision(runDir, { title: t().retireTitle, lines: t().retireLines(inFolder(args.source), args.why, args.reason, args.replacedBy && inFolder(args.replacedBy), folder) });
         if (answer !== "" && answer !== "y" && answer !== "yes")
             return ok(answer === "q" ? "The person stopped: don't retire it, and stop what you were doing." : "The person said no: the original stays.");
         try {
-            const result = await retireSource(sourcesDir, options.knowledgeDir, projectDir, inFolder(args.source), args.why, args.reason, args.replacedBy && inFolder(args.replacedBy));
-            const pages = result.summaries.map((s) => `${s.page} marked ${s.marked}${s.supersededBy ? ` (see ${s.supersededBy})` : ""}`);
-            return ok([
-                `Retired: moved to sources/${result.movedTo}.`,
-                ...(pages.length ? pages : ["It had no summary page."]),
-                "Now update index.md, and correct or re-ground the pages that cite it (search the knowledge base for its file name).",
-            ].join("\n"));
+            const result = await retireSource(sourcesDir, inFolder(args.source), args.why, args.reason, args.replacedBy && inFolder(args.replacedBy));
+            return ok(`Retired: moved to sources/${result.movedTo}. If anything was built from it (a summary, notes that cite it), review it now: ${args.why === "wrong" ? "what it taught was wrong" : `it was replaced${args.replacedBy ? ` by sources/${inFolder(args.replacedBy)}` : ""}`}.`);
         }
         catch (error) {
             return fail(message(error));

package/dist/index.d.ts

@@ -5,17 +5,21 @@ export { allowAnyMcpTool } from "./core/mcpPermissions.js";
 export { createPromptLoader } from "./core/promptTemplate.js";
 export { resolveClaudeAuth, type ClaudeAuthConfig } from "./core/claudeAuth.js";
 export { ensureClaudeAuth } from "./tui/claudeAuth.js";
-export { createFriendlyToolLabel, truncate, truncatePath, type ToolDescriber, } from "./core/toolLabels.js";
+export { createFriendlyToolLabel, truncate, truncatePath, withToolLabels, withToolPhrases, type ToolDescriber, type ToolLabel, type ToolLabels, } from "./core/toolLabels.js";
 export type { Mode, BaseSessionConfig, AgentSpec, AgentIdentity, PlanModeSpec } from "./core/agentSpec.js";
-export { buildSessionOptions, createInputQueue, createDeferred, createModeControl, togglePlanMode, type ModeControl } from "./core/session.js";
+export { buildSessionOptions, createInputQueue, createDeferred, createModeControl, togglePlanMode, type ModeControl, type ExtensionsStatus } from "./core/session.js";
 export { runQuery, type AgentEvent, type AgentRun, type SessionUsage, type ContextUsage } from "./core/runner.js";
-export { knowledgePluginRoot, knowledgePromptSection } from "./core/knowledge.js";
+export type { SessionFacts } from "./core/sessionFacts.js";
+export { knowledgePluginRoot, knowledgePromptSection } from "./extensions/knowledge/prompt.js";
+export { readExtensionManifest, type Extension, type ExtensionContext, type ExtensionContribution, type ExtensionManifest, } from "./core/extensions.js";
+export { addExtension, removeExtension, setExtensionEnabled, listInstalled, readExternalManifest, type ExtensionAuthor, type ExtensionDirs, type ExtensionScope, type ExternalManifest, type ExternalToolLabel, type PluginServer, type InstalledExtension, type LockEntry, } from "./core/externalExtensions.js";
+export { runExtensionCommand } from "./tui/extensionCommand.js";
 export { agentKitVersion } from "./core/version.js";
-export { BUILT_IN_PAGE_TYPES, isSlug, parseId, linkedIds, type KnowledgeStore, type PageType, type KnowledgePage, type PageInfo, type SearchHit, type CheckReport, type FieldChanges, type NewPage, } from "./core/knowledgeStore.js";
-export { createFileKnowledgeStore, type FileKnowledgeStoreOptions } from "./core/fileKnowledgeStore.js";
-export { createKnowledgeServer, type KnowledgeToolsOptions } from "./core/tools/knowledgeTools.js";
+export { BUILT_IN_PAGE_TYPES, isSlug, parseId, linkedIds, type KnowledgeStore, type PageType, type KnowledgePage, type PageInfo, type SearchHit, type CheckReport, type FieldChanges, type NewPage, } from "./extensions/knowledge/knowledgeStore.js";
+export { createFileKnowledgeStore, type FileKnowledgeStoreOptions } from "./extensions/knowledge/fileKnowledgeStore.js";
+export { createKnowledgeServer, type KnowledgeToolsOptions } from "./extensions/knowledge/tools.js";
 export { resolveLanguage, detectLanguage, SUPPORTED_LANGUAGES, type Language, type LanguageSources, type ResolvedLanguage, } from "./core/language.js";
-export { setLanguage, getLanguage, messagesFor, type Messages } from "./core/messages/index.js";
+export { setLanguage, switchLanguage, getLanguage, messagesFor, type Messages } from "./core/messages/index.js";
 export { createRunStore, createRunFolder, listRuns, readConversation, type RunFolder, type RunSummary, type ConversationMessage, } from "./core/runs.js";
 export type { Options, McpServerConfig, AgentDefinition } from "@anthropic-ai/claude-agent-sdk";
 export { tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
@@ -31,9 +35,10 @@ export { setInteractionPort, getInteractionPort, type InteractionPort, type Appr
 export { terminalInteractionPort, setSharedReadline, getSharedReadline } from "./tui/terminalInteraction.js";
 export { createHumanApprovalServer, DEFAULT_HUMAN_APPROVAL_TEXTS, type HumanApprovalTexts } from "./core/tools/humanApproval.js";
 export { createManualLoginServer, type ManualInterventionTexts } from "./core/tools/manualLogin.js";
-export { createSaveToSourcesServer, type SourceToolsOptions } from "./core/tools/saveToSources.js";
+export { createSaveToSourcesServer, sourcesPromptSection, type SourceToolsOptions } from "./extensions/sources/tools.js";
 export { runChatTui, type ChatTuiOptions } from "./tui/chatTui.js";
-export type { SessionOpener } from "./tui/runs.js";
+export type { SessionOpener } from "./chat/runs.js";
+export { createChatController, type ChatController, type ChatSettings, type ChatState, type ChatEvent, type ChatPanel, type ChatQuestion, type TranscriptEntry, type TranscriptCall, type NoticeTone, } from "./chat/chatController.js";
 export { createConsoleRenderer, type ConsoleRenderer, type ConsoleRendererOptions } from "./tui/consoleRenderer.js";
 export { runChatInk, type InkChatOptions, type HeaderInfo } from "./tui/ink/runChatInk.js";
 export type { ToolPhrase, ToolDetail, ResultFormatter } from "./tui/ink/toolGroup.js";

package/dist/index.js

@@ -7,16 +7,19 @@ export { allowAnyMcpTool } from "./core/mcpPermissions.js";
 export { createPromptLoader } from "./core/promptTemplate.js";
 export { resolveClaudeAuth } from "./core/claudeAuth.js";
 export { ensureClaudeAuth } from "./tui/claudeAuth.js";
-export { createFriendlyToolLabel, truncate, truncatePath, } from "./core/toolLabels.js";
+export { createFriendlyToolLabel, truncate, truncatePath, withToolLabels, withToolPhrases, } from "./core/toolLabels.js";
 export { buildSessionOptions, createInputQueue, createDeferred, createModeControl, togglePlanMode } from "./core/session.js";
 export { runQuery } from "./core/runner.js";
-export { knowledgePluginRoot, knowledgePromptSection } from "./core/knowledge.js";
+export { knowledgePluginRoot, knowledgePromptSection } from "./extensions/knowledge/prompt.js";
+export { readExtensionManifest, } from "./core/extensions.js";
+export { addExtension, removeExtension, setExtensionEnabled, listInstalled, readExternalManifest, } from "./core/externalExtensions.js";
+export { runExtensionCommand } from "./tui/extensionCommand.js";
 export { agentKitVersion } from "./core/version.js";
-export { BUILT_IN_PAGE_TYPES, isSlug, parseId, linkedIds, } from "./core/knowledgeStore.js";
-export { createFileKnowledgeStore } from "./core/fileKnowledgeStore.js";
-export { createKnowledgeServer } from "./core/tools/knowledgeTools.js";
+export { BUILT_IN_PAGE_TYPES, isSlug, parseId, linkedIds, } from "./extensions/knowledge/knowledgeStore.js";
+export { createFileKnowledgeStore } from "./extensions/knowledge/fileKnowledgeStore.js";
+export { createKnowledgeServer } from "./extensions/knowledge/tools.js";
 export { resolveLanguage, detectLanguage, SUPPORTED_LANGUAGES, } from "./core/language.js";
-export { setLanguage, getLanguage, messagesFor } from "./core/messages/index.js";
+export { setLanguage, switchLanguage, getLanguage, messagesFor } from "./core/messages/index.js";
 export { createRunStore, createRunFolder, listRuns, readConversation, } from "./core/runs.js";
 // And the two functions an agent needs for tools of its own (an in-process MCP server,
 // returned from AgentSpec.buildMcpServers()), so it doesn't need the SDK for those either.
@@ -36,8 +39,9 @@ export { terminalInteractionPort, setSharedReadline, getSharedReadline } from ".
 setInteractionPort(terminalInteractionPort);
 export { createHumanApprovalServer, DEFAULT_HUMAN_APPROVAL_TEXTS } from "./core/tools/humanApproval.js";
 export { createManualLoginServer } from "./core/tools/manualLogin.js";
-export { createSaveToSourcesServer } from "./core/tools/saveToSources.js";
+export { createSaveToSourcesServer, sourcesPromptSection } from "./extensions/sources/tools.js";
 export { runChatTui } from "./tui/chatTui.js";
+export { createChatController, } from "./chat/chatController.js";
 export { createConsoleRenderer } from "./tui/consoleRenderer.js";
 export { runChatInk } from "./tui/ink/runChatInk.js";
 export { createProgressView } from "./tui/ink/progressView.js";

package/dist/tui/chatTui.d.ts

@@ -1,8 +1,10 @@
 import type { Options } from "@anthropic-ai/claude-agent-sdk";
-import { type ModeControl } from "../core/session.js";
-import { type AgentEvent } from "../core/runner.js";
+import type { ModeControl } from "../core/session.js";
+import type { AgentEvent } from "../core/runner.js";
 import { type Theme } from "./theme.js";
-import { type SessionOpener } from "./runs.js";
+import type { ToolLabels } from "../core/toolLabels.js";
+import { type SessionOpener } from "../chat/runs.js";
+export { capHistory, loadHistory, saveHistory, slashCommandToken } from "../chat/history.js";
 /** Options of the chats (`runChatTui()`, and `runChatInk()` through `InkChatOptions`). */
 export interface ChatTuiOptions {
     /**
@@ -80,6 +82,12 @@ export interface ChatTuiOptions {
      * returns is used instead.
      */
     modeControl?: ModeControl;
+    /**
+     * How the chat shows the extensions' tools (`buildSessionOptions()` returns them as
+     * `toolLabels`), before `formatAction`. With a session opener, the ones it returns are used
+     * instead.
+     */
+    toolLabels?: ToolLabels;
     /**
      * Colors for the kit's roles (see `Theme`), on top of the kit's defaults: only the roles
      * given change, e.g. `{ toolResult: "yellow", selection: "#00ff00" }`. One theme per
@@ -87,22 +95,6 @@ export interface ChatTuiOptions {
      */
     theme?: Partial<Theme>;
 }
-interface HistoryEntry {
-    text: string;
-    timestamp: string;
-}
-/** Keeps only the most recent `limit` entries (oldest-first order in, oldest-first out). */
-export declare function capHistory(entries: readonly HistoryEntry[], limit: number): HistoryEntry[];
-/** Oldest-first. Missing file reads as empty — nothing to load yet is the normal case. */
-export declare function loadHistory(filePath: string): Promise<HistoryEntry[]>;
-/** Overwrites the whole file (not appended) so a prior prune (oldest entries dropped) sticks. */
-export declare function saveHistory(filePath: string, entries: readonly HistoryEntry[]): Promise<void>;
-/**
- * The command name a typed line would invoke (e.g. "chiste" for both "/chiste" and
- * "/chiste con salsa"), or `null` for a line that isn't a slash command at all (doesn't
- * start with "/") or is just a bare "/" with nothing after it.
- */
-export declare function slashCommandToken(line: string): string | null;
 /**
  * Reads `events` one turn at a time — up to and including a `turn-end` — via manual
  * `.next()` calls, calling `onEvent` for each. Deliberately never uses
@@ -139,4 +131,3 @@ export declare function drainTurn(events: AsyncIterator<AgentEvent>, onEvent: (e
  * interface itself before returning.
  */
 export declare function runChatTui(options: Options | SessionOpener, tuiOptions?: ChatTuiOptions): Promise<void>;
-export {};