@kodax-ai/kodax 0.7.63 → 0.7.66

package/dist/types-chunks/{sdk-session-RBSBBKol.d.ts → sdk-session-CLqyfAmf.d.ts}

@@ -1,7 +1,7 @@
-import { b as PermissionMode, F as FileSessionStorage, S as SessionData } from './storage.d-C6kkAEch.js';
-import { E as KodaXReasoningMode, j as KodaXMessage, c as KodaXContentBlock, R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
-import { m as KodaXAgentMode } from './bash-prefix-extractor.d-CZW9fRoa.js';
-import { ao as KodaXSessionUiHistoryItem, as as KodaXSessionUiToolCall, a4 as KodaXJsonValue } from './process.d-CY2g03Mb.js';
+import { f as PermissionMode } from './public-api.d-jtREVfEq.js';
+import { E as KodaXReasoningMode, j as KodaXMessage, c as KodaXContentBlock } from './types.d-Bp4Lm1jv.js';
+import { r as KodaXAgentMode } from './bash-prefix-extractor.d-BjkITAva.js';
+import { ao as KodaXSessionUiHistoryItem, as as KodaXSessionUiToolCall } from './process.d-CY2g03Mb.js';
 
 /**
  * TextBuffer - Text buffer management class - 文本缓冲区管理类
@@ -380,6 +380,8 @@ interface InputPromptProps {
     initialValue?: string;
     /** Callback when input text changes - 输入文本变化时的回调 */
     onInputChange?: (text: string) => void;
+    /** Called for a transient UI notice when image paste falls back to text. */
+    onPasteFallback?: (message: string) => void;
     /**
      * Called when the ↑ arrow history recall brings back an entry with stored
      * paste contents. Consumer can hydrate a disk-backed paste cache here.
@@ -788,305 +790,5 @@ declare function extractTitle(messages: KodaXMessage[]): string;
  */
 declare function formatMessagePreview(content: string, maxLength?: number): string;
 
-/**
- * FEATURE_247 (R6) — imperative session compaction.
- *
- * Lets an SDK embedder (KodaX-Space) compact a session by id immediately —
- * e.g. when the user clicks a "/compact" button — instead of forging a token
- * snapshot or appending an empty message to trip auto-compaction. Loads the
- * session, runs the same `compact()` pass the REPL `/compact` command uses,
- * applies the result to the session lineage (so `loadFullTranscript` / resume
- * see the compaction entry), and writes it back.
- *
- * Applies uniformly to Partner and Coder sessions. Never throws — failures
- * return `{ compacted: false, reason }`.
- */
-
-interface CompactSessionOptions {
-    /** Provider alias for the summarizer. Defaults to the session's persisted provider, then 'anthropic'. */
-    readonly provider?: string;
-    /** Model override forwarded to the summarizer. */
-    readonly model?: string;
-    /** Custom summarizer instructions (same as `/compact <text>`). */
-    readonly customInstructions?: string;
-    /** Provider context-window override (tokens). Otherwise resolved from the provider/model. */
-    readonly contextWindow?: number;
-    /** Sessions directory (mirrors createSessionManager's override). */
-    readonly sessionsDir?: string;
-    /** Injected storage instance (takes precedence over sessionsDir). */
-    readonly storage?: FileSessionStorage;
-}
-interface CompactSessionResult {
-    /** True when the session was actually rewritten. */
-    readonly compacted: boolean;
-    readonly tokensBefore: number;
-    readonly tokensAfter: number;
-    /** The rewritten (or unchanged) message list. */
-    readonly messages: KodaXMessage[];
-    /** Populated when `compacted` is false to explain why (not-found / no-op / error). */
-    readonly reason?: string;
-}
-/**
- * Compact a session by id, writing the result (lineage + messages) back to
- * storage. Never throws.
- */
-declare function compactSession(sessionId: string, options?: CompactSessionOptions): Promise<CompactSessionResult>;
-
-/**
- * FEATURE_173 Part B (v0.7.42) — Session Management Public SDK.
- *
- * Thin facades over FileSessionStorage + discoverInstances. All methods
- * NEVER throw — missing sessions return null, blocked operations return
- * an error envelope, missing directories return empty arrays / no-op
- * watchers.
- *
- * The `@kodax-ai/kodax/session` SDK subpath re-exports this module.
- */
-
-interface SessionSummary {
-    readonly id: string;
-    readonly title: string;
-    readonly msgCount: number;
-    readonly tag?: string;
-    readonly createdAt?: string;
-    readonly runtimeInfo?: {
-        workspaceRoot?: string;
-        gitRoot?: string;
-        surface?: string;
-        profileId?: string;
-    };
-    /**
-     * FEATURE_219 (v0.7.46) — the per-project directory key this session lives
-     * under (ADR-038 §7). A backward-compatible hint: consumers may pass it back
-     * for precise disambiguation, but `loadSession(id)` works without it.
-     */
-    readonly projectKey?: string;
-    /** FEATURE_219 — true when the session is whole-session archived (only ever
-     * surfaced when `includeArchived` is set). */
-    readonly archived?: boolean;
-}
-type SessionTranscriptEntryType = 'message' | 'compaction' | 'branch_summary'
-/** Rewind audit marker; not included in `FullTranscriptSessionData.messages`. */
- | 'rewind_marker' | 'client_notice'
-/**
- * Synthetic task/workflow completion entry derived from `_taskResult`,
- * `_taskResults`, or legacy `<task-completed>` banners. The original
- * `KodaXMessage` is still exposed on `message`, but consumers that want a
- * complete transcript should not filter only `type === 'message'`.
- */
- | 'task_result';
-type SessionTranscriptEntrySource = 'user' | 'assistant' | 'workflow' | 'child_task' | 'system' | 'client';
-interface SessionTranscriptEntry {
-    readonly entryId: string;
-    readonly parentId: string | null;
-    /** Stable logical identity shared by cloned/forked copies of the same entry. */
-    readonly logicalId: string;
-    /** Root source physical entry id when this transcript entry was cloned/forked. */
-    readonly sourceEntryId?: string;
-    readonly timestamp: string;
-    readonly type: SessionTranscriptEntryType;
-    readonly source?: SessionTranscriptEntrySource;
-    readonly turnId?: string;
-    readonly message: KodaXMessage;
-    readonly active: boolean;
-    readonly summary?: string;
-    readonly payload?: unknown;
-    readonly taskResults?: readonly KodaXTaskResultMetadata[];
-}
-interface FullTranscriptSessionData extends Omit<SessionData, 'messages'> {
-    readonly messages: KodaXMessage[];
-    readonly activeMessages: KodaXMessage[];
-    readonly transcriptEntries: SessionTranscriptEntry[];
-}
-interface AppendClientNoticeOptions {
-    readonly source?: string;
-    readonly content: string;
-    readonly timestamp?: string;
-    readonly turnId?: string;
-    readonly payload?: KodaXJsonValue;
-}
-interface ListSessionsOptions {
-    /**
-     * Alias for gitRoot; backwards-compat with KodaX Space terminology.
-     * When provided, list() is scoped to sessions from this project root.
-     */
-    readonly projectRoot?: string;
-    /**
-     * Which session scopes to include.
-     * - 'user' (default): only user-initiated sessions.
-     * - 'managed-task-worker': only managed-task worker sessions.
-     * - 'all': no scope filter.
-     */
-    readonly scope?: 'user' | 'managed-task-worker' | 'all';
-    /**
-     * Whether to include whole-session-archived sessions. FEATURE_219 (v0.7.46):
-     * archived sessions live in `<projectKey>/archived/` (see `archiveSession`);
-     * also still hides the legacy `archived-` filename prefix. Default false.
-     */
-    readonly includeArchived?: boolean;
-    /** Maximum number of sessions to return. Default 50. */
-    readonly limit?: number;
-    /**
-     * ISO date string — return only sessions whose createdAt is before this
-     * timestamp. Applied after list + scope filtering.
-     */
-    readonly before?: string;
-    /** Exact match. Omitted means no tag filter. */
-    readonly tag?: string;
-}
-type WatchSessionsCallback = (event: {
-    kind: 'change' | 'add' | 'remove';
-    sessionId: string;
-}) => void;
-interface SessionManager {
-    listSessions: typeof listSessions;
-    loadSession: typeof loadSession;
-    loadFullTranscript: typeof loadFullTranscript;
-    appendClientNotice: typeof appendClientNotice;
-    forkSession: typeof forkSession;
-    rewindSession: typeof rewindSession;
-    setActiveEntry: typeof setActiveEntry;
-    deleteSession: typeof deleteSession;
-    archiveSession: typeof archiveSession;
-    unarchiveSession: typeof unarchiveSession;
-    listRunningSessions: typeof listRunningSessions;
-    watchSessions: typeof watchSessions;
-    /** FEATURE_247 (R6) — imperatively compact a session by id (writes lineage + emits nothing; returns stats). */
-    compactSession: typeof compactSession;
-    /**
-     * v0.7.43 — the raw write-side storage instance. SDK embedders pass
-     * this into `runKodaX({ session: { id, scope, storage } })` so the
-     * SA / AMA loops write per-turn JSONL snapshots to disk. Without an
-     * injected storage, `saveSessionSnapshot` is a silent no-op and the
-     * sessions directory stays empty regardless of `session.id`.
-     *
-     * See {@link FileSessionStorage} for the concrete implementation and
-     * `docs/SDK_EMBEDDER_GUIDE.md` §6 for the end-to-end recipe.
-     */
-    storage: FileSessionStorage;
-}
-/**
- * List sessions, optionally filtered by scope, limit, and date.
- * NEVER throws. Returns [] when the sessions directory is empty or missing.
- */
-declare function listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
-/**
- * Load full session data by ID.
- * Returns null for a missing session. NEVER throws.
- */
-declare function loadSession(id: string): Promise<SessionData | null>;
-/**
- * Load append-order transcript data by ID.
- *
- * `loadSession` remains the active model-context API. This helper is for UI
- * scrollback: it returns every persisted transcript-bearing lineage entry in
- * append order and keeps the active branch in `activeMessages`.
- */
-declare function loadFullTranscript(id: string): Promise<FullTranscriptSessionData | null>;
-/**
- * Append a host-owned transcript notice that never enters model context.
- *
- * Use this for local slash-command output such as `/doctor`, `/mcp status`,
- * or host-side status panes. It is visible through `loadFullTranscript()` but
- * `loadSession()` keeps returning only the active model messages.
- */
-declare function appendClientNotice(id: string, options: AppendClientNoticeOptions): Promise<SessionTranscriptEntry | null>;
-/**
- * Fork a session at an optional selector.
- * Returns null for a missing session. NEVER throws.
- */
-declare function forkSession(id: string, opts?: {
-    selector?: string;
-    sessionId?: string;
-    title?: string;
-}): Promise<{
-    sessionId: string;
-    data: SessionData;
-} | null>;
-/**
- * Rewind a session to a previous user entry.
- * Returns null for a missing session. NEVER throws.
- */
-declare function rewindSession(id: string, opts?: {
-    selector?: string;
-}): Promise<SessionData | null>;
-/**
- * Set the active lineage entry by selector.
- * Returns null for a missing session. NEVER throws.
- */
-declare function setActiveEntry(id: string, selector: string): Promise<SessionData | null>;
-interface RunningSessionInfo {
-    readonly pid: number;
-    readonly startedAt: number;
-    readonly cwd: string;
-    /**
-     * v0.7.43 — populated from `PersistedSessionState.sessionId`, published
-     * by the REPL after `createInteractiveContext`. Remains `undefined` for
-     * a brief window during a peer's bootstrap (before the first sessionId
-     * is generated) and for peers running pre-v0.7.43 binaries; consumers
-     * MUST handle `undefined`.
-     */
-    readonly sessionId: string | undefined;
-}
-/**
- * Returns live KodaX sibling instances (excluding this process).
- * Uses discoverInstances() from @kodax-ai/agent (FEATURE_125 Team Mode).
- * NEVER throws. Returns [] when no instances directory exists.
- */
-declare function listRunningSessions(): Promise<RunningSessionInfo[]>;
-type DeleteSessionResult = {
-    ok: true;
-} | {
-    error: {
-        code: 'session_running';
-        runningProcess: {
-            pid: number;
-            startedAt: number;
-        };
-    };
-};
-/**
- * Delete a session by ID.
- * Returns { ok: true } on success (including when the session doesn't exist).
- * Returns an error envelope when the session is currently running.
- * NEVER throws.
- */
-declare function deleteSession(id: string): Promise<DeleteSessionResult>;
-/**
- * FEATURE_219 (v0.7.46) — whole-session archive. Moves the session (and its
- * island sidecar) into `<projectKey>/archived/`. Returns false for a missing
- * session. NEVER throws. Archived sessions are hidden from the default listing
- * and resurface only with `listSessions({ includeArchived: true })`.
- */
-declare function archiveSession(id: string): Promise<boolean>;
-/** Restore an archived session back into its project directory. NEVER throws. */
-declare function unarchiveSession(id: string): Promise<boolean>;
-/**
- * Watch the sessions directory for changes.
- * Returns { close() } that stops the watcher / poll interval.
- *
- * Platform branches:
- * - POSIX: fs.watch() with 100ms debounce.
- * - Windows: readdir poll every 1000ms, diffed against a snapshot.
- *
- * NEVER throws — if the directory doesn't exist the watcher is a no-op
- * until the directory is created.
- */
-declare function watchSessions(cb: WatchSessionsCallback): {
-    close: () => void;
-};
-/**
- * Factory that returns an object with all session management methods bound.
- *
- * v0.7.43 (FEATURE_173 Part B follow-up) — the `sessionsDir` override is
- * now honored. When provided, all read/write/watch operations go through
- * that directory instead of the module-load-frozen `KODAX_SESSIONS_DIR`.
- * `listRunningSessions` still consults the agent-config-home instances
- * directory (sibling-process awareness is not scoped per sessions dir).
- */
-declare function createSessionManager(opts?: {
-    sessionsDir?: string;
-}): SessionManager;
-
-export { DEFAULT_UI_STATE as D, StreamingState as U, TOOL_STATUS_ICONS as W, TextBuffer as X, ToolCallStatus as a1, appendClientNotice as a8, archiveSession as a9, compactSession as aa, createSessionManager as ab, deleteSession as ac, extractHistorySeedsFromMessage as ad, extractHistorySeedsFromMessages as ae, extractTextContent as af, extractTitle as ag, forkSession as ah, formatMessagePreview as ai, listRunningSessions as aj, listSessions as ak, loadFullTranscript as al, loadSession as am, restoreHistoryItemsFromSession as an, rewindSession as ao, seedToHistoryItem as ap, setActiveEntry as aq, toolCallSeedToHistoryToolCall as ar, trimPersistedUiHistorySnapshot as as, unarchiveSession as at, watchSessions as au, KeypressHandlerPriority as y };
-export type { ThemeSymbols as $, AppProps as A, PromptEditingMode as B, CompactSessionOptions as C, PromptSubmitPayload as E, FullTranscriptSessionData as F, RestoredHistorySeed as G, HistoryEntry as H, InputPromptProps as I, RunningSessionInfo as J, KeyInfo as K, LegacyMessageListProps as L, Message as M, SessionSummary as N, SessionTranscriptEntry as O, PastedContent as P, SessionTranscriptEntryType as Q, RestoreHistoryItemsFromSessionInput as R, SessionManager as S, StatusBarProps as T, Suggestion as V, TextBufferOptions as Y, Theme as Z, ThemeColors as _, AppState as a, ToolCall as a0, UIActions as a2, UIState as a3, UseTextBufferReturn as a4, VisualCursor as a5, VisualLayout as a6, WatchSessionsCallback as a7, AppendClientNoticeOptions as b, CompactSessionResult as c, Completer as d, Completion as e, CreatableHistoryItem as f, CursorPosition as g, DeleteSessionResult as h, HistoryItem as i, HistoryItemAssistant as j, HistoryItemBase as k, HistoryItemError as l, HistoryItemEvent as m, HistoryItemHint as n, HistoryItemInfo as o, HistoryItemSidecar as p, HistoryItemSystem as q, HistoryItemThinking as r, HistoryItemToolGroup as s, HistoryItemType as t, HistoryItemUser as u, HistorySeedSourceMessage as v, KeypressEvent as w, KeypressHandler as x, ListSessionsOptions as z };
+export { extractTitle as $, TextBuffer as B, DEFAULT_UI_STATE as D, ToolCallStatus as O, TOOL_STATUS_ICONS as T, extractHistorySeedsFromMessage as Y, extractHistorySeedsFromMessages as Z, extractTextContent as _, formatMessagePreview as a0, restoreHistoryItemsFromSession as a1, seedToHistoryItem as a2, toolCallSeedToHistoryToolCall as a3, trimPersistedUiHistorySnapshot as a4, KeypressHandlerPriority as u, StreamingState as y };
+export type { AppProps as A, Completer as C, TextBufferOptions as E, Theme as F, ThemeColors as G, HistoryEntry as H, InputPromptProps as I, ThemeSymbols as J, KeyInfo as K, LegacyMessageListProps as L, Message as M, ToolCall as N, PastedContent as P, UIState as Q, RestoreHistoryItemsFromSessionInput as R, StatusBarProps as S, UIActions as U, UseTextBufferReturn as V, VisualCursor as W, VisualLayout as X, AppState as a, Completion as b, CreatableHistoryItem as c, CursorPosition as d, HistoryItem as e, HistoryItemAssistant as f, HistoryItemBase as g, HistoryItemError as h, HistoryItemEvent as i, HistoryItemHint as j, HistoryItemInfo as k, HistoryItemSidecar as l, HistoryItemSystem as m, HistoryItemThinking as n, HistoryItemToolGroup as o, HistoryItemType as p, HistoryItemUser as q, HistorySeedSourceMessage as r, KeypressEvent as s, KeypressHandler as t, PromptEditingMode as v, PromptSubmitPayload as w, RestoredHistorySeed as x, Suggestion as z };

package/dist/types-chunks/types.d-BMLxKV69.d.ts

@@ -0,0 +1,128 @@
+import { a2 as KodaXInputArtifact } from './process.d-CY2g03Mb.js';
+import { R as KodaXTaskResultMetadata } from './types.d-Bp4Lm1jv.js';
+
+/**
+ * @kodax-ai/agent/messaging — Message queue types
+ *
+ * FEATURE_115 (v0.7.36): agentId-scoped 2-tier priority queue infrastructure.
+ *
+ * Per ADR-021: messaging is a generic agent-platform primitive (not coding-
+ * specific). Downstream consumers:
+ *   - @kodax-ai/coding runner-driven mid-turn drain
+ *   - @kodax-ai/repl InkREPL ESC soft-pause + text injection (FEATURE_111 absorbed)
+ *   - subagent task-notification routing (FEATURE_155 idle-yield wakeup)
+ *
+ * Phase 0.6 study (`c:/tmp/claude-code-actual-usage.md`): Claude Code's
+ * `'now'` priority has zero production usage; KodaX simplifies to 2 tiers.
+ */
+
+type MessagePriority = 'user' | 'background';
+type MessageMode = 'prompt' | 'task-notification' | 'system-reminder';
+type QueuedInputArtifact = KodaXInputArtifact;
+interface QueuedMessage {
+    /** Stable id for tracing / dedup. Format: `msg-<sequence>`. */
+    readonly id: string;
+    readonly priority: MessagePriority;
+    /**
+     * Routing key:
+     *   undefined = main thread / coordinator agent
+     *   'agent-id-XYZ' = subagent / specific consumer
+     *
+     * Drain consumers MUST filter by agentId match — undefined matches only
+     * undefined-agentId messages, not "any agent".
+     */
+    readonly agentId?: string;
+    readonly mode: MessageMode;
+    readonly content: string;
+    readonly inputArtifacts?: readonly QueuedInputArtifact[];
+    readonly taskResult?: KodaXTaskResultMetadata;
+    /** Wall-clock timestamp (`Date.now()`) for tracing only — not used for ordering. */
+    readonly enqueuedAt: number;
+}
+interface DequeueFilter {
+    /**
+     * Only return messages with this agentId.
+     * undefined matches messages with no agentId (main-thread messages only).
+     */
+    readonly agentId?: string;
+    /**
+     * Highest priority level included in the drain.
+     *   'user'       → only user priority drained, background stays queued
+     *   'background' → both user + background drained (Sleep-gated case)
+     */
+    readonly maxPriority: MessagePriority;
+    /**
+     * Optional cap on number of messages drained in this call.
+     * Defaults to unlimited (drains all matching).
+     */
+    readonly limit?: number;
+    /**
+     * FEATURE_159 (v0.7.40) — optional mode filter. Lets REPL split the
+     * single queue into mode-typed views (e.g. `mode:'prompt'` for user
+     * input vs `mode:'task-notification'` for child completion banners)
+     * without separate queues. When omitted, all modes match.
+     */
+    readonly mode?: MessageMode;
+    /**
+     * FEATURE_159 (v0.7.40) — optional precise-id filter. Single-message
+     * targeted removal — drives Esc-pop-this-uuid in REPL. When set, all
+     * other filters still apply (agentId / priority / mode mismatches still
+     * skip the message), so callers can't accidentally remove a message
+     * outside their scope.
+     */
+    readonly id?: string;
+    /**
+     * FEATURE_159 (v0.7.40) — optional escape-hatch predicate, AND-ed with
+     * the structured filters. Lets SDK consumers express conditions the
+     * typed fields don't cover (e.g. timestamp ranges, content-match) without
+     * forcing every new use case to extend `DequeueFilter`. KodaX-internal
+     * code should prefer the typed fields for readability; this is the
+     * "data-driven main path + predicate escape" pattern.
+     *
+     * Evaluated AFTER the typed filters succeed — so a `predicate` that
+     * inspects `message.content` never runs on messages outside the
+     * caller's `agentId` / `mode` / `id` scope.
+     */
+    readonly predicate?: (message: QueuedMessage) => boolean;
+}
+/**
+ * FEATURE_159 (v0.7.40) — structured queue event emitted to subscribers.
+ *
+ * Replaces the prior `() => void` bare-notify signal. Carries the kind +
+ * affected messages so SDK observability consumers (logging, tracing,
+ * metrics) can react per-event without re-diffing snapshots.
+ *
+ * Event granularity rules:
+ *   - `enqueued` fires ONCE per `enqueue()` call (always 1 message).
+ *   - `dequeued` fires ONCE per `dequeue()` call that removed ≥1 message,
+ *     carrying ALL drained messages in priority+FIFO order. No-op drains
+ *     (filter matched nothing) fire no event — quiet by design so the
+ *     `waitForWakeEvent` 100ms poll doesn't spam idle subscribers.
+ *   - `cleared` fires ONCE per `clear()` call that removed ≥1 message,
+ *     carrying the pre-clear messages. Empty-queue clear fires nothing.
+ *
+ * The `useSyncExternalStore` React hook ignores the event payload (it
+ * only needs the change signal); SDK / tracer consumers read the event.
+ */
+type QueueEvent = {
+    readonly kind: 'enqueued';
+    readonly message: QueuedMessage;
+} | {
+    readonly kind: 'dequeued';
+    readonly messages: readonly QueuedMessage[];
+} | {
+    readonly kind: 'cleared';
+    readonly messages: readonly QueuedMessage[];
+};
+/** FEATURE_159 — `MessageQueue.subscribe` listener signature. */
+type QueueEventListener = (event: QueueEvent) => void;
+interface EnqueueInput {
+    readonly priority: MessagePriority;
+    readonly mode: MessageMode;
+    readonly content: string;
+    readonly agentId?: string;
+    readonly inputArtifacts?: readonly QueuedInputArtifact[];
+    readonly taskResult?: KodaXTaskResultMetadata;
+}
+
+export type { DequeueFilter as D, EnqueueInput as E, MessageMode as M, QueueEventListener as Q, MessagePriority as a, QueuedInputArtifact as b, QueuedMessage as c };