@bounty-ai/agent-sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,375 @@
+// src/errors.ts
+var SdkError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "SdkError";
+  }
+};
+var ApiError = class extends SdkError {
+  status;
+  code;
+  body;
+  retryable;
+  constructor(params) {
+    super(params.message);
+    this.name = "ApiError";
+    this.status = params.status;
+    this.code = params.code;
+    this.body = params.body;
+    this.retryable = params.status === 429 || params.status >= 500;
+  }
+};
+
+// src/client.ts
+var AgentClient = class {
+  baseUrl;
+  apiKey;
+  fetchImpl;
+  constructor(options) {
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.fetchImpl = options.fetchImpl ?? fetch;
+  }
+  async ackAssignment(assignmentId, request) {
+    await this.post(`/agent/assignments/ack`, {
+      assignment_id: assignmentId,
+      ...request
+    });
+  }
+  async submitResult(input) {
+    const payload = {
+      status: input.status,
+      ...input.result ? { result: input.result } : {},
+      ...input.error ? { error: input.error } : {}
+    };
+    await this.post(`/agent/assignments/submit`, {
+      assignment_id: input.assignmentId,
+      ...payload
+    });
+  }
+  async submitError(input) {
+    await this.submitResult({
+      assignmentId: input.assignmentId,
+      status: "timed_out",
+      error: input.error,
+      ...input.details ? { result: { details: input.details } } : {}
+    });
+  }
+  async post(path, body) {
+    const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      throw await this.toApiError(response);
+    }
+  }
+  async toApiError(response) {
+    const raw = await response.text();
+    let parsed = null;
+    if (raw) {
+      try {
+        parsed = JSON.parse(raw);
+      } catch {
+        parsed = { message: raw };
+      }
+    }
+    return new ApiError({
+      status: response.status,
+      message: parsed?.message ?? `API request failed (${response.status}): ${raw || response.statusText}`,
+      code: parsed?.code,
+      body: parsed
+    });
+  }
+};
+
+// src/signature.ts
+import { createHmac, timingSafeEqual } from "crypto";
+function computeWebhookSignature(params) {
+  const signedPayload = `${params.timestamp}.${params.body}`;
+  const digest = createHmac("sha256", params.webhookSecret).update(signedPayload, "utf8").digest("hex");
+  return `sha256=${digest}`;
+}
+function verifyWebhookSignature(params) {
+  if (!params.timestamp || !params.signature) {
+    throw new SdkError("Missing webhook timestamp or signature");
+  }
+  const expected = computeWebhookSignature({
+    webhookSecret: params.webhookSecret,
+    timestamp: params.timestamp,
+    body: params.body
+  });
+  const expectedBuffer = Buffer.from(expected, "utf8");
+  const actualBuffer = Buffer.from(params.signature, "utf8");
+  if (expectedBuffer.length !== actualBuffer.length) {
+    throw new SdkError("Invalid webhook signature");
+  }
+  if (!timingSafeEqual(expectedBuffer, actualBuffer)) {
+    throw new SdkError("Invalid webhook signature");
+  }
+}
+
+// src/contracts.ts
+var CONTRACT_VERSION = "v1";
+function isObject(value) {
+  return !!value && typeof value === "object";
+}
+function parseAssignmentRecord(record) {
+  if (typeof record.assignment_id !== "string") {
+    throw new SdkError("Missing assignment_id");
+  }
+  if (typeof record.template_slug !== "string") {
+    throw new SdkError("Missing template_slug");
+  }
+  if (!isObject(record.outcome)) {
+    throw new SdkError("Missing outcome");
+  }
+  if (!isObject(record.result_schema)) {
+    throw new SdkError("Missing result_schema");
+  }
+  const outcome = record.outcome;
+  if (typeof outcome.title !== "string") {
+    throw new SdkError("Missing outcome.title");
+  }
+  if (!isObject(outcome.payload)) {
+    throw new SdkError("Missing outcome.payload");
+  }
+  const parsedResultSchema = record.result_schema;
+  return {
+    assignment_id: record.assignment_id,
+    template_slug: record.template_slug,
+    result_schema: parsedResultSchema,
+    outcome: {
+      title: outcome.title,
+      payload: outcome.payload,
+      ...typeof outcome.requested_unit_price_value === "number" ? { requested_unit_price_value: outcome.requested_unit_price_value } : {},
+      ...typeof outcome.requested_total_price_value === "number" ? { requested_total_price_value: outcome.requested_total_price_value } : {},
+      ...typeof outcome.currency === "string" ? { currency: outcome.currency } : {},
+      ...typeof outcome.time_window === "string" ? { time_window: outcome.time_window } : {}
+    }
+  };
+}
+function parseAssignmentV1(body) {
+  let payload;
+  try {
+    payload = JSON.parse(body);
+  } catch {
+    throw new SdkError("Invalid JSON payload");
+  }
+  if (!isObject(payload)) {
+    throw new SdkError("Invalid assignment payload");
+  }
+  if (payload.version !== CONTRACT_VERSION) {
+    throw new SdkError("Unsupported assignment contract version");
+  }
+  if (!isObject(payload.assignment)) {
+    throw new SdkError("Missing assignment envelope payload");
+  }
+  return parseAssignmentRecord(payload.assignment);
+}
+function toAssignmentEnvelopeV1(assignment) {
+  return {
+    version: CONTRACT_VERSION,
+    assignment
+  };
+}
+function getContractVersion() {
+  return CONTRACT_VERSION;
+}
+
+// src/webhook.ts
+var DEFAULT_SIGNATURE_HEADER = "x-bounty-signature";
+var DEFAULT_TIMESTAMP_HEADER = "x-bounty-timestamp";
+function createWebhookHandler(options) {
+  const shouldVerify = options.verifySignature ?? true;
+  return async function handleWebhook(input) {
+    if (shouldVerify) {
+      verifyWebhookSignature({
+        webhookSecret: options.webhookSecret,
+        body: input.body,
+        ...input.signature ? { signature: input.signature } : {},
+        ...input.timestamp ? { timestamp: input.timestamp } : {}
+      });
+    }
+    const assignment = parseAssignmentV1(input.body);
+    return options.onAssignment({ assignment });
+  };
+}
+async function executeWebhook(handler, input) {
+  try {
+    const body = await handler(input);
+    return {
+      status: 200,
+      body
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unexpected webhook error";
+    const sdkError = error instanceof SdkError ? error : new SdkError(message);
+    return {
+      status: 400,
+      body: {
+        status: "timed_out",
+        error: sdkError.message
+      }
+    };
+  }
+}
+
+// src/adapters.ts
+function headerValue(headers, key) {
+  const value = headers[key] ?? headers[key.toLowerCase()];
+  if (Array.isArray(value)) {
+    return value[0];
+  }
+  return value;
+}
+function normalizeBody(body) {
+  if (typeof body === "string") {
+    return body;
+  }
+  if (body === void 0 || body === null) {
+    return "";
+  }
+  return JSON.stringify(body);
+}
+function toWebhookInput(params) {
+  return {
+    body: params.body,
+    ...params.signature ? { signature: params.signature } : {},
+    ...params.timestamp ? { timestamp: params.timestamp } : {}
+  };
+}
+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)
+      })
+    );
+    res.status(result.status).json(result.body);
+  };
+}
+function createFastifyWebhookHandler(options) {
+  const handler = createWebhookHandler(options);
+  return async function fastifyWebhook(request, reply) {
+    const body = request.rawBody ?? normalizeBody(request.body);
+    const result = await executeWebhook(
+      handler,
+      toWebhookInput({
+        body,
+        signature: headerValue(request.headers, DEFAULT_SIGNATURE_HEADER),
+        timestamp: headerValue(request.headers, DEFAULT_TIMESTAMP_HEADER)
+      })
+    );
+    reply.code(result.status).send(result.body);
+  };
+}
+function createNextWebhookHandler(options) {
+  const handler = createWebhookHandler(options);
+  return async function nextWebhook(request) {
+    const body = await request.text();
+    const result = await executeWebhook(
+      handler,
+      toWebhookInput({
+        body,
+        signature: request.headers.get(DEFAULT_SIGNATURE_HEADER) ?? void 0,
+        timestamp: request.headers.get(DEFAULT_TIMESTAMP_HEADER) ?? void 0
+      })
+    );
+    return new Response(JSON.stringify(result.body), {
+      status: result.status,
+      headers: { "content-type": "application/json" }
+    });
+  };
+}
+function createHonoWebhookHandler(options) {
+  const handler = createWebhookHandler(options);
+  return async function honoWebhook(c) {
+    const body = await c.req.text();
+    const result = await executeWebhook(
+      handler,
+      toWebhookInput({
+        body,
+        signature: c.req.header(DEFAULT_SIGNATURE_HEADER),
+        timestamp: c.req.header(DEFAULT_TIMESTAMP_HEADER)
+      })
+    );
+    return c.json(result.body, result.status);
+  };
+}
+
+// src/results.ts
+var DEFAULT_CONTACT_FIELDS = ["email", "phone", "profile_url", "linkedin_url"];
+function hasValue(value) {
+  if (typeof value === "string") {
+    return value.trim().length > 0;
+  }
+  return value !== null && value !== void 0;
+}
+function deriveColumns(rows) {
+  const ordered = [];
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      if (!ordered.includes(key)) {
+        ordered.push(key);
+      }
+    }
+  }
+  return ordered;
+}
+function makeRowKey(row, keys) {
+  const normalized = keys.map((key) => [key, row[key]]);
+  return JSON.stringify(normalized);
+}
+function createTablePayload(rows, options = {}) {
+  const columns = options.columns ?? deriveColumns(rows);
+  const dedupeKeys = options.dedupeBy && options.dedupeBy.length > 0 ? options.dedupeBy : columns;
+  const contactFields = options.contactFields && options.contactFields.length > 0 ? options.contactFields : DEFAULT_CONTACT_FIELDS;
+  const uniqueCount = new Set(rows.map((row) => makeRowKey(row, dedupeKeys))).size;
+  const hasContactMethod = rows.every((row) => contactFields.some((field) => hasValue(row[field])));
+  return {
+    table: {
+      columns,
+      rows
+    },
+    row_count: rows.length,
+    rows_unique: uniqueCount === rows.length,
+    has_contact_method: hasContactMethod,
+    ...options.summary ? { summary: options.summary } : {}
+  };
+}
+function createTableResult(rows, options = {}) {
+  return {
+    result: createTablePayload(rows, options)
+  };
+}
+export {
+  AgentClient,
+  ApiError,
+  DEFAULT_SIGNATURE_HEADER,
+  DEFAULT_TIMESTAMP_HEADER,
+  SdkError,
+  computeWebhookSignature,
+  createExpressWebhookHandler,
+  createFastifyWebhookHandler,
+  createHonoWebhookHandler,
+  createNextWebhookHandler,
+  createTablePayload,
+  createTableResult,
+  createWebhookHandler,
+  executeWebhook,
+  getContractVersion,
+  parseAssignmentV1,
+  toAssignmentEnvelopeV1,
+  verifyWebhookSignature
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/signature.ts","../src/contracts.ts","../src/webhook.ts","../src/adapters.ts","../src/results.ts"],"sourcesContent":["import type { ApiErrorBody } from \"./types\";\n\nexport class SdkError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"SdkError\";\n  }\n}\n\nexport class ApiError extends SdkError {\n  readonly status: number;\n  readonly code: string | undefined;\n  readonly body: ApiErrorBody | null;\n  readonly retryable: boolean;\n\n  constructor(params: {\n    status: number;\n    message: string;\n    code: string | undefined;\n    body: ApiErrorBody | null;\n  }) {\n    super(params.message);\n    this.name = \"ApiError\";\n    this.status = params.status;\n    this.code = params.code;\n    this.body = params.body;\n    this.retryable = params.status === 429 || params.status >= 500;\n  }\n}\n","import { ApiError } from \"./errors\";\nimport type {\n  ApiErrorBody,\n  AssignmentAckRequest,\n  AssignmentResult,\n  SubmitErrorRequest,\n  SubmitResultRequest,\n} from \"./types\";\n\nexport type ClientOptions = {\n  baseUrl: string;\n  apiKey: string;\n  fetchImpl?: typeof fetch;\n};\n\nexport class AgentClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: ClientOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, \"\");\n    this.apiKey = options.apiKey;\n    this.fetchImpl = options.fetchImpl ?? fetch;\n  }\n\n  async ackAssignment(assignmentId: string, request: AssignmentAckRequest): Promise<void> {\n    await this.post(`/agent/assignments/ack`, {\n      assignment_id: assignmentId,\n      ...request,\n    });\n  }\n\n  async submitResult(input: SubmitResultRequest): Promise<void> {\n    const payload: AssignmentResult = {\n      status: input.status,\n      ...(input.result ? { result: input.result } : {}),\n      ...(input.error ? { error: input.error } : {}),\n    };\n\n    await this.post(`/agent/assignments/submit`, {\n      assignment_id: input.assignmentId,\n      ...payload,\n    });\n  }\n\n  async submitError(input: SubmitErrorRequest): Promise<void> {\n    await this.submitResult({\n      assignmentId: input.assignmentId,\n      status: \"timed_out\",\n      error: input.error,\n      ...(input.details ? { result: { details: input.details } } : {}),\n    });\n  }\n\n  private async post(path: string, body: Record<string, unknown>): Promise<void> {\n    const response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        authorization: `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      throw await this.toApiError(response);\n    }\n  }\n\n  private async toApiError(response: Response): Promise<ApiError> {\n    const raw = await response.text();\n    let parsed: ApiErrorBody | null = null;\n\n    if (raw) {\n      try {\n        parsed = JSON.parse(raw) as ApiErrorBody;\n      } catch {\n        parsed = { message: raw };\n      }\n    }\n\n    return new ApiError({\n      status: response.status,\n      message:\n        parsed?.message ?? `API request failed (${response.status}): ${raw || response.statusText}`,\n      code: parsed?.code,\n      body: parsed,\n    });\n  }\n}\n","import { createHmac, timingSafeEqual } from \"node:crypto\";\nimport { SdkError } from \"./errors\";\n\nexport function computeWebhookSignature(params: {\n  webhookSecret: string;\n  timestamp: string;\n  body: string;\n}) {\n  const signedPayload = `${params.timestamp}.${params.body}`;\n  const digest = createHmac(\"sha256\", params.webhookSecret)\n    .update(signedPayload, \"utf8\")\n    .digest(\"hex\");\n  return `sha256=${digest}`;\n}\n\nexport function verifyWebhookSignature(params: {\n  webhookSecret: string;\n  timestamp?: string;\n  body: string;\n  signature?: string;\n}) {\n  if (!params.timestamp || !params.signature) {\n    throw new SdkError(\"Missing webhook timestamp or signature\");\n  }\n\n  const expected = computeWebhookSignature({\n    webhookSecret: params.webhookSecret,\n    timestamp: params.timestamp,\n    body: params.body,\n  });\n\n  const expectedBuffer = Buffer.from(expected, \"utf8\");\n  const actualBuffer = Buffer.from(params.signature, \"utf8\");\n\n  if (expectedBuffer.length !== actualBuffer.length) {\n    throw new SdkError(\"Invalid webhook signature\");\n  }\n\n  if (!timingSafeEqual(expectedBuffer, actualBuffer)) {\n    throw new SdkError(\"Invalid webhook signature\");\n  }\n}\n","import { SdkError } from \"./errors\";\nimport type { Assignment, AssignmentEnvelopeV1, AssignmentResultSchema, SdkContractVersion } from \"./types\";\n\nconst CONTRACT_VERSION: SdkContractVersion = \"v1\";\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\";\n}\n\nfunction parseAssignmentRecord(record: Record<string, unknown>): Assignment {\n  if (typeof record.assignment_id !== \"string\") {\n    throw new SdkError(\"Missing assignment_id\");\n  }\n  if (typeof record.template_slug !== \"string\") {\n    throw new SdkError(\"Missing template_slug\");\n  }\n  if (!isObject(record.outcome)) {\n    throw new SdkError(\"Missing outcome\");\n  }\n  if (!isObject(record.result_schema)) {\n    throw new SdkError(\"Missing result_schema\");\n  }\n\n  const outcome = record.outcome;\n  if (typeof outcome.title !== \"string\") {\n    throw new SdkError(\"Missing outcome.title\");\n  }\n  if (!isObject(outcome.payload)) {\n    throw new SdkError(\"Missing outcome.payload\");\n  }\n\n  const parsedResultSchema = record.result_schema as AssignmentResultSchema;\n\n  return {\n    assignment_id: record.assignment_id,\n    template_slug: record.template_slug,\n    result_schema: parsedResultSchema,\n    outcome: {\n      title: outcome.title,\n      payload: outcome.payload,\n      ...(typeof outcome.requested_unit_price_value === \"number\"\n        ? { requested_unit_price_value: outcome.requested_unit_price_value }\n        : {}),\n      ...(typeof outcome.requested_total_price_value === \"number\"\n        ? { requested_total_price_value: outcome.requested_total_price_value }\n        : {}),\n      ...(typeof outcome.currency === \"string\" ? { currency: outcome.currency } : {}),\n      ...(typeof outcome.time_window === \"string\" ? { time_window: outcome.time_window } : {}),\n    },\n  };\n}\n\nexport function parseAssignmentV1(body: string): Assignment {\n  let payload: unknown;\n  try {\n    payload = JSON.parse(body);\n  } catch {\n    throw new SdkError(\"Invalid JSON payload\");\n  }\n\n  if (!isObject(payload)) {\n    throw new SdkError(\"Invalid assignment payload\");\n  }\n\n  if (payload.version !== CONTRACT_VERSION) {\n    throw new SdkError(\"Unsupported assignment contract version\");\n  }\n  if (!isObject(payload.assignment)) {\n    throw new SdkError(\"Missing assignment envelope payload\");\n  }\n\n  return parseAssignmentRecord(payload.assignment);\n}\n\nexport function toAssignmentEnvelopeV1(assignment: Assignment): AssignmentEnvelopeV1 {\n  return {\n    version: CONTRACT_VERSION,\n    assignment,\n  };\n}\n\nexport function getContractVersion(): SdkContractVersion {\n  return CONTRACT_VERSION;\n}\n","import { SdkError } from \"./errors\";\nimport { parseAssignmentV1 } from \"./contracts\";\nimport { verifyWebhookSignature } from \"./signature\";\nimport type { Assignment, AssignmentResult, WebhookInput } from \"./types\";\n\nexport const DEFAULT_SIGNATURE_HEADER = \"x-bounty-signature\";\nexport const DEFAULT_TIMESTAMP_HEADER = \"x-bounty-timestamp\";\n\nexport type WebhookHandlerOptions = {\n  webhookSecret: string;\n  onAssignment: (params: { assignment: Assignment }) => Promise<AssignmentResult>;\n  verifySignature?: boolean;\n};\n\nexport type WebhookHttpResponse = {\n  status: number;\n  body: AssignmentResult;\n};\n\nexport function createWebhookHandler(options: WebhookHandlerOptions) {\n  const shouldVerify = options.verifySignature ?? true;\n\n  return async function handleWebhook(input: WebhookInput): Promise<AssignmentResult> {\n    if (shouldVerify) {\n      verifyWebhookSignature({\n        webhookSecret: options.webhookSecret,\n        body: input.body,\n        ...(input.signature ? { signature: input.signature } : {}),\n        ...(input.timestamp ? { timestamp: input.timestamp } : {}),\n      });\n    }\n\n    const assignment = parseAssignmentV1(input.body);\n    return options.onAssignment({ assignment });\n  };\n}\n\nexport async function executeWebhook(\n  handler: ReturnType<typeof createWebhookHandler>,\n  input: WebhookInput,\n): Promise<WebhookHttpResponse> {\n  try {\n    const body = await handler(input);\n    return {\n      status: 200,\n      body,\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : \"Unexpected webhook error\";\n    const sdkError = error instanceof SdkError ? error : new SdkError(message);\n    return {\n      status: 400,\n      body: {\n        status: \"timed_out\",\n        error: sdkError.message,\n      },\n    };\n  }\n}\n","import {\n  DEFAULT_SIGNATURE_HEADER,\n  DEFAULT_TIMESTAMP_HEADER,\n  createWebhookHandler,\n  executeWebhook,\n  type WebhookHandlerOptions,\n} from \"./webhook\";\n\nfunction headerValue(headers: Record<string, string | string[] | undefined>, key: string) {\n  const value = headers[key] ?? headers[key.toLowerCase()];\n  if (Array.isArray(value)) {\n    return value[0];\n  }\n  return value;\n}\n\nfunction normalizeBody(body: unknown): string {\n  if (typeof body === \"string\") {\n    return body;\n  }\n  if (body === undefined || body === null) {\n    return \"\";\n  }\n  return JSON.stringify(body);\n}\n\nfunction toWebhookInput(params: {\n  body: string;\n  signature: string | undefined;\n  timestamp: string | undefined;\n}) {\n  return {\n    body: params.body,\n    ...(params.signature ? { signature: params.signature } : {}),\n    ...(params.timestamp ? { timestamp: params.timestamp } : {}),\n  };\n}\n\nexport function createExpressWebhookHandler(options: WebhookHandlerOptions) {\n  const handler = createWebhookHandler(options);\n\n  return async function expressWebhook(\n    req: {\n      headers: Record<string, string | string[] | undefined>;\n      body?: unknown;\n      rawBody?: string;\n    },\n    res: {\n      status: (code: number) => { json: (payload: unknown) => void };\n    },\n  ) {\n    const body = req.rawBody ?? normalizeBody(req.body);\n    const result = await executeWebhook(\n      handler,\n      toWebhookInput({\n        body,\n        signature: headerValue(req.headers, DEFAULT_SIGNATURE_HEADER),\n        timestamp: headerValue(req.headers, DEFAULT_TIMESTAMP_HEADER),\n      }),\n    );\n\n    res.status(result.status).json(result.body);\n  };\n}\n\nexport function createFastifyWebhookHandler(options: WebhookHandlerOptions) {\n  const handler = createWebhookHandler(options);\n\n  return async function fastifyWebhook(\n    request: {\n      headers: Record<string, string | string[] | undefined>;\n      body?: unknown;\n      rawBody?: string;\n    },\n    reply: {\n      code: (statusCode: number) => { send: (payload: unknown) => void };\n    },\n  ) {\n    const body = request.rawBody ?? normalizeBody(request.body);\n    const result = await executeWebhook(\n      handler,\n      toWebhookInput({\n        body,\n        signature: headerValue(request.headers, DEFAULT_SIGNATURE_HEADER),\n        timestamp: headerValue(request.headers, DEFAULT_TIMESTAMP_HEADER),\n      }),\n    );\n\n    reply.code(result.status).send(result.body);\n  };\n}\n\nexport function createNextWebhookHandler(options: WebhookHandlerOptions) {\n  const handler = createWebhookHandler(options);\n\n  return async function nextWebhook(request: Request): Promise<Response> {\n    const body = await request.text();\n    const result = await executeWebhook(\n      handler,\n      toWebhookInput({\n        body,\n        signature: request.headers.get(DEFAULT_SIGNATURE_HEADER) ?? undefined,\n        timestamp: request.headers.get(DEFAULT_TIMESTAMP_HEADER) ?? undefined,\n      }),\n    );\n\n    return new Response(JSON.stringify(result.body), {\n      status: result.status,\n      headers: { \"content-type\": \"application/json\" },\n    });\n  };\n}\n\nexport function createHonoWebhookHandler(options: WebhookHandlerOptions) {\n  const handler = createWebhookHandler(options);\n\n  return async function honoWebhook(c: {\n    req: {\n      text: () => Promise<string>;\n      header: (name: string) => string | undefined;\n    };\n    json: (payload: unknown, status?: number) => Response;\n  }) {\n    const body = await c.req.text();\n    const result = await executeWebhook(\n      handler,\n      toWebhookInput({\n        body,\n        signature: c.req.header(DEFAULT_SIGNATURE_HEADER),\n        timestamp: c.req.header(DEFAULT_TIMESTAMP_HEADER),\n      }),\n    );\n\n    return c.json(result.body, result.status);\n  };\n}\n","import type { AssignmentResult } from \"./types\";\n\nexport type TableRow = Record<string, unknown>;\n\nexport type TablePayload = {\n  table: {\n    columns: string[];\n    rows: TableRow[];\n  };\n  row_count: number;\n  rows_unique: boolean;\n  has_contact_method: boolean;\n  summary?: string;\n};\n\nexport type CreateTableResultOptions = {\n  columns?: string[];\n  summary?: string;\n  contactFields?: string[];\n  dedupeBy?: string[];\n};\n\nconst DEFAULT_CONTACT_FIELDS = [\"email\", \"phone\", \"profile_url\", \"linkedin_url\"];\n\nfunction hasValue(value: unknown) {\n  if (typeof value === \"string\") {\n    return value.trim().length > 0;\n  }\n  return value !== null && value !== undefined;\n}\n\nfunction deriveColumns(rows: TableRow[]) {\n  const ordered: string[] = [];\n  for (const row of rows) {\n    for (const key of Object.keys(row)) {\n      if (!ordered.includes(key)) {\n        ordered.push(key);\n      }\n    }\n  }\n  return ordered;\n}\n\nfunction makeRowKey(row: TableRow, keys: string[]) {\n  const normalized = keys.map((key) => [key, row[key]]);\n  return JSON.stringify(normalized);\n}\n\nexport function createTablePayload(\n  rows: TableRow[],\n  options: CreateTableResultOptions = {},\n): TablePayload {\n  const columns = options.columns ?? deriveColumns(rows);\n  const dedupeKeys = options.dedupeBy && options.dedupeBy.length > 0 ? options.dedupeBy : columns;\n  const contactFields =\n    options.contactFields && options.contactFields.length > 0\n      ? options.contactFields\n      : DEFAULT_CONTACT_FIELDS;\n\n  const uniqueCount = new Set(rows.map((row) => makeRowKey(row, dedupeKeys))).size;\n  const hasContactMethod = rows.every((row) => contactFields.some((field) => hasValue(row[field])));\n\n  return {\n    table: {\n      columns,\n      rows,\n    },\n    row_count: rows.length,\n    rows_unique: uniqueCount === rows.length,\n    has_contact_method: hasContactMethod,\n    ...(options.summary ? { summary: options.summary } : {}),\n  };\n}\n\nexport function createTableResult(\n  rows: TableRow[],\n  options: CreateTableResultOptions = {},\n): Pick<AssignmentResult, \"result\"> {\n  return {\n    result: createTablePayload(rows, options),\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@bounty-ai/agent-sdk",
+  "version": "0.1.0",
+  "description": "Bounty agent SDK for receiving assignments and submitting results",
+  "main": "./dist/index.cjs",
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "build": "tsup src/index.ts --format esm,cjs --dts --sourcemap --clean --target node18",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --sourcemap --watch --target node18",
+    "clean": "rimraf dist",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run clean && npm run lint && npm run typecheck && npm run test && npm run build"
+  },
+  "keywords": [
+    "bounty",
+    "agent",
+    "sdk",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^25.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "eslint": "^9.39.2",
+    "globals": "^17.3.0",
+    "jiti": "^2.6.1",
+    "rimraf": "^6.1.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.0",
+    "vitest": "^4.0.18"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}