@deepseek-harness-tui/dsh-tui 0.14.0 → 0.15.0

package/tui-profile/protocols/profile-definitions.d.ts

@@ -8,6 +8,7 @@ export const DECISION_EVENTS: Readonly<ApiReference & {
 }>
 
 export const decisionEventsDefinition: ProtocolDefinition
+export const backendDefinition: ProtocolDefinition
 export const profileDefinitions: readonly ProtocolDefinition[]
 
 export function registerProfileProtocols(catalog: ProtocolCatalog): () => void

package/tui-profile/protocols/profile-definitions.js

@@ -3,6 +3,7 @@
 export { registerTuiContributionExtensions } from './tui-contributions.js'
 export * from './tui-channel.js'
 import { tuiChannelDefinition } from './tui-channel.js'
+import { BACKEND } from './tui-contributions.js'
 
 export const DECISION_EVENTS = Object.freeze({
   apiVersion: 'tui.dsh/v1alpha1',
@@ -48,9 +49,22 @@ function providerDefinition(reference, label) {
 
 export const decisionEventsDefinition = providerDefinition(DECISION_EVENTS, 'DecisionEvents')
 
+/**
+ * The `Backend` contribution coordinate as a **host-published contract** (C
+ * stage / W-2). The family's own declaration shape and validator live in
+ * `tui-contributions.js` (the manifest extension catalog); this definition is the
+ * other half — the coordinate a bundle names in `requires.contracts`, which the
+ * host descriptor advertises once its admission machine answers a real probe.
+ * Like DecisionEvents it carries no support spec: a backend's support is not
+ * feature-granular, and what a declaration may say is decided by the extension
+ * definition, not by this contract.
+ */
+export const backendDefinition = providerDefinition(BACKEND, 'Backend')
+
 export const profileDefinitions = Object.freeze([
   decisionEventsDefinition,
   tuiChannelDefinition,
+  backendDefinition,
 ])
 
 export function registerProfileProtocols(catalog) {

package/tui-profile/protocols/tui-contributions.d.ts

@@ -4,6 +4,9 @@ import type { ManifestDefinitionCatalog, ManifestObjectDefinition } from '@dsh-s
 export const API_VERSION: 'tui.dsh/v1alpha1'
 export const SETTINGS_SECTION: Readonly<ApiReference & { kind: 'SettingsSection' }>
 export const SCENE: Readonly<ApiReference & { kind: 'Scene' }>
+export const BACKEND: Readonly<ApiReference & { kind: 'Backend' }>
+export const BACKEND_RESERVED_IDS: readonly string[]
+export const BACKEND_CONFIRMATION_POLICIES: readonly ('confirm' | 'trusted-source')[]
 
 export type LocalizedText = Readonly<Record<string, string>>
 export type SettingsFieldKind = 'text' | 'number' | 'boolean' | 'select'
@@ -32,11 +35,63 @@ export interface SceneHandler<Props = unknown, Result = unknown> {
   readonly component: (props: Props) => Result
 }
 
+/**
+ * The install recipe the host's wizard would run: `executor` names one of the
+ * host's executors, `specifier`/`version` are what it would add. An executor this
+ * host does not implement means "no install surface", never a refused
+ * declaration. Absent = nothing to install (the user's own binary is the
+ * dependency).
+ */
+export interface BackendInstallRecipe {
+  readonly executor: string
+  readonly specifier: string
+  readonly version: string
+}
+
+/**
+ * One backend's public declaration.
+ *
+ * Plain `string`, literal label text and plain arrays only, on purpose (roadmap
+ * §6 item 10): this value arrives from JSON/YAML, across versions, where a
+ * compile-time brand protects nothing. Discriminated unions and brands stay
+ * inside the host package.
+ */
+export interface BackendSpec {
+  readonly id: string
+  /** Literal only — a host i18n key is refused (D2). */
+  readonly label: { readonly text: string }
+  readonly shortLabel: string
+  readonly product?: string
+  readonly capabilities: readonly string[]
+  readonly grants: readonly string[]
+  readonly install?: BackendInstallRecipe
+  /** Module export closing this backend's process-wide resource pool. See the
+   *  definition body: session-scoped resources belong to `session.dispose()`. */
+  readonly unloadExport?: string
+  /** The confirmation this contribution requests; absent means the default
+   *  `confirm`. `trusted-source` asks for the host's own source judgment and is
+   *  honored only when that judgment holds — it never exempts by itself. */
+  readonly confirmation?: { readonly policy: 'confirm' | 'trusted-source' }
+}
+
+/** The handler a contribution binds at registration (the runtime `AgentBackend`). */
+export interface BackendHandler {
+  readonly id: string
+  readonly descriptor?: object
+  detect(...args: unknown[]): Promise<unknown>
+  open(...args: unknown[]): Promise<unknown>
+  readonly catalog?: object
+  readonly launch?: object
+}
+
 export const settingsSectionExtensionDefinition: ManifestObjectDefinition
 export const sceneExtensionDefinition: ManifestObjectDefinition
+export const backendExtensionDefinition: ManifestObjectDefinition
 export const contributionExtensionDefinitions: readonly ManifestObjectDefinition[]
 export function validateSettingsSectionSpec(value: unknown): Readonly<SettingsSectionSpec>
 export function validateSceneSpec(value: unknown): Readonly<SceneSpec>
+export function validateBackendSpec(value: unknown): Readonly<BackendSpec>
 export function registerTuiContributionExtensions(catalog: ManifestDefinitionCatalog): () => void
 export function assertSettingsSectionHandler(value: unknown): asserts value is SettingsSectionHandler
 export function assertSceneHandler(value: unknown): asserts value is SceneHandler
+export function assertBackendHandler(value: unknown): asserts value is BackendHandler

package/tui-profile/protocols/tui-contributions.js

@@ -12,6 +12,44 @@ export const SCENE = Object.freeze({
   kind: 'Scene',
 })
 
+export const BACKEND = Object.freeze({
+  apiVersion: API_VERSION,
+  kind: 'Backend',
+})
+
+/**
+ * Ids the host owns. A **contribution** may not wear one: `dsh` serializes
+ * session refs without a prefix, and the bundled backends' rows are the host's own
+ * vocabulary — a plugin claiming either would render as first-party. The host's
+ * own seed legitimately carries them, so this is deliberately **not** a shape rule
+ * (one declaration shape is valid for the seed and invalid for a bundle): the host
+ * refuses a contribution whose `id` is in this set at admission, with
+ * `BACKEND_ID_RESERVED`. Mirrored by the host registry (`BUILTIN_BACKEND_IDS`); the
+ * two lists are compared bidirectionally by
+ * `scripts/verify-backend-contribution.ts`.
+ */
+export const BACKEND_RESERVED_IDS = Object.freeze(['dsh', 'claude', 'codex'])
+
+/**
+ * The confirmation policies this host implements (roadmap §6 item 5 ②).
+ *
+ * A contribution **requests** a policy; the host decides. `confirm` (the default
+ * when the field is absent) always asks the user. `trusted-source` asks for the
+ * host's trusted-source path: the host applies *its own* judgment of where the
+ * package came from — a curated, offline-readable list of first-party packages,
+ * cross-checked against provenance when the registry offers it — and **falls back
+ * to `confirm` whenever that judgment does not hold**. A declaration therefore
+ * never exempts itself: wearing this value is a request, not a grant, and any
+ * mismatch (not on the list, publisher disagrees, provenance disagrees) is
+ * fail-closed. Exempting an entry from the interactive confirmation never exempts
+ * it from the effect ledger or from being listed.
+ *
+ * An unknown value is refused: a contribution may never exempt itself from a
+ * confirmation this host does not implement. The vocabulary only grows — a later
+ * decision adds a value rather than widening the field (additive, not breaking).
+ */
+export const BACKEND_CONFIRMATION_POLICIES = Object.freeze(['confirm', 'trusted-source'])
+
 export const settingsSectionExtensionDefinition = Object.freeze({
   ...SETTINGS_SECTION,
   validateMetadata(metadata) {
@@ -52,9 +90,85 @@ export function validateSceneSpec(value) {
   })
 }
 
+/**
+ * One backend's public declaration (`tui.dsh/v1alpha1#Backend`).
+ *
+ * The body is **shape + honesty**, never authority: an in-process backend runs
+ * with this host's own privileges (`securityBoundary: false` in the contract
+ * profile), so nothing here is enforced against a hostile plugin — what it buys
+ * is that the host can state what a backend claims *before* it runs, and that a
+ * claim the host cannot honor (a reserved id, a host label key, a native channel,
+ * a self-granted confirmation exemption) is refused at admission rather than
+ * discovered later.
+ *
+ * Deliberately absent: `inTree` (a host fact, not a contribution one),
+ * `alwaysAvailable`, `nativeKey` (refused outright — a native channel is derived
+ * from an in-tree manifest, never declared) and `backendExport` (the build-time
+ * index resolves an export name from a module namespace; a contribution hands
+ * over its handler object at registration instead).
+ */
+export const backendExtensionDefinition = Object.freeze({
+  ...BACKEND,
+  validateMetadata(metadata) {
+    contributionName(metadata?.name, 'Backend metadata.name')
+  },
+  validateSpec: validateBackendSpec,
+})
+
+export function validateBackendSpec(value) {
+  const spec = exactRecord(value, [
+    'id', 'label', 'shortLabel', 'product', 'capabilities', 'grants', 'install', 'unloadExport', 'confirmation',
+  ], 'Backend content')
+  if (typeof spec.id !== 'string' || !/^[a-z0-9][a-z0-9-]{0,31}$/u.test(spec.id)) {
+    throw new TypeError('Backend content.id is invalid (lowercase letters, digits and dashes, at most 32 characters)')
+  }
+  // Literal text only: a host i18n key here would let a contribution paint
+  // itself with the host's own vocabulary (D2). The host expands its in-tree
+  // `{ kind: 'key' }` labels into literals before projecting them here.
+  const label = exactRecord(spec.label, ['text'], 'Backend content.label')
+  nonEmpty(label.text, 'Backend content.label.text')
+  nonEmpty(spec.shortLabel, 'Backend content.shortLabel')
+  if (spec.product !== undefined) nonEmpty(spec.product, 'Backend content.product')
+  stringArray(spec.capabilities, 'Backend content.capabilities')
+  stringArray(spec.grants, 'Backend content.grants')
+  if (spec.install !== undefined) {
+    const install = exactRecord(spec.install, ['executor', 'specifier', 'version'], 'Backend content.install')
+    for (const field of ['executor', 'specifier', 'version']) {
+      nonEmpty(install[field], `Backend content.install.${field}`)
+    }
+  }
+  if (spec.unloadExport !== undefined) nonEmpty(spec.unloadExport, 'Backend content.unloadExport')
+  let confirmation
+  if (spec.confirmation !== undefined) {
+    const declared = exactRecord(spec.confirmation, ['policy'], 'Backend content.confirmation')
+    if (!BACKEND_CONFIRMATION_POLICIES.includes(declared.policy)) {
+      throw new TypeError('Backend content.confirmation.policy is not a policy this host implements')
+    }
+    confirmation = Object.freeze({ policy: declared.policy })
+  }
+  return Object.freeze({
+    id: spec.id,
+    label: Object.freeze({ text: label.text }),
+    shortLabel: spec.shortLabel,
+    ...(spec.product === undefined ? {} : { product: spec.product }),
+    capabilities: Object.freeze([...spec.capabilities]),
+    grants: Object.freeze([...spec.grants]),
+    ...(spec.install === undefined ? {} : {
+      install: Object.freeze({
+        executor: spec.install.executor,
+        specifier: spec.install.specifier,
+        version: spec.install.version,
+      }),
+    }),
+    ...(spec.unloadExport === undefined ? {} : { unloadExport: spec.unloadExport }),
+    ...(confirmation === undefined ? {} : { confirmation }),
+  })
+}
+
 export const contributionExtensionDefinitions = Object.freeze([
   settingsSectionExtensionDefinition,
   sceneExtensionDefinition,
+  backendExtensionDefinition,
 ])
 
 export function registerTuiContributionExtensions(catalog) {
@@ -71,6 +185,24 @@ export function assertSceneHandler(value) {
   if (typeof handler.component !== 'function') throw new TypeError('Scene handler.component must be a function')
 }
 
+/**
+ * The handler a contribution binds at registration — the runtime form of
+ * `AgentBackend`, asserted at the same boundary `assertSceneHandler` guards: the
+ * declaration above is validated as data, this is the object the host is about to
+ * call. `catalog`, `launch` and `descriptor` are objects when present, never
+ * silently ignored.
+ */
+export function assertBackendHandler(value) {
+  const handler = runtimeObject(value, 'Backend handler')
+  nonEmpty(handler.id, 'Backend handler.id')
+  for (const method of ['detect', 'open']) {
+    if (typeof handler[method] !== 'function') throw new TypeError(`Backend handler.${method} must be a function`)
+  }
+  for (const member of ['descriptor', 'catalog', 'launch']) {
+    if (handler[member] !== undefined) runtimeObject(handler[member], `Backend handler.${member}`)
+  }
+}
+
 function validateSettingsField(value, index) {
   const label = `SettingsSection spec.fields[${index}]`
   const field = exactRecord(value, [
@@ -129,6 +261,15 @@ function nonEmpty(value, label) {
   if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)
 }
 
+/** Names a backend declares. The *vocabulary* is the host's (admission maps an
+ *  unknown name to a pending item, never to a rejection); the shape is not. */
+function stringArray(value, label) {
+  if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`)
+  for (const entry of value) {
+    if (typeof entry !== 'string' || entry.trim() === '') throw new TypeError(`${label} must contain non-empty strings`)
+  }
+}
+
 function localized(value, label) {
   if (value === undefined) return
   const record = exactRecord(value, Object.keys(value), label)

package/tui-profile/registry/contracts/backend-v1alpha1.json

@@ -0,0 +1,13 @@
+{
+  "name":"tui.backend","version":"v1alpha1","kind":"extension",
+  "coordinates":{"apiVersion":"tui.dsh/v1alpha1","kind":"Backend"},
+  "caller":"trusted in-process dsh-TUI backend registry",
+  "permissions":[],
+  "operations":["declare","detect","open","catalog","resume"],
+  "errors":["BACKEND_ID_RESERVED","PERMISSION_NOT_GRANTED"],
+  "concurrency":"one backend owns one process-wide resource pool; session-scoped resources belong to session.dispose()",
+  "timeout":"detection and install preflight are local; session operations retain their own deadlines",
+  "cleanup":"the registry closes only the entries it actually loaded (unloadExport); a session's resources are closed by its own dispose()",
+  "privacyClass":"sensitive",
+  "securityBoundary":false
+}

package/tui-profile/registry/registry-0.15.json

@@ -141,6 +141,18 @@
       "profile": "registry/contracts/scene-v1alpha1.json",
       "profileHash": "sha256:69ce3ae26d60dea2ed170376db8a1fb5860c94bd192c62681423c1d848ec2b26",
       "permissions": []
+    },
+    {
+      "name": "tui.backend",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "Backend"
+      },
+      "kind": "extension",
+      "profile": "registry/contracts/backend-v1alpha1.json",
+      "profileHash": "sha256:14d0923ccead5420219da39767050cdb46aa8e29f2b168d8d1e9b6cb1b3d4547",
+      "permissions": []
     }
   ],
   "facetApiVersions": [

package/lib/types/backends/claude/install.d.ts

@@ -1,15 +0,0 @@
-import type { SdkInstallTarget, SdkInstaller } from '../../agent/backend.js';
-/** What `pnpm add` installs, at the validated pin (see contract.ts). */
-export declare const CLAUDE_SDK_SPECIFIER = "@anthropic-ai/claude-agent-sdk@0.3.287";
-export type { SdkInstallTarget, SdkInstallResult, SdkInstaller } from '../../agent/backend.js';
-/** Resolve the install target for the CURRENT launch (never throws). The
- *  non-profile kinds carry the reason for the wizard's manual-instructions
- *  panel: standalone builds swap a whole binary (update.ts owns that path),
- *  and source checkouts / `--config` launches have no profile to add into. */
-export declare function resolveSdkInstallTarget(argv?: readonly string[]): SdkInstallTarget;
-/** Whether `pnpm` runs at all (the wizard's preflight). */
-export declare function checkPnpmAvailable(): Promise<boolean>;
-/** Install the pinned SDK into the profile root. Resolve target failures are
- *  the caller's business (the wizard shows manual instructions for them). */
-export declare function startClaudeSdkInstall(dir: string): SdkInstaller;
-//# sourceMappingURL=install.d.ts.map

package/lib/types/backends/claude/install.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../src/backends/claude/install.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAK9F,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,2CAA4D,CAAA;AAE7F,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE9F;;;8EAG8E;AAC9E,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,gBAAgB,CAIhG;AA2CD,2DAA2D;AAC3D,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAI3D;AAED;6EAC6E;AAC7E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAU/D"}

package/lib/types/backends/claude/install.js

@@ -1,91 +0,0 @@
-/**
- * One-shot installer for the optional `@anthropic-ai/claude-agent-sdk` peer.
- *
- * Runs `pnpm add <sdk>@<pin>` in the DSH profile root — the install dir whose
- * `node_modules` the backend's dynamic import resolves through. Everything the
- * child prints is piped and captured, never inherited: an inherit-stdio child
- * may only run after the Ink frame is unmounted (the update.ts contract); a
- * captured one may run under the live TUI, which is what the kernel-picker
- * install wizard needs. Only the tail of the captured output is surfaced, on
- * failure.
- *
- * The pinned SDK version is old enough that pnpm's minimumReleaseAge gate
- * never blocks it; if the pin ever moves to a version published within the
- * gate's window, the install needs a `minimumReleaseAgeExclude` entry
- * (generalize `ensureProfileReleaseAgeExclude` in update.ts then).
- */
-import { spawn } from 'node:child_process';
-import { homedir } from 'node:os';
-import { dirname } from 'node:path';
-import stripAnsi from 'strip-ansi';
-import { isStandaloneRuntime, profileWorkspaceYamlPath, resolveDshProfileName } from '../../update.js';
-import { shellQuote } from '../../utils/shellQuote.js';
-import { VALIDATED_SDK_VERSION } from './contract.js';
-/** What `pnpm add` installs, at the validated pin (see contract.ts). */
-export const CLAUDE_SDK_SPECIFIER = `@anthropic-ai/claude-agent-sdk@${VALIDATED_SDK_VERSION}`;
-/** Resolve the install target for the CURRENT launch (never throws). The
- *  non-profile kinds carry the reason for the wizard's manual-instructions
- *  panel: standalone builds swap a whole binary (update.ts owns that path),
- *  and source checkouts / `--config` launches have no profile to add into. */
-export function resolveSdkInstallTarget(argv = process.argv) {
-    if (isStandaloneRuntime())
-        return { kind: 'standalone' };
-    const profile = resolveDshProfileName(argv);
-    return profile === undefined ? { kind: 'no-profile' } : { kind: 'profile', dir: dirname(profileWorkspaceYamlPath(profile)) };
-}
-/** Run pnpm with captured output. On Windows the arguments fold into the
- *  command string and go through the shell — pnpm is a `.cmd` shim there and
- *  Node ≥22 refuses to spawn `.cmd` directly (DEP0190) — the same escape
- *  update.ts's runProcess uses. */
-function runPnpm(args, cwd) {
-    const windows = process.platform === 'win32';
-    const [command, spawnArgs] = windows
-        ? [`pnpm ${shellQuote(args).join(' ')}`, []]
-        : ['pnpm', [...args]];
-    const child = spawn(command, spawnArgs, {
-        cwd,
-        shell: windows,
-        stdio: ['ignore', 'pipe', 'pipe'],
-        windowsHide: true,
-    });
-    const chunks = [];
-    for (const stream of [child.stdout, child.stderr]) {
-        if (stream === null)
-            continue;
-        stream.setEncoding('utf8');
-        stream.on('data', (chunk) => { chunks.push(chunk); });
-    }
-    const promise = new Promise(resolve => {
-        const finish = (code, spawnError) => {
-            // pnpm progress frames redraw with \r — split on all line breaks, strip
-            // the ANSI layer, drop the empty frames the redraws leave behind.
-            const lines = chunks.join('').split(/\r\n|\r|\n/u).map(line => stripAnsi(line).trim()).filter(line => line !== '');
-            resolve({ code, spawnError, lines });
-        };
-        child.once('error', error => finish(undefined, error.code));
-        child.once('close', code => finish(code ?? undefined));
-    });
-    return { promise, cancel: () => { child.kill(); } };
-}
-/** Whether `pnpm` runs at all (the wizard's preflight). */
-export async function checkPnpmAvailable() {
-    const { promise } = runPnpm(['--version'], homedir());
-    const run = await promise;
-    return run.code === 0 && run.spawnError === undefined;
-}
-/** Install the pinned SDK into the profile root. Resolve target failures are
- *  the caller's business (the wizard shows manual instructions for them). */
-export function startClaudeSdkInstall(dir) {
-    let cancelled = false;
-    const { promise, cancel } = runPnpm(['add', CLAUDE_SDK_SPECIFIER], dir);
-    const result = promise.then(run => {
-        if (cancelled)
-            return { kind: 'cancelled' };
-        if (run.code === 0)
-            return { kind: 'ok' };
-        if (run.spawnError === 'ENOENT')
-            return { kind: 'pnpm-missing' };
-        return { kind: 'failed', exitCode: run.code ?? 1, tail: run.lines.slice(-10) };
-    });
-    return { result, cancel: () => { cancelled = true; cancel(); } };
-}

package/lib/types/channel/elicitation.d.ts.map

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

package/lib/types/dsh-adapter/channel/session-lineage.d.ts

@@ -1,42 +0,0 @@
-/**
- * Lineage decision consulted by `/model` only.
- *
- * `/rewind` and the `/tree` branch also re-create the live session as a child,
- * but they always record `parentSession` and do not call this helper. A blank
- * log cannot reach them (`boundary < 0`). This module is not their gate.
- *
- * The decision is load-bearing beyond grouping. Upstream's automatic session
- * title only ever runs on a session WITHOUT a parent: `dsh-session-title`
- * schedules its provider on the first human message under
- * `session.header.parentSession === undefined`, and a session that already has
- * one is never offered a generated title again — a fork keeps the title it
- * inherited, and only an explicit `ctx.sessionTitle.refresh()` retries, which
- * no TUI surface calls. A route switch on a session nobody has typed into
- * would therefore cost that user the title of their first real prompt, leaving
- * the deterministic fallback instead (a mid-word truncation of the prompt at
- * `fallbackMaxBytes`).
- *
- * A session with no human message has no conversation for the lineage to
- * describe, so its replacement stands as its own root — the same independent-
- * conversation choice `/fork` already makes (`session-fork.ts`), for the same
- * reason. The seeded prefix is unaffected either way: the child still inherits
- * the source's session scaffolding verbatim.
- *
- * @module
- */
-import type { SessionEvent } from '@deepseek-ai/dsh-session';
-/**
- * Whether a re-created child must record the session it replaces as its parent.
- *
- * A `user/message` whose `source` is the person at the keyboard is a human turn
- * whether or not it carries text (an image-only prompt is still a prompt), so
- * its session is a conversation the lineage must describe. A user-role message
- * from any other producer — a plugin injection, an instruction snapshot, a
- * skill catalogue — is not: the child stays in the same family rather than
- * being promoted to a root on a technicality.
- *
- * @param seed - the exact events the child inherits.
- * @returns whether the child records `parentSession`.
- */
-export declare function childRecordsLineage(seed: readonly SessionEvent[]): boolean;
-//# sourceMappingURL=session-lineage.d.ts.map

package/lib/types/dsh-adapter/channel/session-lineage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-lineage.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/session-lineage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAE1E"}

package/lib/types/dsh-adapter/channel/session-lineage.js

@@ -1,51 +0,0 @@
-/**
- * Lineage decision consulted by `/model` only.
- *
- * `/rewind` and the `/tree` branch also re-create the live session as a child,
- * but they always record `parentSession` and do not call this helper. A blank
- * log cannot reach them (`boundary < 0`). This module is not their gate.
- *
- * The decision is load-bearing beyond grouping. Upstream's automatic session
- * title only ever runs on a session WITHOUT a parent: `dsh-session-title`
- * schedules its provider on the first human message under
- * `session.header.parentSession === undefined`, and a session that already has
- * one is never offered a generated title again — a fork keeps the title it
- * inherited, and only an explicit `ctx.sessionTitle.refresh()` retries, which
- * no TUI surface calls. A route switch on a session nobody has typed into
- * would therefore cost that user the title of their first real prompt, leaving
- * the deterministic fallback instead (a mid-word truncation of the prompt at
- * `fallbackMaxBytes`).
- *
- * A session with no human message has no conversation for the lineage to
- * describe, so its replacement stands as its own root — the same independent-
- * conversation choice `/fork` already makes (`session-fork.ts`), for the same
- * reason. The seeded prefix is unaffected either way: the child still inherits
- * the source's session scaffolding verbatim.
- *
- * @module
- */
-/**
- * Whether a re-created child must record the session it replaces as its parent.
- *
- * A `user/message` whose `source` is the person at the keyboard is a human turn
- * whether or not it carries text (an image-only prompt is still a prompt), so
- * its session is a conversation the lineage must describe. A user-role message
- * from any other producer — a plugin injection, an instruction snapshot, a
- * skill catalogue — is not: the child stays in the same family rather than
- * being promoted to a root on a technicality.
- *
- * @param seed - the exact events the child inherits.
- * @returns whether the child records `parentSession`.
- */
-export function childRecordsLineage(seed) {
-    return seed.some(isHumanMessage);
-}
-/** One message the person at the keyboard sent, by `source.kind` alone. */
-function isHumanMessage(event) {
-    if (event.type !== 'user/message')
-        return false;
-    // Durable data: the source is a merge-extensible sum type whose members are
-    // declared by their producers, so narrow instead of trusting the union.
-    const source = event.data.source;
-    return source?.kind === 'user';
-}

package/lib/types/utils/jsonl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/utils/jsonl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iCAAiC;AACjC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEhD,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAE5D;AAED,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IACvC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAgBjD"}