@orkestrel/terminal 0.0.4 → 0.0.5

package/dist/src/core/index.d.cts

@@ -312,7 +312,7 @@ export declare const CTRL_U: string;
  * - **`set(snapshot)` upserts under the snapshot's OWN `id`** (no separate id param) — it writes
  *   the row `{ id: snapshot.id, snapshot }`.
  * - **`get(id)` resolves the stored snapshot for an id**, narrowing the opaque JSON column back to
- *   a {@link TerminalSnapshot} ({@link import('./helpers.js').isTerminalSnapshot} — the AGENTS §14
+ *   a {@link TerminalSnapshot} ({@link import('./validators.js').isTerminalSnapshot} — the AGENTS §14
  *   boundary narrow for an untrusted storage read), or `undefined` if none is stored.
  * - **`delete(id)` drops a snapshot by id**; an absent id is a no-op (no throw).
  *
@@ -565,8 +565,10 @@ export declare function isCheckboxChoice(value: unknown): value is CheckboxChoic
 export declare function isInsecureRemote(url: string): boolean;
 
 /**
- * Narrow an unknown wire value to a {@link PendingPrompt} — the §14 guard a {@link PromptClient}
- * applies to each decoded SSE `pending` payload before dispatching it (never an `as`).
+ * Narrow an unknown wire value to a {@link PendingPrompt} before dispatching it.
+ *
+ * @param value - The decoded wire value to inspect
+ * @returns Whether `value` is a complete pending-prompt record
  */
 export declare const isPendingPrompt: Guard<PendingPrompt>;
 
@@ -599,7 +601,7 @@ export declare const isPromptType: Guard<PromptType>;
  */
 export declare function isTerminalError(value: unknown): value is TerminalError;
 
-/** Narrow an unknown value to a {@link TerminalSnapshot} — a non-empty `id` plus an optional numeric `timeout`. */
+/** Narrow an unknown value to a {@link TerminalSnapshot}. */
 export declare const isTerminalSnapshot: Guard<TerminalSnapshot>;
 
 /**
@@ -985,10 +987,10 @@ export declare class PromptClient implements PromptClientInterface {
  * - `error` — a connection / dispatch / POST fault (errors are `unknown`).
  */
 export declare type PromptClientEventMap = {
-    connect: [];
-    disconnect: [];
-    expire: [id: string];
-    error: [error: unknown];
+    readonly connect: readonly [];
+    readonly disconnect: readonly [];
+    readonly expire: readonly [id: string];
+    readonly error: readonly [error: unknown];
 };
 
 /**
@@ -1042,7 +1044,7 @@ export declare interface PromptClientOptions {
     readonly on?: EmitterHooks<PromptClientEventMap>;
     readonly error?: EmitterErrorHandler;
     readonly fetch?: FetchHandler;
-    readonly timer?: TimerHandler;
+    readonly timer?: TimerHandler_2;
 }
 
 /**
@@ -1055,9 +1057,9 @@ export declare interface PromptClientOptions {
  * - `expire` — a parked prompt timed out (or was torn down) unanswered (carries its `id`).
  */
 export declare type PromptEventMap = {
-    pending: [prompt: PendingPrompt];
-    answer: [id: string, value: unknown];
-    expire: [id: string];
+    readonly pending: readonly [prompt: PendingPrompt];
+    readonly answer: readonly [id: string, value: unknown];
+    readonly expire: readonly [id: string];
 };
 
 /**
@@ -1143,7 +1145,7 @@ export declare interface PromptOptions {
     readonly on?: EmitterHooks<PromptEventMap>;
     readonly error?: EmitterErrorHandler;
     readonly timeout?: number;
-    readonly timer?: TimerHandler;
+    readonly timer?: TimerHandler_2;
     readonly cap?: number;
 }
 
@@ -1511,9 +1513,9 @@ export declare class TerminalManager implements TerminalManagerInterface {
  * - `expire` — an endpoint's parked prompt timed out (`to` names the endpoint).
  */
 export declare type TerminalManagerEventMap = {
-    pending: [prompt: PendingPrompt];
-    answer: [to: string, id: string, value: unknown];
-    expire: [to: string, id: string];
+    readonly pending: readonly [prompt: PendingPrompt];
+    readonly answer: readonly [to: string, id: string, value: unknown];
+    readonly expire: readonly [to: string, id: string];
 };
 
 /**
@@ -1573,7 +1575,7 @@ export declare interface TerminalManagerInterface {
 export declare interface TerminalManagerOptions {
     readonly store?: TerminalStoreInterface;
     readonly timeout?: number;
-    readonly timer?: TimerHandler;
+    readonly timer?: TimerHandler_2;
     readonly cap?: number;
     readonly on?: EmitterHooks<TerminalManagerEventMap>;
     readonly error?: EmitterErrorHandler;
@@ -1582,7 +1584,7 @@ export declare interface TerminalManagerOptions {
 /** Options for {@link import('./factories.js').createTerminal} / a manager-owned {@link PromptInterface} broker — the per-endpoint `timeout` + injected `timer` + optional `cap` on concurrently-parked prompts. */
 export declare interface TerminalOptions {
     readonly timeout?: number;
-    readonly timer?: TimerHandler;
+    readonly timer?: TimerHandler_2;
     readonly cap?: number;
 }
 
@@ -1592,7 +1594,7 @@ export declare interface TerminalSnapshot {
     readonly timeout?: number;
 }
 
-/** One opaque persisted row — the shape a `TableInterface<TerminalSnapshotRow>`-backed store reads/writes; `snapshot` is narrowed with {@link import('./helpers.js').isTerminalSnapshot} on read. */
+/** One opaque persisted row — the shape a `TableInterface<TerminalSnapshotRow>`-backed store reads/writes; `snapshot` is narrowed with {@link import('./validators.js').isTerminalSnapshot} on read. */
 export declare interface TerminalSnapshotRow {
     readonly id: string;
     readonly snapshot: unknown;
@@ -1623,7 +1625,8 @@ export declare type TimerCancel = () => void;
  * `setTimeout` / `clearTimeout`; a test injects a deterministic timer that captures the callback
  * and fires it on demand (no real time, no global fake-timer patching).
  */
-export declare type TimerHandler = (callback: () => void, ms: number) => TimerCancel;
+declare type TimerHandler_2 = (callback: () => void, ms: number) => TimerCancel;
+export { TimerHandler_2 as TimerHandler }
 
 /** Toggle `index` in a readonly index list — copy-on-write, returning the new sorted-by-insertion list. */
 export declare function toggleIndex(indices: readonly number[], index: number): readonly number[];

package/dist/src/core/index.d.ts

@@ -312,7 +312,7 @@ export declare const CTRL_U: string;
  * - **`set(snapshot)` upserts under the snapshot's OWN `id`** (no separate id param) — it writes
  *   the row `{ id: snapshot.id, snapshot }`.
  * - **`get(id)` resolves the stored snapshot for an id**, narrowing the opaque JSON column back to
- *   a {@link TerminalSnapshot} ({@link import('./helpers.js').isTerminalSnapshot} — the AGENTS §14
+ *   a {@link TerminalSnapshot} ({@link import('./validators.js').isTerminalSnapshot} — the AGENTS §14
  *   boundary narrow for an untrusted storage read), or `undefined` if none is stored.
  * - **`delete(id)` drops a snapshot by id**; an absent id is a no-op (no throw).
  *
@@ -565,8 +565,10 @@ export declare function isCheckboxChoice(value: unknown): value is CheckboxChoic
 export declare function isInsecureRemote(url: string): boolean;
 
 /**
- * Narrow an unknown wire value to a {@link PendingPrompt} — the §14 guard a {@link PromptClient}
- * applies to each decoded SSE `pending` payload before dispatching it (never an `as`).
+ * Narrow an unknown wire value to a {@link PendingPrompt} before dispatching it.
+ *
+ * @param value - The decoded wire value to inspect
+ * @returns Whether `value` is a complete pending-prompt record
  */
 export declare const isPendingPrompt: Guard<PendingPrompt>;
 
@@ -599,7 +601,7 @@ export declare const isPromptType: Guard<PromptType>;
  */
 export declare function isTerminalError(value: unknown): value is TerminalError;
 
-/** Narrow an unknown value to a {@link TerminalSnapshot} — a non-empty `id` plus an optional numeric `timeout`. */
+/** Narrow an unknown value to a {@link TerminalSnapshot}. */
 export declare const isTerminalSnapshot: Guard<TerminalSnapshot>;
 
 /**
@@ -985,10 +987,10 @@ export declare class PromptClient implements PromptClientInterface {
  * - `error` — a connection / dispatch / POST fault (errors are `unknown`).
  */
 export declare type PromptClientEventMap = {
-    connect: [];
-    disconnect: [];
-    expire: [id: string];
-    error: [error: unknown];
+    readonly connect: readonly [];
+    readonly disconnect: readonly [];
+    readonly expire: readonly [id: string];
+    readonly error: readonly [error: unknown];
 };
 
 /**
@@ -1042,7 +1044,7 @@ export declare interface PromptClientOptions {
     readonly on?: EmitterHooks<PromptClientEventMap>;
     readonly error?: EmitterErrorHandler;
     readonly fetch?: FetchHandler;
-    readonly timer?: TimerHandler;
+    readonly timer?: TimerHandler_2;
 }
 
 /**
@@ -1055,9 +1057,9 @@ export declare interface PromptClientOptions {
  * - `expire` — a parked prompt timed out (or was torn down) unanswered (carries its `id`).
  */
 export declare type PromptEventMap = {
-    pending: [prompt: PendingPrompt];
-    answer: [id: string, value: unknown];
-    expire: [id: string];
+    readonly pending: readonly [prompt: PendingPrompt];
+    readonly answer: readonly [id: string, value: unknown];
+    readonly expire: readonly [id: string];
 };
 
 /**
@@ -1143,7 +1145,7 @@ export declare interface PromptOptions {
     readonly on?: EmitterHooks<PromptEventMap>;
     readonly error?: EmitterErrorHandler;
     readonly timeout?: number;
-    readonly timer?: TimerHandler;
+    readonly timer?: TimerHandler_2;
     readonly cap?: number;
 }
 
@@ -1511,9 +1513,9 @@ export declare class TerminalManager implements TerminalManagerInterface {
  * - `expire` — an endpoint's parked prompt timed out (`to` names the endpoint).
  */
 export declare type TerminalManagerEventMap = {
-    pending: [prompt: PendingPrompt];
-    answer: [to: string, id: string, value: unknown];
-    expire: [to: string, id: string];
+    readonly pending: readonly [prompt: PendingPrompt];
+    readonly answer: readonly [to: string, id: string, value: unknown];
+    readonly expire: readonly [to: string, id: string];
 };
 
 /**
@@ -1573,7 +1575,7 @@ export declare interface TerminalManagerInterface {
 export declare interface TerminalManagerOptions {
     readonly store?: TerminalStoreInterface;
     readonly timeout?: number;
-    readonly timer?: TimerHandler;
+    readonly timer?: TimerHandler_2;
     readonly cap?: number;
     readonly on?: EmitterHooks<TerminalManagerEventMap>;
     readonly error?: EmitterErrorHandler;
@@ -1582,7 +1584,7 @@ export declare interface TerminalManagerOptions {
 /** Options for {@link import('./factories.js').createTerminal} / a manager-owned {@link PromptInterface} broker — the per-endpoint `timeout` + injected `timer` + optional `cap` on concurrently-parked prompts. */
 export declare interface TerminalOptions {
     readonly timeout?: number;
-    readonly timer?: TimerHandler;
+    readonly timer?: TimerHandler_2;
     readonly cap?: number;
 }
 
@@ -1592,7 +1594,7 @@ export declare interface TerminalSnapshot {
     readonly timeout?: number;
 }
 
-/** One opaque persisted row — the shape a `TableInterface<TerminalSnapshotRow>`-backed store reads/writes; `snapshot` is narrowed with {@link import('./helpers.js').isTerminalSnapshot} on read. */
+/** One opaque persisted row — the shape a `TableInterface<TerminalSnapshotRow>`-backed store reads/writes; `snapshot` is narrowed with {@link import('./validators.js').isTerminalSnapshot} on read. */
 export declare interface TerminalSnapshotRow {
     readonly id: string;
     readonly snapshot: unknown;
@@ -1623,7 +1625,8 @@ export declare type TimerCancel = () => void;
  * `setTimeout` / `clearTimeout`; a test injects a deterministic timer that captures the callback
  * and fires it on demand (no real time, no global fake-timer patching).
  */
-export declare type TimerHandler = (callback: () => void, ms: number) => TimerCancel;
+declare type TimerHandler_2 = (callback: () => void, ms: number) => TimerCancel;
+export { TimerHandler_2 as TimerHandler }
 
 /** Toggle `index` in a readonly index list — copy-on-write, returning the new sorted-by-insertion list. */
 export declare function toggleIndex(indices: readonly number[], index: number): readonly number[];