@herdctl/core 0.1.0 → 0.3.0

package/dist/config/schema.d.ts

@@ -1315,6 +1315,549 @@ export declare const AgentChatSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
 }>;
+/**
+ * Hook events that can trigger hooks
+ */
+export declare const HookEventSchema: z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>;
+/**
+ * Shell hook configuration - executes a shell command with HookContext on stdin
+ */
+export declare const ShellHookConfigSchema: z.ZodObject<{
+    /** Human-readable name for this hook (used in logs) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+    continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Filter which events trigger this hook (default: all events) */
+    on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+    /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+    when: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"shell">;
+    /** Shell command to execute */
+    command: z.ZodString;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    type: "shell";
+    timeout: number;
+    command: string;
+    continue_on_error: boolean;
+    name?: string | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}, {
+    type: "shell";
+    command: string;
+    timeout?: number | undefined;
+    name?: string | undefined;
+    continue_on_error?: boolean | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}>;
+/**
+ * Webhook hook configuration - POSTs HookContext JSON to a URL
+ */
+export declare const WebhookHookConfigSchema: z.ZodObject<{
+    /** Human-readable name for this hook (used in logs) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+    continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Filter which events trigger this hook (default: all events) */
+    on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+    /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+    when: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"webhook">;
+    /** URL to POST the HookContext to */
+    url: z.ZodString;
+    /** HTTP method (default: POST) */
+    method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["POST", "PUT"]>>>;
+    /** Custom headers (supports ${ENV_VAR} substitution) */
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Timeout in milliseconds (default: 10000) */
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    type: "webhook";
+    timeout: number;
+    url: string;
+    continue_on_error: boolean;
+    method: "POST" | "PUT";
+    name?: string | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+    headers?: Record<string, string> | undefined;
+}, {
+    type: "webhook";
+    url: string;
+    timeout?: number | undefined;
+    name?: string | undefined;
+    continue_on_error?: boolean | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+    method?: "POST" | "PUT" | undefined;
+    headers?: Record<string, string> | undefined;
+}>;
+/**
+ * Discord hook configuration - sends notification to Discord channel
+ */
+export declare const DiscordHookConfigSchema: z.ZodObject<{
+    /** Human-readable name for this hook (used in logs) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+    continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Filter which events trigger this hook (default: all events) */
+    on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+    /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+    when: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"discord">;
+    /** Discord channel ID */
+    channel_id: z.ZodString;
+    /** Environment variable name containing the bot token */
+    bot_token_env: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "discord";
+    bot_token_env: string;
+    continue_on_error: boolean;
+    channel_id: string;
+    name?: string | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}, {
+    type: "discord";
+    bot_token_env: string;
+    channel_id: string;
+    name?: string | undefined;
+    continue_on_error?: boolean | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}>;
+/**
+ * Union of all hook configuration types
+ */
+export declare const HookConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    /** Human-readable name for this hook (used in logs) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+    continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Filter which events trigger this hook (default: all events) */
+    on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+    /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+    when: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"shell">;
+    /** Shell command to execute */
+    command: z.ZodString;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    type: "shell";
+    timeout: number;
+    command: string;
+    continue_on_error: boolean;
+    name?: string | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}, {
+    type: "shell";
+    command: string;
+    timeout?: number | undefined;
+    name?: string | undefined;
+    continue_on_error?: boolean | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}>, z.ZodObject<{
+    /** Human-readable name for this hook (used in logs) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+    continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Filter which events trigger this hook (default: all events) */
+    on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+    /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+    when: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"webhook">;
+    /** URL to POST the HookContext to */
+    url: z.ZodString;
+    /** HTTP method (default: POST) */
+    method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["POST", "PUT"]>>>;
+    /** Custom headers (supports ${ENV_VAR} substitution) */
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Timeout in milliseconds (default: 10000) */
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    type: "webhook";
+    timeout: number;
+    url: string;
+    continue_on_error: boolean;
+    method: "POST" | "PUT";
+    name?: string | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+    headers?: Record<string, string> | undefined;
+}, {
+    type: "webhook";
+    url: string;
+    timeout?: number | undefined;
+    name?: string | undefined;
+    continue_on_error?: boolean | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+    method?: "POST" | "PUT" | undefined;
+    headers?: Record<string, string> | undefined;
+}>, z.ZodObject<{
+    /** Human-readable name for this hook (used in logs) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+    continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Filter which events trigger this hook (default: all events) */
+    on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+    /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+    when: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"discord">;
+    /** Discord channel ID */
+    channel_id: z.ZodString;
+    /** Environment variable name containing the bot token */
+    bot_token_env: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "discord";
+    bot_token_env: string;
+    continue_on_error: boolean;
+    channel_id: string;
+    name?: string | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}, {
+    type: "discord";
+    bot_token_env: string;
+    channel_id: string;
+    name?: string | undefined;
+    continue_on_error?: boolean | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}>]>;
+/**
+ * Agent hooks configuration
+ */
+export declare const AgentHooksSchema: z.ZodObject<{
+    /** Hooks to run after every job (success or failure) */
+    after_run: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        /** Human-readable name for this hook (used in logs) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+        continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Filter which events trigger this hook (default: all events) */
+        on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+        /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+        when: z.ZodOptional<z.ZodString>;
+    } & {
+        type: z.ZodLiteral<"shell">;
+        /** Shell command to execute */
+        command: z.ZodString;
+        /** Timeout in milliseconds (default: 30000) */
+        timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "shell";
+        timeout: number;
+        command: string;
+        continue_on_error: boolean;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }, {
+        type: "shell";
+        command: string;
+        timeout?: number | undefined;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }>, z.ZodObject<{
+        /** Human-readable name for this hook (used in logs) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+        continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Filter which events trigger this hook (default: all events) */
+        on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+        /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+        when: z.ZodOptional<z.ZodString>;
+    } & {
+        type: z.ZodLiteral<"webhook">;
+        /** URL to POST the HookContext to */
+        url: z.ZodString;
+        /** HTTP method (default: POST) */
+        method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["POST", "PUT"]>>>;
+        /** Custom headers (supports ${ENV_VAR} substitution) */
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Timeout in milliseconds (default: 10000) */
+        timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "webhook";
+        timeout: number;
+        url: string;
+        continue_on_error: boolean;
+        method: "POST" | "PUT";
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+        headers?: Record<string, string> | undefined;
+    }, {
+        type: "webhook";
+        url: string;
+        timeout?: number | undefined;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+        method?: "POST" | "PUT" | undefined;
+        headers?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        /** Human-readable name for this hook (used in logs) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+        continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Filter which events trigger this hook (default: all events) */
+        on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+        /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+        when: z.ZodOptional<z.ZodString>;
+    } & {
+        type: z.ZodLiteral<"discord">;
+        /** Discord channel ID */
+        channel_id: z.ZodString;
+        /** Environment variable name containing the bot token */
+        bot_token_env: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "discord";
+        bot_token_env: string;
+        continue_on_error: boolean;
+        channel_id: string;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }, {
+        type: "discord";
+        bot_token_env: string;
+        channel_id: string;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }>]>, "many">>;
+    /** Hooks to run only when a job fails */
+    on_error: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        /** Human-readable name for this hook (used in logs) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+        continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Filter which events trigger this hook (default: all events) */
+        on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+        /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+        when: z.ZodOptional<z.ZodString>;
+    } & {
+        type: z.ZodLiteral<"shell">;
+        /** Shell command to execute */
+        command: z.ZodString;
+        /** Timeout in milliseconds (default: 30000) */
+        timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "shell";
+        timeout: number;
+        command: string;
+        continue_on_error: boolean;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }, {
+        type: "shell";
+        command: string;
+        timeout?: number | undefined;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }>, z.ZodObject<{
+        /** Human-readable name for this hook (used in logs) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+        continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Filter which events trigger this hook (default: all events) */
+        on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+        /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+        when: z.ZodOptional<z.ZodString>;
+    } & {
+        type: z.ZodLiteral<"webhook">;
+        /** URL to POST the HookContext to */
+        url: z.ZodString;
+        /** HTTP method (default: POST) */
+        method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["POST", "PUT"]>>>;
+        /** Custom headers (supports ${ENV_VAR} substitution) */
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Timeout in milliseconds (default: 10000) */
+        timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "webhook";
+        timeout: number;
+        url: string;
+        continue_on_error: boolean;
+        method: "POST" | "PUT";
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+        headers?: Record<string, string> | undefined;
+    }, {
+        type: "webhook";
+        url: string;
+        timeout?: number | undefined;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+        method?: "POST" | "PUT" | undefined;
+        headers?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        /** Human-readable name for this hook (used in logs) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+        continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Filter which events trigger this hook (default: all events) */
+        on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+        /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+        when: z.ZodOptional<z.ZodString>;
+    } & {
+        type: z.ZodLiteral<"discord">;
+        /** Discord channel ID */
+        channel_id: z.ZodString;
+        /** Environment variable name containing the bot token */
+        bot_token_env: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "discord";
+        bot_token_env: string;
+        continue_on_error: boolean;
+        channel_id: string;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }, {
+        type: "discord";
+        bot_token_env: string;
+        channel_id: string;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }>]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    after_run?: ({
+        type: "shell";
+        timeout: number;
+        command: string;
+        continue_on_error: boolean;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    } | {
+        type: "webhook";
+        timeout: number;
+        url: string;
+        continue_on_error: boolean;
+        method: "POST" | "PUT";
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+        headers?: Record<string, string> | undefined;
+    } | {
+        type: "discord";
+        bot_token_env: string;
+        continue_on_error: boolean;
+        channel_id: string;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    })[] | undefined;
+    on_error?: ({
+        type: "shell";
+        timeout: number;
+        command: string;
+        continue_on_error: boolean;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    } | {
+        type: "webhook";
+        timeout: number;
+        url: string;
+        continue_on_error: boolean;
+        method: "POST" | "PUT";
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+        headers?: Record<string, string> | undefined;
+    } | {
+        type: "discord";
+        bot_token_env: string;
+        continue_on_error: boolean;
+        channel_id: string;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    })[] | undefined;
+}, {
+    after_run?: ({
+        type: "shell";
+        command: string;
+        timeout?: number | undefined;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    } | {
+        type: "webhook";
+        url: string;
+        timeout?: number | undefined;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+        method?: "POST" | "PUT" | undefined;
+        headers?: Record<string, string> | undefined;
+    } | {
+        type: "discord";
+        bot_token_env: string;
+        channel_id: string;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    })[] | undefined;
+    on_error?: ({
+        type: "shell";
+        command: string;
+        timeout?: number | undefined;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    } | {
+        type: "webhook";
+        url: string;
+        timeout?: number | undefined;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+        method?: "POST" | "PUT" | undefined;
+        headers?: Record<string, string> | undefined;
+    } | {
+        type: "discord";
+        bot_token_env: string;
+        channel_id: string;
+        name?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    })[] | undefined;
+}>;
 export declare const AgentWorkspaceSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     root: z.ZodString;
     auto_clone: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -1365,6 +1908,8 @@ export declare const AgentConfigSchema: z.ZodObject<{
         personality?: string | undefined;
     }>>;
     system_prompt: z.ZodOptional<z.ZodString>;
+    /** Default prompt used when triggering without --prompt */
+    default_prompt: z.ZodOptional<z.ZodString>;
     work_source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
         type: z.ZodLiteral<"github">;
         /** GitHub repository in owner/repo format (required) */
@@ -1885,6 +2430,324 @@ export declare const AgentConfigSchema: z.ZodObject<{
             } | undefined;
         } | undefined;
     }>>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        /** Hooks to run after every job (success or failure) */
+        after_run: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            /** Human-readable name for this hook (used in logs) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+            continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Filter which events trigger this hook (default: all events) */
+            on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+            /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+            when: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"shell">;
+            /** Shell command to execute */
+            command: z.ZodString;
+            /** Timeout in milliseconds (default: 30000) */
+            timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "shell";
+            timeout: number;
+            command: string;
+            continue_on_error: boolean;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }, {
+            type: "shell";
+            command: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }>, z.ZodObject<{
+            /** Human-readable name for this hook (used in logs) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+            continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Filter which events trigger this hook (default: all events) */
+            on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+            /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+            when: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"webhook">;
+            /** URL to POST the HookContext to */
+            url: z.ZodString;
+            /** HTTP method (default: POST) */
+            method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["POST", "PUT"]>>>;
+            /** Custom headers (supports ${ENV_VAR} substitution) */
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            /** Timeout in milliseconds (default: 10000) */
+            timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "webhook";
+            timeout: number;
+            url: string;
+            continue_on_error: boolean;
+            method: "POST" | "PUT";
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        }, {
+            type: "webhook";
+            url: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            method?: "POST" | "PUT" | undefined;
+            headers?: Record<string, string> | undefined;
+        }>, z.ZodObject<{
+            /** Human-readable name for this hook (used in logs) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+            continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Filter which events trigger this hook (default: all events) */
+            on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+            /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+            when: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"discord">;
+            /** Discord channel ID */
+            channel_id: z.ZodString;
+            /** Environment variable name containing the bot token */
+            bot_token_env: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "discord";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }, {
+            type: "discord";
+            bot_token_env: string;
+            channel_id: string;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }>]>, "many">>;
+        /** Hooks to run only when a job fails */
+        on_error: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            /** Human-readable name for this hook (used in logs) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+            continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Filter which events trigger this hook (default: all events) */
+            on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+            /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+            when: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"shell">;
+            /** Shell command to execute */
+            command: z.ZodString;
+            /** Timeout in milliseconds (default: 30000) */
+            timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "shell";
+            timeout: number;
+            command: string;
+            continue_on_error: boolean;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }, {
+            type: "shell";
+            command: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }>, z.ZodObject<{
+            /** Human-readable name for this hook (used in logs) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+            continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Filter which events trigger this hook (default: all events) */
+            on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+            /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+            when: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"webhook">;
+            /** URL to POST the HookContext to */
+            url: z.ZodString;
+            /** HTTP method (default: POST) */
+            method: z.ZodDefault<z.ZodOptional<z.ZodEnum<["POST", "PUT"]>>>;
+            /** Custom headers (supports ${ENV_VAR} substitution) */
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            /** Timeout in milliseconds (default: 10000) */
+            timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "webhook";
+            timeout: number;
+            url: string;
+            continue_on_error: boolean;
+            method: "POST" | "PUT";
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        }, {
+            type: "webhook";
+            url: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            method?: "POST" | "PUT" | undefined;
+            headers?: Record<string, string> | undefined;
+        }>, z.ZodObject<{
+            /** Human-readable name for this hook (used in logs) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+            continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Filter which events trigger this hook (default: all events) */
+            on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+            /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+            when: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"discord">;
+            /** Discord channel ID */
+            channel_id: z.ZodString;
+            /** Environment variable name containing the bot token */
+            bot_token_env: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "discord";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }, {
+            type: "discord";
+            bot_token_env: string;
+            channel_id: string;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }>]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        after_run?: ({
+            type: "shell";
+            timeout: number;
+            command: string;
+            continue_on_error: boolean;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        } | {
+            type: "webhook";
+            timeout: number;
+            url: string;
+            continue_on_error: boolean;
+            method: "POST" | "PUT";
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "discord";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        })[] | undefined;
+        on_error?: ({
+            type: "shell";
+            timeout: number;
+            command: string;
+            continue_on_error: boolean;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        } | {
+            type: "webhook";
+            timeout: number;
+            url: string;
+            continue_on_error: boolean;
+            method: "POST" | "PUT";
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "discord";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        })[] | undefined;
+    }, {
+        after_run?: ({
+            type: "shell";
+            command: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        } | {
+            type: "webhook";
+            url: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            method?: "POST" | "PUT" | undefined;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "discord";
+            bot_token_env: string;
+            channel_id: string;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        })[] | undefined;
+        on_error?: ({
+            type: "shell";
+            command: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        } | {
+            type: "webhook";
+            url: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            method?: "POST" | "PUT" | undefined;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "discord";
+            bot_token_env: string;
+            channel_id: string;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        })[] | undefined;
+    }>>;
     docker: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         base_image: z.ZodOptional<z.ZodString>;
@@ -1905,6 +2768,8 @@ export declare const AgentConfigSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     max_turns: z.ZodOptional<z.ZodNumber>;
     permission_mode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "bypassPermissions", "plan"]>>;
+    /** Path to metadata JSON file written by agent (default: metadata.json in workspace) */
+    metadata_file: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     name: string;
     repo?: string | undefined;
@@ -1998,6 +2863,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
         personality?: string | undefined;
     } | undefined;
     system_prompt?: string | undefined;
+    default_prompt?: string | undefined;
     schedules?: Record<string, {
         type: "interval" | "cron" | "webhook" | "chat";
         enabled: boolean;
@@ -2033,6 +2899,63 @@ export declare const AgentConfigSchema: z.ZodObject<{
         url?: string | undefined;
         env?: Record<string, string> | undefined;
     }> | undefined;
+    hooks?: {
+        after_run?: ({
+            type: "shell";
+            timeout: number;
+            command: string;
+            continue_on_error: boolean;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        } | {
+            type: "webhook";
+            timeout: number;
+            url: string;
+            continue_on_error: boolean;
+            method: "POST" | "PUT";
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "discord";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        })[] | undefined;
+        on_error?: ({
+            type: "shell";
+            timeout: number;
+            command: string;
+            continue_on_error: boolean;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        } | {
+            type: "webhook";
+            timeout: number;
+            url: string;
+            continue_on_error: boolean;
+            method: "POST" | "PUT";
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "discord";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        })[] | undefined;
+    } | undefined;
+    metadata_file?: string | undefined;
 }, {
     name: string;
     repo?: string | undefined;
@@ -2126,6 +3049,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
         personality?: string | undefined;
     } | undefined;
     system_prompt?: string | undefined;
+    default_prompt?: string | undefined;
     schedules?: Record<string, {
         type: "interval" | "cron" | "webhook" | "chat";
         enabled?: boolean | undefined;
@@ -2161,6 +3085,63 @@ export declare const AgentConfigSchema: z.ZodObject<{
         url?: string | undefined;
         env?: Record<string, string> | undefined;
     }> | undefined;
+    hooks?: {
+        after_run?: ({
+            type: "shell";
+            command: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        } | {
+            type: "webhook";
+            url: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            method?: "POST" | "PUT" | undefined;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "discord";
+            bot_token_env: string;
+            channel_id: string;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        })[] | undefined;
+        on_error?: ({
+            type: "shell";
+            command: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        } | {
+            type: "webhook";
+            url: string;
+            timeout?: number | undefined;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+            method?: "POST" | "PUT" | undefined;
+            headers?: Record<string, string> | undefined;
+        } | {
+            type: "discord";
+            bot_token_env: string;
+            channel_id: string;
+            name?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        })[] | undefined;
+    } | undefined;
+    metadata_file?: string | undefined;
 }>;
 export declare const DiscordChatSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -2717,4 +3698,15 @@ export type AgentChatDiscord = z.infer<typeof AgentChatDiscordSchema>;
 export type AgentChat = z.infer<typeof AgentChatSchema>;
 export type AgentWorkspace = z.infer<typeof AgentWorkspaceSchema>;
 export type AgentConfig = z.infer<typeof AgentConfigSchema>;
+export type HookEvent = z.infer<typeof HookEventSchema>;
+export type ShellHookConfig = z.infer<typeof ShellHookConfigSchema>;
+export type WebhookHookConfig = z.infer<typeof WebhookHookConfigSchema>;
+export type DiscordHookConfig = z.infer<typeof DiscordHookConfigSchema>;
+export type HookConfig = z.infer<typeof HookConfigSchema>;
+export type AgentHooks = z.infer<typeof AgentHooksSchema>;
+export type ShellHookConfigInput = z.input<typeof ShellHookConfigSchema>;
+export type WebhookHookConfigInput = z.input<typeof WebhookHookConfigSchema>;
+export type DiscordHookConfigInput = z.input<typeof DiscordHookConfigSchema>;
+export type HookConfigInput = z.input<typeof HookConfigSchema>;
+export type AgentHooksInput = z.input<typeof AgentHooksSchema>;
 //# sourceMappingURL=schema.d.ts.map