codsh-bundle 0.3.0

package/lib/types/theme.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Terminal styling and display metrics: SGR sequences that degrade to plain
+ * text off a TTY, and the display-column width a rendered string occupies.
+ * @module codsh-bundle/src/theme
+ */
+/** Style roles the renderer asks for, resolved to SGR codes by {@link createTheme}. */
+export interface Theme {
+    /** Whether this theme emits SGR sequences at all. */
+    readonly colored: boolean;
+    dim(text: string): string;
+    bold(text: string): string;
+    /** Failures, denied approvals, and removed diff lines. */
+    error(text: string): string;
+    /** Completed work and added diff lines. */
+    success(text: string): string;
+    /** Pending state and approval prompts. */
+    pending(text: string): string;
+    /** Tool names and card titles. */
+    tool(text: string): string;
+    /** File paths and locations. */
+    path(text: string): string;
+    /** The user's own echoed input. */
+    user(text: string): string;
+    /** Roles used inside a fenced code block. */
+    readonly syntax: SyntaxTheme;
+}
+/** Styling for the token classes a code block is coloured by. */
+export interface SyntaxTheme {
+    keyword(text: string): string;
+    string(text: string): string;
+    number(text: string): string;
+    comment(text: string): string;
+}
+/**
+ * Build the theme for one surface.
+ *
+ * Color is suppressed off a TTY and whenever `NO_COLOR` is set to any value,
+ * following the `no-color.org` convention: a redirected transcript stays
+ * greppable, and a pipe never receives sequences a reader would have to strip.
+ *
+ * Secondary text uses a palette gray on a 256-color terminal rather than the
+ * `dim` attribute: several terminals render `dim` at full brightness, and a
+ * hierarchy nobody can see is no hierarchy — the placeholder, the menu details,
+ * and the status row must sit visibly behind what the person typed.
+ * @param isTty - whether the output stream is a terminal.
+ * @param env - the environment to read `NO_COLOR` and the color depth from.
+ * @returns the styling functions for this surface.
+ */
+export declare function createTheme(isTty: boolean, env: Record<string, string | undefined>): Theme;
+/**
+ * Display columns a string occupies once printed, ignoring styling sequences.
+ *
+ * Measured by `string-width` — the width authority cli-table3, ink, and every
+ * maintained terminal renderer sit on — so East Asian Wide, emoji presentation
+ * (`⚡` included), combining marks, and ZWJ sequences all match what a
+ * terminal's cursor actually does. A hand-kept range table here mis-sized `⚡`
+ * and sheared a real table's columns; widths are exactly the kind of data
+ * nobody should maintain by hand.
+ * @param text - the string to measure, possibly carrying SGR sequences.
+ * @returns the number of display columns.
+ */
+export declare function displayWidth(text: string): number;
+/**
+ * Shorten a string to at most `columns` display columns, marking the cut with
+ * an ellipsis when anything was dropped.
+ *
+ * Styling survives: sequences cost no columns and travel with the text they
+ * style, and a cut that kept any styling closes it with a reset before the
+ * ellipsis so nothing leaks onto the next row. A string that already fits is
+ * returned exactly as it came — a fit is not a licence to restyle it.
+ * @param text - the string to shorten, possibly carrying SGR sequences.
+ * @param columns - the display-column budget; a budget under 2 yields the empty string.
+ * @returns the string, unchanged when it already fits.
+ */
+export declare function truncate(text: string, columns: number): string;

package/lib/types/transcript.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Session log to terminal lines. One appended {@link SessionEvent} renders to
+ * zero or more finished lines; the surface never rewrites a line it has
+ * printed, so the transcript scrolls like a shell history.
+ *
+ * Tool cards come from the registered presenters rather than from tool names:
+ * a tool declares its own render intent, and this module switches on the
+ * resulting `card` tag.
+ * @module codsh-bundle/src/transcript
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { ToolCallView, ToolResult, ToolResultView } from '@deepseek-ai/dsh-tools';
+import type { Theme } from './theme.ts';
+/** The registered presenters, resolved against the agent's scope by the caller. */
+export interface ToolPresenters {
+    /**
+     * Render intent for a pending call.
+     * @param name - the tool the model called.
+     * @param args - the parsed call arguments.
+     * @returns the declared view, or undefined for the generic fallback.
+     */
+    call(name: string, args: unknown): ToolCallView | undefined;
+    /**
+     * Render intent for a completed call.
+     * @param name - the tool the model called.
+     * @param args - the parsed call arguments.
+     * @param result - the completed outcome.
+     * @returns the declared view, or undefined for the generic fallback.
+     */
+    result(name: string, args: unknown, result: ToolResult): ToolResultView | undefined;
+}
+/** What the renderer needs to know about the surface it writes to. */
+export interface TranscriptOptions {
+    theme: Theme;
+    /** Display columns available for one line. */
+    columns: number;
+    /** Session workspace, stripped from absolute paths so cards stay short. */
+    cwd: string;
+}
+/** Renders one session's appended events as terminal lines. */
+export declare class Transcript {
+    private readonly options;
+    private readonly presenters;
+    private readonly calls;
+    /** The full form of the event just rendered, when its body was collapsed. */
+    private fold;
+    constructor(options: TranscriptOptions, presenters: ToolPresenters);
+    /**
+     * Shorten an absolute path inside the workspace to a workspace-relative one.
+     * @param path - the model-facing path a card carries.
+     * @returns the display path.
+     */
+    private relative;
+    /**
+     * Shorten every workspace path a presenter embedded in free text.
+     *
+     * A title is prose the tool composed (`Write /abs/path`), so the path inside
+     * it needs the same shortening as a structured `locations` entry.
+     * @param text - the presenter-supplied line.
+     * @returns the line with workspace-rooted paths made relative.
+     */
+    private relativizeIn;
+    /**
+     * Paths worth appending to a title that may already name them.
+     * @param title - the presenter's title, already relativized.
+     * @param paths - the relativized paths the card covers.
+     * @returns the paths the title does not mention, joined for display.
+     */
+    private extraPaths;
+    /**
+     * Render one appended event.
+     * @param event - the event exactly as recorded.
+     * @returns the lines to append to the transcript, empty when the event shows nothing.
+     */
+    render(event: SessionEvent): string[];
+    /**
+     * Render a pending call as its declared card.
+     * @param callId - correlation id, remembered until the result pairs with it.
+     * @param name - the tool the model called.
+     * @param rawArguments - the unparsed arguments JSON the model produced.
+     * @returns the pending card's lines.
+     */
+    private renderCall;
+    /**
+     * Render a completed call, pairing it with the call this transcript recorded.
+     * @param data - the `tool/result` payload.
+     * @returns the completed card's lines.
+     */
+    private renderResult;
+    /**
+     * The expanded form of the lines {@link render} just returned, when that
+     * event's body was collapsed — the whole event re-rendered without its cap,
+     * because a fold swaps entire blocks, not just the clipped tail. The full
+     * body is kept from the render itself: what a tool truncated before
+     * returning is upstream of the log and unrecoverable everywhere.
+     * @returns the full lines, or undefined when nothing was collapsed.
+     */
+    takeFold(): string[] | undefined;
+    /**
+     * Render one completed call's status suffix and body from its declared view.
+     * @param view - the result view, absent when no presenter answered.
+     * @param block - the model-facing result block, used by the generic fallback.
+     * @returns the suffix, the (possibly capped) body, and — when the cap dropped
+     *   lines, or a bodiless card withheld content — the full body for Ctrl-O.
+     */
+    private outcome;
+    /**
+     * Flatten a result's content blocks to displayable text.
+     * @param content - the result content blocks.
+     * @returns the joined text.
+     */
+    private resultText;
+    /**
+     * Ask a call presenter for its view, absorbing a throwing presenter.
+     * @param name - the tool the model called.
+     * @param args - the parsed call arguments.
+     * @returns the view, or undefined to fall back to the generic line.
+     */
+    private safeCall;
+    /**
+     * Ask a result presenter for its view, absorbing a throwing presenter.
+     * @param pending - the recorded call this result pairs with.
+     * @param content - the model-facing result content.
+     * @param isError - whether the executor reported a failure.
+     * @param meta - the tool's private presentation payload, when it attached one.
+     * @returns the view, or undefined to fall back to the generic card.
+     */
+    private safeResult;
+}

package/lib/types/wrap.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Display-width wrapping for styled text.
+ *
+ * Inside the alternate screen the terminal no longer wraps for us: a transcript
+ * line longer than the viewport must be broken into rows before it is painted,
+ * or it would overwrite the row below. The lines being broken are already
+ * styled, so a naive split would cut an escape sequence in half and leak
+ * gibberish — and a continuation row would lose the colour its first half set.
+ * @module codsh-bundle/src/wrap
+ */
+/**
+ * Break one styled line into rows no wider than `columns` display columns.
+ *
+ * Styles carry across the break: each continuation row re-opens whatever was
+ * active where the cut fell, and every row that opened a style closes it.
+ * @param text - the styled line, without a terminator.
+ * @param columns - display columns available per row.
+ * @returns the rows, at least one (an empty line yields one empty row).
+ */
+export declare function wrapStyled(text: string, columns: number): string[];
+/**
+ * Wrap many lines, keeping their order.
+ * @param lines - styled lines.
+ * @param columns - display columns per row.
+ * @returns the physical rows they occupy.
+ */
+export declare function wrapAll(lines: readonly string[], columns: number): string[];

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "codsh-bundle",
+  "description": "The codsh runtime: the interactive TTY surface and code-cli agent preset, installed into a dsh profile. Users install codsh-cli (the launcher) — this package is what it registers.",
+  "version": "0.3.0",
+  "type": "module",
+  "license": "MIT",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./startup": {
+      "types": "./lib/types/startup.d.ts",
+      "default": "./lib/startup.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json",
+    "./agent-presets/*": "./agent-presets/*"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/startup.js",
+    "cordis.patch.yml",
+    "agent-presets",
+    "lib/types/**/*.d.ts",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-agent-instructions": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-cmdline": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-code-runtime-worker-thread": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-command-compact": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-compaction-basic": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-compaction-tool-result-pruner": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-lsp": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-lsp-stdio": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-persona": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-skill-filesystem": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-terminal": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-terminal-bash": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-ask-user": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-bash": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-fs": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-fs-search": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-goal": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-jobs": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-lsp": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-pwsh": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-ralph": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-skill": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-subagent": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-subagent-control": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-terminal": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-todo": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-web": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tool-workflow": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-workflow-worker-thread": "^0.1.0-rc.7",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "commander": "^15.0.0",
+    "diff": "^9.0.0",
+    "string-width": "^8.2.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-session-projection": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-session-query": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-token-meter": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-user-approval": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.7"
+  },
+  "engines": {
+    "node": ">=22.19"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Blackman99/codsh.git",
+    "directory": "packages/bundle"
+  },
+  "keywords": [
+    "cli",
+    "coding-agent",
+    "terminal",
+    "deepseek",
+    "dsh",
+    "ai",
+    "agent"
+  ],
+  "homepage": "https://github.com/Blackman99/codsh#readme",
+  "bugs": "https://github.com/Blackman99/codsh/issues",
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.build.json"
+  }
+}