catui-agent 1.0.0-beta.0

package/dist/core/tools/truncate.d.ts

@@ -0,0 +1,66 @@
+/**
+ * [WHO]: TruncationResult, truncateHead(), truncateTail(), formatSize()
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/tools/index.ts, core/tools/bash.ts, core/tools/read.ts, core/tools/grep.ts, core/tools/find.ts, core/tools/ls.ts, core/platform/exec/bash-executor.ts, modes/interactive/components/tool-execution.ts, modes/interactive/components/bash-execution.ts
+ * [HERE]: core/tools/truncate.ts - shared truncation utilities for tool outputs
+ */
+export declare const DEFAULT_MAX_LINES = 2000;
+export declare const DEFAULT_MAX_BYTES: number;
+export declare const GREP_MAX_LINE_LENGTH = 500;
+export interface TruncationResult {
+    /** The truncated content */
+    content: string;
+    /** Whether truncation occurred */
+    truncated: boolean;
+    /** Which limit was hit: "lines", "bytes", or null if not truncated */
+    truncatedBy: "lines" | "bytes" | null;
+    /** Total number of lines in the original content */
+    totalLines: number;
+    /** Total number of bytes in the original content */
+    totalBytes: number;
+    /** Number of complete lines in the truncated output */
+    outputLines: number;
+    /** Number of bytes in the truncated output */
+    outputBytes: number;
+    /** Whether the last line was partially truncated (only for tail truncation edge case) */
+    lastLinePartial: boolean;
+    /** Whether the first line exceeded the byte limit (for head truncation) */
+    firstLineExceedsLimit: boolean;
+    /** The max lines limit that was applied */
+    maxLines: number;
+    /** The max bytes limit that was applied */
+    maxBytes: number;
+}
+export interface TruncationOptions {
+    /** Maximum number of lines (default: 2000) */
+    maxLines?: number;
+    /** Maximum number of bytes (default: 50KB) */
+    maxBytes?: number;
+}
+/**
+ * Format bytes as human-readable size.
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * Truncate content from the head (keep first N lines/bytes).
+ * Suitable for file reads where you want to see the beginning.
+ *
+ * Never returns partial lines. If first line exceeds byte limit,
+ * returns empty content with firstLineExceedsLimit=true.
+ */
+export declare function truncateHead(content: string, options?: TruncationOptions): TruncationResult;
+/**
+ * Truncate content from the tail (keep last N lines/bytes).
+ * Suitable for bash output where you want to see the end (errors, final results).
+ *
+ * May return partial first line if the last line of original content exceeds byte limit.
+ */
+export declare function truncateTail(content: string, options?: TruncationOptions): TruncationResult;
+/**
+ * Truncate a single line to max characters, adding [truncated] suffix.
+ * Used for grep match lines.
+ */
+export declare function truncateLine(line: string, maxChars?: number): {
+    text: string;
+    wasTruncated: boolean;
+};

package/dist/core/tools/truncate.js

@@ -0,0 +1,5 @@
+var x=Object.defineProperty;var B=(t,u)=>x(t,"name",{value:u,configurable:!0});const _=2e3,A=51200,T=500;function m(t){return t<1024?`${t}B`:t<1024*1024?`${(t/1024).toFixed(1)}KB`:`${(t/(1024*1024)).toFixed(1)}MB`}B(m,"formatSize");function b(t,u={}){const n=u.maxLines??2e3,e=u.maxBytes??51200,s=Buffer.byteLength(t,"utf-8"),o=t.split(`
+`),i=o.length;if(i<=n&&s<=e)return{content:t,truncated:!1,truncatedBy:null,totalLines:i,totalBytes:s,outputLines:i,outputBytes:s,lastLinePartial:!1,firstLineExceedsLimit:!1,maxLines:n,maxBytes:e};if(Buffer.byteLength(o[0],"utf-8")>e)return{content:"",truncated:!0,truncatedBy:"bytes",totalLines:i,totalBytes:s,outputLines:0,outputBytes:0,lastLinePartial:!1,firstLineExceedsLimit:!0,maxLines:n,maxBytes:e};const f=[];let a=0,c="lines";for(let l=0;l<o.length&&l<n;l++){const L=o[l],h=Buffer.byteLength(L,"utf-8")+(l>0?1:0);if(a+h>e){c="bytes";break}f.push(L),a+=h}f.length>=n&&a<=e&&(c="lines");const y=f.join(`
+`),p=Buffer.byteLength(y,"utf-8");return{content:y,truncated:!0,truncatedBy:c,totalLines:i,totalBytes:s,outputLines:f.length,outputBytes:p,lastLinePartial:!1,firstLineExceedsLimit:!1,maxLines:n,maxBytes:e}}B(b,"truncateHead");function F(t,u={}){const n=u.maxLines??2e3,e=u.maxBytes??51200,s=Buffer.byteLength(t,"utf-8"),o=t.split(`
+`),i=o.length;if(i<=n&&s<=e)return{content:t,truncated:!1,truncatedBy:null,totalLines:i,totalBytes:s,outputLines:i,outputBytes:s,lastLinePartial:!1,firstLineExceedsLimit:!1,maxLines:n,maxBytes:e};const r=[];let f=0,a="lines",c=!1;for(let l=o.length-1;l>=0&&r.length<n;l--){const L=o[l],h=Buffer.byteLength(L,"utf-8")+(r.length>0?1:0);if(f+h>e){if(a="bytes",r.length===0){const g=E(L,e);r.unshift(g),f=Buffer.byteLength(g,"utf-8"),c=!0}break}r.unshift(L),f+=h}r.length>=n&&f<=e&&(a="lines");const y=r.join(`
+`),p=Buffer.byteLength(y,"utf-8");return{content:y,truncated:!0,truncatedBy:a,totalLines:i,totalBytes:s,outputLines:r.length,outputBytes:p,lastLinePartial:c,firstLineExceedsLimit:!1,maxLines:n,maxBytes:e}}B(F,"truncateTail");function E(t,u){const n=Buffer.from(t,"utf-8");if(n.length<=u)return t;let e=n.length-u;for(;e<n.length&&(n[e]&192)===128;)e++;return n.slice(e).toString("utf-8")}B(E,"truncateStringToBytesFromEnd");function M(t,u=500){return t.length<=u?{text:t,wasTruncated:!1}:{text:`${t.slice(0,u)}... [truncated]`,wasTruncated:!0}}B(M,"truncateLine");export{A as DEFAULT_MAX_BYTES,_ as DEFAULT_MAX_LINES,T as GREP_MAX_LINE_LENGTH,m as formatSize,b as truncateHead,M as truncateLine,F as truncateTail};

package/dist/core/tools/write-guard.d.ts

@@ -0,0 +1,2 @@
+export declare function isPathWithinRoot(targetPath: string, rootPath: string): boolean;
+export declare function createWorkspaceWriteGuard(cwd: string): (absolutePath: string) => void;

package/dist/core/tools/write-guard.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var t=(r,o)=>c(r,"name",{value:o,configurable:!0});import{isAbsolute as a,resolve as u}from"node:path";function i(r){return u((a(r),r))}t(i,"normalizePath");function s(r){return i(r).replace(/\\/g,"/").replace(/\/+$/,"")}t(s,"normalizeForComparison");function f(r,o){const e=s(o),n=s(r);return n===e||n.startsWith(`${e}/`)}t(f,"isPathWithinRoot");function m(r){const o=i(r);return e=>{if(!f(e,o))throw new Error(`Write denied for ${e}. Main session write tools may only write inside the current workspace: ${o}`)}}t(m,"createWorkspaceWriteGuard");export{m as createWorkspaceWriteGuard,f as isPathWithinRoot};

package/dist/core/tools/write.d.ts

@@ -0,0 +1,36 @@
+/**
+ * [WHO]: WriteTool, writeTool, createWriteTool, WriteToolInput
+ * [FROM]: Depends on agent-core, node:fs/promises, path-utils.ts
+ * [TO]: Consumed by core/tools/index.ts
+ * [HERE]: core/tools/write.ts - filesystem creation/overwrite; consumed by orchestrator
+ */
+import type { AgentTool } from "@catui/agent-core";
+import { type Static } from "@sinclair/typebox";
+declare const writeSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    content: import("@sinclair/typebox").TString;
+}>;
+export type WriteToolInput = Static<typeof writeSchema>;
+/**
+ * Pluggable operations for the write tool.
+ * Override these to delegate file writing to remote systems (e.g., SSH).
+ */
+export interface WriteOperations {
+    /** Write content to a file */
+    writeFile: (absolutePath: string, content: string) => Promise<void>;
+    /** Create directory (recursively) */
+    mkdir: (dir: string) => Promise<void>;
+}
+export interface WriteToolOptions {
+    /** Custom operations for file writing. Default: local filesystem */
+    operations?: WriteOperations;
+    /** Optional guard called with the resolved absolute path before writing. */
+    beforeWrite?: (absolutePath: string) => void | Promise<void>;
+}
+export declare function createWriteTool(cwd: string, options?: WriteToolOptions): AgentTool<typeof writeSchema>;
+/** Default write tool using process.cwd() - for backwards compatibility */
+export declare const writeTool: AgentTool<import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    content: import("@sinclair/typebox").TString;
+}>, any>;
+export {};

package/dist/core/tools/write.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var o=(r,i)=>h(r,"name",{value:i,configurable:!0});import{Type as m}from"@sinclair/typebox";import{existsSync as v}from"fs";import{mkdir as y,stat as S,writeFile as x}from"fs/promises";import{dirname as E}from"path";import{fileStateCache as l}from"./file-state-cache.js";import{resolveToCwd as C}from"./path-utils.js";const W=m.Object({path:m.String({description:"Path to the file to write (relative or absolute)"}),content:m.String({description:"Content to write to the file"})}),k={writeFile:o((r,i)=>x(r,i,"utf-8"),"writeFile"),mkdir:o(r=>y(r,{recursive:!0}).then(()=>{}),"mkdir")};function F(r,i){const w=i?.operations??k;return{name:"write",label:"write",description:"Write content to a file. Creates the file if it doesn't exist, overwrites if it does. Automatically creates parent directories.",parameters:W,execute:o(async(L,{path:d,content:c},e)=>{const t=C(d,r),u=E(t);return await i?.beforeWrite?.(t),new Promise((p,a)=>{if(e?.aborted){a(new Error("Operation aborted"));return}let n=!1;const s=o(()=>{n=!0,a(new Error("Operation aborted"))},"onAbort");e&&e.addEventListener("abort",s,{once:!0}),(async()=>{try{if(v(t)){const f=l.get(t);if(f){const b=await S(t);if(Math.floor(b.mtimeMs)>f.timestamp){l.delete(t),e&&e.removeEventListener("abort",s),a(new Error(`Cannot write ${d}: file has been modified since it was last read. Use the read tool to re-read the file before writing.`));return}}}if(await w.mkdir(u),n||(await w.writeFile(t,c),l.set(t,{content:c,timestamp:Math.floor(Date.now()),offset:void 0,limit:void 0}),n))return;e&&e.removeEventListener("abort",s),p({content:[{type:"text",text:`Successfully wrote ${c.length} bytes to ${d}`}],details:void 0})}catch(f){e&&e.removeEventListener("abort",s),n||a(f)}})()})},"execute")}}o(F,"createWriteTool");const I=F(process.cwd());export{F as createWriteTool,I as writeTool};

package/dist/core/workspace/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: Barrel exports - WorktreeManager, WorkspacePath
+ * [FROM]: Depends on ./worktree-manager
+ * [TO]: Consumed by core/sub-agent/*, extensions/builtin/subagent/*, extensions/builtin/team/*
+ * [HERE]: core/workspace/index.ts - workspace management public API
+ */
+export { WorktreeManager, worktreeManager } from "./worktree-manager.js";
+export type { WorkspacePath } from "./worktree-manager.js";

package/dist/core/workspace/index.js

@@ -0,0 +1 @@
+import{WorktreeManager as a,worktreeManager as o}from"./worktree-manager.js";export{a as WorktreeManager,o as worktreeManager};

package/dist/core/workspace/worktree-manager.d.ts

@@ -0,0 +1,73 @@
+/**
+ * [WHO]: WorktreeManager class - temporary workspace and git worktree management
+ * [FROM]: Depends on node:fs/promises, node:path, node:child_process
+ * [TO]: Consumed by ./index.ts, core/sub-agent/*, extensions/builtin/subagent/*, extensions/builtin/team/*
+ * [HERE]: core/workspace/worktree-manager.ts - workspace management for SubAgents
+ */
+export interface WorkspacePath {
+    /** Absolute path to the workspace */
+    readonly path: string;
+    /** Type of workspace */
+    readonly type: "temp" | "worktree";
+}
+export interface WorkspaceChange {
+    path: string;
+    status: "added" | "modified" | "deleted";
+}
+/**
+ * Manager for creating and disposing workspaces for SubAgents.
+ * Provides temporary directories and git worktrees.
+ */
+export declare class WorktreeManager {
+    private tempDirs;
+    private worktrees;
+    private snapshots;
+    /**
+     * Create a temporary workspace.
+     * Copies seed files to a new temp directory.
+     * @param seedFiles Files to copy to the temp workspace
+     * @param prefix Prefix for the temp directory name
+     */
+    createTempWorkspace(seedFiles?: string[], prefix?: string, sourceCwd?: string): Promise<WorkspacePath>;
+    /**
+     * Create a temporary snapshot workspace by copying the current project tree.
+     * Used as a fallback when git worktree is unavailable.
+     */
+    createSnapshotWorkspace(sourceCwd: string, prefix?: string): Promise<WorkspacePath>;
+    /**
+     * Create a git worktree for the given branch.
+     * @param branch Branch name for the worktree
+     * @param cwd Working directory for git operations
+     */
+    createGitWorktree(branch?: string, cwd?: string): Promise<WorkspacePath>;
+    /**
+     * List changed files inside a workspace.
+     */
+    listChangedFiles(workspace: WorkspacePath): Promise<string[]>;
+    listChanges(workspace: WorkspacePath): Promise<WorkspaceChange[]>;
+    writePatch(workspace: WorkspacePath, outputPath: string): Promise<boolean>;
+    applyChanges(workspace: WorkspacePath, targetCwd: string): Promise<WorkspaceChange[]>;
+    /**
+     * Dispose of a workspace.
+     * Removes temp directories and worktrees.
+     * @param workspace The workspace to dispose
+     */
+    dispose(workspace: WorkspacePath): Promise<void>;
+    /**
+     * Get all active temp directories.
+     */
+    getActiveTempDirs(): string[];
+    /**
+     * Clean up all temp directories.
+     */
+    disposeAll(): Promise<void>;
+    private resolveWorktreeOwner;
+    private parseGitStatusLine;
+    private collectSnapshotChanges;
+    private collectWorkspaceFiles;
+    private shouldIgnoreRelativePath;
+}
+/**
+ * Default global worktree manager instance.
+ */
+export declare const worktreeManager: WorktreeManager;

package/dist/core/workspace/worktree-manager.js

@@ -0,0 +1,3 @@
+var k=Object.defineProperty;var m=(p,t)=>k(p,"name",{value:t,configurable:!0});import{execFileSync as l}from"node:child_process";import{cp as y,mkdir as g,readdir as F,readFile as S,rm as d,stat as D,writeFile as x}from"node:fs/promises";import{basename as b,dirname as w,join as h,relative as W,resolve as C}from"node:path";function P(p){if(typeof p=="object"&&p!==null){const t=p.stdout;return typeof t=="string"?t:""}return""}m(P,"getStdoutFromExecError");class A{static{m(this,"WorktreeManager")}tempDirs=new Set;worktrees=new Map;snapshots=new Map;async createTempWorkspace(t=[],r="catui-subagent",e=process.cwd()){const i=await import("node:os").then(n=>n.tmpdir()),s=`${r}-${crypto.randomUUID()}`,a=h(i,s);await g(a,{recursive:!0}),this.tempDirs.add(a);for(const n of t)try{const o=C(e,n),c=W(e,o),u=c&&!c.startsWith("..")?c:b(o),f=h(a,u);await g(w(f),{recursive:!0}),await y(o,f,{recursive:!0})}catch{}return{path:a,type:"temp"}}async createSnapshotWorkspace(t,r="catui-subagent-snapshot"){const e=await this.createTempWorkspace([],r,t);return this.snapshots.set(e.path,t),await y(t,e.path,{recursive:!0,force:!0,filter:m(i=>{const s=W(t,i);return s?!(s===".git"||s.startsWith(".git/")||s==="node_modules"||s.startsWith("node_modules/")||s==="dist"||s.startsWith("dist/")||s===".codex"||s.startsWith(".codex/")):!0},"filter")}),e}async createGitWorktree(t,r){const e=r??process.cwd(),i=await import("node:os").then(a=>a.tmpdir()),s=h(i,`catui-worktree-${crypto.randomUUID()}`);try{return l("git",["rev-parse","--show-toplevel"],{cwd:e,stdio:"ignore"}),l("git",t?["worktree","add","-b",t,s]:["worktree","add","--detach",s],{cwd:e,stdio:"ignore"}),this.worktrees.set(s,e),{path:s,type:"worktree"}}catch{return await d(s,{recursive:!0,force:!0}).catch(()=>{}),this.createSnapshotWorkspace(e)}}async listChangedFiles(t){return(await this.listChanges(t)).map(e=>e.path)}async listChanges(t){if(t.type==="worktree")try{return l("git",["status","--porcelain"],{cwd:t.path,encoding:"utf-8",stdio:["ignore","pipe","ignore"]}).split(`
+`).map(i=>i.trimEnd()).filter(Boolean).map(i=>this.parseGitStatusLine(i)).filter(i=>i!==null)}catch{return[]}const r=this.snapshots.get(t.path);return r?this.collectSnapshotChanges(r,t.path):[]}async writePatch(t,r){try{await g(w(r),{recursive:!0});let e="";if(t.type==="worktree")e=l("git",["diff","--binary"],{cwd:t.path,encoding:"utf-8",stdio:["ignore","pipe","ignore"]});else{const i=this.snapshots.get(t.path);if(!i)return!1;const s=await this.collectSnapshotChanges(i,t.path);e=(await Promise.all(s.map(async n=>{const o=h(i,n.path),c=h(t.path,n.path);try{return l("git",["diff","--no-index","--binary","--",o,c],{cwd:i,encoding:"utf-8",stdio:["ignore","pipe","ignore"]})}catch(u){return P(u)}}))).filter(Boolean).join(`
+`)}return e.trim()?(await x(r,e,"utf-8"),!0):!1}catch{return!1}}async applyChanges(t,r){const e=await this.listChanges(t);for(const i of e){const s=h(r,i.path),a=h(t.path,i.path);if(i.status==="deleted"){await d(s,{recursive:!0,force:!0}).catch(()=>{});continue}await g(w(s),{recursive:!0}),await y(a,s,{recursive:!0,force:!0})}return e.map(i=>({...i,path:i.path.replace(/\\/g,"/")}))}async dispose(t){if(t.type==="temp"){try{await d(t.path,{recursive:!0,force:!0})}catch{}this.tempDirs.delete(t.path),this.snapshots.delete(t.path)}else if(t.type==="worktree"){const r=this.worktrees.get(t.path)??this.resolveWorktreeOwner(t.path);if(r){const{execSync:e}=await import("node:child_process");try{e(`git worktree remove "${t.path}" --force`,{cwd:r,stdio:"ignore"})}catch{}this.worktrees.delete(t.path)}try{await d(t.path,{recursive:!0,force:!0})}catch{}}}getActiveTempDirs(){return Array.from(this.tempDirs)}async disposeAll(){await Promise.all(Array.from(this.tempDirs).map(t=>d(t,{recursive:!0,force:!0}).catch(()=>{}))),this.tempDirs.clear(),this.worktrees.clear(),this.snapshots.clear()}resolveWorktreeOwner(t){try{const r=l("git",["rev-parse","--path-format=absolute","--git-common-dir"],{cwd:t,encoding:"utf-8",stdio:["ignore","pipe","ignore"]}).trim();return r?w(r):void 0}catch{return}}parseGitStatusLine(t){const r=t.slice(0,2),e=t.slice(3).trim();if(!e)return null;const i=e.includes(" -> ")?e.split(" -> ").pop()??e:e,s=r.includes("D")?"deleted":r.includes("A")||r==="??"?"added":"modified";return{path:i,status:s}}async collectSnapshotChanges(t,r){const e=await this.collectWorkspaceFiles(t,t),i=await this.collectWorkspaceFiles(r,r),s=new Set([...e.keys(),...i.keys()]),a=[];for(const n of Array.from(s).sort()){const o=e.get(n),c=i.get(n);if(!o&&c){a.push({path:n,status:"added"});continue}if(o&&!c){a.push({path:n,status:"deleted"});continue}o&&c&&!o.equals(c)&&a.push({path:n,status:"modified"})}return a.map(n=>({...n,path:n.path.replace(/\\/g,"/")}))}async collectWorkspaceFiles(t,r){const e=new Map,i=await F(r,{withFileTypes:!0});for(const s of i){const a=h(r,s.name),n=W(t,a);if(this.shouldIgnoreRelativePath(n))continue;if(s.isDirectory()){const u=await this.collectWorkspaceFiles(t,a);for(const[f,v]of u)e.set(f,v);continue}if(!s.isFile())continue;const o=await D(a),c=await S(a);e.set(n,{size:o.size,content:c,equals(u){return this.size===u.size&&Buffer.compare(this.content,u.content)===0}})}return e}shouldIgnoreRelativePath(t){return!t||t===".git"||t.startsWith(".git/")||t===".catui"||t.startsWith(".catui/")||t==="node_modules"||t.startsWith("node_modules/")||t==="dist"||t.startsWith("dist/")||t===".codex"||t.startsWith(".codex/")}}const T=new A;export{A as WorktreeManager,T as worktreeManager};

package/dist/extensions/builtin/AGENT.md

@@ -0,0 +1,115 @@
+# extensions/builtin/
+
+> P2 | Parent: ../AGENT.md
+
+Member List
+diagnostics/index.ts: Diagnostics extension entry, subscribes to diagnostic:event, buffers session-local diagnostic records, prompts only after threshold at agent_end, registers /report-issue
+goal/index.ts: Goal extension entry, per-thread GoalController, /goal command and goal subcommand autocomplete, get_goal/create_goal/update_goal tools, turn/account lifecycle hooks, idle-continuation prompt dispatch, GOAL_MESSAGE_TYPE renderer, session_start/shutdown hooks, persistent per-thread status footer indicator
+goal/goal-types.ts: ThreadGoalStatus enum (active/paused/blocked/usage_limited/budget_limited/complete), ThreadGoal record, GoalSetMode, GoalAccountingMode, GoalTurnAccounting, GoalControllerState, validation constants
+goal/goal-store.ts: GoalStore JSON-file persistence layer; get/replace/insert/update/delete/account_usage primitives, atomic temp-file rename, status-filtered accounting modes, budget-limit auto-downgrade
+goal/goal-format.ts: formatGoalElapsedSeconds, formatTokens, goalStatusLabel, goalUsageSummary, goalSummaryLines, goalStatusIndicator, shouldConfirmBeforeReplacing, editedGoalStatus, validateObjective, validateBudget
+goal/goal-prompts.ts: buildContinuationPrompt, buildBudgetLimitPrompt, buildObjectiveUpdatedPrompt - three steering templates mirroring codex-rs prompts/templates/goals/*
+goal/goal-controller.ts: GoalController class, per-thread mutex, on_turn_start/on_token_usage/on_tool_finish/on_turn_end/on_turn_abort/on_turn_error/on_usage_limit hooks, idle continuation followUp injection, blocked-signal escalation counter, budget-limit steering emission
+goal/goal-tools.ts: get_goal/create_goal/update_goal LLM tool factories, TypeBox parameter schemas, host singleton for controller lookup, renderGoalResponse formatter
+goal/goal-parser.ts: parseGoalCommand, buildGoalHelp, getGoalArgumentCompletions for /goal subcommand autocomplete
+goal/goal-command.ts: runGoalCommand handler for /goal show/clear/edit/pause/resume/set with ConfirmIfExists dialog, multi-line summary renderer
+goal/README.md: Goal extension documentation - usage, LLM tools, lifecycle, persistence, status indicator, file-by-file architecture
+diagnostics/types.ts: Diagnostic event/report type contract and diagnostic:event channel name
+diagnostics/diagnostic-buffer.ts: DiagnosticBuffer, event coercion, fingerprint dedupe, prompt gating
+diagnostics/reporter.ts: User-approved InsForge catui_issue_events reporter, configured via CATUI_ISSUE_* env vars
+diagnostics/redaction.ts: Diagnostic message normalization and secret/path redaction helpers
+browser/index.ts: Browser Harness extension entry, registers browser/browser_admin tools, /browser command, Browser Harness resource discovery, project-local browser workspace seeding; opt-in since P6/EV03 despite physical source staying under builtin pending Q2 physical/package decision
+browser/browser.md: Browser Harness day-to-day skill instructions for Catui tool use and workspace contribution
+browser/install.md: Browser Harness setup and troubleshooting instructions, exposed as a skill resource
+browser/src/browser_harness/: Vendored Browser Harness Python package, CDP daemon, IPC bridge, admin commands, and helper functions
+browser/interaction-skills/: Reusable Browser Harness mechanics guides for browser interactions
+browser/agent-workspace/: Seed workspace copied to .catui/browser-workspace for editable helpers and domain skills
+discipline/index.ts: Engineering discipline extension entry, registers skill tool, default workflow skills, and lightweight before_agent_start bootstrap prompt
+discipline/skills/: Built-in engineering workflow skills for brainstorming, debugging, TDD, verification, planning, code review, worktrees, and branch finishing
+idle-think/index.ts: IdleThink extension entry, session lifecycle registration, activity tracking, and persistent insight prompt injection
+idle-think/idle-think-runtime.ts: IdleThink runtime boundary - state, budget reset, interval ownership, abort cleanup, exploration orchestration, insight persistence, and diagnostic reporting
+idle-think/thinker.ts: IdleThink read-only SubAgent exploration runner, project context collection, network capability detection, and exploration prompt construction
+idle-think/insights.ts: IdleThink nanomem-backed project-scoped insight storage and system prompt injection
+idle-think/curiosity.ts: IdleThink curiosity queue persistence, topic selection, dedupe, and explored-topic pruning
+link-world/index.ts: Internet access integration entry, registers link_world_admin/link_world_exec/web_search/web_fetch tools, /link-world status/doctor/version/install commands, and bundled internet-search resources
+link-world/link-world-agent.md: Agent-facing skill that tells models to prefer web_search/web_fetch and link_world_admin/link_world_exec over bash for internet tasks
+link-world/network-routing.md: Routing skill that tells models when to use web_search/web_fetch/link-world versus browser automation
+link-world/agent-workspace/: Seed workspace copied to .catui/link-world-workspace for project-local domain skills and notes
+mcp/index.ts: MCP protocol integration extension, MCP guidance resources
+presence/index.ts: AI-driven opening + idle presence lines, git/cwd snapshot, systemPrompt injection of recent presence lines, timers/debounce/idle in-flight lock, settings.presence.enabled guard, PRESENCE_MESSAGE_TYPE renderer
+presence/presence-memory.ts: Presence memory boundary - NanoMem directory/project discovery, memory-derived locale detection, randomized preference/lesson highlight selection for greeting prompts
+plan/index.ts: Plan Mode extension entry, /plan /plan:validate /plan:approve commands, EnterPlanMode/ExitPlanMode tools, permission gating, TUI status/widget, workflow prompt injection
+plan/types.ts: Plan mode types, persisted state payload, attachment variants, permission result model
+plan/plan-file-manager.ts: Plan file path management, slug generation, settings-aware plans directory, plan state hydration/serialization, resume/fork copy helpers
+plan/plan-permissions.ts: Plan mode tool permission gating, exact plan-file write checks, read-only bash allowlist, agent/tool blocking policy
+plan/plan-workflow-prompt.ts: Plan mode full/sparse workflow prompt, reentry prompt, exit prompt, EnterPlanMode/ExitPlanMode tool result text
+plan/enter-plan-mode-tool.ts: EnterPlanMode tool for model-initiated plan mode entry and UI state activation
+plan/exit-plan-mode-tool.ts: ExitPlanMode tool for user-approved plan mode exit, validation, teammate approval, UI cleanup
+plan/plan-agents.ts: Explore/Plan subagent prompt helpers and read-only tool list for plan mode
+plan/plan-validation.ts: Plan structure validation for Context, Approach, Files/Changes, and Verification sections
+plan/teammate-approval.ts: Teammate plan approval mailbox integration and approval/waiting message formatting
+subagent/index.ts: SubAgent extension entry, /subagent:/subagent:run/:stop/:status/:report/:apply commands, SUBAGENT_MESSAGE_TYPE renderer
+subagent/subagent-parser.ts: SubAgent command parsing, parseSubAgentCommand/buildSubAgentHelp
+subagent/subagent-runner.ts: SubAgent orchestration — research (read-only) and implement (isolated worktree) roles, diff preview and apply flow
+subagent/subagent-types.ts: SubAgent extension types — SubAgentPhase, SubAgentWorkerInfo, SubAgentRunState, SubAgentRunReport
+interview/index.ts: Requirement clarification extension entry, /interview and /grill-me commands, interview tool registration, custom message renderers, lightweight before_agent_start hook
+interview/interview-runtime.ts: Interview probe/runtime boundary - synchronous prompt heuristics, workspace context collection, LLM probe coercion, UI follow-up loop, refined intent injection text
+security-audit/interface.ts: Security audit interface, SecurityCheckResult/AuditEvent/SecurityEngine
+security-audit/index.ts: Security extension entry, audit logging and dangerous pattern detection
+security-audit/engine/interceptor.ts: Request/response interception, InterceptorResult confirmation flow
+security-audit/engine/logger.ts: Security event logging, JSON file audit trail
+security-audit/engine/detector.ts: Vulnerability detection, pattern matching for dangerous commands
+soul/index.ts: AI personality evolution extension, persistent personality across sessions
+grub/index.ts: Grub extension entry - autonomous iterative task runner, /grub command, dual-phase prompt injection, feature-list guard dispatch, GRUB_MESSAGE_TYPE renderer
+grub/grub-controller.ts: GrubController - drives autonomous grub iterations, durable GrubTaskState, initializer baseline capture, feature-list mutation validation
+grub/grub-decision.ts: Grub assistant protocol parser, extracts validated loop-state decisions from assistant text
+grub/grub-parser.ts: Grub command parsing, parseGrubCommand/buildGrubHelp
+grub/grub-prompts.ts: Grub prompt construction boundary, initializer/coding system prompts and per-task dispatch prompts
+grub/grub-harness.ts: Grub harness artifact boundary, .grub/<id>/ feature-list/progress-log/init.sh creation
+grub/grub-format.ts: Grub user-facing status/result formatter for readable TUI messages
+grub/grub-turn.ts: Grub turn-end coordinator, parsing assistant output, checklist gates, retry/terminal update events
+grub/grub-i18n.ts: Grub localization helper, English/Chinese prompts and TUI strings
+grub/grub-feature-list.ts: feature-list.json IO, initializer skeleton, legacy checklist migration, passes/evidence-only diff validation
+grub/grub-persistence.ts: Cross-session .grub/<id>/state.json persistence, active task discovery, stale harness pruning
+grub/grub-types.ts: Grub types, GrubStatus/GrubDecisionStatus/GrubDecision/GrubTaskState/GrubTaskSnapshot/FeatureList/PersistedGrubState
+grub/README.md: Grub extension documentation - autonomous "keep digging until done" runner without default git commits
+loop/index.ts: Loop extension entry - session-scoped recurring prompt/command scheduler with pause/resume/run-now/max-runs/quiet, /loop command + LOOP_MESSAGE_TYPE renderer
+loop/scheduler-controller.ts: SchedulerController - in-memory recurring task store with pause/resume/run-now/max-runs, MAX_SCHEDULED_TASKS=50
+loop/scheduler-parser.ts: Loop command parsing with flags/subcommands, parseSchedulerCommand/parseDurationSpec/buildSchedulerHelp, --name/--max/--quiet
+loop/scheduler-types.ts: Scheduled loop types, LoopPayloadKind/ScheduledLoopTask/LoopStartSpec/ParsedSchedulerCommand
+loop/README.md: Loop extension documentation - recurring scheduler usage and flags
+sal/index.ts: SAL extension entry, enabled by default, registers flags, /sal:* commands, lifecycle hooks including agent_result, terrain snapshot refresh, eval event emission, and stale-run cleanup scheduling; delegates config, context, runtime contracts, and tool_trace analytics to focused SAL modules
+sal/sal-config.ts: SAL build metadata, eval environment constants, credential loading, truthy parsing, stale-cleanup/A-B flag resolution, experiment id normalization, and sidecar directory resolution
+sal/sal-context.ts: SAL anchor system-prompt injection formatting plus A/B sidecar turn-record persistence
+sal/sal-runtime.ts: SAL shared BuildMeta/TurnState/SalRuntime contracts used across config, context, trace, and entry modules, including per-turn loop outcome state
+sal/sal-trace.ts: SAL tool path extraction, task intent inference, and bounded tool_trace payload construction with loop outcome summary
+sal/terrain.ts: TerrainSnapshot/TerrainNode/TerrainEdge model, buildTerrainIndex(), checkDipCoverage(), isSnapshotStale(), moduleIdForPath(), parses P2 AGENT.md and P3 file headers
+sal/anchors.ts: StructuralAnchor/AnchorResolution model, locateTask(), locateAction(), evidence-driven scoring with tunable SalWeights, CJK bigram tokenization
+sal/weights.ts: SalWeights interface, SAL_DEFAULT_WEIGHTS, loadSalWeights() reads sal-config.json from workspace or .memory-experiments/sal/
+sal/eval/index.ts: createEvalSink() factory + barrel re-exports; adapter selection via options.adapter or endpoint scheme inference (http(s)→insforge, file://|/|./|../→jsonl, missing→noop); ONLY entry point SAL imports from
+sal/eval/types.ts: EvalSink interface, EvalEventEnvelope/EvalEventType (run_start/run_end/turn_anchor), EvalAdapterId ("insforge"|"jsonl"|"noop"), CreateEvalSinkOptions with optional onDiagnostic callback, createEvalEvent factory; zero-dependency type surface
+sal/eval/noop-sink.ts: noopSink — silent EvalSink used when eval disabled or no adapter configured
+sal/eval/insforge-sink.ts: InsForgeEvalSink — PostgREST adapter, routes run_start→eval_runs INSERT (merge-duplicates) with legacy-schema fallback, writes turn_anchor/tool_trace/memory_recalls/run_end only after parent run confirmation, tool_trace→eval_tool_traces with PGRST204 fallback, memory_recalls→eval_memory_recalls batch INSERT, run_end→eval_runs PATCH; allowSelfSigned TLS option logs only in development runtime, batching with default 2000ms interval
+sal/eval/jsonl-sink.ts: JsonlEvalSink — append-only filesystem adapter, one JSON object per line, accepts file:// URLs or plain paths, auto-creates parent dir, batched writes
+sal/README.md: SAL extension usage, sidecar output layout, weights override, pluggability contract
+team/index.ts: AgentTeam extension entry, /team <task>, /team:spawn/:preset/:send/:status/:progress/:psyche/:dashboard/:task/:mail/:allow-path/:stop/:terminate/:approve/:mode command registration and dispatch
+team/team-ui.ts: AgentTeam message renderer, list/status/task formatting, dashboard visibility/timer ownership, realtime observer, speaker-stream emission helpers
+team/team-types.ts: TeammateRole/TeammateMode/TeammateStatus/TeamTask/HarnessState/PsycheWeights/TeamUtterance/Handoff/LeaderPlan/AgentLiveView/TeammateIdentity/PersistedTeammate/TeamSpawnSpec/TeamSendResult types
+team/team-state-store.ts: TeamStateStore class - durable teammate persistence via JSON files in <agentDir>/teams/
+team/team-parser.ts: Team command parser - parseTeamCommand/buildTeamHelp for /team:* subcommands
+team/team-runtime.ts: TeamRuntime class - teammate registry, stable internal labels plus visible teammate names, per-teammate send queue, lifecycle, durable tasks, mailbox + permission + transcript wiring
+team/team-runtime-helpers.ts: TeamRuntime helper boundary - teammate prompt construction, harness turn preparation, live event projection, tool selection, path guards, label/role/text helpers
+team/team-orchestrator.ts: Leader orchestration helpers - plan building, speaker utterance creation, @mention parsing, and handoff execution
+team/team-task-store.ts: TeamTaskStore class - durable shared task list in <storageDir>/tasks.json
+team/team-harness.ts: Harness protocol helpers - context files, phase instructions, checkpoint/revert, feature validation
+team/team-presets.ts: Preset definitions and executor - solo/duo/squad spawning, model-assisted auto team selection, heuristic fallback
+team/team-dashboard.ts: Text dashboard/status rendering - teammate workbench cards, current task, last utterance, progress bars, footer summary
+team/team-psyche.ts: Psyche prompt layer - role/phase weighted Id/Ego/Superego prompt construction
+team/team-permissions.ts: PermissionStore - pending permission request queue, approve/deny, path allowlists
+team/team-mailbox.ts: TeamMailbox - typed JSONL-backed append-only message log for leader↔teammate and teammate↔teammate
+team/team-transcript.ts: TeamTranscriptWriter - per-teammate JSONL transcripts
+team/TESTING.md: Manual & smoke-test guide for Phase B AgentTeam
+
+Rule: Members complete, one item per line, parent links valid, precise terms first
+
+[COVENANT]: Update this file header on changes and verify against parent AGENT.md

package/dist/extensions/builtin/ask-user-question/ask-user-question-tool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [WHO]: createAskUserQuestionTool()
+ * [FROM]: 1:1 ported from Claude Code AskUserQuestion tool; depends on ./prompt, ./types, extension types
+ * [TO]: Consumed by ./index.ts
+ * [HERE]: extensions/builtin/ask-user-question/ask-user-question-tool.ts - tool definition + UI interaction
+ */
+import type { ToolDefinition } from "../../../core/extensions-host/types.js";
+import { AskUserQuestionInputSchema, type AskUserQuestionOutput } from "./types.js";
+export declare function createAskUserQuestionTool(): ToolDefinition<typeof AskUserQuestionInputSchema, AskUserQuestionOutput>;

package/dist/extensions/builtin/ask-user-question/ask-user-question-tool.js

@@ -0,0 +1,4 @@
+var m=Object.defineProperty;var a=(n,e)=>m(n,"name",{value:e,configurable:!0});import{Container as p,Text as u}from"@catui/tui";import{ASK_USER_QUESTION_TOOL_CHIP_WIDTH as f,ASK_USER_QUESTION_TOOL_PROMPT as $,DESCRIPTION as U}from"./prompt.js";import{AskUserQuestionInputSchema as C,validateUniqueness as O}from"./types.js";function g(n,e){return`User has answered your questions: ${Object.entries(n).map(([s,o])=>{const r=e?.[s],i=[`"${s}"="${o}"`];return r?.preview&&i.push(`selected preview:
+${r.preview}`),r?.notes&&i.push(`user notes: ${r.notes}`),i.join(" ")}).join(", ")}. You can now continue with the user's answers in mind.`}a(g,"formatResultText");function T(n,e){return`${n} \u2014 ${e}`}a(T,"buildOptionDisplayLabel");function b(n){const e=n.indexOf(" \u2014 ");return e>=0?n.substring(0,e):n}a(b,"extractLabelFromDisplay");function v(n){const t=[`${`[${n.header.slice(0,f)}]`} ${n.question}`,""];for(const s of n.options)t.push(`${s.label}: ${s.description}`),s.preview&&(t.push(""),t.push("```"),t.push(s.preview),t.push("```"));return t.join(`
+`)}a(v,"buildQuestionTitle");async function A(n,e){const s=`${`[${e.header.slice(0,f)}]`} ${e.question}`,o=e.options.map(i=>T(i.label,i.description));o.push("Other (custom answer)");const r=await n.ui.select(s,o);if(r===void 0)throw new Error(`User declined to answer: "${e.question}"`);if(r==="Other (custom answer)"){const i=await n.ui.input(`Custom answer for: ${e.question}`);if(i===void 0)throw new Error(`User declined to answer: "${e.question}"`);return i}return b(r)}a(A,"askSingleSelect");async function S(n,e){const t=[];for(const o of e.options)await n.ui.confirm(e.header,`Enable: ${o.label} \u2014 ${o.description}?`)&&t.push(o.label);if(await n.ui.confirm(e.header,"Add a custom answer?")){const o=await n.ui.input(`Custom answer for: ${e.question}`);o!==void 0&&o.trim().length>0&&t.push(o.trim())}if(t.length===0)throw new Error(`User declined to answer: "${e.question}"`);return t.join(", ")}a(S,"askMultiSelect");function _(n,e){const t=new p,s=n.questions??[];if(t.addChild(new u(e.fg("toolTitle",e.bold("AskUserQuestion")),0,0)),s.length===0)return t.addChild(new u(e.fg("toolOutput","  (no questions)"),0,0)),t;for(const o of s){t.addChild(new u("",0,0));const r=`[${o.header.slice(0,f)}]`;t.addChild(new u(e.fg("accent",e.bold(r))+" "+e.fg("text",o.question),0,0))}return t}a(_,"renderCallForAskUserQuestion");function I(n,e,t){const s=new p,r=n.details;if(!r){const c=n.content?.filter(d=>d.type==="text").map(d=>d.text).join(`
+`);return c&&s.addChild(new u(t.fg("toolOutput",c),0,0)),s}const{answers:i}=r;for(const[c,d]of Object.entries(i)){const w=t.fg("muted","Q: ")+t.fg("text",c);s.addChild(new u(w,0,0));const l=t.fg("muted","A: ")+t.fg("success",d);s.addChild(new u(l,0,0)),s.addChild(new u("",0,0))}return s}a(I,"renderResultForAskUserQuestion");function y(){return{name:"AskUserQuestion",label:"AskUserQuestion",description:U,parameters:C,isConcurrencySafe:!0,guidance:$,validateInput(n){const e=O(n.questions);if(e)return e},renderCall:_,renderResult:I,async execute(n,e,t,s,o){if(!o?.hasUI)throw new Error("AskUserQuestion requires an interactive UI session.");const{questions:r}=e,i={},c={};for(const l of r){const h=l.multiSelect===!0?await S(o,l):await A(o,l);i[l.question]=h}const d={questions:r,answers:i,annotations:c};return{content:[{type:"text",text:g(i,c)}],details:d}}}}a(y,"createAskUserQuestionTool");export{y as createAskUserQuestionTool};

package/dist/extensions/builtin/ask-user-question/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: askUserQuestionExtension - registers AskUserQuestion tool
+ * [FROM]: Depends on ./ask-user-question-tool
+ * [TO]: Auto-loaded by builtin-extensions.ts as a default extension
+ * [HERE]: extensions/builtin/ask-user-question/index.ts - extension entry point
+ */
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+export default function askUserQuestionExtension(api: ExtensionAPI): Promise<void>;

package/dist/extensions/builtin/ask-user-question/index.js

@@ -0,0 +1 @@
+var t=Object.defineProperty;var o=(e,s)=>t(e,"name",{value:s,configurable:!0});import{createAskUserQuestionTool as r}from"./ask-user-question-tool.js";async function n(e){e.registerTool(r())}o(n,"askUserQuestionExtension");export{n as default};

package/dist/extensions/builtin/ask-user-question/prompt.d.ts

@@ -0,0 +1,14 @@
+/**
+ * [WHO]: ASK_USER_QUESTION_TOOL_NAME, DESCRIPTION, ASK_USER_QUESTION_TOOL_PROMPT, PREVIEW_FEATURE_PROMPT
+ * [FROM]: 1:1 ported from Claude Code AskUserQuestion tool prompt constants
+ * [TO]: Consumed by ./ask-user-question-tool.ts
+ * [HERE]: extensions/builtin/ask-user-question/prompt.ts - tool name, description, and guidance text
+ */
+export declare const ASK_USER_QUESTION_TOOL_NAME = "AskUserQuestion";
+export declare const ASK_USER_QUESTION_TOOL_CHIP_WIDTH = 12;
+export declare const DESCRIPTION = "Asks the user multiple choice questions to gather information, clarify ambiguity, understand preferences, make decisions or offer them choices.";
+export declare const PREVIEW_FEATURE_PROMPT: {
+    markdown: string;
+    html: string;
+};
+export declare const ASK_USER_QUESTION_TOOL_PROMPT = "Use this tool when you need to ask the user questions during execution. This allows you to:\n1. Gather user preferences or requirements\n2. Clarify ambiguous instructions\n3. Get decisions on implementation choices as you work\n4. Offer choices to the user about what direction to take.\n\nUsage notes:\n- Users will always be able to select \"Other\" to provide custom text input\n- Use multiSelect: true to allow multiple answers to be selected for a question\n- If you recommend a specific option, make that the first option in the list and add \"(Recommended)\" at the end of the label\n\nPlan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask \"Is my plan ready?\" or \"Should I proceed?\" - use ExitPlanMode for plan approval. IMPORTANT: Do not reference \"the plan\" in your questions (e.g., \"Do you have feedback about the plan?\", \"Does the plan look good?\") because the user cannot see the plan in the UI until you call ExitPlanMode. If you need plan approval, use ExitPlanMode instead.\n";

package/dist/extensions/builtin/ask-user-question/prompt.js

@@ -0,0 +1,30 @@
+const e="AskUserQuestion",t=12,o="Asks the user multiple choice questions to gather information, clarify ambiguity, understand preferences, make decisions or offer them choices.",s={markdown:`
+Preview feature:
+Use the optional \`preview\` field on options when presenting concrete artifacts that users need to visually compare:
+- ASCII mockups of UI layouts or components
+- Code snippets showing different implementations
+- Diagram variations
+- Configuration examples
+
+Preview content is rendered as markdown in a monospace box. Multi-line text with newlines is supported. When any option has a preview, the UI switches to a side-by-side layout with a vertical option list on the left and preview on the right. Do not use previews for simple preference questions where labels and descriptions suffice. Note: previews are only supported for single-select questions (not multiSelect).
+`,html:`
+Preview feature:
+Use the optional \`preview\` field on options when presenting concrete artifacts that users need to visually compare:
+- HTML mockups of UI layouts or components
+- Formatted code snippets showing different implementations
+- Visual comparisons or diagrams
+
+Preview content must be a self-contained HTML fragment (no <html>/<body> wrapper, no <script> or <style> tags \u2014 use inline style attributes instead). Do not use previews for simple preference questions where labels and descriptions suffice. Note: previews are only supported for single-select questions (not multiSelect).
+`},n=`Use this tool when you need to ask the user questions during execution. This allows you to:
+1. Gather user preferences or requirements
+2. Clarify ambiguous instructions
+3. Get decisions on implementation choices as you work
+4. Offer choices to the user about what direction to take.
+
+Usage notes:
+- Users will always be able to select "Other" to provide custom text input
+- Use multiSelect: true to allow multiple answers to be selected for a question
+- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
+
+Plan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?" - use ExitPlanMode for plan approval. IMPORTANT: Do not reference "the plan" in your questions (e.g., "Do you have feedback about the plan?", "Does the plan look good?") because the user cannot see the plan in the UI until you call ExitPlanMode. If you need plan approval, use ExitPlanMode instead.
+`;export{t as ASK_USER_QUESTION_TOOL_CHIP_WIDTH,e as ASK_USER_QUESTION_TOOL_NAME,n as ASK_USER_QUESTION_TOOL_PROMPT,o as DESCRIPTION,s as PREVIEW_FEATURE_PROMPT};

package/dist/extensions/builtin/ask-user-question/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * [WHO]: QuestionOption, Question, AskUserQuestionInput, AskUserQuestionOutput, schema definitions
+ * [FROM]: 1:1 ported from Claude Code AskUserQuestion Zod schemas → TypeBox
+ * [TO]: Consumed by ./ask-user-question-tool.ts
+ * [HERE]: extensions/builtin/ask-user-question/types.ts - TypeBox schemas for AskUserQuestion tool
+ */
+import { type Static } from "@sinclair/typebox";
+export declare const QuestionOptionSchema: import("@sinclair/typebox").TObject<{
+    label: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TString;
+    preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type QuestionOption = Static<typeof QuestionOptionSchema>;
+export declare const QuestionSchema: import("@sinclair/typebox").TObject<{
+    question: import("@sinclair/typebox").TString;
+    header: import("@sinclair/typebox").TString;
+    options: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        label: import("@sinclair/typebox").TString;
+        description: import("@sinclair/typebox").TString;
+        preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+    multiSelect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export type Question = Static<typeof QuestionSchema>;
+export declare const AnnotationsSchema: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+    preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    notes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>>>;
+export type Annotations = Static<typeof AnnotationsSchema>;
+export declare const AskUserQuestionInputSchema: import("@sinclair/typebox").TObject<{
+    questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        question: import("@sinclair/typebox").TString;
+        header: import("@sinclair/typebox").TString;
+        options: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            label: import("@sinclair/typebox").TString;
+            description: import("@sinclair/typebox").TString;
+            preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>>;
+        multiSelect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    }>>;
+    answers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>>;
+    annotations: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+        preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        notes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        source: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+}>;
+export type AskUserQuestionInput = Static<typeof AskUserQuestionInputSchema>;
+export declare const AskUserQuestionOutputSchema: import("@sinclair/typebox").TObject<{
+    questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        question: import("@sinclair/typebox").TString;
+        header: import("@sinclair/typebox").TString;
+        options: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            label: import("@sinclair/typebox").TString;
+            description: import("@sinclair/typebox").TString;
+            preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>>;
+        multiSelect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    }>>;
+    answers: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>;
+    annotations: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+        preview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        notes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>>;
+}>;
+export type AskUserQuestionOutput = Static<typeof AskUserQuestionOutputSchema>;
+export declare function validateUniqueness(questions: Question[]): string | null;

package/dist/extensions/builtin/ask-user-question/types.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var s=(t,o)=>l(t,"name",{value:o,configurable:!0});import{Type as e}from"@sinclair/typebox";const p=e.Object({label:e.String({description:"The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice."}),description:e.String({description:"Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications."}),preview:e.Optional(e.String({description:"Optional preview content rendered when this option is focused. Use for mockups, code snippets, or visual comparisons that help users compare options. See the tool description for the expected content format."}))}),r=e.Object({question:e.String({description:'The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"'}),header:e.String({description:'Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".'}),options:e.Array(p,{minItems:2,maxItems:4,description:"The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically."}),multiSelect:e.Optional(e.Boolean({default:!1,description:"Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive."}))}),u=e.Object({preview:e.Optional(e.String({description:"The preview content of the selected option, if the question used previews."})),notes:e.Optional(e.String({description:"Free-text notes the user added to their selection."}))}),a=e.Optional(e.Record(e.String(),u,{description:"Optional per-question annotations from the user (e.g., notes on preview selections). Keyed by question text."})),m=e.Object({questions:e.Array(r,{minItems:1,maxItems:4,description:"Questions to ask the user (1-4 questions)"}),answers:e.Optional(e.Record(e.String(),e.String(),{description:"User answers collected by the permission component"})),annotations:a,metadata:e.Optional(e.Object({source:e.Optional(e.String({description:'Optional identifier for the source of this question (e.g., "remember" for /remember command). Used for analytics tracking.'}))},{description:"Optional metadata for tracking and analytics purposes. Not displayed to user."}))}),f=e.Object({questions:e.Array(r,{description:"The questions that were asked"}),answers:e.Record(e.String(),e.String(),{description:"The answers provided by the user (question text -> answer string; multi-select answers are comma-separated)"}),annotations:a});function b(t){const o=t.map(i=>i.question);if(o.length!==new Set(o).size)return"Question texts must be unique, option labels must be unique within each question";for(const i of t){const n=i.options.map(c=>c.label);if(n.length!==new Set(n).size)return"Question texts must be unique, option labels must be unique within each question"}return null}s(b,"validateUniqueness");export{a as AnnotationsSchema,m as AskUserQuestionInputSchema,f as AskUserQuestionOutputSchema,p as QuestionOptionSchema,r as QuestionSchema,b as validateUniqueness};

package/dist/extensions/builtin/browser/AGENT.md

@@ -0,0 +1,17 @@
+# extensions/builtin/browser/
+
+> P2 | Parent: ../AGENT.md
+
+Member List
+index.ts: Browser Harness extension entry, registers browser/browser_admin tools, /browser command, Browser Harness resource discovery for core/interaction/domain skills, project-local browser workspace seeding; loaded only through explicit extension config/CLI opt-in since P6/EV03
+browser.md: Browser Harness day-to-day skill instructions for Catui tool use and workspace contribution
+install.md: Browser Harness setup and troubleshooting instructions, exposed as a skill resource
+src/browser_harness/: Vendored Browser Harness Python package, CDP daemon, IPC bridge, admin commands, and helper functions
+src/browser_harness/AGENT.md: P2 module map for the vendored Browser Harness Python package
+interaction-skills/: Reusable Browser Harness mechanics guides for tabs, screenshots, iframes, cookies, uploads, dialogs, scrolling, and related browser interactions
+agent-workspace/: Seed workspace copied to .catui/browser-workspace for editable helpers and domain skills
+.env.example: Browser Harness environment variable template for Browser Use cloud integration
+
+Rule: Members complete, one item per line, parent links valid, precise terms first
+
+[COVENANT]: Update this file header on changes and verify against parent AGENT.md

package/dist/extensions/builtin/browser/agent-workspace/agent_helpers.py

@@ -0,0 +1,12 @@
+"""Agent-editable browser helpers.
+
+Add task-specific browser primitives here. Core helpers from browser_harness.helpers
+load this file when BH_AGENT_WORKSPACE points at this directory, or when this
+repo's default agent-workspace exists.
+
+[WHO]: Provides project-local extension points for reusable Browser Harness helper functions
+[FROM]: Depends on browser_harness.helpers importing this file through BH_AGENT_WORKSPACE
+[TO]: Consumed by browser snippets after NanoPencil seeds .nanopencil/browser-workspace
+[HERE]: extensions/defaults/browser/agent-workspace/agent_helpers.py seed copied into project browser workspace
+"""
+