@agentproto/agencies 0.1.0-alpha.0

package/dist/index.mjs

@@ -0,0 +1,17 @@
+import './chunk-SOJ4GQR7.mjs';
+export { checkAgenciesConsistency, validateAgency, validateAgreement, validateCapacity, validateCounterparty, validateDeliverable, validateEngagement, validateInvoice, validateOperations, validatePricingModel, validateProcedure, validateRoutine, validateService } from './chunk-GAJQ5ZC2.mjs';
+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 } from './chunk-DYQ4A5HV.mjs';
+
+/**
+ * @agentproto/agencies v0.1.0-alpha
+ * agentagencies/v1 — operating layer for entities that exercise agency.
+ * Vendor-neutral. Filesystem-first. Extends agentcompanies/v1 + agentgovernance/v1.
+ */
+
+// src/index.ts
+var SPEC_NAME = "agentagencies/v1";
+var SPEC_VERSION = "1.0.0-alpha";
+
+export { SPEC_NAME, SPEC_VERSION };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;AAwBO,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["/**\n * @agentproto/agencies — agentagencies/v1 spec implementation.\n *\n * Operating layer for entities that exercise *agency* — both in the business\n * sense (service businesses, consultancies, freelancers) and the philosophical\n * sense (any system that acts with intention, autonomy, decision-making).\n *\n * Extends agentcompanies/v1 (org structure) + agentgovernance/v1 (audit + signing)\n * with operations doctypes: AGENCY, OPERATIONS, SERVICE, PROCEDURE, PRICING-MODEL,\n * COUNTERPARTY, ENGAGEMENT, AGREEMENT, DELIVERABLE, INVOICE, ROUTINE, CAPACITY.\n *\n * Subpath exports:\n *   - \"./doctypes\"     — zod schemas + inferred types for all operations doctypes\n *   - \"./validators\"   — per-doctype + cross-doctype validators\n *   - \"./composition\"  — resolver for the 4 composition patterns\n *   - \"./renderers\"    — canvakit template ids + variable schemas + bundled HTML\n *\n * Reference runtime (workspace walkers like `computeAgencyOverview`,\n * snapshot index helpers, FS-only orchestrators) lives in the sibling package\n * `@agentproto/agencies-engine`. Spec stays pure: zero I/O, zero filesystem deps.\n *\n * Spec doc: ./AGENTAGENCIES.md (canonical, included in npm publish)\n */\n\nexport const SPEC_NAME = \"agentagencies/v1\" as const\nexport const SPEC_VERSION = \"1.0.0-alpha\" as const\n\nexport * from \"./spec/doctypes/index.js\"\nexport * from \"./spec/validators/index.js\"\n"]}

package/dist/renderers/index.d.ts

@@ -0,0 +1,288 @@
+import { z } from 'zod';
+
+/**
+ * Renderer wrapper for the `agency.engagement-dashboard` canvakit template.
+ *
+ * The template is a self-contained dashboard that re-reads workspace files on
+ * every refresh tick. The host application substitutes `{{engagementSlug}}`
+ * in the data-source paths before calling canvakit's resolver — variables
+ * here are template-time values, NOT runtime data (which comes from the
+ * declared data sources).
+ */
+
+declare const ENGAGEMENT_DASHBOARD_TEMPLATE_ID: "agency.engagement-dashboard";
+/** Path to the bundled .canvakit.html template (relative to the package root). */
+declare const ENGAGEMENT_DASHBOARD_TEMPLATE_PATH: "src/spec/canvakit-templates/agency.engagement-dashboard/template.canvakit.html";
+declare const engagementDashboardVariablesSchema: z.ZodObject<{
+    engagementSlug: z.ZodString;
+    agencyName: z.ZodString;
+    signUrlBase: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type EngagementDashboardVariables = z.infer<typeof engagementDashboardVariablesSchema>;
+declare function engagementDashboardVariables(input: EngagementDashboardVariables): Record<string, string>;
+
+/**
+ * Renderer wrapper for the `agency.agency-overview` canvakit template.
+ *
+ * The overview is a routine-populated rollup. The template's only data
+ * source is `_snapshots/agency-overview.json`, written by a procedure that
+ * walks the workspace and computes aggregates. The shape of that snapshot
+ * is documented here as `AgencyOverviewSnapshot` so writers + readers
+ * stay in sync.
+ *
+ * Why a snapshot rather than live globs:
+ *   - Counting + summing 50 engagements on every page-view is expensive.
+ *   - Per-engagement parsing of frontmatter is the bottleneck (no DB index).
+ *   - Snapshots invert the cost: compute once per cron tick, render cheap.
+ *
+ * Trade-off: the dashboard shows up-to-`refreshEvery` stale data. The
+ * snapshot's `generatedAt` field plus the staleness banner make that
+ * visible to the operator.
+ */
+
+declare const AGENCY_OVERVIEW_TEMPLATE_ID: "agency.agency-overview";
+declare const AGENCY_OVERVIEW_TEMPLATE_PATH: "src/spec/canvakit-templates/agency.agency-overview/template.canvakit.html";
+/** Snapshot shape — the procedure writes `_snapshots/agency-overview.json` matching this. */
+declare const agencyOverviewSnapshotSchema: z.ZodObject<{
+    generatedAt: z.ZodString;
+    isStale: z.ZodDefault<z.ZodBoolean>;
+    activeEngagementsCount: z.ZodNumber;
+    activeEngagementsDelta: z.ZodDefault<z.ZodNumber>;
+    pipelineValueFormatted: z.ZodString;
+    mrrFormatted: z.ZodString;
+    pendingSignaturesCount: z.ZodNumber;
+    byStatus: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        status: z.ZodString;
+        pillClass: z.ZodDefault<z.ZodEnum<{
+            "": "";
+            ok: "ok";
+            warn: "warn";
+            danger: "danger";
+            muted: "muted";
+        }>>;
+        count: z.ZodNumber;
+        valueFormatted: z.ZodString;
+    }, z.core.$strip>>>;
+    recentPayments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        invoiceNumber: z.ZodString;
+        counterpartyDisplayName: z.ZodString;
+        amountFormatted: z.ZodString;
+        paidAt: z.ZodString;
+    }, z.core.$strip>>>;
+    pendingByEngagement: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        requiredSigners: z.ZodString;
+        oldestPendingAt: z.ZodString;
+        stalenessLabel: z.ZodDefault<z.ZodString>;
+        stalenessPillClass: z.ZodDefault<z.ZodEnum<{
+            "": "";
+            ok: "ok";
+            warn: "warn";
+            danger: "danger";
+            muted: "muted";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type AgencyOverviewSnapshot = z.infer<typeof agencyOverviewSnapshotSchema>;
+/** Default freshness threshold (ms): how long a snapshot is considered "fresh". */
+declare const AGENCY_OVERVIEW_FRESHNESS_MS: number;
+/**
+ * Compute `isStale` from a snapshot's `generatedAt` timestamp. Pure helper —
+ * the writing procedure can call it before persisting, the reader can call
+ * it on load to refresh the flag.
+ */
+declare function isAgencyOverviewSnapshotStale(snapshot: {
+    generatedAt: string;
+}, thresholdMs?: number, now?: Date): boolean;
+declare const agencyOverviewVariablesSchema: z.ZodObject<{
+    agencyName: z.ZodString;
+    agencySlug: z.ZodString;
+    currency: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type AgencyOverviewVariables = z.infer<typeof agencyOverviewVariablesSchema>;
+declare function agencyOverviewVariables(input: AgencyOverviewVariables): Record<string, string>;
+
+/**
+ * Renderer wrapper for the `agency.invoice-pdf` canvakit template.
+ *
+ * Unlike the engagement dashboard, this template has no live data sources —
+ * the host application reads INVOICE.md (+ ENGAGEMENT.md / AGENCY.md /
+ * COUNTERPARTY.md) and passes a flattened variable bag in. The result is
+ * print-ready HTML; downstream PDF tooling (Chromium / wkhtmltopdf) renders
+ * it. The frozen PDF is archived alongside the .md and signed.
+ */
+
+declare const INVOICE_PDF_TEMPLATE_ID: "agency.invoice-pdf";
+declare const INVOICE_PDF_TEMPLATE_PATH: "src/spec/canvakit-templates/agency.invoice-pdf/template.canvakit.html";
+declare const invoicePdfVariablesSchema: z.ZodObject<{
+    agencyName: z.ZodString;
+    agencyAddressHtml: z.ZodOptional<z.ZodString>;
+    agencyTaxId: z.ZodOptional<z.ZodString>;
+    invoiceNumber: z.ZodString;
+    issuedAt: z.ZodString;
+    dueAt: z.ZodString;
+    status: z.ZodString;
+    counterpartyDisplayName: z.ZodString;
+    counterpartyAddressHtml: z.ZodOptional<z.ZodString>;
+    counterpartyTaxId: z.ZodOptional<z.ZodString>;
+    currency: z.ZodString;
+    subtotalFormatted: z.ZodString;
+    taxLines: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        amountFormatted: z.ZodString;
+    }, z.core.$strip>>>;
+    totalFormatted: z.ZodString;
+    amountDueFormatted: z.ZodString;
+    paymentTermsHtml: z.ZodOptional<z.ZodString>;
+    notesHtml: z.ZodOptional<z.ZodString>;
+    paymentLinkUrl: z.ZodOptional<z.ZodString>;
+    lineItems: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        quantity: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+        unitPriceFormatted: z.ZodString;
+        totalFormatted: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type InvoicePdfVariables = z.infer<typeof invoicePdfVariablesSchema>;
+declare function invoicePdfVariables(input: InvoicePdfVariables): Record<string, unknown>;
+
+/**
+ * Renderer wrapper for the `agency.agreement-signing` canvakit template.
+ *
+ * Multi-party signing portal for AGREEMENT.md. Differs from
+ * governance.signing-portal by rendering the agreement body, line items, and
+ * the multi-party signature status alongside the typed-name form.
+ */
+
+declare const AGREEMENT_SIGNING_TEMPLATE_ID: "agency.agreement-signing";
+declare const AGREEMENT_SIGNING_TEMPLATE_PATH: "src/spec/canvakit-templates/agency.agreement-signing/template.canvakit.html";
+declare const agreementSigningVariablesSchema: z.ZodObject<{
+    agencyName: z.ZodString;
+    agreementTitle: z.ZodString;
+    agreementPath: z.ZodString;
+    agreementBodyHtml: z.ZodOptional<z.ZodString>;
+    documentHash: z.ZodString;
+    signerKind: z.ZodEnum<{
+        operator: "operator";
+        user: "user";
+        counterparty: "counterparty";
+        agent: "agent";
+        external: "external";
+    }>;
+    signerSlug: z.ZodString;
+    signerName: z.ZodOptional<z.ZodString>;
+    signerEmail: z.ZodOptional<z.ZodEmail>;
+    nonce: z.ZodString;
+    signUrl: z.ZodString;
+    alreadySignedParties: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        signedAt: z.ZodOptional<z.ZodString>;
+        deadline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    pendingParties: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        signedAt: z.ZodOptional<z.ZodString>;
+        deadline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    lineItems: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        quantity: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+        totalFormatted: z.ZodString;
+    }, z.core.$strip>>>;
+    totalFormatted: z.ZodDefault<z.ZodString>;
+    currency: z.ZodDefault<z.ZodString>;
+    paymentTermsHtml: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type AgreementSigningVariables = z.infer<typeof agreementSigningVariablesSchema>;
+declare function agreementSigningVariables(input: AgreementSigningVariables): Record<string, unknown>;
+
+/**
+ * Renderer wrapper for the `agency.deliverable-review` canvakit template.
+ *
+ * Counterparty validation page — approve (typed-name signature) or request
+ * revisions. Approval signs DELIVERABLE.md; revision request appends a
+ * feedback comment + flips the engagement workflow back to `revise`.
+ */
+
+declare const DELIVERABLE_REVIEW_TEMPLATE_ID: "agency.deliverable-review";
+declare const DELIVERABLE_REVIEW_TEMPLATE_PATH: "src/spec/canvakit-templates/agency.deliverable-review/template.canvakit.html";
+declare const deliverableReviewVariablesSchema: z.ZodObject<{
+    agencyName: z.ZodString;
+    engagementName: z.ZodOptional<z.ZodString>;
+    deliverableTitle: z.ZodString;
+    deliverablePath: z.ZodString;
+    deliverableBodyHtml: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodString>;
+    documentHash: z.ZodString;
+    signerKind: z.ZodEnum<{
+        operator: "operator";
+        user: "user";
+        counterparty: "counterparty";
+        agent: "agent";
+        external: "external";
+    }>;
+    signerSlug: z.ZodString;
+    signerName: z.ZodOptional<z.ZodString>;
+    signerEmail: z.ZodOptional<z.ZodEmail>;
+    nonce: z.ZodString;
+    signUrl: z.ZodString;
+    reviseUrl: z.ZodString;
+    attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        sizeFormatted: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        url: z.ZodString;
+        icon: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type DeliverableReviewVariables = z.infer<typeof deliverableReviewVariablesSchema>;
+declare function deliverableReviewVariables(input: DeliverableReviewVariables): Record<string, unknown>;
+
+/**
+ * Renderer wrapper for the `agency.procedure-card` canvakit template.
+ *
+ * Narrative card view of a PROCEDURE.md — overview + step list. Doubles as
+ * an in-product help surface and a public preview on agencies.sh registry
+ * pages.
+ *
+ * The template reads the source PROCEDURE.md via `kind:file` data source.
+ * The host can pre-compute step state (`done` / `active` / `pending`) and
+ * pass the merged shape under `procedure.steps[].stateClass`.
+ */
+
+declare const PROCEDURE_CARD_TEMPLATE_ID: "agency.procedure-card";
+declare const PROCEDURE_CARD_TEMPLATE_PATH: "src/spec/canvakit-templates/agency.procedure-card/template.canvakit.html";
+declare const procedureCardVariablesSchema: z.ZodObject<{
+    agencyName: z.ZodOptional<z.ZodString>;
+    procedurePath: z.ZodString;
+    currentStepId: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type ProcedureCardVariables = z.infer<typeof procedureCardVariablesSchema>;
+declare function procedureCardVariables(input: ProcedureCardVariables): Record<string, string>;
+
+/**
+ * Renderer wrapper for the `agency.agency-profile` canvakit template.
+ *
+ * Public-facing profile rendering of AGENCY.md. Reads AGENCY.md plus the
+ * services/ and pricing-models/ directories, projects them into a marketing
+ * page suitable as `/agency/<slug>` landing or a registry preview.
+ *
+ * No live tools — pure file + glob. Cacheable via `refreshEvery` set to a
+ * long interval; defaults to none (host caches at CDN level).
+ */
+
+declare const AGENCY_PROFILE_TEMPLATE_ID: "agency.agency-profile";
+declare const AGENCY_PROFILE_TEMPLATE_PATH: "src/spec/canvakit-templates/agency.agency-profile/template.canvakit.html";
+declare const agencyProfileVariablesSchema: z.ZodObject<{
+    agencyName: z.ZodOptional<z.ZodString>;
+    agencyTagline: z.ZodOptional<z.ZodString>;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+    contactUrl: z.ZodDefault<z.ZodString>;
+    autonomyPosture: z.ZodOptional<z.ZodString>;
+    defaultCurrency: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type AgencyProfileVariables = z.infer<typeof agencyProfileVariablesSchema>;
+declare function agencyProfileVariables(input: AgencyProfileVariables): Record<string, string>;
+
+export { AGENCY_OVERVIEW_FRESHNESS_MS, AGENCY_OVERVIEW_TEMPLATE_ID, AGENCY_OVERVIEW_TEMPLATE_PATH, AGENCY_PROFILE_TEMPLATE_ID, AGENCY_PROFILE_TEMPLATE_PATH, AGREEMENT_SIGNING_TEMPLATE_ID as AGREEMENT_PDF_TEMPLATE_ID, AGREEMENT_SIGNING_TEMPLATE_ID, AGREEMENT_SIGNING_TEMPLATE_PATH, type AgencyOverviewSnapshot, type AgencyOverviewVariables, type AgencyProfileVariables, type AgreementSigningVariables, DELIVERABLE_REVIEW_TEMPLATE_ID, DELIVERABLE_REVIEW_TEMPLATE_PATH, type DeliverableReviewVariables, ENGAGEMENT_DASHBOARD_TEMPLATE_ID, ENGAGEMENT_DASHBOARD_TEMPLATE_PATH, type EngagementDashboardVariables, INVOICE_PDF_TEMPLATE_ID, INVOICE_PDF_TEMPLATE_PATH, type InvoicePdfVariables, PROCEDURE_CARD_TEMPLATE_ID, PROCEDURE_CARD_TEMPLATE_PATH, type ProcedureCardVariables, agencyOverviewSnapshotSchema, agencyOverviewVariables, agencyOverviewVariablesSchema, agencyProfileVariables, agencyProfileVariablesSchema, agreementSigningVariables, agreementSigningVariablesSchema, deliverableReviewVariables, deliverableReviewVariablesSchema, engagementDashboardVariables, engagementDashboardVariablesSchema, invoicePdfVariables, invoicePdfVariablesSchema, isAgencyOverviewSnapshotStale, procedureCardVariables, procedureCardVariablesSchema };

package/dist/renderers/index.mjs

@@ -0,0 +1,321 @@
+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 ENGAGEMENT_DASHBOARD_TEMPLATE_ID = "agency.engagement-dashboard";
+var ENGAGEMENT_DASHBOARD_TEMPLATE_PATH = "src/spec/canvakit-templates/agency.engagement-dashboard/template.canvakit.html";
+var engagementDashboardVariablesSchema = z.object({
+  /** Slug of the engagement folder under `engagements/` (e.g. `2026-acme-website-redesign`). */
+  engagementSlug: z.string().regex(
+    /^[a-z0-9][a-z0-9-]*$/,
+    "Expected lowercase slug (alphanumeric + hyphens)"
+  ),
+  /** Display name of the agency (header). */
+  agencyName: z.string().min(1),
+  /**
+   * Base URL used when the dashboard renders signing links for pending
+   * artifacts. The full link is `${signUrlBase}?artifactPath=...&nonce=...`.
+   */
+  signUrlBase: z.string().min(1).default("/sign")
+});
+function engagementDashboardVariables(input) {
+  return {
+    engagementSlug: input.engagementSlug,
+    agencyName: input.agencyName,
+    signUrlBase: input.signUrlBase ?? "/sign"
+  };
+}
+var AGENCY_OVERVIEW_TEMPLATE_ID = "agency.agency-overview";
+var AGENCY_OVERVIEW_TEMPLATE_PATH = "src/spec/canvakit-templates/agency.agency-overview/template.canvakit.html";
+var agencyOverviewSnapshotSchema = z.object({
+  /** ISO 8601 timestamp of when the snapshot was computed. */
+  generatedAt: z.string().min(1),
+  /** Set true when `Date.now() - generatedAt` exceeds the freshness threshold (default 30 min). */
+  isStale: z.boolean().default(false),
+  activeEngagementsCount: z.number().int().nonnegative(),
+  activeEngagementsDelta: z.number().int().default(0),
+  pipelineValueFormatted: z.string(),
+  mrrFormatted: z.string(),
+  pendingSignaturesCount: z.number().int().nonnegative(),
+  byStatus: z.array(
+    z.object({
+      status: z.string(),
+      pillClass: z.enum(["", "ok", "warn", "danger", "muted"]).default(""),
+      count: z.number().int().nonnegative(),
+      valueFormatted: z.string()
+    })
+  ).default([]),
+  recentPayments: z.array(
+    z.object({
+      invoiceNumber: z.string(),
+      counterpartyDisplayName: z.string(),
+      amountFormatted: z.string(),
+      paidAt: z.string()
+    })
+  ).default([]),
+  pendingByEngagement: z.array(
+    z.object({
+      slug: z.string(),
+      name: z.string(),
+      requiredSigners: z.string(),
+      oldestPendingAt: z.string(),
+      stalenessLabel: z.string().default(""),
+      stalenessPillClass: z.enum(["", "ok", "warn", "danger", "muted"]).default("")
+    })
+  ).default([])
+});
+var AGENCY_OVERVIEW_FRESHNESS_MS = 30 * 60 * 1e3;
+function isAgencyOverviewSnapshotStale(snapshot, thresholdMs = AGENCY_OVERVIEW_FRESHNESS_MS, now = /* @__PURE__ */ new Date()) {
+  const generated = Date.parse(snapshot.generatedAt);
+  if (Number.isNaN(generated)) return true;
+  return now.getTime() - generated > thresholdMs;
+}
+var agencyOverviewVariablesSchema = z.object({
+  agencyName: z.string().min(1),
+  /** Used to construct per-engagement deep-links in the dashboard. */
+  agencySlug: z.string().regex(
+    /^[a-z0-9][a-z0-9-]*$/,
+    "Expected lowercase slug (alphanumeric + hyphens)"
+  ),
+  /** ISO 4217 currency for the headline stats. */
+  currency: z.string().regex(/^[A-Z]{3}$/).default("EUR")
+});
+function agencyOverviewVariables(input) {
+  return {
+    agencyName: input.agencyName,
+    agencySlug: input.agencySlug,
+    currency: input.currency ?? "EUR"
+  };
+}
+var INVOICE_PDF_TEMPLATE_ID = "agency.invoice-pdf";
+var INVOICE_PDF_TEMPLATE_PATH = "src/spec/canvakit-templates/agency.invoice-pdf/template.canvakit.html";
+var moneyFormattedSchema = z.string().regex(/^-?\d+(\.\d{1,4})?$/, {
+  message: "Expected a numeric string (e.g. '1234.56'). Format the locale separately."
+});
+var lineItemSchema = z.object({
+  description: z.string().min(1),
+  quantity: z.union([z.number(), z.string()]),
+  unitPriceFormatted: moneyFormattedSchema,
+  totalFormatted: moneyFormattedSchema
+});
+var taxLineSchema = z.object({
+  label: z.string().min(1),
+  amountFormatted: moneyFormattedSchema
+});
+var invoicePdfVariablesSchema = z.object({
+  agencyName: z.string().min(1),
+  /** Allowed-HTML block (sender address). The renderer trusts this — sanitize upstream. */
+  agencyAddressHtml: z.string().optional(),
+  agencyTaxId: z.string().optional(),
+  invoiceNumber: z.string().min(1),
+  /** ISO date (YYYY-MM-DD). */
+  issuedAt: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  dueAt: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  /** "issued" | "paid" | "overdue" | "void" — pill-rendered. */
+  status: z.string().min(1),
+  counterpartyDisplayName: z.string().min(1),
+  counterpartyAddressHtml: z.string().optional(),
+  counterpartyTaxId: z.string().optional(),
+  /** ISO 4217 (e.g. "EUR", "USD"). */
+  currency: z.string().regex(/^[A-Z]{3}$/),
+  subtotalFormatted: moneyFormattedSchema,
+  taxLines: z.array(taxLineSchema).default([]),
+  totalFormatted: moneyFormattedSchema,
+  amountDueFormatted: moneyFormattedSchema,
+  paymentTermsHtml: z.string().optional(),
+  notesHtml: z.string().optional(),
+  paymentLinkUrl: z.string().optional(),
+  lineItems: z.array(lineItemSchema).min(1)
+});
+function invoicePdfVariables(input) {
+  return {
+    agencyName: input.agencyName,
+    agencyAddressHtml: input.agencyAddressHtml ?? "",
+    agencyTaxId: input.agencyTaxId ?? "",
+    invoiceNumber: input.invoiceNumber,
+    issuedAt: input.issuedAt,
+    dueAt: input.dueAt,
+    status: input.status,
+    counterpartyDisplayName: input.counterpartyDisplayName,
+    counterpartyAddressHtml: input.counterpartyAddressHtml ?? "",
+    counterpartyTaxId: input.counterpartyTaxId ?? "",
+    currency: input.currency,
+    subtotalFormatted: input.subtotalFormatted,
+    taxLines: input.taxLines,
+    totalFormatted: input.totalFormatted,
+    amountDueFormatted: input.amountDueFormatted,
+    paymentTermsHtml: input.paymentTermsHtml ?? "",
+    notesHtml: input.notesHtml ?? "",
+    paymentLinkUrl: input.paymentLinkUrl ?? "",
+    lineItems: input.lineItems
+  };
+}
+var AGREEMENT_SIGNING_TEMPLATE_ID = "agency.agreement-signing";
+var AGREEMENT_SIGNING_TEMPLATE_PATH = "src/spec/canvakit-templates/agency.agreement-signing/template.canvakit.html";
+var moneyFormattedSchema2 = z.string().regex(/^-?\d+(\.\d{1,4})?$/, "Expected a numeric string (e.g. '1234.56')");
+var lineItemSchema2 = z.object({
+  description: z.string().min(1),
+  quantity: z.union([z.number(), z.string()]),
+  totalFormatted: moneyFormattedSchema2
+});
+var partySchema = z.object({
+  /** Display label like "Acme Corp (counterparty)". */
+  label: z.string().min(1),
+  /** ISO timestamp (already-signed) or ISO deadline (pending). */
+  signedAt: z.string().optional(),
+  deadline: z.string().optional()
+});
+var agreementSigningVariablesSchema = z.object({
+  agencyName: z.string().min(1),
+  agreementTitle: z.string().min(1),
+  agreementPath: z.string().min(1),
+  /** Pre-rendered HTML of the agreement body (markdown → HTML upstream). */
+  agreementBodyHtml: z.string().optional(),
+  documentHash: z.string().regex(/^[a-f0-9]{64}$/),
+  signerKind: z.enum(["operator", "user", "counterparty", "agent", "external"]),
+  signerSlug: z.string().min(1),
+  signerName: z.string().optional(),
+  signerEmail: z.email().optional(),
+  nonce: z.string().min(1),
+  signUrl: z.string().min(1),
+  /** Parties who have already signed (rendered in the "Already signed" panel). */
+  alreadySignedParties: z.array(partySchema).default([]),
+  /** Parties still pending (rendered in the "Pending signatures" panel). */
+  pendingParties: z.array(partySchema).default([]),
+  lineItems: z.array(lineItemSchema2).default([]),
+  totalFormatted: moneyFormattedSchema2.default("0.00"),
+  currency: z.string().regex(/^[A-Z]{3}$/).default("EUR"),
+  paymentTermsHtml: z.string().optional()
+});
+function agreementSigningVariables(input) {
+  return {
+    agencyName: input.agencyName,
+    agreementTitle: input.agreementTitle,
+    agreementPath: input.agreementPath,
+    agreementBodyHtml: input.agreementBodyHtml ?? "",
+    documentHash: input.documentHash,
+    signerKind: input.signerKind,
+    signerSlug: input.signerSlug,
+    signerName: input.signerName ?? "",
+    signerEmail: input.signerEmail ?? "",
+    nonce: input.nonce,
+    signUrl: input.signUrl,
+    alreadySignedParties: input.alreadySignedParties,
+    pendingParties: input.pendingParties,
+    lineItems: input.lineItems,
+    totalFormatted: input.totalFormatted,
+    currency: input.currency,
+    paymentTermsHtml: input.paymentTermsHtml ?? ""
+  };
+}
+var DELIVERABLE_REVIEW_TEMPLATE_ID = "agency.deliverable-review";
+var DELIVERABLE_REVIEW_TEMPLATE_PATH = "src/spec/canvakit-templates/agency.deliverable-review/template.canvakit.html";
+var attachmentSchema = z.object({
+  name: z.string().min(1),
+  /** Human-friendly size like "1.2 MB" — formatted upstream. */
+  sizeFormatted: z.string(),
+  /** Free-form kind label rendered next to the size ("PDF", "Figma frame", …). */
+  kind: z.string().optional(),
+  /** URL to view/download the attachment. */
+  url: z.string().min(1),
+  /** Single-glyph icon (emoji or unicode). The template renders verbatim. */
+  icon: z.string().default("\u{1F4CE}")
+});
+var deliverableReviewVariablesSchema = z.object({
+  agencyName: z.string().min(1),
+  /** Optional engagement display name (rendered in the lead). */
+  engagementName: z.string().optional(),
+  deliverableTitle: z.string().min(1),
+  deliverablePath: z.string().min(1),
+  /** Markdown body rendered to HTML upstream (description + acceptance criteria). */
+  deliverableBodyHtml: z.string().optional(),
+  /** Free-form context shown above the body (e.g., "Phase 1 of 3"). */
+  context: z.string().optional(),
+  documentHash: z.string().regex(/^[a-f0-9]{64}$/),
+  signerKind: z.enum(["operator", "user", "counterparty", "agent", "external"]),
+  signerSlug: z.string().min(1),
+  signerName: z.string().optional(),
+  signerEmail: z.email().optional(),
+  nonce: z.string().min(1),
+  signUrl: z.string().min(1),
+  reviseUrl: z.string().min(1),
+  attachments: z.array(attachmentSchema).default([])
+});
+function deliverableReviewVariables(input) {
+  return {
+    agencyName: input.agencyName,
+    engagementName: input.engagementName ?? "",
+    deliverableTitle: input.deliverableTitle,
+    deliverablePath: input.deliverablePath,
+    deliverableBodyHtml: input.deliverableBodyHtml ?? "",
+    context: input.context ?? "",
+    documentHash: input.documentHash,
+    signerKind: input.signerKind,
+    signerSlug: input.signerSlug,
+    signerName: input.signerName ?? "",
+    signerEmail: input.signerEmail ?? "",
+    nonce: input.nonce,
+    signUrl: input.signUrl,
+    reviseUrl: input.reviseUrl,
+    attachments: input.attachments
+  };
+}
+var PROCEDURE_CARD_TEMPLATE_ID = "agency.procedure-card";
+var PROCEDURE_CARD_TEMPLATE_PATH = "src/spec/canvakit-templates/agency.procedure-card/template.canvakit.html";
+var procedureCardVariablesSchema = z.object({
+  /** Optional agency name shown in the lead label. */
+  agencyName: z.string().optional(),
+  /** Workspace-relative path to the PROCEDURE.md being rendered. */
+  procedurePath: z.string().min(1),
+  /**
+   * If rendered inside an active engagement, the slug of the step currently
+   * executing. The host fills `step.stateClass = active|done|pending` based
+   * on this when projecting the procedure data source. Pass `""` for the
+   * static documentation view.
+   */
+  currentStepId: z.string().default("")
+});
+function procedureCardVariables(input) {
+  return {
+    agencyName: input.agencyName ?? "",
+    procedurePath: input.procedurePath,
+    currentStepId: input.currentStepId ?? ""
+  };
+}
+var AGENCY_PROFILE_TEMPLATE_ID = "agency.agency-profile";
+var AGENCY_PROFILE_TEMPLATE_PATH = "src/spec/canvakit-templates/agency.agency-profile/template.canvakit.html";
+var agencyProfileVariablesSchema = z.object({
+  /**
+   * The primary header. Defaults to `agency.name` resolved from AGENCY.md
+   * when omitted (template falls back to the data source).
+   */
+  agencyName: z.string().optional(),
+  /** Optional one-line tagline shown under the H1. */
+  agencyTagline: z.string().optional(),
+  /** Optional public website URL shown in the footer. */
+  websiteUrl: z.string().optional(),
+  /** Where the "Start an engagement" CTA points. */
+  contactUrl: z.string().default("/contact"),
+  /** Override AGENCY.md.autonomyPosture in the "How we work" panel (rare). */
+  autonomyPosture: z.string().optional(),
+  /** Override AGENCY.md.defaultCurrency. */
+  defaultCurrency: z.string().regex(/^[A-Z]{3}$/).default("EUR")
+});
+function agencyProfileVariables(input) {
+  return {
+    agencyName: input.agencyName ?? "",
+    agencyTagline: input.agencyTagline ?? "",
+    websiteUrl: input.websiteUrl ?? "",
+    contactUrl: input.contactUrl,
+    autonomyPosture: input.autonomyPosture ?? "",
+    defaultCurrency: input.defaultCurrency
+  };
+}
+
+export { AGENCY_OVERVIEW_FRESHNESS_MS, AGENCY_OVERVIEW_TEMPLATE_ID, AGENCY_OVERVIEW_TEMPLATE_PATH, AGENCY_PROFILE_TEMPLATE_ID, AGENCY_PROFILE_TEMPLATE_PATH, AGREEMENT_SIGNING_TEMPLATE_ID as AGREEMENT_PDF_TEMPLATE_ID, AGREEMENT_SIGNING_TEMPLATE_ID, AGREEMENT_SIGNING_TEMPLATE_PATH, DELIVERABLE_REVIEW_TEMPLATE_ID, DELIVERABLE_REVIEW_TEMPLATE_PATH, ENGAGEMENT_DASHBOARD_TEMPLATE_ID, ENGAGEMENT_DASHBOARD_TEMPLATE_PATH, INVOICE_PDF_TEMPLATE_ID, INVOICE_PDF_TEMPLATE_PATH, PROCEDURE_CARD_TEMPLATE_ID, PROCEDURE_CARD_TEMPLATE_PATH, agencyOverviewSnapshotSchema, agencyOverviewVariables, agencyOverviewVariablesSchema, agencyProfileVariables, agencyProfileVariablesSchema, agreementSigningVariables, agreementSigningVariablesSchema, deliverableReviewVariables, deliverableReviewVariablesSchema, engagementDashboardVariables, engagementDashboardVariablesSchema, invoicePdfVariables, invoicePdfVariablesSchema, isAgencyOverviewSnapshotStale, procedureCardVariables, procedureCardVariablesSchema };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map