catui-agent 1.0.0-beta.0

package/dist/extensions/builtin/team/team-runtime.js

@@ -0,0 +1,3 @@
+var M=Object.defineProperty;var d=(g,a)=>M(g,"name",{value:a,configurable:!0});import{SubAgentRuntime as $,InProcessSubAgentBackend as D}from"../../../core/sub-agent/index.js";import{createAgentSession as E}from"../../../core/runtime/sdk.js";import{WorktreeManager as L}from"../../../core/workspace/index.js";import{isAbsolute as B,join as _,resolve as S}from"node:path";import{TeamStateStore as F}from"./team-state-store.js";import{PermissionStore as U}from"./team-permissions.js";import{TeamMailbox as R}from"./team-mailbox.js";import{TeamTaskStore as V}from"./team-task-store.js";import{TeamTranscriptWriter as W}from"./team-transcript.js";import{createInitialHarnessState as Q,inspectHarnessExit as q}from"./team-harness.js";import{computePsycheWeights as j}from"./team-psyche.js";import{applyLiveEvent as G,buildTeammatePrompt as H,createWritePathGuard as O,ensureLiveView as w,getDefaultModeForRole as z,indexFromLabel as J,isBuilderRole as b,labelFromIndex as K,normalizePath as X,prepareHarnessTurn as Y,selectToolsForMode as T,singleLine as x,summarizeTask as Z,tailText as N}from"./team-runtime-helpers.js";class ht{static{d(this,"TeamRuntime")}store;worktreeManager;subAgentRuntime;permissions;mailbox;tasks;transcripts;teammates=new Map;sendQueues=new Map;loaded=!1;nameCounter=0;labelCounter=0;soulManager;constructor(a={}){this.store=new F(a.storageDir),this.worktreeManager=new L,this.subAgentRuntime=new $(new D(E)),this.permissions=new U,this.mailbox=new R(1e3,_(this.store.directory,"mailbox.jsonl")),this.tasks=new V(this.store.directory),this.transcripts=new W(this.store.directory)}getPermissionStore(){return this.permissions}getMailbox(){return this.mailbox}getTaskStore(){return this.tasks}setSoulManager(a){this.soulManager=a}async load(){if(this.loaded)return;const a=await this.store.loadAll();await this.mailbox.load(),await this.tasks.load();for(const t of a){if(t.status==="terminated"){await this.store.remove(t.identity.id);continue}let s;if(t.worktreePath)try{const{stat:e}=await import("node:fs/promises");await e(t.worktreePath),s={path:t.worktreePath,type:await this.detectWorkspaceType(t.worktreePath)}}catch{t.worktreePath=void 0,t.worktreeBranch=void 0}t.status==="running"&&(t.status="idle"),t.identity.label||(t.identity.label=this.generateLabel(),await this.store.save(t)),this.bumpNameCounter(t.identity.name,t.identity.role),this.bumpLabelCounter(t.identity.label),t.liveView=w(t.liveView,t.identity);const i={state:t,abortController:new AbortController,worktree:s};this.teammates.set(t.identity.id,i),this.teammates.set(t.identity.name,i),this.teammates.set(t.identity.label,i)}this.loaded=!0}async spawn(a){await this.ensureLoaded();let t=a.name?.trim();t?this.findByName(t)&&(t=this.generateName(a.role)):t=this.generateName(a.role);let s;b(a.role)&&(s=await this.worktreeManager.createGitWorktree(void 0,a.baseCwd));const i={id:crypto.randomUUID(),label:this.generateLabel(),name:t,role:a.role,createdAt:Date.now()},e=a.mode??(a.harnessEnabled&&b(a.role)?"execute":z(a.role)),o={identity:i,mode:e,status:"idle",cwd:s?.path??a.baseCwd,worktreePath:s?.path,worktreeBranch:void 0,messages:[],lastActiveAt:Date.now(),psycheOverrides:a.psycheOverrides,liveView:w(void 0,i)};a.harnessEnabled&&(o.harness=Q()),(a.psycheOverrides||a.role==="verifier"||a.role==="data-analyst")&&(o.psyche=j("verify",a.role,void 0,a.psycheOverrides));const m={state:o,abortController:new AbortController,worktree:s};return this.teammates.set(i.id,m),this.teammates.set(i.name,m),this.teammates.set(i.label,m),await this.store.save(o),o}async send(a,t,s,i={}){await this.ensureLoaded();const e=this.findByName(a);if(!e)return{teammateId:"",teammateName:a,success:!1,response:"",error:`Teammate "${a}" not found`,durationMs:0};const o=this.sendQueues.get(e.state.identity.id);o&&(i.onEvent?.({type:"teammate_status",teammate:e.state,event:`Queued message for ${e.state.identity.name}.`}),this.mailbox.post({teammateId:e.state.identity.id,teammateName:e.state.identity.name,type:"task_progress",direction:"leader_to_teammate",payload:{status:"queued",content:t}}));const m=(o??Promise.resolve()).catch(()=>{}).then(async()=>{const y=Date.now(),k=new AbortController;e.currentTurnAbortController=k;const C={id:crypto.randomUUID(),timestamp:y,direction:"leader",content:t};e.state.messages.push(C),e.state.liveView={...w(e.state.liveView,e.state.identity),currentTask:Z(t),progress:"assigned"},e.state.status="running",e.state.lastActiveAt=y,await this.store.save(e.state),i.onEvent?.({type:"teammate_status",teammate:e.state,event:`Started ${e.state.identity.name} (${e.state.identity.role}) in ${e.state.mode} mode.`}),this.mailbox.post({teammateId:e.state.identity.id,teammateName:e.state.identity.name,type:"task_request",direction:"leader_to_teammate",payload:{content:t}}),await this.transcripts.append(e.state.identity.id,{timestamp:y,kind:"leader",content:t});const A=H({state:e.state,teammates:this.getAllTeammates(),tasks:await this.tasks.list(),mailboxMessages:this.mailbox.list(e.state.identity.id).slice(-12)}),p=await Y({teammate:e,taskDescription:t,soulManager:this.soulManager}),I=p?[A,p.psychePrompt,p.harnessInstructions].join(`
+
+`):A,P=T({mode:e.state.mode,cwd:e.state.cwd,getAllTeammates:d(()=>this.getAllTeammates(),"getAllTeammates"),isPathAllowed:d((l,c)=>this.permissions.isPathAllowed(l,c),"isPathAllowed")});try{const l={prompt:I,tools:P,cwd:e.state.cwd,signal:k.signal,model:s,contextFiles:p?.contextFiles,onEvent:d(f=>{G(e,f),i.onEvent?.({type:"teammate_live",teammate:e.state,event:f})},"onEvent"),exitHook:p?async f=>{if(!e.state.harness)return;const h=await q(e.state.harness,e.state.cwd,f);e.state.harness=h.harness,i.onEvent?.({type:"harness_event",teammate:e.state,event:h.event}),this.mailbox.post({teammateId:e.state.identity.id,teammateName:e.state.identity.name,type:"task_result",direction:"teammate_to_leader",payload:{success:h.violations.length===0,content:h.event,error:h.violations.length?h.violations.join("; "):void 0}})}:void 0},c=await this.subAgentRuntime.spawn(l);e.handle=c;const r=await c.result(),u=Date.now()-y,n={id:crypto.randomUUID(),timestamp:Date.now(),direction:"teammate",content:r.success?r.response??"":r.error??"Error",aborted:!r.success&&r.error==="Aborted",error:r.success?void 0:r.error};return e.state.messages.push(n),e.state.status=r.success?"idle":n.aborted?"stopped":"error",!r.success&&r.error&&!n.aborted?e.state.lastError=r.error:e.state.lastError=void 0,e.state.lastActiveAt=Date.now(),e.state.live=void 0,e.state.liveView={...w(e.state.liveView,e.state.identity),lastUtterance:N(x(n.content),200),progress:r.success?"done":n.aborted?"stopped":"error"},await this.store.save(e.state),i.onEvent?.({type:"teammate_status",teammate:e.state,event:r.success?`Finished ${e.state.identity.name}.`:`Failed ${e.state.identity.name}: ${r.error??"Unknown error"}`}),this.mailbox.post({teammateId:e.state.identity.id,teammateName:e.state.identity.name,type:"task_result",direction:"teammate_to_leader",payload:{success:r.success,content:n.content,error:r.error,aborted:n.aborted}}),await this.transcripts.append(e.state.identity.id,{timestamp:Date.now(),kind:"teammate",content:n.content,meta:{success:r.success,aborted:n.aborted}}),{teammateId:e.state.identity.id,teammateName:a,success:r.success,response:n.content,aborted:n.aborted,error:r.error,durationMs:u}}catch(l){const c=Date.now()-y,r=l instanceof Error?l.message:String(l),u={id:crypto.randomUUID(),timestamp:Date.now(),direction:"teammate",content:`Error: ${r}`,error:r};return e.state.messages.push(u),e.state.status=r==="Aborted"?"stopped":"error",e.state.lastError=r==="Aborted"?void 0:r,e.state.lastActiveAt=Date.now(),e.state.live=void 0,e.state.liveView={...w(e.state.liveView,e.state.identity),lastUtterance:N(x(u.content),200),progress:r==="Aborted"?"stopped":"error"},await this.store.save(e.state),i.onEvent?.({type:"teammate_status",teammate:e.state,event:`Failed ${e.state.identity.name}: ${r}`}),this.mailbox.post({teammateId:e.state.identity.id,teammateName:e.state.identity.name,type:"task_result",direction:"teammate_to_leader",payload:{success:!1,content:u.content,error:r,aborted:r==="Aborted"}}),await this.transcripts.append(e.state.identity.id,{timestamp:Date.now(),kind:"teammate",content:u.content,meta:{success:!1,aborted:r==="Aborted",error:r}}),{teammateId:e.state.identity.id,teammateName:a,success:!1,response:"",error:r,durationMs:c}}finally{e.currentTurnAbortController=void 0,e.handle=void 0}}),v=m.then(()=>{},()=>{}).finally(()=>{this.sendQueues.get(e.state.identity.id)===v&&this.sendQueues.delete(e.state.identity.id)});return this.sendQueues.set(e.state.identity.id,v),m}async stop(a){await this.ensureLoaded();const t=this.findByName(a);return t?(t.currentTurnAbortController&&t.currentTurnAbortController.abort(),t.handle&&await t.handle.abort(),t.state.status="stopped",await this.store.save(t.state),!0):!1}async terminate(a){await this.ensureLoaded();const t=this.findByName(a);return t?(t.currentTurnAbortController&&t.currentTurnAbortController.abort(),t.handle&&await t.handle.terminate(),t.worktree&&await this.worktreeManager.dispose(t.worktree),this.permissions.cancelForTeammate(t.state.identity.id),this.permissions.clearPaths(t.state.identity.id),this.mailbox.clearTeammate(t.state.identity.id),await this.transcripts.remove(t.state.identity.id),t.state.status="terminated",await this.store.save(t.state),await this.store.remove(t.state.identity.id),this.teammates.delete(t.state.identity.id),this.teammates.delete(t.state.identity.name),this.teammates.delete(t.state.identity.label),!0):!1}async setMode(a,t){await this.ensureLoaded();const s=this.findByName(a);if(!s)return{ok:!1,error:"not_found"};if(!(t==="execute"&&b(s.state.identity.role)&&s.state.mode!=="execute"))return s.state.mode=t,await this.store.save(s.state),this.mailbox.post({teammateId:s.state.identity.id,teammateName:s.state.identity.name,type:"mode_change",direction:"leader_to_teammate",payload:{mode:t}}),{ok:!0};const{id:e,decision:o}=this.permissions.request(s.state.identity.id,s.state.identity.name,"mode_change_to_execute",`Allow ${s.state.identity.name} to enter execute mode (sandboxed write in ${s.state.cwd})`);return this.mailbox.post({teammateId:s.state.identity.id,teammateName:s.state.identity.name,type:"permission_request",direction:"teammate_to_leader",payload:{requestId:e,action:"mode_change_to_execute"}}),o.then(async m=>{m&&(s.state.mode=t,await this.store.save(s.state)),this.mailbox.post({teammateId:s.state.identity.id,teammateName:s.state.identity.name,type:"permission_response",direction:"leader_to_teammate",payload:{requestId:e,approved:m}}),m&&this.mailbox.post({teammateId:s.state.identity.id,teammateName:s.state.identity.name,type:"mode_change",direction:"leader_to_teammate",payload:{mode:t}})}),{ok:!0,pending:{requestId:e}}}approvePermission(a){return this.permissions.approve(a)}denyPermission(a){return this.permissions.deny(a)}async addTask(a){const t=await this.tasks.create({title:a});return this.mailbox.post({teammateId:"team",teammateName:"team",type:"task_update",direction:"leader_to_teammate",payload:{action:"add",task:t}}),t}async claimTask(a,t){await this.ensureLoaded();const s=this.findByName(t);if(!s)return;const i=await this.tasks.claim(a,s.state.identity.id,s.state.identity.name);return i&&this.mailbox.post({teammateId:s.state.identity.id,teammateName:s.state.identity.name,type:"task_claim",direction:"leader_to_teammate",payload:{task:i}}),i}async updateTaskStatus(a,t){const s=await this.tasks.update(a,{status:t});return s&&this.mailbox.post({teammateId:s.ownerId??"team",teammateName:s.ownerName??"team",type:"task_update",direction:"leader_to_teammate",payload:{action:t,task:s}}),s}async listTasks(){return this.tasks.list()}async sendTeammateMail(a,t,s){await this.ensureLoaded();const i=this.findByName(a),e=this.findByName(t);return!i||!e?!1:(this.mailbox.post({teammateId:i.state.identity.id,teammateName:i.state.identity.name,targetTeammateId:e.state.identity.id,targetTeammateName:e.state.identity.name,type:"teammate_message",direction:"teammate_to_teammate",payload:{content:s}}),await this.transcripts.append(i.state.identity.id,{timestamp:Date.now(),kind:"event",content:`To ${e.state.identity.name}: ${s}`}),await this.transcripts.append(e.state.identity.id,{timestamp:Date.now(),kind:"event",content:`From ${i.state.identity.name}: ${s}`}),!0)}async allowPath(a,t){await this.ensureLoaded();const s=this.findByName(a);if(!s)return;const i=X(B(t)?t:S(s.state.cwd,t));return this.permissions.allowPath(s.state.identity.id,i),this.mailbox.post({teammateId:s.state.identity.id,teammateName:s.state.identity.name,type:"permission_response",direction:"leader_to_teammate",payload:{action:"write_path",path:i,approved:!0}}),i}getAllTeammates(){const a=new Set,t=[];for(const s of this.teammates.values())a.has(s.state.identity.id)||(a.add(s.state.identity.id),t.push(s.state));return t.sort((s,i)=>s.identity.createdAt-i.identity.createdAt)}getTeammate(a){return this.findByName(a)?.state}async dispose(){for(const a of this.teammates.values())a.currentTurnAbortController&&a.currentTurnAbortController.abort(),a.handle&&await a.handle.terminate().catch(()=>{});await this.subAgentRuntime.terminateAll()}async ensureLoaded(){this.loaded||await this.load()}findByName(a){return this.teammates.get(a)}generateName(a){let t;do this.nameCounter++,t=`${a}-${this.nameCounter}`;while(this.findByName(t));return t}generateLabel(){let a="";do this.labelCounter++,a=K(this.labelCounter);while(this.teammates.has(a));return a}bumpNameCounter(a,t){const s=new RegExp(`^${t}-(\\d+)$`).exec(a);if(!s)return;const i=Number.parseInt(s[1]??"",10);Number.isFinite(i)&&(this.nameCounter=Math.max(this.nameCounter,i))}bumpLabelCounter(a){const t=J(a);t>0&&(this.labelCounter=Math.max(this.labelCounter,t))}async detectWorkspaceType(a){try{const{stat:t}=await import("node:fs/promises");return await t(_(a,".git")),"worktree"}catch{return"temp"}}selectTools(a,t){return T({mode:a,cwd:t,getAllTeammates:d(()=>this.getAllTeammates(),"getAllTeammates"),isPathAllowed:d((s,i)=>this.permissions.isPathAllowed(s,i),"isPathAllowed")})}createWritePathGuard(a){return O({cwd:a,getAllTeammates:d(()=>this.getAllTeammates(),"getAllTeammates"),isPathAllowed:d((t,s)=>this.permissions.isPathAllowed(t,s),"isPathAllowed")})}}export{ht as TeamRuntime};

package/dist/extensions/builtin/team/team-state-store.d.ts

@@ -0,0 +1,29 @@
+/**
+ * [WHO]: TeamStateStore class — durable teammate persistence
+ * [FROM]: Depends on node:fs/promises, node:path, node:os, ./team-types
+ * [TO]: Consumed by team-runtime.ts
+ * [HERE]: extensions/builtin/team/team-state-store.ts - one JSON file per teammate under <agentDir>/teams/
+ *
+ * Deliberately independent of core SessionManager. Per refactor plan:
+ * "team-state-store 自己负责 teammate 历史 ... SessionManager 只负责主会话".
+ */
+import type { PersistedTeammate } from "./team-types.js";
+/**
+ * Resolve the agent dir using the canonical getAgentDir() from config.ts.
+ * Previously used NANOPENCIL_AGENT_DIR env directly (wrong name — should be
+ * CATUI_CODING_AGENT_DIR). Now reuses the single source of truth.
+ */
+export declare class TeamStateStore {
+    private readonly dir;
+    constructor(storageDir?: string);
+    /** Absolute storage directory for teammates. */
+    get directory(): string;
+    private fileFor;
+    private ensureDir;
+    /** Load all persisted teammates. Skips corrupt files. */
+    loadAll(): Promise<PersistedTeammate[]>;
+    /** Save (overwrite) one teammate record. */
+    save(state: PersistedTeammate): Promise<void>;
+    /** Remove a teammate's persisted file. No-op if missing. */
+    remove(id: string): Promise<void>;
+}

package/dist/extensions/builtin/team/team-state-store.js

@@ -0,0 +1,2 @@
+var c=Object.defineProperty;var n=(e,t)=>c(e,"name",{value:t,configurable:!0});import{mkdir as d,readFile as u,readdir as h,rm as f,writeFile as y}from"node:fs/promises";import{join as i}from"node:path";import{getAgentDir as l}from"../../../config.js";class g{static{n(this,"TeamStateStore")}dir;constructor(t){this.dir=t??i(l(),"teams")}get directory(){return this.dir}fileFor(t){return i(this.dir,`${t}.json`)}async ensureDir(){await d(this.dir,{recursive:!0})}async loadAll(){await this.ensureDir();let t;try{t=await h(this.dir)}catch{return[]}const r=[];for(const s of t)if(s.endsWith(".json"))try{const o=await u(i(this.dir,s),"utf-8"),a=JSON.parse(o);a?.identity?.id&&r.push(a)}catch{}return r}async save(t){await this.ensureDir();const r=`${JSON.stringify(t,null,2)}
+`;await y(this.fileFor(t.identity.id),r,"utf-8")}async remove(t){try{await f(this.fileFor(t),{force:!0})}catch{}}}export{g as TeamStateStore};

package/dist/extensions/builtin/team/team-task-store.d.ts

@@ -0,0 +1,35 @@
+/**
+ * [WHO]: TeamTaskStore class - durable shared task list for AgentTeam coordination
+ * [FROM]: Depends on node:fs/promises, node:path, ./team-types
+ * [TO]: Consumed by team-runtime.ts and index.ts
+ * [HERE]: extensions/builtin/team/team-task-store.ts - one tasks.json file under the team storage directory
+ */
+import type { TeamTask, TeamTaskStatus } from "./team-types.js";
+export interface CreateTeamTaskInput {
+    title: string;
+    description?: string;
+    dependsOn?: string[];
+    artifactPaths?: string[];
+}
+export interface UpdateTeamTaskInput {
+    status?: TeamTaskStatus;
+    ownerId?: string;
+    ownerName?: string;
+    description?: string;
+    artifactPaths?: string[];
+}
+export declare class TeamTaskStore {
+    private readonly filePath;
+    private tasks;
+    private loaded;
+    constructor(storageDir: string);
+    load(): Promise<void>;
+    create(input: CreateTeamTaskInput): Promise<TeamTask>;
+    claim(taskId: string, ownerId: string, ownerName: string): Promise<TeamTask | undefined>;
+    update(taskId: string, input: UpdateTeamTaskInput): Promise<TeamTask | undefined>;
+    list(): Promise<TeamTask[]>;
+    get(taskId: string): Promise<TeamTask | undefined>;
+    private find;
+    private nextId;
+    private save;
+}

package/dist/extensions/builtin/team/team-task-store.js

@@ -0,0 +1,2 @@
+var d=Object.defineProperty;var i=(s,e)=>d(s,"name",{value:e,configurable:!0});import{mkdir as r,readFile as n,writeFile as o}from"node:fs/promises";import{dirname as f,join as h}from"node:path";class w{static{i(this,"TeamTaskStore")}filePath;tasks=[];loaded=!1;constructor(e){this.filePath=h(e,"tasks.json")}async load(){if(!this.loaded){try{const e=await n(this.filePath,"utf-8"),t=JSON.parse(e);this.tasks=Array.isArray(t)?t.filter(a=>a?.id&&a?.title):[]}catch{this.tasks=[]}this.loaded=!0}}async create(e){await this.load();const t=Date.now(),a={id:this.nextId(),title:e.title.trim(),description:e.description?.trim()||void 0,status:"open",dependsOn:e.dependsOn??[],artifactPaths:e.artifactPaths??[],createdAt:t,updatedAt:t};return this.tasks.push(a),await this.save(),a}async claim(e,t,a){return this.update(e,{status:"claimed",ownerId:t,ownerName:a})}async update(e,t){await this.load();const a=this.find(e);if(a)return t.status&&(a.status=t.status,a.completedAt=t.status==="done"?Date.now():void 0),t.ownerId!==void 0&&(a.ownerId=t.ownerId||void 0),t.ownerName!==void 0&&(a.ownerName=t.ownerName||void 0),t.description!==void 0&&(a.description=t.description.trim()||void 0),t.artifactPaths!==void 0&&(a.artifactPaths=t.artifactPaths),a.updatedAt=Date.now(),await this.save(),a}async list(){return await this.load(),[...this.tasks].sort((e,t)=>e.createdAt-t.createdAt)}async get(e){return await this.load(),this.find(e)}find(e){return this.tasks.find(t=>t.id===e)}nextId(){const e=new Set(this.tasks.map(t=>t.id));for(let t=this.tasks.length+1;;t++){const a=`T-${t}`;if(!e.has(a))return a}}async save(){await r(f(this.filePath),{recursive:!0}),await o(this.filePath,`${JSON.stringify(this.tasks,null,2)}
+`,"utf-8")}}export{w as TeamTaskStore};

package/dist/extensions/builtin/team/team-transcript.d.ts

@@ -0,0 +1,31 @@
+/**
+ * [WHO]: TeamTranscriptWriter
+ * [FROM]: Depends on node:fs/promises, node:path
+ * [TO]: Consumed by team-runtime.ts
+ * [HERE]: extensions/builtin/team/team-transcript.ts - per-teammate JSONL transcripts
+ *
+ * Per refactor plan §B.7: each teammate keeps an independent transcript file
+ * for offline observation and debugging. Format is JSONL — one entry per
+ * line — under `<storageDir>/transcripts/<teammateId>.jsonl`.
+ *
+ * Writes are best-effort and never throw into the runtime hot path.
+ */
+export interface TranscriptEntry {
+    timestamp: number;
+    kind: "leader" | "teammate" | "event";
+    content: string;
+    meta?: Record<string, unknown>;
+}
+export declare class TeamTranscriptWriter {
+    private readonly dir;
+    private dirReady;
+    constructor(storageDir: string);
+    private ensureDir;
+    private fileFor;
+    /** Append one entry to the teammate's transcript. Never throws. */
+    append(teammateId: string, entry: TranscriptEntry): Promise<void>;
+    /** Remove a teammate's transcript file (called on terminate). */
+    remove(teammateId: string): Promise<void>;
+    /** Storage directory used for transcripts. */
+    get directory(): string;
+}

package/dist/extensions/builtin/team/team-transcript.js

@@ -0,0 +1,2 @@
+var s=Object.defineProperty;var t=(i,r)=>s(i,"name",{value:r,configurable:!0});import{mkdir as c,appendFile as n,rm as d}from"node:fs/promises";import{join as e}from"node:path";class y{static{t(this,"TeamTranscriptWriter")}dir;dirReady=!1;constructor(r){this.dir=e(r,"transcripts")}async ensureDir(){if(!this.dirReady)try{await c(this.dir,{recursive:!0}),this.dirReady=!0}catch{}}fileFor(r){return e(this.dir,`${r}.jsonl`)}async append(r,a){try{await this.ensureDir(),await n(this.fileFor(r),`${JSON.stringify(a)}
+`,"utf-8")}catch{}}async remove(r){try{await d(this.fileFor(r),{force:!0})}catch{}}get directory(){return this.dir}}export{y as TeamTranscriptWriter};

package/dist/extensions/builtin/team/team-types.d.ts

@@ -0,0 +1,250 @@
+/**
+ * [WHO]: TeammateRole, TeammateMode, HarnessState, PsycheWeights, TeamUtterance, Handoff, LeaderPlan, AgentLiveView, PersistedTeammate, TeamSpawnSpec, TeamSendResult
+ * [FROM]: No external deps
+ * [TO]: Consumed by team-state-store.ts, team-runtime.ts, team-parser.ts, team-dashboard.ts, team-orchestrator.ts, index.ts
+ * [HERE]: extensions/builtin/team/team-types.ts - shared type surface for team extension
+ */
+/**
+ * Teammate role. Determines default mode and toolset.
+ * - pm: planning and sequencing
+ * - architect: system design and technical decomposition
+ * - developer: implementation and code delivery
+ * - designer: UX/UI and interaction review
+ * - data-analyst: metrics, evidence, and verification framing
+ * - researcher: read-only exploration
+ * - reviewer: read-only review/audit
+ * - implementer: legacy implementation role
+ * - planner: legacy planning role
+ * - verifier: legacy verification role
+ * - generic: read-only by default, caller supplies mode
+ */
+export type TeammateRole = "pm" | "architect" | "developer" | "designer" | "data-analyst" | "researcher" | "reviewer" | "implementer" | "planner" | "verifier" | "generic";
+/**
+ * Teammate operating mode. Controls the permission envelope.
+ * - research: read-only exploration
+ * - plan: read-only plan production; execute requires leader approval
+ * - execute: sandboxed write in worktree
+ * - review: read-only review
+ */
+export type TeammateMode = "research" | "plan" | "execute" | "review";
+/**
+ * Teammate lifecycle status.
+ * - idle: spawned, no work in flight
+ * - running: currently processing a message
+ * - stopped: current turn aborted, teammate still alive
+ * - terminated: fully disposed
+ * - error: last turn failed
+ */
+export type TeammateStatus = "idle" | "running" | "stopped" | "terminated" | "error";
+/** Shared task status for team coordination. */
+export type TeamTaskStatus = "open" | "claimed" | "blocked" | "done" | "cancelled";
+/** Harness phase for long-running teammate work. */
+export type HarnessPhase = "init" | "coding" | "verify" | "fix" | "complete";
+/** Three-layer psyche weights used by phase-aware prompts. */
+export interface PsycheWeights {
+    id: number;
+    ego: number;
+    superego: number;
+}
+/** Built-in team presets. */
+export type PresetName = "solo" | "duo" | "squad";
+/** Feature tracked by the harness protocol. */
+export interface HarnessFeature {
+    id: string;
+    category: "functional" | "visual" | "performance" | "integration";
+    description: string;
+    steps: string[];
+    passes: boolean;
+    priority: number;
+}
+/** Durable harness state attached to a teammate. */
+export interface HarnessState {
+    enabled: boolean;
+    phase: HarnessPhase;
+    featureListPath: string;
+    progressPath: string;
+    initScriptPath: string;
+    totalFeatures: number;
+    passedFeatures: number;
+    currentFeature: string | null;
+    lastVerifyReport: string | null;
+    cycleCount: number;
+    featureSnapshot: Omit<HarnessFeature, "passes">[];
+    /** Git commit that existed before the current harness turn began */
+    preTurnCommit: string | null;
+    /** Last commit created by the harness checkpoint flow */
+    lastCheckpointCommit: string | null;
+    /** Last commit created to revert a failed/violating turn */
+    lastRevertCommit: string | null;
+    lastEvent?: string;
+}
+/** Transient live view state used by the TUI dashboard while a teammate is running. */
+export interface TeammateLiveState {
+    phase: "starting" | "thinking" | "tool" | "finishing" | "done" | "error";
+    preview: string;
+    toolName: string | null;
+    updatedAt: number;
+}
+/** High-level conversation role surfaced in the team TUI. */
+export type TeamSpeakerRole = "leader" | TeammateRole;
+/** Canonical message kind used by the team speaker stream. */
+export type TeamMessageKind = "thought" | "work" | "handoff" | "result";
+/** Parsed @mention used for agent-to-agent handoffs. */
+export interface TeamMention {
+    raw: string;
+    targetId: string;
+    targetName: string;
+    targetLabel: string;
+    task: string;
+}
+/** One utterance in the visible team chat stream. */
+export interface TeamUtterance {
+    id: string;
+    speakerId: string;
+    speakerLabel: string;
+    role: TeamSpeakerRole;
+    text: string;
+    kind: TeamMessageKind;
+    mentions: TeamMention[];
+    timestamp: number;
+}
+/** Leader-visible handoff edge between two agents. */
+export interface Handoff {
+    id: string;
+    from: string;
+    to: string;
+    task: string;
+    status: "pending" | "accepted" | "done" | "blocked";
+    timestamp: number;
+}
+/** Compact per-agent state shown in the workbench/dashboard. */
+export interface AgentLiveView {
+    name: string;
+    label: string;
+    role: TeammateRole;
+    currentTask?: string;
+    lastUtterance?: string;
+    blockedOn?: string;
+    progress?: string;
+}
+/** One leader-owned subtask in the orchestration plan. */
+export interface LeaderSubtask {
+    id: string;
+    ownerId: string;
+    ownerName: string;
+    ownerLabel: string;
+    ownerRole: TeammateRole;
+    title: string;
+    task: string;
+    dependsOn: string[];
+    status: "pending" | "in_progress" | "done" | "blocked";
+}
+/** Session-scoped leader plan used by the orchestrator. */
+export interface LeaderPlan {
+    userGoal: string;
+    phase: "plan" | "assign" | "watch" | "rebalance" | "summarize" | "done";
+    subtasks: LeaderSubtask[];
+    owners: Record<string, string>;
+    dependencies: Record<string, string[]>;
+    completionState: "pending" | "running" | "completed" | "blocked";
+}
+/** Stable identity for a teammate, assigned at spawn time. */
+export interface TeammateIdentity {
+    /** Unique id (uuid) */
+    id: string;
+    /** Stable short label used in the TUI and mention protocol (A/B/C/...) */
+    label: string;
+    /** Human-friendly name (user-supplied or auto-generated) */
+    name: string;
+    /** Role determines default tools and mode */
+    role: TeammateRole;
+    /** Creation timestamp (ms) */
+    createdAt: number;
+}
+/** One conversation turn persisted with the teammate. */
+export interface TeammateMessage {
+    /** Turn id (uuid) */
+    id: string;
+    /** Timestamp (ms) */
+    timestamp: number;
+    /** Who spoke */
+    direction: "leader" | "teammate";
+    /** Plain text body */
+    content: string;
+    /** Whether the turn was aborted mid-flight */
+    aborted?: boolean;
+    /** Whether the turn errored */
+    error?: string;
+}
+/**
+ * Durable teammate state. Only plain JSON fields — no runtime handles.
+ * This is the on-disk shape managed by TeamStateStore.
+ */
+export interface PersistedTeammate {
+    identity: TeammateIdentity;
+    mode: TeammateMode;
+    status: TeammateStatus;
+    /** Working directory for the teammate (main cwd or worktree path) */
+    cwd: string;
+    /** Worktree path if the teammate owns one, otherwise undefined */
+    worktreePath?: string;
+    /** Git branch name for worktree teammates */
+    worktreeBranch?: string;
+    /** Conversation history */
+    messages: TeammateMessage[];
+    /** Last activity timestamp */
+    lastActiveAt: number;
+    /** Last error message if status = error */
+    lastError?: string;
+    /** Optional long-running task harness state */
+    harness?: HarnessState;
+    /** Last computed psyche weights for status/UI rendering */
+    psyche?: PsycheWeights;
+    /** Optional static psyche tuning from presets or spawn configuration */
+    psycheOverrides?: Partial<PsycheWeights>;
+    /** Runtime-only TUI live state; cleared before persistence after each run */
+    live?: TeammateLiveState;
+    /** Structured workbench state shown by the team dashboard */
+    liveView?: AgentLiveView;
+}
+/** Input for spawning a new teammate. */
+export interface TeamSpawnSpec {
+    /** Desired name; if taken or empty, runtime generates one */
+    name?: string;
+    /** Role selection */
+    role: TeammateRole;
+    /** Optional explicit mode override (defaults to role's natural mode) */
+    mode?: TeammateMode;
+    /** Base cwd for the teammate (usually the main session cwd) */
+    baseCwd: string;
+    /** Enable Anthropic-style long-running harness protocol for this teammate */
+    harnessEnabled?: boolean;
+    /** Optional static psyche tuning for this teammate */
+    psycheOverrides?: Partial<PsycheWeights>;
+}
+/** Result of a /team:send call. */
+export interface TeamSendResult {
+    teammateId: string;
+    teammateName: string;
+    success: boolean;
+    response: string;
+    aborted?: boolean;
+    error?: string;
+    durationMs: number;
+    utterance?: TeamUtterance;
+    mentions?: TeamMention[];
+}
+/** Durable task record shared by the team. */
+export interface TeamTask {
+    id: string;
+    title: string;
+    description?: string;
+    status: TeamTaskStatus;
+    ownerId?: string;
+    ownerName?: string;
+    dependsOn: string[];
+    artifactPaths: string[];
+    createdAt: number;
+    updatedAt: number;
+    completedAt?: number;
+}

package/dist/extensions/builtin/team/team-ui.d.ts

@@ -0,0 +1,50 @@
+/**
+ * [WHO]: TEAM_MESSAGE_TYPE, team message rendering, status/list formatting, dashboard/observer helpers
+ * [FROM]: Depends on @catui/tui, core/extensions-host/types, theme colors, team runtime/types/dashboard/harness/orchestrator helpers
+ * [TO]: Consumed by extensions/builtin/team/index.ts
+ * [HERE]: extensions/builtin/team/team-ui.ts - UI and text formatting boundary for AgentTeam
+ */
+import type { ExtensionAPI, MessageRenderer } from "../../../core/extensions-host/types.js";
+import type { TeamRuntime, TeamRuntimeEvent } from "./team-runtime.js";
+import type { PersistedTeammate, TeamTask, TeamUtterance } from "./team-types.js";
+export declare const TEAM_MESSAGE_TYPE = "team";
+export declare function clearTeamDashboardTimer(): void;
+export declare function createTeamMessageRenderer(): MessageRenderer;
+export declare function formatTaskList(tasks: TeamTask[]): string[];
+export declare function formatTeammateList(teammates: PersistedTeammate[]): string[];
+export declare function formatTeammateStatus(teammate: PersistedTeammate): string[];
+export declare function emitTeamUtterance(api: ExtensionAPI, utterance: TeamUtterance, options?: {
+    streamKey?: string;
+    replace?: boolean;
+}): void;
+export declare function formatSpeakerName(teammate: PersistedTeammate): string;
+export declare function toggleTeamDashboard(ctx: {
+    ui: {
+        setStatus(key: string, text: string | undefined): void;
+        setWidget(key: string, content: string[] | undefined): void;
+    };
+}, teamRuntime: TeamRuntime): boolean;
+export declare function updateTeamUi(ctx: {
+    ui: {
+        setStatus(key: string, text: string | undefined): void;
+        setWidget(key: string, content: string[] | undefined): void;
+    };
+}, teamRuntime: TeamRuntime): void;
+export declare function setTeamActivity(ctx: {
+    ui: {
+        setStatus(key: string, text: string | undefined): void;
+        setWidget(key: string, content: string[] | undefined): void;
+        setWorkingMessage(message?: string): void;
+    };
+}, lines: string[]): void;
+export declare function createTeamObserver(api: ExtensionAPI, ctx: {
+    ui: {
+        setStatus(key: string, text: string | undefined): void;
+        setWidget(key: string, content: string[] | undefined): void;
+        setWorkingMessage(message?: string): void;
+    };
+}, teamRuntime: TeamRuntime): {
+    onEvent(event: TeamRuntimeEvent): void;
+    flush(): void;
+};
+export declare function truncateForStatus(value: string, max?: number): string;

package/dist/extensions/builtin/team/team-ui.js

@@ -0,0 +1,2 @@
+var T=Object.defineProperty;var r=(e,n)=>T(e,"name",{value:n,configurable:!0});import{Box as w,Container as f,Spacer as h,Text as g}from"@catui/tui";import{formatHarnessProgress as k}from"./team-harness.js";import{createTeamUtterance as x,formatUtteranceForContext as b}from"./team-orchestrator.js";import{renderTeamDashboard as M,renderTeamFooterStatus as S}from"./team-dashboard.js";import{formatPsycheWeights as v}from"./team-psyche.js";const L="team";let m=!1;function R(){}r(R,"clearTeamDashboardTimer");function G(){return(e,n,t)=>{const i=e.details;if(i?.variant==="utterance"){const{utterance:s}=i,c=t.fg(C(s.role),`\x1B[1m${s.speakerLabel}:\x1B[22m`),u=t.fg(P(s.kind),s.text),l=new f;return l.addChild(new h(1)),l.addChild(new g(`${c} ${u}`,1,0)),l}const o=typeof e.content=="string"?e.content:Array.isArray(e.content)?e.content.filter(s=>s.type==="text").map(s=>s.text).join(`
+`):"",d=new w(1,1,s=>t.bg("customMessageBg",s));d.addChild(new g(t.fg("customMessageText",o),0,0));const a=new f;return a.addChild(new h(1)),a.addChild(d),a}}r(G,"createTeamMessageRenderer");function Q(e){if(e.length===0)return["No team tasks. Use /team:task add <title> to create one."];const n=["Team Tasks:",""];for(const t of e){const i=t.ownerName?` @${t.ownerName}`:"",o=t.dependsOn.length?` deps:${t.dependsOn.join(",")}`:"";n.push(`${t.id} [${t.status}]${i}${o} ${t.title}`),t.description&&n.push(`  ${t.description}`),t.artifactPaths.length&&n.push(`  artifacts: ${t.artifactPaths.join(", ")}`)}return n}r(Q,"formatTaskList");function V(e){if(e.length===0)return["No teammates. Use /team:spawn to create one."];const n=[`Team (${e.length} teammate${e.length===1?"":"s"}):`,""];for(const t of e){const i=B(t.status),o=t.harness?.enabled?` | harness:${t.harness.phase} ${t.harness.passedFeatures}/${t.harness.totalFeatures}`:"";n.push(`${i} ${t.identity.name} (${t.identity.role}) - ${t.mode} mode${o}`)}return n}r(V,"formatTeammateList");function Y(e){const n=[`Teammate: ${e.identity.name}`,`  ID: ${e.identity.id}`,`  Role: ${e.identity.role}`,`  Mode: ${e.mode}`,`  Status: ${e.status}`,`  Created: ${new Date(e.identity.createdAt).toLocaleString()}`,`  Last Active: ${new Date(e.lastActiveAt).toLocaleString()}`,`  Working Directory: ${e.cwd}`];return e.worktreePath&&(n.push(`  Worktree: ${e.worktreePath}`),e.worktreeBranch&&n.push(`  Branch: ${e.worktreeBranch}`)),e.lastError&&n.push(`  Last Error: ${e.lastError}`),e.harness?.enabled&&n.push(...k(e.harness).map(t=>`  ${t}`)),e.psyche&&n.push(`  ${v(e.psyche)}`),n.push(`  Messages: ${e.messages.length}`),n}r(Y,"formatTeammateStatus");function A(e,n,t){e.sendMessage({customType:L,content:b(n),display:!0,details:{variant:"utterance",utterance:n,streamKey:t?.streamKey,replace:t?.replace}})}r(A,"emitTeamUtterance");function E(e){return e.identity.name}r(E,"formatSpeakerName");function q(e,n){return m=!m,p(e,n),m}r(q,"toggleTeamDashboard");function p(e,n){const t=n.getAllTeammates(),i=t.some(d=>d.status==="running"),o=m||i;e.ui.setStatus("team",o?S(t):void 0),e.ui.setWidget("team-dashboard",o?M(t,80,{expanded:m}):void 0)}r(p,"updateTeamUi");function z(e,n){const[t]=n;e.ui.setStatus("team",t??"Team: working..."),e.ui.setWidget("team-dashboard",["+ Team Workbench ------------------------------------------+",...n.map(i=>`| ${W(i,58).padEnd(58)} |`),"+---------------------------------------------------------+"]),e.ui.setWorkingMessage(t??"Team: working...")}r(z,"setTeamActivity");function J(e,n,t){let i=0;const o=new Map,d=new Map;return{onEvent(a){const s=Date.now();if(a.type==="teammate_live"){if(n.ui.setWorkingMessage(D(a)),a.event.type==="message_update"){const c=a.teammate,u=c.live?.preview??a.event.text??"",l=o.get(c.identity.id)??"",$=u.startsWith(l)?u.slice(l.length):u,y=d.get(c.identity.id)??0;U($,s-y)&&(A(e,x({speakerId:c.identity.id,speakerLabel:E(c),role:c.identity.role,kind:"thought",text:u.trim()||_(u)}),{streamKey:`team-stream:${c.identity.id}`,replace:!0}),o.set(c.identity.id,u),d.set(c.identity.id,s))}}else a.type==="teammate_status"?n.ui.setWorkingMessage(`Team: ${a.event}`):n.ui.setWorkingMessage(`Team: ${a.teammate.identity.name} ${a.event}`);(a.type==="teammate_live"||s-i>80)&&(p(n,t),i=s)},flush(){p(n,t)}}}r(J,"createTeamObserver");function W(e,n=100){const t=N(e);return t.length<=n?t:`${t.slice(0,Math.max(0,n-3))}...`}r(W,"truncateForStatus");function C(e){switch(e){case"leader":return"accent";case"pm":return"warning";case"architect":return"mdHeading";case"developer":case"implementer":return"success";case"designer":return"mdLink";case"data-analyst":return"syntaxNumber";case"reviewer":return"mdQuote";case"researcher":return"syntaxFunction";default:return"customMessageLabel"}}r(C,"getTeamSpeakerColor");function P(e){switch(e){case"thought":return"thinkingText";case"handoff":return"mdLink";default:return"text"}}r(P,"getTeamUtteranceColor");function U(e,n){const t=e.trim();return t?t.length>=24||/[\n。！？!?]$/.test(t)||n>=700:!1}r(U,"shouldEmitStreamDelta");function _(e,n=120){const t=e.replace(/\s+/g," ").trim();return t.length<=n?t:t.slice(t.length-n)}r(_,"tailPreview");function D(e){const n=e.teammate.identity.name,t=e.teammate.live;return e.event.type==="tool_start"?`Team: ${n} running ${e.event.toolName}...`:e.event.type==="tool_update"||e.event.type==="tool_end"?`Team: ${n} using ${e.event.toolName}...`:t?.phase==="thinking"?`Team: ${n} streaming...`:t?.phase==="finishing"?`Team: ${n} finishing...`:`Team: ${n} ${t?.phase??"working"}...`}r(D,"formatLiveWorkingMessage");function N(e){return e.replace(/\s+/g," ").trim()}r(N,"singleLine");function B(e){switch(e){case"idle":return"o";case"running":return"*";case"stopped":return"!";case"error":return"x";case"terminated":return"-";default:return"?"}}r(B,"getStatusIconAscii");export{L as TEAM_MESSAGE_TYPE,R as clearTeamDashboardTimer,G as createTeamMessageRenderer,J as createTeamObserver,A as emitTeamUtterance,E as formatSpeakerName,Q as formatTaskList,V as formatTeammateList,Y as formatTeammateStatus,z as setTeamActivity,q as toggleTeamDashboard,W as truncateForStatus,p as updateTeamUi};

package/dist/extensions/builtin/token-save/README.md

@@ -0,0 +1,56 @@
+# TokenSave
+
+TokenSave is a default-on extension that reduces noisy shell output before it enters the agent context.
+
+## Behavior
+
+- Commands execute with their original shell semantics.
+- TokenSave plans commands before execution and filters output after execution.
+- Small outputs, unsafe redirection, heredocs, and explicitly disabled commands pass through unchanged.
+- Filtered outputs include estimated token savings and a raw recovery file path when available.
+- Both agent-called `bash` tools and user `!` bash commands are covered. `!!` commands stay excluded from context and are not intercepted.
+
+## Disable
+
+Set either environment variable on a command to bypass filtering:
+
+```bash
+TOKEN_SAVE_DISABLED=1 git status
+TOKENSAVE_DISABLED=1 npm test
+```
+
+## Stats
+
+Use:
+
+```text
+/tokensave
+/tokensave history
+/tokensave plan <command>
+```
+
+## Config Filters
+
+User filters load from:
+
+```text
+~/.catui/token-save/filters.json
+```
+
+Project filters load from:
+
+```text
+.catui/token-save/filters.json
+```
+
+Project filters are ignored unless the project explicitly opts in with:
+
+```json
+{ "trusted": true }
+```
+
+at:
+
+```text
+.catui/token-save/trust.json
+```

package/dist/extensions/builtin/token-save/config.d.ts

@@ -0,0 +1,8 @@
+import type { TomlStyleFilter } from "./toml-dsl.js";
+export interface ConfiguredTokenSaveFilter {
+    name: string;
+    commandPattern: string;
+    filter: TomlStyleFilter;
+    source: "user" | "project";
+}
+export declare function loadTokenSaveConfigFilters(projectPath: string): Promise<ConfiguredTokenSaveFilter[]>;

package/dist/extensions/builtin/token-save/config.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var n=(t,r)=>f(t,"name",{value:r,configurable:!0});import{readFile as i}from"node:fs/promises";import{homedir as p}from"node:os";import{join as o}from"node:path";async function j(t){const r=o(p(),".catui","token-save","filters.json"),e=o(t,".catui","token-save","filters.json"),s=o(t,".catui","token-save","trust.json"),a=[];return a.push(...await c(r,"user")),await m(s)&&a.push(...await c(e,"project")),a}n(j,"loadTokenSaveConfigFilters");async function m(t){try{return JSON.parse(await i(t,"utf8")).trusted===!0}catch{return!1}}n(m,"isProjectTrusted");async function c(t,r){try{return(JSON.parse(await i(t,"utf8")).filters??[]).filter(s=>l(s)).map(s=>({...s,source:r}))}catch{return[]}}n(c,"readFilters");function l(t){return!t||typeof t.name!="string"||typeof t.commandPattern!="string"||t.commandPattern.length>240||!u(t.commandPattern)||!t.filter||typeof t.filter!="object"?!1:[t.filter.stripLines??[],t.filter.keepLines??[],(t.filter.replace??[]).map(e=>e.pattern),(t.filter.matchMessage??[]).map(e=>e.pattern)].flat().every(e=>typeof e=="string"&&e.length<=240&&u(e))}n(l,"isSafeFilter");function u(t){try{return new RegExp(t),!0}catch{return!1}}n(u,"canCompile");export{j as loadTokenSaveConfigFilters};

package/dist/extensions/builtin/token-save/filters.d.ts

@@ -0,0 +1,14 @@
+export type TokenSaveCategory = "git-status" | "git-log" | "git-diff" | "read-file" | "search" | "typescript" | "lint" | "pytest" | "test" | "json" | "package-manager" | "generic";
+export interface TokenSaveClassification {
+    category: TokenSaveCategory;
+    mode: "filtered" | "passthrough";
+    reason?: string;
+}
+export interface TokenSaveFilterResult {
+    text: string;
+    category: TokenSaveCategory;
+    mode: "filtered" | "passthrough";
+}
+export declare function classifyCommand(command: string): TokenSaveClassification;
+export declare function filterTokenSaveOutput(command: string, rawOutput: string): TokenSaveFilterResult;
+export declare function estimateTokens(text: string): number;

package/dist/extensions/builtin/token-save/filters.js

@@ -0,0 +1,24 @@
+var b=Object.defineProperty;var a=(t,e)=>b(t,"name",{value:e,configurable:!0});import{truncateHead as m,truncateTail as u}from"../../../core/tools/truncate.js";const y=120,g=180,k=180;function f(t){return t.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g,"")}a(f,"stripAnsi");function x(t){return t.split(/&&|\|\||;/,1)[0].replace(/^\s*(?:\w+=\S+\s+)*/,"").trim()}a(x,"firstCommandSegment");function $(t){return/\b(?:TOKEN_SAVE_DISABLED|TOKENSAVE_DISABLED)=1\b/.test(t)}a($,"looksLikeDisabled");function S(t){return/(^|\s)(?:>>?|2>|&>)/.test(t)||/\bcat\s*>/.test(t)}a(S,"hasWriteRedirection");function j(t){if(!t.trim())return{category:"generic",mode:"passthrough",reason:"empty command"};if($(t))return{category:"generic",mode:"passthrough",reason:"disabled by env"};const e=x(t);return S(e)?{category:"generic",mode:"passthrough",reason:"write redirection"}:/\bgit\s+status\b/.test(e)?{category:"git-status",mode:"filtered"}:/\bgit\s+(?:log|show)\b/.test(e)?{category:"git-log",mode:"filtered"}:/\bgit\s+(?:diff|show)\b/.test(e)?{category:"git-diff",mode:"filtered"}:/^(?:cat|head|tail|less|sed\s+-n)\b/.test(e)?{category:"read-file",mode:"filtered"}:/^(?:rg|grep|find|fd|ls|tree)\b/.test(e)?{category:"search",mode:"filtered"}:/\b(?:tsc|vue-tsc)\b/.test(e)?{category:"typescript",mode:"filtered"}:/\b(?:eslint|biome)\b/.test(e)?{category:"lint",mode:"filtered"}:/\bpytest\b/.test(e)?{category:"pytest",mode:"filtered"}:/\b(?:vitest|jest|playwright|pytest|mocha)\b/.test(e)?{category:"test",mode:"filtered"}:/\b(?:npm|pnpm|yarn|bun)\s+(?:install|add|remove|update)\b/.test(e)?{category:"package-manager",mode:"filtered"}:/\b(?:npm|pnpm|yarn|bun)\s+(?:test|run\s+(?:test|build|lint|typecheck)|exec\s+(?:tsc|vue-tsc|vitest|jest|playwright|eslint|biome))\b/.test(e)?{category:"test",mode:"filtered"}:/\b(?:jq|curl)\b/.test(e)?{category:"json",mode:"filtered"}:{category:"generic",mode:"filtered"}}a(j,"classifyCommand");function A(t){const e=t.split(`
+`).map(o=>o.trimEnd()).filter(Boolean),s=e.find(o=>/^On branch /.test(o)||/^## /.test(o)),i=e.find(o=>/(nothing to commit|working tree clean|changed|insertions|deletions|files? changed)/i.test(o)),n=[];let r="";const c=new Map;for(const o of e){if(/^(Changes|Untracked|Changes not staged|Changes to be committed)/i.test(o)){r=o.replace(/:$/,""),c.has(r)||c.set(r,[]);continue}if(/^\s*(modified|new file|deleted|renamed|copied|both modified):\s+/.test(o)&&r)c.get(r)?.push(o.trim());else if(/^  \S/.test(o)&&/^Untracked files/i.test(r))c.get(r)?.push(o.trim());else if(/^[ MADRCU?!]{1,2}\s+/.test(o)){const l="Short status";c.has(l)||c.set(l,[]),c.get(l)?.push(o.trim())}}s&&n.push(s),i&&n.push(i);for(const[o,l]of c)n.push(`${o}: ${l.length}`),n.push(...l.slice(0,20).map(p=>`  ${p}`)),l.length>20&&n.push(`  ... ${l.length-20} more`);return n.length?n.join(`
+`):m(t,{maxLines:80,maxBytes:12e3}).content}a(A,"compactGitStatus");function E(t){const e=t.split(`
+`),s=e.filter(o=>o.startsWith("diff --git ")).map(o=>o.replace(/^diff --git /,"")),i=e.filter(o=>/^[-+]{3} |^@@ |^\+\+\+ /.test(o)),n=e.filter(o=>/^[+-][^+-]/.test(o)).length,r=[`Git diff compact: ${s.length} file(s), ${n} changed line(s)`];s.length&&r.push(...s.slice(0,40).map(o=>`  ${o}`));const c=i.slice(0,k);return[...r,...c,i.length>c.length?`... ${i.length-c.length} diff metadata lines omitted`:""].filter(Boolean).join(`
+`)}a(E,"compactGitDiff");function L(t){const e=t.split(`
+`).filter(Boolean),s=e.filter(r=>/^(commit\s+[0-9a-f]{7,40}|[0-9a-f]{7,40}\s+)/i.test(r)),i=e.filter(r=>/^Date:\s+/.test(r)).slice(0,20),n=e.filter(r=>/^\s{4}\S/.test(r)).map(r=>r.trim()).slice(0,80);return s.length===0&&n.length===0?m(t,{maxLines:120,maxBytes:16e3}).content:[`Git log compact: ${s.length||n.length} entr${s.length===1||n.length===1?"y":"ies"}`,...s.slice(0,80),...i,...n].join(`
+`)}a(L,"compactGitLog");function B(t){const e=f(t).split(`
+`).filter(Boolean),s=new Map,i=[];for(const r of e){const c=r.match(/^(.+?\.(?:ts|tsx|js|jsx|vue))\((\d+),(\d+)\):\s+error\s+(TS\d+):\s+(.+)$/);if(c){const o=`${c[1]} ${c[4]}`,l=`  ${c[2]}:${c[3]} ${c[5]}`,p=s.get(o)??[];p.push(l),s.set(o,p);continue}/error TS\d+|Found \d+ errors?/.test(r)&&i.push(r)}if(s.size===0)return d(t);const n=[`TypeScript compact: ${s.size} file/code group(s)`];for(const[r,c]of Array.from(s.entries()).slice(0,60))n.push(r),n.push(...c.slice(0,6)),c.length>6&&n.push(`  ... ${c.length-6} more`);return n.push(...i.slice(-10)),n.join(`
+`)}a(B,"compactTypeScriptOutput");function _(t){const s=f(t).split(`
+`).filter(Boolean).filter(i=>/(error|warning|problem|^\s*\d+:\d+\s+|\/.+\.(?:ts|tsx|js|jsx|vue|css|json)$)/i.test(i));return s.length?s.slice(0,g).join(`
+`):d(t)}a(_,"compactLintOutput");function O(t){const s=f(t).split(`
+`).filter(Boolean).filter(i=>/(^FAILED |^ERROR |^E\s+|Traceback|AssertionError|short test summary|failed|passed|warnings?)/i.test(i));return s.length?s.slice(0,g).join(`
+`):d(t)}a(O,"compactPytestOutput");function d(t){const e=f(t).split(`
+`).filter(Boolean),s=e.filter(r=>/(error|failed|failure|exception|traceback|^\s*at\s+|expected|received|AssertionError|TS\d{4}|ERR!|FAIL)/i.test(r)),i=e.filter(r=>/(tests?|passed|failed|skipped|errors?|warnings?|Time:|Ran \d+)/i.test(r)).slice(-30),n=[...s.slice(0,g),...i];return n.length?Array.from(new Set(n)).join(`
+`):u(t,{maxLines:120,maxBytes:18e3}).content}a(d,"compactFailureOutput");function T(t){const e=t.split(`
+`).filter(Boolean);if(e.length<=160&&t.length<=2e4)return t;const s=new Map;for(const n of e){const r=n.split(":",1)[0]||"(output)",c=s.get(r)??[];c.push(n),s.set(r,c)}const i=[`Search compact: ${e.length} line(s), ${s.size} group(s)`];for(const[n,r]of Array.from(s.entries()).slice(0,80))i.push(`${n}: ${r.length}`),i.push(...r.slice(0,3).map(c=>`  ${c.slice(0,240)}`)),r.length>3&&i.push(`  ... ${r.length-3} more`);return i.join(`
+`)}a(T,"compactSearchOutput");function R(t){const s=f(t).split(`
+`).filter(Boolean).filter(i=>/(added|removed|updated|packages?|dependencies|deprecated|warning|error|vulnerab|audit|funding|lockfile|resolved|downloaded)/i.test(i));return s.length?s.slice(0,120).join(`
+`):u(t,{maxLines:80,maxBytes:12e3}).content}a(R,"compactPackageManagerOutput");function D(t){const e=t.split(`
+`);if(e.length<=220&&t.length<=24e3)return t;const s=m(t,{maxLines:80,maxBytes:12e3}).content,i=u(t,{maxLines:80,maxBytes:12e3}).content;return`${s}
+
+... TokenSave omitted ${Math.max(0,e.length-160)} middle line(s) ...
+
+${i}`}a(D,"compactFileRead");function I(t){try{const e=JSON.parse(t);return JSON.stringify(h(e),null,2)}catch{return u(t,{maxLines:y,maxBytes:18e3}).content}}a(I,"compactJson");function h(t,e=0){if(e>=4)return Array.isArray(t)?`[array:${t.length}]`:typeof t;if(Array.isArray(t))return{type:"array",length:t.length,sample:t.slice(0,3).map(s=>h(s,e+1))};if(t&&typeof t=="object"){const s=Object.entries(t).slice(0,40);return Object.fromEntries(s.map(([i,n])=>[i,h(n,e+1)]))}return typeof t=="string"&&t.length>160?`${t.slice(0,157)}...`:t}a(h,"summarizeJson");function N(t,e){const s=j(t),i=f(e);if(s.mode==="passthrough")return{text:e,category:s.category,mode:"passthrough"};let n;switch(s.category){case"git-status":n=A(i);break;case"git-diff":n=E(i);break;case"git-log":n=L(i);break;case"read-file":n=D(i);break;case"typescript":n=B(i);break;case"lint":n=_(i);break;case"pytest":n=O(i);break;case"test":n=d(i);break;case"json":n=I(i);break;case"search":n=T(i);break;case"package-manager":n=R(i);break;case"generic":n=u(i,{maxLines:y,maxBytes:18e3}).content;break}return{text:n||e,category:s.category,mode:"filtered"}}a(N,"filterTokenSaveOutput");function C(t){return Math.ceil(t.length/4)}a(C,"estimateTokens");export{j as classifyCommand,C as estimateTokens,N as filterTokenSaveOutput};

package/dist/extensions/builtin/token-save/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: tokenSaveExtension - default-on bash output filtering, savings tracking, and /tokensave command
+ * [FROM]: Depends on core/extensions-host/types, ./filters, ./tracking
+ * [TO]: Auto-loaded by builtin-extensions.ts as a default extension
+ * [HERE]: extensions/builtin/token-save/index.ts - TokenSave extension entry point
+ */
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+export default function tokenSaveExtension(api: ExtensionAPI): void;

package/dist/extensions/builtin/token-save/index.js

@@ -0,0 +1,4 @@
+var y=Object.defineProperty;var u=(r,n)=>y(r,"name",{value:n,configurable:!0});import{executeBash as k}from"../../../core/platform/exec/bash-executor.js";import{loadTokenSaveConfigFilters as p}from"./config.js";import{applyTokenSavePlan as f}from"./runner.js";import{planCommand as c}from"./rewrite.js";import{applyTomlStyleFilter as v}from"./toml-dsl.js";import{TokenSaveTracker as w}from"./tracking.js";const P=[{value:"summary",label:"summary",description:"Show total shell output savings"},{value:"history",label:"history",description:"Show recent shortened commands"},{value:"reload",label:"reload",description:"Reload project output-shortening rules"},{value:"plan",label:"plan",description:"Preview how a command will be shortened"}];function m(r){const n=r.content.filter(i=>i.type==="text");if(n.length!==0)return n.map(i=>i.text).join(`
+`)}u(m,"getTextContent");function x(r){const n=r.input.command;return typeof n=="string"?n:void 0}u(x,"getCommand");function h(r){const n=r.details;return typeof n?.fullOutputPath=="string"?n.fullOutputPath:m(r)?.match(/Full output:\s+([^\]\n]+)/)?.[1]?.trim()}u(h,"recoveryPathFromDetails");function $(r){const n=new w(r.cwd);let i=[];p(r.cwd).then(o=>{i=o}),r.registerCommand("tokensave",{description:"Review shell output shortening. Usage: /tokensave [summary|history|reload|plan <cmd>]",getArgumentCompletions:u((o,a)=>{if(a&&a.tokenIndex>0)return null;const s=o.trim().toLowerCase(),t=P.filter(e=>e.value.startsWith(s));return t.length>0?t:null},"getArgumentCompletions"),async handler(o,a){const s=o.trim();if(s==="reload"){i=await p(r.cwd),a.ui.notify(`TokenSave loaded ${i.length} configured filter(s).`,"info");return}if(s.startsWith("plan ")){const t=c(s.slice(5));a.ui.notify(JSON.stringify(t,null,2),"info");return}if(s==="history"){a.ui.notify(n.formatHistory(),"info");return}a.ui.notify(n.formatSummary(),"info")}}),r.on("tool_call",o=>{if(o.toolName!=="bash")return;const a=typeof o.input.command=="string"?o.input.command:void 0;if(!(!a||c(a).mode==="passthrough"))return{input:{...o.input,command:a}}}),r.on("user_bash",async o=>{if(o.excludeFromContext||c(o.command).mode==="passthrough")return;const s=await k(o.command,{cwd:o.cwd});return{result:await R(o.command,s,r.cwd,i,n,Date.now())}}),r.on("tool_result",async o=>{if(o.toolName!=="bash")return;const a=x(o),s=m(o);if(!a||!s)return;const t=Date.now(),e=await f(a,s,r.cwd),l=g(a,s,i);if(l&&l.length<e.filteredText.length&&(e.filteredText=l,e.outputTokens=Math.ceil(l.length/4),e.savedTokens=Math.max(0,e.inputTokens-e.outputTokens),e.savingsPct=e.inputTokens>0?Math.round(e.savedTokens/e.inputTokens*100):0,e.shouldReplace=e.savedTokens>=32&&e.savingsPct>=12),n.add({command:a,category:e.plan.category,mode:e.plan.mode==="passthrough"?"passthrough":"filtered",inputTokens:e.inputTokens,outputTokens:e.outputTokens,savedTokens:e.savedTokens,savingsPct:e.savingsPct,elapsedMs:Date.now()-t,isError:o.isError,rawRecoveryPath:e.rawRecoveryPath??h(o)}),!e.shouldReplace)return;const d=e.rawRecoveryPath??h(o),T=["",`[TokenSave: ${e.inputTokens} -> ${e.outputTokens} estimated tokens, saved ${e.savedTokens} (${e.savingsPct}%), mode=${e.plan.mode}, category=${e.plan.category}]`,d?`[Raw recovery: ${d}]`:void 0].filter(Boolean).join(`
+`);return{content:[{type:"text",text:`${e.filteredText}${T}`}],details:o.details}})}u($,"tokenSaveExtension");async function R(r,n,i,o,a,s){const t=await f(r,n.output,i),e=g(r,n.output,o);if(e&&e.length<t.filteredText.length&&(t.filteredText=e,t.outputTokens=Math.ceil(e.length/4),t.savedTokens=Math.max(0,t.inputTokens-t.outputTokens),t.savingsPct=t.inputTokens>0?Math.round(t.savedTokens/t.inputTokens*100):0,t.shouldReplace=t.savedTokens>=32&&t.savingsPct>=12),a.add({command:r,category:t.plan.category,mode:t.plan.mode==="passthrough"?"passthrough":"filtered",inputTokens:t.inputTokens,outputTokens:t.outputTokens,savedTokens:t.savedTokens,savingsPct:t.savingsPct,elapsedMs:Date.now()-s,isError:(n.exitCode??0)!==0,rawRecoveryPath:t.rawRecoveryPath??n.fullOutputPath}),!t.shouldReplace)return n;const l=["",`[TokenSave: ${t.inputTokens} -> ${t.outputTokens} estimated tokens, saved ${t.savedTokens} (${t.savingsPct}%), mode=${t.plan.mode}, category=${t.plan.category}]`,t.rawRecoveryPath?`[Raw recovery: ${t.rawRecoveryPath}]`:void 0].filter(Boolean).join(`
+`);return{...n,output:`${t.filteredText}${l}`,truncated:n.truncated,fullOutputPath:t.rawRecoveryPath??n.fullOutputPath}}u(R,"applyToBashResult");function g(r,n,i){for(const o of i)try{if(!new RegExp(o.commandPattern).test(r))continue;return v(o.filter,n)}catch{continue}}u(g,"applyConfiguredFilter");export{$ as default};

package/dist/extensions/builtin/token-save/lexer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * [WHO]: splitShellSegments() quote-aware shell segment lexer
+ * [FROM]: No runtime dependencies
+ * [TO]: Consumed by token-save rewrite registry and tests
+ * [HERE]: extensions/builtin/token-save/lexer.ts - conservative command boundary parser
+ */
+export interface ShellSegment {
+    text: string;
+    operator: "" | "&&" | "||" | ";" | "|";
+}
+export declare function splitShellSegments(command: string): ShellSegment[];

package/dist/extensions/builtin/token-save/lexer.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var u=(o,n)=>c(o,"name",{value:n,configurable:!0});function h(o){const n=[];let e="",r,f=!1;for(let i=0;i<o.length;i++){const t=o[i],s=o[i+1];if(f){e+=t,f=!1;continue}if(t==="\\"){e+=t,f=!0;continue}if(r){e+=t,t===r&&(r=void 0);continue}if(t==="'"||t==='"'||t==="`"){e+=t,r=t;continue}const l=`${t}${s??""}`;if(l==="&&"||l==="||"){n.push({text:e.trim(),operator:l}),e="",i++;continue}if(t===";"||t==="|"){n.push({text:e.trim(),operator:t}),e="";continue}e+=t}return e.trim()||n.length===0?n.push({text:e.trim(),operator:""}):n.length>0&&(n[n.length-1].operator=""),n.filter(i=>i.text||i.operator)}u(h,"splitShellSegments");export{h as splitShellSegments};