@lingxi-ai-cn/dsh-tui-runtime 0.1.0-rc.8

package/lib/types/work.d.ts

@@ -0,0 +1,100 @@
+/** Authoritative background-work projection for the native TUI. */
+import type { AgentStatus, JobSnapshot, JobStatus, SessionIdType as SessionId, SubagentDescendantListEntry, SubagentRunEndInfo, SubagentRunInfo, SubagentTimingProjection } from './host.ts';
+/** Live Agent facts used to refine one durable subagent catalog row. */
+export interface TuiWorkAgentSnapshot {
+    /** Exact live Agent status. */
+    readonly status: AgentStatus;
+    /** Durable active-turn timing folded by the subagent projection. */
+    readonly timing?: SubagentTimingProjection | undefined;
+}
+/** One owner-scoped remote subagent lifecycle observed during this TUI process. */
+export interface TuiObservedSubagentRun {
+    /** Authoritative lifecycle start payload. */
+    readonly info: SubagentRunInfo;
+    /** Local receipt time used only as a lower-bound elapsed clock. */
+    readonly observedAt: number;
+    /** Authoritative terminal payload, absent while the run is live. */
+    readonly outcome?: SubagentRunEndInfo | undefined;
+    /** Local receipt time of the terminal edge. */
+    readonly finishedAt?: number | undefined;
+}
+/** State vocabulary shared by jobs and continuable subagent rows. */
+export type TuiWorkItemState = JobStatus | 'waiting' | 'inactive';
+/** One deduplicated row in the native TUI work panel. */
+export interface TuiWorkItemView {
+    /** Stable React and selection identity. */
+    readonly key: string;
+    /** Owning source of truth and available controls. */
+    readonly source: 'job' | 'subagent';
+    /** Source-owned job id or child Session id. */
+    readonly id: string;
+    /** Concise source-owned label. */
+    readonly label: string;
+    /** Owning Agent Session when known. */
+    readonly ownerSession?: SessionId | undefined;
+    /** Current authoritative lifecycle state. */
+    readonly state: TuiWorkItemState;
+    /** Source-specific terminal detail. */
+    readonly detail?: string | undefined;
+    /** Epoch milliseconds at the authoritative start or local observation edge. */
+    readonly startedAt?: number | undefined;
+    /** Epoch milliseconds at terminal settlement. */
+    readonly finishedAt?: number | undefined;
+    /** Durable tree depth for subagents; jobs use zero. */
+    readonly depth: number;
+    /** Whether Enter can open a local Session transcript. */
+    readonly inspectable: boolean;
+    /** Why a non-local child has no inspectable transcript. */
+    readonly readOnlyReason?: string | undefined;
+    /** Source-owned action currently safe to expose. */
+    readonly action: 'cancel-job' | 'interrupt-subagent' | 'none';
+    /** Durable accumulated execution and optional open-turn timing. */
+    readonly timing?: SubagentTimingProjection | undefined;
+}
+/** Footer counters derived from the same work rows as the panel. */
+export interface TuiWorkSummary {
+    /** Running or stopping rows. */
+    readonly running: number;
+    /** Authoritative queued rows; zero until an owning service exposes that state. */
+    readonly queued: number;
+    /** Terminal failed rows retained by their owning service or observed lifecycle. */
+    readonly failed: number;
+    /** Total mounted work rows. */
+    readonly total: number;
+}
+/** Immutable work-panel snapshot consumed through `useSyncExternalStore`. */
+export interface TuiWorkSnapshot {
+    /** Deduplicated rows in stable live-first order. */
+    readonly items: readonly TuiWorkItemView[];
+    /** Counters projected from `items`. */
+    readonly summary: TuiWorkSummary;
+    /** Catalog refresh currently in flight. */
+    readonly loading: boolean;
+    /** Contained catalog failure, retried on the next lifecycle change. */
+    readonly error?: string | undefined;
+}
+/** Empty immutable snapshot used before the first authoritative scan. */
+export declare const EMPTY_TUI_WORK_SNAPSHOT: TuiWorkSnapshot;
+/** Inputs for one deterministic work projection. */
+export interface TuiWorkProjectionInput {
+    /** Jobs visible to the root and its currently live descendants. */
+    readonly jobs: readonly JobSnapshot[];
+    /** Durable local child catalog below the TUI root. */
+    readonly subagents: readonly SubagentDescendantListEntry[];
+    /** Exact live Agent facts keyed by child Session id. */
+    readonly liveAgents: ReadonlyMap<SessionId, TuiWorkAgentSnapshot>;
+    /** Owner-scoped remote runs observed in this process. */
+    readonly remoteRuns: readonly TuiObservedSubagentRun[];
+    /** Whether an authoritative catalog refresh is pending. */
+    readonly loading?: boolean;
+    /** Contained catalog error. */
+    readonly error?: string;
+}
+/**
+ * Project jobs, continuable local children, and summary-only remote runs into
+ * one stable panel without duplicating job-managed one-shot subagents.
+ * @param input - current snapshots from the owning services and event streams.
+ * @returns an immutable panel snapshot and counters.
+ */
+export declare function projectTuiWork(input: TuiWorkProjectionInput): TuiWorkSnapshot;
+//# sourceMappingURL=work.d.ts.map

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "@lingxi-ai-cn/dsh-tui-runtime",
+  "description": "Native terminal UI for one in-process DeepSeek Harness Agent and Session",
+  "version": "0.1.0-rc.8",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lingxi-AI-cn/dsh-tui-plugin.git",
+    "directory": "packages/ui/tui"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "ink": "5.2.1",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "micromark-extension-gfm": "^3.0.0",
+    "react": "^18.3.1",
+    "string-width": "^7.2.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis-plugin-loader": "1.0.2",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-agent-presets": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-cmdline": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-compaction": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-commands": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-fs": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-jobs": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-native-command": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-permission-presets": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-projection": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-projection-cache": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-query": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-title": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-subagent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-token-meter": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-persistence": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-user-approval": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-user-questions": "0.1.0-rc.8",
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@lingxi-ai-cn/dsh-session-export": "0.1.0-rc.8",
+    "@lingxi-ai-cn/dsh-plugin-hub": "0.1.0-rc.8"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis-plugin-loader": "1.0.2",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-agent-presets": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-cmdline": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-compaction": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-commands": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-fs": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-jobs": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-native-command": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-permission-presets": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-projection": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-projection-cache": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-query": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-title": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-subagent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-token-meter": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-session-persistence": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-user-approval": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-user-questions": "0.1.0-rc.8",
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@types/react": "~18.3.1",
+    "@lingxi-ai-cn/dsh-session-export": "0.1.0-rc.8",
+    "@lingxi-ai-cn/dsh-plugin-hub": "0.1.0-rc.8"
+  }
+}