@kodax-ai/kodax 0.7.93 → 0.7.94

package/dist/sdk-runtime.d.ts

@@ -1,6 +1,6 @@
 import { KodaXReasoningMode, KodaXCustomProviderConfig } from './index.js';
 export { b as KodaXMessage } from './types-chunks/types.d-Cv09EdJR.js';
-import { Q as KodaXEvents, al as KodaXResult, bu as RuntimeContextBudgetSnapshot, bB as RuntimeToolExposurePlan, ad as KodaXPromptCacheDiagnosticEvent } from './types-chunks/bash-prefix-extractor.d-BMi_TJIY.js';
+import { Q as KodaXEvents, al as KodaXResult, bx as RuntimeContextBudgetSnapshot, bE as RuntimeToolExposurePlan, ad as KodaXPromptCacheDiagnosticEvent } from './types-chunks/bash-prefix-extractor.d-AOJdvO4r.js';
 import { KodaXOptions, KodaXShellExecutionContract, KodaXOutputSegmentProjection, KodaXToolSandboxObservationUpdate, KodaXToolEventMeta, KodaXManagedTaskStatusEvent, KodaXContextOptions, KodaXOutputSegmentStarted, KodaXActivityEventMeta, KodaXTurnStartedEvent, KodaXTurnCompletedEvent, KodaXTurnFailedEvent, KodaXLiveEventMeta, KodaXCompactionEndResult, RuntimeCompactionSkippedEvent, KodaXContextCompactionFinishedEvent, KodaXContextIdentity } from './index.js';
 import { AgentExecutionKind, AgentTreeSnapshot, AgentDetail, AgentSpawnInput, AgentTurnRef, AgentDataClassification, AgentFollowupResult, AgentOutput, AgentEvent } from './sdk-agent.js';
 import { KodaXImageInputArtifact, KodaXInputArtifactSource, KodaXVideoInputArtifact } from './index.js';
@@ -14,7 +14,7 @@ import { LoadedExtensionDiagnostic, ExtensionRuntimeDiagnostics } from './index.
 import { AutoModeDecisionDiagnostics, AutoModeStats } from './index.js';
 import { saveConfig } from './index.js';
 import { CommandInfo } from './sdk-repl.js';
-import { e as SessionTranscriptEntry } from './types-chunks/public-api.d-BsZWOq3P.js';
+import { e as SessionTranscriptEntry } from './types-chunks/public-api.d-BNmLxGnR.js';
 import { FullTranscriptSessionData, SessionConversationHistoryData, SessionConversationHistoryStatus, SessionConversationHistoryIssue, SessionConversationHistoryEntry, CompactSessionResult } from './sdk-repl.js';
 import 'vscode-languageserver-protocol';
 import './types-chunks/cost-tracker.d-MTAt6N7b.js';
@@ -238,12 +238,16 @@ interface RuntimeDaemonRequestControl {
     readonly signal?: AbortSignal;
     readonly onLateResult?: (value: unknown) => void;
 }
+/** Factual state for one daemon connection; disconnected does not imply daemon crash. */
 interface RuntimeDaemonTransportLifecycleState {
     readonly state: 'connected' | 'disconnected';
     readonly connectionId: string;
+    readonly code?: RuntimeDaemonDisconnectCode;
     readonly reason?: string;
     readonly reconnectable: boolean;
 }
+/** Transport-observable close reason. Run/daemon crash classification needs durable evidence. */
+type RuntimeDaemonDisconnectCode = 'protocol_closed' | 'transport_error' | 'invalid_frame' | 'client_closed';
 declare class RuntimeTransportBoundaryError extends Error {
     readonly path: string;
     readonly code: "invalid_transport_value";
@@ -378,6 +382,14 @@ interface RuntimeDaemonEndpoint {
     readonly kind: 'pipe' | 'unix';
     readonly path: string;
 }
+/** Pending RPC failure enriched with the same facts published by the lifecycle stream. */
+declare class RuntimeDaemonDisconnectError extends Error {
+    readonly code: RuntimeDaemonDisconnectCode;
+    readonly connectionId: string;
+    readonly reconnectable: boolean;
+    constructor(message: string, code: RuntimeDaemonDisconnectCode, connectionId: string, reconnectable: boolean, options?: ErrorOptions);
+}
+declare function isRuntimeDaemonDisconnectError(error: unknown): error is RuntimeDaemonDisconnectError;
 
 declare function parseRuntimeEvent(value: unknown): RuntimeEventParseResult;
 
@@ -1193,6 +1205,7 @@ interface ConnectKodaXRuntimeOptions {
 /** SDK facts that embedders can inspect before auto-starting a daemon. */
 declare const KODAX_RUNTIME_SDK_CAPABILITIES: Readonly<{
     readonly actorSettlementConvergence: 2;
+    readonly conversationHistory: 2;
     readonly crashOutcomeModel: 2;
     readonly daemonOrphanExit: 1;
     readonly daemonShutdownVerification: 1;
@@ -1234,8 +1247,8 @@ interface RuntimeCapabilityRequirements {
     readonly transcriptPaging?: 1;
     /** Require deterministic exact-history search over merged persisted lineage. */
     readonly transcriptSearch?: 1;
-    /** Require SDK-resolved ordinary history with explicit legacy ambiguity. */
-    readonly conversationHistory?: 1;
+    /** v2 also requires topology-transparent managed context and direct clone provenance. */
+    readonly conversationHistory?: 1 | 2;
     readonly connectionLifecycle?: 1;
     readonly typedRuntimeEvents?: 1;
     readonly daemonSafeRunInput?: 1;
@@ -1304,6 +1317,7 @@ interface RuntimeConnectionState {
     readonly connectionId: string;
     readonly runtimeEpoch: string;
     readonly journalEpoch?: string;
+    readonly code?: RuntimeDaemonTransportLifecycleState["code"];
     readonly reason?: string;
     readonly reconnectable: boolean;
 }
@@ -1399,6 +1413,7 @@ interface RuntimeCommandInfo {
 }
 interface RuntimeSkillListFilter {
     readonly projectRoot?: string;
+    /** @deprecated Every enabled Skill is explicitly user-invocable. */
     readonly userInvocableOnly?: boolean;
 }
 interface RuntimeSkillDescribeInput {
@@ -1413,10 +1428,12 @@ interface RuntimeSkillFileSummary {
 interface RuntimeSkillSummary {
     readonly name: string;
     readonly description: string;
+    /** Always true for enabled Skills; retained for wire compatibility. */
     readonly userInvocable: boolean;
     readonly argumentHint?: string;
     readonly path: string;
     readonly source: SkillMetadata["source"];
+    /** True when the Skill is hidden from model discovery and the model tool. */
     readonly disableModelInvocation: boolean;
 }
 interface RuntimeSkillDescription extends RuntimeSkillSummary {
@@ -1591,7 +1608,8 @@ interface RuntimeSessionDiagnosticsInput extends RuntimeReadOptions {
     /** Select one Run control record; otherwise the authoritative Session Run is used. */
     readonly runId?: string;
 }
-type RuntimeSessionDiagnosticErrorCode = "run_control_unknown" | "run_status_unknown" | "owner_liveness_unconfirmed" | "owner_recovery_required" | "stop_outcome_unconfirmed" | "actor_settlement_retrying" | "actor_settlement_not_persisted" | "run_failed" | "terminal_time_unknown";
+/** Bounded support classification; `unknown` settlement remains fail-closed. */
+type RuntimeSessionDiagnosticErrorCode = "run_control_unknown" | "run_status_unknown" | "owner_liveness_unconfirmed" | "owner_recovery_required" | "stop_outcome_unconfirmed" | "actor_settlement_retrying" | "actor_settlement_not_persisted" | "run_settlement_not_persisted" | "run_failed" | "terminal_time_unknown";
 interface RuntimeSessionDiagnosticError {
     readonly code: RuntimeSessionDiagnosticErrorCode;
     readonly message: string;
@@ -2013,8 +2031,9 @@ interface RuntimeRunStatus {
     readonly stop?: RuntimeRunStopStatus;
     readonly requirements?: RuntimeRunRequirements;
 }
+/** Durable lifecycle uncertainty reported without converting it into a successful terminal. */
 interface RuntimeRunLifecycleError {
-    readonly code: "actor_settlement_retrying" | "actor_settlement_not_persisted";
+    readonly code: "actor_settlement_retrying" | "actor_settlement_not_persisted" | "run_settlement_not_persisted";
     readonly message: string;
     readonly retryable: boolean;
 }
@@ -2067,12 +2086,16 @@ interface RuntimeRunStopReceipt {
     readonly revision: number;
 }
 type RuntimeTerminalCode = "completed" | "run_failed" | "blocked" | "cancelled" | "interrupted" | "runtime_restarted" | "daemon_crashed" | "credential_unavailable" | "host_not_dispatched" | "host_outcome_unknown" | "actor_settlement_not_persisted" | "control_history_untrusted";
+/** Credential-safe failure category; raw provider error text is never required. */
+type RuntimeRunFailureKind = "auth" | "rate_limit" | "network" | "provider_aborted" | "invalid_response" | "runtime_cleanup" | "provider";
 interface RuntimeTerminalFact {
     readonly revision: number;
     readonly kind: "completed" | "failed" | "cancelled" | "interrupted";
     readonly code: RuntimeTerminalCode;
     readonly effectOutcome: "none" | "known" | "unknown";
     readonly message?: string;
+    /** Safe diagnostic category for failed terminals, independent from display text. */
+    readonly failureKind?: RuntimeRunFailureKind;
 }
 interface RuntimeRunResult {
     readonly runId: string;
@@ -2671,5 +2694,5 @@ declare function connectKodaXRuntime(options?: ConnectKodaXRuntimeOptions): Prom
  */
 declare function settleKodaXRuntimeExit(input: RuntimeExitSettlementInput): Promise<RuntimeExitSettlement>;
 
-export { KODAX_DAEMON_PROTOCOL, KODAX_DAEMON_PROTOCOL_VERSION, KODAX_RUNTIME_SDK_CAPABILITIES, KodaXEvents, KodaXPromptCacheDiagnosticEvent, KodaXResult, RUNTIME_DAEMON_METHODS, RUNTIME_DAEMON_METHOD_SCHEMAS, RUNTIME_DAEMON_NOTIFICATION_SCHEMAS, RUNTIME_DAEMON_PROTOCOL_SCHEMA, RUNTIME_DAEMON_PROTOCOL_SCHEMA_JSON, RuntimeAutoModeConfigurationError, RuntimeContextBudgetSnapshot, RuntimeDaemonCapabilityUpgradeError, RuntimePermissionScopeUpgradeRequiredError, RuntimeToolExposurePlan, RuntimeTransportBoundaryError, SessionTranscriptEntry, acquireKodaXInlineOwner, captureRuntimeSessionDiagnostics, connectKodaXRuntime, createKodaXRuntime, enableKodaXDaemonOwner, getKodaXRuntimeOwnerPolicy, getKodaXRuntimeOwnerState, handleRuntimePermissionRequest, listRuntimeDaemonSchemaMethods, parseRuntimeEvent, setKodaXRuntimeOwnerMode, settleKodaXRuntimeExit, waitForRuntimeDaemonShutdown };
-export type { ConnectKodaXRuntimeOptions, CreateKodaXRuntimeOptions, KodaXDaemonRuntime, KodaXRuntime, KodaXRuntimeIsolation, KodaXRuntimeMode, RuntimeActiveAgentTurn, RuntimeActiveToolProjection, RuntimeAdminService, RuntimeAgentBindingService, RuntimeAgentOwnerSession, RuntimeAgentService, RuntimeAppendNoticeInput, RuntimeArtifact, RuntimeArtifactKind, RuntimeArtifactRefInput, RuntimeArtifactService, RuntimeBoundDefaultAgent, RuntimeBoundLocalAgent, RuntimeCapabilityRequirements, RuntimeCatalogService, RuntimeClientCapabilities, RuntimeClientInfo, RuntimeCommandInfo, RuntimeCommandResolveInput, RuntimeCompactSessionInput, RuntimeCompactSessionResult, RuntimeConfigPatch, RuntimeConfigReloadResult, RuntimeConfigService, RuntimeConnectionService, RuntimeConnectionState, RuntimeContextCompactionEndedEventPayload, RuntimeContextCompactionFinishedEventPayload, RuntimeContextCompactionMessagesEventPayload, RuntimeContextCompactionSkippedEventPayload, RuntimeContextCompactionStartedEventPayload, RuntimeContextCompactionStatsEventPayload, RuntimeContinuationStatus, RuntimeConversationHistory, RuntimeConversationHistoryBoundary, RuntimeConversationHistoryEntryChunk, RuntimeConversationHistoryEntryChunkInput, RuntimeConversationHistoryPageInput, RuntimeConversationHistorySlice, RuntimeConversationHistorySliceEntry, RuntimeCreateArtifactInput, RuntimeCreateSessionInput, RuntimeCredentialBroker, RuntimeCredentialLease, RuntimeCredentialRequest, RuntimeCredentialService, RuntimeDaemonClientTransport, RuntimeDaemonContextOptions, RuntimeDaemonEndpoint, RuntimeDaemonError, RuntimeDaemonErrorCode, RuntimeDaemonFrame, RuntimeDaemonJsonSchema, RuntimeDaemonKodaXOptions, RuntimeDaemonManagementService, RuntimeDaemonManagementState, RuntimeDaemonMethod, RuntimeDaemonMethodSchema, RuntimeDaemonNotification, RuntimeDaemonNotificationMethod, RuntimeDaemonPreflight, RuntimeDaemonProtocolSchema, RuntimeDaemonRequest, RuntimeDaemonRequestControl, RuntimeDaemonRollbackInput, RuntimeDaemonRollbackResult, RuntimeDaemonRunService, RuntimeDaemonShutdownVerification, RuntimeDaemonShutdownVerificationInput, RuntimeDaemonShutdownVerificationOwner, RuntimeDaemonStartRunInput, RuntimeDaemonTransportLifecycleState, RuntimeDefaultAgentStartInput, RuntimeDeliveredInterruptInput, RuntimeDiagnosticFilter, RuntimeDiagnosticsService, RuntimeEffectiveSkillRef, RuntimeEvent, RuntimeEventEnvelope, RuntimeEventFilter, RuntimeEventListener, RuntimeEventParseResult, RuntimeEventPayloadMap, RuntimeEventReplayFilter, RuntimeEventService, RuntimeEventType, RuntimeExactCallPermissionMatcher, RuntimeExactCommandPermissionMatcher, RuntimeExactPathPermissionMatcher, RuntimeExecutionToolPolicy, RuntimeExitSettlement, RuntimeExitSettlementBlockReason, RuntimeExitSettlementInput, RuntimeExtensionListResult, RuntimeExtensionReloadResult, RuntimeExternalAgentsOptions, RuntimeFileInput, RuntimeForkSessionInput, RuntimeGrantedScope, RuntimeHostToolDescriptor, RuntimeHostToolHandler, RuntimeHostToolInvocation, RuntimeHostToolInvocationStatus, RuntimeHostToolLease, RuntimeHostToolResult, RuntimeHostToolService, RuntimeIdentity, RuntimeImageInput, RuntimeInlineOwnerHandle, RuntimeInput, RuntimeIntegrationDiagnostic, RuntimeIntegrationDomainStatus, RuntimeIntegrationHealth, RuntimeInteractionResolvedEventPayload, RuntimeInterruptInputStatus, RuntimeKodaXOptions, RuntimeLearningService, RuntimeLocalAgentStartInput, RuntimeManagedTaskProjection, RuntimeMcpReloadResult, RuntimeMcpService, RuntimeMcpToolListFilter, RuntimeMcpValidateResult, RuntimeModelListFilter, RuntimeObservationInvalidation, RuntimeOperationOptions, RuntimeOperationReceipt, RuntimeOperationService, RuntimeOperationState, RuntimeOutputSegmentStartedEventPayload, RuntimeOwnerIdentity, RuntimeOwnerPolicyState, RuntimeOwnerState, RuntimePendingUserInputProjection, RuntimePermissionBroker, RuntimePermissionDecision, RuntimePermissionFilter, RuntimePermissionGrant, RuntimePermissionGrantChangedEventPayload, RuntimePermissionGrantSuggestion, RuntimePermissionHostPlatform, RuntimePermissionMatcher, RuntimePermissionPrompt, RuntimePermissionPromptContext, RuntimePermissionPromptResolution, RuntimePermissionRequest, RuntimePermissionRequestInput, RuntimePermissionRespondOptions, RuntimePermissionRisk, RuntimePermissionScope, RuntimePermissionService, RuntimeReadOptions, RuntimeResolvedLocalAgent, RuntimeRewindSessionInput, RuntimeRunFilter, RuntimeRunHandle, RuntimeRunInputDeliveredEventPayload, RuntimeRunInputQueuedEventPayload, RuntimeRunLifecycleError, RuntimeRunMode, RuntimeRunPhase, RuntimeRunProgressEventPayload, RuntimeRunRequirements, RuntimeRunResult, RuntimeRunService, RuntimeRunSessionLoadedEventPayload, RuntimeRunStage, RuntimeRunStatus, RuntimeRunStopReceipt, RuntimeRunStopStatus, RuntimeSession, RuntimeSessionCursor, RuntimeSessionDiagnosticError, RuntimeSessionDiagnosticErrorCode, RuntimeSessionDiagnosticRun, RuntimeSessionDiagnostics, RuntimeSessionDiagnosticsInput, RuntimeSessionFilter, RuntimeSessionLiveProjection, RuntimeSessionLoadedEventPayload, RuntimeSessionObservation, RuntimeSessionObservationSnapshot, RuntimeSessionService, RuntimeSessionSettings, RuntimeSessionSettingsPatch, RuntimeSessionSettingsUpdatedEventPayload, RuntimeSessionStatus, RuntimeSessionSummary, RuntimeSetActiveEntryInput, RuntimeSkillDescribeInput, RuntimeSkillDescription, RuntimeSkillFileSummary, RuntimeSkillListFilter, RuntimeSkillSummary, RuntimeStartRunInput, RuntimeStatusService, RuntimeStatusSnapshot, RuntimeSubmitInput, RuntimeSubmitInputResult, RuntimeSubscription, RuntimeTerminalCode, RuntimeTerminalFact, RuntimeTextDeltaEventPayload, RuntimeTextInput, RuntimeThinkingFinishedEventPayload, RuntimeTodoUpdatedEventPayload, RuntimeToolFinishedEventPayload, RuntimeToolProgressEventPayload, RuntimeToolSandboxEventPayload, RuntimeToolStartedEventPayload, RuntimeTranscript, RuntimeTranscriptEntryChunk, RuntimeTranscriptEntryChunkInput, RuntimeTranscriptPageInput, RuntimeTranscriptSearchHit, RuntimeTranscriptSearchInput, RuntimeTranscriptSearchResult, RuntimeTranscriptSlice, RuntimeTranscriptSliceEntry, RuntimeTypedEvent, RuntimeTypedEventListener, RuntimeUserInputFilter, RuntimeUserInputKind, RuntimeUserInputRequest, RuntimeUserInputRequestedEventPayload, RuntimeUserInputResolution, RuntimeUserInputService, RuntimeUserMarkdownAgentRef, RuntimeVersionedUpdateOptions, RuntimeVersionedValue, RuntimeVideoInput, RuntimeWarningEventPayload, RuntimeWorkerOptions, RuntimeWorkerResourceLimits, RuntimeWorkflowFilter, RuntimeWorkflowListener, RuntimeWorkflowService, RuntimeWorkflowSnapshot, RuntimeWorkflowSummary, RuntimeWorkspaceBinding };
+export { KODAX_DAEMON_PROTOCOL, KODAX_DAEMON_PROTOCOL_VERSION, KODAX_RUNTIME_SDK_CAPABILITIES, KodaXEvents, KodaXPromptCacheDiagnosticEvent, KodaXResult, RUNTIME_DAEMON_METHODS, RUNTIME_DAEMON_METHOD_SCHEMAS, RUNTIME_DAEMON_NOTIFICATION_SCHEMAS, RUNTIME_DAEMON_PROTOCOL_SCHEMA, RUNTIME_DAEMON_PROTOCOL_SCHEMA_JSON, RuntimeAutoModeConfigurationError, RuntimeContextBudgetSnapshot, RuntimeDaemonCapabilityUpgradeError, RuntimeDaemonDisconnectError, RuntimePermissionScopeUpgradeRequiredError, RuntimeToolExposurePlan, RuntimeTransportBoundaryError, SessionTranscriptEntry, acquireKodaXInlineOwner, captureRuntimeSessionDiagnostics, connectKodaXRuntime, createKodaXRuntime, enableKodaXDaemonOwner, getKodaXRuntimeOwnerPolicy, getKodaXRuntimeOwnerState, handleRuntimePermissionRequest, isRuntimeDaemonDisconnectError, listRuntimeDaemonSchemaMethods, parseRuntimeEvent, setKodaXRuntimeOwnerMode, settleKodaXRuntimeExit, waitForRuntimeDaemonShutdown };
+export type { ConnectKodaXRuntimeOptions, CreateKodaXRuntimeOptions, KodaXDaemonRuntime, KodaXRuntime, KodaXRuntimeIsolation, KodaXRuntimeMode, RuntimeActiveAgentTurn, RuntimeActiveToolProjection, RuntimeAdminService, RuntimeAgentBindingService, RuntimeAgentOwnerSession, RuntimeAgentService, RuntimeAppendNoticeInput, RuntimeArtifact, RuntimeArtifactKind, RuntimeArtifactRefInput, RuntimeArtifactService, RuntimeBoundDefaultAgent, RuntimeBoundLocalAgent, RuntimeCapabilityRequirements, RuntimeCatalogService, RuntimeClientCapabilities, RuntimeClientInfo, RuntimeCommandInfo, RuntimeCommandResolveInput, RuntimeCompactSessionInput, RuntimeCompactSessionResult, RuntimeConfigPatch, RuntimeConfigReloadResult, RuntimeConfigService, RuntimeConnectionService, RuntimeConnectionState, RuntimeContextCompactionEndedEventPayload, RuntimeContextCompactionFinishedEventPayload, RuntimeContextCompactionMessagesEventPayload, RuntimeContextCompactionSkippedEventPayload, RuntimeContextCompactionStartedEventPayload, RuntimeContextCompactionStatsEventPayload, RuntimeContinuationStatus, RuntimeConversationHistory, RuntimeConversationHistoryBoundary, RuntimeConversationHistoryEntryChunk, RuntimeConversationHistoryEntryChunkInput, RuntimeConversationHistoryPageInput, RuntimeConversationHistorySlice, RuntimeConversationHistorySliceEntry, RuntimeCreateArtifactInput, RuntimeCreateSessionInput, RuntimeCredentialBroker, RuntimeCredentialLease, RuntimeCredentialRequest, RuntimeCredentialService, RuntimeDaemonClientTransport, RuntimeDaemonContextOptions, RuntimeDaemonDisconnectCode, RuntimeDaemonEndpoint, RuntimeDaemonError, RuntimeDaemonErrorCode, RuntimeDaemonFrame, RuntimeDaemonJsonSchema, RuntimeDaemonKodaXOptions, RuntimeDaemonManagementService, RuntimeDaemonManagementState, RuntimeDaemonMethod, RuntimeDaemonMethodSchema, RuntimeDaemonNotification, RuntimeDaemonNotificationMethod, RuntimeDaemonPreflight, RuntimeDaemonProtocolSchema, RuntimeDaemonRequest, RuntimeDaemonRequestControl, RuntimeDaemonRollbackInput, RuntimeDaemonRollbackResult, RuntimeDaemonRunService, RuntimeDaemonShutdownVerification, RuntimeDaemonShutdownVerificationInput, RuntimeDaemonShutdownVerificationOwner, RuntimeDaemonStartRunInput, RuntimeDaemonTransportLifecycleState, RuntimeDefaultAgentStartInput, RuntimeDeliveredInterruptInput, RuntimeDiagnosticFilter, RuntimeDiagnosticsService, RuntimeEffectiveSkillRef, RuntimeEvent, RuntimeEventEnvelope, RuntimeEventFilter, RuntimeEventListener, RuntimeEventParseResult, RuntimeEventPayloadMap, RuntimeEventReplayFilter, RuntimeEventService, RuntimeEventType, RuntimeExactCallPermissionMatcher, RuntimeExactCommandPermissionMatcher, RuntimeExactPathPermissionMatcher, RuntimeExecutionToolPolicy, RuntimeExitSettlement, RuntimeExitSettlementBlockReason, RuntimeExitSettlementInput, RuntimeExtensionListResult, RuntimeExtensionReloadResult, RuntimeExternalAgentsOptions, RuntimeFileInput, RuntimeForkSessionInput, RuntimeGrantedScope, RuntimeHostToolDescriptor, RuntimeHostToolHandler, RuntimeHostToolInvocation, RuntimeHostToolInvocationStatus, RuntimeHostToolLease, RuntimeHostToolResult, RuntimeHostToolService, RuntimeIdentity, RuntimeImageInput, RuntimeInlineOwnerHandle, RuntimeInput, RuntimeIntegrationDiagnostic, RuntimeIntegrationDomainStatus, RuntimeIntegrationHealth, RuntimeInteractionResolvedEventPayload, RuntimeInterruptInputStatus, RuntimeKodaXOptions, RuntimeLearningService, RuntimeLocalAgentStartInput, RuntimeManagedTaskProjection, RuntimeMcpReloadResult, RuntimeMcpService, RuntimeMcpToolListFilter, RuntimeMcpValidateResult, RuntimeModelListFilter, RuntimeObservationInvalidation, RuntimeOperationOptions, RuntimeOperationReceipt, RuntimeOperationService, RuntimeOperationState, RuntimeOutputSegmentStartedEventPayload, RuntimeOwnerIdentity, RuntimeOwnerPolicyState, RuntimeOwnerState, RuntimePendingUserInputProjection, RuntimePermissionBroker, RuntimePermissionDecision, RuntimePermissionFilter, RuntimePermissionGrant, RuntimePermissionGrantChangedEventPayload, RuntimePermissionGrantSuggestion, RuntimePermissionHostPlatform, RuntimePermissionMatcher, RuntimePermissionPrompt, RuntimePermissionPromptContext, RuntimePermissionPromptResolution, RuntimePermissionRequest, RuntimePermissionRequestInput, RuntimePermissionRespondOptions, RuntimePermissionRisk, RuntimePermissionScope, RuntimePermissionService, RuntimeReadOptions, RuntimeResolvedLocalAgent, RuntimeRewindSessionInput, RuntimeRunFailureKind, RuntimeRunFilter, RuntimeRunHandle, RuntimeRunInputDeliveredEventPayload, RuntimeRunInputQueuedEventPayload, RuntimeRunLifecycleError, RuntimeRunMode, RuntimeRunPhase, RuntimeRunProgressEventPayload, RuntimeRunRequirements, RuntimeRunResult, RuntimeRunService, RuntimeRunSessionLoadedEventPayload, RuntimeRunStage, RuntimeRunStatus, RuntimeRunStopReceipt, RuntimeRunStopStatus, RuntimeSession, RuntimeSessionCursor, RuntimeSessionDiagnosticError, RuntimeSessionDiagnosticErrorCode, RuntimeSessionDiagnosticRun, RuntimeSessionDiagnostics, RuntimeSessionDiagnosticsInput, RuntimeSessionFilter, RuntimeSessionLiveProjection, RuntimeSessionLoadedEventPayload, RuntimeSessionObservation, RuntimeSessionObservationSnapshot, RuntimeSessionService, RuntimeSessionSettings, RuntimeSessionSettingsPatch, RuntimeSessionSettingsUpdatedEventPayload, RuntimeSessionStatus, RuntimeSessionSummary, RuntimeSetActiveEntryInput, RuntimeSkillDescribeInput, RuntimeSkillDescription, RuntimeSkillFileSummary, RuntimeSkillListFilter, RuntimeSkillSummary, RuntimeStartRunInput, RuntimeStatusService, RuntimeStatusSnapshot, RuntimeSubmitInput, RuntimeSubmitInputResult, RuntimeSubscription, RuntimeTerminalCode, RuntimeTerminalFact, RuntimeTextDeltaEventPayload, RuntimeTextInput, RuntimeThinkingFinishedEventPayload, RuntimeTodoUpdatedEventPayload, RuntimeToolFinishedEventPayload, RuntimeToolProgressEventPayload, RuntimeToolSandboxEventPayload, RuntimeToolStartedEventPayload, RuntimeTranscript, RuntimeTranscriptEntryChunk, RuntimeTranscriptEntryChunkInput, RuntimeTranscriptPageInput, RuntimeTranscriptSearchHit, RuntimeTranscriptSearchInput, RuntimeTranscriptSearchResult, RuntimeTranscriptSlice, RuntimeTranscriptSliceEntry, RuntimeTypedEvent, RuntimeTypedEventListener, RuntimeUserInputFilter, RuntimeUserInputKind, RuntimeUserInputRequest, RuntimeUserInputRequestedEventPayload, RuntimeUserInputResolution, RuntimeUserInputService, RuntimeUserMarkdownAgentRef, RuntimeVersionedUpdateOptions, RuntimeVersionedValue, RuntimeVideoInput, RuntimeWarningEventPayload, RuntimeWorkerOptions, RuntimeWorkerResourceLimits, RuntimeWorkflowFilter, RuntimeWorkflowListener, RuntimeWorkflowService, RuntimeWorkflowSnapshot, RuntimeWorkflowSummary, RuntimeWorkspaceBinding };

package/dist/sdk-runtime.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y}from"./chunks/chunk-D27EY4XC.js";import"./chunks/chunk-A3ZQE2BX.js";import"./chunks/chunk-SMVC3Q3U.js";import"./chunks/chunk-3YOZIFSJ.js";import"./chunks/chunk-HLZWPB32.js";import"./chunks/chunk-GRWUC6H7.js";import"./chunks/chunk-4BY53JTF.js";import"./chunks/chunk-XTWIGVUL.js";import"./chunks/chunk-JJ2YDBSN.js";import"./chunks/chunk-7QBWHCIZ.js";import"./chunks/chunk-PRASABCC.js";import"./chunks/chunk-JTZKC4TV.js";import"./chunks/chunk-GH3KBC2H.js";import"./chunks/chunk-YVG6OKN7.js";import"./chunks/chunk-BHE66SP3.js";import"./chunks/chunk-7XSZVOG7.js";import"./chunks/chunk-QFV6YCIH.js";import"./chunks/chunk-ONUPGMER.js";export{b as KODAX_DAEMON_PROTOCOL,c as KODAX_DAEMON_PROTOCOL_VERSION,t as KODAX_RUNTIME_SDK_CAPABILITIES,d as RUNTIME_DAEMON_METHODS,g as RUNTIME_DAEMON_METHOD_SCHEMAS,h as RUNTIME_DAEMON_NOTIFICATION_SCHEMAS,i as RUNTIME_DAEMON_PROTOCOL_SCHEMA,j as RUNTIME_DAEMON_PROTOCOL_SCHEMA_JSON,n as RuntimeAutoModeConfigurationError,m as RuntimeDaemonCapabilityUpgradeError,f as RuntimePermissionScopeUpgradeRequiredError,e as RuntimeTransportBoundaryError,o as acquireKodaXInlineOwner,v as captureRuntimeSessionDiagnostics,x as connectKodaXRuntime,w as createKodaXRuntime,r as enableKodaXDaemonOwner,p as getKodaXRuntimeOwnerPolicy,q as getKodaXRuntimeOwnerState,u as handleRuntimePermissionRequest,k as listRuntimeDaemonSchemaMethods,a as parseRuntimeEvent,s as setKodaXRuntimeOwnerMode,y as settleKodaXRuntimeExit,l as waitForRuntimeDaemonShutdown};
+import{A,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"./chunks/chunk-7CKGNNTU.js";import"./chunks/chunk-EASGM7W7.js";import"./chunks/chunk-NK5AWGNW.js";import"./chunks/chunk-ZKEXHAXA.js";import"./chunks/chunk-YMNFQ7SQ.js";import"./chunks/chunk-IIIAUDGW.js";import"./chunks/chunk-ZMGATMXN.js";import"./chunks/chunk-NGOPE4KK.js";import"./chunks/chunk-56CIZI5I.js";import"./chunks/chunk-7QBWHCIZ.js";import"./chunks/chunk-6BATYA47.js";import"./chunks/chunk-ZGZLSKN6.js";import"./chunks/chunk-N7HIJNJH.js";import"./chunks/chunk-BVV3IA5W.js";import"./chunks/chunk-BHE66SP3.js";import"./chunks/chunk-UNRHTOT5.js";import"./chunks/chunk-77PNP27P.js";import"./chunks/chunk-ONUPGMER.js";export{b as KODAX_DAEMON_PROTOCOL,c as KODAX_DAEMON_PROTOCOL_VERSION,v as KODAX_RUNTIME_SDK_CAPABILITIES,d as RUNTIME_DAEMON_METHODS,i as RUNTIME_DAEMON_METHOD_SCHEMAS,j as RUNTIME_DAEMON_NOTIFICATION_SCHEMAS,k as RUNTIME_DAEMON_PROTOCOL_SCHEMA,l as RUNTIME_DAEMON_PROTOCOL_SCHEMA_JSON,p as RuntimeAutoModeConfigurationError,o as RuntimeDaemonCapabilityUpgradeError,g as RuntimeDaemonDisconnectError,f as RuntimePermissionScopeUpgradeRequiredError,e as RuntimeTransportBoundaryError,q as acquireKodaXInlineOwner,x as captureRuntimeSessionDiagnostics,z as connectKodaXRuntime,y as createKodaXRuntime,t as enableKodaXDaemonOwner,r as getKodaXRuntimeOwnerPolicy,s as getKodaXRuntimeOwnerState,w as handleRuntimePermissionRequest,h as isRuntimeDaemonDisconnectError,m as listRuntimeDaemonSchemaMethods,a as parseRuntimeEvent,u as setKodaXRuntimeOwnerMode,A as settleKodaXRuntimeExit,n as waitForRuntimeDaemonShutdown};

package/dist/sdk-sandbox.d.ts

@@ -69,6 +69,13 @@ interface KodaXSandboxCapability {
     readonly setupMayElevate: boolean;
     readonly unavailableBehavior: 'structured-no-execution';
     readonly permissionFallback: 'normal-permission-policy';
+    /**
+     * Marker field (v4, non-versioned): Windows sandboxed git trusts exactly the
+     * session-authorized repo roots through per-exec `safe.directory` env entries.
+     * A daemon that reports `sandboxRuntime` without this field predates that
+     * behavior; clients surface a restart diagnostic instead of failing the gate.
+     */
+    readonly gitSafeDirectory: 'authorized-repo-roots';
 }
 declare function sandboxRuntimeCapability(): KodaXSandboxCapability;
 declare function doctorSandboxRuntime(options?: {

package/dist/sdk-sandbox.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import"./chunks/chunk-5BNQXXGY.js";import{a,b,h as c,i as d,j as e,k as f,l as g}from"./chunks/chunk-A3ZQE2BX.js";import"./chunks/chunk-4BY53JTF.js";import"./chunks/chunk-XTWIGVUL.js";import"./chunks/chunk-JJ2YDBSN.js";import"./chunks/chunk-7QBWHCIZ.js";import"./chunks/chunk-PRASABCC.js";import"./chunks/chunk-JTZKC4TV.js";import"./chunks/chunk-GH3KBC2H.js";import"./chunks/chunk-YVG6OKN7.js";import"./chunks/chunk-BHE66SP3.js";import"./chunks/chunk-7XSZVOG7.js";import"./chunks/chunk-QFV6YCIH.js";import"./chunks/chunk-ONUPGMER.js";export{a as KODAX_ASRT_VERSION,f as activateKodaXSandbox,c as doctorKodaXSandbox,b as getKodaXSandboxCapability,e as getKodaXSandboxSetupGuidance,g as runKodaXSandboxed,d as setupKodaXSandbox};
+import"./chunks/chunk-5BNQXXGY.js";import{a,b,h as c,i as d,j as e,k as f,l as g}from"./chunks/chunk-EASGM7W7.js";import"./chunks/chunk-ZMGATMXN.js";import"./chunks/chunk-NGOPE4KK.js";import"./chunks/chunk-56CIZI5I.js";import"./chunks/chunk-7QBWHCIZ.js";import"./chunks/chunk-6BATYA47.js";import"./chunks/chunk-ZGZLSKN6.js";import"./chunks/chunk-N7HIJNJH.js";import"./chunks/chunk-BVV3IA5W.js";import"./chunks/chunk-BHE66SP3.js";import"./chunks/chunk-UNRHTOT5.js";import"./chunks/chunk-77PNP27P.js";import"./chunks/chunk-ONUPGMER.js";export{a as KODAX_ASRT_VERSION,f as activateKodaXSandbox,c as doctorKodaXSandbox,b as getKodaXSandboxCapability,e as getKodaXSandboxSetupGuidance,g as runKodaXSandboxed,d as setupKodaXSandbox};

package/dist/sdk-session.d.ts

@@ -1,11 +1,11 @@
-export { x as AppendClientNoticeOptions, y as CompactSessionOptions, C as CompactSessionResult, j as CreatableHistoryItem, N as DeleteSessionResult, O as ForkSessionOptions, d as FullTranscriptSessionData, a5 as ListSessionsOptions, P as PreparedSessionAppendBaseline, a as PreparedSessionTailDelta, aa as RewindSessionOptions, ab as RunningSessionInfo, ac as SessionBundleExportDiagnostic, ad as SessionBundleExportFile, ae as SessionBundleExportOptions, af as SessionBundleExportResult, ag as SessionBundleExportStatus, f as SessionConversationHistoryData, i as SessionConversationHistoryEntry, h as SessionConversationHistoryIssue, ah as SessionConversationHistoryIssueCode, g as SessionConversationHistoryStatus, ai as SessionConversationMutationBoundary, ak as SessionManager, am as SessionReadError, an as SessionReadErrorCode, ao as SessionReadOptions, ap as SessionSummary, e as SessionTranscriptEntry, aq as SessionTranscriptEntryType, ay as WatchSessionsCallback, az as appendClientNotice, aA as archiveSession, aB as compactSession, aH as createSessionManager, aI as deleteSession, aK as exportSessionBundle, aM as forkSession, aO as listRunningSessions, aP as listSessions, aQ as loadFullTranscript, aR as loadSession, aU as readConversationHistory, aV as readFullTranscript, aX as rewindSession, aY as setActiveEntry, aZ as unarchiveSession, a_ as watchSessions } from './types-chunks/public-api.d-BsZWOq3P.js';
+export { x as AppendClientNoticeOptions, y as CompactSessionOptions, C as CompactSessionResult, j as CreatableHistoryItem, N as DeleteSessionResult, O as ForkSessionOptions, d as FullTranscriptSessionData, a5 as ListSessionsOptions, P as PreparedSessionAppendBaseline, a as PreparedSessionTailDelta, aa as RewindSessionOptions, ab as RunningSessionInfo, ac as SessionBundleExportDiagnostic, ad as SessionBundleExportFile, ae as SessionBundleExportOptions, af as SessionBundleExportResult, ag as SessionBundleExportStatus, f as SessionConversationHistoryData, i as SessionConversationHistoryEntry, h as SessionConversationHistoryIssue, ah as SessionConversationHistoryIssueCode, g as SessionConversationHistoryStatus, ai as SessionConversationMutationBoundary, ak as SessionManager, am as SessionReadError, an as SessionReadErrorCode, ao as SessionReadOptions, ap as SessionSummary, e as SessionTranscriptEntry, aq as SessionTranscriptEntryType, ay as WatchSessionsCallback, az as appendClientNotice, aA as archiveSession, aB as compactSession, aH as createSessionManager, aI as deleteSession, aK as exportSessionBundle, aM as forkSession, aO as listRunningSessions, aP as listSessions, aQ as loadFullTranscript, aR as loadSession, aU as readConversationHistory, aV as readFullTranscript, aX as rewindSession, aY as setActiveEntry, aZ as unarchiveSession, a_ as watchSessions } from './types-chunks/public-api.d-BNmLxGnR.js';
 export { a as KodaXTaskResultMetadata, G as KodaXTaskResultSource } from './types-chunks/types.d-Cv09EdJR.js';
 export { S as KodaXSessionUiHistoryItem, T as KodaXSessionUiHistoryItemType, U as KodaXSessionUiTextHistoryItem, V as KodaXSessionUiTextHistoryItemType, W as KodaXSessionUiToolCall, X as KodaXSessionUiToolCallStatus, Y as KodaXSessionUiToolGroupHistoryItem } from './types-chunks/types.d-EjZTEEVu.js';
-export { H as HistorySeedSourceMessage, R as RestoreHistoryItemsFromSessionInput, a as RestoredHistorySeed, e as extractHistorySeedsFromMessage, b as extractHistorySeedsFromMessages, r as restoreHistoryItemsFromSession } from './types-chunks/sdk-session-BTzblJTQ.js';
-import './types-chunks/bash-prefix-extractor.d-BMi_TJIY.js';
+export { H as HistorySeedSourceMessage, R as RestoreHistoryItemsFromSessionInput, a as RestoredHistorySeed, e as extractHistorySeedsFromMessage, b as extractHistorySeedsFromMessages, r as restoreHistoryItemsFromSession } from './types-chunks/sdk-session-BwC_i6JB.js';
+import './types-chunks/bash-prefix-extractor.d-AOJdvO4r.js';
 import 'vscode-languageserver-protocol';
 import './types-chunks/controller.d-Bm1i9RVj.js';
-import './types-chunks/types.d-BEMcUOng.js';
+import './types-chunks/types.d-ssh6zRaf.js';
 import './types-chunks/cost-tracker.d-MTAt6N7b.js';
 import './types-chunks/types-D8OiIEwA.js';
 import './types-chunks/capability.d-K664nHOS.js';

package/dist/sdk-session.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{$b as l,Tb as n,Ub as t,Vb as r,Wb as a,Xb as S,Yb as d,ac as p,bb as o,bc as u,cc as y,dc as c,ec as m,fc as H,gc as C,hc as T,ic as x,jc as R,mb as i}from"./chunks/chunk-SMVC3Q3U.js";import{O as s,P as e}from"./chunks/chunk-3YOZIFSJ.js";import"./chunks/chunk-HLZWPB32.js";import"./chunks/chunk-GRWUC6H7.js";import"./chunks/chunk-4BY53JTF.js";import"./chunks/chunk-XTWIGVUL.js";import"./chunks/chunk-JJ2YDBSN.js";import"./chunks/chunk-7QBWHCIZ.js";import"./chunks/chunk-PRASABCC.js";import"./chunks/chunk-JTZKC4TV.js";import"./chunks/chunk-GH3KBC2H.js";import"./chunks/chunk-YVG6OKN7.js";import"./chunks/chunk-BHE66SP3.js";import"./chunks/chunk-7XSZVOG7.js";import"./chunks/chunk-QFV6YCIH.js";import"./chunks/chunk-ONUPGMER.js";export{i as SessionReadError,p as appendClientNotice,C as archiveSession,n as compactSession,R as createSessionManager,H as deleteSession,l as exportSessionBundle,s as extractHistorySeedsFromMessage,e as extractHistorySeedsFromMessages,u as forkSession,m as listRunningSessions,t as listSessions,a as loadFullTranscript,r as loadSession,d as readConversationHistory,S as readFullTranscript,o as restoreHistoryItemsFromSession,y as rewindSession,c as setActiveEntry,T as unarchiveSession,x as watchSessions};
+import{Ub as n,Vb as t,Wb as r,Xb as a,Yb as S,Zb as d,ac as l,bc as p,cb as o,cc as u,dc as y,ec as c,fc as m,gc as H,hc as C,ic as T,jc as x,kc as R,nb as i}from"./chunks/chunk-NK5AWGNW.js";import{S as s,T as e}from"./chunks/chunk-ZKEXHAXA.js";import"./chunks/chunk-YMNFQ7SQ.js";import"./chunks/chunk-IIIAUDGW.js";import"./chunks/chunk-ZMGATMXN.js";import"./chunks/chunk-NGOPE4KK.js";import"./chunks/chunk-56CIZI5I.js";import"./chunks/chunk-7QBWHCIZ.js";import"./chunks/chunk-6BATYA47.js";import"./chunks/chunk-ZGZLSKN6.js";import"./chunks/chunk-N7HIJNJH.js";import"./chunks/chunk-BVV3IA5W.js";import"./chunks/chunk-BHE66SP3.js";import"./chunks/chunk-UNRHTOT5.js";import"./chunks/chunk-77PNP27P.js";import"./chunks/chunk-ONUPGMER.js";export{i as SessionReadError,p as appendClientNotice,C as archiveSession,n as compactSession,R as createSessionManager,H as deleteSession,l as exportSessionBundle,s as extractHistorySeedsFromMessage,e as extractHistorySeedsFromMessages,u as forkSession,m as listRunningSessions,t as listSessions,a as loadFullTranscript,r as loadSession,d as readConversationHistory,S as readFullTranscript,o as restoreHistoryItemsFromSession,y as rewindSession,c as setActiveEntry,T as unarchiveSession,x as watchSessions};

package/dist/sdk-skills.d.ts

@@ -1,333 +1,2 @@
-import { R as ResolvedSkillSource, c as Skill, f as SkillFile, S as SkillMetadata, g as SkillFrontmatter, j as SkillPathsConfig, b as IVariableResolver, e as SkillContext, I as ISkillRegistry, k as SkillResult } from './types-chunks/types.d-BEMcUOng.js';
-export { d as SkillArtifact, a as SkillDynamicContextExecutor, h as SkillHook, i as SkillHooks, l as SkillSource, m as getDefaultSkillPaths, n as getSkillPathsFlat } from './types-chunks/types.d-BEMcUOng.js';
-
-declare function registerPluginSkillPath(skillPath: string): () => void;
-declare function unregisterPluginSkillPath(skillPath: string): boolean;
-declare function listPluginSkillPaths(): string[];
-declare function clearPluginSkillPaths(): void;
-
-/**
- * Skill Loader - YAML Frontmatter Parsing and Skill Loading
- *
- * Parses SKILL.md files with YAML frontmatter and loads skill content.
- * Implements fallback sanitization for non-standard YAML formats.
- */
-
-/**
- * Parse SKILL.md file with YAML frontmatter
- */
-declare function parseSkillMarkdown(content: string): {
-    frontmatter: SkillFrontmatter;
-    body: string;
-};
-/**
- * Load skill metadata from SKILL.md file
- */
-declare function loadSkillMetadata(skillDir: string, source: ResolvedSkillSource): Promise<SkillMetadata | null>;
-/**
- * Load full skill content
- */
-declare function loadFullSkill(skillDir: string, source: ResolvedSkillSource): Promise<Skill | null>;
-/**
- * Load a specific support file's content
- */
-declare function loadSkillFileContent(file: SkillFile): Promise<string>;
-
-/**
- * Skill Discovery - Multi-path skill scanning
- *
- * Discovers skills from multiple paths with priority handling.
- * Supports nested directory discovery for monorepos.
- */
-
-/**
- * Result of skill discovery
- */
-interface DiscoveryResult {
-    skills: Map<string, SkillMetadata>;
-    errors: Array<{
-        path: string;
-        error: string;
-    }>;
-}
-/**
- * Discover all skills from configured paths
- */
-declare function discoverSkills(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): Promise<DiscoveryResult>;
-/**
- * Get nested skill paths for monorepo support
- * When in a subdirectory, also check parent directories for skills
- */
-declare function getNestedSkillPaths(currentDir: string, projectRoot: string): string[];
-/**
- * Discover skills with monorepo support
- */
-declare function discoverSkillsWithMonorepo(currentDir: string, projectRoot: string): Promise<DiscoveryResult>;
-
-/**
- * Skill Resolver - Variable Replacement System
- *
- * Handles variable replacement in skill content:
- * - $ARGUMENTS - All arguments
- * - $0, $1, $2... - Positional arguments
- * - ${VAR_NAME} - Environment variables
- * - !`command` - Dynamic context injection
- */
-
-/**
- * Split arguments string into positional arguments
- * Handles quoted strings correctly
- */
-declare function parseArguments(args: string): string[];
-/**
- * Variable resolver implementation
- */
-declare class VariableResolver implements IVariableResolver {
-    private context;
-    constructor(context: SkillContext);
-    /**
-     * Resolve all variables in content
-     */
-    resolve(content: string, args: string): Promise<string>;
-    /**
-     * Replace $0, $1, $2... with positional arguments
-     */
-    private resolvePositionalArgs;
-    /**
-     * Replace $ARGUMENTS with all arguments
-     */
-    private resolveArguments;
-    /**
-     * Replace ${VAR_NAME} with environment variables
-     */
-    private resolveEnvVars;
-    /**
-     * Replace !`command` with command output (dynamic context).
-     *
-     * Three-tier dispatch (v0.7.42):
-     *   1. `context.disableDynamicContext === true` → throw immediately,
-     *      surfaced to the LLM as `[Error: …]`. Host-level kill switch.
-     *   2. `context.executeDynamicContext` provided → route there. Embedder
-     *      mediates shell execution (broker, audit, deny).
-     *   3. else → legacy built-in path (`isSafeDynamicContextCommand`
-     *      whitelist + `execSync` with 5s timeout).
-     *
-     * The resolver inlines an `[Error: …]` placeholder for any thrown
-     * exception so a single bad token doesn't poison the whole skill load.
-     */
-    private resolveDynamicContext;
-    /**
-     * Execute a dynamic context command via the appropriate dispatch tier.
-     * See `resolveDynamicContext` JSDoc for the 3-tier ordering rationale.
-     */
-    private executeDynamicCommand;
-}
-/**
- * Create a variable resolver for a given context
- */
-declare function createResolver(context: SkillContext): IVariableResolver;
-/**
- * Resolve skill content with arguments and context
- */
-declare function resolveSkillContent(content: string, args: string, context: SkillContext): Promise<string>;
-
-/**
- * Skill Registry - Progressive Disclosure and Skill Management
- *
- * Manages skill discovery, loading, and invocation with progressive disclosure:
- * - Level 1: Metadata preloaded at startup (name, description)
- * - Level 2: Full content loaded on invoke
- * - Level 3: Support files loaded on demand
- */
-
-/**
- * Skill Registry implementation
- */
-declare class SkillRegistry implements ISkillRegistry {
-    private readonly skillsByName;
-    private readonly fullSkillsByName;
-    private readonly projectRoot?;
-    private readonly customPaths?;
-    constructor(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>);
-    /**
-     * Discover skills from all configured paths
-     */
-    discover(): Promise<void>;
-    /**
-     * Get skill metadata by name
-     */
-    get skills(): ReadonlyMap<string, SkillMetadata>;
-    /**
-     * Get skill metadata by name
-     */
-    get(name: string): SkillMetadata | undefined;
-    /**
-     * Load full skill content
-     */
-    loadFull(name: string): Promise<Skill>;
-    /**
-     * Invoke a skill with arguments
-     */
-    invoke(name: string, args: string, context: SkillContext): Promise<SkillResult>;
-    /**
-     * Reload skills from disk
-     */
-    reload(): Promise<void>;
-    /**
-     * List all available skills
-     */
-    list(): SkillMetadata[];
-    /**
-     * List user-invocable skills (for / menu)
-     */
-    listUserInvocable(): SkillMetadata[];
-    /**
-     * Get skills formatted for system prompt injection.
-     *
-     * FEATURE_143 (v0.7.36): manifest wording hardened toward Claude
-     * Code-style strong constraints. The previous wording ("when a user
-     * request matches a skill description, use read to load the skill")
-     * was too soft — the LLM treated skill invocation as one option among
-     * many and frequently authored its own answer instead of loading the
-     * SKILL.md instructions. Aligns with the
-     * `c:/Works/claudecode/src/tools/SkillTool/prompt.ts` ruleset:
-     * BLOCKING REQUIREMENT to load the relevant skill BEFORE generating
-     * any other response when a skill matches.
-     *
-     * Filters out skills with disableModelInvocation=true (Issue 056).
-     */
-    getSystemPromptSnippet(): string;
-    /**
-     * Check if a name is a valid skill
-     */
-    has(name: string): boolean;
-    /**
-     * Get the count of discovered skills
-     */
-    get size(): number;
-}
-/**
- * Get the global skill registry instance
- *
- * IMPORTANT: If projectRoot is undefined, returns existing instance without reset.
- * This prevents accidental singleton reset when called without arguments.
- */
-declare function getSkillRegistry(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): SkillRegistry;
-/**
- * Initialize the skill registry and discover skills
- */
-declare function initializeSkillRegistry(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): Promise<SkillRegistry>;
-/**
- * Reset the global registry (for testing or hot reload)
- */
-declare function resetSkillRegistry(): void;
-
-/**
- * Skill Executor - Execution Engine
- *
- * Handles skill execution with support for:
- * - Inline execution (default)
- * - Fork execution (sub-agent)
- * - Tool restrictions
- */
-
-/**
- * Execution mode
- */
-type ExecutionMode = 'inline' | 'fork';
-/**
- * Execution options
- */
-interface ExecutionOptions {
-    /** Force a specific execution mode */
-    mode?: ExecutionMode;
-    /** Override model */
-    model?: string;
-    /** Override agent type (for fork mode) */
-    agent?: string;
-    /** Override allowed tools */
-    allowedTools?: string[];
-    /** Callback for inline execution */
-    onExecute?: (content: string, skill: Skill) => Promise<string>;
-}
-/**
- * Skill executor class
- */
-declare class SkillExecutor {
-    private context;
-    constructor(context: SkillContext);
-    /**
-     * Execute a skill
-     */
-    execute(skillName: string, args: string, options?: ExecutionOptions): Promise<SkillResult>;
-    /**
-     * Execute skill inline (in current context)
-     */
-    private executeInline;
-    /**
-     * Execute skill in fork mode (sub-agent)
-     */
-    private executeFork;
-    /**
-     * Build the execution prompt
-     */
-    private buildPrompt;
-    /**
-     * Parse allowed tools string into array
-     */
-    private parseAllowedTools;
-}
-/**
- * Create a skill executor
- */
-declare function createExecutor(context: SkillContext): SkillExecutor;
-/**
- * Execute a skill with default context
- */
-declare function executeSkill(skillName: string, args: string, context: SkillContext, options?: ExecutionOptions): Promise<SkillResult>;
-
-/**
- * Skill Expander - Expand skill commands for LLM context injection
- *
- * Takes a skill invocation and produces content that can be injected
- * into the user message for LLM execution.
- *
- * Design based on pi-mono's _expandSkillCommand:
- * - Wraps content in XML blocks for clear context
- * - Includes skill metadata (name, location)
- * - Resolves all variables ($ARGUMENTS, $0, etc.)
- * - Handles dynamic context (!`command`)
- */
-
-/**
- * Result of skill expansion
- */
-interface SkillExpansionResult {
-    /** The expanded skill content ready for LLM injection */
-    content: string;
-    /** Whether the skill has model invocation disabled */
-    disableModelInvocation: boolean;
-    /** Original skill metadata */
-    skill: Skill;
-}
-/**
- * Expand a skill into LLM-ready content
- *
- * This function:
- * 1. Resolves all variables in the skill content ($ARGUMENTS, $0, $1, etc.)
- * 2. Executes dynamic context commands (!`command`)
- * 3. Wraps the content in an XML block for clear context boundaries
- *
- * @param skill - The full skill object with content
- * @param args - Raw arguments string from user input
- * @param context - Execution context (working directory, session ID, etc.)
- * @returns Expansion result with content ready for LLM injection
- */
-declare function expandSkillForLLM(skill: Skill, args: string, context: SkillContext): Promise<SkillExpansionResult>;
-/**
- * Format skill activation message for user display
- */
-declare function formatSkillActivationMessage(skillName: string, args: string): string;
-
-export { ISkillRegistry, IVariableResolver, ResolvedSkillSource, Skill, SkillContext, SkillExecutor, SkillFile, SkillFrontmatter, SkillMetadata, SkillPathsConfig, SkillRegistry, SkillResult, VariableResolver, clearPluginSkillPaths, createExecutor, createResolver, discoverSkills, discoverSkillsWithMonorepo, executeSkill, expandSkillForLLM, formatSkillActivationMessage, getNestedSkillPaths, getSkillRegistry, initializeSkillRegistry, listPluginSkillPaths, loadFullSkill, loadSkillFileContent, loadSkillMetadata, parseArguments, parseSkillMarkdown, registerPluginSkillPath, resetSkillRegistry, resolveSkillContent, unregisterPluginSkillPath };
-export type { DiscoveryResult, ExecutionMode, ExecutionOptions, SkillExpansionResult };
+export { I as ISkillRegistry, c as IVariableResolver, R as ResolvedSkillSource, d as Skill, e as SkillArtifact, b as SkillContext, a as SkillDynamicContextExecutor, f as SkillFile, g as SkillFrontmatter, h as SkillHook, i as SkillHooks, S as SkillMetadata, j as SkillPathsConfig, k as SkillResult, l as SkillSource, m as getDefaultSkillPaths, n as getSkillPathsFlat } from './types-chunks/types.d-ssh6zRaf.js';
+export { D as DiscoveryResult, E as ExecutionMode, a as ExecutionOptions, S as SkillExecutor, b as SkillExpansionResult, c as SkillRegistry, V as VariableResolver, d as clearPluginSkillPaths, e as createExecutor, f as createResolver, g as discoverSkills, h as discoverSkillsWithMonorepo, i as executeSkill, j as expandSkillForLLM, k as formatSkillActivationMessage, m as getNestedSkillPaths, n as getSkillRegistry, o as initializeSkillRegistry, p as listPluginSkillPaths, q as loadFullSkill, r as loadSkillFileContent, s as loadSkillMetadata, t as parseArguments, u as parseSkillMarkdown, v as registerPluginSkillPath, w as resetSkillRegistry, x as resolveSkillContent, y as unregisterPluginSkillPath } from './types-chunks/sdk-skills-Bg1yL4i4.js';

package/dist/sdk-skills.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Ad as g,Bd as u,Cd as c,Dd as d,Ed as x,Fd as P,Gd as R,Hd as h,Id as p,Jd as v,Kd as y,Ld as M,Md as f,Nd as m,Od as E,gc as l,hc as e,ic as i,jc as t,kc as o,lc as a,pc as k,qc as r,rc as S,sc as s,zd as n}from"./chunks/chunk-7XSZVOG7.js";import"./chunks/chunk-QFV6YCIH.js";import"./chunks/chunk-ONUPGMER.js";export{y as SkillExecutor,R as SkillRegistry,d as VariableResolver,t as clearPluginSkillPaths,M as createExecutor,x as createResolver,n as discoverSkills,u as discoverSkillsWithMonorepo,f as executeSkill,m as expandSkillForLLM,E as formatSkillActivationMessage,o as getDefaultSkillPaths,g as getNestedSkillPaths,a as getSkillPathsFlat,h as getSkillRegistry,p as initializeSkillRegistry,i as listPluginSkillPaths,S as loadFullSkill,s as loadSkillFileContent,r as loadSkillMetadata,c as parseArguments,k as parseSkillMarkdown,l as registerPluginSkillPath,v as resetSkillRegistry,P as resolveSkillContent,e as unregisterPluginSkillPath};
+import{Ad as g,Bd as u,Cd as c,Dd as d,Ed as x,Fd as P,Hd as R,Id as h,Jd as p,Kd as v,Ld as y,Md as M,Nd as f,Od as m,Pd as E,gc as l,hc as e,ic as i,jc as t,kc as o,lc as a,pc as k,qc as r,rc as S,sc as s,zd as n}from"./chunks/chunk-UNRHTOT5.js";import"./chunks/chunk-77PNP27P.js";import"./chunks/chunk-ONUPGMER.js";export{y as SkillExecutor,R as SkillRegistry,d as VariableResolver,t as clearPluginSkillPaths,M as createExecutor,x as createResolver,n as discoverSkills,u as discoverSkillsWithMonorepo,f as executeSkill,m as expandSkillForLLM,E as formatSkillActivationMessage,o as getDefaultSkillPaths,g as getNestedSkillPaths,a as getSkillPathsFlat,h as getSkillRegistry,p as initializeSkillRegistry,i as listPluginSkillPaths,S as loadFullSkill,s as loadSkillFileContent,r as loadSkillMetadata,c as parseArguments,k as parseSkillMarkdown,l as registerPluginSkillPath,v as resetSkillRegistry,P as resolveSkillContent,e as unregisterPluginSkillPath};