@opencow-ai/opencow-agent-sdk 0.4.0 → 0.4.1

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

@@ -549,12 +549,15 @@ export declare const SDKHookCallbackRequestSchema: () => z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         hook_event_name: z.ZodLiteral<"SessionEnd">;
         reason: z.ZodEnum<{
+            error: "error";
             resume: "resume";
             clear: "clear";
             logout: "logout";
             prompt_input_exit: "prompt_input_exit";
-            other: "other";
             bypass_permissions_disabled: "bypass_permissions_disabled";
+            normal: "normal";
+            aborted: "aborted";
+            other: "other";
         }>;
     }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
         session_id: z.ZodString;
@@ -1403,12 +1406,15 @@ export declare const SDKControlRequestInnerSchema: () => z.ZodUnion<readonly [z.
     }, z.core.$strip>, z.ZodObject<{
         hook_event_name: z.ZodLiteral<"SessionEnd">;
         reason: z.ZodEnum<{
+            error: "error";
             resume: "resume";
             clear: "clear";
             logout: "logout";
             prompt_input_exit: "prompt_input_exit";
-            other: "other";
             bypass_permissions_disabled: "bypass_permissions_disabled";
+            normal: "normal";
+            aborted: "aborted";
+            other: "other";
         }>;
     }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
         session_id: z.ZodString;
@@ -2160,12 +2166,15 @@ export declare const SDKControlRequestSchema: () => z.ZodObject<{
         }, z.core.$strip>, z.ZodObject<{
             hook_event_name: z.ZodLiteral<"SessionEnd">;
             reason: z.ZodEnum<{
+                error: "error";
                 resume: "resume";
                 clear: "clear";
                 logout: "logout";
                 prompt_input_exit: "prompt_input_exit";
-                other: "other";
                 bypass_permissions_disabled: "bypass_permissions_disabled";
+                normal: "normal";
+                aborted: "aborted";
+                other: "other";
             }>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
@@ -2927,12 +2936,15 @@ export declare const ControlErrorResponseSchema: () => z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 hook_event_name: z.ZodLiteral<"SessionEnd">;
                 reason: z.ZodEnum<{
+                    error: "error";
                     resume: "resume";
                     clear: "clear";
                     logout: "logout";
                     prompt_input_exit: "prompt_input_exit";
-                    other: "other";
                     bypass_permissions_disabled: "bypass_permissions_disabled";
+                    normal: "normal";
+                    aborted: "aborted";
+                    other: "other";
                 }>;
             }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                 session_id: z.ZodString;
@@ -3696,12 +3708,15 @@ export declare const SDKControlResponseSchema: () => z.ZodObject<{
                 }, z.core.$strip>, z.ZodObject<{
                     hook_event_name: z.ZodLiteral<"SessionEnd">;
                     reason: z.ZodEnum<{
+                        error: "error";
                         resume: "resume";
                         clear: "clear";
                         logout: "logout";
                         prompt_input_exit: "prompt_input_exit";
-                        other: "other";
                         bypass_permissions_disabled: "bypass_permissions_disabled";
+                        normal: "normal";
+                        aborted: "aborted";
+                        other: "other";
                     }>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;
@@ -4907,12 +4922,15 @@ export declare const StdoutMessageSchema: () => z.ZodUnion<readonly [z.ZodUnion<
                 }, z.core.$strip>, z.ZodObject<{
                     hook_event_name: z.ZodLiteral<"SessionEnd">;
                     reason: z.ZodEnum<{
+                        error: "error";
                         resume: "resume";
                         clear: "clear";
                         logout: "logout";
                         prompt_input_exit: "prompt_input_exit";
-                        other: "other";
                         bypass_permissions_disabled: "bypass_permissions_disabled";
+                        normal: "normal";
+                        aborted: "aborted";
+                        other: "other";
                     }>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;
@@ -5666,12 +5684,15 @@ export declare const StdoutMessageSchema: () => z.ZodUnion<readonly [z.ZodUnion<
         }, z.core.$strip>, z.ZodObject<{
             hook_event_name: z.ZodLiteral<"SessionEnd">;
             reason: z.ZodEnum<{
+                error: "error";
                 resume: "resume";
                 clear: "clear";
                 logout: "logout";
                 prompt_input_exit: "prompt_input_exit";
-                other: "other";
                 bypass_permissions_disabled: "bypass_permissions_disabled";
+                normal: "normal";
+                aborted: "aborted";
+                other: "other";
             }>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
@@ -6443,12 +6464,15 @@ export declare const StdinMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<
         }, z.core.$strip>, z.ZodObject<{
             hook_event_name: z.ZodLiteral<"SessionEnd">;
             reason: z.ZodEnum<{
+                error: "error";
                 resume: "resume";
                 clear: "clear";
                 logout: "logout";
                 prompt_input_exit: "prompt_input_exit";
-                other: "other";
                 bypass_permissions_disabled: "bypass_permissions_disabled";
+                normal: "normal";
+                aborted: "aborted";
+                other: "other";
             }>;
         }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
             session_id: z.ZodString;
@@ -7210,12 +7234,15 @@ export declare const StdinMessageSchema: () => z.ZodUnion<readonly [z.ZodObject<
                 }, z.core.$strip>, z.ZodObject<{
                     hook_event_name: z.ZodLiteral<"SessionEnd">;
                     reason: z.ZodEnum<{
+                        error: "error";
                         resume: "resume";
                         clear: "clear";
                         logout: "logout";
                         prompt_input_exit: "prompt_input_exit";
-                        other: "other";
                         bypass_permissions_disabled: "bypass_permissions_disabled";
+                        normal: "normal";
+                        aborted: "aborted";
+                        other: "other";
                     }>;
                 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
                     session_id: z.ZodString;

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

@@ -931,14 +931,17 @@ export declare const FileChangedHookInputSchema: () => z.ZodIntersection<z.ZodOb
         unlink: "unlink";
     }>;
 }, z.core.$strip>>;
-export declare const EXIT_REASONS: readonly ["clear", "resume", "logout", "prompt_input_exit", "other", "bypass_permissions_disabled"];
+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";
     logout: "logout";
     prompt_input_exit: "prompt_input_exit";
-    other: "other";
     bypass_permissions_disabled: "bypass_permissions_disabled";
+    normal: "normal";
+    aborted: "aborted";
+    other: "other";
 }>;
 export declare const SessionEndHookInputSchema: () => z.ZodIntersection<z.ZodObject<{
     session_id: z.ZodString;
@@ -950,12 +953,15 @@ 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";
         logout: "logout";
         prompt_input_exit: "prompt_input_exit";
-        other: "other";
         bypass_permissions_disabled: "bypass_permissions_disabled";
+        normal: "normal";
+        aborted: "aborted";
+        other: "other";
     }>;
 }, z.core.$strip>>;
 export declare const HookInputSchema: () => z.ZodUnion<readonly [z.ZodIntersection<z.ZodObject<{
@@ -1059,12 +1065,15 @@ 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";
         logout: "logout";
         prompt_input_exit: "prompt_input_exit";
-        other: "other";
         bypass_permissions_disabled: "bypass_permissions_disabled";
+        normal: "normal";
+        aborted: "aborted";
+        other: "other";
     }>;
 }, z.core.$strip>>, z.ZodIntersection<z.ZodObject<{
     session_id: z.ZodString;

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

@@ -2,4 +2,4 @@ export type { SandboxFilesystemConfig, SandboxIgnoreViolations, SandboxNetworkCo
 export * from './coreTypes.generated.js';
 export type { NonNullableUsage } from './sdkUtilityTypes.js';
 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 EXIT_REASONS: readonly ["clear", "resume", "logout", "prompt_input_exit", "other", "bypass_permissions_disabled"];
+export declare const EXIT_REASONS: readonly ["clear", "resume", "logout", "prompt_input_exit", "bypass_permissions_disabled", "normal", "aborted", "error", "other"];

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

@@ -2,7 +2,7 @@ import type { ChildProcessWithoutNullStreams } from 'node:child_process';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
 import type { z } from 'zod/v4';
-import type { HookEvent, HookInput, SDKMessage, SDKResultMessage, SDKSessionInfo, SDKUserMessage, SyncHookJSONOutput } from './coreTypes.js';
+import type { ExitReason, HookEvent, HookInput, SDKMessage, SDKResultMessage, SDKSessionInfo, SDKUserMessage, SyncHookJSONOutput } from './coreTypes.js';
 export type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 export type AnyZodRawShape = z.ZodRawShape;
 export type InferShape<Shape extends AnyZodRawShape = AnyZodRawShape> = z.infer<z.ZodObject<Shape>>;
@@ -422,7 +422,22 @@ export type SDKSession = {
     }): Query;
     prompt(message: string, options?: Options): Promise<SDKResultMessage>;
     getInfo(): Promise<SDKSessionInfo | undefined>;
-    close(): Promise<void>;
+    /**
+     * Tear down the session container and fire the SessionEnd hook once.
+     *
+     * Per CC/SDK community semantics SessionEnd is a session-lifecycle event
+     * (not per-turn / per-query). Hosts call this on:
+     *   - the user closing the chat / deleting the session (`'aborted'`)
+     *   - graceful app shutdown or max_turns completion (`'normal'`)
+     *   - an unrecoverable error tearing the session down (`'error'`)
+     *   - any other host-defined teardown (`'other'`)
+     *
+     * `reason` is passed straight through to the SessionEnd hook payload's
+     * `reason: ExitReason` field. Default `'normal'` keeps single-arg
+     * callers (`session.close()`) backwards-compatible with pre-fire-on-
+     * close hosts; new code should pass the most specific reason it knows.
+     */
+    close(reason?: ExitReason): Promise<void>;
     /**
      * 把跟踪的文件回退到 `messageUuid` 对应的 snapshot。
      *