@agentproto/mastra 0.1.1 → 0.2.1

package/dist/index.d.ts

@@ -15,4 +15,8 @@
 export { buildMastraAgent } from "./build-agent.js";
 export { composeInstructions } from "./instructions.js";
 export type { BuildMastraAgentOptions, BuildMastraAgentResult, ModelResolver, ToolResolver, WorkflowResolver, MemoryBuilder, VoiceBuilder, InstructionsFormatter, LanguageModelLike, MastraToolLike, MastraMemoryLike, MastraVoiceLike, MastraWorkflowLike, AgentHandle, AnyRef, ActionRef, ModelRef, MemoryConfig, } from "./types.js";
+export { makePlaybookOverlayProcessor } from "./playbook-overlay-processor.js";
+export type { PlaybookOverlayProcessorOptions } from "./playbook-overlay-processor.js";
+export { makeQueryKnowledgeTool } from "./tools/query-knowledge.js";
+export type { QueryKnowledgeToolOptions, QueryKnowledgeTool, QueryKnowledgeInput, } from "./tools/query-knowledge.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,MAAM,EACN,SAAS,EACT,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,MAAM,EACN,SAAS,EACT,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAA;AAInB,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAA;AAC9E,YAAY,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAA;AAGtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,YAAY,EACV,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,4BAA4B,CAAA"}

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { Agent } from '@mastra/core/agent';
+import { OperatorOverlayResolver, renderOverlays } from '@agentproto/corpus';
 
 /**
  * @agentproto/mastra v0.1.0-alpha
@@ -150,7 +151,69 @@ function stripOwner(id) {
   const m = id.match(/^@[^/]+\/(.+)$/);
   return m ? m[1] : id;
 }
+function systemNote(text, id) {
+  return {
+    id,
+    role: "system",
+    createdAt: /* @__PURE__ */ new Date(),
+    content: { format: 2, parts: [{ type: "text", text }], content: text }
+  };
+}
+function makePlaybookOverlayProcessor(opts) {
+  return {
+    id: "playbook-overlay",
+    name: "PlaybookOverlay",
+    description: "Splices active AIP-12 playbook overlays bound to the running operator into the prompt as a system note",
+    async processInput(args) {
+      const { requestContext } = args;
+      const scopeId = opts.getScopeId(requestContext);
+      if (!scopeId) return args.messages;
+      const dimensions = opts.getDimensions?.(requestContext);
+      const operatorSlug = opts.getOperatorSlug?.(requestContext) ?? "";
+      const conversationId = opts.getConversationId?.(requestContext);
+      if (!operatorSlug && !dimensions) return args.messages;
+      try {
+        const registry = await opts.host.getPlaybookRegistry(scopeId);
+        const result = new OperatorOverlayResolver(registry).resolve({
+          operatorSlug,
+          ...dimensions ? { dimensions } : {},
+          ...conversationId ? { conversationId } : {}
+        });
+        const { appendBlock } = renderOverlays(result);
+        if (!appendBlock) return args.messages;
+        const note = "Operating playbooks in effect (active SOPs \u2014 follow them; they override your defaults where they conflict):\n\n" + appendBlock;
+        return [systemNote(note, `playbook-overlay-${Date.now()}`), ...args.messages];
+      } catch (error) {
+        console.warn(
+          "[playbook-overlay] resolve failed; skipping injection:",
+          error instanceof Error ? error.message : error
+        );
+        return args.messages;
+      }
+    }
+  };
+}
+
+// src/tools/query-knowledge.ts
+function makeQueryKnowledgeTool(opts) {
+  return {
+    name: "query_knowledge",
+    tool: {
+      id: "corpus:query_knowledge",
+      description: "Query the attached knowledge base for entries matching the given tags or text query.",
+      execute: async (input, context) => {
+        const scopeId = opts.getScopeId(context);
+        if (!scopeId) return [];
+        const dimensions = opts.getDimensions?.(context);
+        const q = {
+          ...input.tags && input.tags.length > 0 ? { tags: input.tags } : {}
+        };
+        return opts.host.resolveKnowledgeEntries(scopeId, q, dimensions);
+      }
+    }
+  };
+}
 
-export { buildMastraAgent, composeInstructions };
+export { buildMastraAgent, composeInstructions, makePlaybookOverlayProcessor, makeQueryKnowledgeTool };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/instructions.ts","../src/build-agent.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Default instructions composer.\n *\n * AIP-42 says the markdown body of an AGENT.md is the agent's primary\n * system prompt. Boundaries, persona inline content, and trait scores\n * are appended in that order so the body — the human-authored part —\n * stays at the top where the model sees it first.\n */\n\nimport type { AgentHandle } from \"@agentproto/agent\"\n\nconst HEADER_RULE = \"Hard rules — these MUST be followed:\"\n\n/**\n * Compose the AGENT.md body + structural fields into a system prompt.\n *\n * Order:\n *   1. body (markdown after frontmatter), or `description` if absent\n *   2. inline persona block (when `persona` is `{ inline: ... }`)\n *   3. boundaries (rendered as a bulleted \"hard rules\" block)\n *   4. traits (rendered as a one-line guidance hint when present)\n *\n * Refs (`persona: \"@some/persona\"`) are NOT inlined — the host is\n * expected to resolve them externally and inject them via\n * `formatInstructions` if it cares, or pre-resolve and pass the\n * resolved body in via `body:`.\n */\nexport function composeInstructions(\n  handle: AgentHandle,\n  body: string | undefined,\n): string {\n  const parts: string[] = []\n  parts.push(body?.trim() ?? handle.description.trim())\n\n  const personaInline = extractPersonaInline(handle)\n  if (personaInline) parts.push(personaInline)\n\n  if (handle.boundaries && handle.boundaries.length > 0) {\n    const lines = handle.boundaries.map((b) => `- ${b}`).join(\"\\n\")\n    parts.push(`${HEADER_RULE}\\n${lines}`)\n  }\n\n  if (handle.traits && Object.keys(handle.traits).length > 0) {\n    parts.push(traitsLine(handle.traits))\n  }\n\n  return parts.filter((s) => s.length > 0).join(\"\\n\\n\")\n}\n\nfunction extractPersonaInline(handle: AgentHandle): string | undefined {\n  const p = handle.persona\n  if (!p || typeof p === \"string\") return undefined\n  if (typeof p !== \"object\" || p === null || !(\"inline\" in p)) return undefined\n  const inline = (p as { inline?: Record<string, unknown> }).inline\n  if (!inline) return undefined\n  const lines: string[] = []\n  if (typeof inline.name === \"string\") lines.push(`Name: ${inline.name}`)\n  if (typeof inline.tone === \"string\") lines.push(`Tone: ${inline.tone}`)\n  if (Array.isArray(inline.values)) {\n    lines.push(`Values: ${inline.values.join(\", \")}`)\n  }\n  if (typeof inline.bio === \"string\") lines.push(inline.bio)\n  return lines.length > 0 ? `Persona\\n${lines.join(\"\\n\")}` : undefined\n}\n\nfunction traitsLine(traits: Record<string, number>): string {\n  const formatted = Object.entries(traits)\n    .map(([k, v]) => `${k}=${v}`)\n    .join(\", \")\n  return `Trait scores (0-10): ${formatted}.`\n}\n","/**\n * `buildMastraAgent(handle, opts)` — turn an AIP-42 AGENT.md handle\n * into a runnable `new Agent({ ... })` from `@mastra/core/agent`.\n *\n * The function is intentionally narrow: it walks the manifest's\n * structural fields and calls user-supplied resolvers for everything\n * that needs runtime knowledge (model, tools, workflows, memory,\n * voice). Anything the resolvers can't translate is either dropped\n * with a warning (default) or throws (`strict: true`).\n */\n\nimport { Agent } from \"@mastra/core/agent\"\nimport type { AgentHandle, AnyRef } from \"@agentproto/agent\"\nimport { composeInstructions } from \"./instructions.js\"\nimport type {\n  BuildMastraAgentOptions,\n  BuildMastraAgentResult,\n  ToolResolver,\n  WorkflowResolver,\n  MastraToolLike,\n} from \"./types.js\"\n\nexport async function buildMastraAgent(\n  handle: AgentHandle,\n  opts: BuildMastraAgentOptions,\n): Promise<BuildMastraAgentResult> {\n  const formatInstructions = opts.formatInstructions ?? composeInstructions\n  const instructions = formatInstructions(handle, opts.body)\n  const model = await opts.resolveModel(handle.model)\n\n  const { tools, resolvedTools, droppedTools } = await resolveTools(\n    handle.tools,\n    opts.resolveTool,\n    { strict: opts.strict ?? false, agentId: handle.id },\n  )\n\n  const { resolvedWorkflows, droppedWorkflows } = await resolveWorkflows(\n    handle.workflows,\n    opts.resolveWorkflow,\n    { strict: opts.strict ?? false, agentId: handle.id },\n  )\n\n  const memory = opts.buildMemory && handle.memory\n    ? await opts.buildMemory(handle.memory)\n    : undefined\n\n  const voice = opts.buildVoice ? await opts.buildVoice(handle) : undefined\n\n  const name = opts.name ?? stripOwner(handle.id)\n  const id = opts.id ?? handle.id\n\n  // Mastra's Agent ctor types are heterogeneous (model union, tools\n  // record etc.) and have generic-variance issues that leak through\n  // structuredOutput inference; we widen at both ends so the package\n  // stays independent of @mastra/core's internal generic shape.\n  const agent = new Agent({\n    name,\n    id,\n    instructions,\n    model,\n    tools,\n    memory,\n    voice,\n  } as unknown as ConstructorParameters<typeof Agent>[0]) as unknown as Agent\n\n  return {\n    agent,\n    resolvedTools,\n    droppedTools,\n    resolvedWorkflows,\n    droppedWorkflows,\n    instructions,\n  }\n}\n\ninterface ResolveToolsCtx {\n  strict: boolean\n  agentId: string\n}\n\nasync function resolveTools(\n  refs: AnyRef[] | undefined,\n  resolve: ToolResolver | undefined,\n  ctx: ResolveToolsCtx,\n): Promise<{\n  tools: Record<string, MastraToolLike>\n  resolvedTools: string[]\n  droppedTools: string[]\n}> {\n  const tools: Record<string, MastraToolLike> = {}\n  const resolvedTools: string[] = []\n  const droppedTools: string[] = []\n\n  if (!refs || refs.length === 0) return { tools, resolvedTools, droppedTools }\n\n  if (!resolve) {\n    if (ctx.strict) {\n      throw new Error(\n        `buildMastraAgent: agent '${ctx.agentId}' declares ${refs.length} tool(s) but no resolveTool was provided`,\n      )\n    }\n    console.warn(\n      `[@agentproto/mastra] agent '${ctx.agentId}' declares ${refs.length} tool(s) but no resolveTool was provided — skipping`,\n    )\n    refs.forEach((r) => droppedTools.push(refKey(r)))\n    return { tools, resolvedTools, droppedTools }\n  }\n\n  for (const ref of refs) {\n    const resolved = await resolve(ref)\n    if (!resolved) {\n      droppedTools.push(refKey(ref))\n      if (ctx.strict) {\n        throw new Error(\n          `buildMastraAgent: agent '${ctx.agentId}' tool '${refKey(ref)}' did not resolve`,\n        )\n      }\n      console.warn(\n        `[@agentproto/mastra] agent '${ctx.agentId}' tool '${refKey(ref)}' did not resolve — skipping`,\n      )\n      continue\n    }\n    tools[resolved.name] = resolved.tool\n    resolvedTools.push(resolved.name)\n  }\n\n  return { tools, resolvedTools, droppedTools }\n}\n\nasync function resolveWorkflows(\n  refs: AnyRef[] | undefined,\n  resolve: WorkflowResolver | undefined,\n  ctx: ResolveToolsCtx,\n): Promise<{ resolvedWorkflows: string[]; droppedWorkflows: string[] }> {\n  const resolvedWorkflows: string[] = []\n  const droppedWorkflows: string[] = []\n\n  if (!refs || refs.length === 0) {\n    return { resolvedWorkflows, droppedWorkflows }\n  }\n  if (!resolve) {\n    refs.forEach((r) => droppedWorkflows.push(refKey(r)))\n    return { resolvedWorkflows, droppedWorkflows }\n  }\n\n  for (const ref of refs) {\n    const resolved = await resolve(ref)\n    if (!resolved) {\n      droppedWorkflows.push(refKey(ref))\n      if (ctx.strict) {\n        throw new Error(\n          `buildMastraAgent: agent '${ctx.agentId}' workflow '${refKey(ref)}' did not resolve`,\n        )\n      }\n      continue\n    }\n    resolvedWorkflows.push(resolved.name)\n  }\n\n  return { resolvedWorkflows, droppedWorkflows }\n}\n\nfunction refKey(ref: AnyRef): string {\n  if (typeof ref === \"string\") return ref\n  return ref.ref ?? ref.file ?? JSON.stringify(ref.inline ?? ref)\n}\n\nfunction stripOwner(id: string): string {\n  // `@agentik/writer` → `writer`; bare ids untouched.\n  const m = id.match(/^@[^/]+\\/(.+)$/)\n  return m ? m[1]! : id\n}\n"]}
+{"version":3,"sources":["../src/instructions.ts","../src/build-agent.ts","../src/playbook-overlay-processor.ts","../src/tools/query-knowledge.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Default instructions composer.\n *\n * AIP-42 says the markdown body of an AGENT.md is the agent's primary\n * system prompt. Boundaries, persona inline content, and trait scores\n * are appended in that order so the body — the human-authored part —\n * stays at the top where the model sees it first.\n */\n\nimport type { AgentHandle } from \"@agentproto/agent\"\n\nconst HEADER_RULE = \"Hard rules — these MUST be followed:\"\n\n/**\n * Compose the AGENT.md body + structural fields into a system prompt.\n *\n * Order:\n *   1. body (markdown after frontmatter), or `description` if absent\n *   2. inline persona block (when `persona` is `{ inline: ... }`)\n *   3. boundaries (rendered as a bulleted \"hard rules\" block)\n *   4. traits (rendered as a one-line guidance hint when present)\n *\n * Refs (`persona: \"@some/persona\"`) are NOT inlined — the host is\n * expected to resolve them externally and inject them via\n * `formatInstructions` if it cares, or pre-resolve and pass the\n * resolved body in via `body:`.\n */\nexport function composeInstructions(\n  handle: AgentHandle,\n  body: string | undefined,\n): string {\n  const parts: string[] = []\n  parts.push(body?.trim() ?? handle.description.trim())\n\n  const personaInline = extractPersonaInline(handle)\n  if (personaInline) parts.push(personaInline)\n\n  if (handle.boundaries && handle.boundaries.length > 0) {\n    const lines = handle.boundaries.map((b) => `- ${b}`).join(\"\\n\")\n    parts.push(`${HEADER_RULE}\\n${lines}`)\n  }\n\n  if (handle.traits && Object.keys(handle.traits).length > 0) {\n    parts.push(traitsLine(handle.traits))\n  }\n\n  return parts.filter((s) => s.length > 0).join(\"\\n\\n\")\n}\n\nfunction extractPersonaInline(handle: AgentHandle): string | undefined {\n  const p = handle.persona\n  if (!p || typeof p === \"string\") return undefined\n  if (typeof p !== \"object\" || p === null || !(\"inline\" in p)) return undefined\n  const inline = (p as { inline?: Record<string, unknown> }).inline\n  if (!inline) return undefined\n  const lines: string[] = []\n  if (typeof inline.name === \"string\") lines.push(`Name: ${inline.name}`)\n  if (typeof inline.tone === \"string\") lines.push(`Tone: ${inline.tone}`)\n  if (Array.isArray(inline.values)) {\n    lines.push(`Values: ${inline.values.join(\", \")}`)\n  }\n  if (typeof inline.bio === \"string\") lines.push(inline.bio)\n  return lines.length > 0 ? `Persona\\n${lines.join(\"\\n\")}` : undefined\n}\n\nfunction traitsLine(traits: Record<string, number>): string {\n  const formatted = Object.entries(traits)\n    .map(([k, v]) => `${k}=${v}`)\n    .join(\", \")\n  return `Trait scores (0-10): ${formatted}.`\n}\n","/**\n * `buildMastraAgent(handle, opts)` — turn an AIP-42 AGENT.md handle\n * into a runnable `new Agent({ ... })` from `@mastra/core/agent`.\n *\n * The function is intentionally narrow: it walks the manifest's\n * structural fields and calls user-supplied resolvers for everything\n * that needs runtime knowledge (model, tools, workflows, memory,\n * voice). Anything the resolvers can't translate is either dropped\n * with a warning (default) or throws (`strict: true`).\n */\n\nimport { Agent } from \"@mastra/core/agent\"\nimport type { AgentHandle, AnyRef } from \"@agentproto/agent\"\nimport { composeInstructions } from \"./instructions.js\"\nimport type {\n  BuildMastraAgentOptions,\n  BuildMastraAgentResult,\n  ToolResolver,\n  WorkflowResolver,\n  MastraToolLike,\n} from \"./types.js\"\n\nexport async function buildMastraAgent(\n  handle: AgentHandle,\n  opts: BuildMastraAgentOptions,\n): Promise<BuildMastraAgentResult> {\n  const formatInstructions = opts.formatInstructions ?? composeInstructions\n  const instructions = formatInstructions(handle, opts.body)\n  const model = await opts.resolveModel(handle.model)\n\n  const { tools, resolvedTools, droppedTools } = await resolveTools(\n    handle.tools,\n    opts.resolveTool,\n    { strict: opts.strict ?? false, agentId: handle.id },\n  )\n\n  const { resolvedWorkflows, droppedWorkflows } = await resolveWorkflows(\n    handle.workflows,\n    opts.resolveWorkflow,\n    { strict: opts.strict ?? false, agentId: handle.id },\n  )\n\n  const memory = opts.buildMemory && handle.memory\n    ? await opts.buildMemory(handle.memory)\n    : undefined\n\n  const voice = opts.buildVoice ? await opts.buildVoice(handle) : undefined\n\n  const name = opts.name ?? stripOwner(handle.id)\n  const id = opts.id ?? handle.id\n\n  // Mastra's Agent ctor types are heterogeneous (model union, tools\n  // record etc.) and have generic-variance issues that leak through\n  // structuredOutput inference; we widen at both ends so the package\n  // stays independent of @mastra/core's internal generic shape.\n  const agent = new Agent({\n    name,\n    id,\n    instructions,\n    model,\n    tools,\n    memory,\n    voice,\n  } as unknown as ConstructorParameters<typeof Agent>[0]) as unknown as Agent\n\n  return {\n    agent,\n    resolvedTools,\n    droppedTools,\n    resolvedWorkflows,\n    droppedWorkflows,\n    instructions,\n  }\n}\n\ninterface ResolveToolsCtx {\n  strict: boolean\n  agentId: string\n}\n\nasync function resolveTools(\n  refs: AnyRef[] | undefined,\n  resolve: ToolResolver | undefined,\n  ctx: ResolveToolsCtx,\n): Promise<{\n  tools: Record<string, MastraToolLike>\n  resolvedTools: string[]\n  droppedTools: string[]\n}> {\n  const tools: Record<string, MastraToolLike> = {}\n  const resolvedTools: string[] = []\n  const droppedTools: string[] = []\n\n  if (!refs || refs.length === 0) return { tools, resolvedTools, droppedTools }\n\n  if (!resolve) {\n    if (ctx.strict) {\n      throw new Error(\n        `buildMastraAgent: agent '${ctx.agentId}' declares ${refs.length} tool(s) but no resolveTool was provided`,\n      )\n    }\n    console.warn(\n      `[@agentproto/mastra] agent '${ctx.agentId}' declares ${refs.length} tool(s) but no resolveTool was provided — skipping`,\n    )\n    refs.forEach((r) => droppedTools.push(refKey(r)))\n    return { tools, resolvedTools, droppedTools }\n  }\n\n  for (const ref of refs) {\n    const resolved = await resolve(ref)\n    if (!resolved) {\n      droppedTools.push(refKey(ref))\n      if (ctx.strict) {\n        throw new Error(\n          `buildMastraAgent: agent '${ctx.agentId}' tool '${refKey(ref)}' did not resolve`,\n        )\n      }\n      console.warn(\n        `[@agentproto/mastra] agent '${ctx.agentId}' tool '${refKey(ref)}' did not resolve — skipping`,\n      )\n      continue\n    }\n    tools[resolved.name] = resolved.tool\n    resolvedTools.push(resolved.name)\n  }\n\n  return { tools, resolvedTools, droppedTools }\n}\n\nasync function resolveWorkflows(\n  refs: AnyRef[] | undefined,\n  resolve: WorkflowResolver | undefined,\n  ctx: ResolveToolsCtx,\n): Promise<{ resolvedWorkflows: string[]; droppedWorkflows: string[] }> {\n  const resolvedWorkflows: string[] = []\n  const droppedWorkflows: string[] = []\n\n  if (!refs || refs.length === 0) {\n    return { resolvedWorkflows, droppedWorkflows }\n  }\n  if (!resolve) {\n    refs.forEach((r) => droppedWorkflows.push(refKey(r)))\n    return { resolvedWorkflows, droppedWorkflows }\n  }\n\n  for (const ref of refs) {\n    const resolved = await resolve(ref)\n    if (!resolved) {\n      droppedWorkflows.push(refKey(ref))\n      if (ctx.strict) {\n        throw new Error(\n          `buildMastraAgent: agent '${ctx.agentId}' workflow '${refKey(ref)}' did not resolve`,\n        )\n      }\n      continue\n    }\n    resolvedWorkflows.push(resolved.name)\n  }\n\n  return { resolvedWorkflows, droppedWorkflows }\n}\n\nfunction refKey(ref: AnyRef): string {\n  if (typeof ref === \"string\") return ref\n  return ref.ref ?? ref.file ?? JSON.stringify(ref.inline ?? ref)\n}\n\nfunction stripOwner(id: string): string {\n  // `@agentik/writer` → `writer`; bare ids untouched.\n  const m = id.match(/^@[^/]+\\/(.+)$/)\n  return m ? m[1]! : id\n}\n","/**\n * makePlaybookOverlayProcessor — portable Mastra InputProcessor factory.\n *\n * Parameterized on a `CorpusHost` and request-context extractors so it\n * can run in any Mastra app without assuming Guilde's request context\n * shape. Guilde's `guildePlaybookOverlayProcessor` can become a thin\n * wrapper: call this factory with extractors that read from\n * `asGuildeRequestContext`.\n *\n * Before each agent turn it:\n *   1. Extracts scopeId + dimensions from the request context.\n *   2. Fetches the PlaybookRegistry for the scope via the host.\n *   3. Resolves active (and deterministically-sampled shadow) overlays\n *      via OperatorOverlayResolver.\n *   4. Prepends them as a system note. Best-effort: any failure skips\n *      injection rather than failing the turn.\n */\n\nimport type { InputProcessor, ProcessInputArgs, ProcessInputResult } from \"@mastra/core/processors\"\nimport type { MastraDBMessage } from \"@mastra/core/agent/message-list\"\nimport { OperatorOverlayResolver, renderOverlays } from \"@agentproto/corpus\"\nimport type { CorpusHost, Dimensions } from \"@agentproto/corpus\"\n\nfunction systemNote(text: string, id: string): MastraDBMessage {\n  return {\n    id,\n    role: \"system\",\n    createdAt: new Date(),\n    content: { format: 2, parts: [{ type: \"text\", text }], content: text },\n  }\n}\n\nexport interface PlaybookOverlayProcessorOptions {\n  /** The corpus host that owns per-scope FsPorts and the StackResolver. */\n  readonly host: CorpusHost\n  /**\n   * Extract a stable scope ID (e.g. guild id, workspace id) from the\n   * Mastra request context. Return `undefined` to skip injection for\n   * this request.\n   */\n  readonly getScopeId: (requestContext: unknown) => string | undefined\n  /**\n   * Extract the operator's dimension bag (identity/role/position/capability\n   * + any host-registered axes) from the request context. Used for\n   * selector matching. Optional — falls back to operatorSlug-only matching.\n   */\n  readonly getDimensions?: (requestContext: unknown) => Dimensions | undefined\n  /**\n   * Extract the operator slug for the resolver's `operatorSlug` field.\n   * The slug is used as a fallback when `getDimensions` is absent or\n   * returns nothing.\n   */\n  readonly getOperatorSlug?: (requestContext: unknown) => string | undefined\n  /**\n   * Extract a stable conversation id for deterministic shadow-traffic\n   * sampling. Optional — without it shadow playbooks never fire.\n   */\n  readonly getConversationId?: (requestContext: unknown) => string | undefined\n}\n\n/**\n * Factory that creates a Mastra `InputProcessor` for AIP-12 playbook\n * overlay injection. Wire this into `new Agent({ inputProcessors: [...] })`\n * or add it via Mastra's agent-level processor registry.\n */\nexport function makePlaybookOverlayProcessor(\n  opts: PlaybookOverlayProcessorOptions\n): InputProcessor {\n  return {\n    id: \"playbook-overlay\",\n    name: \"PlaybookOverlay\",\n    description:\n      \"Splices active AIP-12 playbook overlays bound to the running operator into the prompt as a system note\",\n\n    async processInput(args: ProcessInputArgs): Promise<ProcessInputResult> {\n      const { requestContext } = args\n      const scopeId = opts.getScopeId(requestContext)\n      if (!scopeId) return args.messages\n\n      const dimensions = opts.getDimensions?.(requestContext)\n      const operatorSlug = opts.getOperatorSlug?.(requestContext) ?? \"\"\n      const conversationId = opts.getConversationId?.(requestContext)\n\n      // If we have no slug and no dimensions, nothing to match against.\n      if (!operatorSlug && !dimensions) return args.messages\n\n      try {\n        const registry = await opts.host.getPlaybookRegistry(scopeId)\n        const result = new OperatorOverlayResolver(registry).resolve({\n          operatorSlug,\n          ...(dimensions ? { dimensions } : {}),\n          ...(conversationId ? { conversationId } : {}),\n        })\n        const { appendBlock } = renderOverlays(result)\n        if (!appendBlock) return args.messages\n\n        const note =\n          \"Operating playbooks in effect (active SOPs — follow them; \" +\n          \"they override your defaults where they conflict):\\n\\n\" +\n          appendBlock\n        return [systemNote(note, `playbook-overlay-${Date.now()}`), ...args.messages]\n      } catch (error) {\n        console.warn(\n          \"[playbook-overlay] resolve failed; skipping injection:\",\n          error instanceof Error ? error.message : error\n        )\n        return args.messages\n      }\n    },\n  }\n}\n","/**\n * makeQueryKnowledgeTool — tool factory for on-demand knowledge recall.\n *\n * Returns a `{ name, tool }` pair where `tool` is a Mastra-compatible\n * object (id / description / execute) closed over a `CorpusHost`. Pass\n * the result directly as a resolved tool in `buildMastraAgent`'s\n * `resolveTool` callback, or register it in your tool catalog.\n *\n * The `execute` function is also directly testable without a running\n * Mastra agent — it just calls `host.resolveKnowledgeEntries`.\n */\n\nimport type { CorpusHost, CorpusEntryQuery, ResolvedEntry, Dimensions } from \"@agentproto/corpus\"\n\nexport interface QueryKnowledgeToolOptions {\n  readonly host: CorpusHost\n  /** Extract the scope id from the Mastra tool execution context. */\n  readonly getScopeId: (context: unknown) => string | undefined\n  /** Optionally extract dimensions to influence stack resolution. */\n  readonly getDimensions?: (context: unknown) => Dimensions | undefined\n}\n\nexport interface QueryKnowledgeInput {\n  /** Match entries sharing any of these tags. */\n  readonly tags?: string[]\n  /** Free-text query (currently passed as a tag hint; semantic search TBD). */\n  readonly query?: string\n}\n\nexport interface QueryKnowledgeTool {\n  readonly name: string\n  readonly tool: {\n    readonly id: string\n    readonly description: string\n    execute(\n      input: QueryKnowledgeInput,\n      context: unknown\n    ): Promise<readonly ResolvedEntry[]>\n  }\n}\n\n/**\n * Create a `query_knowledge` tool that resolves entries from the\n * `CorpusHost` for the request's scope. Wire into `buildMastraAgent`\n * via `resolveTool` when a corpus host is available:\n *\n * ```ts\n * const kbTool = makeQueryKnowledgeTool({ host, getScopeId })\n * buildMastraAgent(handle, {\n *   resolveTool: (ref) =>\n *     ref === \"corpus:query_knowledge\" ? kbTool : undefined,\n *   ...\n * })\n * ```\n */\nexport function makeQueryKnowledgeTool(\n  opts: QueryKnowledgeToolOptions\n): QueryKnowledgeTool {\n  return {\n    name: \"query_knowledge\",\n    tool: {\n      id: \"corpus:query_knowledge\",\n      description:\n        \"Query the attached knowledge base for entries matching the given tags or text query.\",\n      execute: async (input, context) => {\n        const scopeId = opts.getScopeId(context)\n        if (!scopeId) return []\n        const dimensions = opts.getDimensions?.(context)\n        const q: CorpusEntryQuery = {\n          ...(input.tags && input.tags.length > 0 ? { tags: input.tags } : {}),\n        }\n        return opts.host.resolveKnowledgeEntries(scopeId, q, dimensions)\n      },\n    },\n  }\n}\n"]}

package/dist/playbook-overlay-processor.d.ts

@@ -0,0 +1,53 @@
+/**
+ * makePlaybookOverlayProcessor — portable Mastra InputProcessor factory.
+ *
+ * Parameterized on a `CorpusHost` and request-context extractors so it
+ * can run in any Mastra app without assuming Guilde's request context
+ * shape. Guilde's `guildePlaybookOverlayProcessor` can become a thin
+ * wrapper: call this factory with extractors that read from
+ * `asGuildeRequestContext`.
+ *
+ * Before each agent turn it:
+ *   1. Extracts scopeId + dimensions from the request context.
+ *   2. Fetches the PlaybookRegistry for the scope via the host.
+ *   3. Resolves active (and deterministically-sampled shadow) overlays
+ *      via OperatorOverlayResolver.
+ *   4. Prepends them as a system note. Best-effort: any failure skips
+ *      injection rather than failing the turn.
+ */
+import type { InputProcessor } from "@mastra/core/processors";
+import type { CorpusHost, Dimensions } from "@agentproto/corpus";
+export interface PlaybookOverlayProcessorOptions {
+    /** The corpus host that owns per-scope FsPorts and the StackResolver. */
+    readonly host: CorpusHost;
+    /**
+     * Extract a stable scope ID (e.g. guild id, workspace id) from the
+     * Mastra request context. Return `undefined` to skip injection for
+     * this request.
+     */
+    readonly getScopeId: (requestContext: unknown) => string | undefined;
+    /**
+     * Extract the operator's dimension bag (identity/role/position/capability
+     * + any host-registered axes) from the request context. Used for
+     * selector matching. Optional — falls back to operatorSlug-only matching.
+     */
+    readonly getDimensions?: (requestContext: unknown) => Dimensions | undefined;
+    /**
+     * Extract the operator slug for the resolver's `operatorSlug` field.
+     * The slug is used as a fallback when `getDimensions` is absent or
+     * returns nothing.
+     */
+    readonly getOperatorSlug?: (requestContext: unknown) => string | undefined;
+    /**
+     * Extract a stable conversation id for deterministic shadow-traffic
+     * sampling. Optional — without it shadow playbooks never fire.
+     */
+    readonly getConversationId?: (requestContext: unknown) => string | undefined;
+}
+/**
+ * Factory that creates a Mastra `InputProcessor` for AIP-12 playbook
+ * overlay injection. Wire this into `new Agent({ inputProcessors: [...] })`
+ * or add it via Mastra's agent-level processor registry.
+ */
+export declare function makePlaybookOverlayProcessor(opts: PlaybookOverlayProcessorOptions): InputProcessor;
+//# sourceMappingURL=playbook-overlay-processor.d.ts.map

package/dist/playbook-overlay-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-overlay-processor.d.ts","sourceRoot":"","sources":["../src/playbook-overlay-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAwC,MAAM,yBAAyB,CAAA;AAGnG,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAWhE,MAAM,WAAW,+BAA+B;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAA;IACpE;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,UAAU,GAAG,SAAS,CAAA;IAC5E;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAA;IAC1E;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAA;CAC7E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,+BAA+B,GACpC,cAAc,CA2ChB"}

package/dist/tools/query-knowledge.d.ts

@@ -0,0 +1,49 @@
+/**
+ * makeQueryKnowledgeTool — tool factory for on-demand knowledge recall.
+ *
+ * Returns a `{ name, tool }` pair where `tool` is a Mastra-compatible
+ * object (id / description / execute) closed over a `CorpusHost`. Pass
+ * the result directly as a resolved tool in `buildMastraAgent`'s
+ * `resolveTool` callback, or register it in your tool catalog.
+ *
+ * The `execute` function is also directly testable without a running
+ * Mastra agent — it just calls `host.resolveKnowledgeEntries`.
+ */
+import type { CorpusHost, ResolvedEntry, Dimensions } from "@agentproto/corpus";
+export interface QueryKnowledgeToolOptions {
+    readonly host: CorpusHost;
+    /** Extract the scope id from the Mastra tool execution context. */
+    readonly getScopeId: (context: unknown) => string | undefined;
+    /** Optionally extract dimensions to influence stack resolution. */
+    readonly getDimensions?: (context: unknown) => Dimensions | undefined;
+}
+export interface QueryKnowledgeInput {
+    /** Match entries sharing any of these tags. */
+    readonly tags?: string[];
+    /** Free-text query (currently passed as a tag hint; semantic search TBD). */
+    readonly query?: string;
+}
+export interface QueryKnowledgeTool {
+    readonly name: string;
+    readonly tool: {
+        readonly id: string;
+        readonly description: string;
+        execute(input: QueryKnowledgeInput, context: unknown): Promise<readonly ResolvedEntry[]>;
+    };
+}
+/**
+ * Create a `query_knowledge` tool that resolves entries from the
+ * `CorpusHost` for the request's scope. Wire into `buildMastraAgent`
+ * via `resolveTool` when a corpus host is available:
+ *
+ * ```ts
+ * const kbTool = makeQueryKnowledgeTool({ host, getScopeId })
+ * buildMastraAgent(handle, {
+ *   resolveTool: (ref) =>
+ *     ref === "corpus:query_knowledge" ? kbTool : undefined,
+ *   ...
+ * })
+ * ```
+ */
+export declare function makeQueryKnowledgeTool(opts: QueryKnowledgeToolOptions): QueryKnowledgeTool;
+//# sourceMappingURL=query-knowledge.d.ts.map

package/dist/tools/query-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/query-knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAoB,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEjG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAA;IAC7D,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,UAAU,GAAG,SAAS,CAAA;CACtE;AAED,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,OAAO,CACL,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAA;KACrC,CAAA;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,yBAAyB,GAC9B,kBAAkB,CAkBpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/mastra",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "@agentproto/mastra — turn an AIP-42 AGENT.md handle into a runnable Mastra Agent. The package is a thin adapter: you supply resolvers (model, tool, workflow, memory) and it composes the manifest's identity, persona, body, boundaries, and tool refs into a constructed `new Agent({...})` from `@mastra/core/agent`. Reference implementation for the agent/v1 → Mastra runtime path.",
   "keywords": [
     "agentproto",
@@ -42,7 +42,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@agentproto/agent": "0.2.0"
+    "@agentproto/agent": "0.2.0",
+    "@agentproto/corpus": "0.2.1"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0"