dsh-code 0.3.0 → 0.5.0

package/src/startup.ts

@@ -1,6 +1,6 @@
 /**
  * The interactive terminal app's command-line provider: parses `--resume`,
- * `--continue`, `--session`, and `--help`, then publishes
+ * `--continue`, `--session`, `--mode`, and `--help`, then publishes
  * {@link TUI_STARTUP_SERVICE} for the runner to consume lazily. Follows the
  * headless bundle's startup shape (a commander action publishing a service
  * through {@link parseCmdline}).
@@ -33,11 +33,37 @@ export const TUI_STARTUP_SERVICE = 'tuiStartup'
 
 /** How the runner obtains its session identity. */
 export type TuiStartup =
-  | { readonly kind: 'fresh' }
-  | { readonly kind: 'named'; readonly sessionId: string }
+  | { readonly kind: 'fresh'; readonly mode?: string }
+  | { readonly kind: 'named'; readonly sessionId: string; readonly mode?: string }
   | { readonly kind: 'resume'; readonly sessionId: string }
   | { readonly kind: 'latest' }
 
+export interface TuiStartupOptions {
+  readonly resume?: string
+  readonly continue?: boolean
+  readonly session?: string
+  readonly mode?: string
+}
+
+/** Pure option policy shared by Commander and tests. */
+export function resolveTuiStartup(options: TuiStartupOptions): TuiStartup {
+  const selected = [options.resume !== undefined, options.continue === true, options.session !== undefined]
+  if (selected.filter(Boolean).length > 1) throw new Error('--resume, --continue, and --session are mutually exclusive')
+  if (options.session === '') throw new Error('--session needs an id')
+  if (options.resume === '') throw new Error('--resume needs a session id or id prefix')
+  if (options.mode === '') throw new Error('--mode needs a preset id')
+  if (options.mode !== undefined && (options.resume !== undefined || options.continue === true)) {
+    throw new Error('--mode applies only to a new session; it cannot be combined with --resume or --continue')
+  }
+  return options.resume !== undefined
+    ? { kind: 'resume', sessionId: options.resume }
+    : options.continue === true
+      ? { kind: 'latest' }
+      : options.session !== undefined
+        ? { kind: 'named', sessionId: options.session, ...options.mode === undefined ? {} : { mode: options.mode } }
+        : { kind: 'fresh', ...options.mode === undefined ? {} : { mode: options.mode } }
+}
+
 /**
  * This app's command: the launcher's flags this app owns, its description,
  * and its help text.
@@ -51,11 +77,13 @@ function tuiCommand(): Command {
     .option('-r, --resume <session>', 'resume the persisted session with this id (or unique id prefix)')
     .option('-c, --continue', 'resume the most recent persisted session for this working directory')
     .option('--session <id>', 'create a new session under this explicit id')
+    .option('--mode <preset>', 'agent preset for a newly created session')
     .addHelpText('after', `
 Examples:
   dsh --profile cli                       fresh session, minted id
   dsh --profile cli --resume abc123       resume session by id prefix
   dsh --profile cli --continue            resume the latest local session
+  dsh --profile cli --mode minimal        fresh session using the minimal preset
 `)
 }
 
@@ -67,24 +95,14 @@ Examples:
 export function apply(ctx: Context): void {
   const program = tuiCommand()
   program.action(() => {
-    const options = program.opts<{ resume?: string; continue?: boolean; session?: string }>()
-    const selected = [options.resume !== undefined, options.continue === true, options.session !== undefined]
-    if (selected.filter(Boolean).length > 1) {
-      program.error('error: --resume, --continue, and --session are mutually exclusive')
-    }
-    if (options.session !== undefined && options.session === '') {
-      program.error('error: --session needs an id')
-    }
-    if (options.resume !== undefined && options.resume === '') {
-      program.error('error: --resume needs a session id or id prefix')
+    const options = program.opts<TuiStartupOptions>()
+    let startup: TuiStartup | undefined
+    try {
+      startup = resolveTuiStartup(options)
+    } catch (error: unknown) {
+      program.error(`error: ${error instanceof Error ? error.message : String(error)}`)
     }
-    const startup: TuiStartup = options.resume !== undefined
-      ? { kind: 'resume', sessionId: options.resume }
-      : options.continue === true
-        ? { kind: 'latest' }
-        : options.session !== undefined
-          ? { kind: 'named', sessionId: options.session }
-          : { kind: 'fresh' }
+    if (startup === undefined) return
     ctx.provide(TUI_STARTUP_SERVICE, { startup } satisfies { startup: TuiStartup })
   })
   parseCmdline(ctx, program)

package/src/store.ts

@@ -18,6 +18,8 @@ export interface TranscriptStore {
   subscribe(listener: () => void): () => void
   /** Fold one session event; ignored events change nothing and notify nobody. */
   apply(event: SessionEvent): void
+  /** Drop the folded view entirely (/clear): the next event starts a fresh one. */
+  reset(): void
 }
 
 /**
@@ -49,5 +51,11 @@ export function createTranscriptStore(replay?: readonly SessionEvent[]): Transcr
         listener()
       }
     },
+    reset(): void {
+      view = createTranscriptView()
+      for (const listener of listeners) {
+        listener()
+      }
+    },
   }
 }