@agentproto/agencies-mastra 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeremy André and 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,39 @@
+# @agentproto/agencies-mastra
+
+Mastra adapter for [agentagencies/v1](https://agentproto.sh/docs/agp-1).
+
+## Two surfaces
+
+### 1. Codegen (`./codegen`)
+
+Turns a `PROCEDURE.md` (vendor-neutral playbook) into a Mastra `workflow.ts`.
+Apps run this codegen once per procedure + commit the generated file.
+
+```ts
+import { procedureToWorkflow } from "@agentproto/agencies-mastra/codegen"
+
+const procedure = await loadProcedure("design-project-execute")
+const tsSource = procedureToWorkflow(procedure.frontmatter, {
+  toolsModuleSpecifier: "@my-app/tools",
+})
+
+await writeFile(
+  "apps/my-app/src/mastra/workflows/design-project-execute.ts",
+  tsSource
+)
+```
+
+### 2. Runtime (`./` main)
+
+`createAgenciesBindings(config)` returns a bag of orchestration helpers:
+engagement state machine, agreement issuer, invoice issuer. Phase 1 ships the
+scaffold; Phase 2 wires actual Mastra suspend/resume.
+
+## Status
+
+**Alpha — scaffolding.** The codegen emits a skeleton with TODOs; full state
+machine wiring lands in Phase 2 once the host workflow patterns stabilize.
+
+## License
+
+MIT

package/dist/codegen.d.ts

@@ -0,0 +1,32 @@
+import { ProcedureFrontmatter } from '@agentproto/agencies/doctypes';
+
+/**
+ * PROCEDURE.md → Mastra `workflow.ts` codegen.
+ *
+ * Reads a procedure doctype + emits a TypeScript file that instantiates a
+ * Mastra workflow with one step per procedure step. Branching steps emit
+ * conditional resume logic; signature gates suspend via the governance Mastra adapter.
+ *
+ * Phase 1 scaffolding: outputs a skeleton workflow.ts with TODO markers where
+ * signature gates need to wire to @agentproto/governance-mastra primitives.
+ */
+
+interface ProcedureToWorkflowOptions {
+    /** Workflow id used by Mastra (defaults to procedure slug). */
+    workflowId?: string;
+    /** Module specifier for tools used in the workflow (defaults to app's own tools file). */
+    toolsModuleSpecifier?: string;
+    /** Module specifier for the agencies bindings (defaults to "@agentproto/agencies-mastra"). */
+    bindingsModuleSpecifier?: string;
+}
+/**
+ * Generate a Mastra `workflow.ts` source string from a parsed PROCEDURE.md
+ * frontmatter.
+ *
+ * Phase 1 emits a skeleton with one step stub per procedure step + comments
+ * pointing at the canvakit/agency.* templates and the governance suspend hook.
+ * Apps customize the generated file then commit it.
+ */
+declare function procedureToWorkflow(procedure: ProcedureFrontmatter, options?: ProcedureToWorkflowOptions): string;
+
+export { type ProcedureToWorkflowOptions, procedureToWorkflow };

package/dist/codegen.mjs

@@ -0,0 +1,52 @@
+/**
+ * @agentproto/agencies-mastra v0.1.0-alpha
+ * Mastra adapter for agentagencies/v1.
+ */
+
+// src/codegen.ts
+function procedureToWorkflow(procedure, options = {}) {
+  const id = options.workflowId ?? procedure.slug;
+  const tools = options.toolsModuleSpecifier ?? "../tools/index.js";
+  const bindings = options.bindingsModuleSpecifier ?? "@agentproto/agencies-mastra";
+  const stepBlocks = procedure.steps.map((step, index) => {
+    const next = procedure.steps[index + 1]?.id ?? "<final>";
+    return `// Step: ${step.id}
+// description: ${step.description ?? "(no description)"}
+// requiredSkill: ${step.requiredSkill ?? "(none)"}
+// expected output: ${step.output ?? "(none)"}
+//
+// TODO(phase-2): emit a Mastra step (tools[...], inputSchema, outputSchema, execute).
+// If this step has \`branch\`, emit conditional resume to one of the branch.action targets.
+// If this step requires signatures, suspend via @agentproto/governance-mastra
+// shouldSuspendForSignatures + resume on signArtifact completion.
+// Next step: ${next}
+`;
+  }).join("\n");
+  return `/**
+ * AUTO-GENERATED from PROCEDURE.md slug=${procedure.slug} (agentagencies/v1).
+ * DO NOT EDIT BY HAND \u2014 re-run \`@agentproto/agencies-mastra\` codegen if the procedure changes.
+ *
+ * Procedure name: ${procedure.name}
+ * Procedure description: ${procedure.description ?? "(no description)"}
+ * Triggers: ${procedure.triggers.map((t) => t.kind).join(", ") || "(none)"}
+ * Required skills: ${procedure.requiredSkills.join(", ") || "(none)"}
+ * Autonomy policy: ${procedure.autonomyPolicy ?? "(none)"}
+ */
+
+import { createWorkflow } from "@mastra/core/workflows" // peer dep
+import { createGovernanceBindings } from "${bindings}"
+import * as agencyTools from "${tools}" // app-provided tool registry
+
+export const ${id.replace(/-/g, "_")}_workflow = createWorkflow({
+  id: ${JSON.stringify(id)},
+  steps: {
+    // \u2500\u2500\u2500 steps \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+${stepBlocks}
+  },
+})
+`;
+}
+
+export { procedureToWorkflow };
+//# sourceMappingURL=codegen.mjs.map
+//# sourceMappingURL=codegen.mjs.map

package/dist/codegen.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codegen.ts"],"names":[],"mappings":";;;;;;AA8BO,SAAS,mBAAA,CACd,SAAA,EACA,OAAA,GAAsC,EAAC,EAC/B;AACR,EAAA,MAAM,EAAA,GAAK,OAAA,CAAQ,UAAA,IAAc,SAAA,CAAU,IAAA;AAC3C,EAAA,MAAM,KAAA,GAAQ,QAAQ,oBAAA,IAAwB,mBAAA;AAC9C,EAAA,MAAM,QAAA,GAAW,QAAQ,uBAAA,IAA2B,6BAAA;AAEpD,EAAA,MAAM,aAAa,SAAA,CAAU,KAAA,CAC1B,GAAA,CAAI,CAAC,MAAM,KAAA,KAAU;AACpB,IAAA,MAAM,OAAO,SAAA,CAAU,KAAA,CAAM,KAAA,GAAQ,CAAC,GAAG,EAAA,IAAM,SAAA;AAC/C,IAAA,OAAO,CAAA,SAAA,EAAY,KAAK,EAAE;AAAA,gBAAA,EACd,IAAA,CAAK,eAAe,kBAAkB;AAAA,kBAAA,EACpC,IAAA,CAAK,iBAAiB,QAAQ;AAAA,oBAAA,EAC5B,IAAA,CAAK,UAAU,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,cAAA,EAM7B,IAAI;AAAA,CAAA;AAAA,EAEhB,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AAEZ,EAAA,OAAO,CAAA;AAAA,yCAAA,EACkC,UAAU,IAAI,CAAA;AAAA;AAAA;AAAA,mBAAA,EAGpC,UAAU,IAAI;AAAA,0BAAA,EACP,SAAA,CAAU,eAAe,kBAAkB;AAAA,aAAA,EACxD,SAAA,CAAU,QAAA,CAAS,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,CAAE,IAAI,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA,IAAK,QAAQ;AAAA,oBAAA,EACnD,SAAA,CAAU,cAAA,CAAe,IAAA,CAAK,IAAI,KAAK,QAAQ;AAAA,oBAAA,EAC/C,SAAA,CAAU,kBAAkB,QAAQ;AAAA;;AAAA;AAAA,0CAAA,EAId,QAAQ,CAAA;AAAA,8BAAA,EACpB,KAAK,CAAA;;AAAA,aAAA,EAEtB,EAAA,CAAG,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAC,CAAA;AAAA,MAAA,EAC5B,IAAA,CAAK,SAAA,CAAU,EAAE,CAAC,CAAA;AAAA;AAAA;AAAA,EAGxB,UAAU;AAAA;AAAA;AAAA,CAAA;AAIZ","file":"codegen.mjs","sourcesContent":["/**\n * PROCEDURE.md → Mastra `workflow.ts` codegen.\n *\n * Reads a procedure doctype + emits a TypeScript file that instantiates a\n * Mastra workflow with one step per procedure step. Branching steps emit\n * conditional resume logic; signature gates suspend via the governance Mastra adapter.\n *\n * Phase 1 scaffolding: outputs a skeleton workflow.ts with TODO markers where\n * signature gates need to wire to @agentproto/governance-mastra primitives.\n */\n\nimport type { ProcedureFrontmatter } from \"@agentproto/agencies/doctypes\"\n\nexport interface ProcedureToWorkflowOptions {\n  /** Workflow id used by Mastra (defaults to procedure slug). */\n  workflowId?: string\n  /** Module specifier for tools used in the workflow (defaults to app's own tools file). */\n  toolsModuleSpecifier?: string\n  /** Module specifier for the agencies bindings (defaults to \"@agentproto/agencies-mastra\"). */\n  bindingsModuleSpecifier?: string\n}\n\n/**\n * Generate a Mastra `workflow.ts` source string from a parsed PROCEDURE.md\n * frontmatter.\n *\n * Phase 1 emits a skeleton with one step stub per procedure step + comments\n * pointing at the canvakit/agency.* templates and the governance suspend hook.\n * Apps customize the generated file then commit it.\n */\nexport function procedureToWorkflow(\n  procedure: ProcedureFrontmatter,\n  options: ProcedureToWorkflowOptions = {}\n): string {\n  const id = options.workflowId ?? procedure.slug\n  const tools = options.toolsModuleSpecifier ?? \"../tools/index.js\"\n  const bindings = options.bindingsModuleSpecifier ?? \"@agentproto/agencies-mastra\"\n\n  const stepBlocks = procedure.steps\n    .map((step, index) => {\n      const next = procedure.steps[index + 1]?.id ?? \"<final>\"\n      return `// Step: ${step.id}\n// description: ${step.description ?? \"(no description)\"}\n// requiredSkill: ${step.requiredSkill ?? \"(none)\"}\n// expected output: ${step.output ?? \"(none)\"}\n//\n// TODO(phase-2): emit a Mastra step (tools[...], inputSchema, outputSchema, execute).\n// If this step has \\`branch\\`, emit conditional resume to one of the branch.action targets.\n// If this step requires signatures, suspend via @agentproto/governance-mastra\n// shouldSuspendForSignatures + resume on signArtifact completion.\n// Next step: ${next}\n`\n    })\n    .join(\"\\n\")\n\n  return `/**\n * AUTO-GENERATED from PROCEDURE.md slug=${procedure.slug} (agentagencies/v1).\n * DO NOT EDIT BY HAND — re-run \\`@agentproto/agencies-mastra\\` codegen if the procedure changes.\n *\n * Procedure name: ${procedure.name}\n * Procedure description: ${procedure.description ?? \"(no description)\"}\n * Triggers: ${procedure.triggers.map(t => t.kind).join(\", \") || \"(none)\"}\n * Required skills: ${procedure.requiredSkills.join(\", \") || \"(none)\"}\n * Autonomy policy: ${procedure.autonomyPolicy ?? \"(none)\"}\n */\n\nimport { createWorkflow } from \"@mastra/core/workflows\" // peer dep\nimport { createGovernanceBindings } from \"${bindings}\"\nimport * as agencyTools from \"${tools}\" // app-provided tool registry\n\nexport const ${id.replace(/-/g, \"_\")}_workflow = createWorkflow({\n  id: ${JSON.stringify(id)},\n  steps: {\n    // ─── steps ──────────────────────────────────────────────────────────\n${stepBlocks}\n  },\n})\n`\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+export { ProcedureToWorkflowOptions, procedureToWorkflow } from './codegen.js';
+import '@agentproto/agencies/doctypes';
+
+/**
+ * @agentproto/agencies-mastra — Mastra adapter for agentagencies/v1.
+ *
+ * Two roles:
+ *   1. **Codegen** (./codegen) — turns a `PROCEDURE.md` into a Mastra `workflow.ts`
+ *      file at build time. Apps run this codegen once per template + commit the
+ *      generated workflow.ts; runtime then registers it with Mastra normally.
+ *
+ *   2. **Runtime** (this entry) — `createAgenciesBindings(config)` returns a
+ *      bag of high-level orchestration helpers (engagement state machine,
+ *      agreement issuer, invoice issuer) that compose the FS-only spec runtime
+ *      with Mastra workflow primitives.
+ *
+ * Phase 1 ships scaffolding + the procedure-to-workflow codegen surface.
+ * Phase 2 wires actual Mastra suspend/resume into the engagement state machine.
+ */
+
+/**
+ * Bind agencies operations to a workspace + governance config.
+ *
+ * Phase 1 returns the input config + governance bindings; Phase 2 will add the
+ * full engagement orchestrator (state machine over ENGAGEMENT.md status).
+ */
+declare function createAgenciesBindings(_config: unknown): unknown;
+
+export { createAgenciesBindings };

package/dist/index.mjs

@@ -0,0 +1,57 @@
+/**
+ * @agentproto/agencies-mastra v0.1.0-alpha
+ * Mastra adapter for agentagencies/v1.
+ */
+
+// src/codegen.ts
+function procedureToWorkflow(procedure, options = {}) {
+  const id = options.workflowId ?? procedure.slug;
+  const tools = options.toolsModuleSpecifier ?? "../tools/index.js";
+  const bindings = options.bindingsModuleSpecifier ?? "@agentproto/agencies-mastra";
+  const stepBlocks = procedure.steps.map((step, index) => {
+    const next = procedure.steps[index + 1]?.id ?? "<final>";
+    return `// Step: ${step.id}
+// description: ${step.description ?? "(no description)"}
+// requiredSkill: ${step.requiredSkill ?? "(none)"}
+// expected output: ${step.output ?? "(none)"}
+//
+// TODO(phase-2): emit a Mastra step (tools[...], inputSchema, outputSchema, execute).
+// If this step has \`branch\`, emit conditional resume to one of the branch.action targets.
+// If this step requires signatures, suspend via @agentproto/governance-mastra
+// shouldSuspendForSignatures + resume on signArtifact completion.
+// Next step: ${next}
+`;
+  }).join("\n");
+  return `/**
+ * AUTO-GENERATED from PROCEDURE.md slug=${procedure.slug} (agentagencies/v1).
+ * DO NOT EDIT BY HAND \u2014 re-run \`@agentproto/agencies-mastra\` codegen if the procedure changes.
+ *
+ * Procedure name: ${procedure.name}
+ * Procedure description: ${procedure.description ?? "(no description)"}
+ * Triggers: ${procedure.triggers.map((t) => t.kind).join(", ") || "(none)"}
+ * Required skills: ${procedure.requiredSkills.join(", ") || "(none)"}
+ * Autonomy policy: ${procedure.autonomyPolicy ?? "(none)"}
+ */
+
+import { createWorkflow } from "@mastra/core/workflows" // peer dep
+import { createGovernanceBindings } from "${bindings}"
+import * as agencyTools from "${tools}" // app-provided tool registry
+
+export const ${id.replace(/-/g, "_")}_workflow = createWorkflow({
+  id: ${JSON.stringify(id)},
+  steps: {
+    // \u2500\u2500\u2500 steps \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+${stepBlocks}
+  },
+})
+`;
+}
+
+// src/index.ts
+function createAgenciesBindings(_config) {
+  return {};
+}
+
+export { createAgenciesBindings, procedureToWorkflow };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codegen.ts","../src/index.ts"],"names":[],"mappings":";;;;;;AA8BO,SAAS,mBAAA,CACd,SAAA,EACA,OAAA,GAAsC,EAAC,EAC/B;AACR,EAAA,MAAM,EAAA,GAAK,OAAA,CAAQ,UAAA,IAAc,SAAA,CAAU,IAAA;AAC3C,EAAA,MAAM,KAAA,GAAQ,QAAQ,oBAAA,IAAwB,mBAAA;AAC9C,EAAA,MAAM,QAAA,GAAW,QAAQ,uBAAA,IAA2B,6BAAA;AAEpD,EAAA,MAAM,aAAa,SAAA,CAAU,KAAA,CAC1B,GAAA,CAAI,CAAC,MAAM,KAAA,KAAU;AACpB,IAAA,MAAM,OAAO,SAAA,CAAU,KAAA,CAAM,KAAA,GAAQ,CAAC,GAAG,EAAA,IAAM,SAAA;AAC/C,IAAA,OAAO,CAAA,SAAA,EAAY,KAAK,EAAE;AAAA,gBAAA,EACd,IAAA,CAAK,eAAe,kBAAkB;AAAA,kBAAA,EACpC,IAAA,CAAK,iBAAiB,QAAQ;AAAA,oBAAA,EAC5B,IAAA,CAAK,UAAU,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,cAAA,EAM7B,IAAI;AAAA,CAAA;AAAA,EAEhB,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AAEZ,EAAA,OAAO,CAAA;AAAA,yCAAA,EACkC,UAAU,IAAI,CAAA;AAAA;AAAA;AAAA,mBAAA,EAGpC,UAAU,IAAI;AAAA,0BAAA,EACP,SAAA,CAAU,eAAe,kBAAkB;AAAA,aAAA,EACxD,SAAA,CAAU,QAAA,CAAS,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,CAAE,IAAI,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA,IAAK,QAAQ;AAAA,oBAAA,EACnD,SAAA,CAAU,cAAA,CAAe,IAAA,CAAK,IAAI,KAAK,QAAQ;AAAA,oBAAA,EAC/C,SAAA,CAAU,kBAAkB,QAAQ;AAAA;;AAAA;AAAA,0CAAA,EAId,QAAQ,CAAA;AAAA,8BAAA,EACpB,KAAK,CAAA;;AAAA,aAAA,EAEtB,EAAA,CAAG,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAC,CAAA;AAAA,MAAA,EAC5B,IAAA,CAAK,SAAA,CAAU,EAAE,CAAC,CAAA;AAAA;AAAA;AAAA,EAGxB,UAAU;AAAA;AAAA;AAAA,CAAA;AAIZ;;;ACpDO,SAAS,uBAAuB,OAAA,EAA2B;AAEhE,EAAA,OAAO,EAAC;AACV","file":"index.mjs","sourcesContent":["/**\n * PROCEDURE.md → Mastra `workflow.ts` codegen.\n *\n * Reads a procedure doctype + emits a TypeScript file that instantiates a\n * Mastra workflow with one step per procedure step. Branching steps emit\n * conditional resume logic; signature gates suspend via the governance Mastra adapter.\n *\n * Phase 1 scaffolding: outputs a skeleton workflow.ts with TODO markers where\n * signature gates need to wire to @agentproto/governance-mastra primitives.\n */\n\nimport type { ProcedureFrontmatter } from \"@agentproto/agencies/doctypes\"\n\nexport interface ProcedureToWorkflowOptions {\n  /** Workflow id used by Mastra (defaults to procedure slug). */\n  workflowId?: string\n  /** Module specifier for tools used in the workflow (defaults to app's own tools file). */\n  toolsModuleSpecifier?: string\n  /** Module specifier for the agencies bindings (defaults to \"@agentproto/agencies-mastra\"). */\n  bindingsModuleSpecifier?: string\n}\n\n/**\n * Generate a Mastra `workflow.ts` source string from a parsed PROCEDURE.md\n * frontmatter.\n *\n * Phase 1 emits a skeleton with one step stub per procedure step + comments\n * pointing at the canvakit/agency.* templates and the governance suspend hook.\n * Apps customize the generated file then commit it.\n */\nexport function procedureToWorkflow(\n  procedure: ProcedureFrontmatter,\n  options: ProcedureToWorkflowOptions = {}\n): string {\n  const id = options.workflowId ?? procedure.slug\n  const tools = options.toolsModuleSpecifier ?? \"../tools/index.js\"\n  const bindings = options.bindingsModuleSpecifier ?? \"@agentproto/agencies-mastra\"\n\n  const stepBlocks = procedure.steps\n    .map((step, index) => {\n      const next = procedure.steps[index + 1]?.id ?? \"<final>\"\n      return `// Step: ${step.id}\n// description: ${step.description ?? \"(no description)\"}\n// requiredSkill: ${step.requiredSkill ?? \"(none)\"}\n// expected output: ${step.output ?? \"(none)\"}\n//\n// TODO(phase-2): emit a Mastra step (tools[...], inputSchema, outputSchema, execute).\n// If this step has \\`branch\\`, emit conditional resume to one of the branch.action targets.\n// If this step requires signatures, suspend via @agentproto/governance-mastra\n// shouldSuspendForSignatures + resume on signArtifact completion.\n// Next step: ${next}\n`\n    })\n    .join(\"\\n\")\n\n  return `/**\n * AUTO-GENERATED from PROCEDURE.md slug=${procedure.slug} (agentagencies/v1).\n * DO NOT EDIT BY HAND — re-run \\`@agentproto/agencies-mastra\\` codegen if the procedure changes.\n *\n * Procedure name: ${procedure.name}\n * Procedure description: ${procedure.description ?? \"(no description)\"}\n * Triggers: ${procedure.triggers.map(t => t.kind).join(\", \") || \"(none)\"}\n * Required skills: ${procedure.requiredSkills.join(\", \") || \"(none)\"}\n * Autonomy policy: ${procedure.autonomyPolicy ?? \"(none)\"}\n */\n\nimport { createWorkflow } from \"@mastra/core/workflows\" // peer dep\nimport { createGovernanceBindings } from \"${bindings}\"\nimport * as agencyTools from \"${tools}\" // app-provided tool registry\n\nexport const ${id.replace(/-/g, \"_\")}_workflow = createWorkflow({\n  id: ${JSON.stringify(id)},\n  steps: {\n    // ─── steps ──────────────────────────────────────────────────────────\n${stepBlocks}\n  },\n})\n`\n}\n","/**\n * @agentproto/agencies-mastra — Mastra adapter for agentagencies/v1.\n *\n * Two roles:\n *   1. **Codegen** (./codegen) — turns a `PROCEDURE.md` into a Mastra `workflow.ts`\n *      file at build time. Apps run this codegen once per template + commit the\n *      generated workflow.ts; runtime then registers it with Mastra normally.\n *\n *   2. **Runtime** (this entry) — `createAgenciesBindings(config)` returns a\n *      bag of high-level orchestration helpers (engagement state machine,\n *      agreement issuer, invoice issuer) that compose the FS-only spec runtime\n *      with Mastra workflow primitives.\n *\n * Phase 1 ships scaffolding + the procedure-to-workflow codegen surface.\n * Phase 2 wires actual Mastra suspend/resume into the engagement state machine.\n */\n\nexport type { ProcedureToWorkflowOptions } from \"./codegen.js\"\nexport { procedureToWorkflow } from \"./codegen.js\"\n\n/**\n * Bind agencies operations to a workspace + governance config.\n *\n * Phase 1 returns the input config + governance bindings; Phase 2 will add the\n * full engagement orchestrator (state machine over ENGAGEMENT.md status).\n */\nexport function createAgenciesBindings(_config: unknown): unknown {\n  // TODO(phase-2): full engagement orchestrator with Mastra workflow integration.\n  return {}\n}\n"]}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@agentproto/agencies-mastra",
+  "version": "0.1.0-alpha.0",
+  "description": "Mastra adapter for agentagencies/v1 — PROCEDURE.md → Mastra workflow.ts codegen, engagement orchestrator, Mastra-flavored agencies tools.",
+  "keywords": [
+    "agentagencies",
+    "agencies",
+    "mastra",
+    "adapter",
+    "procedure",
+    "workflow",
+    "codegen"
+  ],
+  "homepage": "https://agentproto.sh/docs/agp-1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/agencies/mastra"
+  },
+  "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"
+    },
+    "./codegen": {
+      "types": "./dist/codegen.d.ts",
+      "import": "./dist/codegen.mjs",
+      "default": "./dist/codegen.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@agentproto/agencies": "0.1.0-alpha.0",
+    "@agentproto/governance": "0.1.0-alpha.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": "*"
+  },
+  "peerDependenciesMeta": {
+    "@mastra/core": {
+      "optional": true
+    }
+  },
+  "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"
+  }
+}