@kodax-ai/kodax 0.7.76 → 0.7.78

package/dist/types-chunks/{types.d-DEctY20M.d.ts → types.d-BH0ZkTGf.d.ts}

@@ -1,5 +1,5 @@
-import { bw as KodaXInputArtifact } from './types.d-sRLugmjy.js';
-import { S as KodaXTaskResultMetadata } from './types.d-CSmF0t0n.js';
+import { bD as KodaXInputArtifact } from './types.d-BA-Jwpfs.js';
+import { S as KodaXTaskResultMetadata } from './types.d-DIpZJKUl.js';
 
 /**
  * @kodax-ai/agent/messaging — Message queue types

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

@@ -56,6 +56,11 @@ interface SkillMetadata {
     argumentHint?: string;
     path: string;
     source: ResolvedSkillSource;
+    readonly learned?: {
+        readonly capabilityId: string;
+        readonly revision: number;
+        readonly fingerprint: string;
+    };
     /** If true, exclude from system prompt; still invokable by explicit slash forms. */
     disableModelInvocation: boolean;
 }
@@ -204,7 +209,22 @@ interface SkillPathsConfig {
     userPaths: string[];
     pluginPaths: string[];
     builtinPath: string;
+    /**
+     * Deprecated loose-file path. It remains in the public shape for source
+     * compatibility but is intentionally not discovered without a manifest.
+     */
     learnedPath?: string;
+    learnedArea?: LearnedSkillDiscoveryConfig;
+}
+interface LearnedSkillDiscoveryConfig {
+    readonly rootDir: string;
+    readonly expectedScope: {
+        readonly configHomeHash: string;
+        readonly tenantHash: string;
+        readonly projectHash: string;
+    };
+    readonly testingBindings?: Readonly<Record<string, string>>;
+    readonly now?: string;
 }
 /**
  * Get default skill discovery paths
@@ -215,13 +235,15 @@ 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)
+ * Learned Skills are supplied separately through a record-gated Learned Area
+ * and never through a loose directory.
  */
 declare function getDefaultSkillPaths(projectRoot?: string): SkillPathsConfig;
 /**
  * All skill paths in priority order (highest to lowest)
  *
- * Priority: Project > User > Plugin > Builtin > Learned
+ * Priority: Project > User > Plugin > Builtin. Record-gated Learned Skills
+ * are appended by discovery after these formal sources.
  * - Project: Project-specific skills override everything else
  * - User: User preferences (~/.kodax/ and ~/.agents/)
  * - Plugin: Third-party plugins
@@ -234,4 +256,4 @@ declare function getSkillPathsFlat(config: SkillPathsConfig): Array<{
 }>;
 
 export { getDefaultSkillPaths as m, getSkillPathsFlat as n };
-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 };
+export type { ISkillRegistry as I, LearnedSkillDiscoveryConfig as L, 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 };

package/dist/types-chunks/{types.d-CSmF0t0n.d.ts → types.d-DIpZJKUl.d.ts}

@@ -473,6 +473,14 @@ interface KodaXCustomProviderConfig {
     contextWindow?: number;
     maxOutputTokens?: number;
     thinkingBudgetCap?: number;
+    /**
+     * Opt in only when this exact endpoint is known to accept the protocol's
+     * cache-affinity field. Anthropic-compatible providers lower it to
+     * `metadata.user_id`; OpenAI-compatible providers lower it to
+     * `prompt_cache_key`. Disabled by default because strict compatibility
+     * gateways may reject unknown request fields.
+     */
+    promptCacheAffinity?: boolean;
     /**
      * Provider-level default for OpenAI-compat `reasoning_content` echo.
      * Required by DeepSeek V4 thinking mode (replay 400s without it).
@@ -523,6 +531,8 @@ interface KodaXProviderConfig {
     maxOutputTokens?: number;
     /** Provider thinking budget 上限 */
     thinkingBudgetCap?: number;
+    /** Whether this verified endpoint accepts the protocol cache-affinity field. */
+    promptCacheAffinity?: boolean;
     /** Provider 默认 thinking budget 映射 */
     defaultThinkingBudgets?: Partial<KodaXThinkingBudgetMap>;
     /** 按任务类型覆盖默认 budget */
@@ -580,6 +590,11 @@ interface KodaXProviderConfig {
 interface KodaXProviderStreamOptions {
     /** Request-only tail context. Providers must not mutate persisted messages. */
     ephemeralSuffix?: KodaXEphemeralSuffix;
+    /**
+     * Opaque stable logical-context key used only for Provider cache routing.
+     * Protocol adapters lower it only when their endpoint explicitly opts in.
+     */
+    promptCacheKey?: string;
     onTextDelta?: (text: string) => void;
     onThinkingDelta?: (text: string) => void;
     onThinkingEnd?: (thinking: string) => void;

package/dist/types-chunks/{types.d-Bm_y6YuM.d.ts → types.d-DVDTIfB_.d.ts}

@@ -1,8 +1,8 @@
-import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CSmF0t0n.js';
-import { K as KodaXBaseProvider } from './base.d-ChvpaKjZ.js';
+import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-DIpZJKUl.js';
+import { K as KodaXBaseProvider } from './base.d-4e74xDdy.js';
 import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
-import { by as KodaXJsonValue, bm as KodaXExtensionSessionRecord, bo as KodaXExtensionStore } from './types.d-sRLugmjy.js';
-import { aG as KodaXToolExecutionContext, bn as ToolSideEffect } from './bash-prefix-extractor.d-r1beOESM.js';
+import { bF as KodaXJsonValue, bt as KodaXExtensionSessionRecord, bv as KodaXExtensionStore } from './types.d-BA-Jwpfs.js';
+import { aP as KodaXToolExecutionContext, bx as ToolSideEffect } from './bash-prefix-extractor.d-uAe2Oqda.js';
 
 /**
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).

package/dist/types-chunks/{utils.d-D0wPxz8y.d.ts → utils.d-CVp6bFl9.d.ts}

@@ -1,9 +1,9 @@
-import { k as KodaXMessage, F as KodaXReasoningMode, d as KodaXCustomProviderConfig, p as KodaXProviderCapabilityProfile } from './types.d-CSmF0t0n.js';
-import { O as KodaXContextTokenSnapshot, aj as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a6 as KodaXRepoIntelligenceMode, a1 as KodaXOptions, ak as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-r1beOESM.js';
-import { bX as KodaXSessionUiHistoryItem, bM as KodaXSessionLineage, bD as KodaXSessionArtifactLedgerEntry, bn as KodaXExtensionSessionState, bm as KodaXExtensionSessionRecord, bT as KodaXSessionRuntimeInfo, eb as WorkflowProcessSource } from './types.d-sRLugmjy.js';
-import { d as AgentsFile, r as AutoModeStats, x as KodaXMcpServersConfig } from './guardrail.d-qjuKJZ31.js';
+import { k as KodaXMessage, F as KodaXReasoningMode, d as KodaXCustomProviderConfig, p as KodaXProviderCapabilityProfile } from './types.d-DIpZJKUl.js';
+import { c3 as KodaXSessionUiHistoryItem, bU as KodaXSessionLineage, bL as KodaXSessionArtifactLedgerEntry, bu as KodaXExtensionSessionState, bt as KodaXExtensionSessionRecord, b$ as KodaXSessionRuntimeInfo, e$ as WorkflowProcessSource } from './types.d-BA-Jwpfs.js';
+import { O as KodaXContextTokenSnapshot, as as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a8 as KodaXRepoIntelligenceMode, a1 as KodaXOptions, at as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-uAe2Oqda.js';
+import { d as AgentsFile, s as AutoModeStats, J as KodaXMcpServersConfig } from './guardrail.d-CXDYRgZ3.js';
 import * as readline from 'readline';
-import { R as PermissionMode, L as LearningBinding, E as LearningSurfaceSnapshot } from './public-api.d-CX4B11qY.js';
+import { R as PermissionMode, L as LearningBinding, E as LearningSurfaceSnapshot } from './public-api.d-B3AohsxN.js';
 import { SpawnSyncReturns } from 'child_process';
 
 /**
@@ -310,6 +310,22 @@ interface CommandCallbacks {
     rewindSession?: (selector?: string) => Promise<SessionRewindStatus>;
     getCostReport?: () => string | null;
     getRuntimeStatus?: () => Promise<RuntimeSurfaceStatus | undefined>;
+    /** Canonical host parser used by `/setup` for the root-owned A2A schema. */
+    validateSetupA2AConfig?: (value: unknown) => unknown;
+    /** Root-owned sandbox activation because ASRT is distributed by the host package. */
+    prepareSetupSandbox?: () => Promise<{
+        readonly status: 'ready' | 'cancelled' | 'unavailable';
+        readonly lines: readonly string[];
+    }>;
+    /** Explicit read-only `/sandbox` probe. Ordinary startup never calls it. */
+    inspectSandbox?: () => Promise<{
+        readonly ready: boolean;
+        readonly platform: string;
+        readonly version: string;
+        readonly backend: string;
+        readonly diagnostics: readonly string[];
+        readonly guidance: readonly string[];
+    }>;
     learning?: LearningBinding;
     getLearningSummary?: () => Promise<LearningSurfaceSnapshot>;
     openLearningCenter?: (nameOrSlug?: string) => Promise<void>;
@@ -364,7 +380,7 @@ interface CommandDefinition {
     aliases?: string[];
     description: string;
     usage?: string;
-    detailedHelp?: () => void;
+    detailedHelp?: (args?: readonly string[]) => void;
     handler: CommandHandler;
     source?: CommandSource;
     priority?: CommandPriority;
@@ -406,7 +422,7 @@ interface Command {
     description: string;
     usage?: string;
     handler: CommandHandler;
-    detailedHelp?: () => void;
+    detailedHelp?: (args?: readonly string[]) => void;
     source?: CommandSource;
     priority?: CommandPriority;
     location?: 'user' | 'project' | 'path';