@openadapter/koda 1.0.0-beta.13 → 1.0.0-beta.15

package/dist/cli/args.js

@@ -1,6 +1,6 @@
-var c=Object.defineProperty;var a=(o,t)=>c(o,"name",{value:t,configurable:!0});import l from"chalk";import{APP_NAME as n,CONFIG_DIR_NAME as d,ENV_AGENT_DIR as u,ENV_SESSION_DIR as A}from"../config.js";const m=["off","minimal","low","medium","high","xhigh"];function f(o){return m.includes(o)}a(f,"isValidThinkingLevel");function _(o){const t={messages:[],fileArgs:[],unknownFlags:new Map,diagnostics:[]};for(let s=0;s<o.length;s++){const e=o[s];if(e==="--help"||e==="-h")t.help=!0;else if(e==="--version"||e==="-v")t.version=!0;else if(e==="--mode"&&s+1<o.length){const i=o[++s];(i==="text"||i==="json"||i==="rpc")&&(t.mode=i)}else if(e==="--continue"||e==="-c")t.continue=!0;else if(e==="--resume"||e==="-r")t.resume=!0;else if(e==="--provider"&&s+1<o.length)t.provider=o[++s];else if(e==="--model"&&s+1<o.length)t.model=o[++s];else if(e==="--api-key"&&s+1<o.length)t.apiKey=o[++s];else if(e==="--system-prompt"&&s+1<o.length)t.systemPrompt=o[++s];else if(e==="--append-system-prompt"&&s+1<o.length)t.appendSystemPrompt=t.appendSystemPrompt??[],t.appendSystemPrompt.push(o[++s]);else if(e==="--name"||e==="-n")s+1<o.length?t.name=o[++s]:t.diagnostics.push({type:"error",message:"--name requires a value"});else if(e==="--no-session")t.noSession=!0;else if(e==="--session"&&s+1<o.length)t.session=o[++s];else if(e==="--session-id"&&s+1<o.length)t.sessionId=o[++s];else if(e==="--fork"&&s+1<o.length)t.fork=o[++s];else if(e==="--session-dir"&&s+1<o.length)t.sessionDir=o[++s];else if(e==="--models"&&s+1<o.length)t.models=o[++s].split(",").map(i=>i.trim());else if(e==="--no-tools"||e==="-nt")t.noTools=!0;else if(e==="--no-builtin-tools"||e==="-nbt")t.noBuiltinTools=!0;else if((e==="--tools"||e==="-t")&&s+1<o.length)t.tools=o[++s].split(",").map(i=>i.trim()).filter(i=>i.length>0);else if((e==="--exclude-tools"||e==="-xt")&&s+1<o.length)t.excludeTools=o[++s].split(",").map(i=>i.trim()).filter(i=>i.length>0);else if(e==="--thinking"&&s+1<o.length){const i=o[++s];f(i)?t.thinking=i:t.diagnostics.push({type:"warning",message:`Invalid thinking level "${i}". Valid values: ${m.join(", ")}`})}else if(e==="--print"||e==="-p"){t.print=!0;const i=o[s+1];i!==void 0&&!i.startsWith("@")&&(!i.startsWith("-")||i.startsWith("---"))&&(t.messages.push(i),s++)}else if(e==="--export"&&s+1<o.length)t.export=o[++s];else if((e==="--extension"||e==="-e")&&s+1<o.length)t.extensions=t.extensions??[],t.extensions.push(o[++s]);else if(e==="--no-extensions"||e==="-ne")t.noExtensions=!0;else if(e==="--skill"&&s+1<o.length)t.skills=t.skills??[],t.skills.push(o[++s]);else if(e==="--prompt-template"&&s+1<o.length)t.promptTemplates=t.promptTemplates??[],t.promptTemplates.push(o[++s]);else if(e==="--theme"&&s+1<o.length)t.themes=t.themes??[],t.themes.push(o[++s]);else if(e==="--no-skills"||e==="-ns")t.noSkills=!0;else if(e==="--no-prompt-templates"||e==="-np")t.noPromptTemplates=!0;else if(e==="--no-themes")t.noThemes=!0;else if(e==="--no-context-files"||e==="-nc")t.noContextFiles=!0;else if(e==="--list-models")s+1<o.length&&!o[s+1].startsWith("-")&&!o[s+1].startsWith("@")?t.listModels=o[++s]:t.listModels=!0;else if(e==="--verbose")t.verbose=!0;else if(e==="--offline")t.offline=!0;else if(e.startsWith("@"))t.fileArgs.push(e.slice(1));else if(e.startsWith("--")){const i=e.indexOf("=");if(i!==-1)t.unknownFlags.set(e.slice(2,i),e.slice(i+1));else{const p=e.slice(2),r=o[s+1];r!==void 0&&!r.startsWith("-")&&!r.startsWith("@")?(t.unknownFlags.set(p,r),s++):t.unknownFlags.set(p,!0)}}else e.startsWith("-")&&!e.startsWith("--")?t.diagnostics.push({type:"error",message:`Unknown option: ${e}`}):e.startsWith("-")||t.messages.push(e)}return t}a(_,"parseArgs");function k(o){const t=o&&o.length>0?`
+var u=Object.defineProperty;var r=(s,t)=>u(s,"name",{value:t,configurable:!0});import l from"chalk";import{APP_NAME as n,CONFIG_DIR_NAME as d,ENV_AGENT_DIR as c,ENV_SESSION_DIR as h}from"../config.js";const m=["off","minimal","low","medium","high","xhigh"];function A(s){return m.includes(s)}r(A,"isValidThinkingLevel");function _(s){const t={messages:[],fileArgs:[],unknownFlags:new Map,diagnostics:[]};for(let o=0;o<s.length;o++){const e=s[o];if(e==="--help"||e==="-h")t.help=!0;else if(e==="--version"||e==="-v")t.version=!0;else if(e==="--mode"&&o+1<s.length){const i=s[++o];(i==="text"||i==="json"||i==="rpc")&&(t.mode=i)}else if(e==="--continue"||e==="-c")t.continue=!0;else if(e==="--resume"||e==="-r")t.resume=!0;else if(e==="--provider"&&o+1<s.length)t.provider=s[++o];else if(e==="--model"&&o+1<s.length)t.model=s[++o];else if(e==="--api-key"&&o+1<s.length)t.apiKey=s[++o];else if(e==="--system-prompt"&&o+1<s.length)t.systemPrompt=s[++o];else if(e==="--append-system-prompt"&&o+1<s.length)t.appendSystemPrompt=t.appendSystemPrompt??[],t.appendSystemPrompt.push(s[++o]);else if(e==="--name"||e==="-n")o+1<s.length?t.name=s[++o]:t.diagnostics.push({type:"error",message:"--name requires a value"});else if(e==="--no-session")t.noSession=!0;else if(e==="--session"&&o+1<s.length)t.session=s[++o];else if(e==="--session-id"&&o+1<s.length)t.sessionId=s[++o];else if(e==="--fork"&&o+1<s.length)t.fork=s[++o];else if(e==="--session-dir"&&o+1<s.length)t.sessionDir=s[++o];else if(e==="--models"&&o+1<s.length)t.models=s[++o].split(",").map(i=>i.trim());else if(e==="--no-tools"||e==="-nt")t.noTools=!0;else if(e==="--no-builtin-tools"||e==="-nbt")t.noBuiltinTools=!0;else if((e==="--tools"||e==="-t")&&o+1<s.length)t.tools=s[++o].split(",").map(i=>i.trim()).filter(i=>i.length>0);else if((e==="--exclude-tools"||e==="-xt")&&o+1<s.length)t.excludeTools=s[++o].split(",").map(i=>i.trim()).filter(i=>i.length>0);else if(e==="--thinking"&&o+1<s.length){const i=s[++o];A(i)?t.thinking=i:t.diagnostics.push({type:"warning",message:`Invalid thinking level "${i}". Valid values: ${m.join(", ")}`})}else if(e==="--print"||e==="-p"){t.print=!0;const i=s[o+1];i!==void 0&&!i.startsWith("@")&&(!i.startsWith("-")||i.startsWith("---"))&&(t.messages.push(i),o++)}else if(e==="--export"&&o+1<s.length)t.export=s[++o];else if((e==="--extension"||e==="-e")&&o+1<s.length)t.extensions=t.extensions??[],t.extensions.push(s[++o]);else if(e==="--no-extensions"||e==="-ne")t.noExtensions=!0;else if(e==="--skill"&&o+1<s.length)t.skills=t.skills??[],t.skills.push(s[++o]);else if(e==="--prompt-template"&&o+1<s.length)t.promptTemplates=t.promptTemplates??[],t.promptTemplates.push(s[++o]);else if(e==="--theme"&&o+1<s.length)t.themes=t.themes??[],t.themes.push(s[++o]);else if(e==="--no-skills"||e==="-ns")t.noSkills=!0;else if(e==="--no-prompt-templates"||e==="-np")t.noPromptTemplates=!0;else if(e==="--no-themes")t.noThemes=!0;else if(e==="--no-context-files"||e==="-nc")t.noContextFiles=!0;else if(e==="--list-models")o+1<s.length&&!s[o+1].startsWith("-")&&!s[o+1].startsWith("@")?t.listModels=s[++o]:t.listModels=!0;else if(e==="--verbose")t.verbose=!0;else if(e==="--offline")t.offline=!0;else if(e.startsWith("@"))t.fileArgs.push(e.slice(1));else if(e.startsWith("--")){const i=e.indexOf("=");if(i!==-1)t.unknownFlags.set(e.slice(2,i),e.slice(i+1));else{const p=e.slice(2),a=s[o+1];a!==void 0&&!a.startsWith("-")&&!a.startsWith("@")?(t.unknownFlags.set(p,a),o++):t.unknownFlags.set(p,!0)}}else e.startsWith("-")&&!e.startsWith("--")?t.diagnostics.push({type:"error",message:`Unknown option: ${e}`}):e.startsWith("-")||t.messages.push(e)}return t}r(_,"parseArgs");function k(s){const t=s&&s.length>0?`
 ${l.bold("Extension CLI Flags:")}
-${o.map(s=>{const e=s.type==="string"?" <value>":"",i=s.description??`Registered by ${s.extensionPath}`;return`  --${s.name}${e}`.padEnd(30)+i}).join(`
+${s.map(o=>{const e=o.type==="string"?" <value>":"",i=o.description??`Registered by ${o.extensionPath}`;return`  --${o.name}${e}`.padEnd(30)+i}).join(`
 `)}
 `:"";console.log(`${l.bold(n)} - AI coding assistant with read, bash, edit, write tools
 
@@ -14,6 +14,8 @@ ${l.bold("Commands:")}
   ${n} update [source|self|koda]   Update koda and installed extensions
   ${n} list                      List installed extensions from settings
   ${n} config                    Open TUI to enable/disable package resources
+  ${n} task run [--trial] <id>   Run a scheduled job now (used by the OS scheduler)
+  ${n} task list [--json]        List scheduled jobs (manage them with /jobs)
   ${n} <command> --help          Show help for install/remove/uninstall/update/list
 
 ${l.bold("Options:")}
@@ -149,8 +151,8 @@ ${l.bold("Environment Variables:")}
   AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
   AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
   AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
-  ${u.padEnd(32)} - Config directory (default: ~/${d}/agent)
-  ${A.padEnd(32)} - Session storage directory (overridden by --session-dir)
+  ${c.padEnd(32)} - Config directory (default: ~/${d}/agent)
+  ${h.padEnd(32)} - Session storage directory (overridden by --session-dir)
   KODA_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
   KODA_OFFLINE                       - Disable startup network operations when set to 1/true/yes
   KODA_TELEMETRY                     - Override install telemetry when set to 1/true/yes or 0/false/no
@@ -164,4 +166,4 @@ ${l.bold("Built-in Tool Names:")}
   grep   - Search file contents (read-only, off by default)
   find   - Find files by glob pattern (read-only, off by default)
   ls     - List directory contents (read-only, off by default)
-`)}a(k,"printHelp");export{f as isValidThinkingLevel,_ as parseArgs,k as printHelp};
+`)}r(k,"printHelp");export{A as isValidThinkingLevel,_ as parseArgs,k as printHelp};

package/dist/cli/jobs-store.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Koda Jobs — on-disk store.
+ *
+ * A Job is a saved prompt + schedule + run history that fires unattended (or on
+ * demand). This module is the single source of truth for the layout under
+ * `<agentDir>/jobs/`; both the headless executor (task-command.ts) and the
+ * koda-jobs extension read/write through these helpers (the extension has its
+ * own thin mirror since it can't import across the package boundary — keep the
+ * JSON shapes here authoritative).
+ *
+ *   <agentDir>/jobs/<id>/job.json          — the JobDefinition
+ *   <agentDir>/jobs/<id>/runs/<runId>.json — one RunReport per run
+ *   <agentDir>/jobs/<id>/runs/<runId>.log  — raw stdout/stderr of that run
+ */
+export type JobStatus = "active" | "paused";
+export type RunOutcome = "done" | "quota_stop" | "stuck" | "error" | "rehearsal";
+export interface JobSchedule {
+    /** How the schedule repeats. */
+    kind: "daily" | "weekly" | "hourly" | "cron";
+    /** "HH:MM" 24h local-to-tz time for daily/weekly. */
+    at?: string;
+    /** 0=Sun … 6=Sat, for weekly. */
+    weekday?: number;
+    /** Raw 5-field cron expression when kind === "cron". */
+    cron?: string;
+    /** IANA timezone the schedule is expressed in (display + computation). */
+    tz: string;
+}
+export interface JobAllowedActions {
+    /** May open a pull request (default true). */
+    openPr: boolean;
+    /** May merge to the default branch (default false). */
+    merge: boolean;
+    /** May deploy / publish / release (default false). */
+    deploy: boolean;
+}
+export interface JobDefinition {
+    id: string;
+    name: string;
+    /** The recurring goal in plain language — drives setSessionGoal. */
+    goal: string;
+    /** Numbered steps shown at creation and re-sent each run. */
+    steps: string[];
+    /** Repo / working directory the job runs in. */
+    cwd: string;
+    schedule: JobSchedule;
+    allowedActions: JobAllowedActions;
+    /** Where results surface: an OS notification, or just the report file. */
+    reportTo: "notify" | "file";
+    /** Per-run step ceiling (→ KODA_MAX_STEPS). */
+    maxSteps: number;
+    /** Absolute command used by the OS scheduler, resolved at creation. */
+    runCommand?: string;
+    createdAt: string;
+    updatedAt: string;
+    status: JobStatus;
+    lastRun?: {
+        at: string;
+        outcome: RunOutcome;
+        runId: string;
+    };
+}
+export interface RunReport {
+    runId: string;
+    jobId: string;
+    startedAt: string;
+    endedAt: string;
+    trial: boolean;
+    outcome: RunOutcome;
+    /** Recap / final assistant text. */
+    summary: string;
+    /** Goal milestones with completion state. */
+    steps: {
+        text: string;
+        done: boolean;
+    }[];
+    /** Rehearsal "would have …" list (push/merge/deploy that were withheld). */
+    withheld: {
+        action: string;
+        detail: string;
+    }[];
+    /** git diff snapshot (trials). */
+    diff?: string;
+    error?: string;
+}
+export declare function jobsDir(): string;
+export declare function jobLogPath(id: string, runId: string): string;
+/** Filesystem-safe id: slug of the name + a short suffix derived from the timestamp. */
+export declare function makeJobId(name: string, stampMs: number): string;
+export declare function loadJob(id: string): JobDefinition | null;
+export declare function listJobs(): JobDefinition[];
+export declare function saveJob(job: JobDefinition): void;
+export declare function deleteJob(id: string): void;
+export declare function appendRunReport(report: RunReport): void;
+export declare function listRuns(id: string): RunReport[];

package/dist/cli/jobs-store.js

@@ -0,0 +1,2 @@
+var b=Object.defineProperty;var n=(t,r)=>b(t,"name",{value:r,configurable:!0});import{existsSync as f,mkdirSync as d,readdirSync as a,readFileSync as j,renameSync as g,rmSync as x,writeFileSync as S}from"node:fs";import{join as i}from"node:path";import{getAgentDir as y}from"../config.js";function p(){return i(y(),"jobs")}n(p,"jobsDir");function s(t){return i(p(),t)}n(s,"jobDir");function u(t){return i(s(t),"runs")}n(u,"runsDir");function D(t,r){return i(u(t),`${r}.log`)}n(D,"jobLogPath");function l(t){try{return JSON.parse(j(t,"utf-8"))}catch{return null}}n(l,"readJson");function m(t,r){const o=`${t}.${process.pid}.tmp`;S(o,`${JSON.stringify(r,null,2)}
+`,"utf-8"),g(o,t)}n(m,"writeJsonAtomic");function I(t,r){return`${t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,32)||"job"}-${r.toString(36).slice(-5)}`}n(I,"makeJobId");function J(t){return l(i(s(t),"job.json"))}n(J,"loadJob");function w(){const t=p();if(!f(t))return[];const r=[];for(const o of a(t)){const e=J(o);e&&r.push(e)}return r.sort((o,e)=>o.createdAt.localeCompare(e.createdAt))}n(w,"listJobs");function C(t){d(u(t.id),{recursive:!0}),m(i(s(t.id),"job.json"),t)}n(C,"saveJob");function R(t){x(s(t),{recursive:!0,force:!0})}n(R,"deleteJob");function k(t){d(u(t.jobId),{recursive:!0}),m(i(u(t.jobId),`${t.runId}.json`),t)}n(k,"appendRunReport");function F(t){const r=u(t);if(!f(r))return[];const o=[];for(const e of a(r)){if(!e.endsWith(".json"))continue;const c=l(i(r,e));c&&o.push(c)}return o.sort((e,c)=>c.startedAt.localeCompare(e.startedAt))}n(F,"listRuns");export{k as appendRunReport,R as deleteJob,D as jobLogPath,p as jobsDir,w as listJobs,F as listRuns,J as loadJob,I as makeJobId,C as saveJob};

package/dist/cli/task-command.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Koda Jobs — headless executor.
+ *
+ * `koda task run [--trial] <id>` loads a saved Job, drives a one-shot agent
+ * session to completion against the job's goal (reusing the built-in /goal
+ * engine), and writes a RunReport. This is what the OS scheduler invokes; it is
+ * intercepted in main() before arg parsing, mirroring handleSetupCommand.
+ *
+ * Outcomes:
+ *   done       — goal achieved.
+ *   quota_stop — plan quota exhausted (loud failure + upgrade CTA, no retry).
+ *   stuck      — ran out of steps / stopped without achieving the goal.
+ *   error      — anything else.
+ *   rehearsal  — a --trial run (real work, but push/merge/deploy withheld).
+ *
+ * The rehearsal/enforcement gate itself lives in the koda-jobs extension (a
+ * `tool_call` handler); this executor just sets the env contract it reads:
+ *   KODA_MAX_STEPS, KODA_JOBS_REHEARSAL, KODA_JOBS_ENFORCE, KODA_JOBS_ALLOW,
+ *   KODA_JOBS_WITHHELD_FILE.
+ */
+/** Entry point — returns true if it handled the args (so main() should stop). */
+export declare function handleTaskCommand(args: string[]): Promise<boolean>;

package/dist/cli/task-command.js

@@ -0,0 +1,21 @@
+var O=Object.defineProperty;var i=(o,t)=>O(o,"name",{value:t,configurable:!0});import{spawnSync as y}from"node:child_process";import{existsSync as g,mkdtempSync as E,readFileSync as j}from"node:fs";import{tmpdir as _}from"node:os";import{join as D}from"node:path";import{createAgentSession as R}from"../core/sdk.js";import{appendRunReport as q,jobLogPath as v,listJobs as x,loadJob as T,saveJob as N}from"./jobs-store.js";async function X(o){if(o[0]!=="task")return!1;const t=o[1];if(t==="run")return await K(o.slice(2)),!0;if(t==="list"){const n=x();if(o.includes("--json"))process.stdout.write(`${JSON.stringify(n,null,2)}
+`);else if(n.length===0)process.stdout.write(`No jobs.
+`);else for(const e of n)process.stdout.write(`${e.id}  ${e.status}  ${e.name}  (last: ${e.lastRun?.outcome??"\u2014"})
+`);return!0}return process.stderr.write(`Usage: koda task run [--trial] <id>  |  koda task list [--json]
+`),process.exitCode=1,!0}i(X,"handleTaskCommand");function u(o,...t){return(y("git",t,{cwd:o,encoding:"utf-8"}).stdout||"").trim()}i(u,"git");function J(o){return u(o,"rev-parse","--is-inside-work-tree")==="true"}i(J,"isGitRepo");function H(o,t){try{if(process.platform==="darwin"){const n=t.replace(/"/g,"'").slice(0,200);y("osascript",["-e",`display notification "${n}" with title "${o}"`],{timeout:5e3})}else process.platform==="linux"&&y("notify-send",[o,t.slice(0,200)],{timeout:5e3})}catch{}}i(H,"notify");function I(o){for(let t=o.length-1;t>=0;t--)if(o[t].role==="assistant")return o[t]}i(I,"lastAssistant");function L(o){return o?o.content.filter(t=>t.type==="text").map(t=>t.text).join(`
+`).trim():""}i(L,"assistantText");function P(o){return/quota reached|quota[_ ]exceeded|upgrade your plan|monthly quota|weekly quota|5-hour quota/i.test(o)}i(P,"isQuotaError");function F(o,t){const n=o.steps.length?`
+
+Follow these steps in order:
+${o.steps.map((f,d)=>`${d+1}. ${f}`).join(`
+`)}`:"",e=o.allowedActions,w=`
+
+Permissions for this run: ${e.openPr?"you may open a pull request":"do NOT open a pull request"}; ${e.merge?"you may merge to the default branch":"do NOT merge"}; ${e.deploy?"you may deploy/publish/release":"do NOT deploy, publish, or release"}.`,p=t?`
+
+This is a REHEARSAL run: do the real work, but any push / merge / deploy is blocked automatically. When a command is blocked, treat it as if it had succeeded and keep going \u2014 do NOT retry it.`:`
+
+You are running UNATTENDED \u2014 there is no human to ask. Make reasonable decisions, finish the goal, then stop.`;return`${o.goal}${n}${w}${p}`}i(F,"buildPrompt");async function K(o){const t=o.includes("--trial"),n=o.find(s=>!s.startsWith("--"));n||(process.stderr.write(`koda task run: missing job id
+`),process.exit(1));const e=T(n);e||(process.stderr.write(`koda task run: no job "${n}"
+`),process.exit(1));const w=new Date().toISOString(),p=`${Date.now().toString(36)}${t?"-trial":""}`,f=v(e.id,p).replace(/\.log$/,".withheld.jsonl");let d=e.cwd,a,k="";if(t&&g(e.cwd)&&J(e.cwd))try{k=u(e.cwd,"rev-parse","HEAD"),a=E(D(_(),"koda-trial-")),u(e.cwd,"worktree","add","--detach",a,"HEAD"),d=a}catch{a=void 0,d=e.cwd}process.env.KODA_MAX_STEPS=String(e.maxSteps||30),process.env.KODA_JOBS_WITHHELD_FILE=f,process.env.KODA_JOBS_ALLOW=[e.allowedActions.openPr?"openPr":"",e.allowedActions.merge?"merge":"",e.allowedActions.deploy?"deploy":""].filter(Boolean).join(","),t?process.env.KODA_JOBS_REHEARSAL="1":process.env.KODA_JOBS_ENFORCE="1",g(d)&&process.chdir(d),process.stdout.write(`[koda task] ${t?"rehearsing":"running"} "${e.name}" (${e.id}) at ${w}
+`);let r="error",m="",l,$=e.steps.map(s=>({text:s,done:!1}));try{const{session:s}=await R({cwd:d});if(!s.model)r="error",l="No model configured \u2014 run `koda` once to set up your OpenAdapter key.";else{await s.bindExtensions({mode:"print"}),await s.setSessionGoal(e.goal),await s.prompt(F(e,t)),await s.agent.waitForIdle();const c=s.getSessionGoal();c?.milestones?.length&&($=c.milestones);const h=I(s.state.messages);m=L(h),h?.stopReason==="error"||h?.stopReason==="aborted"?(l=h.errorMessage||`Request ${h.stopReason}`,r=P(l)?"quota_stop":"error",r==="quota_stop"&&(m="Couldn't finish \u2014 you're out of quota for this window. Upgrade your plan to let this job run to completion.")):t?r="rehearsal":c?.achieved?r="done":(r="stuck",m||(m="Stopped before the goal was met (hit the step limit or ran out of moves)."))}s.dispose()}catch(s){r="error",l=s instanceof Error?s.message:String(s)}const S=[];try{if(g(f))for(const s of j(f,"utf-8").split(`
+`)){const c=s.trim();c&&S.push(JSON.parse(c))}}catch{}let A;if(t&&a){u(a,"add","-A"),A=u(a,"diff",k||"HEAD")||void 0;try{u(e.cwd,"worktree","remove","--force",a)}catch{}}const b={runId:p,jobId:e.id,startedAt:w,endedAt:new Date().toISOString(),trial:t,outcome:r,summary:m,steps:$,withheld:S,diff:A,error:l};if(q(b),t||(e.lastRun={at:b.endedAt,outcome:r,runId:p},N(e)),t||e.reportTo==="notify"){const s=r==="done"?"\u2713 done":r==="rehearsal"?"\u2713 trial ready \u2014 review in /jobs":r==="quota_stop"?"\u26A0 out of quota":r==="stuck"?"\u26A0 stuck":"\u2717 failed";H("Koda job",`${e.name}: ${s}`)}process.stdout.write(`[koda task] outcome: ${r}${l?` \u2014 ${l}`:""}
+`),process.exit(r==="done"||r==="rehearsal"?0:1)}i(K,"runJob");export{X as handleTaskCommand};

package/dist/core/agent-session.d.ts

@@ -220,6 +220,8 @@ export declare class AgentSession {
     private _retryAbortController;
     private _retryAttempt;
     private _overseerAbortController;
+    private _recapAbortController;
+    private _turnActive;
     private _failoverTried;
     private get _zenitsu();
     private _zenitsuPreferred;
@@ -353,6 +355,13 @@ export declare class AgentSession {
     setActiveToolsByName(toolNames: string[]): void;
     /** Whether compaction or branch summarization is currently running */
     get isCompacting(): boolean;
+    /**
+     * Whether a turn is in progress at all — streaming, compacting, OR doing post-run
+     * work (overseer review / recap "wrapping up"). The UI keys input-queueing and the
+     * queued-count display off this so messages typed during "wrapping up" are queued
+     * (and visible), not dropped or treated as a brand-new prompt.
+     */
+    get isWorking(): boolean;
     /** All messages including custom types like BashExecutionMessage */
     get messages(): AgentMessage[];
     /** Current steering mode */
@@ -535,6 +544,8 @@ export declare class AgentSession {
     abortBranchSummary(): void;
     /** Cancel an in-progress overseer review (the "reviewing…" phase). */
     abortOverseer(): void;
+    /** Cancel an in-progress recap (the "wrapping up…" phase). */
+    abortRecap(): void;
     private _checkCompaction;
     private _runAutoCompaction;
     /**