@agentproto/agency-v2 0.1.0-alpha.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,23 @@
+# @agentproto/agency-v2
+
+AIP-21 `AGENCY.md` reference implementation. A workspace-only successor to AIP-8 that drops the eleven hardcoded agency doctypes (service, engagement, agreement, deliverable, invoice, counterparty, procedure, pricing-model, routine, capacity, agency) and delegates all per-doctype schema work to AIP-18 collections — owning only the workspace root manifest, the engagement lifecycle helpers that span collections, scope axes, and cross-AIP composition with strong governance and work bindings.
+
+> **Status: 0.1.0-alpha.** Generated by `scripts/scaffold-aip.mjs` — `build()` and `validate()` bodies are TODOs.
+
+Spec: <https://agentproto.sh/docs/aip-21>
+
+## Usage
+
+```ts
+import { defineAgencyV2 } from "@agentproto/agency-v2"
+
+const x = defineAgencyV2({
+  id: "my-agency-v2",
+  description: "Short purpose.",
+  // ...
+})
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/chunk-2EJ3V4IK.mjs

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/agency-v2 v0.1.0-alpha
+ * AIP-21 AGENCY.md `defineAgencyV2` reference implementation.
+ */
+
+var agencyV2FrontmatterSchema = z.object({ "schema": z.literal("agency.workspace/v2").describe("Discriminator for the AIP-21 workspace doctype."), "name": z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$")).min(2).max(96).describe("Stable kebab-case identifier for the agency or view."), "title": z.string().min(1).max(200).describe("Human-readable agency title."), "description": z.string().min(1).max(2e3).describe("One-paragraph statement of purpose: what this agency does and who it serves."), "version": z.string().regex(new RegExp("^[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?$")).describe("Semantic version of the WORKSPACE shape. Bump on collection / scope / lifecycle / lint / defaults changes. Independent of the agency's content version."), "extends": z.string().regex(new RegExp("^(\\.\\./|\\./)[^\\s]+/AGENCY\\.md$")).min(1).max(512).describe("OPTIONAL \u2014 relative path to a parent AGENCY.md. Presence makes the manifest a VIEW; absence makes it a WORKSPACE ROOT. Recursive composition; maximum chain depth is 8.").optional(), "appliesTo": z.array(z.string().regex(new RegExp("^(ws://(operators|companies|skills)/[a-z][a-z0-9-]*|\\.\\./[^\\s]+)$")).describe("Either a ws:// ref to an AIP-9 operator / AIP-6 company / AIP-3 skill, or a relative path to a consumer workspace folder.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("OPTIONAL \u2014 list of consumers this VIEW adapts the agency for. Hosts MUST refuse the view if any binding does not resolve. Not inherited; views declare their own scope.").optional(), "identity": z.object({ "legalEntity": z.string().regex(new RegExp("^ws://companies/[a-z][a-z0-9-]*$")).describe("OPTIONAL \u2014 AIP-6 ref to the company that legally signs agreements and issues invoices. When set, hosts SHOULD resolve this ref to populate legalName and taxId from the AIP-6 record.").optional(), "legalName": z.string().min(1).max(200).describe("OPTIONAL \u2014 display string for the legal entity name. Used when legalEntity is absent or to override the AIP-6 record's legalName.").optional(), "taxId": z.string().min(1).max(64).describe("OPTIONAL \u2014 tax identifier (VAT, EIN, GST, etc.). Hosts MUST treat this string as opaque; format validation belongs to per-jurisdiction tooling.").optional(), "jurisdiction": z.string().regex(new RegExp("^[A-Z]{2}$")).describe("OPTIONAL \u2014 primary jurisdiction the agency operates under, as ISO 3166-1 alpha-2 (e.g. FR, US, GB, DE).").optional(), "defaultCurrency": z.string().regex(new RegExp("^[A-Z]{3}$")).describe("OPTIONAL \u2014 default currency for new invoices, as ISO 4217 (e.g. EUR, USD, GBP). Per-engagement overrides take precedence.").optional() }).strict().describe("Commercial-flavored identity block. All fields optional; agencies operating as a sole operator with no counterparty billing may omit the block entirely.").optional(), "executor": z.string().regex(new RegExp("^ws://operators/[a-z][a-z0-9-]*$")).describe("OPTIONAL \u2014 AIP-9 default executor operator. The host activates this operator when an item with no explicit assignee surfaces.").optional(), "governance": z.string().min(1).max(512).describe("OPTIONAL \u2014 AIP-7 policy or audit binding. May be a path to an AIP-7 policy file or a ws:// ref. Status-transition approvals, signature gates on agreements, and audit log routing flow through this ref. Agreements MUST be signed; the default policy lives here.").optional(), "knowledge": z.string().regex(new RegExp("^ws://wikis/[a-z][a-z0-9-]*(/KNOWLEDGE\\.md)?$")).describe("OPTIONAL \u2014 AIP-10 KNOWLEDGE.md ref. Wiki this agency refers to (case studies, prior-art, methodology).").optional(), "work": z.string().regex(new RegExp("^ws://workspaces/[a-z][a-z0-9-]*(/WORK\\.md)?$")).describe("OPTIONAL \u2014 AIP-20 work workspace binding. Items in `deliverable` MAY be tracked as work items in the bound workspace.").optional(), "playbook": z.string().regex(new RegExp("^ws://playbooks/[a-z][a-z0-9-]*$")).describe("OPTIONAL \u2014 AIP-12 active playbook. Governs the routine plays this agency runs.").optional(), "companies": z.string().regex(new RegExp("^ws://companies(/[a-z][a-z0-9-]*)?$")).describe("OPTIONAL \u2014 AIP-6 companies root. Resolution root for `counterparty` items: a counterparty's companyRef resolves under this binding.").optional(), "collections": z.array(z.any()).describe("Collections enabled by this agency. Three forms supported: inline (full COLLECTION.md frontmatter), file ref, or registry import. Merge-by-effective-name (alias if set, otherwise the collection's name) across the extends chain.").default([]), "lifecycle": z.object({ "enabled": z.boolean().describe("Whether cross-collection lifecycle propagation is active. When false, no lifecycle rules fire \u2014 items keep their stored statuses regardless of related items.").default(false), "rules": z.array(z.object({ "id": z.string().regex(new RegExp("^[a-z][a-z0-9-]*$")).describe("Stable kebab-case rule id. Merge key when composing across extends."), "when": z.string().regex(new RegExp("^(all-items-in-collection-terminal|any-linked-item-status|linked-item-terminal|no-linked-items|custom:[a-z][a-z0-9-]*)$")).describe("Predicate id from the recognised vocabulary. Custom predicates are host-defined keyed by `id`."), "forCollection": z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$")).describe("Effective name of the collection whose items receive the bubbled status. MUST appear in the workspace's merged collections array."), "bubbleStatus": z.string().regex(new RegExp("^[a-z][a-z0-9-]*$")).describe("Status id to set on the target item when the predicate holds. MUST exist on the forCollection's state machine."), "params": z.record(z.string(), z.any()).describe("Predicate parameters. Common keys: sourceCollection (collection whose items the predicate inspects), linkField (field on source items pointing at the target), terminalStatuses (subset of terminal statuses to count), statusEquals (specific status to match).").default({}) }).strict()).describe("Cross-collection lifecycle rules. Merge-by-id vs parent. Hosts MUST detect graph cycles in the (forCollection, sourceCollection) edge set and refuse with agency_lifecycle_cycle (HARD).").default([]) }).strict().describe("Engagement lifecycle helpers \u2014 workspace-level rules for cross-collection state propagation. The AIP-21 distinctive contribution.").optional(), "scope": z.object({ "containment": z.object({ "enabled": z.boolean().describe("Whether the containment axis is active. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false (would orphan items). Refusal: agency_scope_disable (HARD).").default(true), "field": z.string().regex(new RegExp("^[a-z][a-zA-Z0-9_]*$")).describe("Item field name carrying the containment ref.").default("parent"), "rules": z.object({ "allowedKinds": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("OPTIONAL \u2014 collection names allowed as containment parents.").optional(), "maxDepth": z.number().int().gte(1).lte(32).describe("OPTIONAL \u2014 maximum containment depth.").optional() }).strict().describe("OPTIONAL containment constraints.").optional() }).strict().describe("Containment axis (parent/child).").optional(), "applicability": z.object({ "enabled": z.boolean().describe("Whether the applicability axis is active.").default(false), "field": z.string().regex(new RegExp("^[a-z][a-zA-Z0-9_]*$")).describe("Item field name carrying the applicability ref list.").default("appliesTo"), "valueClass": z.string().regex(new RegExp("^[a-z][a-z0-9-]*$")).describe("Class of refs the field accepts. Recognised classes: client, market, service, company, role, role-and-company, operator. ONE-WAY SWITCH: once set at any ancestor, descendants MUST NOT change. Refusal: agency_scope_value_class_drift (HARD).").optional() }).strict().describe("Applicability axis (who the item is about / scoped to).").optional(), "ownership": z.object({ "enabled": z.boolean().describe("Whether the ownership axis is active.").default(true), "field": z.string().regex(new RegExp("^[a-z][a-zA-Z0-9_]*$")).describe("Workspace-level default item field name carrying the ownership ref.").default("owner"), "policy": z.enum(["strict", "inherit", "open"]).describe("Workspace-level ownership policy. 'strict' requires every collection's ownership.required to be true; 'inherit' delegates; 'open' permits any collection to omit ownership.").default("inherit") }).strict().describe("Ownership axis (who is doing the item).").optional() }).strict().describe("Workspace-level scope axes \u2014 three orthogonal axes (containment / applicability / ownership) declared once per agency.").optional(), "lints": z.array(z.object({ "id": z.string().regex(new RegExp("^[a-z][a-z0-9-]*$")).describe("Stable kebab-case lint id. Merge key when composing with extends parent."), "kind": z.enum(["stale-engagement", "unsigned-agreement", "overdue-invoice", "broken-procedure-ref", "orphan-across-collections", "stale-tree", "broken-parent-ref", "scope-mismatch", "custom"]).describe("Workspace-spanning lint algorithm. AIP-18 per-collection lints (missing-owner, overdue, required-field, etc.) live on COLLECTION.md and are NOT redeclared here. 'custom' delegates to a host-defined check identified by `id`."), "severity": z.enum(["error", "warn", "info"]).describe("Lint severity. Children may soften; governance policies MAY forbid softening below `error`."), "params": z.record(z.string(), z.any()).describe("Kind-specific parameters.").default({}) }).strict()).describe("Workspace-spanning lints. Merge-by-id vs parent.").default([]), "defaults": z.object({ "workflow": z.string().min(1).max(512).describe("OPTIONAL \u2014 default AIP-15 WORKFLOW.md path or ref.").optional(), "approvalClass": z.string().regex(new RegExp("^(auto|always|on-mutate|policy:[A-Za-z0-9_./:-]+)$")).describe("Approval class for mutations. 'auto' = no gate; 'always' = every mutation requires approval; 'on-mutate' = approval on field-level mutations; 'policy:<ref>' = delegate to an AIP-7 policy.").optional(), "auditMutations": z.boolean().describe("Whether mutations are audited. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false. Refusal: agency_audit_downgrade (HARD).").default(false) }).strict().describe("Routine workflow defaults. Composes with AIP-15.").optional(), "engagement": z.object({ "terms": z.object({ "contractRequired": z.boolean().describe("Whether engagement items require a corresponding agreement item. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false (commercial protection against engagements without paperwork). Refusal: agency_contract_required_downgrade (HARD).").default(false), "defaultPaymentTerms": z.string().regex(new RegExp("^(net-[0-9]+|due-on-receipt|prepaid|[a-z][a-z0-9-]*)$")).describe("OPTIONAL \u2014 default payment terms for new invoices. Common values: net-15, net-30, net-60, due-on-receipt, prepaid. Custom kebab-case strings permitted.").optional(), "defaultCurrency": z.string().regex(new RegExp("^[A-Z]{3}$")).describe("OPTIONAL \u2014 default currency for engagement-derived invoices, as ISO 4217. Falls back to identity.defaultCurrency if unset.").optional() }).strict().describe("Default commercial terms applied to new engagement and invoice items.").optional() }).strict().describe("Engagement-specific terms (AIP-21 distinctive).").optional(), "display": z.object({ "homePage": z.string().regex(new RegExp("^[A-Za-z0-9][A-Za-z0-9_:-]*$")).describe("OPTIONAL \u2014 id of the item to use as the agency landing page.").optional(), "defaultGrouping": z.enum(["kind", "status", "counterparty", "engagement"]).describe("Default grouping for list views.").optional(), "defaultView": z.enum(["list", "board", "timeline", "dashboard"]).describe("Default rendering mode.").optional() }).strict().describe("Display hints for UIs that render the agency. Runtime-agnostic.").optional(), "metadata": z.record(z.string(), z.any()).describe("Vendor-specific extensions, namespaced under <vendor>. Deep-merged across the extends chain. MUST NOT change the meaning of any spec field.").default({}) }).strict().and(z.any().describe("A view (any manifest with appliesTo set) MUST extend a parent. A workspace-root manifest has neither field.")).describe("Validates the YAML frontmatter portion of an AIP-21 AGENCY.md (workspace root or per-context view). The single doctype 'agency.workspace/v2' is used in both modes; the host distinguishes by checking whether `extends` is set. Per-doctype schemas (service, engagement, agreement, deliverable, invoice, counterparty, procedure, pricing-model, routine, capacity) are delegated to AIP-18 (COLLECTION.md / ITEM.md).");
+var defineAgencyV2 = createDoctype({
+  aip: 21,
+  name: "agency-v2",
+  readIdentity: (def) => def.name,
+  validate(def) {
+    const d = def;
+    if (Array.isArray(d.appliesTo) && d.appliesTo.length > 0 && d.extends == null) {
+      throw new Error(
+        `defineAgencyV2 (AIP-21): appliesTo is non-empty \u2014 extends MUST be set`
+      );
+    }
+    const result = agencyV2FrontmatterSchema.safeParse(def);
+    if (!result.success) {
+      throw new Error(
+        `defineAgencyV2 (AIP-21): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+      );
+    }
+  },
+  build(def) {
+    return { ...def };
+  }
+});
+
+export { agencyV2FrontmatterSchema, defineAgencyV2 };
+//# sourceMappingURL=chunk-2EJ3V4IK.mjs.map
+//# sourceMappingURL=chunk-2EJ3V4IK.mjs.map

package/dist/chunk-2EJ3V4IK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/define-agency-v2.ts"],"names":[],"mappings":"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","file":"chunk-2EJ3V4IK.mjs","sourcesContent":["/**\n * AIP-21 AGENCY.md frontmatter zod schema.\n *\n * Generated from `resources/aip-21/draft/AGENCY.schema.json` via\n * json-schema-to-zod. Imported by both `define-agency-v2.ts` (TS path\n * validation) and `manifest/index.ts` (.md path validation) so every\n * field-level constraint runs in both authoring paths from a single\n * source of truth — re-run scaffold-aip to refresh after spec changes.\n *\n * Cross-field rules (if/then/allOf in JSON Schema) don't translate\n * cleanly and live in `define-agency-v2.ts`'s `validate(def)` instead.\n */\n\nimport { z } from \"zod\"\n\nexport const agencyV2FrontmatterSchema = z.object({ \"schema\": z.literal(\"agency.workspace/v2\").describe(\"Discriminator for the AIP-21 workspace doctype.\"), \"name\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\")).min(2).max(96).describe(\"Stable kebab-case identifier for the agency or view.\"), \"title\": z.string().min(1).max(200).describe(\"Human-readable agency title.\"), \"description\": z.string().min(1).max(2000).describe(\"One-paragraph statement of purpose: what this agency does and who it serves.\"), \"version\": z.string().regex(new RegExp(\"^[0-9]+\\\\.[0-9]+\\\\.[0-9]+(-[A-Za-z0-9.-]+)?$\")).describe(\"Semantic version of the WORKSPACE shape. Bump on collection / scope / lifecycle / lint / defaults changes. Independent of the agency's content version.\"), \"extends\": z.string().regex(new RegExp(\"^(\\\\.\\\\./|\\\\./)[^\\\\s]+/AGENCY\\\\.md$\")).min(1).max(512).describe(\"OPTIONAL — relative path to a parent AGENCY.md. Presence makes the manifest a VIEW; absence makes it a WORKSPACE ROOT. Recursive composition; maximum chain depth is 8.\").optional(), \"appliesTo\": z.array(z.string().regex(new RegExp(\"^(ws://(operators|companies|skills)/[a-z][a-z0-9-]*|\\\\.\\\\./[^\\\\s]+)$\")).describe(\"Either a ws:// ref to an AIP-9 operator / AIP-6 company / AIP-3 skill, or a relative path to a consumer workspace folder.\")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"OPTIONAL — list of consumers this VIEW adapts the agency for. Hosts MUST refuse the view if any binding does not resolve. Not inherited; views declare their own scope.\").optional(), \"identity\": z.object({ \"legalEntity\": z.string().regex(new RegExp(\"^ws://companies/[a-z][a-z0-9-]*$\")).describe(\"OPTIONAL — AIP-6 ref to the company that legally signs agreements and issues invoices. When set, hosts SHOULD resolve this ref to populate legalName and taxId from the AIP-6 record.\").optional(), \"legalName\": z.string().min(1).max(200).describe(\"OPTIONAL — display string for the legal entity name. Used when legalEntity is absent or to override the AIP-6 record's legalName.\").optional(), \"taxId\": z.string().min(1).max(64).describe(\"OPTIONAL — tax identifier (VAT, EIN, GST, etc.). Hosts MUST treat this string as opaque; format validation belongs to per-jurisdiction tooling.\").optional(), \"jurisdiction\": z.string().regex(new RegExp(\"^[A-Z]{2}$\")).describe(\"OPTIONAL — primary jurisdiction the agency operates under, as ISO 3166-1 alpha-2 (e.g. FR, US, GB, DE).\").optional(), \"defaultCurrency\": z.string().regex(new RegExp(\"^[A-Z]{3}$\")).describe(\"OPTIONAL — default currency for new invoices, as ISO 4217 (e.g. EUR, USD, GBP). Per-engagement overrides take precedence.\").optional() }).strict().describe(\"Commercial-flavored identity block. All fields optional; agencies operating as a sole operator with no counterparty billing may omit the block entirely.\").optional(), \"executor\": z.string().regex(new RegExp(\"^ws://operators/[a-z][a-z0-9-]*$\")).describe(\"OPTIONAL — AIP-9 default executor operator. The host activates this operator when an item with no explicit assignee surfaces.\").optional(), \"governance\": z.string().min(1).max(512).describe(\"OPTIONAL — AIP-7 policy or audit binding. May be a path to an AIP-7 policy file or a ws:// ref. Status-transition approvals, signature gates on agreements, and audit log routing flow through this ref. Agreements MUST be signed; the default policy lives here.\").optional(), \"knowledge\": z.string().regex(new RegExp(\"^ws://wikis/[a-z][a-z0-9-]*(/KNOWLEDGE\\\\.md)?$\")).describe(\"OPTIONAL — AIP-10 KNOWLEDGE.md ref. Wiki this agency refers to (case studies, prior-art, methodology).\").optional(), \"work\": z.string().regex(new RegExp(\"^ws://workspaces/[a-z][a-z0-9-]*(/WORK\\\\.md)?$\")).describe(\"OPTIONAL — AIP-20 work workspace binding. Items in `deliverable` MAY be tracked as work items in the bound workspace.\").optional(), \"playbook\": z.string().regex(new RegExp(\"^ws://playbooks/[a-z][a-z0-9-]*$\")).describe(\"OPTIONAL — AIP-12 active playbook. Governs the routine plays this agency runs.\").optional(), \"companies\": z.string().regex(new RegExp(\"^ws://companies(/[a-z][a-z0-9-]*)?$\")).describe(\"OPTIONAL — AIP-6 companies root. Resolution root for `counterparty` items: a counterparty's companyRef resolves under this binding.\").optional(), \"collections\": z.array(z.any()).describe(\"Collections enabled by this agency. Three forms supported: inline (full COLLECTION.md frontmatter), file ref, or registry import. Merge-by-effective-name (alias if set, otherwise the collection's name) across the extends chain.\").default([] as never), \"lifecycle\": z.object({ \"enabled\": z.boolean().describe(\"Whether cross-collection lifecycle propagation is active. When false, no lifecycle rules fire — items keep their stored statuses regardless of related items.\").default(false), \"rules\": z.array(z.object({ \"id\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\")).describe(\"Stable kebab-case rule id. Merge key when composing across extends.\"), \"when\": z.string().regex(new RegExp(\"^(all-items-in-collection-terminal|any-linked-item-status|linked-item-terminal|no-linked-items|custom:[a-z][a-z0-9-]*)$\")).describe(\"Predicate id from the recognised vocabulary. Custom predicates are host-defined keyed by `id`.\"), \"forCollection\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\")).describe(\"Effective name of the collection whose items receive the bubbled status. MUST appear in the workspace's merged collections array.\"), \"bubbleStatus\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\")).describe(\"Status id to set on the target item when the predicate holds. MUST exist on the forCollection's state machine.\"), \"params\": z.record(z.string(), z.any()).describe(\"Predicate parameters. Common keys: sourceCollection (collection whose items the predicate inspects), linkField (field on source items pointing at the target), terminalStatuses (subset of terminal statuses to count), statusEquals (specific status to match).\").default({} as never) }).strict()).describe(\"Cross-collection lifecycle rules. Merge-by-id vs parent. Hosts MUST detect graph cycles in the (forCollection, sourceCollection) edge set and refuse with agency_lifecycle_cycle (HARD).\").default([] as never) }).strict().describe(\"Engagement lifecycle helpers — workspace-level rules for cross-collection state propagation. The AIP-21 distinctive contribution.\").optional(), \"scope\": z.object({ \"containment\": z.object({ \"enabled\": z.boolean().describe(\"Whether the containment axis is active. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false (would orphan items). Refusal: agency_scope_disable (HARD).\").default(true), \"field\": z.string().regex(new RegExp(\"^[a-z][a-zA-Z0-9_]*$\")).describe(\"Item field name carrying the containment ref.\").default(\"parent\"), \"rules\": z.object({ \"allowedKinds\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"OPTIONAL — collection names allowed as containment parents.\").optional(), \"maxDepth\": z.number().int().gte(1).lte(32).describe(\"OPTIONAL — maximum containment depth.\").optional() }).strict().describe(\"OPTIONAL containment constraints.\").optional() }).strict().describe(\"Containment axis (parent/child).\").optional(), \"applicability\": z.object({ \"enabled\": z.boolean().describe(\"Whether the applicability axis is active.\").default(false), \"field\": z.string().regex(new RegExp(\"^[a-z][a-zA-Z0-9_]*$\")).describe(\"Item field name carrying the applicability ref list.\").default(\"appliesTo\"), \"valueClass\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\")).describe(\"Class of refs the field accepts. Recognised classes: client, market, service, company, role, role-and-company, operator. ONE-WAY SWITCH: once set at any ancestor, descendants MUST NOT change. Refusal: agency_scope_value_class_drift (HARD).\").optional() }).strict().describe(\"Applicability axis (who the item is about / scoped to).\").optional(), \"ownership\": z.object({ \"enabled\": z.boolean().describe(\"Whether the ownership axis is active.\").default(true), \"field\": z.string().regex(new RegExp(\"^[a-z][a-zA-Z0-9_]*$\")).describe(\"Workspace-level default item field name carrying the ownership ref.\").default(\"owner\"), \"policy\": z.enum([\"strict\",\"inherit\",\"open\"]).describe(\"Workspace-level ownership policy. 'strict' requires every collection's ownership.required to be true; 'inherit' delegates; 'open' permits any collection to omit ownership.\").default(\"inherit\") }).strict().describe(\"Ownership axis (who is doing the item).\").optional() }).strict().describe(\"Workspace-level scope axes — three orthogonal axes (containment / applicability / ownership) declared once per agency.\").optional(), \"lints\": z.array(z.object({ \"id\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\")).describe(\"Stable kebab-case lint id. Merge key when composing with extends parent.\"), \"kind\": z.enum([\"stale-engagement\",\"unsigned-agreement\",\"overdue-invoice\",\"broken-procedure-ref\",\"orphan-across-collections\",\"stale-tree\",\"broken-parent-ref\",\"scope-mismatch\",\"custom\"]).describe(\"Workspace-spanning lint algorithm. AIP-18 per-collection lints (missing-owner, overdue, required-field, etc.) live on COLLECTION.md and are NOT redeclared here. 'custom' delegates to a host-defined check identified by `id`.\"), \"severity\": z.enum([\"error\",\"warn\",\"info\"]).describe(\"Lint severity. Children may soften; governance policies MAY forbid softening below `error`.\"), \"params\": z.record(z.string(), z.any()).describe(\"Kind-specific parameters.\").default({} as never) }).strict()).describe(\"Workspace-spanning lints. Merge-by-id vs parent.\").default([] as never), \"defaults\": z.object({ \"workflow\": z.string().min(1).max(512).describe(\"OPTIONAL — default AIP-15 WORKFLOW.md path or ref.\").optional(), \"approvalClass\": z.string().regex(new RegExp(\"^(auto|always|on-mutate|policy:[A-Za-z0-9_./:-]+)$\")).describe(\"Approval class for mutations. 'auto' = no gate; 'always' = every mutation requires approval; 'on-mutate' = approval on field-level mutations; 'policy:<ref>' = delegate to an AIP-7 policy.\").optional(), \"auditMutations\": z.boolean().describe(\"Whether mutations are audited. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false. Refusal: agency_audit_downgrade (HARD).\").default(false) }).strict().describe(\"Routine workflow defaults. Composes with AIP-15.\").optional(), \"engagement\": z.object({ \"terms\": z.object({ \"contractRequired\": z.boolean().describe(\"Whether engagement items require a corresponding agreement item. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false (commercial protection against engagements without paperwork). Refusal: agency_contract_required_downgrade (HARD).\").default(false), \"defaultPaymentTerms\": z.string().regex(new RegExp(\"^(net-[0-9]+|due-on-receipt|prepaid|[a-z][a-z0-9-]*)$\")).describe(\"OPTIONAL — default payment terms for new invoices. Common values: net-15, net-30, net-60, due-on-receipt, prepaid. Custom kebab-case strings permitted.\").optional(), \"defaultCurrency\": z.string().regex(new RegExp(\"^[A-Z]{3}$\")).describe(\"OPTIONAL — default currency for engagement-derived invoices, as ISO 4217. Falls back to identity.defaultCurrency if unset.\").optional() }).strict().describe(\"Default commercial terms applied to new engagement and invoice items.\").optional() }).strict().describe(\"Engagement-specific terms (AIP-21 distinctive).\").optional(), \"display\": z.object({ \"homePage\": z.string().regex(new RegExp(\"^[A-Za-z0-9][A-Za-z0-9_:-]*$\")).describe(\"OPTIONAL — id of the item to use as the agency landing page.\").optional(), \"defaultGrouping\": z.enum([\"kind\",\"status\",\"counterparty\",\"engagement\"]).describe(\"Default grouping for list views.\").optional(), \"defaultView\": z.enum([\"list\",\"board\",\"timeline\",\"dashboard\"]).describe(\"Default rendering mode.\").optional() }).strict().describe(\"Display hints for UIs that render the agency. Runtime-agnostic.\").optional(), \"metadata\": z.record(z.string(), z.any()).describe(\"Vendor-specific extensions, namespaced under <vendor>. Deep-merged across the extends chain. MUST NOT change the meaning of any spec field.\").default({} as never) }).strict().and(z.any().describe(\"A view (any manifest with appliesTo set) MUST extend a parent. A workspace-root manifest has neither field.\")).describe(\"Validates the YAML frontmatter portion of an AIP-21 AGENCY.md (workspace root or per-context view). The single doctype 'agency.workspace/v2' is used in both modes; the host distinguishes by checking whether `extends` is set. Per-doctype schemas (service, engagement, agreement, deliverable, invoice, counterparty, procedure, pricing-model, routine, capacity) are delegated to AIP-18 (COLLECTION.md / ITEM.md).\")\n\nexport type AgencyV2Frontmatter = z.infer<typeof agencyV2FrontmatterSchema>\n","import { createDoctype } from \"@agentproto/define-doctype\"\nimport { agencyV2FrontmatterSchema } from \"./schema.js\"\nimport type { AgencyV2Definition, AgencyV2Handle } from \"./types.js\"\n\n/**\n * AIP-21 reference implementation of `defineAgencyV2`.\n *\n * Built on `createDoctype` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, \"defineAgencyV2 (AIP-21): …\"\n * error prefix) run uniformly with every other AIP defineX.\n *\n * Field-level validation runs the schema-derived zod from\n * `./schema.ts` against the input. Same source of truth as the .md\n * path uses (`parseAgencyV2Manifest`), so a malformed TS-authored\n * definition fails with the same diagnostic as a malformed manifest.\n * Cross-field rules go in `validate(def)` after the zod check.\n *\n * Identity / description extractors detected from the JSON Schema:\n *   readIdentity: def.name\n *   readDescription: def.description.\n */\nexport const defineAgencyV2 = createDoctype<AgencyV2Definition, AgencyV2Handle>({\n  aip: 21,\n  name: \"agency-v2\",\n  readIdentity: (def) => def.name,\n  validate(def) {\n    // AIP-21 rule (shared with AIP-18/20/22/23/24): appliesTo non-empty\n    // ⇒ extends required. Runs before field-level zod so a structural\n    // miss surfaces before the cascade of \"missing required field\".\n    const d = def as { appliesTo?: readonly unknown[]; extends?: unknown }\n    if (\n      Array.isArray(d.appliesTo) &&\n      d.appliesTo.length > 0 &&\n      d.extends == null\n    ) {\n      throw new Error(\n        `defineAgencyV2 (AIP-21): appliesTo is non-empty — extends MUST be set`,\n      )\n    }\n    const result = agencyV2FrontmatterSchema.safeParse(def)\n    if (!result.success) {\n      throw new Error(\n        `defineAgencyV2 (AIP-21): ${result.error.issues\n          .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n          .join(\"; \")}`,\n      )\n    }\n  },\n  build(def) {\n    // Default build: spread the validated definition into a fresh object.\n    // Hand-tune for nested freezing (Object.freeze on arrays/objects) and\n    // for fields that need defaults applied — see @agentproto/operator\n    // for a reference shape.\n    return { ...def } as AgencyV2Handle\n  },\n})\n"]}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { A as AgencyV2Definition } from './types-DOmT5DLV.js';
+export { a as AgencyV2Handle } from './types-DOmT5DLV.js';
+
+/**
+ * AIP-21 reference implementation of `defineAgencyV2`.
+ *
+ * Built on `createDoctype` so the cross-AIP invariants (id pattern,
+ * description length, top-level freeze, "defineAgencyV2 (AIP-21): …"
+ * error prefix) run uniformly with every other AIP defineX.
+ *
+ * Field-level validation runs the schema-derived zod from
+ * `./schema.ts` against the input. Same source of truth as the .md
+ * path uses (`parseAgencyV2Manifest`), so a malformed TS-authored
+ * definition fails with the same diagnostic as a malformed manifest.
+ * Cross-field rules go in `validate(def)` after the zod check.
+ *
+ * Identity / description extractors detected from the JSON Schema:
+ *   readIdentity: def.name
+ *   readDescription: def.description.
+ */
+declare const defineAgencyV2: (def: AgencyV2Definition) => Readonly<AgencyV2Definition>;
+
+/**
+ * @agentproto/agency-v2 — AIP-21 AGENCY.md `defineAgencyV2` reference impl.
+ *
+ * A workspace-only successor to AIP-8 that drops the eleven hardcoded agency doctypes (service, engagement, agreement, deliverable, invoice, counterparty, procedure, pricing-model, routine, capacity, agency) and delegates all per-doctype schema work to AIP-18 collections — owning only the workspace root manifest, the engagement lifecycle helpers that span collections, scope axes, and cross-AIP composition with strong governance and work bindings.
+ *
+ * Spec: https://agentproto.sh/docs/aip-21
+ *
+ * Authoring paths:
+ *   - TS:  `defineAgencyV2({...})` → `AgencyV2Handle`
+ *   - MD:  `parseAgencyV2Manifest(src) → agencyV2FromManifest({...})` → `AgencyV2Handle`
+ */
+declare const SPEC_NAME: "agentagency-v2/v1";
+declare const SPEC_VERSION: "1.0.0-alpha";
+
+export { AgencyV2Definition, SPEC_NAME, SPEC_VERSION, defineAgencyV2 };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+export { defineAgencyV2 } from './chunk-2EJ3V4IK.mjs';
+
+/**
+ * @agentproto/agency-v2 v0.1.0-alpha
+ * AIP-21 AGENCY.md `defineAgencyV2` reference implementation.
+ */
+
+// src/index.ts
+var SPEC_NAME = "agentagency-v2/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":";;;;;;;;AAYO,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["/**\n * @agentproto/agency-v2 — AIP-21 AGENCY.md `defineAgencyV2` reference impl.\n *\n * A workspace-only successor to AIP-8 that drops the eleven hardcoded agency doctypes (service, engagement, agreement, deliverable, invoice, counterparty, procedure, pricing-model, routine, capacity, agency) and delegates all per-doctype schema work to AIP-18 collections — owning only the workspace root manifest, the engagement lifecycle helpers that span collections, scope axes, and cross-AIP composition with strong governance and work bindings.\n *\n * Spec: https://agentproto.sh/docs/aip-21\n *\n * Authoring paths:\n *   - TS:  `defineAgencyV2({...})` → `AgencyV2Handle`\n *   - MD:  `parseAgencyV2Manifest(src) → agencyV2FromManifest({...})` → `AgencyV2Handle`\n */\n\nexport const SPEC_NAME = \"agentagency-v2/v1\" as const\nexport const SPEC_VERSION = \"1.0.0-alpha\" as const\n\nexport { defineAgencyV2 } from \"./define-agency-v2.js\"\nexport type { AgencyV2Definition, AgencyV2Handle } from \"./types.js\"\n"]}

package/dist/manifest/index.d.ts

@@ -0,0 +1,147 @@
+import { z } from 'zod';
+import { a as AgencyV2Handle } from '../types-DOmT5DLV.js';
+
+/**
+ * AIP-21 AGENCY.md frontmatter zod schema.
+ *
+ * Generated from `resources/aip-21/draft/AGENCY.schema.json` via
+ * json-schema-to-zod. Imported by both `define-agency-v2.ts` (TS path
+ * validation) and `manifest/index.ts` (.md path validation) so every
+ * field-level constraint runs in both authoring paths from a single
+ * source of truth — re-run scaffold-aip to refresh after spec changes.
+ *
+ * Cross-field rules (if/then/allOf in JSON Schema) don't translate
+ * cleanly and live in `define-agency-v2.ts`'s `validate(def)` instead.
+ */
+
+declare const agencyV2FrontmatterSchema: z.ZodIntersection<z.ZodObject<{
+    schema: z.ZodLiteral<"agency.workspace/v2">;
+    name: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    extends: z.ZodOptional<z.ZodString>;
+    appliesTo: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    identity: z.ZodOptional<z.ZodObject<{
+        legalEntity: z.ZodOptional<z.ZodString>;
+        legalName: z.ZodOptional<z.ZodString>;
+        taxId: z.ZodOptional<z.ZodString>;
+        jurisdiction: z.ZodOptional<z.ZodString>;
+        defaultCurrency: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    executor: z.ZodOptional<z.ZodString>;
+    governance: z.ZodOptional<z.ZodString>;
+    knowledge: z.ZodOptional<z.ZodString>;
+    work: z.ZodOptional<z.ZodString>;
+    playbook: z.ZodOptional<z.ZodString>;
+    companies: z.ZodOptional<z.ZodString>;
+    collections: z.ZodDefault<z.ZodArray<z.ZodAny>>;
+    lifecycle: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            when: z.ZodString;
+            forCollection: z.ZodString;
+            bubbleStatus: z.ZodString;
+            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    scope: z.ZodOptional<z.ZodObject<{
+        containment: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            field: z.ZodDefault<z.ZodString>;
+            rules: z.ZodOptional<z.ZodObject<{
+                allowedKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                maxDepth: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        applicability: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            field: z.ZodDefault<z.ZodString>;
+            valueClass: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        ownership: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            field: z.ZodDefault<z.ZodString>;
+            policy: z.ZodDefault<z.ZodEnum<{
+                strict: "strict";
+                inherit: "inherit";
+                open: "open";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    lints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            custom: "custom";
+            "stale-engagement": "stale-engagement";
+            "unsigned-agreement": "unsigned-agreement";
+            "overdue-invoice": "overdue-invoice";
+            "broken-procedure-ref": "broken-procedure-ref";
+            "orphan-across-collections": "orphan-across-collections";
+            "stale-tree": "stale-tree";
+            "broken-parent-ref": "broken-parent-ref";
+            "scope-mismatch": "scope-mismatch";
+        }>;
+        severity: z.ZodEnum<{
+            error: "error";
+            warn: "warn";
+            info: "info";
+        }>;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strict>>>;
+    defaults: z.ZodOptional<z.ZodObject<{
+        workflow: z.ZodOptional<z.ZodString>;
+        approvalClass: z.ZodOptional<z.ZodString>;
+        auditMutations: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    engagement: z.ZodOptional<z.ZodObject<{
+        terms: z.ZodOptional<z.ZodObject<{
+            contractRequired: z.ZodDefault<z.ZodBoolean>;
+            defaultPaymentTerms: z.ZodOptional<z.ZodString>;
+            defaultCurrency: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    display: z.ZodOptional<z.ZodObject<{
+        homePage: z.ZodOptional<z.ZodString>;
+        defaultGrouping: z.ZodOptional<z.ZodEnum<{
+            kind: "kind";
+            engagement: "engagement";
+            status: "status";
+            counterparty: "counterparty";
+        }>>;
+        defaultView: z.ZodOptional<z.ZodEnum<{
+            list: "list";
+            board: "board";
+            timeline: "timeline";
+            dashboard: "dashboard";
+        }>>;
+    }, z.core.$strict>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>, z.ZodAny>;
+type AgencyV2Frontmatter = z.infer<typeof agencyV2FrontmatterSchema>;
+
+/**
+ * AIP-21 AGENCY.md sidecar parser + manifest-to-handle constructor.
+ *
+ * Mirror of `@agentproto/tool/manifest` and `@agentproto/driver/manifest`:
+ * the .md provides metadata; the TS module supplies any spec-specific
+ * runtime bits (schemas, execute bodies, …) that can't live in
+ * frontmatter. Both inputs end up in `defineAgencyV2` so the cross-AIP
+ * invariants run uniformly.
+ *
+ *
+ * The frontmatter zod schema below was generated from
+ * `resources/aip-21/draft/AGENCY.schema.json` via json-schema-to-zod.
+ * Re-run scaffold-aip to refresh after spec changes (or hand-tune
+ * any constraint the converter doesn't capture cleanly).
+ */
+
+interface AgencyV2Manifest {
+    frontmatter: AgencyV2Frontmatter;
+    body: string;
+}
+declare function parseAgencyV2Manifest(source: string): AgencyV2Manifest;
+declare function agencyV2FromManifest(manifest: AgencyV2Manifest): AgencyV2Handle;
+
+export { type AgencyV2Frontmatter, type AgencyV2Manifest, agencyV2FromManifest, agencyV2FrontmatterSchema, parseAgencyV2Manifest };

package/dist/manifest/index.mjs

@@ -0,0 +1,28 @@
+import { agencyV2FrontmatterSchema, defineAgencyV2 } from '../chunk-2EJ3V4IK.mjs';
+export { agencyV2FrontmatterSchema } from '../chunk-2EJ3V4IK.mjs';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/agency-v2 v0.1.0-alpha
+ * AIP-21 AGENCY.md `defineAgencyV2` reference implementation.
+ */
+function parseAgencyV2Manifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parseAgencyV2Manifest: missing or empty frontmatter");
+  }
+  const result = agencyV2FrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parseAgencyV2Manifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function agencyV2FromManifest(manifest) {
+  return defineAgencyV2(manifest.frontmatter);
+}
+
+export { agencyV2FromManifest, parseAgencyV2Manifest };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/manifest/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/manifest/index.ts"],"names":[],"mappings":";;;;;;;;AA8BO,SAAS,sBAAsB,MAAA,EAAkC;AACtE,EAAA,MAAM,MAAA,GAAS,OAAO,MAAM,CAAA;AAC5B,EAAA,IAAI,OAAO,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,CAAE,WAAW,CAAA,EAAG;AACzC,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,MAAM,MAAA,GAAS,yBAAA,CAA0B,SAAA,CAAU,MAAA,CAAO,IAAI,CAAA;AAC9D,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,kDAAA,EAAgD,OAAO,KAAA,CAAM,MAAA,CAC1D,IAAI,CAAC,CAAA,KAAM,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAC,KAAK,CAAA,CAAE,OAAO,EAAE,CAAA,CAC9C,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACf;AAAA,EACF;AACA,EAAA,OAAO,EAAE,WAAA,EAAa,MAAA,CAAO,IAAA,EAAM,IAAA,EAAM,OAAO,OAAA,EAAQ;AAC1D;AAEO,SAAS,qBAAqB,QAAA,EAA4C;AAK/E,EAAA,OAAO,cAAA,CAAe,SAAS,WAA4C,CAAA;AAC7E","file":"index.mjs","sourcesContent":["/**\n * AIP-21 AGENCY.md sidecar parser + manifest-to-handle constructor.\n *\n * Mirror of `@agentproto/tool/manifest` and `@agentproto/driver/manifest`:\n * the .md provides metadata; the TS module supplies any spec-specific\n * runtime bits (schemas, execute bodies, …) that can't live in\n * frontmatter. Both inputs end up in `defineAgencyV2` so the cross-AIP\n * invariants run uniformly.\n *\n *\n * The frontmatter zod schema below was generated from\n * `resources/aip-21/draft/AGENCY.schema.json` via json-schema-to-zod.\n * Re-run scaffold-aip to refresh after spec changes (or hand-tune\n * any constraint the converter doesn't capture cleanly).\n */\n\nimport matter from \"gray-matter\"\nimport { agencyV2FrontmatterSchema, type AgencyV2Frontmatter } from \"../schema.js\"\nimport { defineAgencyV2 } from \"../define-agency-v2.js\"\nimport type { AgencyV2Definition, AgencyV2Handle } from \"../types.js\"\n\n// Re-export so consumers can import the schema + inferred type either\n// from \"@@agentproto/agency-v2/manifest\" or directly from \"@@agentproto/agency-v2/schema\".\nexport { agencyV2FrontmatterSchema, type AgencyV2Frontmatter }\n\nexport interface AgencyV2Manifest {\n  frontmatter: AgencyV2Frontmatter\n  body: string\n}\n\nexport function parseAgencyV2Manifest(source: string): AgencyV2Manifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parseAgencyV2Manifest: missing or empty frontmatter\")\n  }\n  const result = agencyV2FrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parseAgencyV2Manifest: invalid frontmatter — ${result.error.issues\n        .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n        .join(\"; \")}`,\n    )\n  }\n  return { frontmatter: result.data, body: parsed.content }\n}\n\nexport function agencyV2FromManifest(manifest: AgencyV2Manifest): AgencyV2Handle {\n  // The zod-validated frontmatter is structurally compatible with\n  // AgencyV2Definition; the cast pins the typing once the manifest\n  // schema and the TS interface diverge (e.g. handle has frozen fields\n  // a literal config doesn't carry yet).\n  return defineAgencyV2(manifest.frontmatter as unknown as AgencyV2Definition)\n}\n"]}

package/dist/types-DOmT5DLV.d.ts

@@ -0,0 +1,556 @@
+/**
+ * AIP-21 AgencyV2Definition + AgencyV2Handle.
+ *
+ * `AgencyV2Definition` was generated from
+ * `resources/aip-21/draft/AGENCY.schema.json` via json-schema-to-typescript.
+ * `AgencyV2Handle` is the readonly view of the same shape; tighten it
+ * by hand for fields that get defaults applied in build().
+ */
+/**
+ * Validates the YAML frontmatter portion of an AIP-21 AGENCY.md (workspace root or per-context view). The single doctype 'agency.workspace/v2' is used in both modes; the host distinguishes by checking whether `extends` is set. Per-doctype schemas (service, engagement, agreement, deliverable, invoice, counterparty, procedure, pricing-model, routine, capacity) are delegated to AIP-18 (COLLECTION.md / ITEM.md).
+ */
+type AgencyV2Definition = {
+    [k: string]: unknown;
+} & {
+    /**
+     * Discriminator for the AIP-21 workspace doctype.
+     */
+    schema: "agency.workspace/v2";
+    /**
+     * Stable kebab-case identifier for the agency or view.
+     */
+    name: string;
+    /**
+     * Human-readable agency title.
+     */
+    title: string;
+    /**
+     * One-paragraph statement of purpose: what this agency does and who it serves.
+     */
+    description: string;
+    /**
+     * Semantic version of the WORKSPACE shape. Bump on collection / scope / lifecycle / lint / defaults changes. Independent of the agency's content version.
+     */
+    version: string;
+    /**
+     * OPTIONAL — relative path to a parent AGENCY.md. Presence makes the manifest a VIEW; absence makes it a WORKSPACE ROOT. Recursive composition; maximum chain depth is 8.
+     */
+    extends?: string;
+    /**
+     * OPTIONAL — list of consumers this VIEW adapts the agency for. Hosts MUST refuse the view if any binding does not resolve. Not inherited; views declare their own scope.
+     */
+    appliesTo?: string[];
+    /**
+     * Commercial-flavored identity block. All fields optional; agencies operating as a sole operator with no counterparty billing may omit the block entirely.
+     */
+    identity?: {
+        /**
+         * OPTIONAL — AIP-6 ref to the company that legally signs agreements and issues invoices. When set, hosts SHOULD resolve this ref to populate legalName and taxId from the AIP-6 record.
+         */
+        legalEntity?: string;
+        /**
+         * OPTIONAL — display string for the legal entity name. Used when legalEntity is absent or to override the AIP-6 record's legalName.
+         */
+        legalName?: string;
+        /**
+         * OPTIONAL — tax identifier (VAT, EIN, GST, etc.). Hosts MUST treat this string as opaque; format validation belongs to per-jurisdiction tooling.
+         */
+        taxId?: string;
+        /**
+         * OPTIONAL — primary jurisdiction the agency operates under, as ISO 3166-1 alpha-2 (e.g. FR, US, GB, DE).
+         */
+        jurisdiction?: string;
+        /**
+         * OPTIONAL — default currency for new invoices, as ISO 4217 (e.g. EUR, USD, GBP). Per-engagement overrides take precedence.
+         */
+        defaultCurrency?: string;
+    };
+    /**
+     * OPTIONAL — AIP-9 default executor operator. The host activates this operator when an item with no explicit assignee surfaces.
+     */
+    executor?: string;
+    /**
+     * OPTIONAL — AIP-7 policy or audit binding. May be a path to an AIP-7 policy file or a ws:// ref. Status-transition approvals, signature gates on agreements, and audit log routing flow through this ref. Agreements MUST be signed; the default policy lives here.
+     */
+    governance?: string;
+    /**
+     * OPTIONAL — AIP-10 KNOWLEDGE.md ref. Wiki this agency refers to (case studies, prior-art, methodology).
+     */
+    knowledge?: string;
+    /**
+     * OPTIONAL — AIP-20 work workspace binding. Items in `deliverable` MAY be tracked as work items in the bound workspace.
+     */
+    work?: string;
+    /**
+     * OPTIONAL — AIP-12 active playbook. Governs the routine plays this agency runs.
+     */
+    playbook?: string;
+    /**
+     * OPTIONAL — AIP-6 companies root. Resolution root for `counterparty` items: a counterparty's companyRef resolves under this binding.
+     */
+    companies?: string;
+    /**
+     * Collections enabled by this agency. Three forms supported: inline (full COLLECTION.md frontmatter), file ref, or registry import. Merge-by-effective-name (alias if set, otherwise the collection's name) across the extends chain.
+     */
+    collections?: CollectionEntry[];
+    /**
+     * Engagement lifecycle helpers — workspace-level rules for cross-collection state propagation. The AIP-21 distinctive contribution.
+     */
+    lifecycle?: {
+        /**
+         * Whether cross-collection lifecycle propagation is active. When false, no lifecycle rules fire — items keep their stored statuses regardless of related items.
+         */
+        enabled?: boolean;
+        /**
+         * Cross-collection lifecycle rules. Merge-by-id vs parent. Hosts MUST detect graph cycles in the (forCollection, sourceCollection) edge set and refuse with agency_lifecycle_cycle (HARD).
+         */
+        rules?: {
+            /**
+             * Stable kebab-case rule id. Merge key when composing across extends.
+             */
+            id: string;
+            /**
+             * Predicate id from the recognised vocabulary. Custom predicates are host-defined keyed by `id`.
+             */
+            when: string;
+            /**
+             * Effective name of the collection whose items receive the bubbled status. MUST appear in the workspace's merged collections array.
+             */
+            forCollection: string;
+            /**
+             * Status id to set on the target item when the predicate holds. MUST exist on the forCollection's state machine.
+             */
+            bubbleStatus: string;
+            /**
+             * Predicate parameters. Common keys: sourceCollection (collection whose items the predicate inspects), linkField (field on source items pointing at the target), terminalStatuses (subset of terminal statuses to count), statusEquals (specific status to match).
+             */
+            params?: {
+                [k: string]: unknown;
+            };
+        }[];
+    };
+    /**
+     * Workspace-level scope axes — three orthogonal axes (containment / applicability / ownership) declared once per agency.
+     */
+    scope?: {
+        /**
+         * Containment axis (parent/child).
+         */
+        containment?: {
+            /**
+             * Whether the containment axis is active. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false (would orphan items). Refusal: agency_scope_disable (HARD).
+             */
+            enabled?: boolean;
+            /**
+             * Item field name carrying the containment ref.
+             */
+            field?: string;
+            /**
+             * OPTIONAL containment constraints.
+             */
+            rules?: {
+                /**
+                 * OPTIONAL — collection names allowed as containment parents.
+                 */
+                allowedKinds?: string[];
+                /**
+                 * OPTIONAL — maximum containment depth.
+                 */
+                maxDepth?: number;
+            };
+        };
+        /**
+         * Applicability axis (who the item is about / scoped to).
+         */
+        applicability?: {
+            /**
+             * Whether the applicability axis is active.
+             */
+            enabled?: boolean;
+            /**
+             * Item field name carrying the applicability ref list.
+             */
+            field?: string;
+            /**
+             * Class of refs the field accepts. Recognised classes: client, market, service, company, role, role-and-company, operator. ONE-WAY SWITCH: once set at any ancestor, descendants MUST NOT change. Refusal: agency_scope_value_class_drift (HARD).
+             */
+            valueClass?: string;
+        };
+        /**
+         * Ownership axis (who is doing the item).
+         */
+        ownership?: {
+            /**
+             * Whether the ownership axis is active.
+             */
+            enabled?: boolean;
+            /**
+             * Workspace-level default item field name carrying the ownership ref.
+             */
+            field?: string;
+            /**
+             * Workspace-level ownership policy. 'strict' requires every collection's ownership.required to be true; 'inherit' delegates; 'open' permits any collection to omit ownership.
+             */
+            policy?: "strict" | "inherit" | "open";
+        };
+    };
+    /**
+     * Workspace-spanning lints. Merge-by-id vs parent.
+     */
+    lints?: {
+        /**
+         * Stable kebab-case lint id. Merge key when composing with extends parent.
+         */
+        id: string;
+        /**
+         * Workspace-spanning lint algorithm. AIP-18 per-collection lints (missing-owner, overdue, required-field, etc.) live on COLLECTION.md and are NOT redeclared here. 'custom' delegates to a host-defined check identified by `id`.
+         */
+        kind: "stale-engagement" | "unsigned-agreement" | "overdue-invoice" | "broken-procedure-ref" | "orphan-across-collections" | "stale-tree" | "broken-parent-ref" | "scope-mismatch" | "custom";
+        /**
+         * Lint severity. Children may soften; governance policies MAY forbid softening below `error`.
+         */
+        severity: "error" | "warn" | "info";
+        /**
+         * Kind-specific parameters.
+         */
+        params?: {
+            [k: string]: unknown;
+        };
+    }[];
+    /**
+     * Routine workflow defaults. Composes with AIP-15.
+     */
+    defaults?: {
+        /**
+         * OPTIONAL — default AIP-15 WORKFLOW.md path or ref.
+         */
+        workflow?: string;
+        /**
+         * Approval class for mutations. 'auto' = no gate; 'always' = every mutation requires approval; 'on-mutate' = approval on field-level mutations; 'policy:<ref>' = delegate to an AIP-7 policy.
+         */
+        approvalClass?: string;
+        /**
+         * Whether mutations are audited. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false. Refusal: agency_audit_downgrade (HARD).
+         */
+        auditMutations?: boolean;
+    };
+    /**
+     * Engagement-specific terms (AIP-21 distinctive).
+     */
+    engagement?: {
+        /**
+         * Default commercial terms applied to new engagement and invoice items.
+         */
+        terms?: {
+            /**
+             * Whether engagement items require a corresponding agreement item. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false (commercial protection against engagements without paperwork). Refusal: agency_contract_required_downgrade (HARD).
+             */
+            contractRequired?: boolean;
+            /**
+             * OPTIONAL — default payment terms for new invoices. Common values: net-15, net-30, net-60, due-on-receipt, prepaid. Custom kebab-case strings permitted.
+             */
+            defaultPaymentTerms?: string;
+            /**
+             * OPTIONAL — default currency for engagement-derived invoices, as ISO 4217. Falls back to identity.defaultCurrency if unset.
+             */
+            defaultCurrency?: string;
+        };
+    };
+    /**
+     * Display hints for UIs that render the agency. Runtime-agnostic.
+     */
+    display?: {
+        /**
+         * OPTIONAL — id of the item to use as the agency landing page.
+         */
+        homePage?: string;
+        /**
+         * Default grouping for list views.
+         */
+        defaultGrouping?: "kind" | "status" | "counterparty" | "engagement";
+        /**
+         * Default rendering mode.
+         */
+        defaultView?: "list" | "board" | "timeline" | "dashboard";
+    };
+    /**
+     * Vendor-specific extensions, namespaced under <vendor>. Deep-merged across the extends chain. MUST NOT change the meaning of any spec field.
+     */
+    metadata?: {
+        [k: string]: unknown;
+    };
+};
+/**
+ * One collection declaration. Either an inline AIP-18 collection schema, or a ref (path or ws:// URI) optionally aliased and version-pinned.
+ */
+type CollectionEntry = CollectionInline | CollectionRef;
+/**
+ * Full AIP-18 collection.schema/v1 frontmatter, parsed in-place. The host registers the collection directly via AIP-18's defineCollection without loading a separate file.
+ */
+type Schema = {
+    [k: string]: unknown;
+} & {
+    /**
+     * Discriminator for a collection definition.
+     */
+    schema: "collection.schema/v1";
+    /**
+     * Stable kebab-case identifier. Items reference this name via their `collection:` field.
+     */
+    name: string;
+    /**
+     * Human-readable collection title.
+     */
+    title: string;
+    /**
+     * One-paragraph statement of purpose: what this collection captures and when an item belongs here vs another collection.
+     */
+    description: string;
+    /**
+     * Semantic version of the SHAPE. Bump on field/status/lint changes. Independent of the collection's content.
+     */
+    version: string;
+    /**
+     * OPTIONAL — relative path to a parent COLLECTION.md. Recursive composition; maximum chain depth is 8.
+     */
+    extends?: string;
+    /**
+     * OPTIONAL — list of consumers this collection adapts for. Hosts MUST refuse if any binding does not resolve. Not inherited; each child declares its own scope.
+     */
+    appliesTo?: string[];
+    /**
+     * Item field schema. Merge-by-name vs parent: a child entry with the same `name` replaces the parent's (subject to type-drift refusal); new names are appended.
+     */
+    fields?: FieldDef[];
+    /**
+     * Status state machine. Merge-by-id vs parent. Children may add statuses, mark inherited statuses terminal, or narrow `transitionsTo`; they MUST NOT remove an inherited status.
+     */
+    statuses?: {
+        /**
+         * Stable kebab-case status id. Merge key when composing.
+         */
+        id: string;
+        /**
+         * Human-readable status label.
+         */
+        label: string;
+        /**
+         * Whether items in this status are considered closed. Lints like `overdue` typically skip terminal statuses.
+         */
+        terminal?: boolean;
+        /**
+         * OPTIONAL — allowed next status ids. If omitted, all transitions are permitted.
+         */
+        transitionsTo?: string[];
+    }[];
+    /**
+     * OPTIONAL — default status assigned to new items. MUST refer to a status declared (locally or inherited) by this collection.
+     */
+    initialStatus?: string;
+    /**
+     * Ownership rules. Each leaf field overrides independently across the chain.
+     */
+    ownership?: {
+        /**
+         * How many owners an item may carry. `none` = no ownership concept; `single` = one owner; `multiple` = list of owners.
+         */
+        cardinality?: "none" | "single" | "multiple";
+        /**
+         * Item field name that holds the owner ref.
+         */
+        role?: string;
+        /**
+         * Whether items MUST declare an owner.
+         */
+        required?: boolean;
+    };
+    /**
+     * Deadline rules. Each leaf field overrides independently.
+     */
+    deadline?: {
+        /**
+         * Deadline shape. `none` = no deadline concept; `target-date` = single date; `window` = start+end; `recurrent` = repeating.
+         */
+        kind?: "none" | "target-date" | "window" | "recurrent";
+        /**
+         * Whether items MUST declare a deadline value.
+         */
+        required?: boolean;
+        /**
+         * Item field name that holds the deadline value.
+         */
+        fieldName?: string;
+    };
+    /**
+     * Lint rules. Merge-by-id vs parent.
+     */
+    lints?: {
+        /**
+         * Stable kebab-case lint id. Merge key when composing.
+         */
+        id: string;
+        /**
+         * Lint algorithm. `custom` delegates to a host-defined check identified by `id`.
+         */
+        kind: "missing-owner" | "overdue" | "orphan" | "broken-ref" | "stale" | "required-field" | "custom";
+        /**
+         * Always '*' — items belong to one collection, so the lint always applies to all items of this collection. The field is preserved for symmetry with AIP-10's lint shape.
+         */
+        appliesTo: "*";
+        /**
+         * Lint severity. Children may soften; governance policies MAY forbid softening below `error`.
+         */
+        severity: "error" | "warn" | "info";
+        /**
+         * Kind-specific parameters. e.g. { days: 30 } for `stale`; { field: 'severity' } for `required-field`.
+         */
+        params?: {
+            [k: string]: unknown;
+        };
+    }[];
+    /**
+     * Item identity & filing rules.
+     */
+    identity?: {
+        /**
+         * How to derive an item's slug. Either a field name (e.g. 'title'), the literal 'random', the literal 'sequence', or 'hash:<comma-separated-source-fields>' (e.g. 'hash:title,createdAt').
+         */
+        slugSource?: string;
+        /**
+         * Template for where items are filed on disk. Tokens: {collection}, {slug}, {year}, {month}. e.g. 'items/{collection}/{slug}.md'.
+         */
+        filingPath?: string;
+    };
+    /**
+     * Vendor-specific extensions, namespaced under <vendor>. Deep-merged across the extends chain.
+     */
+    metadata?: {
+        [k: string]: unknown;
+    };
+};
+/**
+ * Inline collection declaration. Full AIP-18 schema embedded; hosts MUST validate it against the AIP-18 COLLECTION schema before registration.
+ */
+interface CollectionInline {
+    inline: Schema;
+}
+/**
+ * Definition of one field on a collection's item schema. Merge-by-name. Type drift between parent and child is HARD refused.
+ */
+interface FieldDef {
+    /**
+     * kebab-or-camel-case field name. Merge key when composing.
+     */
+    name: string;
+    /**
+     * Field type. Drift across composition (parent string -> child number) is HARD refused (`collection_field_type_drift`).
+     */
+    type: "string" | "number" | "boolean" | "enum" | "date" | "datetime" | "text" | "url" | "ref" | "array";
+    /**
+     * Whether items MUST declare this field. A child may narrow false -> true; loosening true -> false is permitted (it removes a constraint without invalidating instances).
+     */
+    required?: boolean;
+    /**
+     * Prose describing what the field captures.
+     */
+    description?: string;
+    /**
+     * Required when type=enum. Children may narrow to a subset; widening to a superset is permitted (it does not invalidate instances).
+     */
+    enum?: string[];
+    items?: FieldDef1;
+    /**
+     * Required when type=ref. The target collection's `name`. Hosts validate that ref values point at items of this collection.
+     */
+    refKind?: string;
+    /**
+     * OPTIONAL regex constraint. Only valid when type=string.
+     */
+    pattern?: string;
+    /**
+     * OPTIONAL minimum. For type=number: minimum value. For type=array: minimum length.
+     */
+    min?: number;
+    /**
+     * OPTIONAL maximum. For type=number: maximum value. For type=array: maximum length.
+     */
+    max?: number;
+    /**
+     * OPTIONAL named format. Common values: email, uri, semver, uuid, slug. Only valid when type=string. Hosts MAY interpret unknown formats as advisory.
+     */
+    format?: string;
+    /**
+     * OPTIONAL deprecation flag. A child may set false to mark an inherited field deprecated; the host preserves the field in the resolved schema (so existing items still validate) but flags new uses via lint. Setting enabled:false on a field a child does not inherit is invalid.
+     */
+    enabled?: boolean;
+}
+/**
+ * Required when type=array. Recursive shape — describes the inner item type.
+ */
+interface FieldDef1 {
+    /**
+     * kebab-or-camel-case field name. Merge key when composing.
+     */
+    name: string;
+    /**
+     * Field type. Drift across composition (parent string -> child number) is HARD refused (`collection_field_type_drift`).
+     */
+    type: "string" | "number" | "boolean" | "enum" | "date" | "datetime" | "text" | "url" | "ref" | "array";
+    /**
+     * Whether items MUST declare this field. A child may narrow false -> true; loosening true -> false is permitted (it removes a constraint without invalidating instances).
+     */
+    required?: boolean;
+    /**
+     * Prose describing what the field captures.
+     */
+    description?: string;
+    /**
+     * Required when type=enum. Children may narrow to a subset; widening to a superset is permitted (it does not invalidate instances).
+     */
+    enum?: string[];
+    items?: FieldDef1;
+    /**
+     * Required when type=ref. The target collection's `name`. Hosts validate that ref values point at items of this collection.
+     */
+    refKind?: string;
+    /**
+     * OPTIONAL regex constraint. Only valid when type=string.
+     */
+    pattern?: string;
+    /**
+     * OPTIONAL minimum. For type=number: minimum value. For type=array: minimum length.
+     */
+    min?: number;
+    /**
+     * OPTIONAL maximum. For type=number: maximum value. For type=array: maximum length.
+     */
+    max?: number;
+    /**
+     * OPTIONAL named format. Common values: email, uri, semver, uuid, slug. Only valid when type=string. Hosts MAY interpret unknown formats as advisory.
+     */
+    format?: string;
+    /**
+     * OPTIONAL deprecation flag. A child may set false to mark an inherited field deprecated; the host preserves the field in the resolved schema (so existing items still validate) but flags new uses via lint. Setting enabled:false on a field a child does not inherit is invalid.
+     */
+    enabled?: boolean;
+}
+/**
+ * Collection ref declaration. Either a file path or a registry URI.
+ */
+interface CollectionRef {
+    /**
+     * Either a relative path to a COLLECTION.md (file ref) or a ws://collections/<slug> URI (registry import).
+     */
+    ref: string;
+    /**
+     * OPTIONAL — workspace-local name to expose the collection under. Items in this workspace reference the alias, not the upstream name. Two collections resolving to the same effective name is a HARD failure: agency_collection_alias_conflict.
+     */
+    alias?: string;
+    /**
+     * OPTIONAL — semver range (e.g. "1.x", "^1.2", "1.2.0"). When set, schema bumps outside the range fail with collection_item_schema_pinned_drift (HARD) at item load time.
+     */
+    version?: string;
+}
+type AgencyV2Handle = Readonly<AgencyV2Definition>;
+
+export type { AgencyV2Definition as A, AgencyV2Handle as a };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@agentproto/agency-v2",
+  "version": "0.1.0-alpha.0",
+  "description": "@agentproto/agency-v2 — AIP-21 AGENCY.md reference implementation. A workspace-only successor to AIP-8 that drops the eleven hardcoded agency doctypes (service, engagement, agreement, deliverable, invoice, counterparty, procedure, pricing-model, routine, capacity, agency) and delegates all per-doctype schema work to AIP-18 collections — owning only the workspace root manifest, the engagement lifecycle helpers that span collections, scope axes, and cross-AIP composition with strong governance and work bindings.",
+  "keywords": [
+    "agentproto",
+    "aip-21",
+    "agency-v2",
+    "defineAgencyV2",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-21",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/agency-v2"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./manifest": {
+      "types": "./dist/manifest/index.d.ts",
+      "import": "./dist/manifest/index.mjs",
+      "default": "./dist/manifest/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "zod": "^4.4.3",
+    "@agentproto/define-doctype": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}