@agentproto/agencies 0.1.0-alpha.0

package/dist/capacity-98VwY285.d.ts

@@ -0,0 +1,862 @@
+import { z } from 'zod';
+
+/**
+ * agentagencies/v1 — `AGENCY.md` doctype.
+ *
+ * Operational profile of the company when it acts as an agency.
+ * Lives at `<workspace-root>/AGENCY.md` alongside (NOT replacing) `COMPANY.md`
+ * from agentcompanies/v1. Optional — a workspace is a valid agentagencies
+ * package without it as long as the other doctypes are reachable via
+ * `COMPANY.md.includes[]` or filesystem convention.
+ *
+ * Carries operational defaults that would otherwise be sprinkled across
+ * services / pricing / policies (verticals, default currency, autonomy posture).
+ */
+declare const AUTONOMY_POSTURE: readonly ["full-auto", "hybrid", "manual"];
+declare const autonomyPostureSchema: z.ZodEnum<{
+    "full-auto": "full-auto";
+    hybrid: "hybrid";
+    manual: "manual";
+}>;
+type AutonomyPosture = z.infer<typeof autonomyPostureSchema>;
+declare const agencyFrontmatterSchema: z.ZodObject<{
+    verticals: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    primaryServices: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    defaultPricingModel: z.ZodOptional<z.ZodString>;
+    defaultCurrency: z.ZodOptional<z.ZodString>;
+    defaultCountry: z.ZodOptional<z.ZodString>;
+    billingTimezone: z.ZodOptional<z.ZodString>;
+    fiscalYearStart: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODate, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    autonomyPosture: z.ZodDefault<z.ZodEnum<{
+        "full-auto": "full-auto";
+        hybrid: "hybrid";
+        manual: "manual";
+    }>>;
+    includes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"agency">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type AgencyFrontmatter = z.infer<typeof agencyFrontmatterSchema>;
+interface Agency {
+    frontmatter: AgencyFrontmatter;
+    body: string;
+}
+declare const AGENCY_FILENAME: "AGENCY.md";
+
+/**
+ * agentagencies/v1 — `OPERATIONS.md` doctype.
+ *
+ * Root file for **external** operations packages — used when ops live in a
+ * separate package from the company package, referenced via `includes[]`
+ * from `COMPANY.md` or `AGENCY.md`. Analog of `COMPANY.md` (companies.sh)
+ * but scoped to operations only.
+ *
+ * A holding company with multiple agency divisions might have:
+ *   big-corp/COMPANY.md  → includes: [../plumbing-ops, ../design-ops]
+ *   plumbing-ops/OPERATIONS.md
+ *   design-ops/OPERATIONS.md
+ */
+declare const operationsFrontmatterSchema: z.ZodObject<{
+    includes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    license: z.ZodOptional<z.ZodString>;
+    authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodEmail>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    homepage: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"operations">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type OperationsFrontmatter = z.infer<typeof operationsFrontmatterSchema>;
+interface Operations {
+    frontmatter: OperationsFrontmatter;
+    body: string;
+}
+declare const OPERATIONS_FILENAME: "OPERATIONS.md";
+
+/**
+ * agentagencies/v1 — `SERVICE.md` doctype.
+ *
+ * Catalog item — what the agency sells. Composes one or more SKILL.md
+ * (companies.sh) refs + a default PROCEDURE.md (the playbook to execute when
+ * this service is requested) + a default pricing model + scope template.
+ */
+declare const serviceFrontmatterSchema: z.ZodObject<{
+    requiredSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    defaultProcedure: z.ZodOptional<z.ZodString>;
+    defaultPricingModel: z.ZodOptional<z.ZodString>;
+    estimatedDuration: z.ZodOptional<z.ZodString>;
+    prerequisites: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    scopeTemplate: z.ZodOptional<z.ZodUnknown>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    publishable: z.ZodDefault<z.ZodBoolean>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"service">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type ServiceFrontmatter = z.infer<typeof serviceFrontmatterSchema>;
+interface Service {
+    frontmatter: ServiceFrontmatter;
+    body: string;
+}
+declare const SERVICE_FILENAME: "SERVICE.md";
+
+/**
+ * agentagencies/v1 — `PROCEDURE.md` doctype.
+ *
+ * Vendor-neutral playbook. Step-by-step "how to do X": triggers, required skills,
+ * autonomy policy, branching steps with expected outputs.
+ *
+ * A Mastra workflow.ts is *one possible implementation* of a PROCEDURE.md;
+ * other orchestrators (Temporal, n8n, manual humans) can read and follow the
+ * same procedure without our infrastructure.
+ *
+ * Relationship to ROUTINE.md: ROUTINE.md says "when" (cron, triggers); PROCEDURE.md
+ * says "what" (steps).
+ */
+declare const procedureTriggerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"service">;
+    service: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"routine">;
+    routine: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"manual">;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    eventType: z.ZodString;
+}, z.core.$strip>], "kind">;
+type ProcedureTrigger = z.infer<typeof procedureTriggerSchema>;
+/** A simple step without branching. */
+declare const procedureSimpleStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    requiredSkill: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>;
+/** A branching step — picks which step (by id) to run next based on conditions. */
+declare const procedureBranchStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    requiredSkill: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    branch: z.ZodArray<z.ZodObject<{
+        if: z.ZodOptional<z.ZodString>;
+        else: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const procedureStepSchema: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    requiredSkill: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    requiredSkill: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    branch: z.ZodArray<z.ZodObject<{
+        if: z.ZodOptional<z.ZodString>;
+        else: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
+type ProcedureStep = z.infer<typeof procedureStepSchema>;
+declare const procedureFrontmatterSchema: z.ZodObject<{
+    triggers: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"service">;
+        service: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"routine">;
+        routine: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"manual">;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"event">;
+        eventType: z.ZodString;
+    }, z.core.$strip>], "kind">>>;
+    requiredSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    estimatedDuration: z.ZodOptional<z.ZodString>;
+    autonomyPolicy: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        requiredSkill: z.ZodOptional<z.ZodString>;
+        output: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        requiredSkill: z.ZodOptional<z.ZodString>;
+        output: z.ZodOptional<z.ZodString>;
+        branch: z.ZodArray<z.ZodObject<{
+            if: z.ZodOptional<z.ZodString>;
+            else: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>;
+    defaultApprovers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"procedure">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type ProcedureFrontmatter = z.infer<typeof procedureFrontmatterSchema>;
+interface Procedure {
+    frontmatter: ProcedureFrontmatter;
+    body: string;
+}
+declare const PROCEDURE_FILENAME: "PROCEDURE.md";
+
+/**
+ * agentagencies/v1 — `PRICING-MODEL.md` doctype.
+ *
+ * Pricing rule. Determines how a service is priced + how it gets billed.
+ * Six kinds for v1:
+ *   - fixed         — single price for the whole engagement
+ *   - hourly        — billed per hour worked (with optional cap)
+ *   - retainer      — recurring monthly/period fee
+ *   - milestone     — scheduled payments at defined milestones
+ *   - value         — outcome-based (e.g., % of revenue impact)
+ *   - usage_metered — Stripe-style usage billing
+ */
+declare const PRICING_KIND: readonly ["fixed", "hourly", "retainer", "milestone", "value", "usage_metered"];
+declare const pricingKindSchema: z.ZodEnum<{
+    value: "value";
+    fixed: "fixed";
+    hourly: "hourly";
+    retainer: "retainer";
+    milestone: "milestone";
+    usage_metered: "usage_metered";
+}>;
+type PricingKind = z.infer<typeof pricingKindSchema>;
+declare const pricingDetailsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"fixed">;
+    amount: z.ZodNumber;
+    currency: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"hourly">;
+    rate: z.ZodNumber;
+    currency: z.ZodString;
+    capHours: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"retainer">;
+    amount: z.ZodNumber;
+    currency: z.ZodString;
+    period: z.ZodString;
+    minCommitment: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"milestone">;
+    currency: z.ZodString;
+    milestones: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        amount: z.ZodNumber;
+        dueAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"value">;
+    currency: z.ZodString;
+    formula: z.ZodString;
+    baseFee: z.ZodOptional<z.ZodNumber>;
+    capAmount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"usage_metered">;
+    currency: z.ZodString;
+    unit: z.ZodString;
+    ratePerUnit: z.ZodNumber;
+    includedUnits: z.ZodOptional<z.ZodNumber>;
+    externalMeterId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
+type PricingDetails = z.infer<typeof pricingDetailsSchema>;
+declare const pricingModelFrontmatterSchema: z.ZodObject<{
+    details: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"fixed">;
+        amount: z.ZodNumber;
+        currency: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"hourly">;
+        rate: z.ZodNumber;
+        currency: z.ZodString;
+        capHours: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"retainer">;
+        amount: z.ZodNumber;
+        currency: z.ZodString;
+        period: z.ZodString;
+        minCommitment: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"milestone">;
+        currency: z.ZodString;
+        milestones: z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            amount: z.ZodNumber;
+            dueAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"value">;
+        currency: z.ZodString;
+        formula: z.ZodString;
+        baseFee: z.ZodOptional<z.ZodNumber>;
+        capAmount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"usage_metered">;
+        currency: z.ZodString;
+        unit: z.ZodString;
+        ratePerUnit: z.ZodNumber;
+        includedUnits: z.ZodOptional<z.ZodNumber>;
+        externalMeterId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "kind">;
+    taxIncluded: z.ZodOptional<z.ZodBoolean>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"pricing-model">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type PricingModelFrontmatter = z.infer<typeof pricingModelFrontmatterSchema>;
+interface PricingModel {
+    frontmatter: PricingModelFrontmatter;
+    body: string;
+}
+declare const PRICING_MODEL_FILENAME: "PRICING-MODEL.md";
+
+/**
+ * agentagencies/v1 — `COUNTERPARTY.md` doctype.
+ *
+ * External party (client) — display name, primary channels, country/currency/timezone,
+ * references to encrypted PII blob, mergedIntoId for dedup.
+ *
+ * Counterparties are NOT users / operators / agents. They live outside the
+ * platform; all interactions are via channels (email, WhatsApp, SMS).
+ */
+declare const COUNTERPARTY_KIND: readonly ["individual", "organization"];
+declare const counterpartyKindSchema: z.ZodEnum<{
+    individual: "individual";
+    organization: "organization";
+}>;
+declare const COUNTERPARTY_SOURCE: readonly ["manual", "inbound_email", "imported", "api"];
+declare const counterpartySourceSchema: z.ZodEnum<{
+    manual: "manual";
+    inbound_email: "inbound_email";
+    imported: "imported";
+    api: "api";
+}>;
+declare const counterpartyFrontmatterSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        individual: "individual";
+        organization: "organization";
+    }>;
+    displayName: z.ZodString;
+    primaryEmail: z.ZodOptional<z.ZodEmail>;
+    primaryPhone: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            email: "email";
+            whatsapp: "whatsapp";
+            sms: "sms";
+        }>;
+        address: z.ZodString;
+        isPrimary: z.ZodDefault<z.ZodBoolean>;
+        verifiedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+        optInAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+        optOutAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+        optOutReason: z.ZodOptional<z.ZodString>;
+        bouncedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+        bounceReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    country: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+    source: z.ZodDefault<z.ZodEnum<{
+        manual: "manual";
+        inbound_email: "inbound_email";
+        imported: "imported";
+        api: "api";
+    }>>;
+    piiBlobRef: z.ZodOptional<z.ZodString>;
+    mergedIntoId: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"counterparty">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type CounterpartyFrontmatter = z.infer<typeof counterpartyFrontmatterSchema>;
+interface Counterparty {
+    frontmatter: CounterpartyFrontmatter;
+    body: string;
+}
+declare const COUNTERPARTY_FILENAME: "COUNTERPARTY.md";
+
+/**
+ * agentagencies/v1 — `ENGAGEMENT.md` doctype.
+ *
+ * Commercial instance of a service for a counterparty. Aggregates the work
+ * (PROJECT.md), the contract (AGREEMENT.md), the deliverables, the invoices,
+ * and the active procedure being executed.
+ *
+ * Lifecycle = the workflow's current step. ENGAGEMENT.md `status` is a
+ * denormalization for filesystem-scan filtering, NOT the source of truth.
+ */
+declare const ENGAGEMENT_KIND: readonly ["one_shot", "milestone", "retainer", "usage_metered"];
+declare const engagementKindSchema: z.ZodEnum<{
+    retainer: "retainer";
+    milestone: "milestone";
+    usage_metered: "usage_metered";
+    one_shot: "one_shot";
+}>;
+type EngagementKind = z.infer<typeof engagementKindSchema>;
+/**
+ * Wide engagement status enum for denormalized filesystem-scan filtering.
+ * The authoritative state is the workflow's current step.
+ */
+declare const ENGAGEMENT_STATUS: readonly ["scoping", "quoted", "signed", "in_progress", "review_requested", "revision", "validated", "invoiced", "paid", "closed", "cancelled", "disputed"];
+declare const engagementStatusSchema: z.ZodEnum<{
+    scoping: "scoping";
+    quoted: "quoted";
+    signed: "signed";
+    in_progress: "in_progress";
+    review_requested: "review_requested";
+    revision: "revision";
+    validated: "validated";
+    invoiced: "invoiced";
+    paid: "paid";
+    closed: "closed";
+    cancelled: "cancelled";
+    disputed: "disputed";
+}>;
+type EngagementStatus = z.infer<typeof engagementStatusSchema>;
+declare const engagementFrontmatterSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        retainer: "retainer";
+        milestone: "milestone";
+        usage_metered: "usage_metered";
+        one_shot: "one_shot";
+    }>;
+    status: z.ZodEnum<{
+        scoping: "scoping";
+        quoted: "quoted";
+        signed: "signed";
+        in_progress: "in_progress";
+        review_requested: "review_requested";
+        revision: "revision";
+        validated: "validated";
+        invoiced: "invoiced";
+        paid: "paid";
+        closed: "closed";
+        cancelled: "cancelled";
+        disputed: "disputed";
+    }>;
+    parties: z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        party: z.ZodString;
+        share: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    primaryCounterpartyId: z.ZodString;
+    serviceSlug: z.ZodOptional<z.ZodString>;
+    activeProcedure: z.ZodOptional<z.ZodString>;
+    activeStep: z.ZodOptional<z.ZodString>;
+    agreementPath: z.ZodDefault<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    pricingModelSlug: z.ZodOptional<z.ZodString>;
+    totalContractValue: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+    referredByAffiliateId: z.ZodOptional<z.ZodString>;
+    scopedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    signedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    startedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    validatedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    paidAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    closedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"engagement">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type EngagementFrontmatter = z.infer<typeof engagementFrontmatterSchema>;
+interface Engagement {
+    frontmatter: EngagementFrontmatter;
+    body: string;
+}
+declare const ENGAGEMENT_FILENAME: "ENGAGEMENT.md";
+
+/**
+ * agentagencies/v1 — `AGREEMENT.md` doctype.
+ *
+ * Contract for an engagement. Carries parties, line items, payment terms,
+ * deliverable spec, governing law, and a `requiredSignatures` field that
+ * defers to agentgovernance/v1.
+ *
+ * Once `status === "signed"`, the artifact is effectively immutable — the
+ * runtime layer enforces this via "create new version, supersede" semantics.
+ */
+declare const AGREEMENT_KIND: readonly ["quote", "agreement"];
+declare const agreementKindSchema: z.ZodEnum<{
+    quote: "quote";
+    agreement: "agreement";
+}>;
+type AgreementKind = z.infer<typeof agreementKindSchema>;
+declare const AGREEMENT_STATUS: readonly ["draft", "proposed", "signed", "superseded", "expired", "void", "cancelled"];
+declare const agreementStatusSchema: z.ZodEnum<{
+    void: "void";
+    signed: "signed";
+    cancelled: "cancelled";
+    draft: "draft";
+    proposed: "proposed";
+    superseded: "superseded";
+    expired: "expired";
+}>;
+type AgreementStatus = z.infer<typeof agreementStatusSchema>;
+declare const agreementFrontmatterSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        quote: "quote";
+        agreement: "agreement";
+    }>;
+    status: z.ZodDefault<z.ZodEnum<{
+        void: "void";
+        signed: "signed";
+        cancelled: "cancelled";
+        draft: "draft";
+        proposed: "proposed";
+        superseded: "superseded";
+        expired: "expired";
+    }>>;
+    parties: z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        party: z.ZodString;
+        share: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    primaryCounterpartyId: z.ZodString;
+    lineItems: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        lineItemId: z.ZodUUID;
+        description: z.ZodString;
+        quantity: z.ZodDefault<z.ZodNumber>;
+        unitAmount: z.ZodNumber;
+        currency: z.ZodString;
+        paymentTrigger: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    currency: z.ZodString;
+    totalAmount: z.ZodOptional<z.ZodNumber>;
+    paymentTerms: z.ZodDefault<z.ZodObject<{
+        netDuration: z.ZodDefault<z.ZodString>;
+        schedule: z.ZodDefault<z.ZodEnum<{
+            custom: "custom";
+            retainer: "retainer";
+            milestone: "milestone";
+            at_signature: "at_signature";
+            on_completion: "on_completion";
+        }>>;
+        latePolicy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    deliverableSpec: z.ZodOptional<z.ZodUnknown>;
+    requiredSignatures: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        signer: z.ZodString;
+        method: z.ZodEnum<{
+            typed_name: "typed_name";
+            agent_confirm: "agent_confirm";
+            click_through: "click_through";
+            esign_external: "esign_external";
+        }>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    governingLaw: z.ZodOptional<z.ZodString>;
+    jurisdiction: z.ZodOptional<z.ZodString>;
+    documentHash: z.ZodOptional<z.ZodString>;
+    documentBlobRef: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodString>;
+    parentAgreement: z.ZodOptional<z.ZodString>;
+    effectiveAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    expiresAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    signedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"agreement">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type AgreementFrontmatter = z.infer<typeof agreementFrontmatterSchema>;
+interface Agreement {
+    frontmatter: AgreementFrontmatter;
+    body: string;
+}
+declare const AGREEMENT_FILENAME: "AGREEMENT.md";
+
+/**
+ * agentagencies/v1 — `DELIVERABLE.md` doctype.
+ *
+ * Submitted work product. Extends companies.sh `TASK.md` semantics with
+ * attachments and deferment to agentgovernance/v1 for client validation
+ * (typically `requiredSignatures: [counterparty:<id>]`).
+ */
+declare const DELIVERABLE_STATUS: readonly ["draft", "submitted", "under_review", "validated", "rejected", "revised", "superseded"];
+declare const deliverableStatusSchema: z.ZodEnum<{
+    validated: "validated";
+    draft: "draft";
+    superseded: "superseded";
+    submitted: "submitted";
+    under_review: "under_review";
+    rejected: "rejected";
+    revised: "revised";
+}>;
+type DeliverableStatus = z.infer<typeof deliverableStatusSchema>;
+declare const deliverableFrontmatterSchema: z.ZodObject<{
+    status: z.ZodDefault<z.ZodEnum<{
+        validated: "validated";
+        draft: "draft";
+        superseded: "superseded";
+        submitted: "submitted";
+        under_review: "under_review";
+        rejected: "rejected";
+        revised: "revised";
+    }>>;
+    taskPath: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        contentHash: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    requiredSignatures: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        signer: z.ZodString;
+        method: z.ZodEnum<{
+            typed_name: "typed_name";
+            agent_confirm: "agent_confirm";
+            click_through: "click_through";
+            esign_external: "esign_external";
+        }>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    documentHash: z.ZodOptional<z.ZodString>;
+    parentDeliverable: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodString>;
+    submittedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    validatedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    rejectedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    rejectionReason: z.ZodOptional<z.ZodString>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"deliverable">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type DeliverableFrontmatter = z.infer<typeof deliverableFrontmatterSchema>;
+interface Deliverable {
+    frontmatter: DeliverableFrontmatter;
+    body: string;
+}
+declare const DELIVERABLE_FILENAME: "DELIVERABLE.md";
+
+/**
+ * agentagencies/v1 — `INVOICE.md` doctype.
+ *
+ * Invoice issued to a counterparty. Carries line items, tax lines, totals,
+ * FX (when invoice currency differs from billing-account base), payment status,
+ * and `externalRefs.<provider>` for payment provider linkage (Stripe checkout
+ * sessions, payment intents, etc.).
+ *
+ * Invoice numbering is per-tenant gapless (driven by `_state/invoice-sequence.json`
+ * file-lock pattern in the runtime layer; format like `INV-YYYY-NNNNN`).
+ */
+declare const INVOICE_STATUS: readonly ["draft", "issued", "paid", "void", "uncollectible"];
+declare const invoiceStatusSchema: z.ZodEnum<{
+    void: "void";
+    paid: "paid";
+    draft: "draft";
+    issued: "issued";
+    uncollectible: "uncollectible";
+}>;
+type InvoiceStatus = z.infer<typeof invoiceStatusSchema>;
+declare const invoiceFrontmatterSchema: z.ZodObject<{
+    status: z.ZodDefault<z.ZodEnum<{
+        void: "void";
+        paid: "paid";
+        draft: "draft";
+        issued: "issued";
+        uncollectible: "uncollectible";
+    }>>;
+    invoiceNumber: z.ZodString;
+    engagementSlug: z.ZodOptional<z.ZodString>;
+    agreementSlug: z.ZodOptional<z.ZodString>;
+    counterpartyId: z.ZodString;
+    billingAccountId: z.ZodOptional<z.ZodString>;
+    lineItems: z.ZodArray<z.ZodObject<{
+        lineItemId: z.ZodUUID;
+        description: z.ZodString;
+        quantity: z.ZodDefault<z.ZodNumber>;
+        unitAmount: z.ZodNumber;
+        sourceRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    taxLines: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        rate: z.ZodNumber;
+        base: z.ZodNumber;
+        amount: z.ZodNumber;
+        jurisdiction: z.ZodString;
+    }, z.core.$strip>>>;
+    subtotal: z.ZodNumber;
+    taxTotal: z.ZodDefault<z.ZodNumber>;
+    total: z.ZodNumber;
+    currency: z.ZodString;
+    fxRate: z.ZodOptional<z.ZodNumber>;
+    fxBaseCurrency: z.ZodOptional<z.ZodString>;
+    fxAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    dueAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    issuedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    paidAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    voidedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    voidReason: z.ZodOptional<z.ZodString>;
+    pdfBlobRef: z.ZodOptional<z.ZodString>;
+    pdfHash: z.ZodOptional<z.ZodString>;
+    externalRefs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>>;
+    paymentLinkUrl: z.ZodOptional<z.ZodString>;
+    dunningState: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        reminder_1: "reminder_1";
+        reminder_2: "reminder_2";
+        final_notice: "final_notice";
+        collections: "collections";
+    }>>;
+    nextReminderAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"invoice">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type InvoiceFrontmatter = z.infer<typeof invoiceFrontmatterSchema>;
+interface Invoice {
+    frontmatter: InvoiceFrontmatter;
+    body: string;
+}
+declare const INVOICE_FILENAME: "INVOICE.md";
+
+declare const routineTriggerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"schedule">;
+    cronExpression: z.ZodString;
+    timezone: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    eventType: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"webhook">;
+    webhookSlug: z.ZodString;
+}, z.core.$strip>], "kind">;
+type RoutineTrigger = z.infer<typeof routineTriggerSchema>;
+declare const routineFrontmatterSchema: z.ZodObject<{
+    runs: z.ZodString;
+    trigger: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"schedule">;
+        cronExpression: z.ZodString;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"event">;
+        eventType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"webhook">;
+        webhookSlug: z.ZodString;
+    }, z.core.$strip>], "kind">;
+    conditions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        expression: z.ZodOptional<z.ZodString>;
+        engagementStatus: z.ZodOptional<z.ZodString>;
+        maxPerPeriod: z.ZodOptional<z.ZodObject<{
+            count: z.ZodNumber;
+            period: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    escalation: z.ZodOptional<z.ZodObject<{
+        ifPendingAfter: z.ZodString;
+        escalateTo: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"routine">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type RoutineFrontmatter = z.infer<typeof routineFrontmatterSchema>;
+interface Routine {
+    frontmatter: RoutineFrontmatter;
+    body: string;
+}
+declare const ROUTINE_FILENAME: "ROUTINE.md";
+
+declare const capacityFrontmatterSchema: z.ZodObject<{
+    for: z.ZodString;
+    availability: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        weekday: z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{
+            mon: "mon";
+            tue: "tue";
+            wed: "wed";
+            thu: "thu";
+            fri: "fri";
+            sat: "sat";
+            sun: "sun";
+        }>]>;
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>>>;
+    maxConcurrentEngagements: z.ZodOptional<z.ZodNumber>;
+    maxBillableHoursPerWeek: z.ZodOptional<z.ZodNumber>;
+    specializations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    currentEngagementCount: z.ZodOptional<z.ZodNumber>;
+    currentBillableHoursThisWeek: z.ZodOptional<z.ZodNumber>;
+    blockedWindows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        from: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>;
+        until: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>]>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    schema: z.ZodLiteral<"agentagencies/v1">;
+    doctype: z.ZodLiteral<"capacity">;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type CapacityFrontmatter = z.infer<typeof capacityFrontmatterSchema>;
+interface Capacity {
+    frontmatter: CapacityFrontmatter;
+    body: string;
+}
+declare const CAPACITY_FILENAME: "CAPACITY.md";
+
+export { type RoutineFrontmatter as $, AGENCY_FILENAME as A, type EngagementKind as B, CAPACITY_FILENAME as C, DELIVERABLE_FILENAME as D, ENGAGEMENT_FILENAME as E, type EngagementStatus as F, INVOICE_STATUS as G, type Invoice as H, INVOICE_FILENAME as I, type InvoiceFrontmatter as J, type InvoiceStatus as K, type Operations as L, type OperationsFrontmatter as M, PRICING_MODEL_FILENAME as N, OPERATIONS_FILENAME as O, PRICING_KIND as P, PROCEDURE_FILENAME as Q, type PricingDetails as R, type PricingKind as S, type PricingModel as T, type PricingModelFrontmatter as U, type Procedure as V, type ProcedureFrontmatter as W, type ProcedureStep as X, type ProcedureTrigger as Y, ROUTINE_FILENAME as Z, type Routine as _, AGREEMENT_FILENAME as a, type RoutineTrigger as a0, SERVICE_FILENAME as a1, type Service as a2, type ServiceFrontmatter as a3, agencyFrontmatterSchema as a4, agreementFrontmatterSchema as a5, agreementKindSchema as a6, agreementStatusSchema as a7, autonomyPostureSchema as a8, capacityFrontmatterSchema as a9, counterpartyFrontmatterSchema as aa, counterpartyKindSchema as ab, counterpartySourceSchema as ac, deliverableFrontmatterSchema as ad, deliverableStatusSchema as ae, engagementFrontmatterSchema as af, engagementKindSchema as ag, engagementStatusSchema as ah, invoiceFrontmatterSchema as ai, invoiceStatusSchema as aj, operationsFrontmatterSchema as ak, pricingDetailsSchema as al, pricingKindSchema as am, pricingModelFrontmatterSchema as an, procedureBranchStepSchema as ao, procedureFrontmatterSchema as ap, procedureSimpleStepSchema as aq, procedureStepSchema as ar, procedureTriggerSchema as as, routineFrontmatterSchema as at, routineTriggerSchema as au, serviceFrontmatterSchema as av, AGREEMENT_KIND as b, AGREEMENT_STATUS as c, AUTONOMY_POSTURE as d, type Agency as e, type AgencyFrontmatter as f, type Agreement as g, type AgreementFrontmatter as h, type AgreementKind as i, type AgreementStatus as j, type AutonomyPosture as k, COUNTERPARTY_FILENAME as l, COUNTERPARTY_KIND as m, COUNTERPARTY_SOURCE as n, type Capacity as o, type CapacityFrontmatter as p, type Counterparty as q, type CounterpartyFrontmatter as r, DELIVERABLE_STATUS as s, type Deliverable as t, type DeliverableFrontmatter as u, type DeliverableStatus as v, ENGAGEMENT_KIND as w, ENGAGEMENT_STATUS as x, type Engagement as y, type EngagementFrontmatter as z };