@strimz/shared-types 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Strimz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# @strimz/shared-types
+
+Zod schemas and inferred TypeScript types for every entity, API input, and webhook event in the Strimz platform. The schema is the source of truth; types are inferred via `z.infer<>` so wire format and compile-time shape never diverge.
+
+## Who uses what
+
+| Consumer            | Why                                                                    |
+| ------------------- | ---------------------------------------------------------------------- |
+| `apps/api`          | Runtime validation of every request body, query string, and path param |
+| `apps/scheduler`    | Validation of queued job payloads                                      |
+| `apps/web`          | React Hook Form resolvers, typed API client responses                  |
+| `@strimz/sdk`       | Typed request builders and typed response objects                      |
+| `@strimz/sdk-react` | Typed props for `<StrimzPayButton />` and hooks                        |
+
+## Module map
+
+| Subpath             | Contains                                                                                                |
+| ------------------- | ------------------------------------------------------------------------------------------------------- |
+| `/common`           | Primitives: ids, EVM address, tx hash, email, URL, money, pagination, metadata, mode, tier, environment |
+| `/merchants`        | Merchant entity, login, member invites, tier changes                                                    |
+| `/api-keys`         | Secret/publishable keys, scopes, rotation                                                               |
+| `/customers`        | Payer identity                                                                                          |
+| `/payment-sessions` | One-shot session entity + state machine + `createPaymentSessionInputSchema`                             |
+| `/transactions`     | Confirmed on-chain payment records                                                                      |
+| `/subscriptions`    | Plans, active subscriptions, per-period charges (with `chargeAttemptId`)                                |
+| `/refunds`          | Merchant-initiated refund entity + signature flow                                                       |
+| `/webhooks`         | Endpoints, deliveries, replay                                                                           |
+| `/compliance`       | Sanctions screening log                                                                                 |
+| `/agents`           | Identity, merchant config, activity log, ERC-8183 jobs                                                  |
+| `/storefronts`      | Storefront + product                                                                                    |
+| `/invoices`         | Invoice + line items                                                                                    |
+| `/events`           | Discriminated `StrimzWebhookEvent` union covering every webhook payload shape                           |
+
+The package root re-exports every subpath.
+
+## Usage
+
+```ts
+import {
+  createPaymentSessionInputSchema,
+  type CreatePaymentSessionInput,
+} from '@strimz/shared-types'
+
+const parsed: CreatePaymentSessionInput = createPaymentSessionInputSchema.parse(req.body)
+```
+
+```ts
+// In a webhook handler. Exhaustive over every event kind.
+import { webhookEventSchema, type StrimzWebhookEvent } from '@strimz/shared-types/events'
+
+function handle(event: StrimzWebhookEvent) {
+  switch (event.type) {
+    case 'payment.completed':
+      // event.data is typed as { session, transaction }
+      break
+    case 'subscription.charge_failed':
+      // event.data is typed as { subscription, charge }
+      break
+    // TypeScript enforces exhaustiveness
+  }
+}
+```
+
+## Boundaries
+
+- Schemas describe wire format. They do not contain business logic, persistence, or side effects.
+- Amounts are carried as decimal strings of the token's smallest unit (USDC has 6 decimals, so `"1000000"` is 1 USDC). This preserves precision beyond `Number.MAX_SAFE_INTEGER`.
+- EVM addresses are normalised to lowercase on parse. Transaction hashes are preserved verbatim.
+- Optional fields are marked `.optional()` (omission OK) and nullable fields are `.nullable()` (explicit `null` OK). These are different and not interchangeable.

package/dist/agents.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/agents.ts
+var idSchema = zod.z.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/, "id must be URL-safe");
+var evmAddressSchema = zod.z.string().regex(/^0x[a-fA-F0-9]{40}$/, "must be a 0x-prefixed 40-character hex EVM address").transform((v) => v.toLowerCase());
+var evmTxHashSchema = zod.z.string().regex(/^0x[a-fA-F0-9]{64}$/, "must be a 0x-prefixed 64-character hex EVM transaction hash");
+zod.z.string().email().trim().toLowerCase().max(320);
+zod.z.string().url().refine((v) => v.startsWith("https://"), {
+  message: "must be an https:// URL"
+});
+zod.z.string().url();
+var tokenAmountSchema = zod.z.string().regex(/^[0-9]+$/, "must be a non-negative integer string (base-10)").refine((v) => BigInt(v) >= 0n, "must be >= 0");
+zod.z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+var isoTimestampSchema = zod.z.string().datetime({ offset: true, message: "must be an ISO-8601 timestamp" });
+zod.z.string().length(2).regex(/^[A-Z]{2}$/, "must be an ISO-3166 alpha-2 country code");
+zod.z.object({
+  limit: zod.z.number().int().min(1).max(100).default(25),
+  cursor: zod.z.string().min(1).max(200).nullish()
+});
+var metadataSchema = zod.z.record(
+  zod.z.string().min(1).max(40),
+  zod.z.union([zod.z.string().max(500), zod.z.number(), zod.z.boolean(), zod.z.null()])
+).refine((m) => Object.keys(m).length <= 50, "at most 50 metadata keys").default({});
+zod.z.enum(["test", "live"]);
+zod.z.enum(["USDC", "EURC"]);
+zod.z.enum(["USDC", "EURC", "USYC"]);
+zod.z.enum(["free", "growth", "business", "enterprise"]);
+zod.z.enum(["testnet", "mainnet"]);
+
+// src/agents.ts
+var agentIdentitySchema = zod.z.object({
+  id: idSchema,
+  /** ERC-8004 on-chain identity address. */
+  onchainAddress: evmAddressSchema,
+  /** Public key or agent credential digest, as emitted by ERC-8004. */
+  credentialDigest: zod.z.string().regex(/^0x[a-fA-F0-9]+$/),
+  name: zod.z.string().min(1).max(120),
+  version: zod.z.string().min(1).max(40),
+  reputationScore: zod.z.number().min(0).max(100).nullable(),
+  registeredAt: isoTimestampSchema
+});
+var agentCapabilitySchema = zod.z.enum([
+  "identity",
+  "recovery",
+  "routing",
+  "cashflow",
+  "commerce",
+  "pricing_intelligence"
+]);
+var agentMerchantConfigSchema = zod.z.object({
+  merchantId: idSchema,
+  enabledCapabilities: zod.z.array(agentCapabilitySchema).default([]),
+  recovery: zod.z.object({
+    gracePeriodHours: zod.z.union([zod.z.literal(24), zod.z.literal(48), zod.z.literal(72)]).default(48),
+    strategy: zod.z.enum(["once", "twice", "until_grace_ends"]).default("twice"),
+    notificationTemplate: zod.z.string().max(2e3).nullable()
+  }),
+  cashflow: zod.z.object({
+    digestEnabled: zod.z.boolean().default(false),
+    anomalySensitivity: zod.z.enum(["low", "medium", "high"]).default("medium"),
+    autoConvertToYield: zod.z.boolean().default(false),
+    minimumLiquidReserveCents: zod.z.number().int().nonnegative().default(1e5)
+  }),
+  commerce: zod.z.object({
+    requireHumanApprovalAboveUsdCents: zod.z.number().int().nonnegative().default(1e5),
+    approvedVendors: zod.z.array(evmAddressSchema).default([]),
+    monthlySpendCapUsdCents: zod.z.number().int().nonnegative().nullable()
+  }),
+  updatedAt: isoTimestampSchema
+});
+var updateAgentConfigInputSchema = agentMerchantConfigSchema.omit({ merchantId: true, updatedAt: true }).partial();
+var agentActionTypeSchema = zod.z.enum([
+  "recovery_notification_sent",
+  "recovery_retry_scheduled",
+  "recovery_retry_executed",
+  "recovery_abandoned",
+  "routing_bridge_initiated",
+  "routing_payment_completed",
+  "cashflow_digest_sent",
+  "cashflow_anomaly_flagged",
+  "cashflow_yield_converted",
+  "commerce_job_created",
+  "commerce_job_approved",
+  "commerce_job_completed",
+  "commerce_job_disputed"
+]);
+var agentActionOutcomeSchema = zod.z.enum(["success", "failure", "pending", "skipped"]);
+var agentActivityLogSchema = zod.z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  capability: agentCapabilitySchema,
+  actionType: agentActionTypeSchema,
+  outcome: agentActionOutcomeSchema,
+  subscriptionId: idSchema.nullable(),
+  transactionId: idSchema.nullable(),
+  jobId: idSchema.nullable(),
+  metadata: metadataSchema,
+  createdAt: isoTimestampSchema
+});
+var agentJobStatusSchema = zod.z.enum([
+  "proposed",
+  "accepted",
+  "in_progress",
+  "delivered",
+  "approved",
+  "completed",
+  "disputed",
+  "cancelled"
+]);
+var agentJobSchema = zod.z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  /** On-chain job id from StrimzAgentEscrow. */
+  onchainJobId: zod.z.number().int().nonnegative().nullable(),
+  vendorAddress: evmAddressSchema,
+  description: zod.z.string().min(1).max(2e3),
+  amount: tokenAmountSchema,
+  currency: zod.z.enum(["USDC", "EURC"]),
+  status: agentJobStatusSchema,
+  assessorAddress: evmAddressSchema,
+  deliverableHash: zod.z.string().regex(/^0x[a-fA-F0-9]+$/).nullable(),
+  escrowTxHash: evmTxHashSchema.nullable(),
+  releaseTxHash: evmTxHashSchema.nullable(),
+  createdAt: isoTimestampSchema,
+  completedAt: isoTimestampSchema.nullable()
+});
+var createAgentJobInputSchema = zod.z.object({
+  vendorAddress: evmAddressSchema,
+  description: zod.z.string().min(1).max(2e3),
+  amount: tokenAmountSchema,
+  currency: zod.z.enum(["USDC", "EURC"]),
+  assessorAddress: evmAddressSchema.optional()
+});
+
+exports.agentActionOutcomeSchema = agentActionOutcomeSchema;
+exports.agentActionTypeSchema = agentActionTypeSchema;
+exports.agentActivityLogSchema = agentActivityLogSchema;
+exports.agentCapabilitySchema = agentCapabilitySchema;
+exports.agentIdentitySchema = agentIdentitySchema;
+exports.agentJobSchema = agentJobSchema;
+exports.agentJobStatusSchema = agentJobStatusSchema;
+exports.agentMerchantConfigSchema = agentMerchantConfigSchema;
+exports.createAgentJobInputSchema = createAgentJobInputSchema;
+exports.updateAgentConfigInputSchema = updateAgentConfigInputSchema;
+//# sourceMappingURL=agents.cjs.map
+//# sourceMappingURL=agents.cjs.map

package/dist/agents.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common.ts","../src/agents.ts"],"names":["z"],"mappings":"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","file":"agents.cjs","sourcesContent":["/**\n * Primitive schemas shared across every entity.\n * Every higher-level schema builds on these so validation is consistent.\n */\n\nimport { z } from 'zod'\n\n/** CUID2 or UUID-style opaque identifier. */\nexport const idSchema = z\n  .string()\n  .min(1)\n  .max(64)\n  .regex(/^[a-zA-Z0-9_-]+$/, 'id must be URL-safe')\n\n/** EVM address. Hex-encoded, 0x-prefixed, 20 bytes. Normalised to lowercase. */\nexport const evmAddressSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{40}$/, 'must be a 0x-prefixed 40-character hex EVM address')\n  .transform((v) => v.toLowerCase())\n\n/** EVM transaction hash. 32-byte hex. */\nexport const evmTxHashSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{64}$/, 'must be a 0x-prefixed 64-character hex EVM transaction hash')\n\n/** Email address, trimmed and lower-cased. */\nexport const emailSchema = z.string().email().trim().toLowerCase().max(320)\n\n/** HTTPS URL. No http:// allowed outside dev. */\nexport const httpsUrlSchema = z\n  .string()\n  .url()\n  .refine((v) => v.startsWith('https://'), {\n    message: 'must be an https:// URL',\n  })\n\n/** URL permitting http and https (dev + prod). */\nexport const httpUrlSchema = z.string().url()\n\n/**\n * Amount expressed in the token's smallest unit, serialised as a string to\n * preserve precision beyond `Number.MAX_SAFE_INTEGER`. For USDC (6 decimals),\n * 1 USDC is the string \"1000000\".\n */\nexport const tokenAmountSchema = z\n  .string()\n  .regex(/^[0-9]+$/, 'must be a non-negative integer string (base-10)')\n  .refine((v) => BigInt(v) >= 0n, 'must be >= 0')\n\n/** Unsigned integer up to 2^53 - 1; validated and returned as number. */\nexport const uintSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER)\n\n/** ISO-8601 timestamp string (`.toISOString()`-compatible). */\nexport const isoTimestampSchema = z\n  .string()\n  .datetime({ offset: true, message: 'must be an ISO-8601 timestamp' })\n\n/** Two-letter ISO-3166 country code. */\nexport const countryCodeSchema = z\n  .string()\n  .length(2)\n  .regex(/^[A-Z]{2}$/, 'must be an ISO-3166 alpha-2 country code')\n\n/** Pagination inputs used by every list endpoint. */\nexport const paginationInputSchema = z.object({\n  limit: z.number().int().min(1).max(100).default(25),\n  cursor: z.string().min(1).max(200).nullish(),\n})\nexport type PaginationInput = z.infer<typeof paginationInputSchema>\n\n/** Pagination envelope used by every list response. */\nexport const makePaginatedSchema = <T extends z.ZodTypeAny>(item: T) =>\n  z.object({\n    data: z.array(item),\n    nextCursor: z.string().nullable(),\n    hasMore: z.boolean(),\n  })\n\n/** Free-form metadata bag the API round-trips for merchants. */\nexport const metadataSchema = z\n  .record(\n    z.string().min(1).max(40),\n    z.union([z.string().max(500), z.number(), z.boolean(), z.null()]),\n  )\n  .refine((m) => Object.keys(m).length <= 50, 'at most 50 metadata keys')\n  .default({})\n\n/** Environment mode carried on every mode-scoped resource. */\nexport const modeSchema = z.enum(['test', 'live'])\nexport type Mode = z.infer<typeof modeSchema>\n\n/** Payment token enum — mirrors `@strimz/shared-config`. */\nexport const paymentCurrencySchema = z.enum(['USDC', 'EURC'])\nexport type PaymentCurrency = z.infer<typeof paymentCurrencySchema>\n\n/** Every display-level currency (payment + treasury). */\nexport const tokenSymbolSchema = z.enum(['USDC', 'EURC', 'USYC'])\nexport type TokenSymbol = z.infer<typeof tokenSymbolSchema>\n\n/** Merchant tier enum — mirrors `@strimz/shared-config`. */\nexport const merchantTierSchema = z.enum(['free', 'growth', 'business', 'enterprise'])\nexport type MerchantTier = z.infer<typeof merchantTierSchema>\n\n/** Arc environment enum. */\nexport const arcEnvironmentSchema = z.enum(['testnet', 'mainnet'])\nexport type ArcEnvironment = z.infer<typeof arcEnvironmentSchema>\n\nexport type Id = z.infer<typeof idSchema>\nexport type EvmAddress = z.infer<typeof evmAddressSchema>\nexport type EvmTxHash = z.infer<typeof evmTxHashSchema>\nexport type TokenAmount = z.infer<typeof tokenAmountSchema>\nexport type IsoTimestamp = z.infer<typeof isoTimestampSchema>\nexport type Metadata = z.infer<typeof metadataSchema>\n","/**\n * AI AutoPay Agent — identity, configuration, activity log, and ERC-8183 jobs.\n */\n\nimport { z } from 'zod'\nimport {\n  evmAddressSchema,\n  evmTxHashSchema,\n  idSchema,\n  isoTimestampSchema,\n  metadataSchema,\n  tokenAmountSchema,\n} from './common.js'\n\n// ---------- Identity ----------\n\nexport const agentIdentitySchema = z.object({\n  id: idSchema,\n  /** ERC-8004 on-chain identity address. */\n  onchainAddress: evmAddressSchema,\n  /** Public key or agent credential digest, as emitted by ERC-8004. */\n  credentialDigest: z.string().regex(/^0x[a-fA-F0-9]+$/),\n  name: z.string().min(1).max(120),\n  version: z.string().min(1).max(40),\n  reputationScore: z.number().min(0).max(100).nullable(),\n  registeredAt: isoTimestampSchema,\n})\nexport type AgentIdentity = z.infer<typeof agentIdentitySchema>\n\n// ---------- Merchant config ----------\n\nexport const agentCapabilitySchema = z.enum([\n  'identity',\n  'recovery',\n  'routing',\n  'cashflow',\n  'commerce',\n  'pricing_intelligence',\n])\nexport type AgentCapability = z.infer<typeof agentCapabilitySchema>\n\nexport const agentMerchantConfigSchema = z.object({\n  merchantId: idSchema,\n  enabledCapabilities: z.array(agentCapabilitySchema).default([]),\n  recovery: z.object({\n    gracePeriodHours: z.union([z.literal(24), z.literal(48), z.literal(72)]).default(48),\n    strategy: z.enum(['once', 'twice', 'until_grace_ends']).default('twice'),\n    notificationTemplate: z.string().max(2000).nullable(),\n  }),\n  cashflow: z.object({\n    digestEnabled: z.boolean().default(false),\n    anomalySensitivity: z.enum(['low', 'medium', 'high']).default('medium'),\n    autoConvertToYield: z.boolean().default(false),\n    minimumLiquidReserveCents: z.number().int().nonnegative().default(100_000),\n  }),\n  commerce: z.object({\n    requireHumanApprovalAboveUsdCents: z.number().int().nonnegative().default(100_000),\n    approvedVendors: z.array(evmAddressSchema).default([]),\n    monthlySpendCapUsdCents: z.number().int().nonnegative().nullable(),\n  }),\n  updatedAt: isoTimestampSchema,\n})\nexport type AgentMerchantConfig = z.infer<typeof agentMerchantConfigSchema>\n\nexport const updateAgentConfigInputSchema = agentMerchantConfigSchema\n  .omit({ merchantId: true, updatedAt: true })\n  .partial()\nexport type UpdateAgentConfigInput = z.infer<typeof updateAgentConfigInputSchema>\n\n// ---------- Activity log ----------\n\nexport const agentActionTypeSchema = z.enum([\n  'recovery_notification_sent',\n  'recovery_retry_scheduled',\n  'recovery_retry_executed',\n  'recovery_abandoned',\n  'routing_bridge_initiated',\n  'routing_payment_completed',\n  'cashflow_digest_sent',\n  'cashflow_anomaly_flagged',\n  'cashflow_yield_converted',\n  'commerce_job_created',\n  'commerce_job_approved',\n  'commerce_job_completed',\n  'commerce_job_disputed',\n])\nexport type AgentActionType = z.infer<typeof agentActionTypeSchema>\n\nexport const agentActionOutcomeSchema = z.enum(['success', 'failure', 'pending', 'skipped'])\nexport type AgentActionOutcome = z.infer<typeof agentActionOutcomeSchema>\n\nexport const agentActivityLogSchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  capability: agentCapabilitySchema,\n  actionType: agentActionTypeSchema,\n  outcome: agentActionOutcomeSchema,\n  subscriptionId: idSchema.nullable(),\n  transactionId: idSchema.nullable(),\n  jobId: idSchema.nullable(),\n  metadata: metadataSchema,\n  createdAt: isoTimestampSchema,\n})\nexport type AgentActivityLog = z.infer<typeof agentActivityLogSchema>\n\n// ---------- ERC-8183 jobs ----------\n\nexport const agentJobStatusSchema = z.enum([\n  'proposed',\n  'accepted',\n  'in_progress',\n  'delivered',\n  'approved',\n  'completed',\n  'disputed',\n  'cancelled',\n])\nexport type AgentJobStatus = z.infer<typeof agentJobStatusSchema>\n\nexport const agentJobSchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  /** On-chain job id from StrimzAgentEscrow. */\n  onchainJobId: z.number().int().nonnegative().nullable(),\n  vendorAddress: evmAddressSchema,\n  description: z.string().min(1).max(2000),\n  amount: tokenAmountSchema,\n  currency: z.enum(['USDC', 'EURC']),\n  status: agentJobStatusSchema,\n  assessorAddress: evmAddressSchema,\n  deliverableHash: z\n    .string()\n    .regex(/^0x[a-fA-F0-9]+$/)\n    .nullable(),\n  escrowTxHash: evmTxHashSchema.nullable(),\n  releaseTxHash: evmTxHashSchema.nullable(),\n  createdAt: isoTimestampSchema,\n  completedAt: isoTimestampSchema.nullable(),\n})\nexport type AgentJob = z.infer<typeof agentJobSchema>\n\nexport const createAgentJobInputSchema = z.object({\n  vendorAddress: evmAddressSchema,\n  description: z.string().min(1).max(2000),\n  amount: tokenAmountSchema,\n  currency: z.enum(['USDC', 'EURC']),\n  assessorAddress: evmAddressSchema.optional(),\n})\nexport type CreateAgentJobInput = z.infer<typeof createAgentJobInputSchema>\n"]}

package/dist/agents.d.cts

@@ -0,0 +1,317 @@
+import { z } from 'zod';
+
+/**
+ * AI AutoPay Agent — identity, configuration, activity log, and ERC-8183 jobs.
+ */
+
+declare const agentIdentitySchema: z.ZodObject<{
+    id: z.ZodString;
+    /** ERC-8004 on-chain identity address. */
+    onchainAddress: z.ZodEffects<z.ZodString, string, string>;
+    /** Public key or agent credential digest, as emitted by ERC-8004. */
+    credentialDigest: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    reputationScore: z.ZodNullable<z.ZodNumber>;
+    registeredAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    onchainAddress: string;
+    credentialDigest: string;
+    name: string;
+    version: string;
+    reputationScore: number | null;
+    registeredAt: string;
+}, {
+    id: string;
+    onchainAddress: string;
+    credentialDigest: string;
+    name: string;
+    version: string;
+    reputationScore: number | null;
+    registeredAt: string;
+}>;
+type AgentIdentity = z.infer<typeof agentIdentitySchema>;
+declare const agentCapabilitySchema: z.ZodEnum<["identity", "recovery", "routing", "cashflow", "commerce", "pricing_intelligence"]>;
+type AgentCapability = z.infer<typeof agentCapabilitySchema>;
+declare const agentMerchantConfigSchema: z.ZodObject<{
+    merchantId: z.ZodString;
+    enabledCapabilities: z.ZodDefault<z.ZodArray<z.ZodEnum<["identity", "recovery", "routing", "cashflow", "commerce", "pricing_intelligence"]>, "many">>;
+    recovery: z.ZodObject<{
+        gracePeriodHours: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<24>, z.ZodLiteral<48>, z.ZodLiteral<72>]>>;
+        strategy: z.ZodDefault<z.ZodEnum<["once", "twice", "until_grace_ends"]>>;
+        notificationTemplate: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        gracePeriodHours: 24 | 48 | 72;
+        strategy: "once" | "twice" | "until_grace_ends";
+        notificationTemplate: string | null;
+    }, {
+        notificationTemplate: string | null;
+        gracePeriodHours?: 24 | 48 | 72 | undefined;
+        strategy?: "once" | "twice" | "until_grace_ends" | undefined;
+    }>;
+    cashflow: z.ZodObject<{
+        digestEnabled: z.ZodDefault<z.ZodBoolean>;
+        anomalySensitivity: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+        autoConvertToYield: z.ZodDefault<z.ZodBoolean>;
+        minimumLiquidReserveCents: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        digestEnabled: boolean;
+        anomalySensitivity: "low" | "medium" | "high";
+        autoConvertToYield: boolean;
+        minimumLiquidReserveCents: number;
+    }, {
+        digestEnabled?: boolean | undefined;
+        anomalySensitivity?: "low" | "medium" | "high" | undefined;
+        autoConvertToYield?: boolean | undefined;
+        minimumLiquidReserveCents?: number | undefined;
+    }>;
+    commerce: z.ZodObject<{
+        requireHumanApprovalAboveUsdCents: z.ZodDefault<z.ZodNumber>;
+        approvedVendors: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        monthlySpendCapUsdCents: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        requireHumanApprovalAboveUsdCents: number;
+        approvedVendors: string[];
+        monthlySpendCapUsdCents: number | null;
+    }, {
+        monthlySpendCapUsdCents: number | null;
+        requireHumanApprovalAboveUsdCents?: number | undefined;
+        approvedVendors?: string[] | undefined;
+    }>;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    recovery: {
+        gracePeriodHours: 24 | 48 | 72;
+        strategy: "once" | "twice" | "until_grace_ends";
+        notificationTemplate: string | null;
+    };
+    cashflow: {
+        digestEnabled: boolean;
+        anomalySensitivity: "low" | "medium" | "high";
+        autoConvertToYield: boolean;
+        minimumLiquidReserveCents: number;
+    };
+    commerce: {
+        requireHumanApprovalAboveUsdCents: number;
+        approvedVendors: string[];
+        monthlySpendCapUsdCents: number | null;
+    };
+    merchantId: string;
+    enabledCapabilities: ("identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence")[];
+    updatedAt: string;
+}, {
+    recovery: {
+        notificationTemplate: string | null;
+        gracePeriodHours?: 24 | 48 | 72 | undefined;
+        strategy?: "once" | "twice" | "until_grace_ends" | undefined;
+    };
+    cashflow: {
+        digestEnabled?: boolean | undefined;
+        anomalySensitivity?: "low" | "medium" | "high" | undefined;
+        autoConvertToYield?: boolean | undefined;
+        minimumLiquidReserveCents?: number | undefined;
+    };
+    commerce: {
+        monthlySpendCapUsdCents: number | null;
+        requireHumanApprovalAboveUsdCents?: number | undefined;
+        approvedVendors?: string[] | undefined;
+    };
+    merchantId: string;
+    updatedAt: string;
+    enabledCapabilities?: ("identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence")[] | undefined;
+}>;
+type AgentMerchantConfig = z.infer<typeof agentMerchantConfigSchema>;
+declare const updateAgentConfigInputSchema: z.ZodObject<{
+    recovery: z.ZodOptional<z.ZodObject<{
+        gracePeriodHours: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<24>, z.ZodLiteral<48>, z.ZodLiteral<72>]>>;
+        strategy: z.ZodDefault<z.ZodEnum<["once", "twice", "until_grace_ends"]>>;
+        notificationTemplate: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        gracePeriodHours: 24 | 48 | 72;
+        strategy: "once" | "twice" | "until_grace_ends";
+        notificationTemplate: string | null;
+    }, {
+        notificationTemplate: string | null;
+        gracePeriodHours?: 24 | 48 | 72 | undefined;
+        strategy?: "once" | "twice" | "until_grace_ends" | undefined;
+    }>>;
+    cashflow: z.ZodOptional<z.ZodObject<{
+        digestEnabled: z.ZodDefault<z.ZodBoolean>;
+        anomalySensitivity: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+        autoConvertToYield: z.ZodDefault<z.ZodBoolean>;
+        minimumLiquidReserveCents: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        digestEnabled: boolean;
+        anomalySensitivity: "low" | "medium" | "high";
+        autoConvertToYield: boolean;
+        minimumLiquidReserveCents: number;
+    }, {
+        digestEnabled?: boolean | undefined;
+        anomalySensitivity?: "low" | "medium" | "high" | undefined;
+        autoConvertToYield?: boolean | undefined;
+        minimumLiquidReserveCents?: number | undefined;
+    }>>;
+    commerce: z.ZodOptional<z.ZodObject<{
+        requireHumanApprovalAboveUsdCents: z.ZodDefault<z.ZodNumber>;
+        approvedVendors: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        monthlySpendCapUsdCents: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        requireHumanApprovalAboveUsdCents: number;
+        approvedVendors: string[];
+        monthlySpendCapUsdCents: number | null;
+    }, {
+        monthlySpendCapUsdCents: number | null;
+        requireHumanApprovalAboveUsdCents?: number | undefined;
+        approvedVendors?: string[] | undefined;
+    }>>;
+    enabledCapabilities: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodEnum<["identity", "recovery", "routing", "cashflow", "commerce", "pricing_intelligence"]>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    recovery?: {
+        gracePeriodHours: 24 | 48 | 72;
+        strategy: "once" | "twice" | "until_grace_ends";
+        notificationTemplate: string | null;
+    } | undefined;
+    cashflow?: {
+        digestEnabled: boolean;
+        anomalySensitivity: "low" | "medium" | "high";
+        autoConvertToYield: boolean;
+        minimumLiquidReserveCents: number;
+    } | undefined;
+    commerce?: {
+        requireHumanApprovalAboveUsdCents: number;
+        approvedVendors: string[];
+        monthlySpendCapUsdCents: number | null;
+    } | undefined;
+    enabledCapabilities?: ("identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence")[] | undefined;
+}, {
+    recovery?: {
+        notificationTemplate: string | null;
+        gracePeriodHours?: 24 | 48 | 72 | undefined;
+        strategy?: "once" | "twice" | "until_grace_ends" | undefined;
+    } | undefined;
+    cashflow?: {
+        digestEnabled?: boolean | undefined;
+        anomalySensitivity?: "low" | "medium" | "high" | undefined;
+        autoConvertToYield?: boolean | undefined;
+        minimumLiquidReserveCents?: number | undefined;
+    } | undefined;
+    commerce?: {
+        monthlySpendCapUsdCents: number | null;
+        requireHumanApprovalAboveUsdCents?: number | undefined;
+        approvedVendors?: string[] | undefined;
+    } | undefined;
+    enabledCapabilities?: ("identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence")[] | undefined;
+}>;
+type UpdateAgentConfigInput = z.infer<typeof updateAgentConfigInputSchema>;
+declare const agentActionTypeSchema: z.ZodEnum<["recovery_notification_sent", "recovery_retry_scheduled", "recovery_retry_executed", "recovery_abandoned", "routing_bridge_initiated", "routing_payment_completed", "cashflow_digest_sent", "cashflow_anomaly_flagged", "cashflow_yield_converted", "commerce_job_created", "commerce_job_approved", "commerce_job_completed", "commerce_job_disputed"]>;
+type AgentActionType = z.infer<typeof agentActionTypeSchema>;
+declare const agentActionOutcomeSchema: z.ZodEnum<["success", "failure", "pending", "skipped"]>;
+type AgentActionOutcome = z.infer<typeof agentActionOutcomeSchema>;
+declare const agentActivityLogSchema: z.ZodObject<{
+    id: z.ZodString;
+    merchantId: z.ZodString;
+    capability: z.ZodEnum<["identity", "recovery", "routing", "cashflow", "commerce", "pricing_intelligence"]>;
+    actionType: z.ZodEnum<["recovery_notification_sent", "recovery_retry_scheduled", "recovery_retry_executed", "recovery_abandoned", "routing_bridge_initiated", "routing_payment_completed", "cashflow_digest_sent", "cashflow_anomaly_flagged", "cashflow_yield_converted", "commerce_job_created", "commerce_job_approved", "commerce_job_completed", "commerce_job_disputed"]>;
+    outcome: z.ZodEnum<["success", "failure", "pending", "skipped"]>;
+    subscriptionId: z.ZodNullable<z.ZodString>;
+    transactionId: z.ZodNullable<z.ZodString>;
+    jobId: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodDefault<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    merchantId: string;
+    capability: "identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence";
+    actionType: "recovery_notification_sent" | "recovery_retry_scheduled" | "recovery_retry_executed" | "recovery_abandoned" | "routing_bridge_initiated" | "routing_payment_completed" | "cashflow_digest_sent" | "cashflow_anomaly_flagged" | "cashflow_yield_converted" | "commerce_job_created" | "commerce_job_approved" | "commerce_job_completed" | "commerce_job_disputed";
+    outcome: "success" | "failure" | "pending" | "skipped";
+    subscriptionId: string | null;
+    transactionId: string | null;
+    jobId: string | null;
+    metadata: Record<string, string | number | boolean | null>;
+    createdAt: string;
+}, {
+    id: string;
+    merchantId: string;
+    capability: "identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence";
+    actionType: "recovery_notification_sent" | "recovery_retry_scheduled" | "recovery_retry_executed" | "recovery_abandoned" | "routing_bridge_initiated" | "routing_payment_completed" | "cashflow_digest_sent" | "cashflow_anomaly_flagged" | "cashflow_yield_converted" | "commerce_job_created" | "commerce_job_approved" | "commerce_job_completed" | "commerce_job_disputed";
+    outcome: "success" | "failure" | "pending" | "skipped";
+    subscriptionId: string | null;
+    transactionId: string | null;
+    jobId: string | null;
+    createdAt: string;
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+}>;
+type AgentActivityLog = z.infer<typeof agentActivityLogSchema>;
+declare const agentJobStatusSchema: z.ZodEnum<["proposed", "accepted", "in_progress", "delivered", "approved", "completed", "disputed", "cancelled"]>;
+type AgentJobStatus = z.infer<typeof agentJobStatusSchema>;
+declare const agentJobSchema: z.ZodObject<{
+    id: z.ZodString;
+    merchantId: z.ZodString;
+    /** On-chain job id from StrimzAgentEscrow. */
+    onchainJobId: z.ZodNullable<z.ZodNumber>;
+    vendorAddress: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodString;
+    amount: z.ZodEffects<z.ZodString, string, string>;
+    currency: z.ZodEnum<["USDC", "EURC"]>;
+    status: z.ZodEnum<["proposed", "accepted", "in_progress", "delivered", "approved", "completed", "disputed", "cancelled"]>;
+    assessorAddress: z.ZodEffects<z.ZodString, string, string>;
+    deliverableHash: z.ZodNullable<z.ZodString>;
+    escrowTxHash: z.ZodNullable<z.ZodString>;
+    releaseTxHash: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status: "proposed" | "accepted" | "in_progress" | "delivered" | "approved" | "completed" | "disputed" | "cancelled";
+    merchantId: string;
+    createdAt: string;
+    onchainJobId: number | null;
+    vendorAddress: string;
+    description: string;
+    amount: string;
+    currency: "USDC" | "EURC";
+    assessorAddress: string;
+    deliverableHash: string | null;
+    escrowTxHash: string | null;
+    releaseTxHash: string | null;
+    completedAt: string | null;
+}, {
+    id: string;
+    status: "proposed" | "accepted" | "in_progress" | "delivered" | "approved" | "completed" | "disputed" | "cancelled";
+    merchantId: string;
+    createdAt: string;
+    onchainJobId: number | null;
+    vendorAddress: string;
+    description: string;
+    amount: string;
+    currency: "USDC" | "EURC";
+    assessorAddress: string;
+    deliverableHash: string | null;
+    escrowTxHash: string | null;
+    releaseTxHash: string | null;
+    completedAt: string | null;
+}>;
+type AgentJob = z.infer<typeof agentJobSchema>;
+declare const createAgentJobInputSchema: z.ZodObject<{
+    vendorAddress: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodString;
+    amount: z.ZodEffects<z.ZodString, string, string>;
+    currency: z.ZodEnum<["USDC", "EURC"]>;
+    assessorAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    vendorAddress: string;
+    description: string;
+    amount: string;
+    currency: "USDC" | "EURC";
+    assessorAddress?: string | undefined;
+}, {
+    vendorAddress: string;
+    description: string;
+    amount: string;
+    currency: "USDC" | "EURC";
+    assessorAddress?: string | undefined;
+}>;
+type CreateAgentJobInput = z.infer<typeof createAgentJobInputSchema>;
+
+export { type AgentActionOutcome, type AgentActionType, type AgentActivityLog, type AgentCapability, type AgentIdentity, type AgentJob, type AgentJobStatus, type AgentMerchantConfig, type CreateAgentJobInput, type UpdateAgentConfigInput, agentActionOutcomeSchema, agentActionTypeSchema, agentActivityLogSchema, agentCapabilitySchema, agentIdentitySchema, agentJobSchema, agentJobStatusSchema, agentMerchantConfigSchema, createAgentJobInputSchema, updateAgentConfigInputSchema };