@agentproto/agencies 0.1.0-alpha.0

package/dist/chunk-DYQ4A5HV.mjs

@@ -0,0 +1,649 @@
+import { z } from 'zod';
+
+/**
+ * @agentproto/agencies v0.1.0-alpha
+ * agentagencies/v1 — operating layer for entities that exercise agency.
+ * Vendor-neutral. Filesystem-first. Extends agentcompanies/v1 + agentgovernance/v1.
+ */
+
+var SCHEMA_NAME = "agentagencies/v1";
+var kebabSlugSchema = z.string().regex(/^[a-z0-9][a-z0-9-]*$/, {
+  message: "Expected kebab-case slug (lowercase, alphanumeric + hyphens, leading alphanumeric)"
+});
+var currencyIsoSchema = z.string().length(3, {
+  message: "Expected ISO 4217 3-letter currency code"
+});
+var countryIsoSchema = z.string().length(2, {
+  message: "Expected ISO 3166 2-letter country code"
+});
+var timezoneSchema = z.string().min(1);
+var isoDurationSchema = z.string().regex(/^P/, {
+  message: "Expected ISO-8601 duration starting with 'P'"
+});
+var isoDateOrDateSchema = z.union([
+  z.iso.date(),
+  z.date().transform((d) => d.toISOString().slice(0, 10))
+]);
+var isoDatetimeOrDateSchema = z.union([
+  z.iso.datetime(),
+  z.date().transform((d) => d.toISOString())
+]);
+var partyRefSchema = z.string().regex(
+  /^(operator|user|counterparty|agent|external|team):([a-z0-9][a-z0-9-]*|\*)$/,
+  { message: "Expected '<kind>:<slug>' or '<kind>:*'" }
+);
+var partyRefStrictSchema = z.string().regex(
+  /^(operator|user|counterparty|agent|external|team):[a-z0-9][a-z0-9-]*$/,
+  { message: "Expected '<kind>:<slug>'" }
+);
+var workspacePathSchema = z.string().min(1).refine((p) => !p.startsWith("/"), {
+  message: "Expected relative path (no leading /)"
+}).refine((p) => !p.includes(".."), { message: "Path must not contain '..'" });
+var metadataSchema = z.record(z.string(), z.unknown());
+var sha256HexSchema = z.string().regex(/^[a-f0-9]{64}$/, {
+  message: "Expected lowercase hex SHA-256 (64 chars)"
+});
+var authorshipFields = {
+  authors: z.array(
+    z.object({
+      name: z.string().min(1),
+      email: z.email().optional(),
+      url: z.string().optional()
+    })
+  ).optional(),
+  homepage: z.string().optional(),
+  tags: z.array(z.string()).optional()
+};
+function envelope(doctype) {
+  return {
+    schema: z.literal(SCHEMA_NAME),
+    doctype: z.literal(doctype),
+    slug: kebabSlugSchema,
+    name: z.string().min(1),
+    description: z.string().optional(),
+    version: z.string().optional(),
+    // semver, optional per agentcompanies convention
+    metadata: metadataSchema.optional()
+  };
+}
+var AUTONOMY_POSTURE = ["full-auto", "hybrid", "manual"];
+var autonomyPostureSchema = z.enum(AUTONOMY_POSTURE);
+var agencyFrontmatterSchema = z.object({
+  ...envelope("agency"),
+  /** Vertical templates this agency uses (slugs from agencies.sh registry, e.g., "design-project"). */
+  verticals: z.array(kebabSlugSchema).default([]),
+  /** Slugs of the primary services this agency offers (refs to services/<slug>/SERVICE.md). */
+  primaryServices: z.array(kebabSlugSchema).default([]),
+  /** Default pricing-model slug applied when a service doesn't specify one. */
+  defaultPricingModel: kebabSlugSchema.optional(),
+  defaultCurrency: currencyIsoSchema.optional(),
+  defaultCountry: countryIsoSchema.optional(),
+  billingTimezone: timezoneSchema.optional(),
+  /** ISO date marking the start of the fiscal year (e.g., 2026-01-01). */
+  fiscalYearStart: isoDateOrDateSchema.optional(),
+  autonomyPosture: autonomyPostureSchema.default("hybrid"),
+  /** External package paths this AGENCY.md pulls in. Mirrors COMPANY.md.includes[]. */
+  includes: z.array(z.string()).default([])
+});
+var AGENCY_FILENAME = "AGENCY.md";
+var operationsFrontmatterSchema = z.object({
+  ...envelope("operations"),
+  ...authorshipFields,
+  /** External package paths or registry shortnames this OPERATIONS.md pulls in. */
+  includes: z.array(z.string()).default([]),
+  /** License (matches agentcompanies/v1 conventions). */
+  license: z.string().optional()
+});
+var OPERATIONS_FILENAME = "OPERATIONS.md";
+var serviceFrontmatterSchema = z.object({
+  ...envelope("service"),
+  /**
+   * Skills required to deliver this service. Refs to companies.sh skills
+   * (`SKILL.md` shortnames or paths); resolution per skills.sh / companies.sh rules.
+   */
+  requiredSkills: z.array(z.string()).default([]),
+  /** Default procedure slug to execute when this service is invoked. */
+  defaultProcedure: kebabSlugSchema.optional(),
+  /** Default pricing-model slug. */
+  defaultPricingModel: kebabSlugSchema.optional(),
+  /** Estimated duration as ISO-8601 duration (e.g., PT2H, P5D). */
+  estimatedDuration: isoDurationSchema.optional(),
+  /** Free-form prerequisites for the counterparty (info needed before scoping). */
+  prerequisites: z.array(z.string()).default([]),
+  /**
+   * Scope template — the structure of the engagement scope when this service
+   * is sold. Free-form for v1; templates may add their own conventions.
+   */
+  scopeTemplate: z.unknown().optional(),
+  /** Tags for catalog discovery (e.g., ["plumbing", "emergency"]). */
+  tags: z.array(z.string()).default([]),
+  /** External listing flag — show on agencies.sh registry / public pages. */
+  publishable: z.boolean().default(true)
+});
+var SERVICE_FILENAME = "SERVICE.md";
+var procedureTriggerSchema = z.discriminatedUnion("kind", [
+  z.object({ kind: z.literal("service"), service: kebabSlugSchema }),
+  z.object({ kind: z.literal("routine"), routine: kebabSlugSchema }),
+  z.object({ kind: z.literal("manual"), description: z.string().optional() }),
+  z.object({ kind: z.literal("event"), eventType: z.string() })
+]);
+var stepBaseSchema = z.object({
+  id: kebabSlugSchema,
+  description: z.string().optional(),
+  /** Skill required to execute this step (refs companies.sh SKILL.md). */
+  requiredSkill: z.string().optional(),
+  /** What this step produces (free-form descriptor). */
+  output: z.string().optional()
+});
+var procedureSimpleStepSchema = stepBaseSchema.extend({
+  branch: z.never().optional()
+});
+var procedureBranchStepSchema = stepBaseSchema.extend({
+  branch: z.array(
+    z.object({
+      if: z.string().optional(),
+      // condition expression (free-form for v1)
+      else: z.boolean().optional(),
+      action: z.string()
+      // "proceed_repair", "requestSignaturesTool", "advance_to_step:<id>", etc.
+    })
+  ).min(1)
+});
+var procedureStepSchema = z.union([
+  procedureSimpleStepSchema,
+  procedureBranchStepSchema
+]);
+var procedureFrontmatterSchema = z.object({
+  ...envelope("procedure"),
+  /** What invokes this procedure. */
+  triggers: z.array(procedureTriggerSchema).default([]),
+  /** Skills required across the whole procedure (union of step requirements). */
+  requiredSkills: z.array(z.string()).default([]),
+  /** Estimated total duration (ISO-8601 duration). */
+  estimatedDuration: isoDurationSchema.optional(),
+  /**
+   * Slug of a POLICY.md (agentgovernance/v1) that governs autonomy for this
+   * procedure. Steps may individually require signatures via the policy.
+   */
+  autonomyPolicy: kebabSlugSchema.optional(),
+  /** Steps in declared order. */
+  steps: z.array(procedureStepSchema).min(1),
+  /**
+   * Default approvers when a step gates on signature without an explicit
+   * policy override (typically refs governance.requiredSignatures).
+   */
+  defaultApprovers: z.array(partyRefSchema).default([])
+});
+var PROCEDURE_FILENAME = "PROCEDURE.md";
+var PRICING_KIND = [
+  "fixed",
+  "hourly",
+  "retainer",
+  "milestone",
+  "value",
+  "usage_metered"
+];
+var pricingKindSchema = z.enum(PRICING_KIND);
+var fixedPricingSchema = z.object({
+  kind: z.literal("fixed"),
+  amount: z.number().positive(),
+  currency: currencyIsoSchema
+});
+var hourlyPricingSchema = z.object({
+  kind: z.literal("hourly"),
+  rate: z.number().positive(),
+  currency: currencyIsoSchema,
+  /** Optional cap on total hours billable. */
+  capHours: z.number().positive().optional()
+});
+var retainerPricingSchema = z.object({
+  kind: z.literal("retainer"),
+  amount: z.number().positive(),
+  currency: currencyIsoSchema,
+  /** ISO duration of one billing period (e.g., P1M for monthly). */
+  period: isoDurationSchema,
+  /** Minimum commitment as ISO duration (e.g., P12M for 12 months). */
+  minCommitment: isoDurationSchema.optional()
+});
+var milestonePricingSchema = z.object({
+  kind: z.literal("milestone"),
+  currency: currencyIsoSchema,
+  milestones: z.array(
+    z.object({
+      slug: z.string(),
+      description: z.string().optional(),
+      amount: z.number().positive(),
+      /** Optional ISO date or duration relative to engagement start. */
+      dueAt: z.string().optional()
+    })
+  ).min(1)
+});
+var valuePricingSchema = z.object({
+  kind: z.literal("value"),
+  currency: currencyIsoSchema,
+  /** Free-form outcome formula description. */
+  formula: z.string(),
+  baseFee: z.number().nonnegative().optional(),
+  capAmount: z.number().positive().optional()
+});
+var usageMeteredPricingSchema = z.object({
+  kind: z.literal("usage_metered"),
+  currency: currencyIsoSchema,
+  unit: z.string(),
+  // e.g., "request", "minute", "GB"
+  ratePerUnit: z.number().positive(),
+  /** Optional included quota before metering kicks in. */
+  includedUnits: z.number().nonnegative().optional(),
+  /** Stripe-compatible meter id (vendor extension). */
+  externalMeterId: z.string().optional()
+});
+var pricingDetailsSchema = z.discriminatedUnion("kind", [
+  fixedPricingSchema,
+  hourlyPricingSchema,
+  retainerPricingSchema,
+  milestonePricingSchema,
+  valuePricingSchema,
+  usageMeteredPricingSchema
+]);
+var pricingModelFrontmatterSchema = z.object({
+  ...envelope("pricing-model"),
+  details: pricingDetailsSchema,
+  /** Default tax handling (vendor extensions in metadata.<vendor>.tax.*). */
+  taxIncluded: z.boolean().optional()
+});
+var PRICING_MODEL_FILENAME = "PRICING-MODEL.md";
+var COUNTERPARTY_KIND = ["individual", "organization"];
+var counterpartyKindSchema = z.enum(COUNTERPARTY_KIND);
+var COUNTERPARTY_SOURCE = [
+  "manual",
+  "inbound_email",
+  "imported",
+  "api"
+];
+var counterpartySourceSchema = z.enum(COUNTERPARTY_SOURCE);
+var counterpartyChannelSchema = z.object({
+  kind: z.enum(["email", "whatsapp", "sms"]),
+  address: z.string(),
+  // normalized: lowercased email / E.164 phone
+  isPrimary: z.boolean().default(false),
+  verifiedAt: isoDatetimeOrDateSchema.optional(),
+  optInAt: isoDatetimeOrDateSchema.optional(),
+  optOutAt: isoDatetimeOrDateSchema.optional(),
+  optOutReason: z.string().optional(),
+  bouncedAt: isoDatetimeOrDateSchema.optional(),
+  bounceReason: z.string().optional()
+});
+var counterpartyFrontmatterSchema = z.object({
+  ...envelope("counterparty"),
+  kind: counterpartyKindSchema,
+  /** Display name (NOT the legal name; legal name lives in encrypted PII). */
+  displayName: z.string().min(1),
+  /** Pre-resolved primary email (denorm of channels[isPrimary, kind=email]). */
+  primaryEmail: z.email().optional(),
+  /** Pre-resolved primary phone in E.164 (denorm of channels[isPrimary, kind=whatsapp|sms]). */
+  primaryPhone: z.string().optional(),
+  channels: z.array(counterpartyChannelSchema).default([]),
+  country: countryIsoSchema.optional(),
+  currency: currencyIsoSchema.optional(),
+  timezone: timezoneSchema.optional(),
+  source: counterpartySourceSchema.default("manual"),
+  /**
+   * Path to encrypted PII blob (e.g., legal name, address, taxId, DOB).
+   * The blob is encrypted at rest with a workspace-level key; only `displayName`
+   * + `primaryEmail` + `primaryPhone` are unencrypted (for inbound channel routing).
+   */
+  piiBlobRef: z.string().optional(),
+  /** Self-FK for dedup: this counterparty is merged into another (canonical) one. */
+  mergedIntoId: kebabSlugSchema.optional(),
+  /** Free-form tags for segmentation (e.g., ["enterprise", "newsletter-2026"]). */
+  tags: z.array(z.string()).default([])
+});
+var COUNTERPARTY_FILENAME = "COUNTERPARTY.md";
+var ENGAGEMENT_KIND = [
+  "one_shot",
+  "milestone",
+  "retainer",
+  "usage_metered"
+];
+var engagementKindSchema = z.enum(ENGAGEMENT_KIND);
+var ENGAGEMENT_STATUS = [
+  "scoping",
+  "quoted",
+  "signed",
+  "in_progress",
+  "review_requested",
+  "revision",
+  "validated",
+  "invoiced",
+  "paid",
+  "closed",
+  "cancelled",
+  "disputed"
+];
+var engagementStatusSchema = z.enum(ENGAGEMENT_STATUS);
+var engagementPartySchema = z.object({
+  /** Role in the engagement (e.g., "client", "primary-contact", "executor"). */
+  role: z.string().min(1),
+  /** Canonical "<kind>:<slug>" — counterparty:..., operator:..., agent:..., etc. */
+  party: partyRefStrictSchema,
+  /** Optional revenue-share percentage (0-100). Sum across parties may exceed 100 (multi-step splits). */
+  share: z.number().min(0).max(100).optional()
+});
+var engagementFrontmatterSchema = z.object({
+  ...envelope("engagement"),
+  kind: engagementKindSchema,
+  status: engagementStatusSchema,
+  /** All parties — roles + canonical refs. */
+  parties: z.array(engagementPartySchema).min(1),
+  /** Denormalized: primary counterparty for fast queries. */
+  primaryCounterpartyId: kebabSlugSchema,
+  /** Service slug being delivered. */
+  serviceSlug: kebabSlugSchema.optional(),
+  /** Active procedure being executed (PROCEDURE.md slug). */
+  activeProcedure: kebabSlugSchema.optional(),
+  /** Active step within the procedure (step id). */
+  activeStep: kebabSlugSchema.optional(),
+  /** Path to the AGREEMENT.md (relative to engagement folder). */
+  agreementPath: z.string().default("AGREEMENT.md"),
+  /** Path to the linked PROJECT.md (companies.sh) — the work. */
+  projectPath: workspacePathSchema.optional(),
+  /** Pricing model in effect for this engagement. */
+  pricingModelSlug: kebabSlugSchema.optional(),
+  totalContractValue: z.number().nonnegative().optional(),
+  currency: currencyIsoSchema.optional(),
+  /** Affiliate referral link (refs core/affiliate domain if present). */
+  referredByAffiliateId: kebabSlugSchema.optional(),
+  // Lifecycle timestamps (denorm of audit-log + workflow state).
+  scopedAt: isoDatetimeOrDateSchema.optional(),
+  signedAt: isoDatetimeOrDateSchema.optional(),
+  startedAt: isoDatetimeOrDateSchema.optional(),
+  validatedAt: isoDatetimeOrDateSchema.optional(),
+  paidAt: isoDatetimeOrDateSchema.optional(),
+  closedAt: isoDatetimeOrDateSchema.optional()
+});
+var ENGAGEMENT_FILENAME = "ENGAGEMENT.md";
+var AGREEMENT_KIND = ["quote", "agreement"];
+var agreementKindSchema = z.enum(AGREEMENT_KIND);
+var AGREEMENT_STATUS = [
+  "draft",
+  "proposed",
+  "signed",
+  "superseded",
+  "expired",
+  "void",
+  "cancelled"
+];
+var agreementStatusSchema = z.enum(AGREEMENT_STATUS);
+var agreementPartySchema = z.object({
+  role: z.string().min(1),
+  party: partyRefStrictSchema,
+  share: z.number().min(0).max(100).optional()
+});
+var lineItemSchema = z.object({
+  /** Stable UUID for the line item — survives revisions. */
+  lineItemId: z.uuid(),
+  description: z.string().min(1),
+  quantity: z.number().positive().default(1),
+  unitAmount: z.number().nonnegative(),
+  currency: currencyIsoSchema,
+  /** When this line item triggers payment (used by milestone pricing). */
+  paymentTrigger: z.string().optional()
+});
+var paymentTermsSchema = z.object({
+  /** ISO-8601 duration: net payment window after invoice (e.g., PT0H, P15D, P30D). */
+  netDuration: isoDurationSchema.default("P30D"),
+  /** Schedule kind: at signature, on milestones, monthly retainer, etc. */
+  schedule: z.enum(["at_signature", "milestone", "retainer", "on_completion", "custom"]).default("on_completion"),
+  /** Late fee terms — free-form for v1. */
+  latePolicy: z.string().optional()
+});
+var requiredSignerSchema = z.object({
+  signer: partyRefStrictSchema,
+  method: z.enum([
+    "typed_name",
+    "agent_confirm",
+    "click_through",
+    "esign_external"
+  ]),
+  weight: z.number().min(0).optional()
+});
+var agreementFrontmatterSchema = z.object({
+  ...envelope("agreement"),
+  kind: agreementKindSchema,
+  status: agreementStatusSchema.default("draft"),
+  parties: z.array(agreementPartySchema).min(2),
+  /** Denormalized: primary counterparty for fast queries. */
+  primaryCounterpartyId: kebabSlugSchema,
+  lineItems: z.array(lineItemSchema).default([]),
+  currency: currencyIsoSchema,
+  // single currency per agreement (multi-currency = separate agreements)
+  /** Denormalized total of lineItems[].quantity * unitAmount. */
+  totalAmount: z.number().nonnegative().optional(),
+  paymentTerms: paymentTermsSchema.default({
+    netDuration: "P30D",
+    schedule: "on_completion"
+  }),
+  /** Free-form deliverable spec (refers to DELIVERABLE.md slugs or describes inline). */
+  deliverableSpec: z.unknown().optional(),
+  /** Required signatures (defers to agentgovernance/v1 contractual approval framework). */
+  requiredSignatures: z.array(requiredSignerSchema).default([]),
+  /** Legal jurisdiction + governing law. */
+  governingLaw: z.string().optional(),
+  jurisdiction: z.string().optional(),
+  /** Hash of the rendered SoW PDF (or canonical bytes if no PDF). Witness for the signature. */
+  documentHash: sha256HexSchema.optional(),
+  /** Storage ref for the rendered immutable PDF/document. */
+  documentBlobRef: z.string().optional(),
+  /** Versioning chain. */
+  version: z.string().default("1"),
+  /** Self-ref to the previous version's slug (when this agreement supersedes another). */
+  parentAgreement: kebabSlugSchema.optional(),
+  effectiveAt: isoDatetimeOrDateSchema.optional(),
+  expiresAt: isoDatetimeOrDateSchema.optional(),
+  signedAt: isoDatetimeOrDateSchema.optional()
+});
+var AGREEMENT_FILENAME = "AGREEMENT.md";
+var DELIVERABLE_STATUS = [
+  "draft",
+  "submitted",
+  "under_review",
+  "validated",
+  "rejected",
+  "revised",
+  "superseded"
+];
+var deliverableStatusSchema = z.enum(DELIVERABLE_STATUS);
+var requiredSignerSchema2 = z.object({
+  signer: partyRefStrictSchema,
+  method: z.enum([
+    "typed_name",
+    "agent_confirm",
+    "click_through",
+    "esign_external"
+  ]),
+  weight: z.number().min(0).optional()
+});
+var deliverableFrontmatterSchema = z.object({
+  ...envelope("deliverable"),
+  status: deliverableStatusSchema.default("draft"),
+  /** Path to the linked TASK.md (companies.sh) if this deliverable resulted from one. */
+  taskPath: workspacePathSchema.optional(),
+  /**
+   * Workspace-relative paths to attached work products (binary or other artifacts).
+   * Each MAY be hashed; the hash anchors what was reviewed.
+   */
+  attachments: z.array(
+    z.object({
+      path: workspacePathSchema,
+      contentHash: sha256HexSchema.optional(),
+      kind: z.string().optional()
+      // "image", "pdf", "video", "document", "code", etc.
+    })
+  ).default([]),
+  /** Required signatures for client validation (typically `[counterparty:<id>]`). */
+  requiredSignatures: z.array(requiredSignerSchema2).default([]),
+  /** Hash of the deliverable.md frontmatter+body — what the signer signs against. */
+  documentHash: sha256HexSchema.optional(),
+  /** Self-ref for revision chain. */
+  parentDeliverable: kebabSlugSchema.optional(),
+  version: z.string().default("1"),
+  submittedAt: isoDatetimeOrDateSchema.optional(),
+  validatedAt: isoDatetimeOrDateSchema.optional(),
+  rejectedAt: isoDatetimeOrDateSchema.optional(),
+  rejectionReason: z.string().optional()
+});
+var DELIVERABLE_FILENAME = "DELIVERABLE.md";
+var INVOICE_STATUS = [
+  "draft",
+  "issued",
+  "paid",
+  "void",
+  "uncollectible"
+];
+var invoiceStatusSchema = z.enum(INVOICE_STATUS);
+var lineItemSchema2 = z.object({
+  lineItemId: z.uuid(),
+  description: z.string().min(1),
+  quantity: z.number().positive().default(1),
+  unitAmount: z.number().nonnegative(),
+  /** Reference to the originating engagement deliverable / agreement line item. */
+  sourceRef: z.string().optional()
+});
+var taxLineSchema = z.object({
+  /** Decimal rate (e.g., 0.20 for 20% VAT). */
+  rate: z.number().min(0).max(1),
+  /** Base amount taxed. */
+  base: z.number().nonnegative(),
+  /** Computed tax amount. */
+  amount: z.number().nonnegative(),
+  /** Jurisdiction code (e.g., "FR-VAT", "US-CA-SALES"). */
+  jurisdiction: z.string()
+});
+var externalRefsSchema = z.record(
+  z.string(),
+  z.record(z.string(), z.string()).optional()
+);
+var invoiceFrontmatterSchema = z.object({
+  ...envelope("invoice"),
+  status: invoiceStatusSchema.default("draft"),
+  /** Per-tenant gapless invoice number (e.g., INV-2026-00042). */
+  invoiceNumber: z.string().min(1),
+  /** Workspace-relative path to the engagement folder. */
+  engagementSlug: kebabSlugSchema.optional(),
+  agreementSlug: kebabSlugSchema.optional(),
+  counterpartyId: kebabSlugSchema,
+  billingAccountId: kebabSlugSchema.optional(),
+  lineItems: z.array(lineItemSchema2).min(1),
+  taxLines: z.array(taxLineSchema).default([]),
+  subtotal: z.number().nonnegative(),
+  taxTotal: z.number().nonnegative().default(0),
+  total: z.number().nonnegative(),
+  currency: currencyIsoSchema,
+  /** FX snapshot — used when invoice currency != billing-account base currency. */
+  fxRate: z.number().positive().optional(),
+  fxBaseCurrency: currencyIsoSchema.optional(),
+  fxAt: isoDatetimeOrDateSchema.optional(),
+  dueAt: isoDatetimeOrDateSchema.optional(),
+  issuedAt: isoDatetimeOrDateSchema.optional(),
+  paidAt: isoDatetimeOrDateSchema.optional(),
+  voidedAt: isoDatetimeOrDateSchema.optional(),
+  voidReason: z.string().optional(),
+  /** Storage ref for the rendered immutable PDF. */
+  pdfBlobRef: z.string().optional(),
+  /** SHA-256 of the rendered PDF. */
+  pdfHash: sha256HexSchema.optional(),
+  /** Provider-specific linkage — Stripe payment intent id, paypal capture id, etc. */
+  externalRefs: externalRefsSchema.optional(),
+  /** Public payment link (set after `issueInvoiceCheckoutTool` runs). */
+  paymentLinkUrl: z.string().optional(),
+  /** Dunning state for retainer/late invoices. */
+  dunningState: z.enum(["none", "reminder_1", "reminder_2", "final_notice", "collections"]).default("none"),
+  nextReminderAt: isoDatetimeOrDateSchema.optional()
+});
+var INVOICE_FILENAME = "INVOICE.md";
+var triggerScheduleSchema = z.object({
+  kind: z.literal("schedule"),
+  /** Standard 5-field cron (UTC by default unless timezone is set). */
+  cronExpression: z.string().min(1),
+  timezone: timezoneSchema.optional()
+});
+var triggerEventSchema = z.object({
+  kind: z.literal("event"),
+  /** Event type to react to (free-form for v1). */
+  eventType: z.string()
+});
+var triggerWebhookSchema = z.object({
+  kind: z.literal("webhook"),
+  webhookSlug: z.string()
+});
+var routineTriggerSchema = z.discriminatedUnion("kind", [
+  triggerScheduleSchema,
+  triggerEventSchema,
+  triggerWebhookSchema
+]);
+var routineConditionSchema = z.object({
+  /** Free-form condition expression (e.g., "engagementStatus == 'pending_signature'"). */
+  expression: z.string().optional(),
+  /** Pre-defined condition kinds for common cases. */
+  engagementStatus: z.string().optional(),
+  /** Maximum runs per period (e.g., max 3 nudges per week). */
+  maxPerPeriod: z.object({
+    count: z.number().positive(),
+    period: isoDurationSchema
+  }).optional()
+});
+var routineEscalationSchema = z.object({
+  /** ISO duration: how long before deadline to escalate. */
+  ifPendingAfter: isoDurationSchema,
+  escalateTo: z.array(partyRefStrictSchema).min(1)
+});
+var routineFrontmatterSchema = z.object({
+  ...envelope("routine"),
+  /** Procedure to run on trigger (PROCEDURE.md slug). */
+  runs: kebabSlugSchema,
+  trigger: routineTriggerSchema,
+  conditions: z.array(routineConditionSchema).default([]),
+  escalation: routineEscalationSchema.optional(),
+  /** Disabled flag for ad-hoc pausing without deletion. */
+  enabled: z.boolean().default(true)
+});
+var ROUTINE_FILENAME = "ROUTINE.md";
+var availabilityWindowSchema = z.object({
+  /** ISO weekday name or 0-6 (Mon=0..Sun=6). */
+  weekday: z.union([
+    z.number().min(0).max(6),
+    z.enum(["mon", "tue", "wed", "thu", "fri", "sat", "sun"])
+  ]),
+  /** "HH:MM" 24h start time (in operator's timezone). */
+  start: z.string().regex(/^\d{2}:\d{2}$/),
+  end: z.string().regex(/^\d{2}:\d{2}$/)
+});
+var capacityFrontmatterSchema = z.object({
+  ...envelope("capacity"),
+  /** The party this capacity describes (operator, agent, or team). */
+  for: partyRefStrictSchema,
+  /** Recurring availability windows (in operator's timezone). */
+  availability: z.array(availabilityWindowSchema).default([]),
+  /** Maximum concurrent engagements. */
+  maxConcurrentEngagements: z.number().positive().optional(),
+  /** Maximum hours per week of billable work. */
+  maxBillableHoursPerWeek: z.number().positive().optional(),
+  /** Vertical specializations (slugs of services or templates). */
+  specializations: z.array(kebabSlugSchema).default([]),
+  /** Current load — denorm of in-flight work (regenerated by runtime). */
+  currentEngagementCount: z.number().nonnegative().optional(),
+  currentBillableHoursThisWeek: z.number().nonnegative().optional(),
+  /** Out-of-office / unavailability windows. */
+  blockedWindows: z.array(
+    z.object({
+      from: isoDatetimeOrDateSchema,
+      until: isoDatetimeOrDateSchema,
+      reason: z.string().optional()
+    })
+  ).default([])
+});
+var CAPACITY_FILENAME = "CAPACITY.md";
+
+export { AGENCY_FILENAME, AGREEMENT_FILENAME, AGREEMENT_KIND, AGREEMENT_STATUS, AUTONOMY_POSTURE, CAPACITY_FILENAME, COUNTERPARTY_FILENAME, COUNTERPARTY_KIND, COUNTERPARTY_SOURCE, DELIVERABLE_FILENAME, DELIVERABLE_STATUS, ENGAGEMENT_FILENAME, ENGAGEMENT_KIND, ENGAGEMENT_STATUS, INVOICE_FILENAME, INVOICE_STATUS, OPERATIONS_FILENAME, PRICING_KIND, PRICING_MODEL_FILENAME, PROCEDURE_FILENAME, ROUTINE_FILENAME, SCHEMA_NAME, SERVICE_FILENAME, agencyFrontmatterSchema, agreementFrontmatterSchema, agreementKindSchema, agreementStatusSchema, authorshipFields, autonomyPostureSchema, capacityFrontmatterSchema, counterpartyFrontmatterSchema, counterpartyKindSchema, counterpartySourceSchema, countryIsoSchema, currencyIsoSchema, deliverableFrontmatterSchema, deliverableStatusSchema, engagementFrontmatterSchema, engagementKindSchema, engagementStatusSchema, envelope, invoiceFrontmatterSchema, invoiceStatusSchema, isoDateOrDateSchema, isoDatetimeOrDateSchema, isoDurationSchema, kebabSlugSchema, metadataSchema, operationsFrontmatterSchema, partyRefSchema, partyRefStrictSchema, pricingDetailsSchema, pricingKindSchema, pricingModelFrontmatterSchema, procedureBranchStepSchema, procedureFrontmatterSchema, procedureSimpleStepSchema, procedureStepSchema, procedureTriggerSchema, routineFrontmatterSchema, routineTriggerSchema, serviceFrontmatterSchema, sha256HexSchema, timezoneSchema, workspacePathSchema };
+//# sourceMappingURL=chunk-DYQ4A5HV.mjs.map
+//# sourceMappingURL=chunk-DYQ4A5HV.mjs.map