@xmoon76/dsh-pi-tui 0.1.3 → 0.1.4

package/README.md

@@ -2,7 +2,7 @@
 
 A third-party TUI mode for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`), built on a vendored fork of [pi-tui](https://github.com/MoonshotAI/kimi-code/tree/main/packages/pi-tui).
 
-This package is the `dsh.bundle` layer that makes `dsh --profile pi-tui` run a terminal UI instead of the browser GUI (`dsh --profile web`) or one-shot mode (`dsh --profile headless`). The vendored pi-tui fork (`@xmoon76/pi-tui`, with its five local rendering fixes) is bundled inside this package's build output — you only ever install this one package.
+This package is the `dsh.bundle` layer that makes `dsh --profile pi-tui` run a terminal UI instead of the browser GUI (`dsh --profile web`) or one-shot mode (`dsh --profile headless`). The vendored pi-tui fork (`@xmoon76/pi-tui`, with its local rendering fixes — the divergence ledger lives in the repo at `packages/pi-tui/AGENTS.md`) is bundled inside this package's build output — you only ever install this one package.
 
 ## Install
 

package/dist/index.d.mts

@@ -22,6 +22,43 @@ interface Config {
   sessionId?: string;
 }
 declare const Config: z<Config>;
+/**
+ * Slash commands that need no session: before the first user message
+ * (deferred start) they run locally without creating one. Everything else
+ * dispatches through `commands.execute`, which creates the session lazily
+ * (the command line IS the first user input). Commands in this set must
+ * tolerate `liveAgent === undefined` in their handlers.
+ *
+ * Exported for the headless suite: the gate is exactly where a sessionless
+ * command silently starts creating sessions again.
+ */
+declare const SESSIONLESS_COMMANDS: Set<string>;
+/**
+ * The LOCAL-execute command set: TUI-owned UI/control commands AND core
+ * control commands the TUI does not itself register (e.g. /kill) that
+ * must ALWAYS run locally through the commands service, never steered,
+ * regardless of the busyEnter preference. Everything NOT in this set —
+ * plain prompts AND non-local commands (the per-skill slash commands like
+ * /grilling or /matrix-cli) — flows through the busy-Enter submission
+ * policy while the agent is running: web parity, where a skill invocation
+ * is a plain `session.prompt` whose leading `/name` line the host's
+ * pre-step listener (dsh-tool-skill) resolves into the injected skill
+ * body — there is no command-execution wire for skills.
+ */
+declare const LOCAL_COMMANDS: Set<string>;
+/**
+ * Whether one submission steers under the busy-Enter preference: NOT a
+ * force-queued chord, NOT a TUI-owned local command, and the agent is
+ * running with the preference set to 'steer'. Pure so the dispatch gate
+ * (inside the runner closure) is testable headless.
+ * @param parsed - the parsed slash command, undefined for a plain prompt.
+ * @param running - whether the live agent reports running.
+ * @param busyEnter - the persisted preference value (''/undefined = queue).
+ * @param forceQueue - the Ctrl+Enter chord: always queue, never steer.
+ */
+declare function shouldSteerOnEnter(parsed: {
+  name: string;
+} | undefined, running: boolean, busyEnter: string | undefined, forceQueue: boolean): boolean;
 /**
  * Read an explicit child-session reference from a future/extended job record.
  * Current dsh JobSnapshot records do not expose one, so this normally returns
@@ -131,4 +168,4 @@ declare function recomposeBlank(ctx: Context, agent: {
  */
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { AgentComposition, Config, RecomposableSession, RecomposeOutcome, apply, composeAgent, dangerCommand, forkSeed, inject, name, recomposeBlank, recordedPreset, resumeCommand, runningProfile, subagentJobTranscriptId, subagentJobViewHint };
+export { AgentComposition, Config, LOCAL_COMMANDS, RecomposableSession, RecomposeOutcome, SESSIONLESS_COMMANDS, apply, composeAgent, dangerCommand, forkSeed, inject, name, recomposeBlank, recordedPreset, resumeCommand, runningProfile, shouldSteerOnEnter, subagentJobTranscriptId, subagentJobViewHint };