@deepseek-harness-tui/dsh-tui 0.13.0 → 0.14.1

package/lib/types/dsh-adapter/channel/core/compose.d.ts

@@ -0,0 +1,217 @@
+/**
+ * The backend-neutral channel core: one composition for every
+ * `AgentSession`, whatever backend serves it.
+ *
+ * `createCoreChannel` acquires, in one owner transaction, the binding, the
+ * host seams and decision gate, the emitter, notifications, context
+ * bookkeeping, the IDE selection link, the composer and input pipeline (FIFO,
+ * `tui/input` decisions, `@` mentions, staged images, IDE selection) ending in
+ * `session.submit`, the shared projector feed, session switching (`/new`),
+ * local actions, files, reports and the capability-backed actions, and builds
+ * the common half of the `ChannelState`. Nothing is subscribed and no action
+ * is callable yet.
+ *
+ * An extension (the DSH extensions, `../extensions.ts`) then `extend`s the
+ * core: hooks into the feed and the emitter, state fields it serves, and its
+ * action delegates on top of the core's. `start()` installs the action table
+ * once, starts the runtime subscriptions, binds the session, and hands the
+ * channel lifetime to Cordis. A session no extension claims is served by the
+ * core alone: every action is backed by a capability, the core, or explicitly
+ * unavailable.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { AgentCapabilities } from '../../../adapter/ports/channel-capabilities.js';
+import type { AgentSession } from '../../../agent/session.js';
+import { type ChannelActionDelegates } from '../action-readiness.js';
+import { type InputConvergence } from '../input-actions.js';
+import { type ChannelOwner } from '../owner.js';
+import { type ChannelLaunchOptions } from '../state.js';
+import type { ChannelState } from '../types.js';
+import { type BindingFeedHooks } from './binding-feed.js';
+import { type CompletionCatalog } from './files.js';
+import { type CoreHost } from './host.js';
+import { type NewSessionOpener, type ResumeSessionOpener } from './session-switch.js';
+/**
+ * What an extension contributes (every member optional; `extend` merges, a
+ * later call wins per member, `delegates` merge by action name).
+ */
+export interface ChannelExtension {
+    /** The object a parked decision's staleness is judged by (default: the
+     *  session object; DSH: its agent, which rebinds keep across wrappers). */
+    conversationKey?(session: AgentSession): object;
+    /** Flush deferred projection work before a frame wake; true = the
+     *  renderer-visible data changed (DSH: the subagent stream batcher). */
+    flushDeferred?(): boolean;
+    /** Restore folded rows from the backend's durable history. Its presence
+     *  enables folding past the transcript window; absent, the session's
+     *  `transcript` capability does (folding only the rows it can restore),
+     *  and without either nothing folds. */
+    loadOlder?(): number;
+    /** The extension projects subagents and background jobs itself (DSH, from
+     *  its host services): the core's event-driven activity projection stays
+     *  inert and its controls are the extension's. */
+    readonly ownsActivity?: boolean;
+    /** The extension serves the trajectory surface itself (DSH: the raw
+     *  session history is the source): the core's AgentEvent fold stays inert
+     *  and its accessors are replaced by the extension's. */
+    readonly ownsTrajectory?: boolean;
+    /** Whether the local disk stands in for a missing host `fs` service
+     *  (default true; the DSH workspace may be remote, so DSH says false). */
+    localFs?: boolean;
+    /** Rows of extension projections that `/clear` drops with the transcript. */
+    dropRows?(): void;
+    /** Move a used session to the front of the `/resume` MRU. */
+    touchSession?(sessionId: string): void;
+    /** Record a resolved git branch against the bound session. */
+    noteBranch?(branch: string): void;
+    /** Argument catalogs for slash completion. */
+    completions?: CompletionCatalog;
+    /** What the bound agent's composition mounts (`ChannelUi.capabilities()`;
+     *  DSH: resolved from its live services, `../capabilities.ts`). Absent, the
+     *  core describes the session from its typed capabilities. */
+    agentCapabilities?(): AgentCapabilities;
+    /** Hooks into every bind (core/binding-feed.ts). */
+    bind?: BindingFeedHooks;
+    /** How `/new` opens a fresh session (default: `options.openSession`). */
+    newSession?: NewSessionOpener;
+    /** How the core `/resume` reopens a persisted session (default:
+     *  `options.openSession`; DSH serves `/resume` itself). */
+    resumeSession?: ResumeSessionOpener;
+    /** Actions served on top of the core's. */
+    delegates?: Partial<ChannelActionDelegates>;
+    /** Runtime starts around the core's host subscriptions, before the bind. */
+    start?: {
+        before?(): void;
+        after?(): void;
+    };
+}
+/** The core as an extension sees it. */
+export type CoreChannel = ReturnType<typeof createCoreChannel>;
+export declare function createCoreChannel(ctx: Context, initialSession: AgentSession, options: ChannelLaunchOptions, owner: ChannelOwner): {
+    state: ChannelState;
+    owner: {
+        current: () => boolean;
+        assertActive: () => void;
+        readonly cleanupCount: number;
+        signal: AbortSignal;
+        bind(check: () => boolean): void;
+        own(cleanup: () => void): () => void;
+        dispose(): void;
+    };
+    binding: {
+        readonly session: AgentSession;
+        readonly agent: import("@deepseek-ai/dsh-agent").Agent | undefined;
+        readonly handle: import("@deepseek-ai/dsh-agent").AgentHandle | undefined;
+        readonly generation: number;
+        capture(): import("../binding.js").BindingCapture;
+        isCurrent(capture: import("../binding.js").BindingCapture): boolean;
+        prepare(capture: import("../binding.js").BindingCapture, create: () => Promise<AgentSession>): Promise<AgentSession>;
+        abandon(candidate: AgentSession): Promise<void>;
+        releaseOwned(): void;
+        waitForDisposal(sessionId: string): Promise<void>;
+        adopt: <T>(candidate: AgentSession, capture: import("../binding.js").BindingCapture, tail: (previous: import("../binding.js").BindingCommit, disposition: (next: "dispose" | "park") => void) => T) => T;
+        switchTo: <T>(next: AgentSession, tail: (previous: import("../binding.js").BindingCommit, disposition: (next: "dispose" | "park") => void) => T) => T;
+        bind(): number;
+        subscribe(dispose: () => void): void;
+        clearSubscriptions: (afterEach?: () => void) => unknown;
+    };
+    rowIds: {
+        value: number;
+    };
+    host: CoreHost;
+    notify: (text: string, options?: {
+        color?: import("../types.js").NotificationItem["color"];
+        timeoutMs?: number;
+    }) => () => void;
+    unavailable: (name: string) => void;
+    bookkeeping: {
+        warning: {
+            value: boolean;
+        };
+        resetContextWarning: () => void;
+        checkContextWarning: () => void;
+        trackPending: (message: {
+            id: string;
+            text: string;
+            images?: readonly import("../types.js").ComposerImageRef[];
+        }, placement: import("../types.js").PendingMessage["placement"]) => void;
+        untrackPending: (messageId: string) => void;
+    };
+    composer: import("../composer-images.js").ComposerImages;
+    input: {
+        dispatchUserText: (text: string, placement: import("../types.js").PendingMessage["placement"], images?: readonly import("../types.js").ComposerImageRef[], attach?: import("@deepseek-ai/dsh-llm").UserMessage) => void;
+        activity: () => {
+            readonly dispatched: number;
+            readonly unsettled: boolean;
+            readonly parked?: string;
+        };
+        deliverUserText: (text: string, placement: import("../types.js").PendingMessage["placement"], images?: readonly import("../types.js").ComposerImageRef[], attach?: import("@deepseek-ai/dsh-llm").UserMessage) => void;
+        claimAttachments: (messages: readonly import("@deepseek-ai/dsh-llm").UserMessage[]) => import("@deepseek-ai/dsh-llm").UserMessage[];
+        retireAttachment: (messageId: string) => void;
+        withDecisionPending: <T>(name: string, pending: Promise<T>, origin?: import("../input-delivery.js").UserTextOrigin) => Promise<T>;
+        clearStagedImages: () => void;
+        stageImage: (input: import("../types.js").StagedImageInput) => Promise<string>;
+        stagedImages: () => ReadonlyMap<string, import("../types.js").ChannelImageBlock["attachment"]>;
+        composer: import("../composer-images.js").ComposerImages;
+    };
+    inputConvergence: InputConvergence;
+    feed: {
+        projector: {
+            apply: (events: readonly import("../../../agent/events.js").AgentEvent[], meta: import("../../../agent/events.js").AgentEventMeta) => void;
+            reset: () => void;
+            settleStreaming: () => void;
+            updateSpinnerMode: () => void;
+            contextUsage: () => {
+                readonly type: "context.usage";
+                readonly used: number;
+                readonly max?: number;
+                readonly categories?: readonly {
+                    readonly name: string;
+                    readonly tokens: number;
+                    readonly kind: string;
+                }[];
+            } | undefined;
+        };
+        router: {
+            route: (batch: readonly import("../../../agent/events.js").AgentEvent[], meta: import("../../../agent/events.js").AgentEventMeta, current: () => boolean) => void;
+            reconcileRetiredProjection: (status: "idle" | "disposed") => void;
+            turnStarts: () => number;
+        };
+        bind: (seed?: readonly import("../../../agent/events.js").AgentEvent[]) => void;
+        resetProjection: () => void;
+        configureProjection(update: Partial<Pick<import("../../../channel/projection.js").ChannelProjectionDeps, "jobs" | "pricingWindow">>): void;
+    };
+    sessionSwitch: {
+        sessionSwitchVetoed: (kind: import("./session-switch.js").SessionSwitchKind, targetSessionId?: string) => Promise<boolean>;
+        notifySessionSwitched: (kind: import("./session-switch.js").SessionSwitchedKind, sessionId: string, previousSessionId: string) => void;
+        newSession: (target?: import("./session-switch.js").NewSessionTarget) => Promise<boolean>;
+        resumeSession: (sessionId: string, kind?: "resume" | "rewind") => Promise<import("../types.js").ResumeResult>;
+    };
+    local: {
+        loadOlder(): number;
+        clear(): void;
+        pushLocal(title: string, lines: readonly string[]): void;
+        setActivityFrames: (name: string) => boolean;
+        runLocalCommand(command: string, includeInContext: boolean): Promise<void>;
+    };
+    files: {
+        fallbackFs: () => import("../types.js").MentionFs | undefined;
+        listFileCandidates: (query: string, options?: {
+            signal?: AbortSignal;
+            topK?: number;
+        }) => Promise<readonly import("../../../utils/fileSuggestions.js").FileCandidate[]>;
+        listFiles: () => Promise<readonly string[]>;
+        commandCompletions(catalog: CompletionCatalog): ChannelState["commandCompletions"];
+    };
+    reports: {
+        doctorInfo: () => string[];
+        exportSession: () => string | null;
+    };
+    resetIdeSelection: () => void;
+    refreshGitBranch: () => void;
+    /** Merge an extension's contributions (before `start`). */
+    extend(next: ChannelExtension): void;
+    /** Install the actions, start the runtime, bind the session. */
+    start(): ChannelState;
+};
+//# sourceMappingURL=compose.d.ts.map

package/lib/types/dsh-adapter/channel/core/compose.d.ts.map

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