@bounty-ai/agent-sdk 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 type SdkContractVersion = "v1";
-type AssignmentStatus = "assigned" | "verifying" | "timed_out";
+type AssignmentStatus = "assigned" | "verifying" | "rejected" | "timed_out";
 type OutcomePayload = Record<string, unknown>;
 type AssignmentResultOutput = {
     type: "table" | "text" | "image" | "file" | "collection";
@@ -35,6 +35,32 @@ type AssignmentResult = {
     result?: Record<string, unknown>;
     error?: string;
 };
+type EmailRecipient = {
+    email: string;
+    name?: string;
+};
+type EmailOutreachMode = "draft" | "send";
+type EmailDeliveryInput = {
+    to: EmailRecipient[];
+    cc?: EmailRecipient[];
+    bcc?: EmailRecipient[];
+    subject: string;
+    textBody: string;
+    htmlBody?: string;
+};
+type IntegrationAction = {
+    type: string;
+    actionKey?: string;
+    operation: string;
+    input: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+type EmailDeliveryAction = IntegrationAction & {
+    type: "email";
+    operation: EmailOutreachMode;
+    input: EmailDeliveryInput;
+};
+type AssignmentAction = IntegrationAction;
 type AssignmentAckStatus = "accepted" | "rejected";
 type AssignmentAckRequest = {
     status: AssignmentAckStatus;
@@ -50,6 +76,7 @@ type SubmitResultRequest = {
     status: AssignmentStatus;
     result?: Record<string, unknown>;
     error?: string;
+    actions?: AssignmentAction[];
 };
 type SubmitErrorRequest = {
     assignmentId: string;
@@ -150,10 +177,75 @@ declare function createHonoWebhookHandler(options: WebhookHandlerOptions): (c: {
     json: (payload: unknown, status?: number) => Response;
 }) => Promise<Response>;
 
+type RuntimeLogger = {
+    info?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+};
+type AutoSubmitAssignmentHandlerOptions = {
+    client: AgentClient | ClientOptions;
+    runAssignment: (params: {
+        assignment: Assignment;
+    }) => Promise<AssignmentExecutionOutput>;
+    acceptAssignment?: (params: {
+        assignment: Assignment;
+    }) => Promise<AssignmentResult> | AssignmentResult;
+    createSubmitRequest?: (params: {
+        assignment: Assignment;
+        result: Record<string, unknown>;
+        actions?: AssignmentAction[];
+    }) => SubmitResultRequest;
+    createSubmitErrorRequest?: (params: {
+        assignment: Assignment;
+        error: unknown;
+    }) => SubmitErrorRequest;
+    executionMode?: "background" | "blocking";
+    logger?: RuntimeLogger;
+};
+type AssignmentExecutionResult = {
+    result: Record<string, unknown>;
+    actions?: AssignmentAction[];
+};
+type AssignmentExecutionOutput = Record<string, unknown> | AssignmentExecutionResult;
+type AssignmentExecutionHandler = (params: {
+    assignment: Assignment;
+}) => Promise<AssignmentExecutionOutput>;
+type AssignmentSlugRouterOptions = {
+    handlers: Record<string, AssignmentExecutionHandler>;
+    fallback?: AssignmentExecutionHandler;
+    normalizeSlug?: (slug: string) => string;
+};
+declare function createAssignmentSlugRouter(options: AssignmentSlugRouterOptions): AssignmentExecutionHandler;
+declare function createAutoSubmitAssignmentHandler(options: AutoSubmitAssignmentHandlerOptions): ({ assignment }: {
+    assignment: Assignment;
+}) => Promise<AssignmentResult>;
+
 declare function parseAssignmentV1(body: string): Assignment;
 declare function toAssignmentEnvelopeV1(assignment: Assignment): AssignmentEnvelopeV1;
 declare function getContractVersion(): SdkContractVersion;
 
+type CreateIntegrationActionInput = {
+    actionKey?: string;
+    type: string;
+    operation: string;
+    input: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+type CreateEmailDeliveryActionInput = {
+    actionKey?: string;
+    mode: "draft" | "send";
+    to: EmailRecipient[];
+    cc?: EmailRecipient[];
+    bcc?: EmailRecipient[];
+    subject: string;
+    textBody: string;
+    htmlBody?: string;
+    metadata?: Record<string, unknown>;
+};
+declare function createIntegrationAction(input: CreateIntegrationActionInput): IntegrationAction;
+declare function createEmailDeliveryAction(input: CreateEmailDeliveryActionInput): EmailDeliveryAction;
+declare function isIntegrationAction(action: AssignmentAction): action is IntegrationAction;
+declare function isEmailDeliveryAction(action: AssignmentAction): action is EmailDeliveryAction;
+
 type TableRow = Record<string, unknown>;
 type TablePayload = {
     table: {
@@ -174,4 +266,4 @@ type CreateTableResultOptions = {
 declare function createTablePayload(rows: TableRow[], options?: CreateTableResultOptions): TablePayload;
 declare function createTableResult(rows: TableRow[], options?: CreateTableResultOptions): Pick<AssignmentResult, "result">;
 
-export { AgentClient, ApiError, type ApiErrorBody, type Assignment, type AssignmentAckRequest, type AssignmentAckStatus, type AssignmentEnvelopeV1, type AssignmentOutcome, type AssignmentResult, type AssignmentResultOutput, type AssignmentResultSchema, type AssignmentStatus, type ClientOptions, type CreateTableResultOptions, DEFAULT_SIGNATURE_HEADER, DEFAULT_TIMESTAMP_HEADER, type OutcomePayload, type SdkContractVersion, SdkError, type SubmitErrorRequest, type SubmitResultRequest, type TablePayload, type TableRow, type WebhookHandlerOptions, type WebhookHttpResponse, type WebhookInput, computeWebhookSignature, createExpressWebhookHandler, createFastifyWebhookHandler, createHonoWebhookHandler, createNextWebhookHandler, createTablePayload, createTableResult, createWebhookHandler, executeWebhook, getContractVersion, parseAssignmentV1, toAssignmentEnvelopeV1, verifyWebhookSignature };
+export { AgentClient, ApiError, type ApiErrorBody, type Assignment, type AssignmentAckRequest, type AssignmentAckStatus, type AssignmentAction, type AssignmentEnvelopeV1, type AssignmentExecutionHandler, type AssignmentExecutionResult, type AssignmentOutcome, type AssignmentResult, type AssignmentResultOutput, type AssignmentResultSchema, type AssignmentSlugRouterOptions, type AssignmentStatus, type AutoSubmitAssignmentHandlerOptions, type ClientOptions, type CreateEmailDeliveryActionInput, type CreateIntegrationActionInput, type CreateTableResultOptions, DEFAULT_SIGNATURE_HEADER, DEFAULT_TIMESTAMP_HEADER, type EmailDeliveryAction, type EmailDeliveryInput, type EmailOutreachMode, type EmailRecipient, type IntegrationAction, type OutcomePayload, type SdkContractVersion, SdkError, type SubmitErrorRequest, type SubmitResultRequest, type TablePayload, type TableRow, type WebhookHandlerOptions, type WebhookHttpResponse, type WebhookInput, computeWebhookSignature, createAssignmentSlugRouter, createAutoSubmitAssignmentHandler, createEmailDeliveryAction, createExpressWebhookHandler, createFastifyWebhookHandler, createHonoWebhookHandler, createIntegrationAction, createNextWebhookHandler, createTablePayload, createTableResult, createWebhookHandler, executeWebhook, getContractVersion, isEmailDeliveryAction, isIntegrationAction, parseAssignmentV1, toAssignmentEnvelopeV1, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 type SdkContractVersion = "v1";
-type AssignmentStatus = "assigned" | "verifying" | "timed_out";
+type AssignmentStatus = "assigned" | "verifying" | "rejected" | "timed_out";
 type OutcomePayload = Record<string, unknown>;
 type AssignmentResultOutput = {
     type: "table" | "text" | "image" | "file" | "collection";
@@ -35,6 +35,32 @@ type AssignmentResult = {
     result?: Record<string, unknown>;
     error?: string;
 };
+type EmailRecipient = {
+    email: string;
+    name?: string;
+};
+type EmailOutreachMode = "draft" | "send";
+type EmailDeliveryInput = {
+    to: EmailRecipient[];
+    cc?: EmailRecipient[];
+    bcc?: EmailRecipient[];
+    subject: string;
+    textBody: string;
+    htmlBody?: string;
+};
+type IntegrationAction = {
+    type: string;
+    actionKey?: string;
+    operation: string;
+    input: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+type EmailDeliveryAction = IntegrationAction & {
+    type: "email";
+    operation: EmailOutreachMode;
+    input: EmailDeliveryInput;
+};
+type AssignmentAction = IntegrationAction;
 type AssignmentAckStatus = "accepted" | "rejected";
 type AssignmentAckRequest = {
     status: AssignmentAckStatus;
@@ -50,6 +76,7 @@ type SubmitResultRequest = {
     status: AssignmentStatus;
     result?: Record<string, unknown>;
     error?: string;
+    actions?: AssignmentAction[];
 };
 type SubmitErrorRequest = {
     assignmentId: string;
@@ -150,10 +177,75 @@ declare function createHonoWebhookHandler(options: WebhookHandlerOptions): (c: {
     json: (payload: unknown, status?: number) => Response;
 }) => Promise<Response>;
 
+type RuntimeLogger = {
+    info?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+};
+type AutoSubmitAssignmentHandlerOptions = {
+    client: AgentClient | ClientOptions;
+    runAssignment: (params: {
+        assignment: Assignment;
+    }) => Promise<AssignmentExecutionOutput>;
+    acceptAssignment?: (params: {
+        assignment: Assignment;
+    }) => Promise<AssignmentResult> | AssignmentResult;
+    createSubmitRequest?: (params: {
+        assignment: Assignment;
+        result: Record<string, unknown>;
+        actions?: AssignmentAction[];
+    }) => SubmitResultRequest;
+    createSubmitErrorRequest?: (params: {
+        assignment: Assignment;
+        error: unknown;
+    }) => SubmitErrorRequest;
+    executionMode?: "background" | "blocking";
+    logger?: RuntimeLogger;
+};
+type AssignmentExecutionResult = {
+    result: Record<string, unknown>;
+    actions?: AssignmentAction[];
+};
+type AssignmentExecutionOutput = Record<string, unknown> | AssignmentExecutionResult;
+type AssignmentExecutionHandler = (params: {
+    assignment: Assignment;
+}) => Promise<AssignmentExecutionOutput>;
+type AssignmentSlugRouterOptions = {
+    handlers: Record<string, AssignmentExecutionHandler>;
+    fallback?: AssignmentExecutionHandler;
+    normalizeSlug?: (slug: string) => string;
+};
+declare function createAssignmentSlugRouter(options: AssignmentSlugRouterOptions): AssignmentExecutionHandler;
+declare function createAutoSubmitAssignmentHandler(options: AutoSubmitAssignmentHandlerOptions): ({ assignment }: {
+    assignment: Assignment;
+}) => Promise<AssignmentResult>;
+
 declare function parseAssignmentV1(body: string): Assignment;
 declare function toAssignmentEnvelopeV1(assignment: Assignment): AssignmentEnvelopeV1;
 declare function getContractVersion(): SdkContractVersion;
 
+type CreateIntegrationActionInput = {
+    actionKey?: string;
+    type: string;
+    operation: string;
+    input: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+type CreateEmailDeliveryActionInput = {
+    actionKey?: string;
+    mode: "draft" | "send";
+    to: EmailRecipient[];
+    cc?: EmailRecipient[];
+    bcc?: EmailRecipient[];
+    subject: string;
+    textBody: string;
+    htmlBody?: string;
+    metadata?: Record<string, unknown>;
+};
+declare function createIntegrationAction(input: CreateIntegrationActionInput): IntegrationAction;
+declare function createEmailDeliveryAction(input: CreateEmailDeliveryActionInput): EmailDeliveryAction;
+declare function isIntegrationAction(action: AssignmentAction): action is IntegrationAction;
+declare function isEmailDeliveryAction(action: AssignmentAction): action is EmailDeliveryAction;
+
 type TableRow = Record<string, unknown>;
 type TablePayload = {
     table: {
@@ -174,4 +266,4 @@ type CreateTableResultOptions = {
 declare function createTablePayload(rows: TableRow[], options?: CreateTableResultOptions): TablePayload;
 declare function createTableResult(rows: TableRow[], options?: CreateTableResultOptions): Pick<AssignmentResult, "result">;
 
-export { AgentClient, ApiError, type ApiErrorBody, type Assignment, type AssignmentAckRequest, type AssignmentAckStatus, type AssignmentEnvelopeV1, type AssignmentOutcome, type AssignmentResult, type AssignmentResultOutput, type AssignmentResultSchema, type AssignmentStatus, type ClientOptions, type CreateTableResultOptions, DEFAULT_SIGNATURE_HEADER, DEFAULT_TIMESTAMP_HEADER, type OutcomePayload, type SdkContractVersion, SdkError, type SubmitErrorRequest, type SubmitResultRequest, type TablePayload, type TableRow, type WebhookHandlerOptions, type WebhookHttpResponse, type WebhookInput, computeWebhookSignature, createExpressWebhookHandler, createFastifyWebhookHandler, createHonoWebhookHandler, createNextWebhookHandler, createTablePayload, createTableResult, createWebhookHandler, executeWebhook, getContractVersion, parseAssignmentV1, toAssignmentEnvelopeV1, verifyWebhookSignature };
+export { AgentClient, ApiError, type ApiErrorBody, type Assignment, type AssignmentAckRequest, type AssignmentAckStatus, type AssignmentAction, type AssignmentEnvelopeV1, type AssignmentExecutionHandler, type AssignmentExecutionResult, type AssignmentOutcome, type AssignmentResult, type AssignmentResultOutput, type AssignmentResultSchema, type AssignmentSlugRouterOptions, type AssignmentStatus, type AutoSubmitAssignmentHandlerOptions, type ClientOptions, type CreateEmailDeliveryActionInput, type CreateIntegrationActionInput, type CreateTableResultOptions, DEFAULT_SIGNATURE_HEADER, DEFAULT_TIMESTAMP_HEADER, type EmailDeliveryAction, type EmailDeliveryInput, type EmailOutreachMode, type EmailRecipient, type IntegrationAction, type OutcomePayload, type SdkContractVersion, SdkError, type SubmitErrorRequest, type SubmitResultRequest, type TablePayload, type TableRow, type WebhookHandlerOptions, type WebhookHttpResponse, type WebhookInput, computeWebhookSignature, createAssignmentSlugRouter, createAutoSubmitAssignmentHandler, createEmailDeliveryAction, createExpressWebhookHandler, createFastifyWebhookHandler, createHonoWebhookHandler, createIntegrationAction, createNextWebhookHandler, createTablePayload, createTableResult, createWebhookHandler, executeWebhook, getContractVersion, isEmailDeliveryAction, isIntegrationAction, parseAssignmentV1, toAssignmentEnvelopeV1, verifyWebhookSignature };

package/dist/index.js

@@ -44,7 +44,8 @@ var AgentClient = class {
     };
     await this.post(`/agent/assignments/submit`, {
       assignment_id: input.assignmentId,
-      ...payload
+      ...payload,
+      ...input.actions ? { actions: input.actions } : {}
     });
   }
   async submitError(input) {
@@ -212,7 +213,7 @@ async function executeWebhook(handler, input) {
     return {
       status: 400,
       body: {
-        status: "timed_out",
+        status: "rejected",
         error: sdkError.message
       }
     };
@@ -231,11 +232,46 @@ function normalizeBody(body) {
   if (typeof body === "string") {
     return body;
   }
+  if (typeof Buffer !== "undefined" && Buffer.isBuffer(body)) {
+    return body.toString("utf8");
+  }
   if (body === void 0 || body === null) {
     return "";
   }
   return JSON.stringify(body);
 }
+async function readExpressBody(req) {
+  if (typeof req.rawBody === "string" || Buffer.isBuffer(req.rawBody)) {
+    return normalizeBody(req.rawBody);
+  }
+  if (req.body !== void 0) {
+    if (typeof req.body === "object" && req.body !== null && !Buffer.isBuffer(req.body)) {
+      throw new SdkError(
+        "Express webhook route must receive raw bytes. Mount webhook routes before express.json() or exclude them from JSON parsing."
+      );
+    }
+    return normalizeBody(req.body);
+  }
+  if (!req.on) {
+    return "";
+  }
+  return await new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on?.("data", (chunk) => {
+      if (typeof chunk === "string") {
+        chunks.push(Buffer.from(chunk, "utf8"));
+      } else if (chunk instanceof Uint8Array) {
+        chunks.push(chunk);
+      }
+    });
+    req.on?.("end", () => {
+      resolve(Buffer.concat(chunks).toString("utf8"));
+    });
+    req.on?.("error", (error) => {
+      reject(error);
+    });
+  });
+}
 function toWebhookInput(params) {
   return {
     body: params.body,
@@ -243,18 +279,33 @@ function toWebhookInput(params) {
     ...params.timestamp ? { timestamp: params.timestamp } : {}
   };
 }
+function toBadRequest(error) {
+  const message = error instanceof Error ? error.message : "Unexpected webhook error";
+  return {
+    status: 400,
+    body: {
+      status: "rejected",
+      error: message
+    }
+  };
+}
 function createExpressWebhookHandler(options) {
   const handler = createWebhookHandler(options);
   return async function expressWebhook(req, res) {
-    const body = req.rawBody ?? normalizeBody(req.body);
-    const result = await executeWebhook(
-      handler,
-      toWebhookInput({
-        body,
-        signature: headerValue(req.headers, DEFAULT_SIGNATURE_HEADER),
-        timestamp: headerValue(req.headers, DEFAULT_TIMESTAMP_HEADER)
-      })
-    );
+    let result;
+    try {
+      const body = await readExpressBody(req);
+      result = await executeWebhook(
+        handler,
+        toWebhookInput({
+          body,
+          signature: headerValue(req.headers, DEFAULT_SIGNATURE_HEADER),
+          timestamp: headerValue(req.headers, DEFAULT_TIMESTAMP_HEADER)
+        })
+      );
+    } catch (error) {
+      result = toBadRequest(error);
+    }
     res.status(result.status).json(result.body);
   };
 }
@@ -307,6 +358,190 @@ function createHonoWebhookHandler(options) {
   };
 }
 
+// src/runtime.ts
+function toMessage(error) {
+  if (error instanceof Error && error.message.trim().length > 0) {
+    return error.message;
+  }
+  return "Unknown assignment execution error";
+}
+function defaultAcceptedResponse(assignment) {
+  return {
+    status: "assigned",
+    result: {
+      accepted: true,
+      assignment_id: assignment.assignment_id
+    }
+  };
+}
+function defaultSubmitRequest(params) {
+  return {
+    assignmentId: params.assignment.assignment_id,
+    status: "verifying",
+    result: params.result,
+    ...params.actions && params.actions.length > 0 ? { actions: params.actions } : {}
+  };
+}
+function defaultSubmitErrorRequest(params) {
+  return {
+    assignmentId: params.assignment.assignment_id,
+    error: toMessage(params.error)
+  };
+}
+function asClient(client) {
+  return client instanceof AgentClient ? client : new AgentClient(client);
+}
+function normalizeExecutionOutput(output) {
+  if (output && typeof output === "object" && !Array.isArray(output) && "result" in output && output.result && typeof output.result === "object" && !Array.isArray(output.result)) {
+    const actions = "actions" in output && Array.isArray(output.actions) ? output.actions : void 0;
+    return {
+      result: output.result,
+      ...actions && actions.length > 0 ? { actions } : {}
+    };
+  }
+  if (!output || typeof output !== "object" || Array.isArray(output)) {
+    throw new SdkError("Assignment execution must return an object result");
+  }
+  return {
+    result: output
+  };
+}
+function createAssignmentSlugRouter(options) {
+  const normalize = options.normalizeSlug ?? ((slug) => slug);
+  const normalizedHandlers = /* @__PURE__ */ new Map();
+  for (const [slug, handler] of Object.entries(options.handlers)) {
+    normalizedHandlers.set(normalize(slug), handler);
+  }
+  return async ({ assignment }) => {
+    const slug = normalize(assignment.template_slug);
+    const handler = normalizedHandlers.get(slug) ?? options.fallback;
+    if (!handler) {
+      throw new SdkError(`No assignment handler registered for template slug "${assignment.template_slug}"`);
+    }
+    return handler({ assignment });
+  };
+}
+function createAutoSubmitAssignmentHandler(options) {
+  const client = asClient(options.client);
+  const mode = options.executionMode ?? "background";
+  const logger = options.logger;
+  async function processAssignment(assignment) {
+    try {
+      const execution = normalizeExecutionOutput(await options.runAssignment({ assignment }));
+      const submitRequest = options.createSubmitRequest ? options.createSubmitRequest({
+        assignment,
+        result: execution.result,
+        ...execution.actions ? { actions: execution.actions } : {}
+      }) : defaultSubmitRequest({
+        assignment,
+        result: execution.result,
+        ...execution.actions ? { actions: execution.actions } : {}
+      });
+      await client.submitResult(submitRequest);
+      logger?.info?.("[agent-sdk] assignment_submitted", {
+        assignmentId: assignment.assignment_id,
+        status: submitRequest.status,
+        actionCount: submitRequest.actions?.length ?? 0
+      });
+    } catch (error) {
+      const submitErrorRequest = options.createSubmitErrorRequest ? options.createSubmitErrorRequest({ assignment, error }) : defaultSubmitErrorRequest({ assignment, error });
+      await client.submitError(submitErrorRequest);
+      logger?.error?.("[agent-sdk] assignment_failed", {
+        assignmentId: assignment.assignment_id,
+        error: submitErrorRequest.error
+      });
+    }
+  }
+  return async function onAssignment({ assignment }) {
+    const accepted = options.acceptAssignment ? await options.acceptAssignment({ assignment }) : defaultAcceptedResponse(assignment);
+    if (accepted.status !== "assigned") {
+      return accepted;
+    }
+    if (mode === "blocking") {
+      await processAssignment(assignment);
+    } else {
+      void processAssignment(assignment).catch((error) => {
+        logger?.error?.("[agent-sdk] assignment_background_failure", {
+          assignmentId: assignment.assignment_id,
+          error: toMessage(error)
+        });
+      });
+    }
+    return accepted;
+  };
+}
+
+// src/integrations.ts
+function normalizeRecipients(recipients, label) {
+  if (!Array.isArray(recipients) || recipients.length === 0) {
+    throw new Error(`${label} must include at least one recipient`);
+  }
+  return recipients.map((recipient, index) => {
+    if (!recipient || typeof recipient.email !== "string" || recipient.email.trim().length === 0) {
+      throw new Error(`${label}[${index}] is missing email`);
+    }
+    return {
+      email: recipient.email.trim(),
+      ...typeof recipient.name === "string" && recipient.name.trim().length > 0 ? { name: recipient.name.trim() } : {}
+    };
+  });
+}
+function createIntegrationAction(input) {
+  if (typeof input.type !== "string" || input.type.trim().length === 0) {
+    throw new Error("type is required");
+  }
+  if (typeof input.operation !== "string" || input.operation.trim().length === 0) {
+    throw new Error("operation is required");
+  }
+  if (!input.input || typeof input.input !== "object" || Array.isArray(input.input)) {
+    throw new Error("input must be an object");
+  }
+  return {
+    type: input.type.trim(),
+    ...typeof input.actionKey === "string" && input.actionKey.trim().length > 0 ? { actionKey: input.actionKey.trim() } : {},
+    operation: input.operation.trim(),
+    input,
+    ...input.metadata ? { metadata: input.metadata } : {}
+  };
+}
+function createEmailDeliveryInput(input) {
+  if (typeof input.subject !== "string" || input.subject.trim().length === 0) {
+    throw new Error("Email subject is required");
+  }
+  if (typeof input.textBody !== "string" || input.textBody.trim().length === 0) {
+    throw new Error("Email textBody is required");
+  }
+  return {
+    to: normalizeRecipients(input.to, "to"),
+    ...input.cc && input.cc.length > 0 ? { cc: normalizeRecipients(input.cc, "cc") } : {},
+    ...input.bcc && input.bcc.length > 0 ? { bcc: normalizeRecipients(input.bcc, "bcc") } : {},
+    subject: input.subject.trim(),
+    textBody: input.textBody.trim(),
+    ...typeof input.htmlBody === "string" && input.htmlBody.trim().length > 0 ? { htmlBody: input.htmlBody } : {}
+  };
+}
+function createEmailDeliveryAction(input) {
+  const emailInput = createEmailDeliveryInput(input);
+  return {
+    ...createIntegrationAction({
+      ...input.actionKey ? { actionKey: input.actionKey } : {},
+      type: "email",
+      operation: input.mode,
+      input: emailInput,
+      ...input.metadata ? { metadata: input.metadata } : {}
+    }),
+    type: "email",
+    operation: input.mode,
+    input: emailInput
+  };
+}
+function isIntegrationAction(action) {
+  return typeof action.type === "string" && typeof action.operation === "string";
+}
+function isEmailDeliveryAction(action) {
+  return action.type === "email" && (action.operation === "draft" || action.operation === "send");
+}
+
 // src/results.ts
 var DEFAULT_CONTACT_FIELDS = ["email", "phone", "profile_url", "linkedin_url"];
 function hasValue(value) {
@@ -359,15 +594,21 @@ export {
   DEFAULT_TIMESTAMP_HEADER,
   SdkError,
   computeWebhookSignature,
+  createAssignmentSlugRouter,
+  createAutoSubmitAssignmentHandler,
+  createEmailDeliveryAction,
   createExpressWebhookHandler,
   createFastifyWebhookHandler,
   createHonoWebhookHandler,
+  createIntegrationAction,
   createNextWebhookHandler,
   createTablePayload,
   createTableResult,
   createWebhookHandler,
   executeWebhook,
   getContractVersion,
+  isEmailDeliveryAction,
+  isIntegrationAction,
   parseAssignmentV1,
   toAssignmentEnvelopeV1,
   verifyWebhookSignature