@kodax-ai/kodax 0.7.71 → 0.7.72

package/dist/types-chunks/{run-manager.d-DxU3SSGR.d.ts → run-manager.d-Bh50OdVl.d.ts}

@@ -1,4 +1,4 @@
-import { dF as WorkflowProcessTrackerOptions, df as WorkflowEvent, dz as WorkflowProcessSnapshot, dt as WorkflowProcessEvent } from './types.d-CRCaLt_s.js';
+import { ef as WorkflowProcessTrackerOptions, dN as WorkflowEvent, e9 as WorkflowProcessSnapshot, e3 as WorkflowProcessEvent } from './types.d-DH1mvdcl.js';
 
 /**
  * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.

package/dist/types-chunks/sdk-session-Cfw6NFu-.d.ts

@@ -0,0 +1,82 @@
+import { g as CreatableHistoryItem, a8 as ToolCall } from './public-api.d--IDNJsu1.js';
+import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-Cqaw71Ax.js';
+import { bW as KodaXSessionUiHistoryItem, b_ as KodaXSessionUiToolCall } from './types.d-DH1mvdcl.js';
+
+interface RestoreHistoryItemsFromSessionInput {
+    messages: readonly KodaXMessage[];
+    uiHistory?: readonly KodaXSessionUiHistoryItem[];
+}
+declare function trimPersistedUiHistorySnapshot(items: readonly KodaXSessionUiHistoryItem[]): KodaXSessionUiHistoryItem[];
+declare function restoreHistoryItemsFromSession(input: RestoreHistoryItemsFromSessionInput): CreatableHistoryItem[];
+
+/**
+ * Utilities for extracting message content for history rendering, copy, and previews.
+ */
+
+type RestoredHistorySeed = ({
+    type: "user";
+    text: string;
+} | {
+    type: "assistant";
+    text: string;
+} | {
+    type: "system";
+    text: string;
+} | {
+    type: "thinking";
+    text: string;
+} | {
+    type: "sidecar";
+    text: string;
+    verdict?: "revise" | "blocked";
+} | {
+    type: "task_completed";
+    text: string;
+} | {
+    type: "tool_summary";
+    text: string;
+} | {
+    type: "tool_group";
+    tools: KodaXSessionUiToolCall[];
+}) & {
+    timestamp?: number;
+};
+/** Convert a RestoredHistorySeed to a CreatableHistoryItem. tool_summary / task_completed → event with icon. */
+declare function seedToHistoryItem(seed: RestoredHistorySeed): CreatableHistoryItem;
+declare function toolCallSeedToHistoryToolCall(tool: KodaXSessionUiToolCall): ToolCall;
+/**
+ * Minimal message shape required to restore UI history items.
+ */
+interface HistorySeedSourceMessage {
+    role: KodaXMessage["role"];
+    content: string | KodaXContentBlock[];
+    timestamp?: string;
+    _synthetic?: boolean;
+    /**
+     * Provenance marker persisted on host-injected messages. `'sidecar-verifier'`
+     * tags the synthetic user message the Sidecar Verifier injects on a `revise`
+     * verdict; `'agent-completed'` tags a synthetic actor-result notification.
+     * Legacy `'task-completed'` values are still accepted while restoring older
+     * sessions. Both render under their own identity instead of being swallowed
+     * by the generic `_synthetic` skip.
+     */
+    _source?: string;
+}
+declare function extractHistorySeedsFromMessage(message: HistorySeedSourceMessage): RestoredHistorySeed[];
+declare function extractHistorySeedsFromMessages(messages: readonly HistorySeedSourceMessage[]): RestoredHistorySeed[];
+/**
+ * Extract plain text from message content.
+ * Thinking/tool blocks are omitted so callers get only visible assistant text.
+ */
+declare function extractTextContent(content: string | readonly unknown[]): string;
+/**
+ * Extract a session title from the first user message.
+ */
+declare function extractTitle(messages: KodaXMessage[]): string;
+/**
+ * Format a single-line preview for session lists.
+ */
+declare function formatMessagePreview(content: string, maxLength?: number): string;
+
+export { extractHistorySeedsFromMessages as b, extractTextContent as c, extractTitle as d, extractHistorySeedsFromMessage as e, formatMessagePreview as f, trimPersistedUiHistorySnapshot as g, restoreHistoryItemsFromSession as r, seedToHistoryItem as s, toolCallSeedToHistoryToolCall as t };
+export type { HistorySeedSourceMessage as H, RestoreHistoryItemsFromSessionInput as R, RestoredHistorySeed as a };

package/dist/types-chunks/{types.d-CEZZSY9s.d.ts → types.d-CNZgY52F.d.ts}

@@ -1,4 +1,4 @@
-import { aX as KodaXInputArtifact } from './types.d-CRCaLt_s.js';
+import { bv as KodaXInputArtifact } from './types.d-DH1mvdcl.js';
 import { S as KodaXTaskResultMetadata } from './types.d-Cqaw71Ax.js';
 
 /**
@@ -97,7 +97,7 @@ interface DequeueFilter {
  *   - `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.
+ *     idle consumers can probe without spamming subscribers.
  *   - `cleared` fires ONCE per `clear()` call that removed ≥1 message,
  *     carrying the pre-clear messages. Empty-queue clear fires nothing.
  *

package/dist/types-chunks/{types.d-vJExiRje.d.ts → types.d-DCQVBqVn.d.ts}

@@ -55,7 +55,7 @@ interface SkillMetadata {
     userInvocable: boolean;
     argumentHint?: string;
     path: string;
-    source: SkillSource;
+    source: ResolvedSkillSource;
     /** If true, exclude from system prompt; still invokable by explicit slash forms. */
     disableModelInvocation: boolean;
 }
@@ -79,7 +79,7 @@ interface Skill extends SkillFrontmatter {
     resources?: SkillFile[];
     /** Runtime state */
     loaded: boolean;
-    source: SkillSource;
+    source: ResolvedSkillSource;
 }
 /**
  * File within a skill directory
@@ -91,6 +91,8 @@ interface SkillFile {
     content?: string;
 }
 type SkillSource = 'project' | 'user' | 'plugin' | 'builtin';
+/** Runtime discovery output; learned Skills remain lower precedence than formal sources. */
+type ResolvedSkillSource = SkillSource | 'learned';
 /**
  * Skill registry interface for managing discovered skills
  */
@@ -202,6 +204,7 @@ interface SkillPathsConfig {
     userPaths: string[];
     pluginPaths: string[];
     builtinPath: string;
+    learnedPath?: string;
 }
 /**
  * Get default skill discovery paths
@@ -212,21 +215,23 @@ interface SkillPathsConfig {
  * 3. User - ~/.agents/skills/ (AgentSkills standard)
  * 4. Plugin - (dynamic)
  * 5. Builtin - packages/skills/src/builtin/
+ * 6. Learned - ~/.kodax/learned/skills/ (never shadows a formal source)
  */
 declare function getDefaultSkillPaths(projectRoot?: string): SkillPathsConfig;
 /**
  * All skill paths in priority order (highest to lowest)
  *
- * Priority: Project > User > Plugin > Builtin
+ * Priority: Project > User > Plugin > Builtin > Learned
  * - Project: Project-specific skills override everything else
  * - User: User preferences (~/.kodax/ and ~/.agents/)
  * - Plugin: Third-party plugins
  * - Builtin: Default skills shipped with KodaX
+ * - Learned: Runtime-governed Skills, always lower precedence than formal sources
  */
 declare function getSkillPathsFlat(config: SkillPathsConfig): Array<{
     path: string;
-    source: SkillSource;
+    source: ResolvedSkillSource;
 }>;
 
 export { getDefaultSkillPaths as m, getSkillPathsFlat as n };
-export type { ISkillRegistry as I, Skill as S, IVariableResolver as a, SkillArtifact as b, SkillContext as c, SkillDynamicContextExecutor as d, SkillFile as e, SkillFrontmatter as f, SkillHook as g, SkillHooks as h, SkillMetadata as i, SkillPathsConfig as j, SkillResult as k, SkillSource as l };
+export type { ISkillRegistry as I, ResolvedSkillSource as R, Skill as S, IVariableResolver as a, SkillArtifact as b, SkillContext as c, SkillDynamicContextExecutor as d, SkillFile as e, SkillFrontmatter as f, SkillHook as g, SkillHooks as h, SkillMetadata as i, SkillPathsConfig as j, SkillResult as k, SkillSource as l };