@corenel/term 0.1.0

package/dist/markdown.d.ts

@@ -0,0 +1,33 @@
+export type MdBlock = {
+    kind: 'h';
+    level: number;
+    text: string;
+} | {
+    kind: 'p';
+    text: string;
+} | {
+    kind: 'li';
+    text: string;
+} | {
+    kind: 'code';
+    lang: string;
+    text: string;
+} | {
+    kind: 'blank';
+    text: '';
+};
+export declare function parseMarkdown(text: string): MdBlock[];
+/** One block, paired with the exact raw source text (original line endings
+ * normalized to '\n', markup un-stripped) that produced it. Concatenating
+ * every span's `raw` in order, joined by '\n', reproduces `text` exactly
+ * (mod CRLF normalization) — this is what lets the TUI commit a block as it
+ * completes and still guarantee the user sees the reply exactly once. */
+export interface MdBlockSpan {
+    block: MdBlock;
+    raw: string;
+}
+export declare function parseMarkdownSpans(text: string): MdBlockSpan[];
+/** Drop inline markup a terminal cannot show. Emphasis must have no space next
+ * to its markers, or `2 * 3` loses its asterisk. */
+export declare function stripInline(s: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,EAAE,CAAA;CAAE,CAAC;AAOhC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAErD;AAED;;;;yEAIyE;AACzE,MAAM,WAAW,WAAW;IAAG,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAE5D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAsC9D;AAED;oDACoD;AACpD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7C"}

package/dist/persist.d.ts

@@ -0,0 +1,30 @@
+import type { AgentSession, FileService } from '@corenel/protocol';
+import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
+import type { CommittedItem } from './state';
+export interface SaveInput {
+    id: string | null;
+    title: string;
+    messages: ChatCompletionMessageParam[];
+}
+export interface LoadedSession {
+    id: string;
+    title: string;
+    messages: ChatCompletionMessageParam[];
+}
+export interface SessionPersistence {
+    save(input: SaveInput): Promise<{
+        id: string;
+    }>;
+    load(id?: string): Promise<LoadedSession | null>;
+    list(): Promise<AgentSession[]>;
+}
+export declare function createSessionPersistence(files: FileService): SessionPersistence;
+/** The display transcript for a restored conversation.
+ *
+ * User and assistant TEXT only, deliberately: an identity mapping keeps the
+ * restored transcript lined up with the history the next turn sends, which is
+ * the trap a richer rebuild walks into. */
+export declare function committedFromMessages(messages: ChatCompletionMessageParam[]): CommittedItem[];
+/** The first line of the first user message, as a session title. */
+export declare function titleFrom(messages: ChatCompletionMessageParam[]): string;
+//# sourceMappingURL=persist.d.ts.map

package/dist/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../src/persist.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,0BAA0B,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,0BAA0B,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACjD,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACjC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,CA4B/E;AAED;;;;2CAI2C;AAC3C,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,0BAA0B,EAAE,GAAG,aAAa,EAAE,CAW7F;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,0BAA0B,EAAE,GAAG,MAAM,CAKxE"}

package/dist/persist.js

@@ -0,0 +1,10 @@
+import {
+  committedFromMessages,
+  createSessionPersistence,
+  titleFrom
+} from "./chunk-HAQGHLW6.js";
+export {
+  committedFromMessages,
+  createSessionPersistence,
+  titleFrom
+};

package/dist/session.d.ts

@@ -0,0 +1,153 @@
+import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
+import type OpenAI from 'openai';
+import type { AgentEvent, AgentTool, AskAnswers, AskQuestion, PermissionDecision, ToolContext } from '@corenel/protocol';
+import { type RunAgentArgs, type RunAgentResult } from '@corenel/harness/core/loop';
+import type { PermissionService } from '@corenel/harness/guardrail/permission-service';
+import { type CommittedItem, type TuiState } from './state';
+import { type SessionPersistence } from './persist';
+export interface TermSessionDeps {
+    cwd: string;
+    model: string;
+    system?: string;
+    client: OpenAI;
+    tools: AgentTool[];
+    /** Built per turn so each turn gets its own signal, and so `ask` reaches the
+     * tool context — which is how ask_user finally works in node. */
+    toolCtx: (signal: AbortSignal, ask: (q: AskQuestion[]) => Promise<AskAnswers | null>) => ToolContext;
+    /** Skip the per-command approval prompt (`--allow-shell`). */
+    approveAll?: boolean;
+    /** Injected so tests can drive a turn without a model. Defaults to runAgent. */
+    runner?: (args: RunAgentArgs) => Promise<RunAgentResult>;
+    /** Raw event tap for a face that renders the turn as it happens (the readline
+     * face streams from this; the Ink face renders state instead). Called before
+     * the event is reduced. */
+    onEvent?: (e: AgentEvent) => void;
+    /** Conversation persistence. Omit and the session is not written to disk. */
+    persistence?: SessionPersistence;
+    /** Read back a tool result that was offloaded to save context. */
+    recall?: (id: string) => Promise<string | null>;
+}
+/** Deltas arrive per token; re-rendering React that often thrashes for output
+ * no eye can follow. They coalesce on this interval instead. */
+export declare const DELTA_FLUSH_MS = 50;
+export declare class TermSession {
+    protected readonly deps: TermSessionDeps;
+    protected state: TuiState;
+    private listeners;
+    private nextOrd;
+    private idSeq;
+    private pendingDelta;
+    private flushTimer;
+    private streamFull;
+    /** How many leading blocks of `streamFull` have already been committed.
+     * Only the block at this index (the last one seen so far) is still live. */
+    private streamCommittedBlocks;
+    private pendingOffload;
+    /** The model's truth, as opposed to `committed`, which is display. */
+    private history;
+    private turnAc;
+    /** Monotonic turn id. Events stamped with an older one are dropped: a late
+     * delta from an aborted turn must never paint into the next one. */
+    private turnId;
+    private activeTurn;
+    private pending;
+    private draining;
+    private historyGen;
+    private settling;
+    /** The approval gate. Supplied by whichever face can show a prompt (readline's
+     * `ask`, the Ink modal, ...) — the controller has no rendering of its own, so
+     * it cannot build one itself. Unattached, `runTurn` simply omits `permission`
+     * from the runner args, and the loop runs every tool ungated. */
+    private permission;
+    wantsExit: boolean;
+    constructor(deps: TermSessionDeps);
+    attachPermission(p: PermissionService): void;
+    historyForTest(): ChatCompletionMessageParam[];
+    getSnapshot(): TuiState;
+    subscribe(fn: () => void): () => void;
+    /** Replace state and notify. Every mutation goes through here so `seq` and the
+     * snapshot identity can never drift from the data. */
+    protected set(patch: Partial<TuiState>): void;
+    protected id(prefix: string): string;
+    protected commit(item: CommittedItem): void;
+    protected note(level: 'info' | 'warn' | 'error', text: string, detail?: string): void;
+    /** Open a live turn. Public-for-test until Task 4 gives it a real caller. */
+    beginTurnForTest(): void;
+    flushDeltasForTest(): void;
+    protected beginTurn(): void;
+    /** Commit every markdown block in `streamFull` that can no longer change --
+     * i.e. every block except the last, which more text can still extend --
+     * and return the still-live trailing block's raw text. This is what keeps
+     * the live region Ink redraws every frame bounded by one block instead of
+     * the whole reply: see the module comment for why an unbounded live region
+     * corrupts the frame once it scrolls out of the viewport.
+     *
+     * KNOWN LIMIT: any single block taller than the terminal -- not just a
+     * fenced code block, but equally one long unbroken paragraph, or any other
+     * span with no internal blank-line break -- stays "the trailing block", and
+     * so stays live and unbounded, until it closes (or the blank line that ends
+     * it arrives). That bounds the live region by one block rather than by the
+     * viewport, which the headless controller has no way to know. It is still
+     * a large improvement over the whole reply staying live, and a single block
+     * taller than the terminal is rare. */
+    private commitCompletedBlocks;
+    private flushDeltas;
+    private scheduleFlush;
+    /** Commit whatever the live region still holds -- the trailing block that
+     * flushDeltas kept live, since every block before it is already committed
+     * -- and close the turn. */
+    protected endTurn(): void;
+    handleEvent(e: AgentEvent): void;
+    /** Route one line: a command runs here; anything else is a turn. */
+    submit(text: string): Promise<void>;
+    private runCommand;
+    /** 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. */
+    resume(id?: string): Promise<void>;
+    /** Re-print a committed tool row in full, as a NEW block at the bottom.
+     * Inline rendering owns this trade: the original row's bytes belong to the
+     * terminal's scrollback and cannot be rewritten in place. */
+    protected expand(ord: number): Promise<void>;
+    /** The full body of a committed row. `committed` only ever keeps the capped
+     * `preview`, and a second copy would be redundant AND wrong: `history`
+     * already carries the exact string the model saw for this call (the full
+     * body when it wasn't offloaded, the short offload ref when it was — see
+     * @corenel/harness core/loop.ts's `messages.push({ role: 'tool', ... })`),
+     * and `history` is cleared by `/clear`, so a stale row can't outlive the
+     * conversation it belongs to the way a side map would. Task 8 adds the (a)
+     * branch below: reading an offloaded body back out of the blob store by
+     * `row.offloadRefId` — the seam, not the wiring: the CLI does not pass
+     * `deps.recall` (context compression in node is a separate feature), so
+     * this branch is currently always skipped in practice. */
+    protected fullResult(_id: string, row: Extract<CommittedItem, {
+        kind: 'tool';
+    }>): Promise<string>;
+    private runTurn;
+    /** Close out a turn that produced nothing usable -- aborted, or failed.
+     * Drops the abandoned user message: a user message with no reply, or a tool
+     * call with no result, poisons the next request. Exactly once, and never when
+     * the conversation was replaced under it (`/clear`, `/resume`), where the
+     * message it would drop belongs to someone else's history. */
+    private finishAbandoned;
+    private drain;
+    /** Stop the TURN, never the process. A long tool call you regret is the common
+     * case, and killing the shell to escape it loses the conversation. */
+    abort(): void;
+    askPermission(req: {
+        tool: string;
+        input: unknown;
+    }): Promise<PermissionDecision>;
+    askUser(questions: AskQuestion[]): Promise<AskAnswers | null>;
+    /** The view's answer to whichever modal is open. */
+    answer(value: PermissionDecision | AskAnswers | null): void;
+    /** Force-close whatever modal is open, on turn teardown or `abort()`. The
+     * sentinel must match the modal's OWN contract, not a shared default:
+     * `askPermission` promises `PermissionDecision`, where `'deny'` is a real
+     * value; `askUser` promises `AskAnswers | null`, and `'deny'` there would be
+     * a bogus truthy string standing in for the documented "dismissed" (`null`)
+     * outcome that `askUserTool` (packages/harness/tools/builtins.ts) checks for. */
+    private forceClosePending;
+    private resolvePending;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -0,0 +1,12 @@
+import {
+  DELTA_FLUSH_MS,
+  TermSession
+} from "./chunk-HYWLODZT.js";
+import "./chunk-47IH6X5H.js";
+import "./chunk-R6AXTD55.js";
+import "./chunk-TCVDVYMF.js";
+import "./chunk-HAQGHLW6.js";
+export {
+  DELTA_FLUSH_MS,
+  TermSession
+};

package/dist/state.d.ts

@@ -0,0 +1,75 @@
+import type { AskQuestion, Usage } from '@corenel/protocol';
+/** An item that can no longer change. Rendered ONCE, then owned by the terminal. */
+export type CommittedItem = {
+    kind: 'user';
+    id: string;
+    text: string;
+} | {
+    kind: 'assistant';
+    id: string;
+    text: string;
+} | {
+    kind: 'tool';
+    id: string;
+    callId: string;
+    ord: number;
+    name: string;
+    subject: string;
+    preview: string[];
+    isError: boolean;
+    durationMs?: number;
+    offloadedBytes?: number;
+    offloadRefId?: string;
+} | {
+    kind: 'note';
+    id: string;
+    level: 'info' | 'warn' | 'error';
+    text: string;
+    detail?: string;
+};
+/** A tool call announced but not yet resolved. */
+export interface LiveTool {
+    callId: string;
+    ord: number;
+    name: string;
+    subject: string;
+}
+export interface PermissionAsk {
+    kind: 'permission';
+    tool: string;
+    /** The command or path being approved — never just the tool name. */
+    detail: string;
+}
+export interface UserAsk {
+    kind: 'user';
+    questions: AskQuestion[];
+}
+export type Modal = PermissionAsk | UserAsk;
+export interface TuiState {
+    /** Bumped on every change so subscribers using useSyncExternalStore refresh. */
+    seq: number;
+    transcriptGen: number;
+    committed: CommittedItem[];
+    live: {
+        streaming: string;
+        tools: LiveTool[];
+        turn: number;
+    } | null;
+    queued: string[];
+    modal: Modal | null;
+    usage: Usage;
+    /** Usage for the CURRENT exchange only -- everything since the user pressed
+     * Enter, including every tool round-trip. Reset when a turn begins;
+     * accumulated (alongside `usage`) on every `usage` event, because the loop
+     * emits one such event per model call and a single submission can span
+     * several (a round of tool calls means another call back to the model). */
+    turnUsage: Usage;
+    session: {
+        id: string;
+        title: string;
+    } | null;
+    status: 'idle' | 'running' | 'aborting';
+    error: string | null;
+}
+export declare function emptyState(): TuiState;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +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;AAE5D,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,CAAA;CAAE,GAC/C;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,CAAA;CAAE,GAC5G;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;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;CAChB;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,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,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;CACtB;AAED,wBAAgB,UAAU,IAAI,QAAQ,CAcrC"}

package/dist/state.js

@@ -0,0 +1,6 @@
+import {
+  emptyState
+} from "./chunk-47IH6X5H.js";
+export {
+  emptyState
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@corenel/term",
+  "version": "0.1.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), so @corenel/harness and @corenel/protocol are inlined at build time and are NOT runtime dependencies; they are needed only to consume the published .d.ts.",
+  "exports": {
+    "./session": {
+      "types": "./dist/session.d.ts",
+      "default": "./dist/session.js"
+    },
+    "./state": {
+      "types": "./dist/state.d.ts",
+      "default": "./dist/state.js"
+    },
+    "./commands": {
+      "types": "./dist/commands.d.ts",
+      "default": "./dist/commands.js"
+    },
+    "./describe": {
+      "types": "./dist/describe.d.ts",
+      "default": "./dist/describe.js"
+    },
+    "./persist": {
+      "types": "./dist/persist.d.ts",
+      "default": "./dist/persist.js"
+    },
+    "./ink": {
+      "types": "./dist/ink/index.d.ts",
+      "default": "./dist/ink/index.js"
+    }
+  },
+  "dependencies": {
+    "ink": "^5.2.1",
+    "ink-text-input": "^6.0.0",
+    "openai": "^4.77.0",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.1",
+    "@types/react": "^18.3.29",
+    "esbuild": "^0.21.5",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^5.9.3",
+    "@corenel/harness": "0.3.2",
+    "@corenel/protocol": "0.3.2",
+    "@corenel/tools-node": "0.2.0"
+  },
+  "license": "Elastic-2.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "node build.mjs && tsc -p tsconfig.build.json"
+  }
+}