@sagmans/dsh-tui 0.1.0

package/lib/identity.d.ts

@@ -0,0 +1,33 @@
+import type { LauncherAgentIdentity } from '@deepseek-ai/dsh-agent-loop';
+/** A command line that cannot be resolved into one launch identity. */
+export declare class LaunchUsageError extends Error {
+}
+/** Resolved intent of the arguments dsh handed to this app. */
+export interface LaunchIntent {
+    /** Exact session id to resume, or empty for a fresh session. */
+    readonly resumeId: string;
+    /** Whether to open the history picker instead of starting a turn immediately. */
+    readonly resumePicker: boolean;
+    /** Whether the user explicitly asked for a new session. */
+    readonly fresh: boolean;
+}
+/**
+ * Resolve the app's own arguments into one identity decision.
+ *
+ * The three ways to name a session (positional `resume <id>`, `--resume [id]`,
+ * and `--new`) overlap, so an ambiguous combination is refused here rather
+ * than silently picking one: a wrong guess would resume the wrong conversation.
+ */
+export declare function resolveLaunchIntent(input: {
+    readonly mode: string | undefined;
+    readonly session: string | undefined;
+    readonly resumeFlag: string | boolean | undefined;
+    readonly newSession: boolean | undefined;
+}): LaunchIntent;
+/** Identity the agent-loop row would adopt when a profile configures one. */
+export declare function identityOf(intent: LaunchIntent, uuid: string): LauncherAgentIdentity;
+/** Profile the surface is installed into; only used for the resume hint. */
+export declare const PROFILE_NAME = "tui";
+/** Line printed after the terminal is handed back, so the session is recoverable. */
+export declare function resumeHint(sessionId: string, profile: string): string;
+//# sourceMappingURL=identity.d.ts.map

package/lib/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAExE,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAA;CACzC,GAAG,YAAY,CAwBf;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAIpF;AAED,4EAA4E;AAC5E,eAAO,MAAM,YAAY,QAAQ,CAAA;AAEjC,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/lib/identity.js

@@ -0,0 +1,49 @@
+import { SessionId } from '@deepseek-ai/dsh-session';
+/** A command line that cannot be resolved into one launch identity. */
+export class LaunchUsageError extends Error {
+}
+/**
+ * Resolve the app's own arguments into one identity decision.
+ *
+ * The three ways to name a session (positional `resume <id>`, `--resume [id]`,
+ * and `--new`) overlap, so an ambiguous combination is refused here rather
+ * than silently picking one: a wrong guess would resume the wrong conversation.
+ */
+export function resolveLaunchIntent(input) {
+    const mode = input.mode?.trim() ?? '';
+    if (mode !== '' && mode !== 'resume') {
+        throw new LaunchUsageError(`unknown argument "${mode}" (expected "resume")`);
+    }
+    const flagValue = typeof input.resumeFlag === 'string' ? input.resumeFlag.trim() : '';
+    const positional = input.session?.trim() ?? '';
+    if (flagValue !== '' && positional !== '' && flagValue !== positional) {
+        throw new LaunchUsageError('session id given twice with different values (--resume and positional)');
+    }
+    if (positional !== '' && mode === '' && input.resumeFlag === undefined) {
+        throw new LaunchUsageError('a session id requires resume mode or --resume');
+    }
+    const resumeId = flagValue !== '' ? flagValue : positional;
+    const resumeRequested = mode === 'resume' || input.resumeFlag !== undefined || positional !== '';
+    if (input.newSession === true && resumeRequested) {
+        throw new LaunchUsageError('--new cannot be combined with a resume session id or mode');
+    }
+    return {
+        resumeId,
+        // An empty --resume (bare flag) asks for the picker rather than a fresh session.
+        resumePicker: resumeId === '' && (mode === 'resume' || input.resumeFlag !== undefined),
+        fresh: input.newSession === true,
+    };
+}
+/** Identity the agent-loop row would adopt when a profile configures one. */
+export function identityOf(intent, uuid) {
+    return intent.resumeId === ''
+        ? { id: SessionId(`tui-session-${uuid}`), resume: false }
+        : { id: SessionId(intent.resumeId), resume: true };
+}
+/** Profile the surface is installed into; only used for the resume hint. */
+export const PROFILE_NAME = 'tui';
+/** Line printed after the terminal is handed back, so the session is recoverable. */
+export function resumeHint(sessionId, profile) {
+    return `To resume this session: dsh --profile ${profile} --resume=${sessionId}`;
+}
+//# sourceMappingURL=identity.js.map

package/lib/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGpD,uEAAuE;AACvE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;CAAG;AAY9C;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAKnC;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACrC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,IAAI,uBAAuB,CAAC,CAAA;IAC9E,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACrF,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC9C,IAAI,SAAS,KAAK,EAAE,IAAI,UAAU,KAAK,EAAE,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACtE,MAAM,IAAI,gBAAgB,CAAC,wEAAwE,CAAC,CAAA;IACtG,CAAC;IACD,IAAI,UAAU,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACvE,MAAM,IAAI,gBAAgB,CAAC,+CAA+C,CAAC,CAAA;IAC7E,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAA;IAC1D,MAAM,eAAe,GAAG,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,CAAA;IAChG,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,IAAI,eAAe,EAAE,CAAC;QACjD,MAAM,IAAI,gBAAgB,CAAC,2DAA2D,CAAC,CAAA;IACzF,CAAC;IACD,OAAO;QACL,QAAQ;QACR,iFAAiF;QACjF,YAAY,EAAE,QAAQ,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC;QACtF,KAAK,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI;KACjC,CAAA;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAC,MAAoB,EAAE,IAAY;IAC3D,OAAO,MAAM,CAAC,QAAQ,KAAK,EAAE;QAC3B,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;QACzD,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AACtD,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAA;AAEjC,qFAAqF;AACrF,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,OAAe;IAC3D,OAAO,yCAAyC,OAAO,aAAa,SAAS,EAAE,CAAA;AACjF,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,24 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "tui";
+/** `agents` is the only service the surface cannot run without. */
+export declare const inject: string[];
+/**
+ * Refuse to run without a real terminal.
+ *
+ * A terminal surface that silently degrades to line mode hides deployment
+ * mistakes and changes interaction semantics, so an unattended invocation
+ * fails loud instead: a caller that wants one-shot output uses headless mode.
+ */
+export declare function assertInteractiveTerminal(input?: {
+    readonly stdinIsTTY?: boolean;
+    readonly stdoutIsTTY?: boolean;
+}): void;
+/**
+ * Mount the terminal surface over the composed agent plane.
+ *
+ * The plugin owns input and presentation only: agent lifecycle, session
+ * persistence, tool execution, and the model-facing question tool stay with
+ * the composition rows around it.
+ */
+export declare function apply(ctx: Context, config: unknown): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAkDlD,eAAO,MAAM,IAAI,QAAQ,CAAA;AAEzB,mEAAmE;AACnE,eAAO,MAAM,MAAM,UAAa,CAAA;AAgChC;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,GAAE;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAC1B,GAAG,IAAI,CAMZ;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAioCzD"}