@kodax-ai/kodax 0.7.68 → 0.7.69

package/dist/types-chunks/{types.d-CzscbsG0.d.ts → types.d-C9YHEAmA.d.ts}

@@ -1,8 +1,8 @@
-import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CO_ZkmOd.js';
-import { K as KodaXBaseProvider } from './base.d-C8mXDhLL.js';
+import { a9 as KodaXWireReasoningEffort, a1 as KodaXToolDefinition, a3 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-TTvpAGWf.js';
+import { K as KodaXBaseProvider } from './base.d-CYjtB68X.js';
 import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-3C62G8Eq.js';
-import { aT as KodaXJsonValue, aH as KodaXExtensionSessionRecord, aJ as KodaXExtensionStore } from './types.d-D2frCRaY.js';
-import { aw as KodaXToolExecutionContext, bd as ToolSideEffect } from './bash-prefix-extractor.d-Dm-T865v.js';
+import { aT as KodaXJsonValue, aH as KodaXExtensionSessionRecord, aJ as KodaXExtensionStore } from './types.d-BtC4yLYO.js';
+import { aB as KodaXToolExecutionContext, bi as ToolSideEffect } from './bash-prefix-extractor.d-BkIA8Wto.js';
 
 /**
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).
@@ -323,6 +323,35 @@ type ToolHandlerStreaming = (input: Record<string, unknown>, context: KodaXToolE
 /** Union of both handler types. Existing tools use ToolHandlerSync; new long-running tools may use ToolHandlerStreaming. */
 type ToolHandler = ToolHandlerSync | ToolHandlerStreaming;
 
+interface RuntimeRemoteWorkspaceBroker {
+    resolveReadablePath(relativePath: string): Promise<string>;
+    stageOutput(suggestedName: string): Promise<{
+        readonly stagingId: string;
+        readonly path: string;
+    }>;
+}
+interface RuntimeRemoteToolContext {
+    readonly workspaceAccess: 'none' | 'read' | 'write';
+    readonly allowedNetworkOrigins: readonly string[];
+    readonly workspace: RuntimeRemoteWorkspaceBroker;
+    readonly signal: AbortSignal;
+}
+type RuntimeRemoteToolDecision = {
+    readonly allowed: true;
+    readonly input: Readonly<Record<string, unknown>>;
+} | {
+    readonly allowed: false;
+    readonly reason: string;
+};
+/** Explicit opt-in contract required before a non-native tool can serve remote callers. */
+interface RuntimeRemoteToolContract {
+    readonly kind: 'managed-service' | 'narrow';
+    readonly workspaceEffect: 'none' | 'read' | 'write';
+    readonly networkOrigins: readonly string[];
+    readonly credentialHandling: 'none' | 'internal-only';
+    readonly processImplementation: 'none' | 'fixed-host-operation';
+    authorizeCall(input: Readonly<Record<string, unknown>>, context: RuntimeRemoteToolContext): Promise<RuntimeRemoteToolDecision>;
+}
 /**
  * FEATURE_149 (v0.7.38) — interrupt-on-submit policy for in-flight tools.
  *
@@ -352,6 +381,8 @@ interface LocalToolDefinition extends KodaXToolDefinition {
      * not optional, to prevent silent drift when new tools are added).
      */
     sideEffect: ToolSideEffect;
+    /** Absent means this tool is not eligible for remote A2A execution. */
+    remoteContract?: RuntimeRemoteToolContract;
     /**
      * v0.7.42 — Optional plan-mode override.
      *
@@ -603,7 +634,7 @@ interface RegisteredHookDiagnostic {
     order: number;
     source: ExtensionContributionSource;
 }
-type ExtensionFailureStage = 'load' | 'reload' | 'event' | 'hook' | 'persistence';
+type ExtensionFailureStage = 'load' | 'reload' | 'event' | 'hook' | 'persistence' | 'dispose';
 interface ExtensionFailureDiagnostic {
     stage: ExtensionFailureStage;
     target: string;
@@ -971,5 +1002,5 @@ interface KodaXExtensionModule {
     activate?: (api: KodaXExtensionAPI) => KodaXExtensionActivationResult;
 }
 
-export { DEFAULT_HANDLER_TIMEOUT_MS as D, defaultPolicy as a1, exec as a2, webhook as a3, CapabilityDeniedError as c, ConstructionManifestError as e };
-export type { WebhookOptions as $, AgentArtifact as A, KodaXRetrievalItem as B, Capabilities as C, ExecOptions as E, KodaXRetrievalResult as F, KodaXRetrievalScope as G, KodaXRetrievalToolName as H, KodaXRetrievalTrust as I, LocalToolDefinition as J, KodaXExtensionAPI as K, LoadedExtensionDiagnostic as L, ModelProviderRegistration as M, RegisteredCommandDiagnostic as N, RegisteredHookDiagnostic as O, RegisteredToolDefinition as P, RegisteredToolDiagnostic as Q, RegisteredCapabilityProviderDiagnostic as R, ScriptSource as S, StagedHandle as T, TestResult as U, ToolContent as V, ToolDefinitionSource as W, ToolHandler as X, ToolHandlerSync as Y, ToolRegistrationOptions as Z, ToolRegistry as _, AgentContent as a, WebhookResult as a0, ArtifactStatus as b, ConstructionArtifact as d, ConstructionPolicy as f, ConstructionPolicyVerdict as g, ExecResult as h, ExtensionCommandContext as i, ExtensionCommandDefinition as j, ExtensionCommandInvocation as k, ExtensionCommandResult as l, ExtensionContributionSource as m, ExtensionEventMap as n, ExtensionFailureDiagnostic as o, ExtensionFailureStage as p, ExtensionHookMap as q, ExtensionLoadSource as r, ExtensionLogger as s, ExtensionRuntimeController as t, ExtensionRuntimeDiagnostics as u, ExtensionToolBeforeHookContext as v, KodaXExtensionActivationResult as w, KodaXExtensionModule as x, KodaXRetrievalArtifact as y, KodaXRetrievalFreshness as z };
+export { DEFAULT_HANDLER_TIMEOUT_MS as D, defaultPolicy as a5, exec as a6, webhook as a7, CapabilityDeniedError as c, ConstructionManifestError as e };
+export type { ToolHandler as $, AgentArtifact as A, KodaXRetrievalItem as B, Capabilities as C, ExecOptions as E, KodaXRetrievalResult as F, KodaXRetrievalScope as G, KodaXRetrievalToolName as H, KodaXRetrievalTrust as I, LocalToolDefinition as J, KodaXExtensionAPI as K, LoadedExtensionDiagnostic as L, ModelProviderRegistration as M, RegisteredCommandDiagnostic as N, RegisteredHookDiagnostic as O, RegisteredToolDefinition as P, RegisteredToolDiagnostic as Q, RegisteredCapabilityProviderDiagnostic as R, RuntimeRemoteToolContext as S, RuntimeRemoteToolContract as T, RuntimeRemoteToolDecision as U, RuntimeRemoteWorkspaceBroker as V, ScriptSource as W, StagedHandle as X, TestResult as Y, ToolContent as Z, ToolDefinitionSource as _, AgentContent as a, ToolHandlerSync as a0, ToolRegistrationOptions as a1, ToolRegistry as a2, WebhookOptions as a3, WebhookResult as a4, ArtifactStatus as b, ConstructionArtifact as d, ConstructionPolicy as f, ConstructionPolicyVerdict as g, ExecResult as h, ExtensionCommandContext as i, ExtensionCommandDefinition as j, ExtensionCommandInvocation as k, ExtensionCommandResult as l, ExtensionContributionSource as m, ExtensionEventMap as n, ExtensionFailureDiagnostic as o, ExtensionFailureStage as p, ExtensionHookMap as q, ExtensionLoadSource as r, ExtensionLogger as s, ExtensionRuntimeController as t, ExtensionRuntimeDiagnostics as u, ExtensionToolBeforeHookContext as v, KodaXExtensionActivationResult as w, KodaXExtensionModule as x, KodaXRetrievalArtifact as y, KodaXRetrievalFreshness as z };

package/dist/types-chunks/{types.d-D9FKbAmf.d.ts → types.d-CJR7t6iW.d.ts}

@@ -1,5 +1,5 @@
-import { aR as KodaXInputArtifact } from './types.d-D2frCRaY.js';
-import { S as KodaXTaskResultMetadata } from './types.d-CO_ZkmOd.js';
+import { aR as KodaXInputArtifact } from './types.d-BtC4yLYO.js';
+import { S as KodaXTaskResultMetadata } from './types.d-TTvpAGWf.js';
 
 /**
  * @kodax-ai/agent/messaging — Message queue types

package/dist/types-chunks/{types.d-CO_ZkmOd.d.ts → types.d-TTvpAGWf.d.ts}

@@ -73,6 +73,11 @@ interface KodaXToolResultBlock {
      */
     content: string | readonly KodaXToolResultContentItem[];
     is_error?: boolean;
+    /**
+     * Local recovery/accounting metadata. Provider serializers intentionally
+     * omit this field from the wire payload.
+     */
+    metadata?: Record<string, unknown>;
 }
 interface KodaXImageBlock {
     type: 'image';

package/dist/types-chunks/{utils.d-DOXxnOnI.d.ts → utils.d-BbB5jzi1.d.ts}

@@ -1,9 +1,9 @@
-import { k as KodaXMessage, F as KodaXReasoningMode, d as KodaXCustomProviderConfig, p as KodaXProviderCapabilityProfile } from './types.d-CO_ZkmOd.js';
-import { I as KodaXContextTokenSnapshot, ad as KodaXSkillDynamicContextPolicy, r as KodaXAgentMode, a0 as KodaXRepoIntelligenceMode, X as KodaXOptions, ae as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-Dm-T865v.js';
-import { bg as KodaXSessionUiHistoryItem, b5 as KodaXSessionLineage, aY as KodaXSessionArtifactLedgerEntry, aI as KodaXExtensionSessionState, aH as KodaXExtensionSessionRecord, bc as KodaXSessionRuntimeInfo, dr as WorkflowProcessSource } from './types.d-D2frCRaY.js';
-import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-CPDfZyJp.js';
+import { k as KodaXMessage, F as KodaXReasoningMode, d as KodaXCustomProviderConfig, p as KodaXProviderCapabilityProfile } from './types.d-TTvpAGWf.js';
+import { I as KodaXContextTokenSnapshot, ae as KodaXSkillDynamicContextPolicy, r as KodaXAgentMode, a1 as KodaXRepoIntelligenceMode, Y as KodaXOptions, af as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-BkIA8Wto.js';
+import { bg as KodaXSessionUiHistoryItem, b5 as KodaXSessionLineage, aY as KodaXSessionArtifactLedgerEntry, aI as KodaXExtensionSessionState, aH as KodaXExtensionSessionRecord, bc as KodaXSessionRuntimeInfo, du as WorkflowProcessSource } from './types.d-BtC4yLYO.js';
+import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-R7AiGfrI.js';
 import * as readline from 'readline';
-import { f as PermissionMode } from './public-api.d-BcKbBy1E.js';
+import { f as PermissionMode } from './public-api.d-7G4--RZE.js';
 import { SpawnSyncReturns } from 'child_process';
 
 /**
@@ -512,6 +512,14 @@ declare function loadConfig(): {
  * not block startup.
  */
 declare const KODAX_EXAMPLE_CONFIG_FILE: string;
+declare const KODAX_INTEGRATION_EXAMPLE_FILES: {
+    readonly mcp: string;
+    readonly a2a: string;
+    readonly extensions: string;
+};
+
+declare function ensureExampleConfigFiles(): readonly string[];
+/** @deprecated Use ensureExampleConfigFiles() to observe every created path. */
 declare function ensureExampleConfigFile(): string | undefined;
 declare function prepareRuntimeConfig(): ReturnType<typeof loadConfig>;
 declare function saveConfig(config: {
@@ -594,5 +602,5 @@ declare function resolveRuntimeEffortSelection(input: {
 declare function getGitRoot(cwd?: string): Promise<string | null>;
 declare function rateLimitedCall<T>(fn: () => Promise<T>): Promise<T>;
 
-export { resolveRuntimeModelSelection as A, resolveRuntimeProviderSelection as B, saveConfig as D, touchContext as E, KODAX_CONFIG_FILE as K, PREVIEW_MAX_LENGTH as P, KODAX_DIR as i, KODAX_EXAMPLE_CONFIG_FILE as j, KODAX_SESSIONS_DIR as k, KODAX_VERSION as l, createInteractiveContext as n, ensureExampleConfigFile as o, getGitRoot as p, getProviderList as q, getProviderModel as r, getVersion as s, hydrateProcessEnvFromShell as t, isProviderConfigured as u, loadConfig as v, prepareRuntimeConfig as w, rateLimitedCall as x, registerConfiguredCustomProviders as y, resolveRuntimeEffortSelection as z };
-export type { Command as C, InteractiveContext as I, RuntimeSurfaceMode as R, CommandCallbacks as a, CommandDefinition as b, CommandInfo as c, CommandInvocationRequest as d, CommandSource as e, CommandWorkflowInvocationRequest as f, CurrentConfig as g, InteractiveMode as h, RuntimeSurfaceStatus as m };
+export { registerConfiguredCustomProviders as A, resolveRuntimeEffortSelection as B, resolveRuntimeModelSelection as D, resolveRuntimeProviderSelection as E, saveConfig as F, touchContext as G, KODAX_CONFIG_FILE as K, PREVIEW_MAX_LENGTH as P, KODAX_DIR as i, KODAX_EXAMPLE_CONFIG_FILE as j, KODAX_INTEGRATION_EXAMPLE_FILES as k, KODAX_SESSIONS_DIR as l, KODAX_VERSION as m, createInteractiveContext as o, ensureExampleConfigFile as p, ensureExampleConfigFiles as q, getGitRoot as r, getProviderList as s, getProviderModel as t, getVersion as u, hydrateProcessEnvFromShell as v, isProviderConfigured as w, loadConfig as x, prepareRuntimeConfig as y, rateLimitedCall as z };
+export type { Command as C, InteractiveContext as I, RuntimeSurfaceMode as R, CommandCallbacks as a, CommandDefinition as b, CommandInfo as c, CommandInvocationRequest as d, CommandSource as e, CommandWorkflowInvocationRequest as f, CurrentConfig as g, InteractiveMode as h, RuntimeSurfaceStatus as n };