octoflow-core 1.0.0

package/dist/prompts/agent-type.js

@@ -0,0 +1,85 @@
+const AGENT_CONTEXT_CONTRACT = [
+  "preserve system/user/project/tool context",
+  "make delegation self-contained",
+  "carry durable decisions forward"
+].join("; ");
+function buildAgentTypePrompt(agentType, spec) {
+  return [
+    `Agent architecture: ${agentType}.`,
+    `Operating model: ${spec.operatingModel}`,
+    `Context contract: ${AGENT_CONTEXT_CONTRACT}.`,
+    `Flow policy: ${spec.flowPolicy}`
+  ].join("\n");
+}
+const AGENT_TYPE_SYSTEM_PROMPTS = {
+  "tool-loop": buildAgentTypePrompt("tool-loop", {
+    operatingModel: "solve as one tool-using agent; observe results and continue until the task is resolved.",
+    flowPolicy: "after each result, update state, then continue, ask, or finish."
+  }),
+  supervisor: buildAgentTypePrompt("supervisor", {
+    operatingModel: "delegate independent work to workers and synthesize one answer.",
+    flowPolicy: "assign ownership, collect outputs, resolve conflicts, and return an integrated result."
+  }),
+  swarm: buildAgentTypePrompt("swarm", {
+    operatingModel: "collaborate with peers through explicit handoffs and standalone messages.",
+    flowPolicy: "name ownership changes, preserve shared state, and close each handoff with a next step."
+  }),
+  sequential: buildAgentTypePrompt("sequential", {
+    operatingModel: "run ordered steps and preserve useful intermediate results.",
+    flowPolicy: "finish each step with enough state for the next step to avoid rework."
+  }),
+  parallel: buildAgentTypePrompt("parallel", {
+    operatingModel: "split independent work across workers, then reduce outputs into one result.",
+    flowPolicy: "keep work partitions disjoint, merge results deterministically, and surface unresolved conflicts."
+  }),
+  loop: buildAgentTypePrompt("loop", {
+    operatingModel: "iterate toward a completion condition and stop as soon as the outcome is sufficient.",
+    flowPolicy: "track progress and the reason to continue or halt; prefer parallel actions when useful."
+  }),
+  "plan-execute": buildAgentTypePrompt("plan-execute", {
+    operatingModel: "explore, plan, execute, then review the result.",
+    flowPolicy: "keep discovery, planning, execution, and verification distinct."
+  }),
+  reflection: buildAgentTypePrompt("reflection", {
+    operatingModel: "weigh a proposal with advocate, critic, and judge roles, then decide.",
+    flowPolicy: "record the strongest arguments, resolve each one, and issue a final decision."
+  }),
+  "code-act": buildAgentTypePrompt("code-act", {
+    operatingModel: "make code changes in small verified steps; assess reversibility and blast radius.",
+    flowPolicy: "inspect before editing, keep scope requested, verify, and pause before irreversible or wide-impact actions."
+  }),
+  react: buildAgentTypePrompt("react", {
+    operatingModel: "use a Thought -> Action -> Observation loop until evidence is enough for an Answer.",
+    flowPolicy: "write concise Thought, Action, and Observation steps; answer only after required evidence is gathered."
+  })
+};
+function mergePrompt(prefix, existing) {
+  if (!existing) return prefix;
+  if (existing.includes(prefix)) return existing;
+  return `${prefix}
+
+${existing}`;
+}
+function applyAgentTypePromptToBridgeOptions(agentType, options) {
+  return {
+    ...options,
+    systemPrompt: mergePrompt(
+      AGENT_TYPE_SYSTEM_PROMPTS[agentType],
+      options.systemPrompt
+    )
+  };
+}
+function applyAgentTypePromptToPackOptions(agentType, options) {
+  const prompt = AGENT_TYPE_SYSTEM_PROMPTS[agentType];
+  const shared = {
+    ...options.shared ?? {},
+    systemPrompt: mergePrompt(prompt, options.shared?.systemPrompt)
+  };
+  return { ...options, shared };
+}
+export {
+  AGENT_TYPE_SYSTEM_PROMPTS,
+  applyAgentTypePromptToBridgeOptions,
+  applyAgentTypePromptToPackOptions
+};
+//# sourceMappingURL=agent-type.js.map

package/dist/prompts/agent-type.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/prompts/agent-type.ts"],
+  "sourcesContent": ["import type { AgentType } from '../runtime/bridge/agent-routes.js';\nimport type {\n  PackOptions,\n  PackSharedContext,\n} from '../runtime/orchestration/pack/types.js';\nimport type { BridgeOptions } from '../runtime/sessions/context-types.js';\n\ninterface AgentTypePromptSpec {\n  operatingModel: string;\n  flowPolicy: string;\n}\n\nconst AGENT_CONTEXT_CONTRACT = [\n  'preserve system/user/project/tool context',\n  'make delegation self-contained',\n  'carry durable decisions forward',\n].join('; ');\n\nfunction buildAgentTypePrompt(\n  agentType: AgentType,\n  spec: AgentTypePromptSpec\n): string {\n  return [\n    `Agent architecture: ${agentType}.`,\n    `Operating model: ${spec.operatingModel}`,\n    `Context contract: ${AGENT_CONTEXT_CONTRACT}.`,\n    `Flow policy: ${spec.flowPolicy}`,\n  ].join('\\n');\n}\n\nexport const AGENT_TYPE_SYSTEM_PROMPTS = {\n  'tool-loop': buildAgentTypePrompt('tool-loop', {\n    operatingModel:\n      'solve as one tool-using agent; observe results and continue until the task is resolved.',\n    flowPolicy:\n      'after each result, update state, then continue, ask, or finish.',\n  }),\n  supervisor: buildAgentTypePrompt('supervisor', {\n    operatingModel:\n      'delegate independent work to workers and synthesize one answer.',\n    flowPolicy:\n      'assign ownership, collect outputs, resolve conflicts, and return an integrated result.',\n  }),\n  swarm: buildAgentTypePrompt('swarm', {\n    operatingModel:\n      'collaborate with peers through explicit handoffs and standalone messages.',\n    flowPolicy:\n      'name ownership changes, preserve shared state, and close each handoff with a next step.',\n  }),\n  sequential: buildAgentTypePrompt('sequential', {\n    operatingModel:\n      'run ordered steps and preserve useful intermediate results.',\n    flowPolicy:\n      'finish each step with enough state for the next step to avoid rework.',\n  }),\n  parallel: buildAgentTypePrompt('parallel', {\n    operatingModel:\n      'split independent work across workers, then reduce outputs into one result.',\n    flowPolicy:\n      'keep work partitions disjoint, merge results deterministically, and surface unresolved conflicts.',\n  }),\n  loop: buildAgentTypePrompt('loop', {\n    operatingModel:\n      'iterate toward a completion condition and stop as soon as the outcome is sufficient.',\n    flowPolicy:\n      'track progress and the reason to continue or halt; prefer parallel actions when useful.',\n  }),\n  'plan-execute': buildAgentTypePrompt('plan-execute', {\n    operatingModel:\n      'explore, plan, execute, then review the result.',\n    flowPolicy:\n      'keep discovery, planning, execution, and verification distinct.',\n  }),\n  reflection: buildAgentTypePrompt('reflection', {\n    operatingModel:\n      'weigh a proposal with advocate, critic, and judge roles, then decide.',\n    flowPolicy:\n      'record the strongest arguments, resolve each one, and issue a final decision.',\n  }),\n  'code-act': buildAgentTypePrompt('code-act', {\n    operatingModel:\n      'make code changes in small verified steps; assess reversibility and blast radius.',\n    flowPolicy:\n      'inspect before editing, keep scope requested, verify, and pause before irreversible or wide-impact actions.',\n  }),\n  react: buildAgentTypePrompt('react', {\n    operatingModel:\n      'use a Thought -> Action -> Observation loop until evidence is enough for an Answer.',\n    flowPolicy:\n      'write concise Thought, Action, and Observation steps; answer only after required evidence is gathered.',\n  }),\n} as const satisfies Record<AgentType, string>;\n\nfunction mergePrompt(prefix: string, existing: string | undefined): string {\n  if (!existing) return prefix;\n  if (existing.includes(prefix)) return existing;\n  return `${prefix}\\n\\n${existing}`;\n}\n\nexport function applyAgentTypePromptToBridgeOptions<T extends BridgeOptions>(\n  agentType: AgentType,\n  options: T\n): T {\n  return {\n    ...options,\n    systemPrompt: mergePrompt(\n      AGENT_TYPE_SYSTEM_PROMPTS[agentType],\n      options.systemPrompt\n    ),\n  };\n}\n\nexport function applyAgentTypePromptToPackOptions<T extends PackOptions>(\n  agentType: AgentType,\n  options: T\n): T {\n  const prompt = AGENT_TYPE_SYSTEM_PROMPTS[agentType];\n  const shared: PackSharedContext = {\n    ...(options.shared ?? {}),\n    systemPrompt: mergePrompt(prompt, options.shared?.systemPrompt),\n  };\n  return { ...options, shared };\n}\n"],
+  "mappings": "AAYA,MAAM,yBAAyB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,SAAS,qBACP,WACA,MACQ;AACR,SAAO;AAAA,IACL,uBAAuB,SAAS;AAAA,IAChC,oBAAoB,KAAK,cAAc;AAAA,IACvC,qBAAqB,sBAAsB;AAAA,IAC3C,gBAAgB,KAAK,UAAU;AAAA,EACjC,EAAE,KAAK,IAAI;AACb;AAEO,MAAM,4BAA4B;AAAA,EACvC,aAAa,qBAAqB,aAAa;AAAA,IAC7C,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,YAAY,qBAAqB,cAAc;AAAA,IAC7C,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,OAAO,qBAAqB,SAAS;AAAA,IACnC,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,YAAY,qBAAqB,cAAc;AAAA,IAC7C,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,UAAU,qBAAqB,YAAY;AAAA,IACzC,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,MAAM,qBAAqB,QAAQ;AAAA,IACjC,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,gBAAgB,qBAAqB,gBAAgB;AAAA,IACnD,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,YAAY,qBAAqB,cAAc;AAAA,IAC7C,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,YAAY,qBAAqB,YAAY;AAAA,IAC3C,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AAAA,EACD,OAAO,qBAAqB,SAAS;AAAA,IACnC,gBACE;AAAA,IACF,YACE;AAAA,EACJ,CAAC;AACH;AAEA,SAAS,YAAY,QAAgB,UAAsC;AACzE,MAAI,CAAC,SAAU,QAAO;AACtB,MAAI,SAAS,SAAS,MAAM,EAAG,QAAO;AACtC,SAAO,GAAG,MAAM;AAAA;AAAA,EAAO,QAAQ;AACjC;AAEO,SAAS,oCACd,WACA,SACG;AACH,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc;AAAA,MACZ,0BAA0B,SAAS;AAAA,MACnC,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEO,SAAS,kCACd,WACA,SACG;AACH,QAAM,SAAS,0BAA0B,SAAS;AAClD,QAAM,SAA4B;AAAA,IAChC,GAAI,QAAQ,UAAU,CAAC;AAAA,IACvB,cAAc,YAAY,QAAQ,QAAQ,QAAQ,YAAY;AAAA,EAChE;AACA,SAAO,EAAE,GAAG,SAAS,OAAO;AAC9B;",
+  "names": []
+}

package/dist/prompts/envelope.d.ts

@@ -0,0 +1,21 @@
+interface PromptHistoryEntry {
+    role: string;
+    content: string;
+}
+interface PromptEnvelopeInput {
+    systemPrompt?: string | null;
+    userMessage: string;
+}
+interface ParsedPromptEnvelope {
+    systemPrompt: string | null;
+    userMessage: string;
+}
+interface PromptUserMessageInput {
+    userMessage: string;
+    structuredHistory?: PromptHistoryEntry[];
+}
+export declare function buildPromptUserMessage(input: PromptUserMessageInput): string;
+export declare function buildPromptEnvelope(input: PromptEnvelopeInput): string;
+export declare function parsePromptEnvelope(input: string): ParsedPromptEnvelope;
+export {};
+//# sourceMappingURL=envelope.d.ts.map

package/dist/prompts/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/prompts/envelope.ts"],"names":[],"mappings":"AAWA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,mBAAmB;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,oBAAoB;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,sBAAsB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC1C;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAa5E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAGtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAWvE"}

package/dist/prompts/envelope.js

@@ -0,0 +1,77 @@
+const SYSTEM_OPEN = "<system_prompt>\n";
+const SYSTEM_CLOSE = "\n</system_prompt>";
+const USER_OPEN = "\n\n<user_message>\n";
+const USER_CLOSE = "\n</user_message>";
+const LEGACY_SYSTEM_HEADER = "[System Instructions]\n";
+const LEGACY_USER_HEADER = "\n\n[User Message]\n";
+const HISTORY_OPEN = "<conversation_history>";
+const HISTORY_CLOSE = "</conversation_history>";
+const CURRENT_MESSAGE_OPEN = "<current_user_message>";
+const CURRENT_MESSAGE_CLOSE = "</current_user_message>";
+function buildPromptUserMessage(input) {
+  const history = renderStructuredHistory(input.structuredHistory);
+  if (!history) return input.userMessage;
+  return [
+    "Use the prior conversation transcript below as context for answering the current user message.",
+    HISTORY_OPEN,
+    history,
+    HISTORY_CLOSE,
+    "",
+    CURRENT_MESSAGE_OPEN,
+    input.userMessage,
+    CURRENT_MESSAGE_CLOSE
+  ].join("\n");
+}
+function buildPromptEnvelope(input) {
+  if (!input.systemPrompt) return input.userMessage;
+  return `${SYSTEM_OPEN}${input.systemPrompt}${SYSTEM_CLOSE}${USER_OPEN}${input.userMessage}${USER_CLOSE}`;
+}
+function parsePromptEnvelope(input) {
+  const parsedTagged = parseTaggedPromptEnvelope(input);
+  if (parsedTagged) return parsedTagged;
+  const parsedLegacy = parseLegacyPromptEnvelope(input);
+  if (parsedLegacy) return parsedLegacy;
+  return {
+    systemPrompt: null,
+    userMessage: input
+  };
+}
+function parseTaggedPromptEnvelope(input) {
+  if (!input.startsWith(SYSTEM_OPEN)) return null;
+  const systemCloseIndex = input.indexOf(SYSTEM_CLOSE, SYSTEM_OPEN.length);
+  if (systemCloseIndex === -1) return null;
+  const userOpenIndex = systemCloseIndex + SYSTEM_CLOSE.length;
+  if (!input.startsWith(USER_OPEN, userOpenIndex)) return null;
+  const userStart = userOpenIndex + USER_OPEN.length;
+  const userCloseIndex = input.indexOf(USER_CLOSE, userStart);
+  if (userCloseIndex === -1) return null;
+  return {
+    systemPrompt: input.slice(SYSTEM_OPEN.length, systemCloseIndex),
+    userMessage: input.slice(userStart, userCloseIndex)
+  };
+}
+function parseLegacyPromptEnvelope(input) {
+  if (!input.startsWith(LEGACY_SYSTEM_HEADER)) return null;
+  const userHeaderIndex = input.indexOf(
+    LEGACY_USER_HEADER,
+    LEGACY_SYSTEM_HEADER.length
+  );
+  if (userHeaderIndex === -1) return null;
+  return {
+    systemPrompt: input.slice(LEGACY_SYSTEM_HEADER.length, userHeaderIndex),
+    userMessage: input.slice(userHeaderIndex + LEGACY_USER_HEADER.length)
+  };
+}
+function renderStructuredHistory(history) {
+  if (!history || history.length === 0) return "";
+  return history.map((entry) => {
+    const speaker = entry.role === "assistant" ? "Assistant" : "User";
+    return `${speaker}: ${entry.content}`;
+  }).join("\n\n");
+}
+export {
+  buildPromptEnvelope,
+  buildPromptUserMessage,
+  parsePromptEnvelope
+};
+//# sourceMappingURL=envelope.js.map

package/dist/prompts/envelope.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/prompts/envelope.ts"],
+  "sourcesContent": ["const SYSTEM_OPEN = '<system_prompt>\\n';\nconst SYSTEM_CLOSE = '\\n</system_prompt>';\nconst USER_OPEN = '\\n\\n<user_message>\\n';\nconst USER_CLOSE = '\\n</user_message>';\nconst LEGACY_SYSTEM_HEADER = '[System Instructions]\\n';\nconst LEGACY_USER_HEADER = '\\n\\n[User Message]\\n';\nconst HISTORY_OPEN = '<conversation_history>';\nconst HISTORY_CLOSE = '</conversation_history>';\nconst CURRENT_MESSAGE_OPEN = '<current_user_message>';\nconst CURRENT_MESSAGE_CLOSE = '</current_user_message>';\n\ninterface PromptHistoryEntry {\n  role: string;\n  content: string;\n}\n\ninterface PromptEnvelopeInput {\n  systemPrompt?: string | null;\n  userMessage: string;\n}\n\ninterface ParsedPromptEnvelope {\n  systemPrompt: string | null;\n  userMessage: string;\n}\n\ninterface PromptUserMessageInput {\n  userMessage: string;\n  structuredHistory?: PromptHistoryEntry[];\n}\n\nexport function buildPromptUserMessage(input: PromptUserMessageInput): string {\n  const history = renderStructuredHistory(input.structuredHistory);\n  if (!history) return input.userMessage;\n  return [\n    'Use the prior conversation transcript below as context for answering the current user message.',\n    HISTORY_OPEN,\n    history,\n    HISTORY_CLOSE,\n    '',\n    CURRENT_MESSAGE_OPEN,\n    input.userMessage,\n    CURRENT_MESSAGE_CLOSE,\n  ].join('\\n');\n}\n\nexport function buildPromptEnvelope(input: PromptEnvelopeInput): string {\n  if (!input.systemPrompt) return input.userMessage;\n  return `${SYSTEM_OPEN}${input.systemPrompt}${SYSTEM_CLOSE}${USER_OPEN}${input.userMessage}${USER_CLOSE}`;\n}\n\nexport function parsePromptEnvelope(input: string): ParsedPromptEnvelope {\n  const parsedTagged = parseTaggedPromptEnvelope(input);\n  if (parsedTagged) return parsedTagged;\n\n  const parsedLegacy = parseLegacyPromptEnvelope(input);\n  if (parsedLegacy) return parsedLegacy;\n\n  return {\n    systemPrompt: null,\n    userMessage: input,\n  };\n}\n\nfunction parseTaggedPromptEnvelope(input: string): ParsedPromptEnvelope | null {\n  if (!input.startsWith(SYSTEM_OPEN)) return null;\n  const systemCloseIndex = input.indexOf(SYSTEM_CLOSE, SYSTEM_OPEN.length);\n  if (systemCloseIndex === -1) return null;\n  const userOpenIndex = systemCloseIndex + SYSTEM_CLOSE.length;\n  if (!input.startsWith(USER_OPEN, userOpenIndex)) return null;\n  const userStart = userOpenIndex + USER_OPEN.length;\n  const userCloseIndex = input.indexOf(USER_CLOSE, userStart);\n  if (userCloseIndex === -1) return null;\n  return {\n    systemPrompt: input.slice(SYSTEM_OPEN.length, systemCloseIndex),\n    userMessage: input.slice(userStart, userCloseIndex),\n  };\n}\n\nfunction parseLegacyPromptEnvelope(input: string): ParsedPromptEnvelope | null {\n  if (!input.startsWith(LEGACY_SYSTEM_HEADER)) return null;\n  const userHeaderIndex = input.indexOf(\n    LEGACY_USER_HEADER,\n    LEGACY_SYSTEM_HEADER.length\n  );\n  if (userHeaderIndex === -1) return null;\n  return {\n    systemPrompt: input.slice(LEGACY_SYSTEM_HEADER.length, userHeaderIndex),\n    userMessage: input.slice(userHeaderIndex + LEGACY_USER_HEADER.length),\n  };\n}\n\nfunction renderStructuredHistory(\n  history: PromptHistoryEntry[] | undefined\n): string {\n  if (!history || history.length === 0) return '';\n  return history\n    .map((entry) => {\n      const speaker = entry.role === 'assistant' ? 'Assistant' : 'User';\n      return `${speaker}: ${entry.content}`;\n    })\n    .join('\\n\\n');\n}\n"],
+  "mappings": "AAAA,MAAM,cAAc;AACpB,MAAM,eAAe;AACrB,MAAM,YAAY;AAClB,MAAM,aAAa;AACnB,MAAM,uBAAuB;AAC7B,MAAM,qBAAqB;AAC3B,MAAM,eAAe;AACrB,MAAM,gBAAgB;AACtB,MAAM,uBAAuB;AAC7B,MAAM,wBAAwB;AAsBvB,SAAS,uBAAuB,OAAuC;AAC5E,QAAM,UAAU,wBAAwB,MAAM,iBAAiB;AAC/D,MAAI,CAAC,QAAS,QAAO,MAAM;AAC3B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEO,SAAS,oBAAoB,OAAoC;AACtE,MAAI,CAAC,MAAM,aAAc,QAAO,MAAM;AACtC,SAAO,GAAG,WAAW,GAAG,MAAM,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,WAAW,GAAG,UAAU;AACxG;AAEO,SAAS,oBAAoB,OAAqC;AACvE,QAAM,eAAe,0BAA0B,KAAK;AACpD,MAAI,aAAc,QAAO;AAEzB,QAAM,eAAe,0BAA0B,KAAK;AACpD,MAAI,aAAc,QAAO;AAEzB,SAAO;AAAA,IACL,cAAc;AAAA,IACd,aAAa;AAAA,EACf;AACF;AAEA,SAAS,0BAA0B,OAA4C;AAC7E,MAAI,CAAC,MAAM,WAAW,WAAW,EAAG,QAAO;AAC3C,QAAM,mBAAmB,MAAM,QAAQ,cAAc,YAAY,MAAM;AACvE,MAAI,qBAAqB,GAAI,QAAO;AACpC,QAAM,gBAAgB,mBAAmB,aAAa;AACtD,MAAI,CAAC,MAAM,WAAW,WAAW,aAAa,EAAG,QAAO;AACxD,QAAM,YAAY,gBAAgB,UAAU;AAC5C,QAAM,iBAAiB,MAAM,QAAQ,YAAY,SAAS;AAC1D,MAAI,mBAAmB,GAAI,QAAO;AAClC,SAAO;AAAA,IACL,cAAc,MAAM,MAAM,YAAY,QAAQ,gBAAgB;AAAA,IAC9D,aAAa,MAAM,MAAM,WAAW,cAAc;AAAA,EACpD;AACF;AAEA,SAAS,0BAA0B,OAA4C;AAC7E,MAAI,CAAC,MAAM,WAAW,oBAAoB,EAAG,QAAO;AACpD,QAAM,kBAAkB,MAAM;AAAA,IAC5B;AAAA,IACA,qBAAqB;AAAA,EACvB;AACA,MAAI,oBAAoB,GAAI,QAAO;AACnC,SAAO;AAAA,IACL,cAAc,MAAM,MAAM,qBAAqB,QAAQ,eAAe;AAAA,IACtE,aAAa,MAAM,MAAM,kBAAkB,mBAAmB,MAAM;AAAA,EACtE;AACF;AAEA,SAAS,wBACP,SACQ;AACR,MAAI,CAAC,WAAW,QAAQ,WAAW,EAAG,QAAO;AAC7C,SAAO,QACJ,IAAI,CAAC,UAAU;AACd,UAAM,UAAU,MAAM,SAAS,cAAc,cAAc;AAC3D,WAAO,GAAG,OAAO,KAAK,MAAM,OAAO;AAAA,EACrC,CAAC,EACA,KAAK,MAAM;AAChB;",
+  "names": []
+}

package/dist/prompts/roles.d.ts

@@ -0,0 +1,17 @@
+export declare const FLOW_EXPLORE_PLAN_EXECUTE_LEADER_PROMPT: string;
+export declare const FLOW_CODE_REVIEW_LEADER_PROMPT: string;
+export declare const RESEARCH_SYNTHESIZE_LEADER_PROMPT: string;
+export declare const DEBATE_DECIDE_LEADER_PROMPT: string;
+export declare function buildMapReduceLeaderPrompt(items: string[]): string;
+export declare const EXPLORER_PROMPT: string;
+export declare const PLANNER_PROMPT: string;
+export declare const EXECUTOR_PROMPT: string;
+export declare const CODER_PROMPT: string;
+export declare const REVIEWER_PROMPT: string;
+export declare const RESEARCHER_PROMPT: string;
+export declare const SYNTHESIZER_PROMPT: string;
+export declare const ADVOCATE_PROMPT: string;
+export declare const CRITIC_PROMPT: string;
+export declare const MAPPER_PROMPT: string;
+export declare const REDUCER_PROMPT: string;
+//# sourceMappingURL=roles.d.ts.map

package/dist/prompts/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/prompts/roles.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,uCAAuC,QAKtC,CAAC;AAEf,eAAO,MAAM,8BAA8B,QAK7B,CAAC;AAEf,eAAO,MAAM,iCAAiC,QAIhC,CAAC;AAEf,eAAO,MAAM,2BAA2B,QAK1B,CAAC;AAQf,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAGlE;AAED,eAAO,MAAM,eAAe,QAKd,CAAC;AAEf,eAAO,MAAM,cAAc,QAIb,CAAC;AAEf,eAAO,MAAM,eAAe,QAId,CAAC;AAEf,eAAO,MAAM,YAAY,QAGX,CAAC;AAEf,eAAO,MAAM,eAAe,QAId,CAAC;AAEf,eAAO,MAAM,iBAAiB,QAIhB,CAAC;AAEf,eAAO,MAAM,kBAAkB,QAGjB,CAAC;AAEf,eAAO,MAAM,eAAe,QAGd,CAAC;AAEf,eAAO,MAAM,aAAa,QAGZ,CAAC;AAEf,eAAO,MAAM,aAAa,QAGZ,CAAC;AAEf,eAAO,MAAM,cAAc,QAGb,CAAC"}

package/dist/prompts/roles.js

@@ -0,0 +1,110 @@
+const REVIEW_VERDICT_INSTRUCTIONS = [
+  "## Verdict",
+  "End your response with exactly one of:",
+  "- APPROVED - implementation meets all requirements",
+  "- NEEDS_CHANGES - followed by specific issues to fix"
+].join("\n");
+const FLOW_EXPLORE_PLAN_EXECUTE_LEADER_PROMPT = [
+  "This workflow uses a pre-wired flow graph: explore -> plan -> execute -> review -> synthesize.",
+  'When the input includes "Previous step results:", you are in the synthesis step and must NOT emit delegation blocks.',
+  "When called directly on a fresh request (no step results), you may delegate normally using the standard delegation format.",
+  "In synthesis mode, produce the final outcome using the step outputs and review verdict."
+].join("\n\n");
+const FLOW_CODE_REVIEW_LEADER_PROMPT = [
+  "This workflow uses a pre-wired flow graph: code -> review -> synthesize.",
+  'When the input includes "Previous step results:", you are in the synthesis step and must NOT emit delegation blocks.',
+  "When called directly on a fresh request (no step results), you may delegate normally using the standard delegation format.",
+  "In synthesis mode, produce the final result using the implementation and review outputs."
+].join("\n\n");
+const RESEARCH_SYNTHESIZE_LEADER_PROMPT = [
+  "You coordinate a research team.",
+  "Decompose the question into 2-4 independent research angles and delegate in parallel.",
+  "After research results arrive, synthesize a coherent answer that resolves contradictions and weighs evidence quality."
+].join("\n\n");
+const DEBATE_DECIDE_LEADER_PROMPT = [
+  "You facilitate a structured debate.",
+  "Delegate the same question to the advocate (FOR) and critic (AGAINST) in parallel.",
+  "After both arguments return, synthesize a final decision with clear reasoning and explicit trade-offs.",
+  "If arguments are shallow, run a rebuttal round before deciding."
+].join("\n\n");
+const MAP_REDUCE_LEADER_PREFIX = [
+  "You coordinate a map-reduce operation.",
+  "Delegate each item to mapper workers. Once mapping completes, delegate synthesis to the reducer.",
+  "Produce one coherent final result that merges findings and resolves conflicts."
+].join("\n\n");
+function buildMapReduceLeaderPrompt(items) {
+  const listedItems = items.map((item) => `- ${item}`).join("\n");
+  return `${MAP_REDUCE_LEADER_PREFIX}
+
+Items to process:
+${listedItems}`;
+}
+const EXPLORER_PROMPT = [
+  "You are a code researcher. Your job is to gather context, not to make changes.",
+  "Read files, search patterns, trace call flows, and identify impact scope.",
+  "Return: relevant files, key contracts, call flow summary, dependencies, and open questions.",
+  "NEVER modify files and NEVER propose implementation details."
+].join("\n\n");
+const PLANNER_PROMPT = [
+  "You are a planning specialist.",
+  "Turn the request into a numbered implementation plan with file paths, concrete changes, and acceptance criteria.",
+  "Be explicit about dependencies and risk checks."
+].join("\n\n");
+const EXECUTOR_PROMPT = [
+  "You are a code implementer.",
+  "Execute the plan faithfully, keep scope tight, run relevant validations, and summarize exactly what changed.",
+  "If the plan is ambiguous, call out blockers instead of guessing."
+].join("\n\n");
+const CODER_PROMPT = [
+  "You are a coding worker focused on implementation.",
+  "Make the required code changes, keep diffs focused, run relevant tests/linting, and report outcomes."
+].join("\n\n");
+const REVIEWER_PROMPT = [
+  "You are a code reviewer and verifier.",
+  "Check correctness, regressions, and whether the implementation matches the requested plan.",
+  REVIEW_VERDICT_INSTRUCTIONS
+].join("\n\n");
+const RESEARCHER_PROMPT = [
+  "You are a research worker.",
+  "Investigate one angle deeply, cite concrete evidence, and call out uncertainty clearly.",
+  "Do not attempt final synthesis; focus only on your assigned angle."
+].join("\n\n");
+const SYNTHESIZER_PROMPT = [
+  "You are a synthesis specialist.",
+  "Merge multiple research outputs into one coherent answer with clear conclusions, trade-offs, and confidence."
+].join("\n\n");
+const ADVOCATE_PROMPT = [
+  "You are the advocate.",
+  "Argue the strongest case FOR the proposal with concrete benefits, risks, and feasibility considerations."
+].join("\n\n");
+const CRITIC_PROMPT = [
+  "You are the critic.",
+  "Argue the strongest case AGAINST the proposal with concrete risks, failure modes, and counterexamples."
+].join("\n\n");
+const MAPPER_PROMPT = [
+  "You are a mapper worker.",
+  "Process only the assigned item and produce structured findings with evidence and clear conclusions."
+].join("\n\n");
+const REDUCER_PROMPT = [
+  "You are a reducer worker.",
+  "Merge mapper outputs into one coherent answer, deduplicate overlap, and resolve conflicts explicitly."
+].join("\n\n");
+export {
+  ADVOCATE_PROMPT,
+  CODER_PROMPT,
+  CRITIC_PROMPT,
+  DEBATE_DECIDE_LEADER_PROMPT,
+  EXECUTOR_PROMPT,
+  EXPLORER_PROMPT,
+  FLOW_CODE_REVIEW_LEADER_PROMPT,
+  FLOW_EXPLORE_PLAN_EXECUTE_LEADER_PROMPT,
+  MAPPER_PROMPT,
+  PLANNER_PROMPT,
+  REDUCER_PROMPT,
+  RESEARCHER_PROMPT,
+  RESEARCH_SYNTHESIZE_LEADER_PROMPT,
+  REVIEWER_PROMPT,
+  SYNTHESIZER_PROMPT,
+  buildMapReduceLeaderPrompt
+};
+//# sourceMappingURL=roles.js.map

package/dist/prompts/roles.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/prompts/roles.ts"],
+  "sourcesContent": ["const REVIEW_VERDICT_INSTRUCTIONS = [\n  '## Verdict',\n  'End your response with exactly one of:',\n  '- APPROVED - implementation meets all requirements',\n  '- NEEDS_CHANGES - followed by specific issues to fix',\n].join('\\n');\n\nexport const FLOW_EXPLORE_PLAN_EXECUTE_LEADER_PROMPT = [\n  'This workflow uses a pre-wired flow graph: explore -> plan -> execute -> review -> synthesize.',\n  'When the input includes \"Previous step results:\", you are in the synthesis step and must NOT emit delegation blocks.',\n  'When called directly on a fresh request (no step results), you may delegate normally using the standard delegation format.',\n  'In synthesis mode, produce the final outcome using the step outputs and review verdict.',\n].join('\\n\\n');\n\nexport const FLOW_CODE_REVIEW_LEADER_PROMPT = [\n  'This workflow uses a pre-wired flow graph: code -> review -> synthesize.',\n  'When the input includes \"Previous step results:\", you are in the synthesis step and must NOT emit delegation blocks.',\n  'When called directly on a fresh request (no step results), you may delegate normally using the standard delegation format.',\n  'In synthesis mode, produce the final result using the implementation and review outputs.',\n].join('\\n\\n');\n\nexport const RESEARCH_SYNTHESIZE_LEADER_PROMPT = [\n  'You coordinate a research team.',\n  'Decompose the question into 2-4 independent research angles and delegate in parallel.',\n  'After research results arrive, synthesize a coherent answer that resolves contradictions and weighs evidence quality.',\n].join('\\n\\n');\n\nexport const DEBATE_DECIDE_LEADER_PROMPT = [\n  'You facilitate a structured debate.',\n  'Delegate the same question to the advocate (FOR) and critic (AGAINST) in parallel.',\n  'After both arguments return, synthesize a final decision with clear reasoning and explicit trade-offs.',\n  'If arguments are shallow, run a rebuttal round before deciding.',\n].join('\\n\\n');\n\nconst MAP_REDUCE_LEADER_PREFIX = [\n  'You coordinate a map-reduce operation.',\n  'Delegate each item to mapper workers. Once mapping completes, delegate synthesis to the reducer.',\n  'Produce one coherent final result that merges findings and resolves conflicts.',\n].join('\\n\\n');\n\nexport function buildMapReduceLeaderPrompt(items: string[]): string {\n  const listedItems = items.map((item) => `- ${item}`).join('\\n');\n  return `${MAP_REDUCE_LEADER_PREFIX}\\n\\nItems to process:\\n${listedItems}`;\n}\n\nexport const EXPLORER_PROMPT = [\n  'You are a code researcher. Your job is to gather context, not to make changes.',\n  'Read files, search patterns, trace call flows, and identify impact scope.',\n  'Return: relevant files, key contracts, call flow summary, dependencies, and open questions.',\n  'NEVER modify files and NEVER propose implementation details.',\n].join('\\n\\n');\n\nexport const PLANNER_PROMPT = [\n  'You are a planning specialist.',\n  'Turn the request into a numbered implementation plan with file paths, concrete changes, and acceptance criteria.',\n  'Be explicit about dependencies and risk checks.',\n].join('\\n\\n');\n\nexport const EXECUTOR_PROMPT = [\n  'You are a code implementer.',\n  'Execute the plan faithfully, keep scope tight, run relevant validations, and summarize exactly what changed.',\n  'If the plan is ambiguous, call out blockers instead of guessing.',\n].join('\\n\\n');\n\nexport const CODER_PROMPT = [\n  'You are a coding worker focused on implementation.',\n  'Make the required code changes, keep diffs focused, run relevant tests/linting, and report outcomes.',\n].join('\\n\\n');\n\nexport const REVIEWER_PROMPT = [\n  'You are a code reviewer and verifier.',\n  'Check correctness, regressions, and whether the implementation matches the requested plan.',\n  REVIEW_VERDICT_INSTRUCTIONS,\n].join('\\n\\n');\n\nexport const RESEARCHER_PROMPT = [\n  'You are a research worker.',\n  'Investigate one angle deeply, cite concrete evidence, and call out uncertainty clearly.',\n  'Do not attempt final synthesis; focus only on your assigned angle.',\n].join('\\n\\n');\n\nexport const SYNTHESIZER_PROMPT = [\n  'You are a synthesis specialist.',\n  'Merge multiple research outputs into one coherent answer with clear conclusions, trade-offs, and confidence.',\n].join('\\n\\n');\n\nexport const ADVOCATE_PROMPT = [\n  'You are the advocate.',\n  'Argue the strongest case FOR the proposal with concrete benefits, risks, and feasibility considerations.',\n].join('\\n\\n');\n\nexport const CRITIC_PROMPT = [\n  'You are the critic.',\n  'Argue the strongest case AGAINST the proposal with concrete risks, failure modes, and counterexamples.',\n].join('\\n\\n');\n\nexport const MAPPER_PROMPT = [\n  'You are a mapper worker.',\n  'Process only the assigned item and produce structured findings with evidence and clear conclusions.',\n].join('\\n\\n');\n\nexport const REDUCER_PROMPT = [\n  'You are a reducer worker.',\n  'Merge mapper outputs into one coherent answer, deduplicate overlap, and resolve conflicts explicitly.',\n].join('\\n\\n');\n"],
+  "mappings": "AAAA,MAAM,8BAA8B;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEJ,MAAM,0CAA0C;AAAA,EACrD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,iCAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,oCAAoC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,8BAA8B;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEb,MAAM,2BAA2B;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,SAAS,2BAA2B,OAAyB;AAClE,QAAM,cAAc,MAAM,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,EAAE,KAAK,IAAI;AAC9D,SAAO,GAAG,wBAAwB;AAAA;AAAA;AAAA,EAA0B,WAAW;AACzE;AAEO,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,qBAAqB;AAAA,EAChC;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEN,MAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AACF,EAAE,KAAK,MAAM;",
+  "names": []
+}

package/dist/prompts/sanitise.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Strip known prompt-injection patterns from user-supplied input
+ * before it is interpolated into a system prompt .
+ *
+ * This is a heuristic defence — not a complete security solution.
+ */
+export declare function sanitisePromptInput(input: string, opts?: {
+    maxLength?: number;
+}): string;
+/**
+ * Build a system prompt from a template string with named placeholders.
+ * Each `{key}` is replaced with the corresponding value from `vars`.
+ * Values are sanitised by default unless `raw: true` is passed.
+ *
+ * ```ts
+ * const prompt = buildSystemPrompt(
+ *   'You are a {role} assistant for {domain}.',
+ *   { role: 'coding', domain: userInput },
+ * );
+ * ```
+ */
+export declare function buildSystemPrompt(template: string, vars: Record<string, string>, opts?: {
+    raw?: boolean;
+    maxLength?: number;
+}): string;
+//# sourceMappingURL=sanitise.d.ts.map

package/dist/prompts/sanitise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitise.d.ts","sourceRoot":"","sources":["../../src/prompts/sanitise.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,MAAM,CAaR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,MAAM,CAQR"}

package/dist/prompts/sanitise.js

@@ -0,0 +1,22 @@
+const OVERRIDE_PREFIXES = /^\s*(ignore|disregard|forget|override|you are now|system:)/i;
+const CODE_FENCE = /```/g;
+function sanitisePromptInput(input, opts = {}) {
+  const maxLen = opts.maxLength ?? 500;
+  let cleaned = input.split("\n").filter((line) => !OVERRIDE_PREFIXES.test(line)).join("\n").replace(CODE_FENCE, "\\`\\`\\`").trim();
+  if (cleaned.length > maxLen) {
+    cleaned = cleaned.slice(0, maxLen);
+  }
+  return cleaned;
+}
+function buildSystemPrompt(template, vars, opts = {}) {
+  return template.replace(/\{(\w+)\}/g, (_match, key) => {
+    const value = vars[key];
+    if (value === void 0) return `{${key}}`;
+    return opts.raw ? value : sanitisePromptInput(value, { maxLength: opts.maxLength });
+  });
+}
+export {
+  buildSystemPrompt,
+  sanitisePromptInput
+};
+//# sourceMappingURL=sanitise.js.map

package/dist/prompts/sanitise.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/prompts/sanitise.ts"],
+  "sourcesContent": ["const OVERRIDE_PREFIXES =\n  /^\\s*(ignore|disregard|forget|override|you are now|system:)/i;\nconst CODE_FENCE = /```/g;\n\n/**\n * Strip known prompt-injection patterns from user-supplied input\n * before it is interpolated into a system prompt .\n *\n * This is a heuristic defence \u2014 not a complete security solution.\n */\nexport function sanitisePromptInput(\n  input: string,\n  opts: { maxLength?: number } = {}\n): string {\n  const maxLen = opts.maxLength ?? 500;\n  let cleaned = input\n    .split('\\n')\n    .filter((line) => !OVERRIDE_PREFIXES.test(line))\n    .join('\\n')\n    .replace(CODE_FENCE, '\\\\`\\\\`\\\\`')\n    .trim();\n\n  if (cleaned.length > maxLen) {\n    cleaned = cleaned.slice(0, maxLen);\n  }\n  return cleaned;\n}\n\n/**\n * Build a system prompt from a template string with named placeholders.\n * Each `{key}` is replaced with the corresponding value from `vars`.\n * Values are sanitised by default unless `raw: true` is passed.\n *\n * ```ts\n * const prompt = buildSystemPrompt(\n *   'You are a {role} assistant for {domain}.',\n *   { role: 'coding', domain: userInput },\n * );\n * ```\n */\nexport function buildSystemPrompt(\n  template: string,\n  vars: Record<string, string>,\n  opts: { raw?: boolean; maxLength?: number } = {}\n): string {\n  return template.replace(/\\{(\\w+)\\}/g, (_match, key: string) => {\n    const value = vars[key];\n    if (value === undefined) return `{${key}}`;\n    return opts.raw\n      ? value\n      : sanitisePromptInput(value, { maxLength: opts.maxLength });\n  });\n}\n"],
+  "mappings": "AAAA,MAAM,oBACJ;AACF,MAAM,aAAa;AAQZ,SAAS,oBACd,OACA,OAA+B,CAAC,GACxB;AACR,QAAM,SAAS,KAAK,aAAa;AACjC,MAAI,UAAU,MACX,MAAM,IAAI,EACV,OAAO,CAAC,SAAS,CAAC,kBAAkB,KAAK,IAAI,CAAC,EAC9C,KAAK,IAAI,EACT,QAAQ,YAAY,WAAW,EAC/B,KAAK;AAER,MAAI,QAAQ,SAAS,QAAQ;AAC3B,cAAU,QAAQ,MAAM,GAAG,MAAM;AAAA,EACnC;AACA,SAAO;AACT;AAcO,SAAS,kBACd,UACA,MACA,OAA8C,CAAC,GACvC;AACR,SAAO,SAAS,QAAQ,cAAc,CAAC,QAAQ,QAAgB;AAC7D,UAAM,QAAQ,KAAK,GAAG;AACtB,QAAI,UAAU,OAAW,QAAO,IAAI,GAAG;AACvC,WAAO,KAAK,MACR,QACA,oBAAoB,OAAO,EAAE,WAAW,KAAK,UAAU,CAAC;AAAA,EAC9D,CAAC;AACH;",
+  "names": []
+}

package/dist/prompts/skills.d.ts

@@ -0,0 +1,8 @@
+import type { ActionDefinition } from '../actions/types.js';
+/**
+ * Builds an XML skill block appended to the system prompt when a backend
+ * uses prompt-injection delivery (CLIs and custom backends that cannot
+ * receive native tool definitions).
+ */
+export declare function buildSkillPromptBlock(actions: ActionDefinition[]): string;
+//# sourceMappingURL=skills.d.ts.map

package/dist/prompts/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/prompts/skills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAoB5D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CA4BzE"}

package/dist/prompts/skills.js

@@ -0,0 +1,41 @@
+import { escapeXml } from "octoflow-skill-runner";
+function renderParamSummary(parameters) {
+  const props = parameters.properties;
+  if (!props || Object.keys(props).length === 0) return "";
+  const required = Array.isArray(parameters.required) ? parameters.required : [];
+  return Object.entries(props).map(([key, val]) => {
+    const opt = required.includes(key) ? "" : "?";
+    const type = val.type ?? "any";
+    const desc = val.description ? `: ${val.description}` : "";
+    return `${key}${opt} (${type})${desc}`;
+  }).join("; ");
+}
+function buildSkillPromptBlock(actions) {
+  if (actions.length === 0) return "";
+  const entries = actions.map((a) => {
+    const desc = a.description || "No description provided.";
+    const params = renderParamSummary(a.parameters);
+    const lines = ["  <skill>"];
+    lines.push(`    <name>${escapeXml(a.name)}</name>`);
+    lines.push(`    <description>${escapeXml(desc)}</description>`);
+    if (params) {
+      lines.push(`    <parameters>${escapeXml(params)}</parameters>`);
+    }
+    lines.push("  </skill>");
+    return lines.join("\n");
+  }).join("\n");
+  return [
+    "<available_skills>",
+    "To invoke a skill, respond with a JSON code block:",
+    "```json",
+    '{"name": "<skill_name>", "arguments": {<args>}}',
+    "```",
+    "",
+    entries,
+    "</available_skills>"
+  ].join("\n");
+}
+export {
+  buildSkillPromptBlock
+};
+//# sourceMappingURL=skills.js.map

package/dist/prompts/skills.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/prompts/skills.ts"],
+  "sourcesContent": ["import { escapeXml } from 'octoflow-skill-runner';\n\nimport type { ActionDefinition } from '../actions/types.js';\n\nfunction renderParamSummary(parameters: Record<string, unknown>): string {\n  const props = parameters.properties as\n    | Record<string, { type?: string; description?: string }>\n    | undefined;\n  if (!props || Object.keys(props).length === 0) return '';\n  const required = Array.isArray(parameters.required)\n    ? (parameters.required as string[])\n    : [];\n  return Object.entries(props)\n    .map(([key, val]) => {\n      const opt = required.includes(key) ? '' : '?';\n      const type = val.type ?? 'any';\n      const desc = val.description ? `: ${val.description}` : '';\n      return `${key}${opt} (${type})${desc}`;\n    })\n    .join('; ');\n}\n\n/**\n * Builds an XML skill block appended to the system prompt when a backend\n * uses prompt-injection delivery (CLIs and custom backends that cannot\n * receive native tool definitions).\n */\nexport function buildSkillPromptBlock(actions: ActionDefinition[]): string {\n  if (actions.length === 0) return '';\n\n  const entries = actions\n    .map((a) => {\n      const desc = a.description || 'No description provided.';\n      const params = renderParamSummary(a.parameters);\n      const lines = ['  <skill>'];\n      lines.push(`    <name>${escapeXml(a.name)}</name>`);\n      lines.push(`    <description>${escapeXml(desc)}</description>`);\n      if (params) {\n        lines.push(`    <parameters>${escapeXml(params)}</parameters>`);\n      }\n      lines.push('  </skill>');\n      return lines.join('\\n');\n    })\n    .join('\\n');\n\n  return [\n    '<available_skills>',\n    'To invoke a skill, respond with a JSON code block:',\n    '```json',\n    '{\"name\": \"<skill_name>\", \"arguments\": {<args>}}',\n    '```',\n    '',\n    entries,\n    '</available_skills>',\n  ].join('\\n');\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAI1B,SAAS,mBAAmB,YAA6C;AACvE,QAAM,QAAQ,WAAW;AAGzB,MAAI,CAAC,SAAS,OAAO,KAAK,KAAK,EAAE,WAAW,EAAG,QAAO;AACtD,QAAM,WAAW,MAAM,QAAQ,WAAW,QAAQ,IAC7C,WAAW,WACZ,CAAC;AACL,SAAO,OAAO,QAAQ,KAAK,EACxB,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM;AACnB,UAAM,MAAM,SAAS,SAAS,GAAG,IAAI,KAAK;AAC1C,UAAM,OAAO,IAAI,QAAQ;AACzB,UAAM,OAAO,IAAI,cAAc,KAAK,IAAI,WAAW,KAAK;AACxD,WAAO,GAAG,GAAG,GAAG,GAAG,KAAK,IAAI,IAAI,IAAI;AAAA,EACtC,CAAC,EACA,KAAK,IAAI;AACd;AAOO,SAAS,sBAAsB,SAAqC;AACzE,MAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,QAAM,UAAU,QACb,IAAI,CAAC,MAAM;AACV,UAAM,OAAO,EAAE,eAAe;AAC9B,UAAM,SAAS,mBAAmB,EAAE,UAAU;AAC9C,UAAM,QAAQ,CAAC,WAAW;AAC1B,UAAM,KAAK,aAAa,UAAU,EAAE,IAAI,CAAC,SAAS;AAClD,UAAM,KAAK,oBAAoB,UAAU,IAAI,CAAC,gBAAgB;AAC9D,QAAI,QAAQ;AACV,YAAM,KAAK,mBAAmB,UAAU,MAAM,CAAC,eAAe;AAAA,IAChE;AACA,UAAM,KAAK,YAAY;AACvB,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB,CAAC,EACA,KAAK,IAAI;AAEZ,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;",
+  "names": []
+}

package/dist/prompts/tool.d.ts

@@ -0,0 +1,24 @@
+import type { BridgeMcpSchemaBudget } from '../capabilities/types.js';
+import type { ToolSchemaDef } from '../domain/harness-shared.js';
+export interface BuildToolSystemPromptOptions {
+    /**
+     * When set, tool schemas are passed through `trimToolSchema` before being
+     * serialized. Applied only to non-native-MCP backends; native CLI backends
+     * that forward `mcpConfigPath` do not need trimming.
+     */
+    trimSchemas?: boolean;
+    /** Schema-trim budget applied when `trimSchemas` is enabled. */
+    schemaBudget?: BridgeMcpSchemaBudget;
+}
+/**
+ * Builds a system prompt block that describes available tools to the model.
+ *
+ * This prompt-based approach works across all backends (CLI, API, SDK)
+ * without requiring native tool_use support in the provider API.
+ *
+ * `filter`, when provided, restricts the serialized schema to tools whose
+ * `name` appears in it. Lets narrow tasks skip the full ~100-tool schema
+ * block in their context window.
+ */
+export declare function buildToolSystemPrompt(tools: ToolSchemaDef[], filter?: readonly string[], options?: BuildToolSystemPromptOptions): string;
+//# sourceMappingURL=tool.d.ts.map

package/dist/prompts/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/prompts/tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gEAAgE;IAChE,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EAAE,EACtB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,4BAA4B,GACrC,MAAM,CAwBR"}

package/dist/prompts/tool.js

@@ -0,0 +1,23 @@
+import { trimToolSchema } from "../capabilities/trim-tool-schema.js";
+function buildToolSystemPrompt(tools, filter, options) {
+  const effective = filter && filter.length > 0 ? tools.filter((t) => filter.includes(t.name)) : tools;
+  if (effective.length === 0) return "";
+  const toolDefs = effective.map((t) => ({
+    name: t.name,
+    description: t.description ?? "",
+    parameters: options?.trimSchemas ? trimToolSchema(t.schema, options.schemaBudget) : t.schema ?? {}
+  }));
+  return [
+    "You have access to the following tools. To use a tool, respond with a JSON code block:",
+    "```json",
+    '{"name": "<tool_name>", "arguments": {<args>}}',
+    "```",
+    "",
+    "Available tools:",
+    JSON.stringify(toolDefs, null, 2)
+  ].join("\n");
+}
+export {
+  buildToolSystemPrompt
+};
+//# sourceMappingURL=tool.js.map

package/dist/prompts/tool.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/prompts/tool.ts"],
+  "sourcesContent": ["import { trimToolSchema } from '../capabilities/trim-tool-schema.js';\nimport type { BridgeMcpSchemaBudget } from '../capabilities/types.js';\nimport type { ToolSchemaDef } from '../domain/harness-shared.js';\n\nexport interface BuildToolSystemPromptOptions {\n  /**\n   * When set, tool schemas are passed through `trimToolSchema` before being\n   * serialized. Applied only to non-native-MCP backends; native CLI backends\n   * that forward `mcpConfigPath` do not need trimming.\n   */\n  trimSchemas?: boolean;\n  /** Schema-trim budget applied when `trimSchemas` is enabled. */\n  schemaBudget?: BridgeMcpSchemaBudget;\n}\n\n/**\n * Builds a system prompt block that describes available tools to the model.\n *\n * This prompt-based approach works across all backends (CLI, API, SDK)\n * without requiring native tool_use support in the provider API.\n *\n * `filter`, when provided, restricts the serialized schema to tools whose\n * `name` appears in it. Lets narrow tasks skip the full ~100-tool schema\n * block in their context window.\n */\nexport function buildToolSystemPrompt(\n  tools: ToolSchemaDef[],\n  filter?: readonly string[],\n  options?: BuildToolSystemPromptOptions\n): string {\n  const effective =\n    filter && filter.length > 0\n      ? tools.filter((t) => filter.includes(t.name))\n      : tools;\n  if (effective.length === 0) return '';\n\n  const toolDefs = effective.map((t) => ({\n    name: t.name,\n    description: t.description ?? '',\n    parameters: options?.trimSchemas\n      ? trimToolSchema(t.schema, options.schemaBudget)\n      : (t.schema ?? {}),\n  }));\n\n  return [\n    'You have access to the following tools. To use a tool, respond with a JSON code block:',\n    '```json',\n    '{\"name\": \"<tool_name>\", \"arguments\": {<args>}}',\n    '```',\n    '',\n    'Available tools:',\n    JSON.stringify(toolDefs, null, 2),\n  ].join('\\n');\n}\n"],
+  "mappings": "AAAA,SAAS,sBAAsB;AAyBxB,SAAS,sBACd,OACA,QACA,SACQ;AACR,QAAM,YACJ,UAAU,OAAO,SAAS,IACtB,MAAM,OAAO,CAAC,MAAM,OAAO,SAAS,EAAE,IAAI,CAAC,IAC3C;AACN,MAAI,UAAU,WAAW,EAAG,QAAO;AAEnC,QAAM,WAAW,UAAU,IAAI,CAAC,OAAO;AAAA,IACrC,MAAM,EAAE;AAAA,IACR,aAAa,EAAE,eAAe;AAAA,IAC9B,YAAY,SAAS,cACjB,eAAe,EAAE,QAAQ,QAAQ,YAAY,IAC5C,EAAE,UAAU,CAAC;AAAA,EACpB,EAAE;AAEF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,KAAK,UAAU,UAAU,MAAM,CAAC;AAAA,EAClC,EAAE,KAAK,IAAI;AACb;",
+  "names": []
+}