@kodax-ai/kodax 0.7.47 → 0.7.49

package/dist/types-chunks/{file-tracker.d-BNTIvsdb.d.ts → capsule.d-DaPuhyyK.d.ts}

@@ -1,6 +1,6 @@
-import { n as KodaXMessage } from './types.d-Cf-GCzac.js';
-import { f as AgentMessage, ag as SessionEntry, ae as Session, ah as SessionExtension, m as CompactionDetails, u as FileOperations } from './types.d-D2RNa5Y7.js';
-import { s as KodaXSessionLineage, i as KodaXJsonValue, a as KodaXCompactMemorySeed, o as KodaXSessionEntry, z as KodaXSessionTreeNode, r as KodaXSessionLabelEntry, q as KodaXSessionGoalEntry, v as KodaXSessionNavigationOptions, k as KodaXSessionArtifactLedgerEntry } from './types.d-B_MIIApc.js';
+import { n as KodaXMessage } from './types.d-rPRl2LSB.js';
+import { f as AgentMessage, ap as SessionEntry, an as Session, a3 as QueueEventListener, a4 as QueuedMessage, E as EnqueueInput, v as DequeueFilter, aq as SessionExtension, p as CompactionDetails, z as FileOperations, b4 as WorkflowMeta, b5 as WorkflowModelHint, b6 as WorkflowModule } from './types.d-BR9oNWup.js';
+import { s as KodaXSessionLineage, i as KodaXJsonValue, a as KodaXCompactMemorySeed, o as KodaXSessionEntry, z as KodaXSessionTreeNode, r as KodaXSessionLabelEntry, q as KodaXSessionGoalEntry, v as KodaXSessionNavigationOptions, k as KodaXSessionArtifactLedgerEntry } from './types.d-BnjX2Gn4.js';
 
 /**
  * @kodax-ai/agent Constants
@@ -271,6 +271,98 @@ declare function getAgentConfigPath(...segments: string[]): string;
  */
 declare function getAppDataDir(appId: string): string;
 
+/**
+ * @kodax-ai/agent/messaging/queue — 2-tier agentId-scoped FIFO message queue.
+ *
+ * FEATURE_115 (v0.7.36).
+ *
+ * Invariants:
+ *   - In-priority FIFO: messages of the same priority drain in enqueue order.
+ *   - Cross-priority precedence: 'user' drains before 'background', regardless
+ *     of enqueue order.
+ *   - agentId routing: messages addressed to agentId X are only visible to
+ *     consumers filtering for that exact agentId. undefined ≠ "any agent" —
+ *     it specifically matches main-thread messages.
+ *   - Not persistent: process restart loses queue state, by design (matches
+ *     TodoStore semantics).
+ *
+ * The queue is process-global by default (`getMessageQueue()`); the class is
+ * also exported for tests / isolated downstream use.
+ */
+
+declare class MessageQueue {
+    private messages;
+    private nextSeq;
+    /**
+     * FEATURE_159 (v0.7.40) — observable subscription set. Same pattern as
+     * Claude Code's `messageQueueManager.ts` `createSignal()` substrate,
+     * but the listener carries a structured `QueueEvent` so SDK
+     * observability consumers (logger, tracer, metrics) can react per-
+     * event without re-diffing snapshots. `useSyncExternalStore` consumers
+     * still work — they ignore the event argument.
+     *
+     * Cached `snapshotRef` keeps reference identity stable across reads
+     * when nothing changed — required by React 18's `useSyncExternalStore`
+     * to avoid render loops.
+     */
+    private listeners;
+    private snapshotRef;
+    private notify;
+    /**
+     * Subscribe to queue mutations. Compatible with React 18's
+     * `useSyncExternalStore(subscribe, getSnapshot)` — the hook passes a
+     * `() => void` callback, which is structurally assignable to the
+     * `QueueEventListener` parameter because TypeScript treats
+     * callback parameter discards as compatible. SDK consumers that
+     * declare a typed `(event: QueueEvent) => void` listener see the
+     * structured event.
+     *
+     * Listener is called synchronously after every mutation; returns an
+     * unsubscribe function.
+     */
+    subscribe: (listener: QueueEventListener) => (() => void);
+    /**
+     * Returns the current frozen queue snapshot. Reference identity is
+     * stable across reads when the queue has not mutated, which is the
+     * contract React's `useSyncExternalStore` relies on.
+     */
+    getSnapshot: () => readonly QueuedMessage[];
+    /** Returns the assigned id of the enqueued message. */
+    enqueue(input: EnqueueInput): string;
+    /**
+     * Drain matching messages, ordered by priority (user > background) then
+     * FIFO within each priority. Removes drained messages from the queue.
+     */
+    dequeue(filter: DequeueFilter): QueuedMessage[];
+    /**
+     * Peek at matching messages without removing them. Returns messages in
+     * the same priority + FIFO order that `dequeue(filter)` would return,
+     * so callers can inspect what the next drain would yield.
+     */
+    peek(filter: DequeueFilter): QueuedMessage[];
+    /** Total queue size across all priorities / agents. */
+    size(): number;
+    /** Count of messages matching the filter. */
+    count(filter: DequeueFilter): number;
+    /** True iff at least one message matches the filter. */
+    has(filter: DequeueFilter): boolean;
+    /** Remove all queued messages — used in tests / process abort scenarios. */
+    clear(): void;
+}
+/**
+ * Returns the process-global MessageQueue singleton, creating it lazily on
+ * first call. Use this for production wiring; instantiate `MessageQueue`
+ * directly in tests / isolated subsystems where a shared instance would
+ * cause cross-test pollution.
+ */
+declare function getMessageQueue(): MessageQueue;
+/**
+ * Test-only reset hook. Production code MUST NOT call this. Underscored
+ * prefix follows the same convention as `_resetInvariantRegistry` /
+ * `_resetAdmittedAgentBindings` / `_resetAdmissionMetrics`.
+ */
+declare function _resetMessageQueueForTests(): void;
+
 /**
  * History cleanup middleware — CAP-002
  *
@@ -636,5 +728,78 @@ declare function mergeFileOps(ops1: FileOperations, ops2: FileOperations): FileO
 declare function extractArtifactLedger(messages: KodaXMessage[]): KodaXSessionArtifactLedgerEntry[];
 declare function mergeArtifactLedger(existing: KodaXSessionArtifactLedgerEntry[], next: KodaXSessionArtifactLedgerEntry[]): KodaXSessionArtifactLedgerEntry[];
 
-export { countActiveLineageMessages as A, countTokens as B, DefaultSummaryCompaction as D, createSessionLineage as E, estimateTokens as F, extractArtifactLedger as G, extractFileOps as H, extractTitleFromMessages as I, findPreviousUserEntryId as J, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, forkSessionLineage as M, generateSessionId as N, getAgentConfigHome as O, PROMISE_PATTERN as P, getAgentConfigPath as Q, getAppDataDir as R, getSessionLineagePath as S, getSessionMessagesFromLineage as T, mergeArtifactLedger as U, mergeFileOps as V, resolveSessionLineageTarget as W, rewindSessionLineage as X, setAgentConfigHome as Y, setSessionLineageActiveEntry as Z, validateAndFixToolHistory as _, KODAX_DEFAULT_TIMEOUT as e, KODAX_HARD_TIMEOUT as f, KODAX_MAX_INCOMPLETE_RETRIES as g, KODAX_MAX_MAXTOKENS_RETRIES as h, KODAX_MAX_RETRIES as i, KODAX_MAX_TOKENS as j, KODAX_RETRY_BASE_DELAY as k, KODAX_STAGGER_DELAY as l, LineageCompaction as n, LineageExtension as q, appendSessionLineageLabel as u, applyLineageTruncation as v, applySessionCompaction as w, archiveOldIslands as x, buildSessionTree as y, cleanupIncompleteToolCalls as z };
-export type { CompactionContext as C, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, DefaultSummaryCompactionOptions as d, LineageArtifactLedgerPayload as m, LineageCompactionDelegates as o, LineageEntryType as p, LineageLabelPayload as r, LineageTreeNode as s, PolicyCompactionResult as t };
+declare const WORKFLOW_PATTERN_IDS: readonly ["classify-and-act", "fan-out-and-synthesize", "adversarial-verification", "generate-and-filter", "tournament", "loop-until-done"];
+type WorkflowPatternId = (typeof WORKFLOW_PATTERN_IDS)[number];
+interface WorkflowScriptManifest extends WorkflowMeta {
+    readonly phases: readonly string[];
+    readonly readOnly: boolean;
+    readonly plannedAgents?: number;
+    readonly maxAgents: number;
+    readonly maxConcurrency: number;
+    readonly tokenBudget?: number;
+    readonly mayUseWorktree?: boolean;
+    readonly patterns: readonly WorkflowPatternId[];
+}
+declare function validateWorkflowScriptManifest(value: unknown): WorkflowScriptManifest;
+
+/**
+ * FEATURE_217 (v0.7.49) Phase M — reusable generated workflow capsule.
+ *
+ * Agent owns only the domain-neutral capsule contract. Persistence,
+ * environment preflight, skills, MCP, and REPL UX live in higher layers.
+ */
+
+declare const WORKFLOW_CAPSULE_FORMAT: "kodax.workflow";
+declare const WORKFLOW_CAPSULE_VERSION: 1;
+declare const WORKFLOW_CAPSULE_API_VERSION: 1;
+type WorkflowCapsuleEnvironmentRequirement = 'git-repo' | 'worktree-capable';
+interface WorkflowCapsuleIntent {
+    readonly taskClass: string;
+    readonly originalRequest?: string;
+    readonly reusableFor?: readonly string[];
+    readonly notFor?: readonly string[];
+}
+interface WorkflowCapsuleInputs {
+    readonly description: string;
+    readonly examples?: readonly unknown[];
+}
+interface WorkflowCapsuleRequirements {
+    readonly environment?: readonly WorkflowCapsuleEnvironmentRequirement[];
+    readonly tools?: readonly string[];
+    readonly mcp?: readonly string[];
+    readonly skills?: readonly string[];
+    readonly modelTiers?: readonly WorkflowModelHint[];
+    readonly userInteraction?: boolean;
+}
+interface WorkflowCapsuleProvenance {
+    readonly fromRunId?: string;
+    readonly createdAt: string;
+    readonly kodaxVersion: string;
+}
+interface WorkflowCapsule {
+    readonly format: typeof WORKFLOW_CAPSULE_FORMAT;
+    readonly version: typeof WORKFLOW_CAPSULE_VERSION;
+    readonly workflowApiVersion: typeof WORKFLOW_CAPSULE_API_VERSION;
+    readonly minKodaxVersion: string;
+    readonly manifest: WorkflowScriptManifest;
+    readonly source: string;
+    readonly intent?: WorkflowCapsuleIntent;
+    readonly inputs?: WorkflowCapsuleInputs;
+    readonly requires?: WorkflowCapsuleRequirements;
+    readonly provenance?: WorkflowCapsuleProvenance;
+}
+interface CreateWorkflowCapsuleInput {
+    readonly minKodaxVersion: string;
+    readonly manifest: WorkflowScriptManifest;
+    readonly source: string;
+    readonly intent?: WorkflowCapsuleIntent;
+    readonly inputs?: WorkflowCapsuleInputs;
+    readonly requires?: WorkflowCapsuleRequirements;
+    readonly provenance?: WorkflowCapsuleProvenance;
+}
+declare function validateWorkflowCapsule(value: unknown): WorkflowCapsule;
+declare function createWorkflowCapsule(input: CreateWorkflowCapsuleInput): WorkflowCapsule;
+declare function createWorkflowModuleFromCapsule(capsule: WorkflowCapsule): WorkflowModule;
+
+export { extractFileOps as $, DefaultSummaryCompaction as D, appendSessionLineageLabel as I, applyLineageTruncation as J, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, MessageQueue as M, applySessionCompaction as N, archiveOldIslands as O, PROMISE_PATTERN as P, buildSessionTree as Q, cleanupIncompleteToolCalls as R, countActiveLineageMessages as S, countTokens as T, createSessionLineage as U, createWorkflowCapsule as V, WORKFLOW_CAPSULE_API_VERSION as W, createWorkflowModuleFromCapsule as X, estimateTokens as Y, extractArtifactLedger as Z, _resetMessageQueueForTests as _, extractTitleFromMessages as a0, findPreviousUserEntryId as a1, forkSessionLineage as a2, generateSessionId as a3, getAgentConfigHome as a4, getAgentConfigPath as a5, getAppDataDir as a6, getMessageQueue as a7, getSessionLineagePath as a8, getSessionMessagesFromLineage as a9, mergeArtifactLedger as aa, mergeFileOps as ab, resolveSessionLineageTarget as ac, rewindSessionLineage as ad, setAgentConfigHome as ae, setSessionLineageActiveEntry as af, validateAndFixToolHistory as ag, validateWorkflowCapsule as ah, validateWorkflowScriptManifest as ai, KODAX_DEFAULT_TIMEOUT as f, KODAX_HARD_TIMEOUT as g, KODAX_MAX_INCOMPLETE_RETRIES as h, KODAX_MAX_MAXTOKENS_RETRIES as i, KODAX_MAX_RETRIES as j, KODAX_MAX_TOKENS as k, KODAX_RETRY_BASE_DELAY as l, KODAX_STAGGER_DELAY as m, LineageCompaction as o, LineageExtension as r, WORKFLOW_CAPSULE_FORMAT as v, WORKFLOW_CAPSULE_VERSION as w, WORKFLOW_PATTERN_IDS as x };
+export type { WorkflowCapsuleInputs as A, WorkflowCapsuleIntent as B, CompactionContext as C, WorkflowCapsuleProvenance as E, WorkflowCapsuleRequirements as F, WorkflowPatternId as G, WorkflowScriptManifest as H, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, CreateWorkflowCapsuleInput as d, DefaultSummaryCompactionOptions as e, LineageArtifactLedgerPayload as n, LineageCompactionDelegates as p, LineageEntryType as q, LineageLabelPayload as s, LineageTreeNode as t, PolicyCompactionResult as u, WorkflowCapsule as y, WorkflowCapsuleEnvironmentRequirement as z };

package/dist/types-chunks/{config.d-BfJUXxC0.d.ts → config.d-CJy1WENT.d.ts}

@@ -5,7 +5,12 @@
  * `Mcp*` names here; the `KodaXMcp*` aliases continue to re-export from
  * `@kodax-ai/coding` for backward compatibility.
  */
-type McpTransportKind = 'stdio' | 'sse' | 'streamable-http';
+/**
+ * Transport config kind. `http` is a compatibility alias used by other MCP
+ * clients' config files; KodaX auto-detects Streamable HTTP first, then falls
+ * back to the legacy HTTP+SSE transport. It is not a distinct wire protocol.
+ */
+type McpTransportKind = 'stdio' | 'sse' | 'streamable-http' | 'http';
 type McpConnectMode = 'lazy' | 'prewarm' | 'disabled';
 interface McpServerConfig {
     /** Transport type. Defaults to 'stdio' when omitted. */
@@ -18,19 +23,24 @@ interface McpServerConfig {
     cwd?: string;
     /** stdio: extra environment variables for the spawned process. */
     env?: Record<string, string>;
-    /** sse / streamable-http: server endpoint URL. */
+    /** sse / streamable-http / http(auto): server endpoint URL. */
     url?: string;
-    /** sse / streamable-http: extra HTTP headers (e.g. Authorization). */
+    /** sse / streamable-http / http(auto): extra HTTP headers (e.g. Authorization). */
     headers?: Record<string, string>;
     connect?: McpConnectMode;
     startupTimeoutMs?: number;
     requestTimeoutMs?: number;
-    /** OAuth 2.0 configuration for authenticated MCP servers. */
+    /**
+     * OAuth 2.0 for authenticated MCP servers. All endpoint fields are optional:
+     * when omitted, KodaX discovers them at runtime (RFC 9728 → RFC 8414) and
+     * dynamically registers a client (RFC 7591). Provide them only to pin a
+     * pre-registered client / static endpoints.
+     */
     auth?: {
         readonly type: 'oauth2';
-        readonly clientId: string;
-        readonly authorizationUrl: string;
-        readonly tokenUrl: string;
+        readonly clientId?: string;
+        readonly authorizationUrl?: string;
+        readonly tokenUrl?: string;
         readonly scopes?: readonly string[];
         readonly redirectPort?: number;
     };