@opencow-ai/opencow-agent-sdk 0.4.21 → 0.4.23

package/dist/entrypoints/sdk/coreSchemas.d.ts

@@ -32,14 +32,14 @@ export declare const OutputFormatSchema: () => z.ZodObject<{
 export declare const ApiKeySourceSchema: () => z.ZodEnum<{
     user: "user";
     project: "project";
+    oauth: "oauth";
     org: "org";
     temporary: "temporary";
-    oauth: "oauth";
 }>;
 export declare const ConfigScopeSchema: () => z.ZodEnum<{
+    local: "local";
     user: "user";
     project: "project";
-    local: "local";
 }>;
 export declare const SdkBetaSchema: () => z.ZodLiteral<"context-1m-2025-08-07">;
 export declare const ThinkingAdaptiveSchema: () => z.ZodObject<{
@@ -126,11 +126,11 @@ export declare const McpServerStatusConfigSchema: () => z.ZodUnion<readonly [z.Z
 export declare const McpServerStatusSchema: () => z.ZodObject<{
     name: z.ZodString;
     status: z.ZodEnum<{
+        pending: "pending";
         disabled: "disabled";
         connected: "connected";
         failed: "failed";
         "needs-auth": "needs-auth";
-        pending: "pending";
     }>;
     serverInfo: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
@@ -253,8 +253,8 @@ export declare const PermissionUpdateSchema: () => z.ZodDiscriminatedUnion<[z.Zo
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>>;
     destination: z.ZodEnum<{
         userSettings: "userSettings";
@@ -352,8 +352,8 @@ export declare const PermissionResultSchema: () => z.ZodUnion<readonly [z.ZodObj
             default: "default";
             acceptEdits: "acceptEdits";
             bypassPermissions: "bypassPermissions";
-            plan: "plan";
             dontAsk: "dontAsk";
+            plan: "plan";
         }>>;
         destination: z.ZodEnum<{
             userSettings: "userSettings";
@@ -404,8 +404,8 @@ export declare const PermissionModeSchema: () => z.ZodEnum<{
     default: "default";
     acceptEdits: "acceptEdits";
     bypassPermissions: "bypassPermissions";
-    plan: "plan";
     dontAsk: "dontAsk";
+    plan: "plan";
 }>;
 export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "PermissionDenied", "Setup", "TeammateIdle", "TaskCreated", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded", "CwdChanged", "FileChanged"];
 export declare const HookEventSchema: () => z.ZodEnum<{
@@ -529,8 +529,8 @@ export declare const PermissionRequestHookInputSchema: () => z.ZodIntersection<z
             default: "default";
             acceptEdits: "acceptEdits";
             bypassPermissions: "bypassPermissions";
-            plan: "plan";
             dontAsk: "dontAsk";
+            plan: "plan";
         }>>;
         destination: z.ZodEnum<{
             userSettings: "userSettings";
@@ -638,9 +638,9 @@ export declare const SessionStartHookInputSchema: () => z.ZodIntersection<z.ZodO
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"SessionStart">;
     source: z.ZodEnum<{
-        startup: "startup";
-        resume: "resume";
         clear: "clear";
+        resume: "resume";
+        startup: "startup";
         compact: "compact";
     }>;
     agent_type: z.ZodOptional<z.ZodString>;
@@ -683,9 +683,9 @@ export declare const StopFailureHookInputSchema: () => z.ZodIntersection<z.ZodOb
     hook_event_name: z.ZodLiteral<"StopFailure">;
     error: z.ZodEnum<{
         unknown: "unknown";
+        rate_limit: "rate_limit";
         authentication_failed: "authentication_failed";
         billing_error: "billing_error";
-        rate_limit: "rate_limit";
         invalid_request: "invalid_request";
         server_error: "server_error";
         max_output_tokens: "max_output_tokens";
@@ -722,8 +722,8 @@ export declare const SubagentStopHookInputSchema: () => z.ZodIntersection<z.ZodO
     agent_type: z.ZodString;
     last_assistant_message: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
-        failed: "failed";
         completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>>;
     error_message: z.ZodOptional<z.ZodString>;
@@ -738,8 +738,8 @@ export declare const PreCompactHookInputSchema: () => z.ZodIntersection<z.ZodObj
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"PreCompact">;
     trigger: z.ZodEnum<{
-        manual: "manual";
         auto: "auto";
+        manual: "manual";
     }>;
     custom_instructions: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>>;
@@ -753,8 +753,8 @@ export declare const PostCompactHookInputSchema: () => z.ZodIntersection<z.ZodOb
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"PostCompact">;
     trigger: z.ZodEnum<{
-        manual: "manual";
         auto: "auto";
+        manual: "manual";
     }>;
     compact_summary: z.ZodString;
 }, z.core.$strip>>;
@@ -852,11 +852,11 @@ export declare const ConfigChangeHookInputSchema: () => z.ZodIntersection<z.ZodO
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"ConfigChange">;
     source: z.ZodEnum<{
+        skills: "skills";
         user_settings: "user_settings";
         project_settings: "project_settings";
         local_settings: "local_settings";
         policy_settings: "policy_settings";
-        skills: "skills";
     }>;
     file_path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;
@@ -941,14 +941,14 @@ export declare const FileChangedHookInputSchema: () => z.ZodIntersection<z.ZodOb
 }, z.core.$strip>>;
 export declare const EXIT_REASONS: readonly ["clear", "resume", "logout", "prompt_input_exit", "bypass_permissions_disabled", "normal", "aborted", "error", "other"];
 export declare const ExitReasonSchema: () => z.ZodEnum<{
-    error: "error";
-    resume: "resume";
     clear: "clear";
+    resume: "resume";
     logout: "logout";
     prompt_input_exit: "prompt_input_exit";
     bypass_permissions_disabled: "bypass_permissions_disabled";
     normal: "normal";
     aborted: "aborted";
+    error: "error";
     other: "other";
 }>;
 export declare const SessionEndHookInputSchema: () => z.ZodIntersection<z.ZodObject<{
@@ -961,14 +961,14 @@ export declare const SessionEndHookInputSchema: () => z.ZodIntersection<z.ZodObj
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"SessionEnd">;
     reason: z.ZodEnum<{
-        error: "error";
-        resume: "resume";
         clear: "clear";
+        resume: "resume";
         logout: "logout";
         prompt_input_exit: "prompt_input_exit";
         bypass_permissions_disabled: "bypass_permissions_disabled";
         normal: "normal";
         aborted: "aborted";
+        error: "error";
         other: "other";
     }>;
 }, z.core.$strip>>;
@@ -1056,9 +1056,9 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"SessionStart">;
     source: z.ZodEnum<{
-        startup: "startup";
-        resume: "resume";
         clear: "clear";
+        resume: "resume";
+        startup: "startup";
         compact: "compact";
     }>;
     agent_type: z.ZodOptional<z.ZodString>;
@@ -1073,14 +1073,14 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"SessionEnd">;
     reason: z.ZodEnum<{
-        error: "error";
-        resume: "resume";
         clear: "clear";
+        resume: "resume";
         logout: "logout";
         prompt_input_exit: "prompt_input_exit";
         bypass_permissions_disabled: "bypass_permissions_disabled";
         normal: "normal";
         aborted: "aborted";
+        error: "error";
         other: "other";
     }>;
 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
@@ -1105,9 +1105,9 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
     hook_event_name: z.ZodLiteral<"StopFailure">;
     error: z.ZodEnum<{
         unknown: "unknown";
+        rate_limit: "rate_limit";
         authentication_failed: "authentication_failed";
         billing_error: "billing_error";
-        rate_limit: "rate_limit";
         invalid_request: "invalid_request";
         server_error: "server_error";
         max_output_tokens: "max_output_tokens";
@@ -1142,8 +1142,8 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
     agent_type: z.ZodString;
     last_assistant_message: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
-        failed: "failed";
         completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>>;
     error_message: z.ZodOptional<z.ZodString>;
@@ -1157,8 +1157,8 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"PreCompact">;
     trigger: z.ZodEnum<{
-        manual: "manual";
         auto: "auto";
+        manual: "manual";
     }>;
     custom_instructions: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
@@ -1171,8 +1171,8 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"PostCompact">;
     trigger: z.ZodEnum<{
-        manual: "manual";
         auto: "auto";
+        manual: "manual";
     }>;
     compact_summary: z.ZodString;
 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
@@ -1246,8 +1246,8 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
             default: "default";
             acceptEdits: "acceptEdits";
             bypassPermissions: "bypassPermissions";
-            plan: "plan";
             dontAsk: "dontAsk";
+            plan: "plan";
         }>>;
         destination: z.ZodEnum<{
             userSettings: "userSettings";
@@ -1378,11 +1378,11 @@ export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersecti
 }, z.core.$strip>, z.ZodObject<{
     hook_event_name: z.ZodLiteral<"ConfigChange">;
     source: z.ZodEnum<{
+        skills: "skills";
         user_settings: "user_settings";
         project_settings: "project_settings";
         local_settings: "local_settings";
         policy_settings: "policy_settings";
-        skills: "skills";
     }>;
     file_path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
@@ -1573,8 +1573,8 @@ export declare const PermissionRequestHookSpecificOutputSchema: () => z.ZodObjec
                 default: "default";
                 acceptEdits: "acceptEdits";
                 bypassPermissions: "bypassPermissions";
-                plan: "plan";
                 dontAsk: "dontAsk";
+                plan: "plan";
             }>>;
             destination: z.ZodEnum<{
                 userSettings: "userSettings";
@@ -1730,8 +1730,8 @@ export declare const SyncHookJSONOutputSchema: () => z.ZodObject<{
                     default: "default";
                     acceptEdits: "acceptEdits";
                     bypassPermissions: "bypassPermissions";
-                    plan: "plan";
                     dontAsk: "dontAsk";
+                    plan: "plan";
                 }>>;
                 destination: z.ZodEnum<{
                     userSettings: "userSettings";
@@ -1930,8 +1930,8 @@ export declare const HookJSONOutputSchema: () => z.ZodUnion<readonly [z.ZodObjec
                     default: "default";
                     acceptEdits: "acceptEdits";
                     bypassPermissions: "bypassPermissions";
-                    plan: "plan";
                     dontAsk: "dontAsk";
+                    plan: "plan";
                 }>>;
                 destination: z.ZodEnum<{
                     userSettings: "userSettings";
@@ -2095,9 +2095,9 @@ export declare const AgentDefinitionSchema: () => z.ZodObject<{
     maxTurns: z.ZodOptional<z.ZodNumber>;
     background: z.ZodOptional<z.ZodBoolean>;
     memory: z.ZodOptional<z.ZodEnum<{
+        local: "local";
         user: "user";
         project: "project";
-        local: "local";
     }>>;
     effort: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
         low: "low";
@@ -2109,14 +2109,14 @@ export declare const AgentDefinitionSchema: () => z.ZodObject<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>>;
 }, z.core.$strip>;
 export declare const SettingSourceSchema: () => z.ZodEnum<{
+    local: "local";
     user: "user";
     project: "project";
-    local: "local";
 }>;
 export declare const SdkPluginConfigSchema: () => z.ZodObject<{
     type: z.ZodLiteral<"local">;
@@ -2141,9 +2141,9 @@ export declare const UUIDPlaceholder: () => z.ZodString;
 export declare const NonNullableUsagePlaceholder: () => z.ZodUnknown;
 export declare const SDKAssistantMessageErrorSchema: () => z.ZodEnum<{
     unknown: "unknown";
+    rate_limit: "rate_limit";
     authentication_failed: "authentication_failed";
     billing_error: "billing_error";
-    rate_limit: "rate_limit";
     invalid_request: "invalid_request";
     server_error: "server_error";
     max_output_tokens: "max_output_tokens";
@@ -2183,8 +2183,8 @@ export declare const SDKUserMessageReplaySchema: () => z.ZodObject<{
 export declare const SDKRateLimitInfoSchema: () => z.ZodObject<{
     status: z.ZodEnum<{
         allowed: "allowed";
-        allowed_warning: "allowed_warning";
         rejected: "rejected";
+        allowed_warning: "allowed_warning";
     }>;
     resetsAt: z.ZodOptional<z.ZodNumber>;
     rateLimitType: z.ZodOptional<z.ZodEnum<{
@@ -2197,8 +2197,8 @@ export declare const SDKRateLimitInfoSchema: () => z.ZodObject<{
     utilization: z.ZodOptional<z.ZodNumber>;
     overageStatus: z.ZodOptional<z.ZodEnum<{
         allowed: "allowed";
-        allowed_warning: "allowed_warning";
         rejected: "rejected";
+        allowed_warning: "allowed_warning";
     }>>;
     overageResetsAt: z.ZodOptional<z.ZodNumber>;
     overageDisabledReason: z.ZodOptional<z.ZodEnum<{
@@ -2225,9 +2225,9 @@ export declare const SDKAssistantMessageSchema: () => z.ZodObject<{
     parent_tool_use_id: z.ZodNullable<z.ZodString>;
     error: z.ZodOptional<z.ZodEnum<{
         unknown: "unknown";
+        rate_limit: "rate_limit";
         authentication_failed: "authentication_failed";
         billing_error: "billing_error";
-        rate_limit: "rate_limit";
         invalid_request: "invalid_request";
         server_error: "server_error";
         max_output_tokens: "max_output_tokens";
@@ -2240,8 +2240,8 @@ export declare const SDKRateLimitEventSchema: () => z.ZodObject<{
     rate_limit_info: z.ZodObject<{
         status: z.ZodEnum<{
             allowed: "allowed";
-            allowed_warning: "allowed_warning";
             rejected: "rejected";
+            allowed_warning: "allowed_warning";
         }>;
         resetsAt: z.ZodOptional<z.ZodNumber>;
         rateLimitType: z.ZodOptional<z.ZodEnum<{
@@ -2254,8 +2254,8 @@ export declare const SDKRateLimitEventSchema: () => z.ZodObject<{
         utilization: z.ZodOptional<z.ZodNumber>;
         overageStatus: z.ZodOptional<z.ZodEnum<{
             allowed: "allowed";
-            allowed_warning: "allowed_warning";
             rejected: "rejected";
+            allowed_warning: "allowed_warning";
         }>>;
         overageResetsAt: z.ZodOptional<z.ZodNumber>;
         overageDisabledReason: z.ZodOptional<z.ZodEnum<{
@@ -2450,9 +2450,9 @@ export declare const SDKSystemMessageSchema: () => z.ZodObject<{
     apiKeySource: z.ZodEnum<{
         user: "user";
         project: "project";
+        oauth: "oauth";
         org: "org";
         temporary: "temporary";
-        oauth: "oauth";
     }>;
     betas: z.ZodOptional<z.ZodArray<z.ZodString>>;
     claude_code_version: z.ZodString;
@@ -2467,8 +2467,8 @@ export declare const SDKSystemMessageSchema: () => z.ZodObject<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>;
     slash_commands: z.ZodArray<z.ZodString>;
     output_style: z.ZodString;
@@ -2498,8 +2498,8 @@ export declare const SDKCompactBoundaryMessageSchema: () => z.ZodObject<{
     subtype: z.ZodLiteral<"compact_boundary">;
     compact_metadata: z.ZodObject<{
         trigger: z.ZodEnum<{
-            manual: "manual";
             auto: "auto";
+            manual: "manual";
         }>;
         pre_tokens: z.ZodNumber;
         post_tokens: z.ZodOptional<z.ZodNumber>;
@@ -2520,8 +2520,8 @@ export declare const SDKStatusMessageSchema: () => z.ZodObject<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>>;
     uuid: z.ZodString;
     session_id: z.ZodString;
@@ -2531,10 +2531,10 @@ export declare const SDKPostTurnSummaryMessageSchema: () => z.ZodObject<{
     subtype: z.ZodLiteral<"post_turn_summary">;
     summarizes_uuid: z.ZodString;
     status_category: z.ZodEnum<{
-        failed: "failed";
         completed: "completed";
-        blocked: "blocked";
         waiting: "waiting";
+        failed: "failed";
+        blocked: "blocked";
         review_ready: "review_ready";
     }>;
     status_detail: z.ZodString;
@@ -2556,9 +2556,9 @@ export declare const SDKAPIRetryMessageSchema: () => z.ZodObject<{
     error_status: z.ZodNullable<z.ZodNumber>;
     error: z.ZodEnum<{
         unknown: "unknown";
+        rate_limit: "rate_limit";
         authentication_failed: "authentication_failed";
         billing_error: "billing_error";
-        rate_limit: "rate_limit";
         invalid_request: "invalid_request";
         server_error: "server_error";
         max_output_tokens: "max_output_tokens";
@@ -2651,8 +2651,8 @@ export declare const SDKTaskNotificationMessageSchema: () => z.ZodObject<{
     task_id: z.ZodString;
     tool_use_id: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
-        failed: "failed";
         completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>;
     output_file: z.ZodString;
@@ -2744,9 +2744,9 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
     parent_tool_use_id: z.ZodNullable<z.ZodString>;
     error: z.ZodOptional<z.ZodEnum<{
         unknown: "unknown";
+        rate_limit: "rate_limit";
         authentication_failed: "authentication_failed";
         billing_error: "billing_error";
-        rate_limit: "rate_limit";
         invalid_request: "invalid_request";
         server_error: "server_error";
         max_output_tokens: "max_output_tokens";
@@ -2861,9 +2861,9 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
     apiKeySource: z.ZodEnum<{
         user: "user";
         project: "project";
+        oauth: "oauth";
         org: "org";
         temporary: "temporary";
-        oauth: "oauth";
     }>;
     betas: z.ZodOptional<z.ZodArray<z.ZodString>>;
     claude_code_version: z.ZodString;
@@ -2878,8 +2878,8 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>;
     slash_commands: z.ZodArray<z.ZodString>;
     output_style: z.ZodString;
@@ -2907,8 +2907,8 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
     subtype: z.ZodLiteral<"compact_boundary">;
     compact_metadata: z.ZodObject<{
         trigger: z.ZodEnum<{
-            manual: "manual";
             auto: "auto";
+            manual: "manual";
         }>;
         pre_tokens: z.ZodNumber;
         post_tokens: z.ZodOptional<z.ZodNumber>;
@@ -2928,8 +2928,8 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
     }>>;
     uuid: z.ZodString;
     session_id: z.ZodString;
@@ -2942,9 +2942,9 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
     error_status: z.ZodNullable<z.ZodNumber>;
     error: z.ZodEnum<{
         unknown: "unknown";
+        rate_limit: "rate_limit";
         authentication_failed: "authentication_failed";
         billing_error: "billing_error";
-        rate_limit: "rate_limit";
         invalid_request: "invalid_request";
         server_error: "server_error";
         max_output_tokens: "max_output_tokens";
@@ -3015,8 +3015,8 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
     task_id: z.ZodString;
     tool_use_id: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
-        failed: "failed";
         completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>;
     output_file: z.ZodString;
@@ -3089,8 +3089,8 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
     rate_limit_info: z.ZodObject<{
         status: z.ZodEnum<{
             allowed: "allowed";
-            allowed_warning: "allowed_warning";
             rejected: "rejected";
+            allowed_warning: "allowed_warning";
         }>;
         resetsAt: z.ZodOptional<z.ZodNumber>;
         rateLimitType: z.ZodOptional<z.ZodEnum<{
@@ -3103,8 +3103,8 @@ export declare const SDKMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<{
         utilization: z.ZodOptional<z.ZodNumber>;
         overageStatus: z.ZodOptional<z.ZodEnum<{
             allowed: "allowed";
-            allowed_warning: "allowed_warning";
             rejected: "rejected";
+            allowed_warning: "allowed_warning";
         }>>;
         overageResetsAt: z.ZodOptional<z.ZodNumber>;
         overageDisabledReason: z.ZodOptional<z.ZodEnum<{

package/dist/entrypoints/sdk/runtimeTypes.d.ts

@@ -1,7 +1,7 @@
 import type { ChildProcessWithoutNullStreams } from 'node:child_process';
 import type { ModelProviders } from '../../providers/shared/routing.js';
 import type { UploadMediaFn } from '../../types/toolRuntime.js';
-export type { ModelProviders, ModelProviderConfig } from '../../providers/shared/routing.js';
+export type { ModelProviders, ModelProviderConfig, } from '../../providers/shared/routing.js';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
 import type { z } from 'zod/v4';
@@ -122,6 +122,81 @@ export type SdkMcpToolDefinition<Schema extends AnyZodRawShape = AnyZodRawShape>
 };
 export type SettingSource = 'user' | 'project' | 'local';
 export type BuiltInToolPreset = 'default' | 'none';
+/** A Claude-compatible plugin directory loaded explicitly by the host. */
+export type SdkLocalPlugin = {
+    type: 'local';
+    path: string;
+};
+export type SdkPluginComponentKind = 'skill' | 'command' | 'agent' | 'hook' | 'mcp' | 'lsp' | 'output-style' | 'monitor';
+export type SdkPluginPermissionGrant = {
+    /** Import-time plugin identity approved by the host. */
+    contentHash: string;
+    approved: boolean;
+    grantedAt?: string;
+    /** Approved process commands declared by hooks, MCP, and LSP components. */
+    process?: readonly string[];
+    /** Approved HTTP(S) origins declared by plugin runtime components. */
+    network?: readonly string[];
+    /** Approved environment variable names referenced by runtime components. */
+    environment?: readonly string[];
+    /** Approved writable roots. Managed plugins must include their dataPath. */
+    writableDirectories?: readonly string[];
+};
+export type SdkManagedPlugin = {
+    id: string;
+    source: SdkLocalPlugin;
+    /** Import-time version identity; managed snapshots do not re-hash source.path. */
+    contentHash: string;
+    dataPath: string;
+    permissionGrant: SdkPluginPermissionGrant;
+};
+export type SdkPluginSnapshot = {
+    revision: string;
+    plugins: readonly SdkManagedPlugin[];
+};
+export type SdkPluginDiagnostic = {
+    severity: 'warning' | 'error';
+    code: string;
+    message: string;
+    pluginId?: string;
+    componentKind?: SdkPluginComponentKind;
+    componentName?: string;
+};
+export type SdkPluginComponentCounts = Record<SdkPluginComponentKind, number>;
+export type SdkPluginCommandCatalogEntry = {
+    runtimeId: string;
+    pluginId: string;
+    componentKind: 'command' | 'skill';
+    name: string;
+    /** Runtime-only user-facing name resolved from the loaded component. */
+    displayName?: string;
+    description: string;
+    argumentHint?: string;
+    sourcePath?: string;
+};
+export type SdkPluginAgentCatalogEntry = {
+    runtimeId: string;
+    pluginId: string;
+    name: string;
+    description: string;
+    sourcePath?: string;
+};
+export type SdkPluginApplyResult = {
+    status: 'applied' | 'unchanged' | 'rejected';
+    requestedRevision: string;
+    appliedRevision: string | null;
+    componentCounts: SdkPluginComponentCounts;
+    commandCatalog: readonly SdkPluginCommandCatalogEntry[];
+    agentCatalog: readonly SdkPluginAgentCatalogEntry[];
+    diagnostics: readonly SdkPluginDiagnostic[];
+};
+export type SdkPluginState = {
+    appliedRevision: string | null;
+    componentCounts: SdkPluginComponentCounts;
+    commandCatalog: readonly SdkPluginCommandCatalogEntry[];
+    agentCatalog: readonly SdkPluginAgentCatalogEntry[];
+    diagnostics: readonly SdkPluginDiagnostic[];
+};
 import type { SdkTool } from '../../capabilities/SdkTool.js';
 import type { LayoutProfile } from '../../session/layout/LayoutProfile.js';
 import type { SdkRule } from '../../session/rules/SdkRule.js';
@@ -131,6 +206,8 @@ import type { BrandingOptions } from '../../session/brandingConfig.js';
 export type { BrandingOptions } from '../../session/brandingConfig.js';
 export type Options = {
     cwd?: string;
+    /** Claude-compatible local plugin roots. No settings or marketplace state is read. */
+    plugins?: readonly SdkLocalPlugin[];
     /**
      * Host-controlled product and assistant names.
      *
@@ -521,6 +598,10 @@ export type SDKSession = {
     }): Query;
     prompt(message: string, options?: Options): Promise<SDKResultMessage>;
     getInfo(): Promise<SDKSessionInfo | undefined>;
+    /** Atomically replace this session's managed plugin revision while idle. */
+    applyPluginSnapshot(snapshot: SdkPluginSnapshot): Promise<SdkPluginApplyResult>;
+    /** Read the last successfully applied plugin revision and diagnostics. */
+    getPluginState(): SdkPluginState;
     /**
      * Tear down the session container and fire the SessionEnd hook once.
      *

package/dist/permissions/PermissionMode.d.ts

@@ -5,16 +5,16 @@ export declare const permissionModeSchema: () => z.ZodEnum<{
     default: "default";
     acceptEdits: "acceptEdits";
     bypassPermissions: "bypassPermissions";
-    plan: "plan";
     dontAsk: "dontAsk";
+    plan: "plan";
     auto: "auto";
 }>;
 export declare const externalPermissionModeSchema: () => z.ZodEnum<{
     default: "default";
     acceptEdits: "acceptEdits";
     bypassPermissions: "bypassPermissions";
-    plan: "plan";
     dontAsk: "dontAsk";
+    plan: "plan";
 }>;
 type ModeColorKey = 'text' | 'planMode' | 'permission' | 'autoAccept' | 'error' | 'warning';
 /**

package/dist/permissions/PermissionPromptToolResultSchema.d.ts

@@ -70,8 +70,8 @@ export declare const outputSchema: () => z.ZodUnion<readonly [z.ZodObject<{
             default: "default";
             acceptEdits: "acceptEdits";
             bypassPermissions: "bypassPermissions";
-            plan: "plan";
             dontAsk: "dontAsk";
+            plan: "plan";
         }>;
         destination: z.ZodEnum<{
             userSettings: "userSettings";