@agentproto/agent-runtime 0.1.0-alpha.0 → 0.1.0

package/dist/adapters/dispatcher-mention.d.ts

@@ -1,4 +1,5 @@
-import { Dispatcher, DispatcherInput, ParticipantId } from '../ports.js';
+import { Dispatcher, DispatcherInput } from '../ports.js';
+import { ParticipantId } from '@agentproto/telemetry';
 
 /**
  * Type sidecar for `mention-parser.mjs`. The implementation file is

package/dist/adapters/participant-agent-cli.d.ts

@@ -1,5 +1,6 @@
 import { ParticipantExecutor, ParticipantExecuteInput, ParticipantExecuteOutput } from '../ports.js';
 export { parseClaudeJsonOutput } from '@agentproto/cli-exec';
+import '@agentproto/telemetry';
 
 /**
  * Agent-CLI participant — spawns a CLI binary, pipes the assembled prompt
@@ -17,6 +18,8 @@ type AgentCliParticipantOptions = {
     readonly args?: readonly string[];
     /** Working directory. Defaults to process.cwd(). */
     readonly cwd?: string;
+    /** Manifest base directory; relative role paths resolve against this. */
+    readonly baseDir?: string;
     /** Hard timeout in ms. Default 90000. */
     readonly timeoutMs?: number;
     /** Optional output parser — if returns null, content falls back to raw stdout. */

package/dist/adapters/participant-agent-cli.mjs

@@ -1,4 +1,5 @@
 import { readFile } from 'fs/promises';
+import { resolve } from 'path';
 import matter from 'gray-matter';
 import { spawnWithStdin } from '@agentproto/cli-exec';
 export { parseClaudeJsonOutput } from '@agentproto/cli-exec';
@@ -17,7 +18,7 @@ var AgentCliParticipant = class {
   opts;
   kind = "agent-cli";
   async executeTurn(input) {
-    const prompt = await assemblePrompt(input);
+    const prompt = await assemblePrompt(input, this.opts.baseDir);
     const stdout = await spawnWithStdin({
       command: this.opts.command,
       args: this.opts.args ?? [],
@@ -31,8 +32,8 @@ var AgentCliParticipant = class {
     return { content };
   }
 };
-async function assemblePrompt(input) {
-  const roleText = input.participant.role ? await loadRole(input.participant.role) : "";
+async function assemblePrompt(input, baseDir) {
+  const roleText = input.participant.role ? await loadRole(input.participant.role, baseDir) : "";
   const transcript = input.recentTurns.map((t) => `[${t.participantId}] ${t.content}`).join("\n\n");
   return [
     roleText && `# Your role
@@ -47,16 +48,17 @@ You are ${input.participant.displayName}. The latest message in the conversation
   ].filter(Boolean).join("\n\n");
 }
 var ROLE_FILE_EXTENSIONS = [".md", ".markdown", ".txt"];
-async function loadRole(roleField) {
+async function loadRole(roleField, baseDir) {
   if (!looksLikeRoleFile(roleField)) return roleField;
+  const path = baseDir ? resolve(baseDir, roleField) : roleField;
   try {
-    const raw = await readFile(roleField, "utf8");
+    const raw = await readFile(path, "utf8");
     const parsed = matter(raw);
     return parsed.content.trim();
   } catch (err) {
     const code = err.code;
     process.stderr.write(
-      `agent-cli participant: role path '${roleField}' not readable (${code ?? "unknown"}); using the literal string as inline role text.
+      `agent-cli participant: role path '${roleField}' (resolved to ${path}) not readable (${code ?? "unknown"}); using the literal string as inline role text.
 `
     );
     return roleField;

package/dist/adapters/participant-agent-cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/participant-agent-cli.ts"],"names":[],"mappings":";;;;;;;;;;;;AAmCO,IAAM,sBAAN,MAAyD;AAAA,EAG9D,YAA6B,IAAA,EAAkC;AAAlC,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmC;AAAA,EAAnC,IAAA;AAAA,EAFpB,IAAA,GAAO,WAAA;AAAA,EAIhB,MAAM,YACJ,KAAA,EACmC;AACnC,IAAA,MAAM,MAAA,GAAS,MAAM,cAAA,CAAe,KAAK,CAAA;AACzC,IAAA,MAAM,MAAA,GAAS,MAAM,cAAA,CAAe;AAAA,MAClC,OAAA,EAAS,KAAK,IAAA,CAAK,OAAA;AAAA,MACnB,IAAA,EAAM,IAAA,CAAK,IAAA,CAAK,IAAA,IAAQ,EAAC;AAAA,MACzB,GAAA,EAAK,IAAA,CAAK,IAAA,CAAK,GAAA,IAAO,QAAQ,GAAA,EAAI;AAAA,MAClC,SAAA,EAAW,IAAA,CAAK,IAAA,CAAK,SAAA,IAAa,GAAA;AAAA,MAClC,KAAA,EAAO,MAAA;AAAA,MACP,QAAQ,KAAA,CAAM;AAAA,KACf,CAAA;AACD,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,WAAA,GAAc,MAAM,CAAA,IAAK,IAAA;AAClD,IAAA,MAAM,OAAA,GAAU,MAAA,IAAU,MAAA,CAAO,OAAA,EAAQ;AACzC,IAAA,OAAO,EAAE,OAAA,EAAQ;AAAA,EACnB;AACF;AAEA,eAAe,eACb,KAAA,EACiB;AACjB,EAAA,MAAM,QAAA,GAAW,MAAM,WAAA,CAAY,IAAA,GAC/B,MAAM,QAAA,CAAS,KAAA,CAAM,WAAA,CAAY,IAAI,CAAA,GACrC,EAAA;AAEJ,EAAA,MAAM,UAAA,GAAa,KAAA,CAAM,WAAA,CACtB,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAA,EAAI,CAAA,CAAE,aAAa,KAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAC9C,KAAK,MAAM,CAAA;AAEd,EAAA,OAAO;AAAA,IACL,QAAA,IAAY,CAAA;;AAAA,EAAkB,QAAQ,CAAA,CAAA;AAAA,IACtC,CAAA;;AAAA,EAA4B,UAAU,CAAA,CAAA;AAAA,IACtC,CAAA;;AAAA,QAAA,EAA0B,KAAA,CAAM,YAAY,WAAW,CAAA,2SAAA;AAAA,GACzD,CACG,MAAA,CAAO,OAAO,CAAA,CACd,KAAK,MAAM,CAAA;AAChB;AAKA,IAAM,oBAAA,GAAuB,CAAC,KAAA,EAAO,WAAA,EAAa,MAAM,CAAA;AAExD,eAAe,SAAS,SAAA,EAAoC;AAC1D,EAAA,IAAI,CAAC,iBAAA,CAAkB,SAAS,CAAA,EAAG,OAAO,SAAA;AAC1C,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,QAAA,CAAS,SAAA,EAAW,MAAM,CAAA;AAI5C,IAAA,MAAM,MAAA,GAAS,OAAO,GAAG,CAAA;AACzB,IAAA,OAAO,MAAA,CAAO,QAAQ,IAAA,EAAK;AAAA,EAC7B,SAAS,GAAA,EAAK;AAKZ,IAAA,MAAM,OAAQ,GAAA,CAA8B,IAAA;AAC5C,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb,CAAA,kCAAA,EAAqC,SAAS,CAAA,gBAAA,EAAmB,IAAA,IAAQ,SAAS,CAAA;AAAA;AAAA,KACpF;AACA,IAAA,OAAO,SAAA;AAAA,EACT;AACF;AAEA,SAAS,kBAAkB,CAAA,EAAoB;AAC7C,EAAA,MAAM,KAAA,GAAQ,EAAE,WAAA,EAAY;AAC5B,EAAA,OAAO,qBAAqB,IAAA,CAAK,CAAC,QAAQ,KAAA,CAAM,QAAA,CAAS,GAAG,CAAC,CAAA;AAC/D","file":"participant-agent-cli.mjs","sourcesContent":["/**\n * Agent-CLI participant — spawns a CLI binary, pipes the assembled prompt\n * over stdin, and uses captured stdout as the turn content.\n *\n * Works for any CLI that supports a one-shot \"read prompt from stdin,\n * print response to stdout\" mode (claude-code's `--print`, hermes' `-p`,\n * etc.).\n */\n\nimport { readFile } from \"node:fs/promises\"\nimport matter from \"gray-matter\"\nimport { spawnWithStdin } from \"@agentproto/cli-exec\"\nimport type {\n  ParticipantExecuteInput,\n  ParticipantExecuteOutput,\n  ParticipantExecutor,\n} from \"../ports.js\"\n\n// Re-exported for back-compat: the JSON-envelope parser now lives in the shared\n// @agentproto/cli-exec package alongside the spawn helper.\nexport { parseClaudeJsonOutput } from \"@agentproto/cli-exec\"\n\nexport type AgentCliParticipantOptions = {\n  /** Executable to invoke. Examples: \"claude\", \"hermes\", \"goose\". */\n  readonly command: string\n  /** Static args. The prompt is fed over stdin, not as an argument. */\n  readonly args?: readonly string[]\n  /** Working directory. Defaults to process.cwd(). */\n  readonly cwd?: string\n  /** Hard timeout in ms. Default 90000. */\n  readonly timeoutMs?: number\n  /** Optional output parser — if returns null, content falls back to raw stdout. */\n  readonly parseOutput?: (stdout: string) => string | null\n}\n\nexport class AgentCliParticipant implements ParticipantExecutor {\n  readonly kind = \"agent-cli\"\n\n  constructor(private readonly opts: AgentCliParticipantOptions) {}\n\n  async executeTurn(\n    input: ParticipantExecuteInput\n  ): Promise<ParticipantExecuteOutput> {\n    const prompt = await assemblePrompt(input)\n    const stdout = await spawnWithStdin({\n      command: this.opts.command,\n      args: this.opts.args ?? [],\n      cwd: this.opts.cwd ?? process.cwd(),\n      timeoutMs: this.opts.timeoutMs ?? 90000,\n      stdin: prompt,\n      signal: input.signal,\n    })\n    const parsed = this.opts.parseOutput?.(stdout) ?? null\n    const content = parsed ?? stdout.trimEnd()\n    return { content }\n  }\n}\n\nasync function assemblePrompt(\n  input: ParticipantExecuteInput\n): Promise<string> {\n  const roleText = input.participant.role\n    ? await loadRole(input.participant.role)\n    : \"\"\n\n  const transcript = input.recentTurns\n    .map((t) => `[${t.participantId}] ${t.content}`)\n    .join(\"\\n\\n\")\n\n  return [\n    roleText && `# Your role\\n\\n${roleText}`,\n    `# Recent conversation\\n\\n${transcript}`,\n    `# Your turn\\n\\nYou are ${input.participant.displayName}. The latest message in the conversation triggered you (most likely because it mentions you). Read the transcript above and reply in character. Keep it conversational unless the trigger asks for detailed work. Output only your reply — no preamble, no role labels, no quotes around the response.`,\n  ]\n    .filter(Boolean)\n    .join(\"\\n\\n\")\n}\n\n// File extensions we treat as a path-to-role-file. Anything else is\n// inline role text — even strings that contain `/`, which are common\n// in normal sentences (\"I am an AI/ML reviewer\").\nconst ROLE_FILE_EXTENSIONS = [\".md\", \".markdown\", \".txt\"]\n\nasync function loadRole(roleField: string): Promise<string> {\n  if (!looksLikeRoleFile(roleField)) return roleField\n  try {\n    const raw = await readFile(roleField, \"utf8\")\n    // Strip optional YAML frontmatter — lets a Claude Code agent\n    // definition file (.claude/agents/*.md) double as a swarm role\n    // without ferrying the agent's metadata into the prompt.\n    const parsed = matter(raw)\n    return parsed.content.trim()\n  } catch (err) {\n    // The string had a role-file extension but the file isn't readable\n    // — surface a hint on stderr so authors don't silently get the\n    // literal path as a prompt. Still fall back to inline so the swarm\n    // doesn't crash on a typo.\n    const code = (err as NodeJS.ErrnoException).code\n    process.stderr.write(\n      `agent-cli participant: role path '${roleField}' not readable (${code ?? \"unknown\"}); using the literal string as inline role text.\\n`\n    )\n    return roleField\n  }\n}\n\nfunction looksLikeRoleFile(s: string): boolean {\n  const lower = s.toLowerCase()\n  return ROLE_FILE_EXTENSIONS.some((ext) => lower.endsWith(ext))\n}\n"]}
+{"version":3,"sources":["../../src/adapters/participant-agent-cli.ts"],"names":["resolvePath"],"mappings":"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","file":"participant-agent-cli.mjs","sourcesContent":["/**\n * Agent-CLI participant — spawns a CLI binary, pipes the assembled prompt\n * over stdin, and uses captured stdout as the turn content.\n *\n * Works for any CLI that supports a one-shot \"read prompt from stdin,\n * print response to stdout\" mode (claude-code's `--print`, hermes' `-p`,\n * etc.).\n */\n\nimport { readFile } from \"node:fs/promises\"\nimport { resolve as resolvePath } from \"node:path\"\nimport matter from \"gray-matter\"\nimport { spawnWithStdin } from \"@agentproto/cli-exec\"\nimport type {\n  ParticipantExecuteInput,\n  ParticipantExecuteOutput,\n  ParticipantExecutor,\n} from \"../ports.js\"\n\n// Re-exported for back-compat: the JSON-envelope parser now lives in the shared\n// @agentproto/cli-exec package alongside the spawn helper.\nexport { parseClaudeJsonOutput } from \"@agentproto/cli-exec\"\n\nexport type AgentCliParticipantOptions = {\n  /** Executable to invoke. Examples: \"claude\", \"hermes\", \"goose\". */\n  readonly command: string\n  /** Static args. The prompt is fed over stdin, not as an argument. */\n  readonly args?: readonly string[]\n  /** Working directory. Defaults to process.cwd(). */\n  readonly cwd?: string\n  /** Manifest base directory; relative role paths resolve against this. */\n  readonly baseDir?: string\n  /** Hard timeout in ms. Default 90000. */\n  readonly timeoutMs?: number\n  /** Optional output parser — if returns null, content falls back to raw stdout. */\n  readonly parseOutput?: (stdout: string) => string | null\n}\n\nexport class AgentCliParticipant implements ParticipantExecutor {\n  readonly kind = \"agent-cli\"\n\n  constructor(private readonly opts: AgentCliParticipantOptions) {}\n\n  async executeTurn(\n    input: ParticipantExecuteInput\n  ): Promise<ParticipantExecuteOutput> {\n    const prompt = await assemblePrompt(input, this.opts.baseDir)\n    const stdout = await spawnWithStdin({\n      command: this.opts.command,\n      args: this.opts.args ?? [],\n      cwd: this.opts.cwd ?? process.cwd(),\n      timeoutMs: this.opts.timeoutMs ?? 90000,\n      stdin: prompt,\n      signal: input.signal,\n    })\n    const parsed = this.opts.parseOutput?.(stdout) ?? null\n    const content = parsed ?? stdout.trimEnd()\n    return { content }\n  }\n}\n\nasync function assemblePrompt(\n  input: ParticipantExecuteInput,\n  baseDir?: string\n): Promise<string> {\n  const roleText = input.participant.role\n    ? await loadRole(input.participant.role, baseDir)\n    : \"\"\n\n  const transcript = input.recentTurns\n    .map((t) => `[${t.participantId}] ${t.content}`)\n    .join(\"\\n\\n\")\n\n  return [\n    roleText && `# Your role\\n\\n${roleText}`,\n    `# Recent conversation\\n\\n${transcript}`,\n    `# Your turn\\n\\nYou are ${input.participant.displayName}. The latest message in the conversation triggered you (most likely because it mentions you). Read the transcript above and reply in character. Keep it conversational unless the trigger asks for detailed work. Output only your reply — no preamble, no role labels, no quotes around the response.`,\n  ]\n    .filter(Boolean)\n    .join(\"\\n\\n\")\n}\n\n// File extensions we treat as a path-to-role-file. Anything else is\n// inline role text — even strings that contain `/`, which are common\n// in normal sentences (\"I am an AI/ML reviewer\").\nconst ROLE_FILE_EXTENSIONS = [\".md\", \".markdown\", \".txt\"]\n\nasync function loadRole(roleField: string, baseDir?: string): Promise<string> {\n  if (!looksLikeRoleFile(roleField)) return roleField\n  const path = baseDir ? resolvePath(baseDir, roleField) : roleField\n  try {\n    const raw = await readFile(path, \"utf8\")\n    // Strip optional YAML frontmatter — lets a Claude Code agent\n    // definition file (.claude/agents/*.md) double as a swarm role\n    // without ferrying the agent's metadata into the prompt.\n    const parsed = matter(raw)\n    return parsed.content.trim()\n  } catch (err) {\n    // The string had a role-file extension but the file isn't readable\n    // — surface a hint on stderr so authors don't silently get the\n    // literal path as a prompt. Still fall back to inline so the swarm\n    // doesn't crash on a typo.\n    const code = (err as NodeJS.ErrnoException).code\n    process.stderr.write(\n      `agent-cli participant: role path '${roleField}' (resolved to ${path}) not readable (${code ?? \"unknown\"}); using the literal string as inline role text.\\n`\n    )\n    return roleField\n  }\n}\n\nfunction looksLikeRoleFile(s: string): boolean {\n  const lower = s.toLowerCase()\n  return ROLE_FILE_EXTENSIONS.some((ext) => lower.endsWith(ext))\n}\n"]}

package/dist/adapters/state-fs.d.ts

@@ -1,4 +1,5 @@
-import { StateStore, ParticipantId } from '../ports.js';
+import { StateStore } from '../ports.js';
+import { ParticipantId } from '@agentproto/telemetry';
 
 /**
  * Filesystem state store — one JSON file per participant.

package/dist/adapters/substrate-file.d.ts

@@ -1,4 +1,5 @@
-import { Substrate, TurnInput, Turn, TurnId } from '../ports.js';
+import { Substrate, TurnInput, Turn } from '../ports.js';
+import { TurnId } from '@agentproto/telemetry';
 
 /**
  * File substrate — append-only markdown journal.

package/dist/adapters/telemetry.d.ts

@@ -1,39 +1 @@
-import { TelemetryEvent, Telemetry } from '../ports.js';
-
-/**
- * Reference Telemetry adapters.
- *
- * Wire `RuntimePorts.telemetry` to one of these (or your own
- * implementation) to receive structured events from each cycle.
- * Sinks may also be composed via `composeTelemetry()`.
- */
-
-/** No-op sink. Equivalent to leaving `telemetry` undefined on RuntimePorts. */
-declare const noopTelemetry: Telemetry;
-interface StderrTelemetryOptions {
-    /** Event kinds to include. Omit to emit all kinds. */
-    readonly include?: ReadonlySet<TelemetryEvent["kind"]>;
-    /** Event kinds to suppress. Wins over `include`. */
-    readonly exclude?: ReadonlySet<TelemetryEvent["kind"]>;
-    /** Prefix prepended to every line. Default "agentproto: ". */
-    readonly prefix?: string;
-}
-/**
- * Human-readable stderr sink — one line per event. Cheaper than wiring
- * a real exporter; good default for `--verbose` mode.
- */
-declare function stderrTelemetry(options?: StderrTelemetryOptions): Telemetry;
-/**
- * In-memory sink — every event pushed onto an array. Intended for
- * tests; reach into `events` after `runTurn` to assert.
- */
-declare function arrayTelemetry(): Telemetry & {
-    readonly events: readonly TelemetryEvent[];
-};
-/**
- * Fan-out — emits every event to all wrapped sinks in order. Useful
- * for "log to stderr AND export to OTEL" setups.
- */
-declare function composeTelemetry(...sinks: readonly Telemetry[]): Telemetry;
-
-export { type StderrTelemetryOptions, arrayTelemetry, composeTelemetry, noopTelemetry, stderrTelemetry };
+export { StderrTelemetryOptions, arrayTelemetry, composeTelemetry, noopTelemetry, stderrTelemetry } from '@agentproto/telemetry';

package/dist/adapters/telemetry.mjs

@@ -1,76 +1,3 @@
-/**
- * @agentproto/agent-runtime v0.1.0-alpha
- * MultiAgentRuntime kernel — swappable ports + reference adapters
- * (file substrate, mention dispatcher, fs state, agent-cli participant).
- * Transport-specific adapters ship in separate packages.
- */
-
-// src/adapters/telemetry.ts
-var noopTelemetry = {
-  emit() {
-  }
-};
-function stderrTelemetry(options = {}) {
-  const prefix = options.prefix ?? "agentproto: ";
-  return {
-    emit(event) {
-      if (options.exclude?.has(event.kind)) return;
-      if (options.include && !options.include.has(event.kind)) return;
-      process.stderr.write(`${prefix}${formatEvent(event)}
-`);
-    }
-  };
-}
-function arrayTelemetry() {
-  const events = [];
-  return {
-    events,
-    emit(event) {
-      events.push(event);
-    }
-  };
-}
-function composeTelemetry(...sinks) {
-  return {
-    emit(event) {
-      for (const sink of sinks) {
-        try {
-          sink.emit(event);
-        } catch {
-        }
-      }
-    }
-  };
-}
-function formatEvent(event) {
-  switch (event.kind) {
-    case "cycle.started":
-      return `${event.cycleId} cycle.started${event.since !== void 0 ? ` since=${event.since}` : ""}`;
-    case "substrate.read":
-      return `${event.cycleId} substrate.read ${event.substrateKind} turns=${event.turnCount} ${event.durationMs}ms`;
-    case "dispatch.decided":
-      return `${event.cycleId} dispatch.decided ${event.dispatcherKind} selected=[${event.selected.join(",") || "(none)"}] ${event.durationMs}ms`;
-    case "participant.started":
-      return `${event.cycleId} participant.started ${event.participantId} (${event.executorKind})`;
-    case "participant.finished":
-      return `${event.cycleId} participant.finished ${event.participantId} ${event.durationMs}ms content=${event.contentLength}b`;
-    case "participant.failed":
-      return `${event.cycleId} participant.failed ${event.participantId} \u2014 ${event.error}`;
-    case "substrate.appended":
-      return `${event.cycleId} substrate.appended turn=${event.turnId} by=${event.participantId}`;
-    case "state.written":
-      return `${event.cycleId} state.written ${event.participantId}`;
-    case "cycle.idle":
-      return `${event.cycleId} cycle.idle`;
-    case "cycle.finished":
-      return `${event.cycleId} cycle.finished ${event.outcome} appended=${event.turnsAppended} ${event.durationMs}ms`;
-    default: {
-      const _exhaustive = event;
-      return JSON.stringify(_exhaustive);
-    }
-  }
-}
-
-export { arrayTelemetry, composeTelemetry, noopTelemetry, stderrTelemetry };
+export { arrayTelemetry, composeTelemetry, noopTelemetry, stderrTelemetry } from '@agentproto/telemetry';
 //# sourceMappingURL=telemetry.mjs.map
 //# sourceMappingURL=telemetry.mjs.map

package/dist/adapters/telemetry.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/telemetry.ts"],"names":[],"mappings":"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","file":"telemetry.mjs","sourcesContent":["/**\n * Reference Telemetry adapters.\n *\n * Wire `RuntimePorts.telemetry` to one of these (or your own\n * implementation) to receive structured events from each cycle.\n * Sinks may also be composed via `composeTelemetry()`.\n */\n\nimport type { Telemetry, TelemetryEvent } from \"../ports.js\"\n\n/** No-op sink. Equivalent to leaving `telemetry` undefined on RuntimePorts. */\nexport const noopTelemetry: Telemetry = {\n  emit() {\n    // intentionally blank\n  },\n}\n\nexport interface StderrTelemetryOptions {\n  /** Event kinds to include. Omit to emit all kinds. */\n  readonly include?: ReadonlySet<TelemetryEvent[\"kind\"]>\n  /** Event kinds to suppress. Wins over `include`. */\n  readonly exclude?: ReadonlySet<TelemetryEvent[\"kind\"]>\n  /** Prefix prepended to every line. Default \"agentproto: \". */\n  readonly prefix?: string\n}\n\n/**\n * Human-readable stderr sink — one line per event. Cheaper than wiring\n * a real exporter; good default for `--verbose` mode.\n */\nexport function stderrTelemetry(\n  options: StderrTelemetryOptions = {}\n): Telemetry {\n  const prefix = options.prefix ?? \"agentproto: \"\n  return {\n    emit(event) {\n      if (options.exclude?.has(event.kind)) return\n      if (options.include && !options.include.has(event.kind)) return\n      process.stderr.write(`${prefix}${formatEvent(event)}\\n`)\n    },\n  }\n}\n\n/**\n * In-memory sink — every event pushed onto an array. Intended for\n * tests; reach into `events` after `runTurn` to assert.\n */\nexport function arrayTelemetry(): Telemetry & {\n  readonly events: readonly TelemetryEvent[]\n} {\n  const events: TelemetryEvent[] = []\n  return {\n    events,\n    emit(event) {\n      events.push(event)\n    },\n  }\n}\n\n/**\n * Fan-out — emits every event to all wrapped sinks in order. Useful\n * for \"log to stderr AND export to OTEL\" setups.\n */\nexport function composeTelemetry(...sinks: readonly Telemetry[]): Telemetry {\n  return {\n    emit(event) {\n      for (const sink of sinks) {\n        try {\n          sink.emit(event)\n        } catch {\n          // Each sink is independently isolated.\n        }\n      }\n    },\n  }\n}\n\nfunction formatEvent(event: TelemetryEvent): string {\n  switch (event.kind) {\n    case \"cycle.started\":\n      return `${event.cycleId} cycle.started${event.since !== undefined ? ` since=${event.since}` : \"\"}`\n    case \"substrate.read\":\n      return `${event.cycleId} substrate.read ${event.substrateKind} turns=${event.turnCount} ${event.durationMs}ms`\n    case \"dispatch.decided\":\n      return `${event.cycleId} dispatch.decided ${event.dispatcherKind} selected=[${event.selected.join(\",\") || \"(none)\"}] ${event.durationMs}ms`\n    case \"participant.started\":\n      return `${event.cycleId} participant.started ${event.participantId} (${event.executorKind})`\n    case \"participant.finished\":\n      return `${event.cycleId} participant.finished ${event.participantId} ${event.durationMs}ms content=${event.contentLength}b`\n    case \"participant.failed\":\n      return `${event.cycleId} participant.failed ${event.participantId} — ${event.error}`\n    case \"substrate.appended\":\n      return `${event.cycleId} substrate.appended turn=${event.turnId} by=${event.participantId}`\n    case \"state.written\":\n      return `${event.cycleId} state.written ${event.participantId}`\n    case \"cycle.idle\":\n      return `${event.cycleId} cycle.idle`\n    case \"cycle.finished\":\n      return `${event.cycleId} cycle.finished ${event.outcome} appended=${event.turnsAppended} ${event.durationMs}ms`\n    default: {\n      // Forward-compat — render unknown kinds as JSON so a future\n      // kernel version doesn't blank-line the log.\n      const _exhaustive: never = event\n      return JSON.stringify(_exhaustive)\n    }\n  }\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"telemetry.mjs","sourcesContent":[]}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-import { TurnId, Turn, RuntimePorts } from './ports.js';
-export { Dispatcher, DispatcherInput, Lifecycle, ParticipantDescriptor, ParticipantExecuteInput, ParticipantExecuteOutput, ParticipantExecutor, ParticipantId, StateStore, Substrate, Telemetry, TelemetryEvent, TurnInput } from './ports.js';
-export { LoadedManifest, MULTI_AGENT_RUNTIME_KIND, MULTI_AGENT_RUNTIME_SCHEMA, MultiAgentRuntimeManifest, MultiAgentRuntimeManifestSchema, loadManifest, parseManifest, resolveManifestPath } from './manifest.js';
+import { Turn, RuntimePorts } from './ports.js';
+export { Dispatcher, DispatcherInput, Lifecycle, ParticipantConfig, ParticipantDescriptor, ParticipantExecuteInput, ParticipantExecuteOutput, ParticipantExecutor, StateStore, Substrate, TurnInput } from './ports.js';
+import { TurnId } from '@agentproto/telemetry';
+export { ParticipantId, Telemetry, TelemetryEvent, TurnId } from '@agentproto/telemetry';
+export { LoadedManifest, MULTI_AGENT_RUNTIME_KIND, MULTI_AGENT_RUNTIME_SCHEMA, MultiAgentRuntimeManifest, MultiAgentRuntimeManifestSchema, ParticipantManifestConfig, loadManifest, parseManifest, resolveManifestPath } from './manifest.js';
 import 'zod';
 
 /**
@@ -33,4 +35,4 @@ type RunTurnResult = {
  */
 declare function runTurn(ports: RuntimePorts, options?: RunTurnOptions): Promise<RunTurnResult>;
 
-export { type RunTurnOptions, type RunTurnResult, RuntimePorts, Turn, TurnId, runTurn };
+export { type RunTurnOptions, type RunTurnResult, RuntimePorts, Turn, runTurn };

package/dist/index.mjs

@@ -78,7 +78,7 @@ async function runTurn(ports, options = {}) {
     if (!participant) {
       continue;
     }
-    const executor = ports.executors.get(participant.executor);
+    const executor = ports.executors.get(participantId);
     if (!executor) {
       continue;
     }
@@ -179,11 +179,17 @@ var MULTI_AGENT_RUNTIME_KIND = "MultiAgentRuntime";
 var AdapterConfigSchema = z.object({
   kind: z.string().min(1)
 }).loose();
+var ParticipantConfigSchema = z.object({
+  command: z.string().min(1).optional(),
+  args: z.array(z.string()).optional(),
+  model: z.string().min(1).optional()
+}).loose();
 var ParticipantManifestSchema = z.object({
   id: z.string().min(1),
   executor: z.string().min(1),
   displayName: z.string().min(1).optional(),
   role: z.string().optional(),
+  config: ParticipantConfigSchema.optional(),
   meta: z.record(z.string(), z.unknown()).optional()
 }).loose();
 var MultiAgentRuntimeManifestSchema = z.object({

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime.ts","../src/manifest.ts"],"names":["resolvePath"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Runtime orchestrator. One cycle =\n *   read substrate → dispatch → execute selected participants → append → fire lifecycle.\n *\n * The kernel knows nothing about specific substrates, dispatchers, or\n * executors — it only routes through the port interfaces. Telemetry,\n * if wired, receives a structured event at every phase boundary; the\n * cycleId on each event lets a sink rebuild OTEL-style spans by\n * grouping.\n */\n\nimport { randomBytes } from \"node:crypto\"\nimport type {\n  ParticipantDescriptor,\n  RuntimePorts,\n  Telemetry,\n  TelemetryEvent,\n  Turn,\n  TurnId,\n} from \"./ports.js\"\n\nexport type RunTurnOptions = {\n  /** How far back to read from the substrate when building dispatcher input. Default 30. */\n  readonly historyLimit?: number\n  /** Read turns strictly newer than this id. Default undefined (full snapshot, truncated by historyLimit). */\n  readonly since?: TurnId\n  /** Abort signal forwarded to participant executors. */\n  readonly signal?: AbortSignal\n}\n\nexport type RunTurnResult = {\n  readonly cycle: \"executed\" | \"idle\"\n  readonly selected: readonly string[]\n  readonly turnsAppended: readonly Turn[]\n}\n\n/**\n * Run a single dispatcher cycle. Returns synchronously after one round of\n * dispatch + execute + append. Callers loop for continuous operation.\n */\nexport async function runTurn(\n  ports: RuntimePorts,\n  options: RunTurnOptions = {}\n): Promise<RunTurnResult> {\n  const historyLimit = options.historyLimit ?? 30\n  const cycleId = newCycleId()\n  const cycleStart = Date.now()\n\n  emit(ports.telemetry, {\n    kind: \"cycle.started\",\n    cycleId,\n    at: nowIso(),\n    ...(options.since !== undefined ? { since: options.since } : {}),\n  })\n\n  const readStart = Date.now()\n  const all = await ports.substrate.read(options.since)\n  const recentTurns = all.slice(-historyLimit)\n  emit(ports.telemetry, {\n    kind: \"substrate.read\",\n    cycleId,\n    at: nowIso(),\n    substrateKind: ports.substrate.kind,\n    turnCount: recentTurns.length,\n    durationMs: Date.now() - readStart,\n  })\n\n  const dispatchStart = Date.now()\n  const selected = await ports.dispatcher.selectNext({\n    recentTurns,\n    participants: ports.participants,\n  })\n  emit(ports.telemetry, {\n    kind: \"dispatch.decided\",\n    cycleId,\n    at: nowIso(),\n    dispatcherKind: ports.dispatcher.kind,\n    selected,\n    durationMs: Date.now() - dispatchStart,\n  })\n\n  if (selected.length === 0) {\n    await ports.lifecycle?.onIdle?.()\n    emit(ports.telemetry, { kind: \"cycle.idle\", cycleId, at: nowIso() })\n    emit(ports.telemetry, {\n      kind: \"cycle.finished\",\n      cycleId,\n      at: nowIso(),\n      outcome: \"idle\",\n      turnsAppended: 0,\n      durationMs: Date.now() - cycleStart,\n    })\n    return { cycle: \"idle\", selected: [], turnsAppended: [] }\n  }\n\n  const triggerTurn = recentTurns[recentTurns.length - 1]\n  if (!triggerTurn) {\n    // Dispatcher selected someone but there's no recent turn to trigger off.\n    // Treat as idle — dispatchers should not pick speakers from an empty substrate.\n    await ports.lifecycle?.onIdle?.()\n    emit(ports.telemetry, { kind: \"cycle.idle\", cycleId, at: nowIso() })\n    emit(ports.telemetry, {\n      kind: \"cycle.finished\",\n      cycleId,\n      at: nowIso(),\n      outcome: \"idle\",\n      turnsAppended: 0,\n      durationMs: Date.now() - cycleStart,\n    })\n    return { cycle: \"idle\", selected: [], turnsAppended: [] }\n  }\n\n  const appended: Turn[] = []\n\n  for (const participantId of selected) {\n    const participant = findParticipant(ports.participants, participantId)\n    if (!participant) {\n      // Dispatcher hallucinated an unknown participant. Skip rather than crash —\n      // a malformed dispatcher shouldn't take down the loop.\n      continue\n    }\n    const executor = ports.executors.get(participant.executor)\n    if (!executor) {\n      // Manifest declared a participant whose executor isn't registered.\n      // Skip; misconfiguration shows up in logs but the loop survives.\n      continue\n    }\n\n    await ports.lifecycle?.onMention?.(participantId, triggerTurn)\n\n    const state = await ports.state.read(participantId)\n\n    emit(ports.telemetry, {\n      kind: \"participant.started\",\n      cycleId,\n      at: nowIso(),\n      participantId,\n      executorKind: participant.executor,\n    })\n\n    const execStart = Date.now()\n    let output\n    try {\n      output = await executor.executeTurn({\n        participant,\n        recentTurns,\n        triggerTurn,\n        state,\n        signal: options.signal,\n      })\n    } catch (err) {\n      emit(ports.telemetry, {\n        kind: \"participant.failed\",\n        cycleId,\n        at: nowIso(),\n        participantId,\n        executorKind: participant.executor,\n        error: err instanceof Error ? err.message : String(err),\n      })\n      throw err\n    }\n\n    emit(ports.telemetry, {\n      kind: \"participant.finished\",\n      cycleId,\n      at: nowIso(),\n      participantId,\n      executorKind: participant.executor,\n      durationMs: Date.now() - execStart,\n      contentLength: output.content.length,\n    })\n\n    const turn = await ports.substrate.append({\n      participantId,\n      content: output.content,\n      meta: output.meta,\n    })\n    appended.push(turn)\n    emit(ports.telemetry, {\n      kind: \"substrate.appended\",\n      cycleId,\n      at: nowIso(),\n      turnId: turn.id,\n      participantId,\n    })\n\n    if (output.stateUpdate) {\n      await ports.state.write(participantId, output.stateUpdate)\n      emit(ports.telemetry, {\n        kind: \"state.written\",\n        cycleId,\n        at: nowIso(),\n        participantId,\n      })\n    }\n\n    await ports.lifecycle?.onTurnEnd?.(turn)\n  }\n\n  emit(ports.telemetry, {\n    kind: \"cycle.finished\",\n    cycleId,\n    at: nowIso(),\n    outcome: \"executed\",\n    turnsAppended: appended.length,\n    durationMs: Date.now() - cycleStart,\n  })\n\n  return { cycle: \"executed\", selected, turnsAppended: appended }\n}\n\nfunction findParticipant(\n  participants: readonly ParticipantDescriptor[],\n  id: string\n): ParticipantDescriptor | undefined {\n  for (const p of participants) {\n    if (p.id === id) return p\n  }\n  return undefined\n}\n\nfunction emit(telemetry: Telemetry | undefined, event: TelemetryEvent): void {\n  // Sinks throwing must not take down the cycle — observability is\n  // non-load-bearing for the conversation.\n  if (!telemetry) return\n  try {\n    telemetry.emit(event)\n  } catch {\n    // Swallow. Better to lose a metric than to corrupt a turn.\n  }\n}\n\nfunction nowIso(): string {\n  return new Date().toISOString()\n}\n\nfunction newCycleId(): string {\n  // 96-bit random id, base32-ish — short enough to read, wide enough\n  // to be unique within a swarm process's lifetime.\n  return `c_${randomBytes(6).toString(\"hex\")}`\n}\n","/**\n * MultiAgentRuntime manifest schema + loader.\n *\n * The manifest is markdown with YAML frontmatter (matching @agentproto's\n * doctype convention used by ROLE.md, OPERATOR.md, etc.). The frontmatter\n * is the structured contract; the markdown body is human-readable\n * documentation of what the swarm does.\n *\n * Loader is filesystem-bound but parsing is pure — the schema can be used\n * by tests with inline strings via `parseManifest()`.\n */\n\nimport { readFile } from \"node:fs/promises\"\nimport { resolve as resolvePath, dirname } from \"node:path\"\nimport matter from \"gray-matter\"\nimport { z } from \"zod\"\n\nexport const MULTI_AGENT_RUNTIME_SCHEMA = \"agentruntimes/v1\"\nexport const MULTI_AGENT_RUNTIME_KIND = \"MultiAgentRuntime\"\n\nconst AdapterConfigSchema = z\n  .object({\n    kind: z.string().min(1),\n  })\n  .loose()\n\nconst ParticipantManifestSchema = z\n  .object({\n    id: z.string().min(1),\n    executor: z.string().min(1),\n    displayName: z.string().min(1).optional(),\n    role: z.string().optional(),\n    meta: z.record(z.string(), z.unknown()).optional(),\n  })\n  .loose()\n\nexport const MultiAgentRuntimeManifestSchema = z\n  .object({\n    schema: z.literal(MULTI_AGENT_RUNTIME_SCHEMA),\n    kind: z.literal(MULTI_AGENT_RUNTIME_KIND),\n    id: z.string().min(1),\n    participants: z.array(ParticipantManifestSchema).min(1),\n    substrate: AdapterConfigSchema,\n    dispatcher: AdapterConfigSchema,\n    state: AdapterConfigSchema.optional(),\n    lifecycle: z\n      .object({\n        onTurnEnd: z.boolean().optional(),\n        onMention: z.boolean().optional(),\n        onIdle: z.boolean().optional(),\n      })\n      .optional(),\n  })\n  .loose()\n\nexport type MultiAgentRuntimeManifest = z.infer<\n  typeof MultiAgentRuntimeManifestSchema\n>\n\nexport type LoadedManifest = {\n  readonly manifest: MultiAgentRuntimeManifest\n  readonly body: string\n  readonly path: string\n  /** Absolute directory of the manifest file — adapter configs that reference paths resolve relative to this. */\n  readonly baseDir: string\n}\n\nexport function parseManifest(source: string): MultiAgentRuntimeManifest {\n  const parsed = matter(source)\n  return MultiAgentRuntimeManifestSchema.parse(parsed.data)\n}\n\nexport async function loadManifest(path: string): Promise<LoadedManifest> {\n  const abs = resolvePath(path)\n  const raw = await readFile(abs, \"utf8\")\n  const parsed = matter(raw)\n  const manifest = MultiAgentRuntimeManifestSchema.parse(parsed.data)\n  return {\n    manifest,\n    body: parsed.content,\n    path: abs,\n    baseDir: dirname(abs),\n  }\n}\n\n/** Resolve a path string from a manifest field, relative to the manifest's directory. */\nexport function resolveManifestPath(loaded: LoadedManifest, value: string): string {\n  return resolvePath(loaded.baseDir, value)\n}\n"]}
+{"version":3,"sources":["../src/runtime.ts","../src/manifest.ts"],"names":["resolvePath"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Runtime orchestrator. One cycle =\n *   read substrate → dispatch → execute selected participants → append → fire lifecycle.\n *\n * The kernel knows nothing about specific substrates, dispatchers, or\n * executors — it only routes through the port interfaces. Telemetry,\n * if wired, receives a structured event at every phase boundary; the\n * cycleId on each event lets a sink rebuild OTEL-style spans by\n * grouping.\n */\n\nimport { randomBytes } from \"node:crypto\"\nimport type {\n  ParticipantDescriptor,\n  RuntimePorts,\n  Telemetry,\n  TelemetryEvent,\n  Turn,\n  TurnId,\n} from \"./ports.js\"\n\nexport type RunTurnOptions = {\n  /** How far back to read from the substrate when building dispatcher input. Default 30. */\n  readonly historyLimit?: number\n  /** Read turns strictly newer than this id. Default undefined (full snapshot, truncated by historyLimit). */\n  readonly since?: TurnId\n  /** Abort signal forwarded to participant executors. */\n  readonly signal?: AbortSignal\n}\n\nexport type RunTurnResult = {\n  readonly cycle: \"executed\" | \"idle\"\n  readonly selected: readonly string[]\n  readonly turnsAppended: readonly Turn[]\n}\n\n/**\n * Run a single dispatcher cycle. Returns synchronously after one round of\n * dispatch + execute + append. Callers loop for continuous operation.\n */\nexport async function runTurn(\n  ports: RuntimePorts,\n  options: RunTurnOptions = {}\n): Promise<RunTurnResult> {\n  const historyLimit = options.historyLimit ?? 30\n  const cycleId = newCycleId()\n  const cycleStart = Date.now()\n\n  emit(ports.telemetry, {\n    kind: \"cycle.started\",\n    cycleId,\n    at: nowIso(),\n    ...(options.since !== undefined ? { since: options.since } : {}),\n  })\n\n  const readStart = Date.now()\n  const all = await ports.substrate.read(options.since)\n  const recentTurns = all.slice(-historyLimit)\n  emit(ports.telemetry, {\n    kind: \"substrate.read\",\n    cycleId,\n    at: nowIso(),\n    substrateKind: ports.substrate.kind,\n    turnCount: recentTurns.length,\n    durationMs: Date.now() - readStart,\n  })\n\n  const dispatchStart = Date.now()\n  const selected = await ports.dispatcher.selectNext({\n    recentTurns,\n    participants: ports.participants,\n  })\n  emit(ports.telemetry, {\n    kind: \"dispatch.decided\",\n    cycleId,\n    at: nowIso(),\n    dispatcherKind: ports.dispatcher.kind,\n    selected,\n    durationMs: Date.now() - dispatchStart,\n  })\n\n  if (selected.length === 0) {\n    await ports.lifecycle?.onIdle?.()\n    emit(ports.telemetry, { kind: \"cycle.idle\", cycleId, at: nowIso() })\n    emit(ports.telemetry, {\n      kind: \"cycle.finished\",\n      cycleId,\n      at: nowIso(),\n      outcome: \"idle\",\n      turnsAppended: 0,\n      durationMs: Date.now() - cycleStart,\n    })\n    return { cycle: \"idle\", selected: [], turnsAppended: [] }\n  }\n\n  const triggerTurn = recentTurns[recentTurns.length - 1]\n  if (!triggerTurn) {\n    // Dispatcher selected someone but there's no recent turn to trigger off.\n    // Treat as idle — dispatchers should not pick speakers from an empty substrate.\n    await ports.lifecycle?.onIdle?.()\n    emit(ports.telemetry, { kind: \"cycle.idle\", cycleId, at: nowIso() })\n    emit(ports.telemetry, {\n      kind: \"cycle.finished\",\n      cycleId,\n      at: nowIso(),\n      outcome: \"idle\",\n      turnsAppended: 0,\n      durationMs: Date.now() - cycleStart,\n    })\n    return { cycle: \"idle\", selected: [], turnsAppended: [] }\n  }\n\n  const appended: Turn[] = []\n\n  for (const participantId of selected) {\n    const participant = findParticipant(ports.participants, participantId)\n    if (!participant) {\n      // Dispatcher hallucinated an unknown participant. Skip rather than crash —\n      // a malformed dispatcher shouldn't take down the loop.\n      continue\n    }\n    const executor = ports.executors.get(participantId)\n    if (!executor) {\n      // Manifest declared a participant whose executor isn't registered.\n      // Skip; misconfiguration shows up in logs but the loop survives.\n      continue\n    }\n\n    await ports.lifecycle?.onMention?.(participantId, triggerTurn)\n\n    const state = await ports.state.read(participantId)\n\n    emit(ports.telemetry, {\n      kind: \"participant.started\",\n      cycleId,\n      at: nowIso(),\n      participantId,\n      executorKind: participant.executor,\n    })\n\n    const execStart = Date.now()\n    let output\n    try {\n      output = await executor.executeTurn({\n        participant,\n        recentTurns,\n        triggerTurn,\n        state,\n        signal: options.signal,\n      })\n    } catch (err) {\n      emit(ports.telemetry, {\n        kind: \"participant.failed\",\n        cycleId,\n        at: nowIso(),\n        participantId,\n        executorKind: participant.executor,\n        error: err instanceof Error ? err.message : String(err),\n      })\n      throw err\n    }\n\n    emit(ports.telemetry, {\n      kind: \"participant.finished\",\n      cycleId,\n      at: nowIso(),\n      participantId,\n      executorKind: participant.executor,\n      durationMs: Date.now() - execStart,\n      contentLength: output.content.length,\n    })\n\n    const turn = await ports.substrate.append({\n      participantId,\n      content: output.content,\n      meta: output.meta,\n    })\n    appended.push(turn)\n    emit(ports.telemetry, {\n      kind: \"substrate.appended\",\n      cycleId,\n      at: nowIso(),\n      turnId: turn.id,\n      participantId,\n    })\n\n    if (output.stateUpdate) {\n      await ports.state.write(participantId, output.stateUpdate)\n      emit(ports.telemetry, {\n        kind: \"state.written\",\n        cycleId,\n        at: nowIso(),\n        participantId,\n      })\n    }\n\n    await ports.lifecycle?.onTurnEnd?.(turn)\n  }\n\n  emit(ports.telemetry, {\n    kind: \"cycle.finished\",\n    cycleId,\n    at: nowIso(),\n    outcome: \"executed\",\n    turnsAppended: appended.length,\n    durationMs: Date.now() - cycleStart,\n  })\n\n  return { cycle: \"executed\", selected, turnsAppended: appended }\n}\n\nfunction findParticipant(\n  participants: readonly ParticipantDescriptor[],\n  id: string\n): ParticipantDescriptor | undefined {\n  for (const p of participants) {\n    if (p.id === id) return p\n  }\n  return undefined\n}\n\nfunction emit(telemetry: Telemetry | undefined, event: TelemetryEvent): void {\n  // Sinks throwing must not take down the cycle — observability is\n  // non-load-bearing for the conversation.\n  if (!telemetry) return\n  try {\n    telemetry.emit(event)\n  } catch {\n    // Swallow. Better to lose a metric than to corrupt a turn.\n  }\n}\n\nfunction nowIso(): string {\n  return new Date().toISOString()\n}\n\nfunction newCycleId(): string {\n  // 96-bit random id, base32-ish — short enough to read, wide enough\n  // to be unique within a swarm process's lifetime.\n  return `c_${randomBytes(6).toString(\"hex\")}`\n}\n","/**\n * MultiAgentRuntime manifest schema + loader.\n *\n * The manifest is markdown with YAML frontmatter (matching @agentproto's\n * doctype convention used by ROLE.md, OPERATOR.md, etc.). The frontmatter\n * is the structured contract; the markdown body is human-readable\n * documentation of what the swarm does.\n *\n * Loader is filesystem-bound but parsing is pure — the schema can be used\n * by tests with inline strings via `parseManifest()`.\n */\n\nimport { readFile } from \"node:fs/promises\"\nimport { resolve as resolvePath, dirname } from \"node:path\"\nimport matter from \"gray-matter\"\nimport { z } from \"zod\"\n\nexport const MULTI_AGENT_RUNTIME_SCHEMA = \"agentruntimes/v1\"\nexport const MULTI_AGENT_RUNTIME_KIND = \"MultiAgentRuntime\"\n\nconst AdapterConfigSchema = z\n  .object({\n    kind: z.string().min(1),\n  })\n  .loose()\n\nconst ParticipantConfigSchema = z\n  .object({\n    command: z.string().min(1).optional(),\n    args: z.array(z.string()).optional(),\n    model: z.string().min(1).optional(),\n  })\n  .loose()\n\nconst ParticipantManifestSchema = z\n  .object({\n    id: z.string().min(1),\n    executor: z.string().min(1),\n    displayName: z.string().min(1).optional(),\n    role: z.string().optional(),\n    config: ParticipantConfigSchema.optional(),\n    meta: z.record(z.string(), z.unknown()).optional(),\n  })\n  .loose()\n\nexport type ParticipantManifestConfig = z.infer<typeof ParticipantConfigSchema>\n\nexport const MultiAgentRuntimeManifestSchema = z\n  .object({\n    schema: z.literal(MULTI_AGENT_RUNTIME_SCHEMA),\n    kind: z.literal(MULTI_AGENT_RUNTIME_KIND),\n    id: z.string().min(1),\n    participants: z.array(ParticipantManifestSchema).min(1),\n    substrate: AdapterConfigSchema,\n    dispatcher: AdapterConfigSchema,\n    state: AdapterConfigSchema.optional(),\n    lifecycle: z\n      .object({\n        onTurnEnd: z.boolean().optional(),\n        onMention: z.boolean().optional(),\n        onIdle: z.boolean().optional(),\n      })\n      .optional(),\n  })\n  .loose()\n\nexport type MultiAgentRuntimeManifest = z.infer<\n  typeof MultiAgentRuntimeManifestSchema\n>\n\nexport type LoadedManifest = {\n  readonly manifest: MultiAgentRuntimeManifest\n  readonly body: string\n  readonly path: string\n  /** Absolute directory of the manifest file — adapter configs that reference paths resolve relative to this. */\n  readonly baseDir: string\n}\n\nexport function parseManifest(source: string): MultiAgentRuntimeManifest {\n  const parsed = matter(source)\n  return MultiAgentRuntimeManifestSchema.parse(parsed.data)\n}\n\nexport async function loadManifest(path: string): Promise<LoadedManifest> {\n  const abs = resolvePath(path)\n  const raw = await readFile(abs, \"utf8\")\n  const parsed = matter(raw)\n  const manifest = MultiAgentRuntimeManifestSchema.parse(parsed.data)\n  return {\n    manifest,\n    body: parsed.content,\n    path: abs,\n    baseDir: dirname(abs),\n  }\n}\n\n/** Resolve a path string from a manifest field, relative to the manifest's directory. */\nexport function resolveManifestPath(loaded: LoadedManifest, value: string): string {\n  return resolvePath(loaded.baseDir, value)\n}\n"]}

package/dist/manifest.d.ts

@@ -14,6 +14,12 @@ import { z } from 'zod';
 
 declare const MULTI_AGENT_RUNTIME_SCHEMA = "agentruntimes/v1";
 declare const MULTI_AGENT_RUNTIME_KIND = "MultiAgentRuntime";
+declare const ParticipantConfigSchema: z.ZodObject<{
+    command: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type ParticipantManifestConfig = z.infer<typeof ParticipantConfigSchema>;
 declare const MultiAgentRuntimeManifestSchema: z.ZodObject<{
     schema: z.ZodLiteral<"agentruntimes/v1">;
     kind: z.ZodLiteral<"MultiAgentRuntime">;
@@ -23,6 +29,11 @@ declare const MultiAgentRuntimeManifestSchema: z.ZodObject<{
         executor: z.ZodString;
         displayName: z.ZodOptional<z.ZodString>;
         role: z.ZodOptional<z.ZodString>;
+        config: z.ZodOptional<z.ZodObject<{
+            command: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            model: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
         meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$loose>>;
     substrate: z.ZodObject<{
@@ -53,4 +64,4 @@ declare function loadManifest(path: string): Promise<LoadedManifest>;
 /** Resolve a path string from a manifest field, relative to the manifest's directory. */
 declare function resolveManifestPath(loaded: LoadedManifest, value: string): string;
 
-export { type LoadedManifest, MULTI_AGENT_RUNTIME_KIND, MULTI_AGENT_RUNTIME_SCHEMA, type MultiAgentRuntimeManifest, MultiAgentRuntimeManifestSchema, loadManifest, parseManifest, resolveManifestPath };
+export { type LoadedManifest, MULTI_AGENT_RUNTIME_KIND, MULTI_AGENT_RUNTIME_SCHEMA, type MultiAgentRuntimeManifest, MultiAgentRuntimeManifestSchema, type ParticipantManifestConfig, loadManifest, parseManifest, resolveManifestPath };

package/dist/manifest.mjs

@@ -15,11 +15,17 @@ var MULTI_AGENT_RUNTIME_KIND = "MultiAgentRuntime";
 var AdapterConfigSchema = z.object({
   kind: z.string().min(1)
 }).loose();
+var ParticipantConfigSchema = z.object({
+  command: z.string().min(1).optional(),
+  args: z.array(z.string()).optional(),
+  model: z.string().min(1).optional()
+}).loose();
 var ParticipantManifestSchema = z.object({
   id: z.string().min(1),
   executor: z.string().min(1),
   displayName: z.string().min(1).optional(),
   role: z.string().optional(),
+  config: ParticipantConfigSchema.optional(),
   meta: z.record(z.string(), z.unknown()).optional()
 }).loose();
 var MultiAgentRuntimeManifestSchema = z.object({

package/dist/manifest.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/manifest.ts"],"names":["resolvePath"],"mappings":";;;;;;;;;;;;AAiBO,IAAM,0BAAA,GAA6B;AACnC,IAAM,wBAAA,GAA2B;AAExC,IAAM,mBAAA,GAAsB,EACzB,MAAA,CAAO;AAAA,EACN,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC;AACxB,CAAC,EACA,KAAA,EAAM;AAET,IAAM,yBAAA,GAA4B,EAC/B,MAAA,CAAO;AAAA,EACN,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EACpB,QAAA,EAAU,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EAC1B,aAAa,CAAA,CAAE,MAAA,GAAS,GAAA,CAAI,CAAC,EAAE,QAAA,EAAS;AAAA,EACxC,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,IAAA,EAAM,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,OAAA,EAAS,CAAA,CAAE,QAAA;AAC1C,CAAC,EACA,KAAA,EAAM;AAEF,IAAM,+BAAA,GAAkC,EAC5C,MAAA,CAAO;AAAA,EACN,MAAA,EAAQ,CAAA,CAAE,OAAA,CAAQ,0BAA0B,CAAA;AAAA,EAC5C,IAAA,EAAM,CAAA,CAAE,OAAA,CAAQ,wBAAwB,CAAA;AAAA,EACxC,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EACpB,cAAc,CAAA,CAAE,KAAA,CAAM,yBAAyB,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,EACtD,SAAA,EAAW,mBAAA;AAAA,EACX,UAAA,EAAY,mBAAA;AAAA,EACZ,KAAA,EAAO,oBAAoB,QAAA,EAAS;AAAA,EACpC,SAAA,EAAW,EACR,MAAA,CAAO;AAAA,IACN,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,IAChC,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,IAChC,MAAA,EAAQ,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AAAS,GAC9B,EACA,QAAA;AACL,CAAC,EACA,KAAA;AAcI,SAAS,cAAc,MAAA,EAA2C;AACvE,EAAA,MAAM,MAAA,GAAS,OAAO,MAAM,CAAA;AAC5B,EAAA,OAAO,+BAAA,CAAgC,KAAA,CAAM,MAAA,CAAO,IAAI,CAAA;AAC1D;AAEA,eAAsB,aAAa,IAAA,EAAuC;AACxE,EAAA,MAAM,GAAA,GAAMA,QAAY,IAAI,CAAA;AAC5B,EAAA,MAAM,GAAA,GAAM,MAAM,QAAA,CAAS,GAAA,EAAK,MAAM,CAAA;AACtC,EAAA,MAAM,MAAA,GAAS,OAAO,GAAG,CAAA;AACzB,EAAA,MAAM,QAAA,GAAW,+BAAA,CAAgC,KAAA,CAAM,MAAA,CAAO,IAAI,CAAA;AAClE,EAAA,OAAO;AAAA,IACL,QAAA;AAAA,IACA,MAAM,MAAA,CAAO,OAAA;AAAA,IACb,IAAA,EAAM,GAAA;AAAA,IACN,OAAA,EAAS,QAAQ,GAAG;AAAA,GACtB;AACF;AAGO,SAAS,mBAAA,CAAoB,QAAwB,KAAA,EAAuB;AACjF,EAAA,OAAOA,OAAA,CAAY,MAAA,CAAO,OAAA,EAAS,KAAK,CAAA;AAC1C","file":"manifest.mjs","sourcesContent":["/**\n * MultiAgentRuntime manifest schema + loader.\n *\n * The manifest is markdown with YAML frontmatter (matching @agentproto's\n * doctype convention used by ROLE.md, OPERATOR.md, etc.). The frontmatter\n * is the structured contract; the markdown body is human-readable\n * documentation of what the swarm does.\n *\n * Loader is filesystem-bound but parsing is pure — the schema can be used\n * by tests with inline strings via `parseManifest()`.\n */\n\nimport { readFile } from \"node:fs/promises\"\nimport { resolve as resolvePath, dirname } from \"node:path\"\nimport matter from \"gray-matter\"\nimport { z } from \"zod\"\n\nexport const MULTI_AGENT_RUNTIME_SCHEMA = \"agentruntimes/v1\"\nexport const MULTI_AGENT_RUNTIME_KIND = \"MultiAgentRuntime\"\n\nconst AdapterConfigSchema = z\n  .object({\n    kind: z.string().min(1),\n  })\n  .loose()\n\nconst ParticipantManifestSchema = z\n  .object({\n    id: z.string().min(1),\n    executor: z.string().min(1),\n    displayName: z.string().min(1).optional(),\n    role: z.string().optional(),\n    meta: z.record(z.string(), z.unknown()).optional(),\n  })\n  .loose()\n\nexport const MultiAgentRuntimeManifestSchema = z\n  .object({\n    schema: z.literal(MULTI_AGENT_RUNTIME_SCHEMA),\n    kind: z.literal(MULTI_AGENT_RUNTIME_KIND),\n    id: z.string().min(1),\n    participants: z.array(ParticipantManifestSchema).min(1),\n    substrate: AdapterConfigSchema,\n    dispatcher: AdapterConfigSchema,\n    state: AdapterConfigSchema.optional(),\n    lifecycle: z\n      .object({\n        onTurnEnd: z.boolean().optional(),\n        onMention: z.boolean().optional(),\n        onIdle: z.boolean().optional(),\n      })\n      .optional(),\n  })\n  .loose()\n\nexport type MultiAgentRuntimeManifest = z.infer<\n  typeof MultiAgentRuntimeManifestSchema\n>\n\nexport type LoadedManifest = {\n  readonly manifest: MultiAgentRuntimeManifest\n  readonly body: string\n  readonly path: string\n  /** Absolute directory of the manifest file — adapter configs that reference paths resolve relative to this. */\n  readonly baseDir: string\n}\n\nexport function parseManifest(source: string): MultiAgentRuntimeManifest {\n  const parsed = matter(source)\n  return MultiAgentRuntimeManifestSchema.parse(parsed.data)\n}\n\nexport async function loadManifest(path: string): Promise<LoadedManifest> {\n  const abs = resolvePath(path)\n  const raw = await readFile(abs, \"utf8\")\n  const parsed = matter(raw)\n  const manifest = MultiAgentRuntimeManifestSchema.parse(parsed.data)\n  return {\n    manifest,\n    body: parsed.content,\n    path: abs,\n    baseDir: dirname(abs),\n  }\n}\n\n/** Resolve a path string from a manifest field, relative to the manifest's directory. */\nexport function resolveManifestPath(loaded: LoadedManifest, value: string): string {\n  return resolvePath(loaded.baseDir, value)\n}\n"]}
+{"version":3,"sources":["../src/manifest.ts"],"names":["resolvePath"],"mappings":"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","file":"manifest.mjs","sourcesContent":["/**\n * MultiAgentRuntime manifest schema + loader.\n *\n * The manifest is markdown with YAML frontmatter (matching @agentproto's\n * doctype convention used by ROLE.md, OPERATOR.md, etc.). The frontmatter\n * is the structured contract; the markdown body is human-readable\n * documentation of what the swarm does.\n *\n * Loader is filesystem-bound but parsing is pure — the schema can be used\n * by tests with inline strings via `parseManifest()`.\n */\n\nimport { readFile } from \"node:fs/promises\"\nimport { resolve as resolvePath, dirname } from \"node:path\"\nimport matter from \"gray-matter\"\nimport { z } from \"zod\"\n\nexport const MULTI_AGENT_RUNTIME_SCHEMA = \"agentruntimes/v1\"\nexport const MULTI_AGENT_RUNTIME_KIND = \"MultiAgentRuntime\"\n\nconst AdapterConfigSchema = z\n  .object({\n    kind: z.string().min(1),\n  })\n  .loose()\n\nconst ParticipantConfigSchema = z\n  .object({\n    command: z.string().min(1).optional(),\n    args: z.array(z.string()).optional(),\n    model: z.string().min(1).optional(),\n  })\n  .loose()\n\nconst ParticipantManifestSchema = z\n  .object({\n    id: z.string().min(1),\n    executor: z.string().min(1),\n    displayName: z.string().min(1).optional(),\n    role: z.string().optional(),\n    config: ParticipantConfigSchema.optional(),\n    meta: z.record(z.string(), z.unknown()).optional(),\n  })\n  .loose()\n\nexport type ParticipantManifestConfig = z.infer<typeof ParticipantConfigSchema>\n\nexport const MultiAgentRuntimeManifestSchema = z\n  .object({\n    schema: z.literal(MULTI_AGENT_RUNTIME_SCHEMA),\n    kind: z.literal(MULTI_AGENT_RUNTIME_KIND),\n    id: z.string().min(1),\n    participants: z.array(ParticipantManifestSchema).min(1),\n    substrate: AdapterConfigSchema,\n    dispatcher: AdapterConfigSchema,\n    state: AdapterConfigSchema.optional(),\n    lifecycle: z\n      .object({\n        onTurnEnd: z.boolean().optional(),\n        onMention: z.boolean().optional(),\n        onIdle: z.boolean().optional(),\n      })\n      .optional(),\n  })\n  .loose()\n\nexport type MultiAgentRuntimeManifest = z.infer<\n  typeof MultiAgentRuntimeManifestSchema\n>\n\nexport type LoadedManifest = {\n  readonly manifest: MultiAgentRuntimeManifest\n  readonly body: string\n  readonly path: string\n  /** Absolute directory of the manifest file — adapter configs that reference paths resolve relative to this. */\n  readonly baseDir: string\n}\n\nexport function parseManifest(source: string): MultiAgentRuntimeManifest {\n  const parsed = matter(source)\n  return MultiAgentRuntimeManifestSchema.parse(parsed.data)\n}\n\nexport async function loadManifest(path: string): Promise<LoadedManifest> {\n  const abs = resolvePath(path)\n  const raw = await readFile(abs, \"utf8\")\n  const parsed = matter(raw)\n  const manifest = MultiAgentRuntimeManifestSchema.parse(parsed.data)\n  return {\n    manifest,\n    body: parsed.content,\n    path: abs,\n    baseDir: dirname(abs),\n  }\n}\n\n/** Resolve a path string from a manifest field, relative to the manifest's directory. */\nexport function resolveManifestPath(loaded: LoadedManifest, value: string): string {\n  return resolvePath(loaded.baseDir, value)\n}\n"]}

package/dist/ports.d.ts

@@ -1,3 +1,6 @@
+import { TurnId, ParticipantId, Telemetry } from '@agentproto/telemetry';
+export { ParticipantId, Telemetry, TelemetryEvent, TurnId } from '@agentproto/telemetry';
+
 /**
  * Port contracts for the MultiAgentRuntime kernel.
  *
@@ -6,8 +9,7 @@
  * the kernel dispatches polymorphically by looking up factories in the
  * registry, never by matching kind strings inside the kernel itself.
  */
-type ParticipantId = string;
-type TurnId = string;
+
 type Turn = {
     readonly id: TurnId;
     readonly participantId: ParticipantId;
@@ -25,12 +27,18 @@ interface Substrate {
     /** Snapshot. If `since` is provided, returns turns strictly newer than that TurnId, oldest first. */
     read(since?: TurnId): Promise<readonly Turn[]>;
 }
+type ParticipantConfig = {
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly model?: string;
+};
 type ParticipantDescriptor = {
     readonly id: ParticipantId;
     readonly displayName: string;
-    /** Executor kind — keys into RuntimePorts.executors. e.g. "agent-cli". */
+    /** Executor kind — e.g. "agent-cli". The runtime looks up the concrete executor per participant. */
     readonly executor: string;
     readonly role?: string;
+    readonly config?: ParticipantConfig;
     readonly meta?: Readonly<Record<string, unknown>>;
 };
 type ParticipantExecuteInput = {
@@ -71,82 +79,6 @@ interface Lifecycle {
     onMention?(target: ParticipantId, byTurn: Turn): Promise<void> | void;
     onIdle?(): Promise<void> | void;
 }
-/**
- * Discriminated union of every event the kernel emits during a cycle.
- *
- * Every event carries `cycleId` (a per-cycle ULID-ish identifier) and
- * `at` (ISO timestamp), so a sink can rebuild OTEL-style spans by
- * grouping on cycleId.
- *
- * Sinks MUST tolerate unknown kinds — future kernel versions may add
- * event types under the same `agentproto/telemetry/v1` schema.
- */
-type TelemetryEvent = {
-    readonly kind: "cycle.started";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly since?: TurnId;
-} | {
-    readonly kind: "substrate.read";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly substrateKind: string;
-    readonly turnCount: number;
-    readonly durationMs: number;
-} | {
-    readonly kind: "dispatch.decided";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly dispatcherKind: string;
-    readonly selected: readonly ParticipantId[];
-    readonly durationMs: number;
-} | {
-    readonly kind: "participant.started";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly participantId: ParticipantId;
-    readonly executorKind: string;
-} | {
-    readonly kind: "participant.finished";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly participantId: ParticipantId;
-    readonly executorKind: string;
-    readonly durationMs: number;
-    readonly contentLength: number;
-} | {
-    readonly kind: "participant.failed";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly participantId: ParticipantId;
-    readonly executorKind: string;
-    readonly error: string;
-} | {
-    readonly kind: "substrate.appended";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly turnId: TurnId;
-    readonly participantId: ParticipantId;
-} | {
-    readonly kind: "state.written";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly participantId: ParticipantId;
-} | {
-    readonly kind: "cycle.idle";
-    readonly cycleId: string;
-    readonly at: string;
-} | {
-    readonly kind: "cycle.finished";
-    readonly cycleId: string;
-    readonly at: string;
-    readonly outcome: "executed" | "idle";
-    readonly turnsAppended: number;
-    readonly durationMs: number;
-};
-interface Telemetry {
-    emit(event: TelemetryEvent): void;
-}
 type RuntimePorts = {
     readonly substrate: Substrate;
     readonly dispatcher: Dispatcher;
@@ -159,7 +91,8 @@ type RuntimePorts = {
      */
     readonly telemetry?: Telemetry;
     readonly participants: readonly ParticipantDescriptor[];
-    readonly executors: ReadonlyMap<string, ParticipantExecutor>;
+    /** One executor instance per participant (keyed by participant id), so per-participant overrides are honored. */
+    readonly executors: ReadonlyMap<ParticipantId, ParticipantExecutor>;
 };
 
-export type { Dispatcher, DispatcherInput, Lifecycle, ParticipantDescriptor, ParticipantExecuteInput, ParticipantExecuteOutput, ParticipantExecutor, ParticipantId, RuntimePorts, StateStore, Substrate, Telemetry, TelemetryEvent, Turn, TurnId, TurnInput };
+export type { Dispatcher, DispatcherInput, Lifecycle, ParticipantConfig, ParticipantDescriptor, ParticipantExecuteInput, ParticipantExecuteOutput, ParticipantExecutor, RuntimePorts, StateStore, Substrate, Turn, TurnInput };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/agent-runtime",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0",
   "description": "@agentproto/agent-runtime — MultiAgentRuntime kernel: swappable ports (substrate, dispatcher, participant executors, state, lifecycle, effectors) plus reference adapters (file journal substrate, mention dispatcher, fs state store, agent-cli participant). Transport-specific adapters (chat servers, MCP bridges, etc.) ship in separate packages and register through the agentproto CLI's plugin API.",
   "keywords": [
     "agentproto",
@@ -84,7 +84,8 @@
   "dependencies": {
     "gray-matter": "^4.0.3",
     "zod": "^4.4.3",
-    "@agentproto/cli-exec": "0.1.0-alpha.1"
+    "@agentproto/cli-exec": "0.1.0-alpha.1",
+    "@agentproto/telemetry": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",