@falkenslab/agent-kit 0.16.0 → 0.16.1

package/README.md

@@ -34,7 +34,9 @@ A foundation for building AI agents on top of the [Claude Agent SDK](https://www
 
 [Captain Whiskers](./examples/captain-whiskers) is a toy agent to see the kit in action: a retired pirate cat who tells jokes in the terminal, in your language. It starts full screen with its logo and has a small crew of subagents: one looks for new jokes on the web, another rates them before they're told, and a third tells the time with a tool of the captain's own. It lets you try the different levels of oversight and is the best starting point for an agent of your own. Its README explains how to run it.
 
-![Captain Whiskers in Windows Terminal: its logo at the top, the conversation in the middle and the framed prompt at the bottom, with a suggestion for the next message](docs/assets/captain-whiskers.png)
+![Captain Whiskers in Windows Terminal: his logo with the mode and the agent-kit version at the top, his crew at work in the middle, a task list under the spinner, and the framed prompt and status bar at the bottom](docs/assets/captain-whiskers.png)
+
+See [everything he can do](https://falkenslab.github.io/agent-kit/docs/next/examples/captain-whiskers#what-he-can-do), with screenshots.
 
 ### teacher-agent
 

package/assets/knowledge-plugin/skills/knowledge-ingest/SKILL.md

@@ -13,7 +13,7 @@ A source is ingested once, and from then on the knowledge base holds what it tau
 
 ## 2. Read it for real
 
-Read the whole source, not its first page (a long PDF in parts: `list_sources` gives its pages). Its path is `sources/<path>` in the project folder, not in this skill's folder. `Read` reads PDFs and images; `extract_text` reads DOCX, PPTX (with its speaker notes) and XLSX. If it exists only outside the sources folder, keep the original first: `download_to_sources` for a URL (a web page is kept as markdown too: read that one), `save_to_sources` for a file in the run's folder, `request_file` to ask the person for one.
+Read the whole source, not its first page (a long PDF in parts: `list_sources` gives its pages). Its path is the sources folder's (named in the system prompt) plus the path `list_sources` gives, from the project folder, not from this skill's folder. `Read` reads PDFs and images; `extract_text` reads DOCX, PPTX (with its speaker notes) and XLSX. If it exists only outside the sources folder, keep the original first: `download_to_sources` for a URL (a web page is kept as markdown too: read that one), `save_to_sources` for a file in the run's folder, `request_file` to ask the person for one.
 
 ## 3. Write the summary page
 

package/dist/core/fileKnowledgeStore.js

@@ -163,7 +163,12 @@ export function createFileKnowledgeStore(knowledgeDir, options = {}) {
     async function storedField(key, value, file) {
         if (key !== "file" || !options.sourcesDir || /^[a-z]+:\/\//i.test(value))
             return value;
-        const original = path.resolve(options.sourcesDir, value.replace(/^sources\//, ""));
+        // Relative to the sources folder; a leading "sources/" or the folder's own name is dropped.
+        let relative = value.replace(/\\/g, "/").replace(/^\.\//, "");
+        for (const prefix of ["sources/", `${path.basename(options.sourcesDir)}/`])
+            if (relative.startsWith(prefix))
+                relative = relative.slice(prefix.length);
+        const original = path.resolve(options.sourcesDir, relative);
         if (!(await stat(original).catch(() => null))?.isFile())
             throw new Error(`"${value}" isn't an original in sources/ (list_sources lists them).`);
         return posix(path.relative(path.dirname(file), original));
@@ -321,6 +326,12 @@ export function createFileKnowledgeStore(knowledgeDir, options = {}) {
                 .map(({ id, title, snippet }) => ({ id, title, snippet }));
         },
         index: indexText,
+        async recentLog(limit = 10) {
+            const text = await readFile(path.join(knowledgeDir, "log.md"), "utf8").catch(() => "");
+            // Entries start with "## [date] operation | what"; the newest are at the bottom.
+            const entries = text.split(/\r?\n(?=## )/).filter((entry) => entry.startsWith("## ")).map((entry) => entry.trim());
+            return entries.slice(-limit).reverse();
+        },
         async log(operation, what, pages = []) {
             await mkdir(knowledgeDir, { recursive: true });
             const file = path.join(knowledgeDir, "log.md");
@@ -331,6 +342,7 @@ export function createFileKnowledgeStore(knowledgeDir, options = {}) {
         async check() {
             await writeIndex(); // the one mechanical fix there is: an index.md out of date
             const { pages, byFile } = await pagesByFile();
+            const reservedFiles = new Set([...RESERVED].map((name) => path.normalize(path.join(knowledgeDir, `${name}.md`))));
             const known = new Map(pages.map((p) => [p.id, p]));
             const inbound = new Map();
             const report = { brokenLinks: [], orphans: [], linksToRetired: [], missingOriginals: [] };
@@ -338,11 +350,16 @@ export function createFileKnowledgeStore(knowledgeDir, options = {}) {
                 if (statusOf(page) === "retired")
                     continue;
                 const body = fromFile(page.body, page.file, byFile);
-                // Relative links to .md files that resolve to nothing are broken too.
+                // Relative links to .md files that resolve to nothing are broken too. The overview, the
+                // index and the log aren't pages but are files: a link to one that exists is fine (a
+                // knowledge base written with the file tools links the overview, #22).
                 for (const m of page.body.matchAll(/\]\(([^)\s:]+\.md)(?:#[^)]*)?\)/g)) {
                     const target = path.normalize(path.resolve(path.dirname(page.file), decodeURI(m[1])));
-                    if (!byFile.has(target) && target.startsWith(path.normalize(knowledgeDir)))
-                        report.brokenLinks.push({ page: page.id, target: posix(path.relative(knowledgeDir, target)) });
+                    if (byFile.has(target) || !target.startsWith(path.normalize(knowledgeDir)))
+                        continue;
+                    if (reservedFiles.has(target) && (await stat(target).catch(() => null)))
+                        continue;
+                    report.brokenLinks.push({ page: page.id, target: posix(path.relative(knowledgeDir, target)) });
                 }
                 for (const id of new Set(linkedIds(body))) {
                     const target = known.get(id);

package/dist/core/knowledge.js

@@ -30,7 +30,7 @@ function toolsSection(originals, pageTypes) {
 Your memory across sessions is an interlinked knowledge base of pages that you write and maintain yourself — a wiki, not a pile of notes. A future session only knows what is written there, so anything worth remembering must end up in a page, not just in this turn's reply. You reach it only through the \`knowledge_*\` tools. Write page content in the language you are using with the human.
 
 ### Layers
-${originals ? originalsLine(originals) : ""}- **The knowledge base**: pages identified by type and slug (\`concept/spring-tides\`), plus the \`overview\`, a living synthesis of the whole. Page types: ${pageTypes.map((type) => `\`${type.type}\` (${type.description})`).join("; ")}.
+${originals ? originalsLine(originals) : ""}- **The knowledge base**: pages identified by type and slug (\`concept/spring-tides\`), plus the \`overview\`, a living synthesis of the whole, and the \`log\` of what was done to it (\`knowledge_read\` reads both). Page types: ${pageTypes.map((type) => `\`${type.type}\` (${type.description})`).join("; ")}.
 - **The schema**: these rules plus the \`knowledge-ingest\`, \`knowledge-query\` and \`knowledge-lint\` skills. \`knowledge_create\` without content gives a type's template.
 
 ### Working rules

package/dist/core/knowledgeStore.d.ts

@@ -114,6 +114,11 @@ export interface KnowledgeStore {
     index(): Promise<string>;
     /** Adds an entry to the operation log, dated today. */
     log(operation: string, what: string, pages?: readonly string[]): Promise<void>;
+    /**
+     * The latest entries of the operation log, newest first, as markdown (e.g. "## [2026-10-04]
+     * ingest | …"). Optional: a store without it can't show the log to the agent.
+     */
+    recentLog?(limit?: number): Promise<string[]>;
     /** The mechanical problems. */
     check(): Promise<CheckReport>;
     /** The overview: a living synthesis of the whole knowledge base ("" if none yet). */

package/dist/core/messages/de.js

@@ -70,12 +70,12 @@ export const de = {
     keepPlanning: "Weiter planen",
     cancelPlan: "Abbrechen",
     planCommentQuestion: "Was soll sich ändern? (Enter zum Überspringen): ",
-    retireLines: (source, why, reason, replacedBy) => [
+    retireLines: (source, why, reason, replacedBy, folder) => [
         `Quelle: ${source}`,
         why === "wrong" ? "Warum: sie ist falsch; ihre Zusammenfassung wird zurückgezogen" : "Warum: sie wird ersetzt; ihre Zusammenfassung wird als ersetzt markiert",
         `Grund: ${reason}`,
         ...(replacedBy ? [`Ersetzt durch: ${replacedBy}`] : []),
-        "Sie wird nach sources/.agent-kit/retired/ verschoben, nicht gelöscht.",
+        `Sie wird nach ${folder}.agent-kit/retired/ verschoben, nicht gelöscht.`,
     ],
     toolPhrases: {
         Read: ["hat {n} Datei gelesen", "hat {n} Dateien gelesen"],
@@ -120,7 +120,7 @@ export const de = {
     labels: {
         askingApproval: (summary) => `Bittet um menschliche Genehmigung: ${summary}`,
         waitingManual: "Wartet auf einen manuellen Eingriff",
-        savingToSources: (destination) => `Speichert eine Datei in sources/${destination}`,
+        savingToSources: (destination) => `Speichert ${destination} in den Quellen`,
         checkingTime: "Datum und Uhrzeit abfragen",
         calculatingDates: "Daten berechnen",
         reading: (file) => `Liest ${file}`,

package/dist/core/messages/en.d.ts

@@ -67,7 +67,7 @@ export interface Messages {
     keepPlanning: string;
     cancelPlan: string;
     planCommentQuestion: string;
-    retireLines(source: string, why: "wrong" | "replaced", reason: string, replacedBy?: string): string[];
+    retireLines(source: string, why: "wrong" | "replaced", reason: string, replacedBy: string | undefined, folder: string): string[];
     toolPhrases: Record<string, ToolPhrase>;
     otherTools: ToolPhrase;
     noOutput: string;

package/dist/core/messages/en.js

@@ -69,12 +69,12 @@ export const en = {
     keepPlanning: "Keep planning",
     cancelPlan: "Cancel",
     planCommentQuestion: "What should change? (Enter to skip): ",
-    retireLines: (source, why, reason, replacedBy) => [
+    retireLines: (source, why, reason, replacedBy, folder) => [
         `Source: ${source}`,
         why === "wrong" ? "Why: it's wrong; its summary will be retired" : "Why: it's replaced; its summary will be marked superseded",
         `Reason: ${reason}`,
         ...(replacedBy ? [`Replaced by: ${replacedBy}`] : []),
-        "It's moved to sources/.agent-kit/retired/, not deleted.",
+        `It's moved to ${folder}.agent-kit/retired/, not deleted.`,
     ],
     toolPhrases: {
         Read: ["read {n} file", "read {n} files"],
@@ -119,7 +119,7 @@ export const en = {
     labels: {
         askingApproval: (summary) => `Asking for human approval: ${summary}`,
         waitingManual: "Waiting for a human to intervene manually",
-        savingToSources: (destination) => `Saving a file to sources/${destination}`,
+        savingToSources: (destination) => `Saving ${destination} to the sources`,
         checkingTime: "Checking the date and time",
         calculatingDates: "Calculating dates",
         reading: (file) => `Reading ${file}`,

package/dist/core/messages/es.js

@@ -70,12 +70,12 @@ export const es = {
     keepPlanning: "Seguir planificando",
     cancelPlan: "Cancelar",
     planCommentQuestion: "¿Qué debería cambiar? (Enter para omitir): ",
-    retireLines: (source, why, reason, replacedBy) => [
+    retireLines: (source, why, reason, replacedBy, folder) => [
         `Fuente: ${source}`,
         why === "wrong" ? "Motivo: es errónea; su resumen se retirará" : "Motivo: se sustituye; su resumen se marcará como sustituido",
         `Razón: ${reason}`,
         ...(replacedBy ? [`Sustituida por: ${replacedBy}`] : []),
-        "Se mueve a sources/.agent-kit/retired/, no se borra.",
+        `Se mueve a ${folder}.agent-kit/retired/, no se borra.`,
     ],
     toolPhrases: {
         Read: ["leyó {n} fichero", "leyó {n} ficheros"],
@@ -120,7 +120,7 @@ export const es = {
     labels: {
         askingApproval: (summary) => `Pidiendo aprobación humana: ${summary}`,
         waitingManual: "Esperando a que una persona intervenga a mano",
-        savingToSources: (destination) => `Guardando un fichero en sources/${destination}`,
+        savingToSources: (destination) => `Guardando ${destination} en las fuentes`,
         checkingTime: "Consultando la fecha y la hora",
         calculatingDates: "Calculando fechas",
         reading: (file) => `Leyendo ${file}`,

package/dist/core/messages/fr.js

@@ -70,12 +70,12 @@ export const fr = {
     keepPlanning: "Continuer à planifier",
     cancelPlan: "Annuler",
     planCommentQuestion: "Que faut-il changer ? (Entrée pour passer) : ",
-    retireLines: (source, why, reason, replacedBy) => [
+    retireLines: (source, why, reason, replacedBy, folder) => [
         `Source : ${source}`,
         why === "wrong" ? "Motif : elle est erronée ; son résumé sera retiré" : "Motif : elle est remplacée ; son résumé sera marqué comme remplacé",
         `Raison : ${reason}`,
         ...(replacedBy ? [`Remplacée par : ${replacedBy}`] : []),
-        "Elle est déplacée dans sources/.agent-kit/retired/, pas supprimée.",
+        `Elle est déplacée dans ${folder}.agent-kit/retired/, pas supprimée.`,
     ],
     toolPhrases: {
         Read: ["a lu {n} fichier", "a lu {n} fichiers"],
@@ -120,7 +120,7 @@ export const fr = {
     labels: {
         askingApproval: (summary) => `Demande d'approbation humaine : ${summary}`,
         waitingManual: "En attente d'une intervention manuelle",
-        savingToSources: (destination) => `Enregistrement d'un fichier dans sources/${destination}`,
+        savingToSources: (destination) => `Enregistrement de ${destination} dans les sources`,
         checkingTime: "Consultation de la date et de l'heure",
         calculatingDates: "Calcul de dates",
         reading: (file) => `Lecture de ${file}`,

package/dist/core/session.js

@@ -148,6 +148,11 @@ export async function buildSessionOptions(config, runDir, spec, options = {}) {
         // name isn't known ahead of time.
         canUseTool: allowAnyMcpTool,
         disallowedTools: spec.disallowedTools ?? [],
+        // TodoWrite (todos.ts) only exists with CLAUDE_CODE_ENABLE_TASKS=0: by default the CLI
+        // offers its TaskCreate/TaskUpdate/TaskList/TaskGet tools instead, and drops TodoWrite from
+        // the session even when `tools` names it (confirmed empirically). `env` replaces the
+        // subprocess environment, so the rest is passed on as it is.
+        env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" },
         // Real text streaming instead of silently waiting for the turn's complete message —
         // see the caller's message loop.
         includePartialMessages: true,

package/dist/core/tools/knowledgeTools.js

@@ -22,6 +22,7 @@ async function attempt(work) {
     }
 }
 const OVERVIEW = "overview";
+const LOG = "log";
 /** The `knowledge` MCP server over `store`. */
 export function createKnowledgeServer(store, options) {
     const typeNames = store.types().map((t) => t.type);
@@ -49,9 +50,15 @@ export function createKnowledgeServer(store, options) {
         const hits = await store.search(args.query, args.limit ?? 10);
         return hits.length ? hits.map((hit) => `- ${hit.id} — ${hit.title}: ${hit.snippet}`).join("\n") : "No page matches.";
     }), { annotations: { readOnlyHint: true } });
-    const read = tool("knowledge_read", 'A page by its id ("concept/bowline"), or "overview": its fields, its content (links to other pages as ids) and the pages that link to it.', { page: z.string().describe('The page id, or "overview"') }, async (args) => attempt(async () => {
+    const read = tool("knowledge_read", 'A page by its id ("concept/bowline"): its fields, its content (links to other pages as ids) and the pages that link to it. Or "overview" (the living synthesis of the whole knowledge base), or "log" (the latest entries of the operation log, newest first: what was done to the knowledge base, and when).', { page: z.string().describe('The page id, "overview" or "log"') }, async (args) => attempt(async () => {
         if (args.page === OVERVIEW)
             return (await store.overview()) || "There's no overview yet: write it with knowledge_rewrite (page \"overview\").";
+        if (args.page === LOG) {
+            if (!store.recentLog)
+                return "This knowledge base's store can't show its log.";
+            const entries = await store.recentLog(10);
+            return entries.length ? entries.join("\n\n") : "The log is empty: nothing has been logged yet.";
+        }
         const page = await store.read(args.page);
         if (!page)
             throw new Error(`There's no page "${args.page}". knowledge_search or knowledge_index finds the right one.`);

package/dist/core/tools/saveToSources.js

@@ -46,8 +46,6 @@ const DEFAULT_DESCRIPTION = "Copy a file from this run's own folder (e.g. someth
     "downloading a document you're about to study in depth, so later sessions have it too.";
 /** The most `download_to_sources` and `request_file` copy in. */
 export const MAX_SOURCE_BYTES = 50 * 1024 * 1024;
-const ok = (text) => ({ content: [{ type: "text", text }] });
-const fail = (text) => ({ content: [{ type: "text", text }], isError: true });
 const message = (error) => (error instanceof Error ? error.message : String(error));
 function added(result, extra = "") {
     return result.duplicateOf
@@ -116,6 +114,20 @@ export async function downloadToFile(url, file, maxBytes) {
 export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFAULT_DESCRIPTION, options = {}) {
     const projectDir = options.projectDir ?? path.dirname(sourcesDir);
     const maxBytes = options.maxBytes ?? MAX_SOURCE_BYTES;
+    // The texts say "sources/"; the model reads the folder's real name (e.g. "treasure/"),
+    // since it reads and searches the originals by that path. Paths it gives may start with
+    // either.
+    const folder = `${path.relative(projectDir, sourcesDir).split(path.sep).join("/") || "."}/`;
+    const named = (text) => text.replaceAll("sources/", folder);
+    const inFolder = (relative) => {
+        const clean = relative.replace(/\\/g, "/").replace(/^\.\//, "");
+        for (const prefix of [folder, "sources/"])
+            if (clean.startsWith(prefix))
+                return clean.slice(prefix.length);
+        return clean;
+    };
+    const ok = (text) => ({ content: [{ type: "text", text: named(text) }] });
+    const fail = (text) => ({ content: [{ type: "text", text: named(text) }], isError: true });
     const replaces = z.string().optional().describe("For a new version: the original it replaces, relative to sources/ (kept, never overwritten)");
     const saveToSources = tool("save_to_sources", description, {
         source: z.string().describe("Path to the file, relative to this run's own folder - not a URL"),
@@ -131,7 +143,7 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
         }
         try {
             const relative = path.relative(runDir, resolvedSource).split(path.sep).join("/");
-            return ok(added(await addSource(sourcesDir, resolvedSource, args.destination, { kind: "run", from: relative }, { replaces: args.replaces })));
+            return ok(added(await addSource(sourcesDir, resolvedSource, inFolder(args.destination), { kind: "run", from: relative }, { replaces: args.replaces && inFolder(args.replaces) })));
         }
         catch (error) {
             return fail(message(error));
@@ -150,7 +162,7 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
         from: z.number().int().positive().optional().describe("First slide (PPTX)"),
         to: z.number().int().positive().optional().describe("Last slide (PPTX)"),
     }, async (args) => {
-        const file = resolveWithin(sourcesDir, args.source);
+        const file = resolveWithin(sourcesDir, inFolder(args.source));
         if (!file || !(await stat(file).catch(() => null))?.isFile())
             return fail(`"${args.source}" isn't an original in sources/ (list_sources lists them).`);
         if (!EXTRACTABLE.has(path.extname(file).slice(1).toLowerCase()))
@@ -171,7 +183,7 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
         try {
             const type = await downloadToFile(args.url, temp, maxBytes);
             const name = decodeURIComponent(new URL(args.url).pathname.split("/").filter(Boolean).pop() ?? "download");
-            const result = await addSource(sourcesDir, temp, args.destination, { kind: "url", from: args.url }, { replaces: args.replaces, name });
+            const result = await addSource(sourcesDir, temp, inFolder(args.destination), { kind: "url", from: args.url }, { replaces: args.replaces && inFolder(args.replaces), name });
             let extra = "";
             if (!result.duplicateOf && /html/i.test(type)) {
                 const html = await readFile(temp, "utf8");
@@ -217,7 +229,7 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
         if (info.size > maxBytes)
             return fail(`"${answer}" is ${info.size} bytes, over the ${maxBytes}-byte limit.`);
         try {
-            return ok(added(await addSource(sourcesDir, file, args.destination ?? path.basename(file), { kind: "person", from: path.basename(file) }, { replaces: args.replaces })));
+            return ok(added(await addSource(sourcesDir, file, args.destination ? inFolder(args.destination) : path.basename(file), { kind: "person", from: path.basename(file) }, { replaces: args.replaces && inFolder(args.replaces) })));
         }
         catch (error) {
             return fail(message(error));
@@ -229,11 +241,11 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
         reason: z.string().describe("Why, in one sentence, in the person's language"),
         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(args.source, args.why, args.reason, args.replacedBy) });
+        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, args.source, args.why, args.reason, args.replacedBy);
+            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}.`,
@@ -245,9 +257,11 @@ export function createSaveToSourcesServer(runDir, sourcesDir, description = DEFA
             return fail(message(error));
         }
     });
-    return createSdkMcpServer({
-        name: "sourceFiles",
-        version: "1.0.0",
-        tools: [saveToSources, listSourcesTool, extractTextTool, downloadToSources, ...(options.interactive ? [requestFile, retire] : [])],
-    });
+    // The descriptions (the tool's and its parameters') with the folder's real name too.
+    const tools = [saveToSources, listSourcesTool, extractTextTool, downloadToSources, ...(options.interactive ? [requestFile, retire] : [])].map((definition) => ({
+        ...definition,
+        description: named(definition.description),
+        inputSchema: Object.fromEntries(Object.entries(definition.inputSchema).map(([key, schema]) => [key, schema.description ? schema.describe(named(schema.description)) : schema])),
+    }));
+    return createSdkMcpServer({ name: "sourceFiles", version: "1.0.0", tools: tools });
 }

package/dist/core/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The version of agent-kit in use, read from its own `package.json` (next to `dist/`, or
+ * `src/` under tsx), e.g. to show it in an agent's header or log.
+ */
+export declare function agentKitVersion(): string;

package/dist/core/version.js

@@ -0,0 +1,12 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+let cached;
+/**
+ * The version of agent-kit in use, read from its own `package.json` (next to `dist/`, or
+ * `src/` under tsx), e.g. to show it in an agent's header or log.
+ */
+export function agentKitVersion() {
+    cached ??= JSON.parse(readFileSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json"), "utf8")).version;
+    return cached;
+}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export type { Mode, BaseSessionConfig, AgentSpec, PlanModeSpec } from "./core/ag
 export { buildSessionOptions, createInputQueue, createDeferred, createModeControl, togglePlanMode, type ModeControl } 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 { 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";

package/dist/index.js

@@ -11,6 +11,7 @@ export { createFriendlyToolLabel, truncate, truncatePath, } from "./core/toolLab
 export { buildSessionOptions, createInputQueue, createDeferred, createModeControl, togglePlanMode } from "./core/session.js";
 export { runQuery } from "./core/runner.js";
 export { knowledgePluginRoot, knowledgePromptSection } from "./core/knowledge.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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falkenslab/agent-kit",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "Library for building an agent on top of the Claude Agent SDK",
   "author": "Francisco Vargas Ruiz",
   "license": "MIT",