@agent-receipts/schema 0.1.0

package/dist/index.js

@@ -0,0 +1,260 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ActionReceipt: () => ActionReceipt,
+  CompleteReceiptInput: () => CompleteReceiptInput,
+  CreateReceiptInput: () => CreateReceiptInput,
+  Environment: () => Environment,
+  ErrorCode: () => ErrorCode,
+  ErrorResponse: () => ErrorResponse,
+  ListReceiptsQuery: () => ListReceiptsQuery,
+  PaginationMeta: () => PaginationMeta,
+  ReceiptStatus: () => ReceiptStatus,
+  ReceiptType: () => ReceiptType,
+  SignablePayload: () => SignablePayload,
+  VerifyResponse: () => VerifyResponse,
+  createErrorResponse: () => createErrorResponse,
+  formatZodError: () => formatZodError,
+  validate: () => validate
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/enums.ts
+var import_zod = require("zod");
+var ReceiptStatus = import_zod.z.enum(["pending", "completed", "failed", "timeout"]);
+var ReceiptType = import_zod.z.enum(["action", "verification", "judgment", "arbitration"]);
+var Environment = import_zod.z.enum(["production", "staging", "test"]);
+var ErrorCode = import_zod.z.enum([
+  "UNAUTHORIZED",
+  "KEY_REVOKED",
+  "FORBIDDEN",
+  "RECEIPT_NOT_FOUND",
+  "CHAIN_NOT_FOUND",
+  "AGENT_NOT_FOUND",
+  "RECEIPT_NOT_PENDING",
+  "RECEIPT_IMMUTABLE",
+  "RATE_LIMIT_EXCEEDED",
+  "VALIDATION_ERROR",
+  "INTERNAL_ERROR"
+]);
+
+// src/receipt.ts
+var import_zod2 = require("zod");
+var SignablePayload = import_zod2.z.object({
+  receipt_id: import_zod2.z.string(),
+  chain_id: import_zod2.z.string(),
+  receipt_type: ReceiptType,
+  agent_id: import_zod2.z.string(),
+  org_id: import_zod2.z.string(),
+  action: import_zod2.z.string(),
+  input_hash: import_zod2.z.string(),
+  output_hash: import_zod2.z.string().nullable(),
+  status: ReceiptStatus,
+  timestamp: import_zod2.z.string().datetime(),
+  completed_at: import_zod2.z.string().datetime().nullable(),
+  environment: Environment
+});
+var ActionReceipt = import_zod2.z.object({
+  // Identity
+  receipt_id: import_zod2.z.string(),
+  parent_receipt_id: import_zod2.z.string().nullable(),
+  chain_id: import_zod2.z.string(),
+  // Type
+  receipt_type: ReceiptType,
+  // Who
+  agent_id: import_zod2.z.string(),
+  org_id: import_zod2.z.string(),
+  // What
+  action: import_zod2.z.string(),
+  input_hash: import_zod2.z.string(),
+  output_hash: import_zod2.z.string().nullable(),
+  output_summary: import_zod2.z.string().nullable(),
+  // How (all nullable — may not be known at creation)
+  model: import_zod2.z.string().nullable(),
+  tokens_in: import_zod2.z.number().int().nonnegative().nullable(),
+  tokens_out: import_zod2.z.number().int().nonnegative().nullable(),
+  cost_usd: import_zod2.z.number().nonnegative().nullable(),
+  latency_ms: import_zod2.z.number().int().nonnegative().nullable(),
+  tool_calls: import_zod2.z.array(import_zod2.z.string()).nullable(),
+  // When
+  timestamp: import_zod2.z.string().datetime(),
+  completed_at: import_zod2.z.string().datetime().nullable(),
+  // Status
+  status: ReceiptStatus,
+  error: import_zod2.z.record(import_zod2.z.unknown()).nullable(),
+  // Context
+  environment: Environment,
+  tags: import_zod2.z.array(import_zod2.z.string()).nullable(),
+  // Verification (Tier 2 — Phase 6)
+  constraints: import_zod2.z.record(import_zod2.z.unknown()).nullable(),
+  constraint_result: import_zod2.z.record(import_zod2.z.unknown()).nullable(),
+  // Trust
+  signature: import_zod2.z.string(),
+  verify_url: import_zod2.z.string().url(),
+  // Optional
+  callback_verified: import_zod2.z.boolean().nullable(),
+  confidence: import_zod2.z.number().min(0).max(1).nullable(),
+  metadata: import_zod2.z.record(import_zod2.z.unknown())
+});
+
+// src/api.ts
+var import_zod3 = require("zod");
+var CreateReceiptInput = import_zod3.z.object({
+  // Required
+  agent_id: import_zod3.z.string().min(1),
+  action: import_zod3.z.string().min(1),
+  input_hash: import_zod3.z.string().min(1),
+  // Optional with defaults
+  receipt_type: ReceiptType.default("action"),
+  status: ReceiptStatus.default("pending"),
+  environment: Environment.default("production"),
+  // Optional
+  parent_receipt_id: import_zod3.z.string().nullable().optional(),
+  output_hash: import_zod3.z.string().nullable().optional(),
+  output_summary: import_zod3.z.string().nullable().optional(),
+  model: import_zod3.z.string().nullable().optional(),
+  tokens_in: import_zod3.z.number().int().nonnegative().nullable().optional(),
+  tokens_out: import_zod3.z.number().int().nonnegative().nullable().optional(),
+  cost_usd: import_zod3.z.number().nonnegative().nullable().optional(),
+  latency_ms: import_zod3.z.number().int().nonnegative().nullable().optional(),
+  tool_calls: import_zod3.z.array(import_zod3.z.string()).nullable().optional(),
+  tags: import_zod3.z.array(import_zod3.z.string()).nullable().optional(),
+  confidence: import_zod3.z.number().min(0).max(1).nullable().optional(),
+  callback_verified: import_zod3.z.boolean().nullable().optional(),
+  metadata: import_zod3.z.record(import_zod3.z.unknown()).optional()
+});
+var CompleteReceiptInput = import_zod3.z.object({
+  // Required — must transition from pending
+  status: import_zod3.z.enum(["completed", "failed", "timeout"]),
+  // Execution results (all optional — set what you know)
+  output_hash: import_zod3.z.string().nullable().optional(),
+  output_summary: import_zod3.z.string().nullable().optional(),
+  model: import_zod3.z.string().nullable().optional(),
+  tokens_in: import_zod3.z.number().int().nonnegative().nullable().optional(),
+  tokens_out: import_zod3.z.number().int().nonnegative().nullable().optional(),
+  cost_usd: import_zod3.z.number().nonnegative().nullable().optional(),
+  latency_ms: import_zod3.z.number().int().nonnegative().nullable().optional(),
+  tool_calls: import_zod3.z.array(import_zod3.z.string()).nullable().optional(),
+  confidence: import_zod3.z.number().min(0).max(1).nullable().optional(),
+  callback_verified: import_zod3.z.boolean().nullable().optional(),
+  error: import_zod3.z.record(import_zod3.z.unknown()).nullable().optional()
+});
+var VerifyResponse = import_zod3.z.object({
+  verified: import_zod3.z.boolean(),
+  receipt: import_zod3.z.object({
+    receipt_id: import_zod3.z.string(),
+    chain_id: import_zod3.z.string(),
+    receipt_type: ReceiptType,
+    agent_id: import_zod3.z.string(),
+    action: import_zod3.z.string(),
+    status: ReceiptStatus,
+    input_hash: import_zod3.z.string(),
+    output_hash: import_zod3.z.string().nullable(),
+    signature: import_zod3.z.string(),
+    timestamp: import_zod3.z.string().datetime(),
+    completed_at: import_zod3.z.string().datetime().nullable(),
+    environment: Environment,
+    latency_ms: import_zod3.z.number().int().nonnegative().nullable()
+  }),
+  signature_valid: import_zod3.z.boolean(),
+  chain_length: import_zod3.z.number().int().nonnegative(),
+  public_key_url: import_zod3.z.string().url()
+});
+var ListReceiptsQuery = import_zod3.z.object({
+  page: import_zod3.z.coerce.number().int().positive().default(1),
+  limit: import_zod3.z.coerce.number().int().positive().max(100).default(50),
+  agent_id: import_zod3.z.string().optional(),
+  action: import_zod3.z.string().optional(),
+  status: ReceiptStatus.optional(),
+  environment: Environment.optional(),
+  receipt_type: ReceiptType.optional(),
+  chain_id: import_zod3.z.string().optional(),
+  tag: import_zod3.z.string().optional(),
+  from: import_zod3.z.string().datetime().optional(),
+  to: import_zod3.z.string().datetime().optional(),
+  sort: import_zod3.z.string().regex(/^(created_at|completed_at|latency_ms|cost_usd):(asc|desc)$/).default("created_at:desc")
+});
+var PaginationMeta = import_zod3.z.object({
+  page: import_zod3.z.number().int().positive(),
+  limit: import_zod3.z.number().int().positive(),
+  total: import_zod3.z.number().int().nonnegative(),
+  total_pages: import_zod3.z.number().int().nonnegative(),
+  has_next: import_zod3.z.boolean(),
+  has_prev: import_zod3.z.boolean()
+});
+var ErrorResponse = import_zod3.z.object({
+  error: import_zod3.z.object({
+    code: ErrorCode,
+    message: import_zod3.z.string(),
+    status: import_zod3.z.number().int()
+  })
+});
+
+// src/validation.ts
+function validate(schema, data) {
+  const result = schema.safeParse(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return {
+    success: false,
+    error: createErrorResponse(
+      "VALIDATION_ERROR",
+      formatZodError(result.error),
+      400
+    )
+  };
+}
+function formatZodError(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
+    return `${path}${issue.message}`;
+  }).join("; ");
+}
+function createErrorResponse(code, message, status) {
+  return {
+    error: {
+      code,
+      message,
+      status
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ActionReceipt,
+  CompleteReceiptInput,
+  CreateReceiptInput,
+  Environment,
+  ErrorCode,
+  ErrorResponse,
+  ListReceiptsQuery,
+  PaginationMeta,
+  ReceiptStatus,
+  ReceiptType,
+  SignablePayload,
+  VerifyResponse,
+  createErrorResponse,
+  formatZodError,
+  validate
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/enums.ts","../src/receipt.ts","../src/api.ts","../src/validation.ts"],"sourcesContent":["// Enums\nexport { ReceiptStatus, ReceiptType, Environment, ErrorCode } from './enums'\n\n// Receipt schemas + types\nexport { SignablePayload, ActionReceipt } from './receipt'\n\n// API schemas + types\nexport {\n  CreateReceiptInput,\n  CompleteReceiptInput,\n  VerifyResponse,\n  ListReceiptsQuery,\n  PaginationMeta,\n  ErrorResponse,\n} from './api'\n\n// Validation utilities\nexport { validate, formatZodError, createErrorResponse } from './validation'\n\n// Re-export types explicitly for consumers who import types only\nexport type {\n  ReceiptStatus as ReceiptStatusType,\n  ReceiptType as ReceiptTypeType,\n  Environment as EnvironmentType,\n  ErrorCode as ErrorCodeType,\n} from './enums'\n","import { z } from 'zod'\n\nexport const ReceiptStatus = z.enum(['pending', 'completed', 'failed', 'timeout'])\nexport type ReceiptStatus = z.infer<typeof ReceiptStatus>\n\nexport const ReceiptType = z.enum(['action', 'verification', 'judgment', 'arbitration'])\nexport type ReceiptType = z.infer<typeof ReceiptType>\n\nexport const Environment = z.enum(['production', 'staging', 'test'])\nexport type Environment = z.infer<typeof Environment>\n\nexport const ErrorCode = z.enum([\n  'UNAUTHORIZED',\n  'KEY_REVOKED',\n  'FORBIDDEN',\n  'RECEIPT_NOT_FOUND',\n  'CHAIN_NOT_FOUND',\n  'AGENT_NOT_FOUND',\n  'RECEIPT_NOT_PENDING',\n  'RECEIPT_IMMUTABLE',\n  'RATE_LIMIT_EXCEEDED',\n  'VALIDATION_ERROR',\n  'INTERNAL_ERROR',\n])\nexport type ErrorCode = z.infer<typeof ErrorCode>\n","import { z } from 'zod'\nimport { ReceiptStatus, ReceiptType, Environment } from './enums'\n\n/**\n * The 12 fields that are cryptographically signed.\n * These fields are extracted from a receipt and serialized as canonical JSON\n * before signing with Ed25519.\n */\nexport const SignablePayload = z.object({\n  receipt_id: z.string(),\n  chain_id: z.string(),\n  receipt_type: ReceiptType,\n  agent_id: z.string(),\n  org_id: z.string(),\n  action: z.string(),\n  input_hash: z.string(),\n  output_hash: z.string().nullable(),\n  status: ReceiptStatus,\n  timestamp: z.string().datetime(),\n  completed_at: z.string().datetime().nullable(),\n  environment: Environment,\n})\nexport type SignablePayload = z.infer<typeof SignablePayload>\n\n/**\n * The complete receipt object as returned by the API.\n */\nexport const ActionReceipt = z.object({\n  // Identity\n  receipt_id: z.string(),\n  parent_receipt_id: z.string().nullable(),\n  chain_id: z.string(),\n\n  // Type\n  receipt_type: ReceiptType,\n\n  // Who\n  agent_id: z.string(),\n  org_id: z.string(),\n\n  // What\n  action: z.string(),\n  input_hash: z.string(),\n  output_hash: z.string().nullable(),\n  output_summary: z.string().nullable(),\n\n  // How (all nullable — may not be known at creation)\n  model: z.string().nullable(),\n  tokens_in: z.number().int().nonnegative().nullable(),\n  tokens_out: z.number().int().nonnegative().nullable(),\n  cost_usd: z.number().nonnegative().nullable(),\n  latency_ms: z.number().int().nonnegative().nullable(),\n  tool_calls: z.array(z.string()).nullable(),\n\n  // When\n  timestamp: z.string().datetime(),\n  completed_at: z.string().datetime().nullable(),\n\n  // Status\n  status: ReceiptStatus,\n  error: z.record(z.unknown()).nullable(),\n\n  // Context\n  environment: Environment,\n  tags: z.array(z.string()).nullable(),\n\n  // Verification (Tier 2 — Phase 6)\n  constraints: z.record(z.unknown()).nullable(),\n  constraint_result: z.record(z.unknown()).nullable(),\n\n  // Trust\n  signature: z.string(),\n  verify_url: z.string().url(),\n\n  // Optional\n  callback_verified: z.boolean().nullable(),\n  confidence: z.number().min(0).max(1).nullable(),\n  metadata: z.record(z.unknown()),\n})\nexport type ActionReceipt = z.infer<typeof ActionReceipt>\n","import { z } from 'zod'\nimport { ReceiptStatus, ReceiptType, Environment, ErrorCode } from './enums'\n\n/**\n * What the client sends to POST /api/v1/receipts.\n */\nexport const CreateReceiptInput = z.object({\n  // Required\n  agent_id: z.string().min(1),\n  action: z.string().min(1),\n  input_hash: z.string().min(1),\n\n  // Optional with defaults\n  receipt_type: ReceiptType.default('action'),\n  status: ReceiptStatus.default('pending'),\n  environment: Environment.default('production'),\n\n  // Optional\n  parent_receipt_id: z.string().nullable().optional(),\n  output_hash: z.string().nullable().optional(),\n  output_summary: z.string().nullable().optional(),\n  model: z.string().nullable().optional(),\n  tokens_in: z.number().int().nonnegative().nullable().optional(),\n  tokens_out: z.number().int().nonnegative().nullable().optional(),\n  cost_usd: z.number().nonnegative().nullable().optional(),\n  latency_ms: z.number().int().nonnegative().nullable().optional(),\n  tool_calls: z.array(z.string()).nullable().optional(),\n  tags: z.array(z.string()).nullable().optional(),\n  confidence: z.number().min(0).max(1).nullable().optional(),\n  callback_verified: z.boolean().nullable().optional(),\n  metadata: z.record(z.unknown()).optional(),\n})\nexport type CreateReceiptInput = z.infer<typeof CreateReceiptInput>\n\n/**\n * What the client sends to PATCH /api/v1/receipts/:id/complete.\n */\nexport const CompleteReceiptInput = z.object({\n  // Required — must transition from pending\n  status: z.enum(['completed', 'failed', 'timeout']),\n\n  // Execution results (all optional — set what you know)\n  output_hash: z.string().nullable().optional(),\n  output_summary: z.string().nullable().optional(),\n  model: z.string().nullable().optional(),\n  tokens_in: z.number().int().nonnegative().nullable().optional(),\n  tokens_out: z.number().int().nonnegative().nullable().optional(),\n  cost_usd: z.number().nonnegative().nullable().optional(),\n  latency_ms: z.number().int().nonnegative().nullable().optional(),\n  tool_calls: z.array(z.string()).nullable().optional(),\n  confidence: z.number().min(0).max(1).nullable().optional(),\n  callback_verified: z.boolean().nullable().optional(),\n  error: z.record(z.unknown()).nullable().optional(),\n})\nexport type CompleteReceiptInput = z.infer<typeof CompleteReceiptInput>\n\n/**\n * What GET /api/v1/verify/:id returns.\n * Note: Does NOT include org_id, metadata, tags, or output_summary (org-private).\n */\nexport const VerifyResponse = z.object({\n  verified: z.boolean(),\n  receipt: z.object({\n    receipt_id: z.string(),\n    chain_id: z.string(),\n    receipt_type: ReceiptType,\n    agent_id: z.string(),\n    action: z.string(),\n    status: ReceiptStatus,\n    input_hash: z.string(),\n    output_hash: z.string().nullable(),\n    signature: z.string(),\n    timestamp: z.string().datetime(),\n    completed_at: z.string().datetime().nullable(),\n    environment: Environment,\n    latency_ms: z.number().int().nonnegative().nullable(),\n  }),\n  signature_valid: z.boolean(),\n  chain_length: z.number().int().nonnegative(),\n  public_key_url: z.string().url(),\n})\nexport type VerifyResponse = z.infer<typeof VerifyResponse>\n\n/**\n * Query parameters for GET /api/v1/receipts.\n */\nexport const ListReceiptsQuery = z.object({\n  page: z.coerce.number().int().positive().default(1),\n  limit: z.coerce.number().int().positive().max(100).default(50),\n  agent_id: z.string().optional(),\n  action: z.string().optional(),\n  status: ReceiptStatus.optional(),\n  environment: Environment.optional(),\n  receipt_type: ReceiptType.optional(),\n  chain_id: z.string().optional(),\n  tag: z.string().optional(),\n  from: z.string().datetime().optional(),\n  to: z.string().datetime().optional(),\n  sort: z.string().regex(/^(created_at|completed_at|latency_ms|cost_usd):(asc|desc)$/).default('created_at:desc'),\n})\nexport type ListReceiptsQuery = z.infer<typeof ListReceiptsQuery>\n\n/**\n * Pagination metadata included in list responses.\n */\nexport const PaginationMeta = z.object({\n  page: z.number().int().positive(),\n  limit: z.number().int().positive(),\n  total: z.number().int().nonnegative(),\n  total_pages: z.number().int().nonnegative(),\n  has_next: z.boolean(),\n  has_prev: z.boolean(),\n})\nexport type PaginationMeta = z.infer<typeof PaginationMeta>\n\n/**\n * Standard error response format.\n */\nexport const ErrorResponse = z.object({\n  error: z.object({\n    code: ErrorCode,\n    message: z.string(),\n    status: z.number().int(),\n  }),\n})\nexport type ErrorResponse = z.infer<typeof ErrorResponse>\n","import { z } from 'zod'\nimport type { ErrorResponse } from './api'\n\n/**\n * Validate data against a Zod schema.\n * Returns { success: true, data } or { success: false, error: ErrorResponse }\n */\nexport function validate<T extends z.ZodSchema>(\n  schema: T,\n  data: unknown\n): { success: true; data: z.infer<T> } | { success: false; error: ErrorResponse } {\n  const result = schema.safeParse(data)\n  if (result.success) {\n    return { success: true, data: result.data }\n  }\n  return {\n    success: false,\n    error: createErrorResponse(\n      'VALIDATION_ERROR',\n      formatZodError(result.error),\n      400\n    ),\n  }\n}\n\n/**\n * Format Zod errors into a human-readable message.\n */\nexport function formatZodError(error: z.ZodError): string {\n  return error.issues\n    .map((issue) => {\n      const path = issue.path.length > 0 ? `${issue.path.join('.')}: ` : ''\n      return `${path}${issue.message}`\n    })\n    .join('; ')\n}\n\n/**\n * Create a standard error response object.\n */\nexport function createErrorResponse(\n  code: string,\n  message: string,\n  status: number\n): ErrorResponse {\n  return {\n    error: {\n      code: code as ErrorResponse['error']['code'],\n      message,\n      status,\n    },\n  }\n}\n"],"mappings":"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","names":["import_zod","import_zod"]}

package/dist/index.mjs

@@ -0,0 +1,219 @@
+// src/enums.ts
+import { z } from "zod";
+var ReceiptStatus = z.enum(["pending", "completed", "failed", "timeout"]);
+var ReceiptType = z.enum(["action", "verification", "judgment", "arbitration"]);
+var Environment = z.enum(["production", "staging", "test"]);
+var ErrorCode = z.enum([
+  "UNAUTHORIZED",
+  "KEY_REVOKED",
+  "FORBIDDEN",
+  "RECEIPT_NOT_FOUND",
+  "CHAIN_NOT_FOUND",
+  "AGENT_NOT_FOUND",
+  "RECEIPT_NOT_PENDING",
+  "RECEIPT_IMMUTABLE",
+  "RATE_LIMIT_EXCEEDED",
+  "VALIDATION_ERROR",
+  "INTERNAL_ERROR"
+]);
+
+// src/receipt.ts
+import { z as z2 } from "zod";
+var SignablePayload = z2.object({
+  receipt_id: z2.string(),
+  chain_id: z2.string(),
+  receipt_type: ReceiptType,
+  agent_id: z2.string(),
+  org_id: z2.string(),
+  action: z2.string(),
+  input_hash: z2.string(),
+  output_hash: z2.string().nullable(),
+  status: ReceiptStatus,
+  timestamp: z2.string().datetime(),
+  completed_at: z2.string().datetime().nullable(),
+  environment: Environment
+});
+var ActionReceipt = z2.object({
+  // Identity
+  receipt_id: z2.string(),
+  parent_receipt_id: z2.string().nullable(),
+  chain_id: z2.string(),
+  // Type
+  receipt_type: ReceiptType,
+  // Who
+  agent_id: z2.string(),
+  org_id: z2.string(),
+  // What
+  action: z2.string(),
+  input_hash: z2.string(),
+  output_hash: z2.string().nullable(),
+  output_summary: z2.string().nullable(),
+  // How (all nullable — may not be known at creation)
+  model: z2.string().nullable(),
+  tokens_in: z2.number().int().nonnegative().nullable(),
+  tokens_out: z2.number().int().nonnegative().nullable(),
+  cost_usd: z2.number().nonnegative().nullable(),
+  latency_ms: z2.number().int().nonnegative().nullable(),
+  tool_calls: z2.array(z2.string()).nullable(),
+  // When
+  timestamp: z2.string().datetime(),
+  completed_at: z2.string().datetime().nullable(),
+  // Status
+  status: ReceiptStatus,
+  error: z2.record(z2.unknown()).nullable(),
+  // Context
+  environment: Environment,
+  tags: z2.array(z2.string()).nullable(),
+  // Verification (Tier 2 — Phase 6)
+  constraints: z2.record(z2.unknown()).nullable(),
+  constraint_result: z2.record(z2.unknown()).nullable(),
+  // Trust
+  signature: z2.string(),
+  verify_url: z2.string().url(),
+  // Optional
+  callback_verified: z2.boolean().nullable(),
+  confidence: z2.number().min(0).max(1).nullable(),
+  metadata: z2.record(z2.unknown())
+});
+
+// src/api.ts
+import { z as z3 } from "zod";
+var CreateReceiptInput = z3.object({
+  // Required
+  agent_id: z3.string().min(1),
+  action: z3.string().min(1),
+  input_hash: z3.string().min(1),
+  // Optional with defaults
+  receipt_type: ReceiptType.default("action"),
+  status: ReceiptStatus.default("pending"),
+  environment: Environment.default("production"),
+  // Optional
+  parent_receipt_id: z3.string().nullable().optional(),
+  output_hash: z3.string().nullable().optional(),
+  output_summary: z3.string().nullable().optional(),
+  model: z3.string().nullable().optional(),
+  tokens_in: z3.number().int().nonnegative().nullable().optional(),
+  tokens_out: z3.number().int().nonnegative().nullable().optional(),
+  cost_usd: z3.number().nonnegative().nullable().optional(),
+  latency_ms: z3.number().int().nonnegative().nullable().optional(),
+  tool_calls: z3.array(z3.string()).nullable().optional(),
+  tags: z3.array(z3.string()).nullable().optional(),
+  confidence: z3.number().min(0).max(1).nullable().optional(),
+  callback_verified: z3.boolean().nullable().optional(),
+  metadata: z3.record(z3.unknown()).optional()
+});
+var CompleteReceiptInput = z3.object({
+  // Required — must transition from pending
+  status: z3.enum(["completed", "failed", "timeout"]),
+  // Execution results (all optional — set what you know)
+  output_hash: z3.string().nullable().optional(),
+  output_summary: z3.string().nullable().optional(),
+  model: z3.string().nullable().optional(),
+  tokens_in: z3.number().int().nonnegative().nullable().optional(),
+  tokens_out: z3.number().int().nonnegative().nullable().optional(),
+  cost_usd: z3.number().nonnegative().nullable().optional(),
+  latency_ms: z3.number().int().nonnegative().nullable().optional(),
+  tool_calls: z3.array(z3.string()).nullable().optional(),
+  confidence: z3.number().min(0).max(1).nullable().optional(),
+  callback_verified: z3.boolean().nullable().optional(),
+  error: z3.record(z3.unknown()).nullable().optional()
+});
+var VerifyResponse = z3.object({
+  verified: z3.boolean(),
+  receipt: z3.object({
+    receipt_id: z3.string(),
+    chain_id: z3.string(),
+    receipt_type: ReceiptType,
+    agent_id: z3.string(),
+    action: z3.string(),
+    status: ReceiptStatus,
+    input_hash: z3.string(),
+    output_hash: z3.string().nullable(),
+    signature: z3.string(),
+    timestamp: z3.string().datetime(),
+    completed_at: z3.string().datetime().nullable(),
+    environment: Environment,
+    latency_ms: z3.number().int().nonnegative().nullable()
+  }),
+  signature_valid: z3.boolean(),
+  chain_length: z3.number().int().nonnegative(),
+  public_key_url: z3.string().url()
+});
+var ListReceiptsQuery = z3.object({
+  page: z3.coerce.number().int().positive().default(1),
+  limit: z3.coerce.number().int().positive().max(100).default(50),
+  agent_id: z3.string().optional(),
+  action: z3.string().optional(),
+  status: ReceiptStatus.optional(),
+  environment: Environment.optional(),
+  receipt_type: ReceiptType.optional(),
+  chain_id: z3.string().optional(),
+  tag: z3.string().optional(),
+  from: z3.string().datetime().optional(),
+  to: z3.string().datetime().optional(),
+  sort: z3.string().regex(/^(created_at|completed_at|latency_ms|cost_usd):(asc|desc)$/).default("created_at:desc")
+});
+var PaginationMeta = z3.object({
+  page: z3.number().int().positive(),
+  limit: z3.number().int().positive(),
+  total: z3.number().int().nonnegative(),
+  total_pages: z3.number().int().nonnegative(),
+  has_next: z3.boolean(),
+  has_prev: z3.boolean()
+});
+var ErrorResponse = z3.object({
+  error: z3.object({
+    code: ErrorCode,
+    message: z3.string(),
+    status: z3.number().int()
+  })
+});
+
+// src/validation.ts
+function validate(schema, data) {
+  const result = schema.safeParse(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return {
+    success: false,
+    error: createErrorResponse(
+      "VALIDATION_ERROR",
+      formatZodError(result.error),
+      400
+    )
+  };
+}
+function formatZodError(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
+    return `${path}${issue.message}`;
+  }).join("; ");
+}
+function createErrorResponse(code, message, status) {
+  return {
+    error: {
+      code,
+      message,
+      status
+    }
+  };
+}
+export {
+  ActionReceipt,
+  CompleteReceiptInput,
+  CreateReceiptInput,
+  Environment,
+  ErrorCode,
+  ErrorResponse,
+  ListReceiptsQuery,
+  PaginationMeta,
+  ReceiptStatus,
+  ReceiptType,
+  SignablePayload,
+  VerifyResponse,
+  createErrorResponse,
+  formatZodError,
+  validate
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/enums.ts","../src/receipt.ts","../src/api.ts","../src/validation.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport const ReceiptStatus = z.enum(['pending', 'completed', 'failed', 'timeout'])\nexport type ReceiptStatus = z.infer<typeof ReceiptStatus>\n\nexport const ReceiptType = z.enum(['action', 'verification', 'judgment', 'arbitration'])\nexport type ReceiptType = z.infer<typeof ReceiptType>\n\nexport const Environment = z.enum(['production', 'staging', 'test'])\nexport type Environment = z.infer<typeof Environment>\n\nexport const ErrorCode = z.enum([\n  'UNAUTHORIZED',\n  'KEY_REVOKED',\n  'FORBIDDEN',\n  'RECEIPT_NOT_FOUND',\n  'CHAIN_NOT_FOUND',\n  'AGENT_NOT_FOUND',\n  'RECEIPT_NOT_PENDING',\n  'RECEIPT_IMMUTABLE',\n  'RATE_LIMIT_EXCEEDED',\n  'VALIDATION_ERROR',\n  'INTERNAL_ERROR',\n])\nexport type ErrorCode = z.infer<typeof ErrorCode>\n","import { z } from 'zod'\nimport { ReceiptStatus, ReceiptType, Environment } from './enums'\n\n/**\n * The 12 fields that are cryptographically signed.\n * These fields are extracted from a receipt and serialized as canonical JSON\n * before signing with Ed25519.\n */\nexport const SignablePayload = z.object({\n  receipt_id: z.string(),\n  chain_id: z.string(),\n  receipt_type: ReceiptType,\n  agent_id: z.string(),\n  org_id: z.string(),\n  action: z.string(),\n  input_hash: z.string(),\n  output_hash: z.string().nullable(),\n  status: ReceiptStatus,\n  timestamp: z.string().datetime(),\n  completed_at: z.string().datetime().nullable(),\n  environment: Environment,\n})\nexport type SignablePayload = z.infer<typeof SignablePayload>\n\n/**\n * The complete receipt object as returned by the API.\n */\nexport const ActionReceipt = z.object({\n  // Identity\n  receipt_id: z.string(),\n  parent_receipt_id: z.string().nullable(),\n  chain_id: z.string(),\n\n  // Type\n  receipt_type: ReceiptType,\n\n  // Who\n  agent_id: z.string(),\n  org_id: z.string(),\n\n  // What\n  action: z.string(),\n  input_hash: z.string(),\n  output_hash: z.string().nullable(),\n  output_summary: z.string().nullable(),\n\n  // How (all nullable — may not be known at creation)\n  model: z.string().nullable(),\n  tokens_in: z.number().int().nonnegative().nullable(),\n  tokens_out: z.number().int().nonnegative().nullable(),\n  cost_usd: z.number().nonnegative().nullable(),\n  latency_ms: z.number().int().nonnegative().nullable(),\n  tool_calls: z.array(z.string()).nullable(),\n\n  // When\n  timestamp: z.string().datetime(),\n  completed_at: z.string().datetime().nullable(),\n\n  // Status\n  status: ReceiptStatus,\n  error: z.record(z.unknown()).nullable(),\n\n  // Context\n  environment: Environment,\n  tags: z.array(z.string()).nullable(),\n\n  // Verification (Tier 2 — Phase 6)\n  constraints: z.record(z.unknown()).nullable(),\n  constraint_result: z.record(z.unknown()).nullable(),\n\n  // Trust\n  signature: z.string(),\n  verify_url: z.string().url(),\n\n  // Optional\n  callback_verified: z.boolean().nullable(),\n  confidence: z.number().min(0).max(1).nullable(),\n  metadata: z.record(z.unknown()),\n})\nexport type ActionReceipt = z.infer<typeof ActionReceipt>\n","import { z } from 'zod'\nimport { ReceiptStatus, ReceiptType, Environment, ErrorCode } from './enums'\n\n/**\n * What the client sends to POST /api/v1/receipts.\n */\nexport const CreateReceiptInput = z.object({\n  // Required\n  agent_id: z.string().min(1),\n  action: z.string().min(1),\n  input_hash: z.string().min(1),\n\n  // Optional with defaults\n  receipt_type: ReceiptType.default('action'),\n  status: ReceiptStatus.default('pending'),\n  environment: Environment.default('production'),\n\n  // Optional\n  parent_receipt_id: z.string().nullable().optional(),\n  output_hash: z.string().nullable().optional(),\n  output_summary: z.string().nullable().optional(),\n  model: z.string().nullable().optional(),\n  tokens_in: z.number().int().nonnegative().nullable().optional(),\n  tokens_out: z.number().int().nonnegative().nullable().optional(),\n  cost_usd: z.number().nonnegative().nullable().optional(),\n  latency_ms: z.number().int().nonnegative().nullable().optional(),\n  tool_calls: z.array(z.string()).nullable().optional(),\n  tags: z.array(z.string()).nullable().optional(),\n  confidence: z.number().min(0).max(1).nullable().optional(),\n  callback_verified: z.boolean().nullable().optional(),\n  metadata: z.record(z.unknown()).optional(),\n})\nexport type CreateReceiptInput = z.infer<typeof CreateReceiptInput>\n\n/**\n * What the client sends to PATCH /api/v1/receipts/:id/complete.\n */\nexport const CompleteReceiptInput = z.object({\n  // Required — must transition from pending\n  status: z.enum(['completed', 'failed', 'timeout']),\n\n  // Execution results (all optional — set what you know)\n  output_hash: z.string().nullable().optional(),\n  output_summary: z.string().nullable().optional(),\n  model: z.string().nullable().optional(),\n  tokens_in: z.number().int().nonnegative().nullable().optional(),\n  tokens_out: z.number().int().nonnegative().nullable().optional(),\n  cost_usd: z.number().nonnegative().nullable().optional(),\n  latency_ms: z.number().int().nonnegative().nullable().optional(),\n  tool_calls: z.array(z.string()).nullable().optional(),\n  confidence: z.number().min(0).max(1).nullable().optional(),\n  callback_verified: z.boolean().nullable().optional(),\n  error: z.record(z.unknown()).nullable().optional(),\n})\nexport type CompleteReceiptInput = z.infer<typeof CompleteReceiptInput>\n\n/**\n * What GET /api/v1/verify/:id returns.\n * Note: Does NOT include org_id, metadata, tags, or output_summary (org-private).\n */\nexport const VerifyResponse = z.object({\n  verified: z.boolean(),\n  receipt: z.object({\n    receipt_id: z.string(),\n    chain_id: z.string(),\n    receipt_type: ReceiptType,\n    agent_id: z.string(),\n    action: z.string(),\n    status: ReceiptStatus,\n    input_hash: z.string(),\n    output_hash: z.string().nullable(),\n    signature: z.string(),\n    timestamp: z.string().datetime(),\n    completed_at: z.string().datetime().nullable(),\n    environment: Environment,\n    latency_ms: z.number().int().nonnegative().nullable(),\n  }),\n  signature_valid: z.boolean(),\n  chain_length: z.number().int().nonnegative(),\n  public_key_url: z.string().url(),\n})\nexport type VerifyResponse = z.infer<typeof VerifyResponse>\n\n/**\n * Query parameters for GET /api/v1/receipts.\n */\nexport const ListReceiptsQuery = z.object({\n  page: z.coerce.number().int().positive().default(1),\n  limit: z.coerce.number().int().positive().max(100).default(50),\n  agent_id: z.string().optional(),\n  action: z.string().optional(),\n  status: ReceiptStatus.optional(),\n  environment: Environment.optional(),\n  receipt_type: ReceiptType.optional(),\n  chain_id: z.string().optional(),\n  tag: z.string().optional(),\n  from: z.string().datetime().optional(),\n  to: z.string().datetime().optional(),\n  sort: z.string().regex(/^(created_at|completed_at|latency_ms|cost_usd):(asc|desc)$/).default('created_at:desc'),\n})\nexport type ListReceiptsQuery = z.infer<typeof ListReceiptsQuery>\n\n/**\n * Pagination metadata included in list responses.\n */\nexport const PaginationMeta = z.object({\n  page: z.number().int().positive(),\n  limit: z.number().int().positive(),\n  total: z.number().int().nonnegative(),\n  total_pages: z.number().int().nonnegative(),\n  has_next: z.boolean(),\n  has_prev: z.boolean(),\n})\nexport type PaginationMeta = z.infer<typeof PaginationMeta>\n\n/**\n * Standard error response format.\n */\nexport const ErrorResponse = z.object({\n  error: z.object({\n    code: ErrorCode,\n    message: z.string(),\n    status: z.number().int(),\n  }),\n})\nexport type ErrorResponse = z.infer<typeof ErrorResponse>\n","import { z } from 'zod'\nimport type { ErrorResponse } from './api'\n\n/**\n * Validate data against a Zod schema.\n * Returns { success: true, data } or { success: false, error: ErrorResponse }\n */\nexport function validate<T extends z.ZodSchema>(\n  schema: T,\n  data: unknown\n): { success: true; data: z.infer<T> } | { success: false; error: ErrorResponse } {\n  const result = schema.safeParse(data)\n  if (result.success) {\n    return { success: true, data: result.data }\n  }\n  return {\n    success: false,\n    error: createErrorResponse(\n      'VALIDATION_ERROR',\n      formatZodError(result.error),\n      400\n    ),\n  }\n}\n\n/**\n * Format Zod errors into a human-readable message.\n */\nexport function formatZodError(error: z.ZodError): string {\n  return error.issues\n    .map((issue) => {\n      const path = issue.path.length > 0 ? `${issue.path.join('.')}: ` : ''\n      return `${path}${issue.message}`\n    })\n    .join('; ')\n}\n\n/**\n * Create a standard error response object.\n */\nexport function createErrorResponse(\n  code: string,\n  message: string,\n  status: number\n): ErrorResponse {\n  return {\n    error: {\n      code: code as ErrorResponse['error']['code'],\n      message,\n      status,\n    },\n  }\n}\n"],"mappings":"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","names":["z","z","z","z"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@agent-receipts/schema",
+  "version": "0.1.0",
+  "description": "Zod schemas and TypeScript types for the Action Receipt Protocol",
+  "license": "MIT",
+  "author": "Amin <amin@webaes.co> (https://webaes.co)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/webaesbyamin/agent-receipts",
+    "directory": "packages/schema"
+  },
+  "homepage": "https://github.com/webaesbyamin/agent-receipts#readme",
+  "bugs": {
+    "url": "https://github.com/webaesbyamin/agent-receipts/issues"
+  },
+  "keywords": [
+    "agent-receipts",
+    "action-receipt-protocol",
+    "zod",
+    "schema",
+    "validation",
+    "ai-agents",
+    "mcp"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "receipt.schema.json"
+  ],
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.2.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.0",
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsup && node -e \"const{zodToJsonSchema}=require('zod-to-json-schema');const{ActionReceipt}=require('./dist');const fs=require('fs');fs.writeFileSync('receipt.schema.json',JSON.stringify(zodToJsonSchema(ActionReceipt,'ActionReceipt'),null,2));\"",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}