@meistrari/agent-sdk 0.3.0 → 0.4.0

package/dist/schemas.mjs

@@ -428,6 +428,7 @@ const nativeAnthropicModelIds = [
   "claude-sonnet-4-5",
   "claude-sonnet-4-6",
   "claude-haiku-4-5",
+  "claude-fable-5",
   "claude-opus-4-6",
   "claude-opus-4-7",
   "claude-opus-4-8"
@@ -440,6 +441,118 @@ const modelSchema = z.enum([
   ...openrouterModelIds
 ]);
 
+const sessionWebhookEventTypeSchema = z.enum([
+  "session.started",
+  "session.completed",
+  "session.failed",
+  "session.cancelled",
+  "session.waiting_messages",
+  "subagent.started",
+  "subagent.completed"
+]);
+const SESSION_WEBHOOK_DEFAULT_EVENTS = [
+  "session.started",
+  "session.completed",
+  "session.failed",
+  "session.cancelled",
+  "session.waiting_messages"
+];
+const BLOCKED_HOSTNAME_SUFFIXES = [".localhost", ".local", ".internal"];
+const BLOCKED_HOSTNAMES = /* @__PURE__ */ new Set(["localhost", "metadata.google.internal"]);
+function isPrivateIpv4(hostname) {
+  const match = hostname.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+  if (!match) {
+    return false;
+  }
+  const octets = match.slice(1).map(Number);
+  if (octets.some((octet) => octet > 255)) {
+    return true;
+  }
+  const a = octets[0] ?? 0;
+  const b = octets[1] ?? 0;
+  return a === 0 || a === 10 || a === 127 || a === 100 && b >= 64 && b <= 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 168;
+}
+function isPrivateIpv6(hostname) {
+  const normalized = hostname.replace(/^\[|\]$/g, "").toLowerCase();
+  if (!normalized.includes(":")) {
+    return false;
+  }
+  return normalized === "::" || normalized === "::1" || normalized.startsWith("fc") || normalized.startsWith("fd") || normalized.startsWith("fe8") || normalized.startsWith("fe9") || normalized.startsWith("fea") || normalized.startsWith("feb") || normalized.startsWith("::ffff:");
+}
+function isBlockedWebhookHostname(hostname) {
+  const normalized = hostname.toLowerCase();
+  if (BLOCKED_HOSTNAMES.has(normalized)) {
+    return true;
+  }
+  if (BLOCKED_HOSTNAME_SUFFIXES.some((suffix) => normalized.endsWith(suffix))) {
+    return true;
+  }
+  return isPrivateIpv4(normalized) || isPrivateIpv6(normalized);
+}
+function validateWebhookUrl(value) {
+  let parsed;
+  try {
+    parsed = new URL(value);
+  } catch {
+    return "Webhook URL is invalid";
+  }
+  if (parsed.protocol !== "https:") {
+    return "Webhook URLs must use https";
+  }
+  if (isBlockedWebhookHostname(parsed.hostname)) {
+    return "Webhook URL host is not allowed";
+  }
+  return null;
+}
+const sessionWebhookConfigSchema = z.object({
+  url: z.string().max(2048).superRefine((value, ctx) => {
+    const error = validateWebhookUrl(value);
+    if (error) {
+      ctx.addIssue({ code: "custom", message: error });
+    }
+  }).describe("HTTPS endpoint that receives lifecycle event POSTs (e.g. a Trigger.dev wait-token URL)"),
+  events: z.array(sessionWebhookEventTypeSchema).min(1).optional().describe("Event filter; defaults to all session.* events (subagent.* events must be opted into)"),
+  secret: z.string().min(8).max(256).optional().describe("Optional HMAC-SHA256 signing secret used for the x-tela-agent-webhook-signature header")
+}).strict();
+const sessionWebhooksSchema = z.array(sessionWebhookConfigSchema).max(5).describe("Webhook endpoints notified about session lifecycle and subagent events");
+const sessionWebhookUsageSchema = z.object({
+  inputTokens: z.number().int().nonnegative().optional(),
+  outputTokens: z.number().int().nonnegative().optional(),
+  cacheReadInputTokens: z.number().int().nonnegative().optional(),
+  cacheCreationInputTokens: z.number().int().nonnegative().optional(),
+  totalCostUsd: z.number().nullable().optional(),
+  durationMs: z.number().int().nonnegative().optional(),
+  numTurns: z.number().int().nonnegative().optional()
+}).strict();
+const sessionWebhookSubagentSchema = z.object({
+  callId: z.string().min(1).max(256),
+  subagentType: z.string().max(256).optional(),
+  status: z.enum(["success", "failed"]).optional(),
+  durationMs: z.number().int().nonnegative().optional()
+}).strict();
+const sessionWebhookEventPayloadSchema = z.object({
+  eventType: sessionWebhookEventTypeSchema,
+  sessionId: z.string(),
+  workspaceId: z.string().optional(),
+  runId: z.string().optional(),
+  status: z.string(),
+  error: z.string().optional(),
+  usage: sessionWebhookUsageSchema.optional(),
+  subagent: sessionWebhookSubagentSchema.optional(),
+  timestamp: z.string(),
+  apiVersion: z.literal("v4"),
+  deliveryId: z.string()
+});
+const sessionAgentEventSchema = z.object({
+  type: z.enum(["subagent.started", "subagent.completed"]),
+  callId: z.string().min(1).max(256),
+  subagentType: z.string().max(256).optional(),
+  status: z.enum(["success", "failed"]).optional(),
+  durationMs: z.number().int().nonnegative().optional(),
+  timestamp: z.number().int().nonnegative()
+}).strict();
+const sessionAgentEventsSchema = z.array(sessionAgentEventSchema).max(20);
+
 const vaultReferenceSchema = z.string().regex(/^vault:\/\/\S+$/, "vaultRef must start with vault:// and cannot contain whitespace");
 const agentInputSchema = z.object({
   vaultRef: vaultReferenceSchema,
@@ -454,7 +567,8 @@ const executeAgentRequestSchema = z.object({
   message: z.string().min(1).max(8e5).optional(),
   inputs: z.array(agentInputSchema).optional(),
   environmentVariables: z.record(z.string(), z.string()).optional(),
-  recover: z.boolean().optional()
+  recover: z.boolean().optional(),
+  webhooks: sessionWebhooksSchema.optional()
 }).strict().superRefine((data, ctx) => {
   if (!data.sessionId) {
     if (!data.organizationName) {
@@ -493,15 +607,15 @@ const updateAgentModelRequestSchema = z.object({
 }).strict();
 const updateAgentModelSuccessResponseSchema = z.object({
   success: z.literal(true).describe("Whether the model update succeeded"),
-  organizationName: z.string().optional().describe("Resolved Forgejo organization name"),
-  repository: z.string().optional().describe("Forgejo repository name"),
-  branch: z.string().optional().describe("Branch written to"),
-  commitHash: z.string().optional().describe("Commit hash after update"),
-  model: modelSchema.optional().describe("Configured model after update"),
-  providerTemplate: z.string().optional().describe("Provider template selected from the model prefix"),
-  templateSynced: z.boolean().optional().describe("Whether managed template files were synchronized"),
-  files: z.array(z.string()).optional().describe("Files written by the update"),
-  deletedFiles: z.array(z.string()).optional().describe("Files deleted by the update")
+  organizationName: z.string().describe("Resolved Forgejo organization name"),
+  repository: z.string().describe("Forgejo repository name"),
+  branch: z.string().describe("Branch written to"),
+  commitHash: z.string().describe("Commit hash after update"),
+  model: modelSchema.describe("Configured model after update"),
+  providerTemplate: z.string().describe("Provider template selected from the model prefix"),
+  templateSynced: z.boolean().describe("Whether managed template files were synchronized"),
+  files: z.array(z.string()).describe("Files written by the update"),
+  deletedFiles: z.array(z.string()).describe("Files deleted by the update")
 });
 const updateAgentModelErrorResponseSchema = z.object({
   success: z.literal(false).describe("Whether the model update succeeded"),
@@ -635,5 +749,9 @@ const sessionStreamEventSchema = z.discriminatedUnion("kind", [
   sessionErrorEventSchema
 ]);
 const SESSION_STREAM_EVENT_KINDS = /* @__PURE__ */ new Set(["status", "steps", "result", "timeline-finalize", "error"]);
+const cancelSessionResponseSchema = z.discriminatedUnion("success", [
+  z.object({ success: z.literal(true), message: z.string() }),
+  z.object({ success: z.literal(false), error: z.string() })
+]);
 
-export { SESSION_STREAM_EVENT_KINDS, agentInputSchema, executeAgentErrorResponseSchema, executeAgentRequestSchema, executeAgentResponseSchema, executeAgentSuccessResponseSchema, modelSchema, nativeAnthropicModelIds, nativeModelSchema, openrouterModelCatalog, openrouterModelIds, sessionStatusSchema, sessionStreamEventSchema, sessionTimelineIdSchema, sessionTimelineResponseSchema, timelineEventSchema, timelineMetricsSchema, timelinePromptSchema, timelineRunTurnMetricsSchema, timelineSpanSchema, timelineToolResultSchema, updateAgentModelErrorResponseSchema, updateAgentModelRequestSchema, updateAgentModelResponseSchema, updateAgentModelSuccessResponseSchema };
+export { SESSION_STREAM_EVENT_KINDS, SESSION_WEBHOOK_DEFAULT_EVENTS, agentInputSchema, cancelSessionResponseSchema, executeAgentErrorResponseSchema, executeAgentRequestSchema, executeAgentResponseSchema, executeAgentSuccessResponseSchema, isBlockedWebhookHostname, modelSchema, nativeAnthropicModelIds, nativeModelSchema, openrouterModelCatalog, openrouterModelIds, sessionAgentEventSchema, sessionAgentEventsSchema, sessionStatusSchema, sessionStreamEventSchema, sessionTimelineIdSchema, sessionTimelineResponseSchema, sessionWebhookConfigSchema, sessionWebhookEventPayloadSchema, sessionWebhookEventTypeSchema, sessionWebhookSubagentSchema, sessionWebhookUsageSchema, sessionWebhooksSchema, timelineEventSchema, timelineMetricsSchema, timelinePromptSchema, timelineRunTurnMetricsSchema, timelineSpanSchema, timelineToolResultSchema, updateAgentModelErrorResponseSchema, updateAgentModelRequestSchema, updateAgentModelResponseSchema, updateAgentModelSuccessResponseSchema, validateWebhookUrl };

package/dist/shared/{agent-sdk.4ad2c746.d.cts → agent-sdk.dc5630ec.d.cts}

@@ -19,6 +19,19 @@ declare const executeAgentRequestSchema: z.ZodObject<{
     }, z.core.$strict>>>;
     environmentVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     recover: z.ZodOptional<z.ZodBoolean>;
+    webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "session.started": "session.started";
+            "session.completed": "session.completed";
+            "session.failed": "session.failed";
+            "session.cancelled": "session.cancelled";
+            "session.waiting_messages": "session.waiting_messages";
+            "subagent.started": "subagent.started";
+            "subagent.completed": "subagent.completed";
+        }>>>;
+        secret: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 type ExecuteAgentRequest = z.infer<typeof executeAgentRequestSchema>;
 declare const executeAgentSuccessResponseSchema: z.ZodObject<{
@@ -47,17 +60,17 @@ declare const updateAgentModelRequestSchema: z.ZodObject<{
 type UpdateAgentModelRequest = z.infer<typeof updateAgentModelRequestSchema>;
 declare const updateAgentModelSuccessResponseSchema: z.ZodObject<{
     success: z.ZodLiteral<true>;
-    organizationName: z.ZodOptional<z.ZodString>;
-    repository: z.ZodOptional<z.ZodString>;
-    branch: z.ZodOptional<z.ZodString>;
-    commitHash: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodEnum<{
+    organizationName: z.ZodString;
+    repository: z.ZodString;
+    branch: z.ZodString;
+    commitHash: z.ZodString;
+    model: z.ZodEnum<{
         [x: string]: string;
-    }>>;
-    providerTemplate: z.ZodOptional<z.ZodString>;
-    templateSynced: z.ZodOptional<z.ZodBoolean>;
-    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    deletedFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }>;
+    providerTemplate: z.ZodString;
+    templateSynced: z.ZodBoolean;
+    files: z.ZodArray<z.ZodString>;
+    deletedFiles: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 declare const updateAgentModelErrorResponseSchema: z.ZodObject<{
     success: z.ZodLiteral<false>;
@@ -65,17 +78,17 @@ declare const updateAgentModelErrorResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const updateAgentModelResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     success: z.ZodLiteral<true>;
-    organizationName: z.ZodOptional<z.ZodString>;
-    repository: z.ZodOptional<z.ZodString>;
-    branch: z.ZodOptional<z.ZodString>;
-    commitHash: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodEnum<{
+    organizationName: z.ZodString;
+    repository: z.ZodString;
+    branch: z.ZodString;
+    commitHash: z.ZodString;
+    model: z.ZodEnum<{
         [x: string]: string;
-    }>>;
-    providerTemplate: z.ZodOptional<z.ZodString>;
-    templateSynced: z.ZodOptional<z.ZodBoolean>;
-    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    deletedFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }>;
+    providerTemplate: z.ZodString;
+    templateSynced: z.ZodBoolean;
+    files: z.ZodArray<z.ZodString>;
+    deletedFiles: z.ZodArray<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     success: z.ZodLiteral<false>;
     error: z.ZodString;
@@ -367,6 +380,142 @@ declare const sessionStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>], "kind">;
 type SessionStreamEvent = z.infer<typeof sessionStreamEventSchema>;
 declare const SESSION_STREAM_EVENT_KINDS: Set<string>;
+declare const cancelSessionResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodString;
+}, z.core.$strip>], "success">;
+type CancelSessionResponse = z.infer<typeof cancelSessionResponseSchema>;
+
+declare const sessionWebhookEventTypeSchema: z.ZodEnum<{
+    "session.started": "session.started";
+    "session.completed": "session.completed";
+    "session.failed": "session.failed";
+    "session.cancelled": "session.cancelled";
+    "session.waiting_messages": "session.waiting_messages";
+    "subagent.started": "subagent.started";
+    "subagent.completed": "subagent.completed";
+}>;
+type SessionWebhookEventType = z.infer<typeof sessionWebhookEventTypeSchema>;
+declare const SESSION_WEBHOOK_DEFAULT_EVENTS: SessionWebhookEventType[];
+declare function isBlockedWebhookHostname(hostname: string): boolean;
+declare function validateWebhookUrl(value: string): string | null;
+declare const sessionWebhookConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "session.started": "session.started";
+        "session.completed": "session.completed";
+        "session.failed": "session.failed";
+        "session.cancelled": "session.cancelled";
+        "session.waiting_messages": "session.waiting_messages";
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>>>;
+    secret: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type SessionWebhookConfig = z.infer<typeof sessionWebhookConfigSchema>;
+declare const sessionWebhooksSchema: z.ZodArray<z.ZodObject<{
+    url: z.ZodString;
+    events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "session.started": "session.started";
+        "session.completed": "session.completed";
+        "session.failed": "session.failed";
+        "session.cancelled": "session.cancelled";
+        "session.waiting_messages": "session.waiting_messages";
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>>>;
+    secret: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+declare const sessionWebhookUsageSchema: z.ZodObject<{
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+    totalCostUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    numTurns: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type SessionWebhookUsage = z.infer<typeof sessionWebhookUsageSchema>;
+declare const sessionWebhookSubagentSchema: z.ZodObject<{
+    callId: z.ZodString;
+    subagentType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        failed: "failed";
+    }>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type SessionWebhookSubagent = z.infer<typeof sessionWebhookSubagentSchema>;
+declare const sessionWebhookEventPayloadSchema: z.ZodObject<{
+    eventType: z.ZodEnum<{
+        "session.started": "session.started";
+        "session.completed": "session.completed";
+        "session.failed": "session.failed";
+        "session.cancelled": "session.cancelled";
+        "session.waiting_messages": "session.waiting_messages";
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodObject<{
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+        totalCostUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        numTurns: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    subagent: z.ZodOptional<z.ZodObject<{
+        callId: z.ZodString;
+        subagentType: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            success: "success";
+            failed: "failed";
+        }>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    timestamp: z.ZodString;
+    apiVersion: z.ZodLiteral<"v4">;
+    deliveryId: z.ZodString;
+}, z.core.$strip>;
+type SessionWebhookEventPayload = z.infer<typeof sessionWebhookEventPayloadSchema>;
+declare const sessionAgentEventSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>;
+    callId: z.ZodString;
+    subagentType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        failed: "failed";
+    }>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodNumber;
+}, z.core.$strict>;
+type SessionAgentEvent = z.infer<typeof sessionAgentEventSchema>;
+declare const sessionAgentEventsSchema: z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<{
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>;
+    callId: z.ZodString;
+    subagentType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        failed: "failed";
+    }>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodNumber;
+}, z.core.$strict>>;
 
-export { sessionTimelineResponseSchema as B, sessionStreamEventSchema as C, SESSION_STREAM_EVENT_KINDS as D, agentInputSchema as j, executeAgentRequestSchema as k, executeAgentSuccessResponseSchema as l, executeAgentErrorResponseSchema as m, executeAgentResponseSchema as n, updateAgentModelSuccessResponseSchema as o, updateAgentModelErrorResponseSchema as p, updateAgentModelResponseSchema as q, sessionTimelineIdSchema as r, sessionStatusSchema as s, timelineMetricsSchema as t, updateAgentModelRequestSchema as u, timelinePromptSchema as v, timelineToolResultSchema as w, timelineRunTurnMetricsSchema as x, timelineEventSchema as y, timelineSpanSchema as z };
-export type { AgentInput as A, ExecuteAgentRequest as E, SessionTimelineResponse as S, TimelineEvent as T, UpdateAgentModelRequest as U, ExecuteAgentResponse as a, UpdateAgentModelResponse as b, SessionStreamEvent as c, SessionStatus as d, TimelineMetrics as e, TimelinePrompt as f, TimelineRunTurnMetrics as g, TimelineSpan as h, TimelineToolResult as i };
+export { timelinePromptSchema as B, timelineToolResultSchema as D, timelineRunTurnMetricsSchema as F, timelineEventSchema as G, timelineSpanSchema as H, sessionTimelineResponseSchema as I, sessionStreamEventSchema as J, SESSION_STREAM_EVENT_KINDS as K, cancelSessionResponseSchema as L, sessionWebhookEventTypeSchema as M, SESSION_WEBHOOK_DEFAULT_EVENTS as N, isBlockedWebhookHostname as O, validateWebhookUrl as P, sessionWebhookConfigSchema as Q, sessionWebhooksSchema as R, sessionWebhookUsageSchema as V, sessionWebhookSubagentSchema as W, sessionWebhookEventPayloadSchema as X, sessionAgentEventSchema as Y, sessionAgentEventsSchema as _, agentInputSchema as o, executeAgentRequestSchema as p, executeAgentSuccessResponseSchema as q, executeAgentErrorResponseSchema as r, executeAgentResponseSchema as s, updateAgentModelSuccessResponseSchema as t, updateAgentModelRequestSchema as u, updateAgentModelErrorResponseSchema as v, updateAgentModelResponseSchema as w, sessionStatusSchema as x, sessionTimelineIdSchema as y, timelineMetricsSchema as z };
+export type { AgentInput as A, CancelSessionResponse as C, ExecuteAgentRequest as E, SessionTimelineResponse as S, TimelineEvent as T, UpdateAgentModelRequest as U, SessionAgentEvent as Z, ExecuteAgentResponse as a, UpdateAgentModelResponse as b, SessionStreamEvent as c, SessionStatus as d, SessionWebhookConfig as e, SessionWebhookEventPayload as f, SessionWebhookEventType as g, SessionWebhookSubagent as h, SessionWebhookUsage as i, TimelineMetrics as j, TimelinePrompt as k, TimelineRunTurnMetrics as l, TimelineSpan as m, TimelineToolResult as n };

package/dist/shared/{agent-sdk.4ad2c746.d.mts → agent-sdk.dc5630ec.d.mts}

@@ -19,6 +19,19 @@ declare const executeAgentRequestSchema: z.ZodObject<{
     }, z.core.$strict>>>;
     environmentVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     recover: z.ZodOptional<z.ZodBoolean>;
+    webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "session.started": "session.started";
+            "session.completed": "session.completed";
+            "session.failed": "session.failed";
+            "session.cancelled": "session.cancelled";
+            "session.waiting_messages": "session.waiting_messages";
+            "subagent.started": "subagent.started";
+            "subagent.completed": "subagent.completed";
+        }>>>;
+        secret: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 type ExecuteAgentRequest = z.infer<typeof executeAgentRequestSchema>;
 declare const executeAgentSuccessResponseSchema: z.ZodObject<{
@@ -47,17 +60,17 @@ declare const updateAgentModelRequestSchema: z.ZodObject<{
 type UpdateAgentModelRequest = z.infer<typeof updateAgentModelRequestSchema>;
 declare const updateAgentModelSuccessResponseSchema: z.ZodObject<{
     success: z.ZodLiteral<true>;
-    organizationName: z.ZodOptional<z.ZodString>;
-    repository: z.ZodOptional<z.ZodString>;
-    branch: z.ZodOptional<z.ZodString>;
-    commitHash: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodEnum<{
+    organizationName: z.ZodString;
+    repository: z.ZodString;
+    branch: z.ZodString;
+    commitHash: z.ZodString;
+    model: z.ZodEnum<{
         [x: string]: string;
-    }>>;
-    providerTemplate: z.ZodOptional<z.ZodString>;
-    templateSynced: z.ZodOptional<z.ZodBoolean>;
-    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    deletedFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }>;
+    providerTemplate: z.ZodString;
+    templateSynced: z.ZodBoolean;
+    files: z.ZodArray<z.ZodString>;
+    deletedFiles: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 declare const updateAgentModelErrorResponseSchema: z.ZodObject<{
     success: z.ZodLiteral<false>;
@@ -65,17 +78,17 @@ declare const updateAgentModelErrorResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const updateAgentModelResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     success: z.ZodLiteral<true>;
-    organizationName: z.ZodOptional<z.ZodString>;
-    repository: z.ZodOptional<z.ZodString>;
-    branch: z.ZodOptional<z.ZodString>;
-    commitHash: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodEnum<{
+    organizationName: z.ZodString;
+    repository: z.ZodString;
+    branch: z.ZodString;
+    commitHash: z.ZodString;
+    model: z.ZodEnum<{
         [x: string]: string;
-    }>>;
-    providerTemplate: z.ZodOptional<z.ZodString>;
-    templateSynced: z.ZodOptional<z.ZodBoolean>;
-    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    deletedFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }>;
+    providerTemplate: z.ZodString;
+    templateSynced: z.ZodBoolean;
+    files: z.ZodArray<z.ZodString>;
+    deletedFiles: z.ZodArray<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     success: z.ZodLiteral<false>;
     error: z.ZodString;
@@ -367,6 +380,142 @@ declare const sessionStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>], "kind">;
 type SessionStreamEvent = z.infer<typeof sessionStreamEventSchema>;
 declare const SESSION_STREAM_EVENT_KINDS: Set<string>;
+declare const cancelSessionResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodString;
+}, z.core.$strip>], "success">;
+type CancelSessionResponse = z.infer<typeof cancelSessionResponseSchema>;
+
+declare const sessionWebhookEventTypeSchema: z.ZodEnum<{
+    "session.started": "session.started";
+    "session.completed": "session.completed";
+    "session.failed": "session.failed";
+    "session.cancelled": "session.cancelled";
+    "session.waiting_messages": "session.waiting_messages";
+    "subagent.started": "subagent.started";
+    "subagent.completed": "subagent.completed";
+}>;
+type SessionWebhookEventType = z.infer<typeof sessionWebhookEventTypeSchema>;
+declare const SESSION_WEBHOOK_DEFAULT_EVENTS: SessionWebhookEventType[];
+declare function isBlockedWebhookHostname(hostname: string): boolean;
+declare function validateWebhookUrl(value: string): string | null;
+declare const sessionWebhookConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "session.started": "session.started";
+        "session.completed": "session.completed";
+        "session.failed": "session.failed";
+        "session.cancelled": "session.cancelled";
+        "session.waiting_messages": "session.waiting_messages";
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>>>;
+    secret: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type SessionWebhookConfig = z.infer<typeof sessionWebhookConfigSchema>;
+declare const sessionWebhooksSchema: z.ZodArray<z.ZodObject<{
+    url: z.ZodString;
+    events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "session.started": "session.started";
+        "session.completed": "session.completed";
+        "session.failed": "session.failed";
+        "session.cancelled": "session.cancelled";
+        "session.waiting_messages": "session.waiting_messages";
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>>>;
+    secret: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+declare const sessionWebhookUsageSchema: z.ZodObject<{
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+    totalCostUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    numTurns: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type SessionWebhookUsage = z.infer<typeof sessionWebhookUsageSchema>;
+declare const sessionWebhookSubagentSchema: z.ZodObject<{
+    callId: z.ZodString;
+    subagentType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        failed: "failed";
+    }>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type SessionWebhookSubagent = z.infer<typeof sessionWebhookSubagentSchema>;
+declare const sessionWebhookEventPayloadSchema: z.ZodObject<{
+    eventType: z.ZodEnum<{
+        "session.started": "session.started";
+        "session.completed": "session.completed";
+        "session.failed": "session.failed";
+        "session.cancelled": "session.cancelled";
+        "session.waiting_messages": "session.waiting_messages";
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodObject<{
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+        totalCostUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        numTurns: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    subagent: z.ZodOptional<z.ZodObject<{
+        callId: z.ZodString;
+        subagentType: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            success: "success";
+            failed: "failed";
+        }>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    timestamp: z.ZodString;
+    apiVersion: z.ZodLiteral<"v4">;
+    deliveryId: z.ZodString;
+}, z.core.$strip>;
+type SessionWebhookEventPayload = z.infer<typeof sessionWebhookEventPayloadSchema>;
+declare const sessionAgentEventSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>;
+    callId: z.ZodString;
+    subagentType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        failed: "failed";
+    }>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodNumber;
+}, z.core.$strict>;
+type SessionAgentEvent = z.infer<typeof sessionAgentEventSchema>;
+declare const sessionAgentEventsSchema: z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<{
+        "subagent.started": "subagent.started";
+        "subagent.completed": "subagent.completed";
+    }>;
+    callId: z.ZodString;
+    subagentType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        failed: "failed";
+    }>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodNumber;
+}, z.core.$strict>>;
 
-export { sessionTimelineResponseSchema as B, sessionStreamEventSchema as C, SESSION_STREAM_EVENT_KINDS as D, agentInputSchema as j, executeAgentRequestSchema as k, executeAgentSuccessResponseSchema as l, executeAgentErrorResponseSchema as m, executeAgentResponseSchema as n, updateAgentModelSuccessResponseSchema as o, updateAgentModelErrorResponseSchema as p, updateAgentModelResponseSchema as q, sessionTimelineIdSchema as r, sessionStatusSchema as s, timelineMetricsSchema as t, updateAgentModelRequestSchema as u, timelinePromptSchema as v, timelineToolResultSchema as w, timelineRunTurnMetricsSchema as x, timelineEventSchema as y, timelineSpanSchema as z };
-export type { AgentInput as A, ExecuteAgentRequest as E, SessionTimelineResponse as S, TimelineEvent as T, UpdateAgentModelRequest as U, ExecuteAgentResponse as a, UpdateAgentModelResponse as b, SessionStreamEvent as c, SessionStatus as d, TimelineMetrics as e, TimelinePrompt as f, TimelineRunTurnMetrics as g, TimelineSpan as h, TimelineToolResult as i };
+export { timelinePromptSchema as B, timelineToolResultSchema as D, timelineRunTurnMetricsSchema as F, timelineEventSchema as G, timelineSpanSchema as H, sessionTimelineResponseSchema as I, sessionStreamEventSchema as J, SESSION_STREAM_EVENT_KINDS as K, cancelSessionResponseSchema as L, sessionWebhookEventTypeSchema as M, SESSION_WEBHOOK_DEFAULT_EVENTS as N, isBlockedWebhookHostname as O, validateWebhookUrl as P, sessionWebhookConfigSchema as Q, sessionWebhooksSchema as R, sessionWebhookUsageSchema as V, sessionWebhookSubagentSchema as W, sessionWebhookEventPayloadSchema as X, sessionAgentEventSchema as Y, sessionAgentEventsSchema as _, agentInputSchema as o, executeAgentRequestSchema as p, executeAgentSuccessResponseSchema as q, executeAgentErrorResponseSchema as r, executeAgentResponseSchema as s, updateAgentModelSuccessResponseSchema as t, updateAgentModelRequestSchema as u, updateAgentModelErrorResponseSchema as v, updateAgentModelResponseSchema as w, sessionStatusSchema as x, sessionTimelineIdSchema as y, timelineMetricsSchema as z };
+export type { AgentInput as A, CancelSessionResponse as C, ExecuteAgentRequest as E, SessionTimelineResponse as S, TimelineEvent as T, UpdateAgentModelRequest as U, SessionAgentEvent as Z, ExecuteAgentResponse as a, UpdateAgentModelResponse as b, SessionStreamEvent as c, SessionStatus as d, SessionWebhookConfig as e, SessionWebhookEventPayload as f, SessionWebhookEventType as g, SessionWebhookSubagent as h, SessionWebhookUsage as i, TimelineMetrics as j, TimelinePrompt as k, TimelineRunTurnMetrics as l, TimelineSpan as m, TimelineToolResult as n };