@falkenslab/agent-kit 0.14.0 → 0.16.0

package/dist/core/messages/en.js

@@ -53,6 +53,29 @@ export const en = {
     parametersLine: (parameters) => `Parameters: ${parameters}`,
     approvalTitle: "Human confirmation required before publishing",
     summaryLine: (summary) => `Summary: ${summary}`,
+    noAnswer: "(no answer)",
+    textAnswerHint: "type the answer",
+    textAnswerKeys: "Enter to send · Esc for no answer",
+    fileRequestTitle: "The agent asks for a file",
+    fileRequestQuestion: "Path of the file (drag it here), or Enter if you don't have it: ",
+    retireTitle: "Retire a source?",
+    retirePageTitle: "Retire a knowledge base page?",
+    choiceQuestion: (multiple) => (multiple ? "Numbers separated by commas, or your own answer: " : "Number, or your own answer: "),
+    otherOption: "Other (type your own answer)",
+    choiceKeys: (multiple) => (multiple ? "Space to mark · Enter to send" : "↑/↓ choose · Enter to send"),
+    questionTitle: "The agent asks",
+    planTitle: "The plan, for your approval",
+    runPlan: "Run it",
+    keepPlanning: "Keep planning",
+    cancelPlan: "Cancel",
+    planCommentQuestion: "What should change? (Enter to skip): ",
+    retireLines: (source, why, reason, replacedBy) => [
+        `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.",
+    ],
     toolPhrases: {
         Read: ["read {n} file", "read {n} files"],
         Write: ["wrote {n} file", "wrote {n} files"],
@@ -65,16 +88,40 @@ export const en = {
         Skill: ["used {n} skill", "used {n} skills"],
         Agent: ["ran {n} subagent", "ran {n} subagents"],
         Task: ["ran {n} subagent", "ran {n} subagents"],
+        mcp__time__current_time: ["checked the time", "checked the time {n} times"],
+        mcp__time__date_math: ["calculated dates", "calculated dates {n} times"],
+        mcp__sourceFiles__list_sources: ["listed the sources", "listed the sources {n} times"],
+        mcp__sourceFiles__extract_text: ["read {n} document", "read {n} documents"],
+        mcp__sourceFiles__save_to_sources: ["saved {n} source", "saved {n} sources"],
+        mcp__sourceFiles__download_to_sources: ["downloaded {n} source", "downloaded {n} sources"],
+        mcp__sourceFiles__request_file: ["asked for {n} file", "asked for {n} files"],
+        mcp__sourceFiles__retire_source: ["retired {n} source", "retired {n} sources"],
+        mcp__knowledge__knowledge_index: ["read the index", "read the index {n} times"],
+        mcp__knowledge__knowledge_search: ["searched the knowledge base", "searched the knowledge base {n} times"],
+        mcp__knowledge__knowledge_read: ["read {n} page", "read {n} pages"],
+        mcp__knowledge__knowledge_create: ["created {n} page", "created {n} pages"],
+        mcp__knowledge__knowledge_edit: ["edited {n} page", "edited {n} pages"],
+        mcp__knowledge__knowledge_rewrite: ["rewrote {n} page", "rewrote {n} pages"],
+        mcp__knowledge__knowledge_supersede: ["superseded {n} page", "superseded {n} pages"],
+        mcp__knowledge__knowledge_retire: ["retired {n} page", "retired {n} pages"],
+        mcp__knowledge__knowledge_log: ["updated the log", "updated the log {n} times"],
+        mcp__knowledge__knowledge_check: ["checked the knowledge base", "checked the knowledge base {n} times"],
+        mcp__approvals__ask_human: ["asked {n} question", "asked {n} questions"],
+        mcp__approvals__present_plan: ["presented the plan", "presented the plan {n} times"],
     },
     otherTools: ["used {n} tool", "used {n} tools"],
     noOutput: "(no output)",
     error: "error",
+    toolFailed: "Couldn't complete it",
     moreResultLines: (count) => `(+${count} ${plural(count, "line", "lines")})`,
     earlierCalls: (count) => `… ${count} earlier`,
+    moreTodos: (count) => `… ${count} more ${plural(count, "task", "tasks")}`,
     labels: {
         askingApproval: (summary) => `Asking for human approval: ${summary}`,
         waitingManual: "Waiting for a human to intervene manually",
         savingToSources: (destination) => `Saving a file to sources/${destination}`,
+        checkingTime: "Checking the date and time",
+        calculatingDates: "Calculating dates",
         reading: (file) => `Reading ${file}`,
         writing: (file) => `Writing to ${file}`,
         editing: (file) => `Editing ${file}`,
@@ -90,6 +137,24 @@ export const en = {
         searchingWeb: (query) => `Searching the web for "${query}"`,
         applyingSkill: (skill) => `Applying the "${skill}" skill`,
         aSkill: "a skill",
+        updatingTasks: "Updating the task list",
+        listingSources: "Listing the sources",
+        extractingText: (source) => `Reading ${source}`,
+        downloading: (url) => `Downloading ${url} to the sources`,
+        requestingFile: (description) => `Asking for a file: ${description}`,
+        retiringSource: (source) => `Retiring the source ${source}`,
+        knowledgeIndex: "Reading the knowledge base's index",
+        knowledgeSearch: (query) => `Searching the knowledge base for "${query}"`,
+        knowledgeRead: (page) => `Reading ${page}`,
+        knowledgeCreate: (page) => `Creating ${page}`,
+        knowledgeEdit: (page) => `Editing ${page}`,
+        knowledgeRewrite: (page) => `Rewriting ${page}`,
+        knowledgeSupersede: (page) => `Marking ${page} superseded`,
+        knowledgeRetire: (page) => `Retiring ${page}`,
+        knowledgeLog: "Updating the knowledge base's log",
+        knowledgeCheck: "Checking the knowledge base",
+        askingHuman: (question) => `Asking: ${question}`,
+        presentingPlan: "Presenting the plan",
     },
     auth: {
         noToken: "No Claude authentication token was found",

package/dist/core/messages/es.js

@@ -54,6 +54,29 @@ export const es = {
     parametersLine: (parameters) => `Parámetros: ${parameters}`,
     approvalTitle: "Hace falta confirmación humana antes de publicar",
     summaryLine: (summary) => `Resumen: ${summary}`,
+    noAnswer: "(sin respuesta)",
+    textAnswerHint: "escribe la respuesta",
+    textAnswerKeys: "Enter para enviar · Esc para no responder",
+    fileRequestTitle: "El agente pide un fichero",
+    fileRequestQuestion: "Ruta del fichero (arrástralo aquí), o Enter si no lo tienes: ",
+    retireTitle: "¿Retirar una fuente?",
+    retirePageTitle: "¿Retirar una página de la base de conocimiento?",
+    choiceQuestion: (multiple) => (multiple ? "Números separados por comas, o tu propia respuesta: " : "Número, o tu propia respuesta: "),
+    otherOption: "Otra (escribe tu respuesta)",
+    choiceKeys: (multiple) => (multiple ? "Espacio para marcar · Enter para enviar" : "↑/↓ elegir · Enter para enviar"),
+    questionTitle: "El agente pregunta",
+    planTitle: "El plan, para tu aprobación",
+    runPlan: "Ejecutarlo",
+    keepPlanning: "Seguir planificando",
+    cancelPlan: "Cancelar",
+    planCommentQuestion: "¿Qué debería cambiar? (Enter para omitir): ",
+    retireLines: (source, why, reason, replacedBy) => [
+        `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.",
+    ],
     toolPhrases: {
         Read: ["leyó {n} fichero", "leyó {n} ficheros"],
         Write: ["escribió {n} fichero", "escribió {n} ficheros"],
@@ -66,16 +89,40 @@ export const es = {
         Skill: ["usó {n} skill", "usó {n} skills"],
         Agent: ["lanzó {n} subagente", "lanzó {n} subagentes"],
         Task: ["lanzó {n} subagente", "lanzó {n} subagentes"],
+        mcp__time__current_time: ["consultó la hora", "consultó la hora {n} veces"],
+        mcp__time__date_math: ["calculó fechas", "calculó fechas {n} veces"],
+        mcp__sourceFiles__list_sources: ["revisó las fuentes", "revisó las fuentes {n} veces"],
+        mcp__sourceFiles__extract_text: ["leyó {n} documento", "leyó {n} documentos"],
+        mcp__sourceFiles__save_to_sources: ["guardó {n} fuente", "guardó {n} fuentes"],
+        mcp__sourceFiles__download_to_sources: ["descargó {n} fuente", "descargó {n} fuentes"],
+        mcp__sourceFiles__request_file: ["pidió {n} fichero", "pidió {n} ficheros"],
+        mcp__sourceFiles__retire_source: ["retiró {n} fuente", "retiró {n} fuentes"],
+        mcp__knowledge__knowledge_index: ["leyó el índice", "leyó el índice {n} veces"],
+        mcp__knowledge__knowledge_search: ["buscó en la base de conocimiento", "buscó en la base de conocimiento {n} veces"],
+        mcp__knowledge__knowledge_read: ["leyó {n} página", "leyó {n} páginas"],
+        mcp__knowledge__knowledge_create: ["creó {n} página", "creó {n} páginas"],
+        mcp__knowledge__knowledge_edit: ["editó {n} página", "editó {n} páginas"],
+        mcp__knowledge__knowledge_rewrite: ["reescribió {n} página", "reescribió {n} páginas"],
+        mcp__knowledge__knowledge_supersede: ["sustituyó {n} página", "sustituyó {n} páginas"],
+        mcp__knowledge__knowledge_retire: ["retiró {n} página", "retiró {n} páginas"],
+        mcp__knowledge__knowledge_log: ["actualizó el registro", "actualizó el registro {n} veces"],
+        mcp__knowledge__knowledge_check: ["revisó la base de conocimiento", "revisó la base de conocimiento {n} veces"],
+        mcp__approvals__ask_human: ["hizo {n} pregunta", "hizo {n} preguntas"],
+        mcp__approvals__present_plan: ["presentó el plan", "presentó el plan {n} veces"],
     },
     otherTools: ["usó {n} herramienta", "usó {n} herramientas"],
     noOutput: "(sin salida)",
     error: "error",
+    toolFailed: "No se pudo completar",
     moreResultLines: (count) => `(+${count} ${plural(count, "línea", "líneas")})`,
     earlierCalls: (count) => `… ${count} ${plural(count, "anterior", "anteriores")}`,
+    moreTodos: (count) => `… ${count} ${plural(count, "tarea", "tareas")} más`,
     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}`,
+        checkingTime: "Consultando la fecha y la hora",
+        calculatingDates: "Calculando fechas",
         reading: (file) => `Leyendo ${file}`,
         writing: (file) => `Escribiendo en ${file}`,
         editing: (file) => `Editando ${file}`,
@@ -91,6 +138,24 @@ export const es = {
         searchingWeb: (query) => `Buscando en la web "${query}"`,
         applyingSkill: (skill) => `Aplicando la skill "${skill}"`,
         aSkill: "una skill",
+        updatingTasks: "Actualizando la lista de tareas",
+        listingSources: "Revisando las fuentes",
+        extractingText: (source) => `Leyendo ${source}`,
+        downloading: (url) => `Descargando ${url} a las fuentes`,
+        requestingFile: (description) => `Pidiendo un fichero: ${description}`,
+        retiringSource: (source) => `Retirando la fuente ${source}`,
+        knowledgeIndex: "Leyendo el índice de la base de conocimiento",
+        knowledgeSearch: (query) => `Buscando "${query}" en la base de conocimiento`,
+        knowledgeRead: (page) => `Leyendo ${page}`,
+        knowledgeCreate: (page) => `Creando ${page}`,
+        knowledgeEdit: (page) => `Editando ${page}`,
+        knowledgeRewrite: (page) => `Reescribiendo ${page}`,
+        knowledgeSupersede: (page) => `Marcando ${page} como sustituida`,
+        knowledgeRetire: (page) => `Retirando ${page}`,
+        knowledgeLog: "Actualizando el registro de la base de conocimiento",
+        knowledgeCheck: "Revisando la base de conocimiento",
+        askingHuman: (question) => `Preguntando: ${question}`,
+        presentingPlan: "Presentando el plan",
     },
     auth: {
         noToken: "No se ha encontrado ningún token de autenticación de Claude",

package/dist/core/messages/fr.js

@@ -54,6 +54,29 @@ export const fr = {
     parametersLine: (parameters) => `Paramètres : ${parameters}`,
     approvalTitle: "Confirmation humaine requise avant de publier",
     summaryLine: (summary) => `Résumé : ${summary}`,
+    noAnswer: "(pas de réponse)",
+    textAnswerHint: "tapez la réponse",
+    textAnswerKeys: "Entrée pour envoyer · Échap pour ne pas répondre",
+    fileRequestTitle: "L'agent demande un fichier",
+    fileRequestQuestion: "Chemin du fichier (glissez-le ici), ou Entrée si vous ne l'avez pas : ",
+    retireTitle: "Retirer une source ?",
+    retirePageTitle: "Retirer une page de la base de connaissances ?",
+    choiceQuestion: (multiple) => (multiple ? "Numéros séparés par des virgules, ou votre propre réponse : " : "Numéro, ou votre propre réponse : "),
+    otherOption: "Autre (tapez votre réponse)",
+    choiceKeys: (multiple) => (multiple ? "Espace pour cocher · Entrée pour envoyer" : "↑/↓ choisir · Entrée pour envoyer"),
+    questionTitle: "L'agent demande",
+    planTitle: "Le plan, pour votre approbation",
+    runPlan: "L'exécuter",
+    keepPlanning: "Continuer à planifier",
+    cancelPlan: "Annuler",
+    planCommentQuestion: "Que faut-il changer ? (Entrée pour passer) : ",
+    retireLines: (source, why, reason, replacedBy) => [
+        `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.",
+    ],
     toolPhrases: {
         Read: ["a lu {n} fichier", "a lu {n} fichiers"],
         Write: ["a écrit {n} fichier", "a écrit {n} fichiers"],
@@ -66,16 +89,40 @@ export const fr = {
         Skill: ["a utilisé {n} skill", "a utilisé {n} skills"],
         Agent: ["a lancé {n} sous-agent", "a lancé {n} sous-agents"],
         Task: ["a lancé {n} sous-agent", "a lancé {n} sous-agents"],
+        mcp__time__current_time: ["a consulté l'heure", "a consulté l'heure {n} fois"],
+        mcp__time__date_math: ["a calculé des dates", "a calculé des dates {n} fois"],
+        mcp__sourceFiles__list_sources: ["a examiné les sources", "a examiné les sources {n} fois"],
+        mcp__sourceFiles__extract_text: ["a lu {n} document", "a lu {n} documents"],
+        mcp__sourceFiles__save_to_sources: ["a enregistré {n} source", "a enregistré {n} sources"],
+        mcp__sourceFiles__download_to_sources: ["a téléchargé {n} source", "a téléchargé {n} sources"],
+        mcp__sourceFiles__request_file: ["a demandé {n} fichier", "a demandé {n} fichiers"],
+        mcp__sourceFiles__retire_source: ["a retiré {n} source", "a retiré {n} sources"],
+        mcp__knowledge__knowledge_index: ["a lu l'index", "a lu l'index {n} fois"],
+        mcp__knowledge__knowledge_search: ["a cherché dans la base", "a cherché dans la base {n} fois"],
+        mcp__knowledge__knowledge_read: ["a lu {n} page", "a lu {n} pages"],
+        mcp__knowledge__knowledge_create: ["a créé {n} page", "a créé {n} pages"],
+        mcp__knowledge__knowledge_edit: ["a modifié {n} page", "a modifié {n} pages"],
+        mcp__knowledge__knowledge_rewrite: ["a réécrit {n} page", "a réécrit {n} pages"],
+        mcp__knowledge__knowledge_supersede: ["a remplacé {n} page", "a remplacé {n} pages"],
+        mcp__knowledge__knowledge_retire: ["a retiré {n} page", "a retiré {n} pages"],
+        mcp__knowledge__knowledge_log: ["a mis à jour le journal", "a mis à jour le journal {n} fois"],
+        mcp__knowledge__knowledge_check: ["a vérifié la base", "a vérifié la base {n} fois"],
+        mcp__approvals__ask_human: ["a posé {n} question", "a posé {n} questions"],
+        mcp__approvals__present_plan: ["a présenté le plan", "a présenté le plan {n} fois"],
     },
     otherTools: ["a utilisé {n} outil", "a utilisé {n} outils"],
     noOutput: "(aucune sortie)",
     error: "erreur",
+    toolFailed: "Impossible de terminer",
     moreResultLines: (count) => `(+${count} ${plural(count, "ligne", "lignes")})`,
     earlierCalls: (count) => `… ${count} ${plural(count, "précédent", "précédents")}`,
+    moreTodos: (count) => `… ${count} ${plural(count, "tâche", "tâches")} de plus`,
     labels: {
         askingApproval: (summary) => `Demande d'approbation humaine : ${summary}`,
         waitingManual: "En attente d'une intervention manuelle",
         savingToSources: (destination) => `Enregistrement d'un fichier dans sources/${destination}`,
+        checkingTime: "Consultation de la date et de l'heure",
+        calculatingDates: "Calcul de dates",
         reading: (file) => `Lecture de ${file}`,
         writing: (file) => `Écriture dans ${file}`,
         editing: (file) => `Modification de ${file}`,
@@ -91,6 +138,24 @@ export const fr = {
         searchingWeb: (query) => `Recherche sur le web de "${query}"`,
         applyingSkill: (skill) => `Application de la skill "${skill}"`,
         aSkill: "une skill",
+        updatingTasks: "Mise à jour de la liste des tâches",
+        listingSources: "Examen des sources",
+        extractingText: (source) => `Lecture de ${source}`,
+        downloading: (url) => `Téléchargement de ${url} dans les sources`,
+        requestingFile: (description) => `Demande d'un fichier : ${description}`,
+        retiringSource: (source) => `Retrait de la source ${source}`,
+        knowledgeIndex: "Lecture de l'index de la base de connaissances",
+        knowledgeSearch: (query) => `Recherche de "${query}" dans la base de connaissances`,
+        knowledgeRead: (page) => `Lecture de ${page}`,
+        knowledgeCreate: (page) => `Création de ${page}`,
+        knowledgeEdit: (page) => `Modification de ${page}`,
+        knowledgeRewrite: (page) => `Réécriture de ${page}`,
+        knowledgeSupersede: (page) => `${page} marquée comme remplacée`,
+        knowledgeRetire: (page) => `Retrait de ${page}`,
+        knowledgeLog: "Mise à jour du journal de la base de connaissances",
+        knowledgeCheck: "Vérification de la base de connaissances",
+        askingHuman: (question) => `Question : ${question}`,
+        presentingPlan: "Présentation du plan",
     },
     auth: {
         noToken: "Aucun jeton d'authentification Claude n'a été trouvé",

package/dist/core/modeControl.d.ts

@@ -0,0 +1,36 @@
+import type { Mode } from "./agentSpec.js";
+/**
+ * The supervision mode of a running session. "guided", "interactive" and "plan" switch into
+ * one another: they share the same tools (the approval tool), and the step gate and the plan
+ * gate are registered in all three, deciding only in their own mode. "autonomous" has no
+ * approval tool at all, and a tool can't appear or vanish mid-session, so a session that
+ * starts autonomous stays autonomous, and one that doesn't can't become autonomous. The
+ * system prompt keeps the mode it was built with, so entering or leaving plan mode is told
+ * to the model with the next message instead (`takeNotice()`).
+ */
+export interface ModeControl {
+    readonly mode: Mode;
+    /** The modes this session can be in, in Shift+Tab's order; fewer than two means it can't switch. */
+    readonly switchable: readonly Mode[];
+    /** Switches to `next` if this session allows it; returns whether it did. */
+    set(next: Mode): boolean;
+    /**
+     * The note telling the model it entered or left plan mode, once per change it hasn't been
+     * told about yet; `undefined` otherwise. `createInputQueue({ modeControl })` puts it before
+     * the next message; a caller with its own queue prepends it itself.
+     */
+    takeNotice?(): string | undefined;
+    /**
+     * Calls `listener` with the new mode whenever it changes (Shift+Tab, `/plan`, or the agent
+     * leaving plan mode through `present_plan`), so a UI can show it; returns the unsubscribe.
+     */
+    subscribe?(listener: (mode: Mode) => void): () => void;
+}
+/** A `ModeControl` starting at `initial` (`buildSessionOptions()` returns one for its session). */
+export declare function createModeControl(initial: Mode): ModeControl;
+/**
+ * What the chats' `/plan` does: switches `control` into plan mode, or, when it's already
+ * there, back to the mode it was entered from ("guided" if it started in plan mode). Returns
+ * the new mode, or `null` when this session can't be in plan mode (an autonomous one).
+ */
+export declare function togglePlanMode(control: ModeControl): Mode | null;

package/dist/core/modeControl.js

@@ -0,0 +1,61 @@
+/** A `ModeControl` starting at `initial` (`buildSessionOptions()` returns one for its session). */
+export function createModeControl(initial) {
+    let current = initial;
+    // The mode the model was last told about: a session starting in plan mode tells it with
+    // the first message, since the system prompt doesn't say.
+    let told = initial === "plan" ? undefined : initial;
+    const switchable = initial === "autonomous" ? ["autonomous"] : ["guided", "interactive", "plan"];
+    const listeners = new Set();
+    return {
+        get mode() {
+            return current;
+        },
+        switchable,
+        set(next) {
+            if (!switchable.includes(next))
+                return false;
+            const changed = next !== current;
+            current = next;
+            if (changed)
+                for (const listener of listeners)
+                    listener(next);
+            return true;
+        },
+        takeNotice() {
+            const before = told;
+            told = current;
+            if (current === "plan" && before !== "plan")
+                return PLAN_MODE_ENTERED;
+            if (current !== "plan" && before === "plan")
+                return PLAN_MODE_LEFT;
+            return undefined;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+// The mode each session was in when `/plan` took it into plan mode, to go back to.
+const modeBeforePlan = new WeakMap();
+/**
+ * What the chats' `/plan` does: switches `control` into plan mode, or, when it's already
+ * there, back to the mode it was entered from ("guided" if it started in plan mode). Returns
+ * the new mode, or `null` when this session can't be in plan mode (an autonomous one).
+ */
+export function togglePlanMode(control) {
+    if (!control.switchable.includes("plan"))
+        return null;
+    if (control.mode === "plan") {
+        const back = modeBeforePlan.get(control) ?? "guided";
+        control.set(back);
+        return back;
+    }
+    modeBeforePlan.set(control, control.mode);
+    control.set("plan");
+    return "plan";
+}
+// What the model reads on a plan-mode switch, in English like the rest of what it reads
+// (ADR-019); tagged so a resumed conversation doesn't show it as the human's words (runs.ts).
+const PLAN_MODE_ENTERED = "<system-reminder>The user switched to plan mode. Only read, research and plan: nothing can be changed (files, tools that modify something) until they switch out of it. When the plan is ready, present it and wait for them.</system-reminder>";
+const PLAN_MODE_LEFT = "<system-reminder>The user left plan mode: you can carry out the plan now.</system-reminder>";

package/dist/core/session.d.ts

@@ -1,6 +1,8 @@
 import type { Options, SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
 import { type TranscriptLogger } from "./hooks/transcriptLogger.js";
-import type { AgentSpec, BaseSessionConfig, Mode } from "./agentSpec.js";
+import { type ModeControl } from "./modeControl.js";
+import type { KnowledgeStore } from "./knowledgeStore.js";
+import type { AgentSpec, BaseSessionConfig } from "./agentSpec.js";
 import { type Language } from "./language.js";
 import { type RunFolder } from "./runs.js";
 /**
@@ -31,37 +33,10 @@ export declare function buildSessionOptions<TConfig extends BaseSessionConfig>(c
     transcriptPath: string;
     modeControl: ModeControl;
     language: Language;
+    /** The knowledge base's store, when the agent reaches it through the `knowledge_*` tools. */
+    knowledgeStore?: KnowledgeStore;
 }>;
-/**
- * The supervision mode of a running session. "guided", "interactive" and "plan" switch into
- * one another: they share the same tools (the approval tool), and the step gate and the plan
- * gate are registered in all three, deciding only in their own mode. "autonomous" has no
- * approval tool at all, and a tool can't appear or vanish mid-session, so a session that
- * starts autonomous stays autonomous, and one that doesn't can't become autonomous. The
- * system prompt keeps the mode it was built with, so entering or leaving plan mode is told
- * to the model with the next message instead (`takeNotice()`).
- */
-export interface ModeControl {
-    readonly mode: Mode;
-    /** The modes this session can be in, in Shift+Tab's order; fewer than two means it can't switch. */
-    readonly switchable: readonly Mode[];
-    /** Switches to `next` if this session allows it; returns whether it did. */
-    set(next: Mode): boolean;
-    /**
-     * The note telling the model it entered or left plan mode, once per change it hasn't been
-     * told about yet; `undefined` otherwise. `createInputQueue({ modeControl })` puts it before
-     * the next message; a caller with its own queue prepends it itself.
-     */
-    takeNotice?(): string | undefined;
-}
-/** A `ModeControl` starting at `initial` (`buildSessionOptions()` returns one for its session). */
-export declare function createModeControl(initial: Mode): ModeControl;
-/**
- * What the chats' `/plan` does: switches `control` into plan mode, or, when it's already
- * there, back to the mode it was entered from ("guided" if it started in plan mode). Returns
- * the new mode, or `null` when this session can't be in plan mode (an autonomous one).
- */
-export declare function togglePlanMode(control: ModeControl): Mode | null;
+export { createModeControl, togglePlanMode, type ModeControl } from "./modeControl.js";
 /**
  * User message queue backed by a single long-lived generator, for any multi-turn
  * (chat-shaped) caller of `query()`.