@corenel/term 0.2.9 → 0.3.0

package/dist/session.d.ts

@@ -4,7 +4,8 @@ import type { AgentEvent, AgentTool, AskAnswers, AskQuestion, CompressionConfig,
 import { type RunAgentArgs, type RunAgentResult } from '@corenel/harness/core/loop';
 import { type ModelRates } from '@corenel/harness/core/pricing';
 import type { PermissionService } from '@corenel/harness/guardrail/permission-service';
-import { type CommittedItem, type PaletteEntry, type TuiState } from './state';
+import { type CommittedItem, type McpServerView, type PaletteEntry, type TuiState } from './state';
+import { type ContextSnapshot } from './contextText';
 import { type ReadExisting } from './writePreview';
 import { type SessionPersistence } from './persist';
 import type { PolicySource } from './policySource';
@@ -35,6 +36,29 @@ export interface TermSessionDeps {
      * (or returning null) means no cost is displayed at all -- see TuiState's
      * `costUsd` for why that is silence rather than $0.00. */
     rates?: () => ModelRates | null;
+    /** The model's context window in tokens, or `null` when nothing sizes it --
+     * for `/context`'s fill fraction. A GETTER, for the same reason `rates` is
+     * one just above: this codebase keeps reintroducing the bug of a value
+     * captured once at construction going stale. The model itself is fixed for
+     * a session (`/model <id>` refuses -- see `listModels`'s field doc), so in
+     * practice this returns the same number every time today; the getter
+     * exists so that fact stays a consequence of how the loop is wired, not
+     * something this package has to assume. Absent, or returning `null`, means
+     * `/context` shows the raw token count sent and says the window is unknown
+     * -- see contextText.ts's honesty rule -- never a percentage against a
+     * guess. */
+    contextWindow?: () => number | null;
+    /** The models this host knows about, for `/model` (list only). The model is
+     * FIXED once a session begins -- `resolveContextWindow(model)` runs ONCE at
+     * launch (packages/cli/src/cli.ts's `resolvedWindow`) and sizes rung-2
+     * compaction from it; switching to a model with a SMALLER window mid-session
+     * would leave compaction sized for the larger one and the loop would meet
+     * the context wall as a fatal 400 instead of compacting in time. So `/model
+     * <id>` refuses (see `runModelCommand`) and there is no `setModel` dep --
+     * changing the model requires reprocessing the session, which is not
+     * implemented (see docs/BACKLOG.md section 5). `/model` with no id still
+     * lists what's available -- that's read-only. */
+    listModels?: () => Promise<PaletteEntry[]>;
     /** The agent modes the host has configured, for `/mode` (list + validate). */
     listModes?: () => Promise<PaletteEntry[]>;
     /** Switch the CURRENT mode. Only takes effect once `system` (above) is next
@@ -96,6 +120,11 @@ export interface TermSessionDeps {
      * no node dependency — the same pattern as `persistence` and `toolCtx`. Omit
      * to run with offload disabled, same as before this dep existed. */
     compression?: CompressionConfig;
+    /** Rung-2 history compaction, forwarded to the loop the same way
+     * `compression` is. A REPL conversation is long by nature, so this is the
+     * face most likely to reach the wall; omit it and the session behaves as it
+     * did before — which is to say it dies on a fatal 400 when it gets there. */
+    compaction?: RunAgentArgs['compaction'];
     /** Told the conversation's session id whenever it becomes known or changes —
      * once after `resume()` loads an existing session, and again after every
      * `persist()` assigns/confirms one. A host that offloads tool results into a
@@ -119,6 +148,17 @@ export interface TermSessionDeps {
      * every other host-supplied command in this file. */
     policy?: Policy;
     policySource?: PolicySource;
+    /** The MCP servers this host can see, for `/mcp`. Absent means the command
+     *  reports itself unavailable, exactly like /policy without a policy. */
+    listMcpServers?: () => Promise<McpServerView[]>;
+    addMcpServer?: (name: string, url: string) => Promise<void>;
+    removeMcpServer?: (name: string) => Promise<void>;
+    loginMcpServer?: (name: string, onUrl: (url: string) => void) => Promise<void>;
+    refreshMcpServer?: (server?: string) => Promise<void>;
+    /** Clear the stored OAuth client registration for a server, so the next
+     *  `/mcp login` registers afresh. See the CLI's `McpAdmin.forget` for why
+     *  this is always a local write. */
+    forgetMcpServer?: (name: string) => Promise<void>;
 }
 /** Deltas arrive per token; re-rendering React that often thrashes for output
  * no eye can follow. They coalesce on this interval instead. */
@@ -181,6 +221,13 @@ export declare class TermSession {
      * reach a renderer. */
     private pendingSkill;
     wantsExit: boolean;
+    /** The last line that was WARNED ABOUT rather than sent, because its first
+     * word after `/` looked like a command but wasn't one -- see `submit`. Set
+     * on the warn, cleared the moment anything else happens (a different line,
+     * a real command, an empty line): only an EXACT resubmission of this same
+     * text counts as "I meant it, send it anyway". `null` means nothing is
+     * pending. */
+    private lastRejectedLine;
     constructor(deps: TermSessionDeps);
     attachPermission(p: PermissionService): void;
     historyForTest(): ChatCompletionMessageParam[];
@@ -256,7 +303,28 @@ export declare class TermSession {
      * no ordinal to show. */
     private ordFor;
     handleEvent(e: AgentEvent): void;
-    /** Route one line: a command runs here; anything else is a turn. */
+    /** Whether calling `submit(text)` right now would warn-and-refuse rather
+     * than run a command or send a message -- i.e. `text`'s first word after a
+     * leading `/` looks like a command attempt but isn't one, AND this isn't
+     * already the resend of a line that was just warned about. PURE: does not
+     * touch `lastRejectedLine` or commit anything, so a caller can check it
+     * before deciding what to do with the input box (see ink/index.tsx's
+     * onSubmit, which must NOT clear the box for the line this reports true
+     * for) without racing `submit`'s own mutation of the same state. */
+    willReject(text: string): boolean;
+    /** Route one line: a command runs here; anything else is a turn -- UNLESS
+     * the first word after a leading `/` looks like a command attempt and
+     * isn't one (see commands.ts's `isKnownCommandWord`), in which case the
+     * FIRST Enter on that exact text warns and stops rather than paying for a
+     * model call on a typo (`/context` before Feature 2 added it, `/toosl`,
+     * `/hepl`, ...). A SECOND Enter on the identical, unchanged line is taken
+     * as "I meant it" and sent as an ordinary message -- tracked in
+     * `lastRejectedLine`, which both faces share automatically since it lives
+     * here rather than in either face's own state: the Ink face keeps the text
+     * in the input box (ink/index.tsx checks `willReject` before clearing it)
+     * so retyping Enter resubmits the SAME string; the readline face has no
+     * input box to hold onto, so there the "second Enter" is the user
+     * retyping the line themselves -- an honest equivalent, not a shortcut. */
     submit(text: string): Promise<void>;
     /** Run `line` as a turn now, or queue it, exactly like `submit` does for
      * ordinary text -- factored out so `/strategy` (runCommand) can send its
@@ -279,14 +347,112 @@ export declare class TermSession {
      * host call here, not just the two that are known to need it, means the
      * NEXT one added can't reintroduce the same gap by omission. */
     private safeCall;
-    /** Shared `/mode` and `/persona` shape: no id lists what's configured, an
+    /** Shared `/mode`/`/persona` shape: no id lists what's configured, an
      * unknown id reports the valid options (never silently no-ops, never sends
-     * a typo through to the model), a real id applies immediately -- "applies"
-     * meaning `deps.system` will pick it up on the NEXT `resolveSystem()` call,
-     * not this instant (see the field docs on TermSessionDeps.system). */
+     * a typo through to the model), a real id applies immediately.
+     *
+     * "applies" means `deps.system` will pick it up on the NEXT
+     * `resolveSystem()` call, not this instant (see the field docs on
+     * TermSessionDeps.system) -- `opts.apply` (the host's `setMode`/
+     * `setPersona`) is the whole story there.
+     *
+     * `/model` does NOT go through here -- see `runModelCommand`: the model is
+     * fixed for a session, so there is nothing for it to apply. */
     private switchIdentity;
+    /** `/model` -- READ-ONLY. No id lists what's available (see `listModels`'s
+     * field doc for why); an id refuses rather than switching, because the
+     * model is fixed for the life of a session -- `resolveContextWindow(model)`
+     * runs once at launch and sizes rung-2 compaction from it, so a downward
+     * switch would leave compaction believing it has a bigger window than the
+     * model actually has and the conversation would meet the context wall as a
+     * fatal 400 instead of compacting in time. Changing the model requires
+     * reprocessing the session, which is not implemented (docs/BACKLOG.md
+     * section 5) -- the remedy is a restart with `--model <id>`, not this
+     * command. Routed through `safeCall` for the listing, same guard every
+     * other identity command uses. */
+    private runModelCommand;
     private armSkillCommand;
     private runStrategyCommand;
+    /** Like `safeCall`, but for `/mcp`'s own host calls -- a SEPARATE wrapper,
+     * not a shared message, because the failure shape is different in kind.
+     * `safeCall`'s "not available -- could not read the config workspace"
+     * framing was written for `/mode`/`/persona`: there, a throw really does
+     * mean the config workspace itself is broken. An MCP host call throwing is
+     * usually something else entirely -- `McpAdmin`'s write methods
+     * (packages/cli/src/mcpAdmin.ts) return `Promise<void>` with no result
+     * channel, so a REFUSAL (a duplicate name, a daemon saying no, a failed
+     * sign-in) surfaces as a thrown Error too, indistinguishable by shape from
+     * a real transport failure. Telling the user the command is "not
+     * available" when it ran and was refused is actively wrong -- it says "try
+     * nothing" when the honest answer is "try something else, here is why this
+     * attempt didn't work". So this wrapper names the ACTION and reports the
+     * underlying reason verbatim, and leaves `safeCall` untouched for the four
+     * callers whose failure really is "could not read the config workspace". */
+    private safeMcpCall;
+    /** `/mcp` and its subcommands -- what is connected, and sign in or add one.
+     * `listMcpServers` gates the whole command, the same way `deps.policy` gates
+     * `/policy`: a host that wires none of the five deps reports `/mcp` itself
+     * unavailable rather than half-working. Each mutating subcommand ALSO checks
+     * its own specific dep, so a host that wires read-only `listMcpServers` still
+     * gets a working `/mcp list` instead of every subcommand failing alike.
+     *
+     * `unknown` carries a subcommand `parseCommand` did not recognize -- see
+     * commands.ts's `mcp` case. It is rejected BY NAME rather than aliased to
+     * `list` (a typo must never produce ordinary-looking output with nothing
+     * to say it was not understood) and rather than reaching here as `null`
+     * from the parser (which would send it to the model as a chat message --
+     * worse still: a silent misfire that LOOKS like an answer). */
+    private runMcpCommand;
+    /** `/mcp` with no argument, from the Ink face only -- see the module doc
+     * above. Fetches the current servers and opens the manager. */
+    openMcpManager(): Promise<void>;
+    /** esc, or any other reason the overlay should close -- a no-op unless the
+     * manager is actually the modal open right now, so it can never steal a
+     * permission or question modal's close. */
+    closeMcpManager(): void;
+    /** `/help` with no argument, from the Ink face only -- see the module doc
+     * above. */
+    openHelp(): void;
+    /** esc, or any other reason the overlay should close -- a no-op unless the
+     * help overlay is actually the modal open right now, so it can never steal
+     * a permission, question, or MCP modal's close. */
+    closeHelp(): void;
+    /** The data `formatContext` (contextText.ts) needs, assembled from
+     * `TuiState`'s own accumulators and the two host-supplied static facts
+     * (`deps.tools.length`, `deps.contextWindow()`) -- called fresh by both
+     * `runCommand`'s `'context'` case and the Ink overlay's render, never
+     * cached, so neither face can show a stale window size after `/context`'s
+     * OWN state changes mid-turn. */
+    contextSnapshot(): ContextSnapshot;
+    /** `/context` with no argument, from the Ink face only -- see the module
+     * doc above. Needs no host dep and nothing to fetch -- opening it is just
+     * setting the modal. */
+    openContext(): void;
+    /** esc, or any other reason the context overlay should close -- a no-op
+     * unless the context overlay is actually the modal open right now, so it
+     * can never steal a permission, question, help, or MCP modal's close. */
+    closeContext(): void;
+    /** Up/down inside the overlay -- wraps, and does nothing with zero rows. */
+    moveMcpSelection(delta: number): void;
+    /** `x` inside the overlay -- removes the selected row via the same
+     * `removeMcpServer` dep `/mcp remove` uses, then refreshes the list. */
+    removeMcpSelection(): Promise<void>;
+    /** `l` inside the overlay -- signs the selected row in via the same
+     * `loginMcpServer` dep `/mcp login` uses. The consent URL genuinely
+     * arrives before the sign-in itself completes (a daemon message, or a
+     * synchronous callback locally), so `modal.login.url` is updated live as
+     * it arrives rather than buffered until the whole call resolves. */
+    loginMcpSelection(): Promise<void>;
+    /** `r` inside the overlay -- refreshes the selected row via the same
+     * `refreshMcpServer` dep `/mcp refresh` uses, then refreshes the list so
+     * the updated tool count and age show without the user reopening the
+     * overlay. Same shape as `removeMcpSelection` above. */
+    refreshMcpSelection(): Promise<void>;
+    /** Re-fetches `listMcpServers` and replaces the overlay's snapshot,
+     * clamping the selection into range -- used after add/remove/login
+     * succeed so the overlay never shows a server list that mutation just
+     * made stale. */
+    private refreshMcpManager;
     /** Save after the turn, never during: a half-written turn is a lie on disk. */
     private persist;
     /** Reopen a conversation: `id` if given, otherwise the most recent. */

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/session.js

@@ -2,9 +2,9 @@ import {
   DELTA_FLUSH_MS,
   TOOL_DELTA_CAP,
   TermSession
-} from "./chunk-QZJTOVZL.js";
-import "./chunk-L4KCEKIT.js";
-import "./chunk-VTJEWHM3.js";
+} from "./chunk-HUVRQX53.js";
+import "./chunk-2MGDL3I4.js";
+import "./chunk-5RPHYXND.js";
 import "./chunk-M44CET5L.js";
 import "./chunk-I44FC7PE.js";
 import "./chunk-TYP4MMO7.js";

package/dist/state.d.ts

@@ -96,7 +96,40 @@ export interface UserAsk {
     kind: 'user';
     questions: AskQuestion[];
 }
-export type Modal = PermissionAsk | UserAsk;
+/** The `/mcp` overlay's own state -- presentation over the SAME `/mcp`
+ * dispatch the text commands use (TermSession.runMcpCommand), not a second
+ * copy of it. `servers` is a snapshot fetched when the manager opens (and
+ * refreshed after a mutation succeeds), never something the view itself
+ * caches or recomputes -- see McpOverlay.tsx. */
+export interface McpManager {
+    kind: 'mcp';
+    servers: McpServerView[];
+    selected: number;
+    /** Set while a login is in flight; the consent URL once the daemon returns
+     * one. The URL genuinely arrives before the browser round-trip finishes on
+     * both write routes (daemon and local), so this is real, live state, not
+     * something the view can buffer or wait out. */
+    login: {
+        server: string;
+        url: string | null;
+    } | null;
+}
+/** Declared here, not in Task 10, because a discriminated union has to name
+ * all its variants at once to typecheck -- Task 10 builds the view that
+ * consumes this. */
+export interface HelpView {
+    kind: 'help';
+}
+/** `/context`'s overlay. Carries no snapshot of its own -- unlike `McpManager`,
+ * which caches a fetched server list, `/context` has nothing to fetch: every
+ * field it shows already lives on `TuiState` (see `sentTokens`, `offloaded`,
+ * `checkpoints`, `toolNames` below), updated live as events arrive. So the
+ * view just reads `TuiState` directly while this stays open, and a turn that
+ * lands while the overlay is up updates it without anyone re-opening it. */
+export interface ContextView {
+    kind: 'context';
+}
+export type Modal = PermissionAsk | UserAsk | McpManager | HelpView | ContextView;
 export type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'blocked';
 /** A local mirror of the harness's `todo_write` tool contract (see
  * packages/harness/tools/todo.ts) — kept local rather than imported so this
@@ -112,6 +145,12 @@ export interface TodoItem {
 export interface TuiState {
     /** Bumped on every change so subscribers using useSyncExternalStore refresh. */
     seq: number;
+    /** The model this session is using, for the status row (see ink/App.tsx's
+     * fitStatus call). Set from `TermSessionDeps.model` at construction and
+     * never written again -- the model is fixed for a session (see
+     * @corenel/term's TermSessionDeps.listModels field doc for why `/model
+     * <id>` refuses rather than mutating this). */
+    model: string;
     transcriptGen: number;
     committed: CommittedItem[];
     live: {
@@ -152,8 +191,50 @@ export interface TuiState {
      * so the effect is never silent, and it is cleared the moment that message
      * is sent (see TermSession.runTurn), not when the turn finishes. */
     pendingSkill: string | null;
+    /** What was actually sent on the LAST model call -- overwritten by every
+     * `usage` event, not accumulated the way `usage`/`turnUsage` are: this
+     * answers "what's in the window right now", not "what has this
+     * conversation cost so far". `null` before any model call has completed. */
+    sentTokens: number | null;
+    /** Tool results offloaded to save context, oldest first -- recallable with
+     * `/expand`. Appended to by every `offload` event; never removed, since a
+     * `/clear` empties this the same way it empties `committed`. */
+    offloaded: {
+        id: string;
+        name: string;
+        bytes: number;
+    }[];
+    /** Compaction seams -- history collapsed into a checkpoint -- oldest first,
+     * appended to by every `checkpoint` event alongside the note it already
+     * commits (see TermSession.handleEvent's `checkpoint` case). */
+    checkpoints: {
+        collapsed: number;
+        checkpoint: string;
+    }[];
+    /** The MCP tool set's current names, as of the last `tools-loaded` event --
+     * REPLACED wholesale each time (the event carries the whole list), not
+     * appended to. */
+    toolNames: string[];
+}
+/** One configured MCP server, as `/mcp` needs it -- joined from config
+ * (`readMcpServers`, the source of truth: see mcpRegistry.ts's
+ * `mcpServerViews`), the live registry's connection status, credential
+ * presence, and the on-disk tool cache's age. A server never touched this
+ * process (no `ensureConnected` yet) still appears here, just with
+ * `connected: false` and a cache-derived (or zero) `toolCount` -- config, not
+ * the registry, decides who is enumerated. */
+export interface McpServerView {
+    name: string;
+    url: string;
+    connected: boolean;
+    signedIn: boolean;
+    toolCount: number;
+    /** Epoch ms of the cached tool list, or null when never fetched. */
+    fetchedAt: number | null;
+    hosted: boolean;
+    error?: string;
 }
-export declare function emptyState(): TuiState;
+export declare function emptyState(model?: string): TuiState;
 /** Parse a `todo_write` call's `args` into the list this face renders.
  *
  * This is MODEL OUTPUT, not a value our own code produced, so it is parsed

package/dist/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;2EAG2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oFAAoF;AACpF,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAC5C;;;;;;;;;;;;;;;;;;;;mBAoBe;IACf,YAAY,CAAC,EAAE,IAAI,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IACrF,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IACzG;;;;;kDAK8C;IAC9C,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;+EAM2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf;;;gDAG4C;IAC5C,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,KAAK,GAAG,aAAa,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E;;;;gCAIgC;AAChC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IASZ,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb;;;;+EAI2E;IAC3E,SAAS,EAAE,KAAK,CAAC;IACjB;;;;;;;oFAOgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;qDAEiD;IACjD,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;wEAGoE;IACpE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,UAAU,IAAI,QAAQ,CAiBrC;AAQD;;;;;;;;;0BAS0B;AAC1B,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,CAiBpD"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}

package/dist/state.js

@@ -1,7 +1,7 @@
 import {
   emptyState,
   parseTodos
-} from "./chunk-L4KCEKIT.js";
+} from "./chunk-2MGDL3I4.js";
 export {
   emptyState,
   parseTodos

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corenel/term",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "type": "module",
   "description": "Corenel's terminal face — a headless chat controller plus its Ink views. `./session` is ink-free and shared with the CLI's readline fallback; only `./ink` pulls React. dist/ is bundled (see build.mjs), but @corenel/harness and @corenel/protocol stay EXTERNAL to that bundle — they are real runtime dependencies, declared below, so the CLI and term share exactly one harness module instance (see build.mjs for why two instances is a governance hole, not a cosmetic bug).",
   "exports": {
@@ -46,7 +46,7 @@
     "ink-text-input": "^6.0.0",
     "openai": "^4.77.0",
     "react": "^18.3.1",
-    "@corenel/harness": "0.7.5",
+    "@corenel/harness": "0.8.0",
     "@corenel/protocol": "0.7.3"
   },
   "devDependencies": {
@@ -55,7 +55,7 @@
     "esbuild": "^0.21.5",
     "ink-testing-library": "^4.0.0",
     "typescript": "^5.9.3",
-    "@corenel/tools-node": "0.3.7"
+    "@corenel/tools-node": "0.4.0"
   },
   "license": "Elastic-2.0",
   "engines": {

package/dist/chunk-VTJEWHM3.js

@@ -1,65 +0,0 @@
-// src/commands.ts
-var TERM_COMMANDS = [
-  { name: "help", summary: "what you can type here" },
-  { name: "tools", summary: "what the agent can do, and what it can change" },
-  { name: "policy", summary: "how this session is governed -- levels, caps, and what actually confines it" },
-  { name: "expand", args: "<#n>", summary: "re-print a tool result in full" },
-  { name: "resume", args: "[id]", summary: "reopen an earlier conversation" },
-  { name: "clear", summary: "forget the conversation" },
-  { name: "exit", summary: "leave" },
-  // -- config-workspace commands: what these do to the NEXT turn is real, see
-  // TermSessionDeps.system in ./session (the re-derivable system prompt) and
-  // the `mode`/`persona`/`skill`/`strategy` cases in runCommand.
-  { name: "mode", args: "<id>", summary: "switch the agent mode (takes effect next turn); no id lists what is configured" },
-  { name: "persona", args: "<id>", summary: "switch persona (takes effect next turn); no id lists what is configured" },
-  { name: "skill", args: "<name>", summary: "apply a skill to your NEXT message only, then it clears; no name lists what is installed" },
-  { name: "strategy", args: "<name>", summary: "run a saved strategy from .prompd/strategies; no name lists what is saved" }
-];
-var ALIASES = { quit: "exit" };
-function parseCommand(line) {
-  const t = line.trim();
-  if (!t.startsWith("/")) return null;
-  const [wordRaw, ...rest] = t.slice(1).split(/\s+/);
-  const word = ALIASES[wordRaw.toLowerCase()] ?? wordRaw.toLowerCase();
-  const arg = rest.join(" ").trim();
-  switch (word) {
-    case "help":
-      return { cmd: "help" };
-    case "tools":
-      return { cmd: "tools" };
-    case "policy":
-      return { cmd: "policy" };
-    case "clear":
-      return { cmd: "clear" };
-    case "exit":
-      return { cmd: "exit" };
-    case "expand": {
-      const m = /^#?(\d+)$/.exec(arg);
-      return m ? { cmd: "expand", ord: Number(m[1]) } : { cmd: "expand" };
-    }
-    case "resume":
-      return arg ? { cmd: "resume", id: arg } : { cmd: "resume" };
-    case "mode":
-      return arg ? { cmd: "mode", id: arg } : { cmd: "mode" };
-    case "persona":
-      return arg ? { cmd: "persona", id: arg } : { cmd: "persona" };
-    case "skill":
-      return arg ? { cmd: "skill", id: arg } : { cmd: "skill" };
-    case "strategy":
-      return arg ? { cmd: "strategy", id: arg } : { cmd: "strategy" };
-    default:
-      return null;
-  }
-}
-function filterCommands(input) {
-  const t = input.trim();
-  if (!t.startsWith("/")) return [];
-  const prefix = t.slice(1).split(/\s+/)[0].toLowerCase();
-  return TERM_COMMANDS.filter((c) => c.name.startsWith(prefix));
-}
-
-export {
-  TERM_COMMANDS,
-  parseCommand,
-  filterCommands
-};