@moikapy/origen 0.4.1 → 0.5.0

package/dist/chunk-QF3XSUMT.js

@@ -0,0 +1,333 @@
+// src/soul.ts
+function parseYamlFrontMatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)?$/);
+  if (!match) {
+    return { frontMatter: {}, body: content };
+  }
+  const rawYaml = match[1];
+  const markdownBody = match[2] ?? "";
+  const frontMatter = parseSoulYaml(rawYaml);
+  return { frontMatter, body: markdownBody };
+}
+function parseSoulYaml(raw) {
+  const lines = raw.split("\n").map((l) => l.replace(/\r$/, ""));
+  const { result } = parseBlock(lines, 0, 0);
+  return result;
+}
+function parseBlock(lines, start, baseIndent) {
+  const result = {};
+  let i = start;
+  while (i < lines.length) {
+    const line = lines[i];
+    const indent = lineLengths(line).indent;
+    if (line.trim() === "") {
+      i++;
+      continue;
+    }
+    if (indent < baseIndent) break;
+    const trimmed = line.trim();
+    if (trimmed.startsWith("- ")) {
+      i++;
+      continue;
+    }
+    const kvMatch = trimmed.match(/^([\w][\w.-]*):\s*(.*)$/);
+    if (!kvMatch) {
+      i++;
+      continue;
+    }
+    const key = kvMatch[1];
+    const inlineVal = kvMatch[2].trim();
+    if (inlineVal === "") {
+      const nextLine = i + 1 < lines.length ? lines[i + 1] : "";
+      const nextIndent = nextLine.trim() === "" ? 0 : lineLengths(nextLine).indent;
+      const nextTrimmed = nextLine.trim();
+      if (nextIndent > indent) {
+        if (nextTrimmed.startsWith("- ")) {
+          const { items, nextLine: afterList } = parseList(lines, i + 1, nextIndent);
+          result[key] = items;
+          i = afterList;
+        } else {
+          const { result: nested, nextLine: afterNested } = parseBlock(lines, i + 1, nextIndent);
+          result[key] = nested;
+          i = afterNested;
+        }
+      } else {
+        result[key] = null;
+        i++;
+      }
+    } else {
+      result[key] = parseScalar(inlineVal);
+      i++;
+    }
+  }
+  return { result, nextLine: i };
+}
+function parseList(lines, start, baseIndent) {
+  const items = [];
+  let i = start;
+  while (i < lines.length) {
+    const line = lines[i];
+    const indent = lineLengths(line).indent;
+    if (line.trim() === "") {
+      i++;
+      continue;
+    }
+    if (indent < baseIndent) break;
+    if (!line.trim().startsWith("- ")) break;
+    const value = line.trim().slice(2).trim();
+    items.push(parseScalar(value));
+    i++;
+  }
+  return { items, nextLine: i };
+}
+function parseScalar(value) {
+  if (value === "null" || value === "~") return null;
+  if (value === "true") return true;
+  if (value === "false") return false;
+  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1);
+  }
+  if (/^-?\d+$/.test(value)) return parseInt(value, 10);
+  if (/^-?\d+\.\d+$/.test(value)) return parseFloat(value);
+  if (value.startsWith("[") && value.endsWith("]")) {
+    return value.slice(1, -1).split(",").map((s) => parseScalar(s.trim()));
+  }
+  return value;
+}
+function lineLengths(line) {
+  const match = line.match(/^(\s*)(.*)$/);
+  const indent = match ? match[1].length : 0;
+  const content = match ? match[2] : "";
+  return { indent, content };
+}
+var Soul = class _Soul {
+  config;
+  body;
+  constructor(config, body) {
+    this.config = config;
+    this.body = body;
+  }
+  /** Select a profile and return a new Soul with that profile merged in. */
+  selectProfile(profileName) {
+    const profiles = this.config.profiles ?? ["default"];
+    const overrides = this.config.profile_overrides ?? {};
+    const profileOverrides = overrides[profileName];
+    if (!profiles.includes(profileName) || !profileOverrides) {
+      return this;
+    }
+    const merged = mergeDeep(
+      structuredClone(this.config),
+      profileOverrides
+    );
+    return new _Soul(merged, this.body);
+  }
+  /** Build a system prompt from the Soul definition. */
+  buildPrompt() {
+    const parts = [];
+    const identity = this.config.identity;
+    if (identity) {
+      const role = identity.role ?? this.config.name;
+      const archetype = identity.archetype;
+      parts.push(`You are ${this.config.name}${archetype ? `, a ${archetype}` : ""}${role ? `. Role: ${role}` : ""}.`);
+      if (identity.domain_focus?.length) {
+        parts.push(`Domain expertise: ${identity.domain_focus.join(", ")}.`);
+      }
+      if (identity.non_goals?.length) {
+        parts.push(`Non-goals: ${identity.non_goals.join(", ")}.`);
+      }
+    } else {
+      parts.push(`You are ${this.config.name}.`);
+    }
+    const relationship = this.config.relationship;
+    if (relationship) {
+      if (relationship.stance) {
+        const stanceMap = {
+          subordinate: "You serve the user's direction.",
+          peer: "You collaborate with the user as a partner.",
+          authoritative: "You provide expert guidance and direction.",
+          adversarial: "You challenge the user's assumptions to improve outcomes."
+        };
+        parts.push(stanceMap[relationship.stance] ?? "");
+      }
+      if (relationship.user_model_default) {
+        const userModelMap = {
+          novice: "Assume the user is new to this domain. Explain terms and concepts.",
+          intermediate: "Assume moderate familiarity. Explain only when needed.",
+          expert: "Be concise. The user knows the domain well.",
+          unknown: "Adapt your explanation depth to the user's apparent knowledge level."
+        };
+        parts.push(userModelMap[relationship.user_model_default] ?? "");
+      }
+    }
+    const values = this.config.values;
+    if (values?.priorities?.length) {
+      parts.push(`
+## Priorities (in order)
+${values.priorities.map((p, i) => `${i + 1}. ${p}`).join("\n")}`);
+    }
+    if (values?.taboo?.length) {
+      parts.push(`
+## Forbidden patterns
+${values.taboo.map((t) => `- ${t}`).join("\n")}`);
+    }
+    const voice = this.config.voice;
+    if (voice) {
+      const voiceParts = ["\n## Voice & Style"];
+      if (voice.formality !== void 0) {
+        const level = voice.formality <= 30 ? "very casual" : voice.formality <= 60 ? "moderately formal" : voice.formality <= 80 ? "professional" : "highly formal";
+        voiceParts.push(`Formality: ${level} (${voice.formality}/100).`);
+      }
+      if (voice.warmth !== void 0) {
+        const level = voice.warmth <= 30 ? "cold/detached" : voice.warmth <= 60 ? "neutral" : voice.warmth <= 80 ? "warm and approachable" : "very friendly and encouraging";
+        voiceParts.push(`Tone: ${level} (${voice.warmth}/100).`);
+      }
+      if (voice.verbosity !== void 0) {
+        const level = voice.verbosity <= 25 ? "extremely concise" : voice.verbosity <= 50 ? "concise" : voice.verbosity <= 75 ? "moderate length" : "thorough and detailed";
+        voiceParts.push(`Brevity: ${level} (${voice.verbosity}/100).`);
+      }
+      if (voice.jargon !== void 0) {
+        const level = voice.jargon <= 30 ? "use plain language" : voice.jargon <= 60 ? "use moderate technical terms" : "use domain-specific terminology freely";
+        voiceParts.push(`Jargon: ${level} (${voice.jargon}/100).`);
+      }
+      if (voice.formatting) voiceParts.push(`Formatting: ${voice.formatting}.`);
+      if (voice.banned_phrases?.length) voiceParts.push(`Never say: ${voice.banned_phrases.map((p) => `"${p}"`).join(", ")}.`);
+      if (voice.preferred_phrases?.length) voiceParts.push(`Prefer: ${voice.preferred_phrases.map((p) => `"${p}"`).join(", ")}.`);
+      if (voice.emoji_policy && voice.emoji_policy !== "rare") voiceParts.push(`Emoji usage: ${voice.emoji_policy}.`);
+      parts.push(voiceParts.join(" "));
+    }
+    const interaction = this.config.interaction;
+    if (interaction) {
+      const interactionParts = ["\n## Interaction Policy"];
+      if (interaction.clarifying_questions) {
+        const qMap = {
+          never: "Never ask clarifying questions. Make reasonable assumptions.",
+          when_ambiguous: "Ask clarifying questions only when the query is ambiguous.",
+          always: "Always confirm your understanding before responding."
+        };
+        interactionParts.push(qMap[interaction.clarifying_questions] ?? "");
+      }
+      if (interaction.uncertainty) {
+        const uMap = {
+          explicit: "Explicitly mark uncertain information. Say when you're not sure.",
+          implicit: "Use hedging language (might, possibly, could) for uncertain claims.",
+          never: "Never express uncertainty. State your best answer confidently."
+        };
+        interactionParts.push(uMap[interaction.uncertainty] ?? "");
+      }
+      if (interaction.disagreement) {
+        const dMap = {
+          soft: "Disagree gently. Acknowledge the user's perspective first.",
+          neutral: "State disagreements directly but politely.",
+          direct: "Challenge incorrect views directly. Don't soften disagreements."
+        };
+        interactionParts.push(dMap[interaction.disagreement] ?? "");
+      }
+      if (interaction.confirmations === "none") {
+        interactionParts.push("Don't ask for confirmation before acting. Just do it.");
+      }
+      parts.push(interactionParts.join(" "));
+    }
+    const cognition = this.config.cognition;
+    if (cognition) {
+      const cogParts = ["\n## Cognition"];
+      if (cognition.mode) {
+        const modeMap = {
+          analytical: "Think analytically. Break problems down, examine evidence, reason step by step.",
+          creative: "Think creatively. Generate novel ideas, make unexpected connections.",
+          operational: "Focus on execution. Prioritize working solutions over theory.",
+          exploratory: "Explore broadly. Consider many angles before committing to an answer.",
+          teaching: "Teach and explain. Build understanding progressively from basics.",
+          mixed: "Adapt your thinking mode to the task at hand."
+        };
+        cogParts.push(modeMap[cognition.mode] ?? "");
+      }
+      if (cognition.verification?.fact_checking) {
+        const fcMap = {
+          none: "No explicit fact-checking.",
+          light: "Verify key claims before stating them.",
+          strict: "Always verify claims. Never state unverified information as fact."
+        };
+        cogParts.push(fcMap[cognition.verification.fact_checking] ?? "");
+      }
+      parts.push(cogParts.join(" "));
+    }
+    const safety = this.config.safety;
+    if (safety) {
+      const safetyParts = ["\n## Safety"];
+      if (safety.speculation) {
+        const specMap = {
+          allow: "You may speculate freely.",
+          mark: "Mark speculative content clearly (e.g., 'I believe', 'likely', 'possibly').",
+          avoid: "Do not speculate. Only state what you can verify."
+        };
+        safetyParts.push(specMap[safety.speculation] ?? "");
+      }
+      if (safety.refusal_style) {
+        const refMap = {
+          brief: "Refuse briefly. No lectures.",
+          explain: "Explain why you're refusing when you decline a request.",
+          policy_cite: "Cite specific policies when refusing requests."
+        };
+        safetyParts.push(refMap[safety.refusal_style] ?? "");
+      }
+      if (safety.no_fabrication) safetyParts.push("Never fabricate information. If you don't know, say so.");
+      if (safety.no_false_certainty) safetyParts.push("Never present uncertain information as certain.");
+      parts.push(safetyParts.join(" "));
+    }
+    const actions = this.config.actions;
+    if (actions) {
+      const actParts = ["\n## Actions"];
+      const toolMap = {
+        avoid_tools: "Minimize tool use. Answer from knowledge when possible.",
+        when_needed: "Use tools when they would improve your answer.",
+        prefer_tools: "Proactively use available tools. Always verify with tools rather than memory."
+      };
+      actParts.push(toolMap[actions.when_to_use_tools] ?? "");
+      if (actions.explain_actions === "brief" || actions.explain_actions === "full") {
+        actParts.push(actions.explain_actions === "full" ? "Explain what you're doing before and after tool use." : "Briefly explain tool use.");
+      }
+      parts.push(actParts.join(" "));
+    }
+    if (this.body.trim()) {
+      parts.push(`
+## Additional Instructions
+
+${this.body.trim()}`);
+    }
+    return parts.join("\n\n");
+  }
+  get defaultProfile() {
+    return this.config.profiles?.[0] ?? "default";
+  }
+  get profileNames() {
+    return this.config.profiles ?? ["default"];
+  }
+};
+function loadSoul(content) {
+  const { frontMatter, body } = parseYamlFrontMatter(content);
+  const config = frontMatter;
+  if (!config.id) throw new Error("Soul.md missing required field: id");
+  if (!config.name) throw new Error("Soul.md missing required field: name");
+  return new Soul(config, body);
+}
+function mergeDeep(base, overlay) {
+  const result = { ...base };
+  for (const key of Object.keys(overlay)) {
+    const baseVal = result[key];
+    const overVal = overlay[key];
+    if (overVal === null) {
+      result[key] = null;
+    } else if (typeof baseVal === "object" && baseVal !== null && !Array.isArray(baseVal) && typeof overVal === "object" && overVal !== null && !Array.isArray(overVal)) {
+      result[key] = mergeDeep(baseVal, overVal);
+    } else {
+      result[key] = overVal;
+    }
+  }
+  return result;
+}
+
+export {
+  Soul,
+  loadSoul
+};
+//# sourceMappingURL=chunk-QF3XSUMT.js.map

package/dist/chunk-QF3XSUMT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/soul.ts"],"sourcesContent":["/**\n * Soul.md parser for Origen agent personas.\n *\n * Implements Soul.md Standard (RFC-1, v1.0.0-rc1):\n * https://github.com/rokoss21/soul.md\n *\n * Parses a portable, provider-agnostic persona definition and produces\n * a system prompt, runtime config, and profile overlays for Origen.\n *\n * Usage:\n *   import { Soul, loadSoul } from \"@moikapy/origen/soul\";\n *\n *   const soul = loadSoul(soulMdContent);\n *   const systemPrompt = soul.buildPrompt();\n *   const profile = soul.selectProfile(\"concise\");\n */\n\n// ── YAML front matter parser ──────────────────────────────────────────\n\nfunction parseYamlFrontMatter(content: string): { frontMatter: Record<string, unknown>; body: string } {\n  const match = content.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)?$/);\n  if (!match) {\n    return { frontMatter: {}, body: content };\n  }\n  const rawYaml = match[1];\n  const markdownBody = match[2] ?? \"\";\n  const frontMatter = parseSoulYaml(rawYaml);\n  return { frontMatter, body: markdownBody };\n}\n\n/**\n * Minimal YAML parser for Soul.md front matter.\n * Handles maps, sequences, inline values, and quoted strings.\n * Does NOT support anchors, aliases, merge keys, or complex types.\n */\nfunction parseSoulYaml(raw: string): Record<string, unknown> {\n  const lines = raw.split(\"\\n\").map((l) => l.replace(/\\r$/, \"\"));\n  const { result } = parseBlock(lines, 0, 0);\n  return result;\n}\n\ninterface BlockResult {\n  result: Record<string, unknown>;\n  nextLine: number;\n}\n\nfunction parseBlock(lines: string[], start: number, baseIndent: number): BlockResult {\n  const result: Record<string, unknown> = {};\n  let i = start;\n\n  while (i < lines.length) {\n    const line = lines[i];\n    const indent = lineLengths(line).indent;\n\n    if (line.trim() === \"\") { i++; continue; }\n    if (indent < baseIndent) break; // End of this block\n\n    const trimmed = line.trim();\n\n    // Skip list items at top level of a map block (shouldn't happen, but guard)\n    if (trimmed.startsWith(\"- \")) { i++; continue; }\n\n    // key: value\n    const kvMatch = trimmed.match(/^([\\w][\\w.-]*):\\s*(.*)$/);\n    if (!kvMatch) { i++; continue; }\n\n    const key = kvMatch[1];\n    const inlineVal = kvMatch[2].trim();\n\n    if (inlineVal === \"\") {\n      // Value continues on next lines\n      const nextLine = i + 1 < lines.length ? lines[i + 1] : \"\";\n      const nextIndent = nextLine.trim() === \"\" ? 0 : lineLengths(nextLine).indent;\n      const nextTrimmed = nextLine.trim();\n\n      if (nextIndent > indent) {\n        if (nextTrimmed.startsWith(\"- \")) {\n          // It's a list block\n          const { items, nextLine: afterList } = parseList(lines, i + 1, nextIndent);\n          result[key] = items;\n          i = afterList;\n        } else {\n          // It's a nested map block\n          const { result: nested, nextLine: afterNested } = parseBlock(lines, i + 1, nextIndent);\n          result[key] = nested;\n          i = afterNested;\n        }\n      } else {\n        // Empty value\n        result[key] = null;\n        i++;\n      }\n    } else {\n      // Inline value\n      result[key] = parseScalar(inlineVal);\n      i++;\n    }\n  }\n\n  return { result, nextLine: i };\n}\n\ninterface ListResult {\n  items: unknown[];\n  nextLine: number;\n}\n\nfunction parseList(lines: string[], start: number, baseIndent: number): ListResult {\n  const items: unknown[] = [];\n  let i = start;\n\n  while (i < lines.length) {\n    const line = lines[i];\n    const indent = lineLengths(line).indent;\n\n    if (line.trim() === \"\") { i++; continue; }\n    if (indent < baseIndent) break;\n    if (!line.trim().startsWith(\"- \")) break;\n\n    const value = line.trim().slice(2).trim();\n    items.push(parseScalar(value));\n    i++;\n  }\n\n  return { items, nextLine: i };\n}\n\nfunction parseScalar(value: string): unknown {\n  if (value === \"null\" || value === \"~\") return null;\n  if (value === \"true\") return true;\n  if (value === \"false\") return false;\n\n  // Quoted string\n  if ((value.startsWith('\"') && value.endsWith('\"')) || (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n    return value.slice(1, -1);\n  }\n\n  // Number\n  if (/^-?\\d+$/.test(value)) return parseInt(value, 10);\n  if (/^-?\\d+\\.\\d+$/.test(value)) return parseFloat(value);\n\n  // Inline list [a, b, c]\n  if (value.startsWith(\"[\") && value.endsWith(\"]\")) {\n    return value\n      .slice(1, -1)\n      .split(\",\")\n      .map((s) => parseScalar(s.trim()));\n  }\n\n  return value;\n}\n\nfunction lineLengths(line: string): { indent: number; content: string } {\n  const match = line.match(/^(\\s*)(.*)$/);\n  const indent = match ? match[1].length : 0;\n  const content = match ? match[2] : \"\";\n  return { indent, content };\n}\n\n// ── Soul types ─────────────────────────────────────────────────────────\n\nexport interface SoulVoice {\n  formality: number;\n  warmth: number;\n  verbosity: number;\n  jargon: number;\n  formatting: \"minimal\" | \"plain\" | \"markdown\";\n  banned_phrases?: string[];\n  preferred_phrases?: string[];\n  emoji_policy?: \"never\" | \"rare\" | \"normal\";\n  punctuation?: \"normal\" | \"sparse\";\n}\n\nexport interface SoulInteraction {\n  clarifying_questions: \"never\" | \"when_ambiguous\" | \"always\";\n  uncertainty: \"explicit\" | \"implicit\" | \"never\";\n  disagreement: \"soft\" | \"neutral\" | \"direct\";\n  confirmations: \"none\" | \"implicit\" | \"explicit\";\n}\n\nexport interface SoulCognition {\n  mode?: \"analytical\" | \"creative\" | \"operational\" | \"exploratory\" | \"teaching\" | \"mixed\";\n  depth?: number;\n  speed_vs_rigor?: number;\n  verification?: {\n    fact_checking?: \"none\" | \"light\" | \"strict\";\n    cross_validation?: number;\n    consistency_checks?: number;\n    assumption_tracking?: \"none\" | \"implicit\" | \"explicit\";\n  };\n}\n\nexport interface SoulSafety {\n  refusal_style: \"brief\" | \"explain\" | \"policy_cite\";\n  privacy: \"normal\" | \"strict\";\n  speculation: \"allow\" | \"mark\" | \"avoid\";\n  no_fabrication?: boolean;\n  no_false_certainty?: boolean;\n}\n\nexport interface SoulActions {\n  when_to_use_tools: \"avoid_tools\" | \"when_needed\" | \"prefer_tools\";\n  explain_actions: \"no\" | \"brief\" | \"full\";\n  failover: \"retry\" | \"alternative_method\" | \"ask_user\";\n}\n\nexport interface SoulConfig {\n  soul_spec?: string;\n  id: string;\n  name: string;\n  locale?: string;\n  version?: string;\n  description?: string;\n  composition?: {\n    extends?: string[];\n    mixins?: string[];\n    merge_policy?: string;\n  };\n  profiles?: string[];\n  profile_overrides?: Record<string, Record<string, unknown>>;\n  values?: {\n    priorities?: string[];\n    tradeoffs?: string[];\n    taboo?: string[];\n  };\n  identity?: {\n    role?: string;\n    archetype?: string;\n    domain_focus?: string[];\n    non_goals?: string[];\n  };\n  relationship?: {\n    stance?: \"subordinate\" | \"peer\" | \"authoritative\" | \"adversarial\";\n    user_model_default?: \"novice\" | \"intermediate\" | \"expert\" | \"unknown\";\n    trust_baseline?: number;\n    boundary_distance?: number;\n  };\n  voice?: Partial<SoulVoice>;\n  interaction?: Partial<SoulInteraction>;\n  cognition?: SoulCognition;\n  safety?: Partial<SoulSafety>;\n  actions?: SoulActions;\n  state?: {\n    base?: string;\n    states?: Record<string, Record<string, unknown>>;\n    triggers?: Array<{ if: string; shift_to: string; duration?: string }>;\n  };\n  examples?: Array<{ user: string; agent: string }>;\n  extensions?: Record<string, unknown>;\n}\n\n// ── Soul class ─────────────────────────────────────────────────────────\n\nexport class Soul {\n  readonly config: SoulConfig;\n  readonly body: string;\n\n  constructor(config: SoulConfig, body: string) {\n    this.config = config;\n    this.body = body;\n  }\n\n  /** Select a profile and return a new Soul with that profile merged in. */\n  selectProfile(profileName: string): Soul {\n    const profiles = this.config.profiles ?? [\"default\"];\n    const overrides = this.config.profile_overrides ?? {};\n    const profileOverrides = overrides[profileName];\n\n    if (!profiles.includes(profileName) || !profileOverrides) {\n      return this;\n    }\n\n    const merged = mergeDeep(\n      structuredClone(this.config) as unknown as Record<string, unknown>,\n      profileOverrides as Record<string, unknown>\n    ) as unknown as SoulConfig;\n    return new Soul(merged, this.body);\n  }\n\n  /** Build a system prompt from the Soul definition. */\n  buildPrompt(): string {\n    const parts: string[] = [];\n\n    // Identity\n    const identity = this.config.identity;\n    if (identity) {\n      const role = identity.role ?? this.config.name;\n      const archetype = identity.archetype;\n      parts.push(`You are ${this.config.name}${archetype ? `, a ${archetype}` : \"\"}${role ? `. Role: ${role}` : \"\"}.`);\n      if (identity.domain_focus?.length) {\n        parts.push(`Domain expertise: ${identity.domain_focus.join(\", \")}.`);\n      }\n      if (identity.non_goals?.length) {\n        parts.push(`Non-goals: ${identity.non_goals.join(\", \")}.`);\n      }\n    } else {\n      parts.push(`You are ${this.config.name}.`);\n    }\n\n    // Relationship\n    const relationship = this.config.relationship;\n    if (relationship) {\n      if (relationship.stance) {\n        const stanceMap: Record<string, string> = {\n          subordinate: \"You serve the user's direction.\",\n          peer: \"You collaborate with the user as a partner.\",\n          authoritative: \"You provide expert guidance and direction.\",\n          adversarial: \"You challenge the user's assumptions to improve outcomes.\",\n        };\n        parts.push(stanceMap[relationship.stance] ?? \"\");\n      }\n      if (relationship.user_model_default) {\n        const userModelMap: Record<string, string> = {\n          novice: \"Assume the user is new to this domain. Explain terms and concepts.\",\n          intermediate: \"Assume moderate familiarity. Explain only when needed.\",\n          expert: \"Be concise. The user knows the domain well.\",\n          unknown: \"Adapt your explanation depth to the user's apparent knowledge level.\",\n        };\n        parts.push(userModelMap[relationship.user_model_default] ?? \"\");\n      }\n    }\n\n    // Values\n    const values = this.config.values;\n    if (values?.priorities?.length) {\n      parts.push(`\\n## Priorities (in order)\\n${values.priorities.map((p, i) => `${i + 1}. ${p}`).join(\"\\n\")}`);\n    }\n    if (values?.taboo?.length) {\n      parts.push(`\\n## Forbidden patterns\\n${values.taboo.map((t) => `- ${t}`).join(\"\\n\")}`);\n    }\n\n    // Voice\n    const voice = this.config.voice;\n    if (voice) {\n      const voiceParts: string[] = [\"\\n## Voice & Style\"];\n      if (voice.formality !== undefined) {\n        const level = voice.formality <= 30 ? \"very casual\" : voice.formality <= 60 ? \"moderately formal\" : voice.formality <= 80 ? \"professional\" : \"highly formal\";\n        voiceParts.push(`Formality: ${level} (${voice.formality}/100).`);\n      }\n      if (voice.warmth !== undefined) {\n        const level = voice.warmth <= 30 ? \"cold/detached\" : voice.warmth <= 60 ? \"neutral\" : voice.warmth <= 80 ? \"warm and approachable\" : \"very friendly and encouraging\";\n        voiceParts.push(`Tone: ${level} (${voice.warmth}/100).`);\n      }\n      if (voice.verbosity !== undefined) {\n        const level = voice.verbosity <= 25 ? \"extremely concise\" : voice.verbosity <= 50 ? \"concise\" : voice.verbosity <= 75 ? \"moderate length\" : \"thorough and detailed\";\n        voiceParts.push(`Brevity: ${level} (${voice.verbosity}/100).`);\n      }\n      if (voice.jargon !== undefined) {\n        const level = voice.jargon <= 30 ? \"use plain language\" : voice.jargon <= 60 ? \"use moderate technical terms\" : \"use domain-specific terminology freely\";\n        voiceParts.push(`Jargon: ${level} (${voice.jargon}/100).`);\n      }\n      if (voice.formatting) voiceParts.push(`Formatting: ${voice.formatting}.`);\n      if (voice.banned_phrases?.length) voiceParts.push(`Never say: ${voice.banned_phrases.map((p) => `\"${p}\"`).join(\", \")}.`);\n      if (voice.preferred_phrases?.length) voiceParts.push(`Prefer: ${voice.preferred_phrases.map((p) => `\"${p}\"`).join(\", \")}.`);\n      if (voice.emoji_policy && voice.emoji_policy !== \"rare\") voiceParts.push(`Emoji usage: ${voice.emoji_policy}.`);\n      parts.push(voiceParts.join(\" \"));\n    }\n\n    // Interaction\n    const interaction = this.config.interaction;\n    if (interaction) {\n      const interactionParts: string[] = [\"\\n## Interaction Policy\"];\n      if (interaction.clarifying_questions) {\n        const qMap: Record<string, string> = {\n          never: \"Never ask clarifying questions. Make reasonable assumptions.\",\n          when_ambiguous: \"Ask clarifying questions only when the query is ambiguous.\",\n          always: \"Always confirm your understanding before responding.\",\n        };\n        interactionParts.push(qMap[interaction.clarifying_questions] ?? \"\");\n      }\n      if (interaction.uncertainty) {\n        const uMap: Record<string, string> = {\n          explicit: \"Explicitly mark uncertain information. Say when you're not sure.\",\n          implicit: \"Use hedging language (might, possibly, could) for uncertain claims.\",\n          never: \"Never express uncertainty. State your best answer confidently.\",\n        };\n        interactionParts.push(uMap[interaction.uncertainty] ?? \"\");\n      }\n      if (interaction.disagreement) {\n        const dMap: Record<string, string> = {\n          soft: \"Disagree gently. Acknowledge the user's perspective first.\",\n          neutral: \"State disagreements directly but politely.\",\n          direct: \"Challenge incorrect views directly. Don't soften disagreements.\",\n        };\n        interactionParts.push(dMap[interaction.disagreement] ?? \"\");\n      }\n      if (interaction.confirmations === \"none\") {\n        interactionParts.push(\"Don't ask for confirmation before acting. Just do it.\");\n      }\n      parts.push(interactionParts.join(\" \"));\n    }\n\n    // Cognition\n    const cognition = this.config.cognition;\n    if (cognition) {\n      const cogParts: string[] = [\"\\n## Cognition\"];\n      if (cognition.mode) {\n        const modeMap: Record<string, string> = {\n          analytical: \"Think analytically. Break problems down, examine evidence, reason step by step.\",\n          creative: \"Think creatively. Generate novel ideas, make unexpected connections.\",\n          operational: \"Focus on execution. Prioritize working solutions over theory.\",\n          exploratory: \"Explore broadly. Consider many angles before committing to an answer.\",\n          teaching: \"Teach and explain. Build understanding progressively from basics.\",\n          mixed: \"Adapt your thinking mode to the task at hand.\",\n        };\n        cogParts.push(modeMap[cognition.mode] ?? \"\");\n      }\n      if (cognition.verification?.fact_checking) {\n        const fcMap: Record<string, string> = {\n          none: \"No explicit fact-checking.\",\n          light: \"Verify key claims before stating them.\",\n          strict: \"Always verify claims. Never state unverified information as fact.\",\n        };\n        cogParts.push(fcMap[cognition.verification.fact_checking] ?? \"\");\n      }\n      parts.push(cogParts.join(\" \"));\n    }\n\n    // Safety\n    const safety = this.config.safety;\n    if (safety) {\n      const safetyParts: string[] = [\"\\n## Safety\"];\n      if (safety.speculation) {\n        const specMap: Record<string, string> = {\n          allow: \"You may speculate freely.\",\n          mark: \"Mark speculative content clearly (e.g., 'I believe', 'likely', 'possibly').\",\n          avoid: \"Do not speculate. Only state what you can verify.\",\n        };\n        safetyParts.push(specMap[safety.speculation] ?? \"\");\n      }\n      if (safety.refusal_style) {\n        const refMap: Record<string, string> = {\n          brief: \"Refuse briefly. No lectures.\",\n          explain: \"Explain why you're refusing when you decline a request.\",\n          policy_cite: \"Cite specific policies when refusing requests.\",\n        };\n        safetyParts.push(refMap[safety.refusal_style] ?? \"\");\n      }\n      if (safety.no_fabrication) safetyParts.push(\"Never fabricate information. If you don't know, say so.\");\n      if (safety.no_false_certainty) safetyParts.push(\"Never present uncertain information as certain.\");\n      parts.push(safetyParts.join(\" \"));\n    }\n\n    // Actions\n    const actions = this.config.actions;\n    if (actions) {\n      const actParts: string[] = [\"\\n## Actions\"];\n      const toolMap: Record<string, string> = {\n        avoid_tools: \"Minimize tool use. Answer from knowledge when possible.\",\n        when_needed: \"Use tools when they would improve your answer.\",\n        prefer_tools: \"Proactively use available tools. Always verify with tools rather than memory.\",\n      };\n      actParts.push(toolMap[actions.when_to_use_tools] ?? \"\");\n      if (actions.explain_actions === \"brief\" || actions.explain_actions === \"full\") {\n        actParts.push(actions.explain_actions === \"full\" ? \"Explain what you're doing before and after tool use.\" : \"Briefly explain tool use.\");\n      }\n      parts.push(actParts.join(\" \"));\n    }\n\n    // Markdown body\n    if (this.body.trim()) {\n      parts.push(`\\n## Additional Instructions\\n\\n${this.body.trim()}`);\n    }\n\n    return parts.join(\"\\n\\n\");\n  }\n\n  get defaultProfile(): string {\n    return this.config.profiles?.[0] ?? \"default\";\n  }\n\n  get profileNames(): string[] {\n    return this.config.profiles ?? [\"default\"];\n  }\n}\n\n// ── Public API ──────────────────────────────────────────────────────────\n\n/** Parse a Soul.md string into a Soul instance. */\nexport function loadSoul(content: string): Soul {\n  const { frontMatter, body } = parseYamlFrontMatter(content);\n  const config = frontMatter as unknown as SoulConfig;\n\n  if (!config.id) throw new Error(\"Soul.md missing required field: id\");\n  if (!config.name) throw new Error(\"Soul.md missing required field: name\");\n\n  return new Soul(config, body);\n}\n\n/** Deep merge (Standard Merge semantics from Soul.md spec). */\nfunction mergeDeep(base: Record<string, unknown>, overlay: Record<string, unknown>): Record<string, unknown> {\n  const result = { ...base };\n  for (const key of Object.keys(overlay)) {\n    const baseVal = result[key];\n    const overVal = overlay[key];\n    if (overVal === null) {\n      result[key] = null;\n    } else if (\n      typeof baseVal === \"object\" && baseVal !== null && !Array.isArray(baseVal) &&\n      typeof overVal === \"object\" && overVal !== null && !Array.isArray(overVal)\n    ) {\n      result[key] = mergeDeep(baseVal as Record<string, unknown>, overVal as Record<string, unknown>);\n    } else {\n      result[key] = overVal;\n    }\n  }\n  return result;\n}"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export { A as AgentConfig, a as AgentResponse, b as AuthCheckResult, C as Citation, D as D1Like, c as D1Provider, ModelResolutionOptions, M as OrigenModelConfig, O as OrigenTool, R as ReadingContext, S as StreamEvent, U as UsageInfo, d as callOrigen, e as checkAuth, f as checkOpenRouterAuth, createEventStream, resolveModel, s as streamOrigen } from './adapter.js';
-export { DEFAULT_MODEL, DEFAULT_MODEL_ID, MODELS, ModelConfig, ModelId, THINKING_MODELS, UIModelConfig, getModelsByProvider, getModelsForUI, isOllamaModel, supportsThinking } from './models.js';
-import 'zod';
+export { A as AgentConfig, a as AgentResponse, b as AuthCheckResult, C as Citation, D as D1Like, c as D1Provider, M as ModelResolutionOptions, d as OrigenModelConfig, O as OrigenTool, R as ReadingContext, S as StreamEvent, U as UsageInfo, e as callOrigen, f as checkAuth, g as checkOpenRouterAuth, h as createEventStream, i as defaultCitationExtractor, r as resolveModel, s as streamOrigen } from './adapter-DXIT3O2f.js';
+export { DEFAULT_MODEL, DEFAULT_MODEL_ID, MODELS, ModelConfig, ModelId, THINKING_MODELS, UIModelConfig, discoverOllamaModels, fetchOllamaModels, getModelsByProvider, getModelsForUI, isOllamaModel, mergeOllamaModels, supportsThinking } from './models.js';
+export { Soul, loadSoul } from './soul.js';
 import '@mariozechner/pi-ai';
 import '@mariozechner/pi-agent-core';
+import 'zod';

package/dist/index.js

@@ -3,17 +3,24 @@ import {
   DEFAULT_MODEL_ID,
   MODELS,
   THINKING_MODELS,
+  discoverOllamaModels,
+  fetchOllamaModels,
   getModelsByProvider,
   getModelsForUI,
   isOllamaModel,
+  mergeOllamaModels,
   supportsThinking
-} from "./chunk-ECRY7XDR.js";
+} from "./chunk-GK5KZOHB.js";
+import {
+  loadSoul
+} from "./chunk-QF3XSUMT.js";
 import {
   adaptTools,
   convertMessages,
   createEventStream,
+  defaultCitationExtractor,
   resolveModel
-} from "./chunk-TECUAB3E.js";
+} from "./chunk-K3FE63XL.js";
 
 // src/agent.ts
 import { Agent } from "@mariozechner/pi-agent-core";
@@ -48,7 +55,7 @@ async function* streamOrigen(messages, context, config, apiKey) {
   const extractCitations = config.extractCitations;
   const model = resolveModel(modelId, { ollamaBaseUrl: config.ollamaBaseUrl });
   const adaptedTools = adaptTools(config.tools, config.getD1);
-  let piMessages = convertMessages(messages);
+  const piMessages = convertMessages(messages);
   if (context && piMessages.length > 0) {
     const lastIdx = piMessages.length - 1;
     const lastMsg = piMessages[lastIdx];
@@ -120,9 +127,14 @@ export {
   checkAuth,
   checkOpenRouterAuth,
   createEventStream,
+  defaultCitationExtractor,
+  discoverOllamaModels,
+  fetchOllamaModels,
   getModelsByProvider,
   getModelsForUI,
   isOllamaModel,
+  loadSoul,
+  mergeOllamaModels,
   resolveModel,
   streamOrigen,
   supportsThinking

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/agent.ts"],"sourcesContent":["/**\n * Origen — Agent Engine (v0.3)\n *\n * Multi-provider agent harness built on pi-ai + pi-agent-core.\n * Supports OpenRouter, Ollama, Anthropic, Google, and any OpenAI-compatible API.\n * Soul.md personas, streaming, parallel tool execution, abort support.\n */\n\nimport { Agent } from \"@mariozechner/pi-agent-core\";\nimport { streamSimple } from \"@mariozechner/pi-ai\";\nimport type { AgentEvent } from \"@mariozechner/pi-agent-core\";\nimport { z } from \"zod\";\nimport {\n  adaptTools,\n  convertMessages,\n  buildContext,\n  createEventStream,\n  resolveModel,\n} from \"./adapter\";\nimport { DEFAULT_MODEL_ID, THINKING_MODELS, type ModelId } from \"./models\";\nimport type { D1Provider, Citation, UsageInfo } from \"./types\";\n\n// ── Tool definition ───────────────────────────────────────────────────\n\n/**\n * A tool that the host app registers with Origen.\n * Simple interface: name, description, JSON schema, and an execute function\n * that receives (args, getD1). The adapter wraps this into pi-agent-core's AgentTool.\n */\nexport interface OrigenTool {\n  name: string;\n  description: string;\n  /** OpenAI function-calling parameter schema (JSON) */\n  parameters: Record<string, unknown>;\n  /** Zod schema for runtime validation (optional) */\n  inputSchema?: z.ZodType;\n  execute: (args: Record<string, unknown>, getD1: D1Provider) => Promise<string>;\n}\n\n// ── Agent configuration ───────────────────────────────────────────────\n\nexport interface AgentConfig {\n  appName?: string;\n  systemPrompt?: string;\n  tools: OrigenTool[];\n  getD1: D1Provider;\n  model?: ModelId;\n  maxSteps?: number;\n  /** Custom citation extractor */\n  extractCitations?: (text: string) => Citation[];\n  /** Dynamic API key resolution per provider (e.g., for expiring OAuth tokens) */\n  getApiKey?: (provider: string) => Promise<string | undefined>;\n  /** Ollama base URL override (default: http://localhost:11434/v1) */\n  ollamaBaseUrl?: string;\n  /** Tool execution mode: \"parallel\" (default) or \"sequential\" */\n  toolExecution?: \"sequential\" | \"parallel\";\n  /** Abort signal for cancellation */\n  signal?: AbortSignal;\n  /** Reasoning/thinking level for models that support it */\n  thinkingLevel?: \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\";\n}\n\n// ── Auth check ────────────────────────────────────────\n\nexport interface AuthCheckResult {\n  authenticated: boolean;\n  apiKey: string | null;\n  provider?: string;\n  error?: string;\n}\n\n/**\n * Provider-aware auth check. Tests key availability for each provider.\n * If no provider argument, checks OpenRouter + Ollama availability.\n */\nexport async function checkAuth(\n  getApiKey: ((provider: string) => Promise<string | undefined>) | (() => Promise<string | null>),\n): Promise<AuthCheckResult> {\n  // Normalize to per-provider signature\n  const getProviderKey = getApiKey.length >= 1\n    ? getApiKey as (provider: string) => Promise<string | undefined>\n    : async (provider: string) => {\n        const key = await (getApiKey as () => Promise<string | null>)();\n        return key ?? undefined;\n      };\n\n  // Try OpenRouter first\n  const orKey = await getProviderKey(\"openrouter\");\n  if (orKey) return { authenticated: true, apiKey: orKey, provider: \"openrouter\" };\n\n  // Try Ollama\n  const ollamaKey = await getProviderKey(\"ollama\");\n  if (ollamaKey) return { authenticated: true, apiKey: ollamaKey, provider: \"ollama\" };\n\n  // Try Anthropic\n  const anthropicKey = await getProviderKey(\"anthropic\");\n  if (anthropicKey) return { authenticated: true, apiKey: anthropicKey, provider: \"anthropic\" };\n\n  return {\n    authenticated: false,\n    apiKey: null,\n    error: \"Connect your OpenRouter account or configure Ollama to enable AI-powered study.\",\n  };\n}\n\n/** Convenience: check OpenRouter auth only (backward compat). */\nexport async function checkOpenRouterAuth(\n  getApiKey: () => Promise<string | null>\n): Promise<AuthCheckResult> {\n  const apiKey = await getApiKey();\n  if (!apiKey) {\n    return { authenticated: false, apiKey: null, error: \"Connect your OpenRouter account to enable AI-powered study.\" };\n  }\n  return { authenticated: true, apiKey, provider: \"openrouter\" };\n}\n\n// ── Stream event types ─────────────────────────────────────────────────\n\nexport type StreamEvent =\n  | { type: \"reasoning\"; content: string }\n  | { type: \"tool_call\"; name: string; args: Record<string, unknown> }\n  | { type: \"tool_result\"; name: string; result: string }\n  | { type: \"text\"; content: string }\n  | { type: \"done\"; message: string; citations: Citation[]; usage?: UsageInfo }\n  | { type: \"error\"; message: string };\n\n// ── Streaming agent call ───────────────────────────────────────────────\n\nexport async function* streamOrigen(\n  messages: Array<{ role: \"user\" | \"assistant\"; content: string }>,\n  context: Record<string, unknown> | undefined,\n  config: AgentConfig,\n  apiKey?: string,\n): AsyncGenerator<StreamEvent> {\n  const systemPrompt = config.systemPrompt ?? `You are ${config.appName ?? \"Origen\"}, an AI assistant. Use your tools to help the user.`;\n  const modelId = config.model ?? DEFAULT_MODEL_ID;\n  const maxSteps = config.maxSteps ?? 5;\n  const extractCitations = config.extractCitations;\n\n  // Resolve model to pi-ai Model object\n  const model = resolveModel(modelId, { ollamaBaseUrl: config.ollamaBaseUrl });\n\n  // Adapt tools to AgentTool format\n  const adaptedTools = adaptTools(config.tools, config.getD1);\n\n  // Convert messages\n  let piMessages = convertMessages(messages);\n\n  // Inject context into last user message\n  if (context && piMessages.length > 0) {\n    const lastIdx = piMessages.length - 1;\n    const lastMsg = piMessages[lastIdx];\n    if (lastMsg.role === \"user\") {\n      piMessages[lastIdx] = {\n        ...lastMsg,\n        content: `[Context: ${JSON.stringify(context)}] ${typeof lastMsg.content === \"string\" ? lastMsg.content : \"\"}`,\n      };\n    }\n  }\n\n  // Resolve API key per provider\n  const resolveApiKey = async (provider: string): Promise<string | undefined> => {\n    if (config.getApiKey) return config.getApiKey(provider);\n    if (apiKey) return apiKey;\n    return undefined;\n  };\n\n  // Create Agent\n  const agent = new Agent({\n    initialState: {\n      systemPrompt,\n      model,\n      thinkingLevel: config.thinkingLevel ?? (THINKING_MODELS.has(modelId) ? \"medium\" : \"off\"),\n      tools: adaptedTools,\n      messages: piMessages as any,\n    },\n    getApiKey: resolveApiKey,\n    toolExecution: config.toolExecution ?? \"parallel\",\n  });\n\n  // CRITICAL: Create event stream BEFORE calling prompt.\n  // createEventStream subscribes eagerly (synchronously), so no events\n  // are missed even though agent.prompt() emits events during execution.\n  const { stream, unsubscribe } = createEventStream(agent, extractCitations);\n\n  let streamError: string | null = null;\n\n  // Start prompt without awaiting — events flow through active subscription\n  agent.prompt(piMessages as any).catch((error) => {\n    // If prompt throws without emitting agent_end, capture error\n    // to yield after the stream ends\n    streamError = error instanceof Error ? error.message : String(error);\n    unsubscribe(); // clean up since agent won't emit agent_end\n  });\n\n  try {\n    for await (const event of stream) {\n      yield event;\n    }\n  } finally {\n    unsubscribe();\n  }\n\n  // If prompt() threw without emitting events, yield the error now\n  if (streamError) {\n    yield { type: \"error\", message: `Agent error: ${streamError}` };\n  }\n}\n\n// ── Non-streaming agent call ──────────────────────────────────────────\n\nexport interface AgentResponse {\n  message: string;\n  citations: Citation[];\n  usage?: UsageInfo;\n}\n\nexport async function callOrigen(\n  messages: Array<{ role: \"user\" | \"assistant\"; content: string }>,\n  context: Record<string, unknown> | undefined,\n  config: AgentConfig,\n  apiKey?: string,\n): Promise<AgentResponse> {\n  let message = \"\";\n  const citations: Citation[] = [];\n  let usage: UsageInfo | undefined;\n\n  for await (const event of streamOrigen(messages, context, config, apiKey)) {\n    switch (event.type) {\n      case \"text\": message += event.content; break;\n      case \"done\": citations.push(...event.citations); usage = event.usage; break;\n      case \"error\": throw new Error(event.message);\n    }\n  }\n\n  return { message, citations, usage };\n}"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/agent.ts"],"sourcesContent":["/**\n * Origen — Agent Engine (v0.3)\n *\n * Multi-provider agent harness built on pi-ai + pi-agent-core.\n * Supports OpenRouter, Ollama, Anthropic, Google, and any OpenAI-compatible API.\n * Soul.md personas, streaming, parallel tool execution, abort support.\n */\n\nimport { Agent } from \"@mariozechner/pi-agent-core\";\nimport { streamSimple } from \"@mariozechner/pi-ai\";\nimport type { AgentEvent } from \"@mariozechner/pi-agent-core\";\nimport { z } from \"zod\";\nimport {\n  adaptTools,\n  convertMessages,\n  buildContext,\n  createEventStream,\n  resolveModel,\n} from \"./adapter\";\nimport type { AgentMessage } from \"@mariozechner/pi-agent-core\";\nimport { DEFAULT_MODEL_ID, THINKING_MODELS, type ModelId } from \"./models\";\nimport type { D1Provider, Citation, UsageInfo } from \"./types\";\n\n// ── Tool definition ───────────────────────────────────────────────────\n\n/**\n * A tool that the host app registers with Origen.\n * Simple interface: name, description, JSON schema, and an execute function\n * that receives (args, getD1). The adapter wraps this into pi-agent-core's AgentTool.\n */\nexport interface OrigenTool {\n  name: string;\n  description: string;\n  /** OpenAI function-calling parameter schema (JSON) */\n  parameters: Record<string, unknown>;\n  /** Zod schema for runtime validation (optional) */\n  inputSchema?: z.ZodType;\n  execute: (args: Record<string, unknown>, getD1: D1Provider) => Promise<string>;\n}\n\n// ── Agent configuration ───────────────────────────────────────────────\n\nexport interface AgentConfig {\n  appName?: string;\n  systemPrompt?: string;\n  tools: OrigenTool[];\n  getD1: D1Provider;\n  model?: ModelId;\n  maxSteps?: number;\n  /** Custom citation extractor */\n  extractCitations?: (text: string) => Citation[];\n  /** Dynamic API key resolution per provider (e.g., for expiring OAuth tokens) */\n  getApiKey?: (provider: string) => Promise<string | undefined>;\n  /** Ollama base URL override (default: http://localhost:11434/v1) */\n  ollamaBaseUrl?: string;\n  /** Tool execution mode: \"parallel\" (default) or \"sequential\" */\n  toolExecution?: \"sequential\" | \"parallel\";\n  /** Abort signal for cancellation */\n  signal?: AbortSignal;\n  /** Reasoning/thinking level for models that support it */\n  thinkingLevel?: \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\";\n}\n\n// ── Auth check ────────────────────────────────────────\n\nexport interface AuthCheckResult {\n  authenticated: boolean;\n  apiKey: string | null;\n  provider?: string;\n  error?: string;\n}\n\n/**\n * Provider-aware auth check. Tests key availability for each provider.\n * If no provider argument, checks OpenRouter + Ollama availability.\n */\nexport async function checkAuth(\n  getApiKey: ((provider: string) => Promise<string | undefined>) | (() => Promise<string | null>),\n): Promise<AuthCheckResult> {\n  // Normalize to per-provider signature\n  const getProviderKey = getApiKey.length >= 1\n    ? getApiKey as (provider: string) => Promise<string | undefined>\n    : async (provider: string) => {\n        const key = await (getApiKey as () => Promise<string | null>)();\n        return key ?? undefined;\n      };\n\n  // Try OpenRouter first\n  const orKey = await getProviderKey(\"openrouter\");\n  if (orKey) return { authenticated: true, apiKey: orKey, provider: \"openrouter\" };\n\n  // Try Ollama\n  const ollamaKey = await getProviderKey(\"ollama\");\n  if (ollamaKey) return { authenticated: true, apiKey: ollamaKey, provider: \"ollama\" };\n\n  // Try Anthropic\n  const anthropicKey = await getProviderKey(\"anthropic\");\n  if (anthropicKey) return { authenticated: true, apiKey: anthropicKey, provider: \"anthropic\" };\n\n  return {\n    authenticated: false,\n    apiKey: null,\n    error: \"Connect your OpenRouter account or configure Ollama to enable AI-powered study.\",\n  };\n}\n\n/** Convenience: check OpenRouter auth only (backward compat). */\nexport async function checkOpenRouterAuth(\n  getApiKey: () => Promise<string | null>\n): Promise<AuthCheckResult> {\n  const apiKey = await getApiKey();\n  if (!apiKey) {\n    return { authenticated: false, apiKey: null, error: \"Connect your OpenRouter account to enable AI-powered study.\" };\n  }\n  return { authenticated: true, apiKey, provider: \"openrouter\" };\n}\n\n// ── Stream event types ─────────────────────────────────────────────────\n\nexport type StreamEvent =\n  | { type: \"reasoning\"; content: string }\n  | { type: \"tool_call\"; name: string; args: Record<string, unknown> }\n  | { type: \"tool_result\"; name: string; result: string }\n  | { type: \"text\"; content: string }\n  | { type: \"done\"; message: string; citations: Citation[]; usage?: UsageInfo }\n  | { type: \"error\"; message: string };\n\n// ── Streaming agent call ───────────────────────────────────────────────\n\nexport async function* streamOrigen(\n  messages: Array<{ role: \"user\" | \"assistant\"; content: string }>,\n  context: Record<string, unknown> | undefined,\n  config: AgentConfig,\n  apiKey?: string,\n): AsyncGenerator<StreamEvent> {\n  const systemPrompt = config.systemPrompt ?? `You are ${config.appName ?? \"Origen\"}, an AI assistant. Use your tools to help the user.`;\n  const modelId = config.model ?? DEFAULT_MODEL_ID;\n  const maxSteps = config.maxSteps ?? 5;\n  const extractCitations = config.extractCitations;\n\n  // Resolve model to pi-ai Model object\n  const model = resolveModel(modelId, { ollamaBaseUrl: config.ollamaBaseUrl });\n\n  // Adapt tools to AgentTool format\n  const adaptedTools = adaptTools(config.tools, config.getD1);\n\n  // Convert messages — Origen's simple {role, content} maps to pi-ai UserMessages.\n  // Assistant messages lack thinking/toolCall content, so we cast through the union.\n  const piMessages = convertMessages(messages) as AgentMessage[];\n\n  // Inject context into last user message\n  if (context && piMessages.length > 0) {\n    const lastIdx = piMessages.length - 1;\n    const lastMsg = piMessages[lastIdx];\n    if (lastMsg.role === \"user\") {\n      piMessages[lastIdx] = {\n        ...lastMsg,\n        content: `[Context: ${JSON.stringify(context)}] ${typeof lastMsg.content === \"string\" ? lastMsg.content : \"\"}`,\n      };\n    }\n  }\n\n  // Resolve API key per provider\n  const resolveApiKey = async (provider: string): Promise<string | undefined> => {\n    if (config.getApiKey) return config.getApiKey(provider);\n    if (apiKey) return apiKey;\n    return undefined;\n  };\n\n  // Create Agent\n  const agent = new Agent({\n    initialState: {\n      systemPrompt,\n      model,\n      thinkingLevel: config.thinkingLevel ?? (THINKING_MODELS.has(modelId) ? \"medium\" : \"off\"),\n      tools: adaptedTools,\n      messages: piMessages,\n    },\n    getApiKey: resolveApiKey,\n    toolExecution: config.toolExecution ?? \"parallel\",\n  });\n\n  // CRITICAL: Create event stream BEFORE calling prompt.\n  // createEventStream subscribes eagerly (synchronously), so no events\n  // are missed even though agent.prompt() emits events during execution.\n  const { stream, unsubscribe } = createEventStream(agent, extractCitations);\n\n  let streamError: string | null = null;\n\n  // Start prompt without awaiting — events flow through active subscription\n  agent.prompt(piMessages).catch((error) => {\n    // If prompt throws without emitting agent_end, capture error\n    // to yield after the stream ends\n    streamError = error instanceof Error ? error.message : String(error);\n    unsubscribe(); // clean up since agent won't emit agent_end\n  });\n\n  try {\n    for await (const event of stream) {\n      yield event;\n    }\n  } finally {\n    unsubscribe();\n  }\n\n  // If prompt() threw without emitting events, yield the error now\n  if (streamError) {\n    yield { type: \"error\", message: `Agent error: ${streamError}` };\n  }\n}\n\n// ── Non-streaming agent call ──────────────────────────────────────────\n\nexport interface AgentResponse {\n  message: string;\n  citations: Citation[];\n  usage?: UsageInfo;\n}\n\nexport async function callOrigen(\n  messages: Array<{ role: \"user\" | \"assistant\"; content: string }>,\n  context: Record<string, unknown> | undefined,\n  config: AgentConfig,\n  apiKey?: string,\n): Promise<AgentResponse> {\n  let message = \"\";\n  const citations: Citation[] = [];\n  let usage: UsageInfo | undefined;\n\n  for await (const event of streamOrigen(messages, context, config, apiKey)) {\n    switch (event.type) {\n      case \"text\": message += event.content; break;\n      case \"done\": citations.push(...event.citations); usage = event.usage; break;\n      case \"error\": throw new Error(event.message);\n    }\n  }\n\n  return { message, citations, usage };\n}"],"mappings":"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","names":[]}

package/dist/models.d.ts

@@ -3,8 +3,12 @@ export { Api, Model as ProviderModel } from '@mariozechner/pi-ai';
 /**
  * Origen model configuration.
  *
- * Delegates to pi-ai's model registry for known providers (OpenRouter, Anthropic, Google, etc.)
- * Plus custom entries for Ollama and free-tier aliases.
+ * Static entries for cloud providers (OpenRouter, Anthropic, Google, etc.)
+ * plus dynamic Ollama model discovery via GET /api/tags.
+ *
+ * Hardcoded Ollama entries serve as fallbacks when Ollama isn't reachable.
+ * When connected, fetchOllamaModels() pulls the live model list and merges
+ * it with the static entries.
  */
 
 interface ModelConfig {
@@ -14,8 +18,6 @@ interface ModelConfig {
 }
 /** UI-facing model config — safe to send to the client. Strips internal fields. */
 type UIModelConfig = ModelConfig;
-/** Get models as a simple UI map (name, description, free). No internal fields. */
-declare function getModelsForUI(): Record<string, UIModelConfig>;
 declare const MODELS: Record<string, ModelConfig>;
 type ModelId = keyof typeof MODELS;
 /** Default model — free router, works with $0 credits */
@@ -23,12 +25,42 @@ declare const DEFAULT_MODEL_ID: ModelId;
 /** Backward compat alias */
 declare const DEFAULT_MODEL: ModelId;
 /** Models that support extended thinking */
-declare const THINKING_MODELS: ReadonlySet<ModelId>;
+declare const THINKING_MODELS: ReadonlySet<string>;
 /** Check if a model supports extended thinking */
-declare function supportsThinking(model: ModelId): boolean;
+declare function supportsThinking(model: string): boolean;
 /** Check if a model is an Ollama model */
-declare function isOllamaModel(model: ModelId): boolean;
+declare function isOllamaModel(model: string): boolean;
 /** Get all model IDs for a specific provider prefix */
-declare function getModelsByProvider(provider: string): ModelId[];
+declare function getModelsByProvider(provider: string): string[];
+/** Get models as a simple UI map (name, description, free). No internal fields. */
+declare function getModelsForUI(): Record<string, UIModelConfig>;
+/**
+ * Fetch available models from a running Ollama server.
+ *
+ * Calls GET /api/tags on the Ollama server and returns model configs
+ * merged with the static defaults. Cloud models (e.g., foo:cloud)
+ * are included alongside local models.
+ *
+ * @param baseUrl - Ollama server URL (default: http://localhost:11434)
+ * @returns Object with discovered Ollama model configs (keyed by "ollama/<name>")
+ */
+declare function fetchOllamaModels(baseUrl?: string): Promise<Record<string, ModelConfig>>;
+/**
+ * Merge dynamically discovered Ollama models into the static MODELS registry.
+ *
+ * Static defaults are kept as fallbacks. Discovered models override
+ * entries with the same key (e.g., "ollama/llama3" from the server
+ * replaces the hardcoded entry with live data).
+ *
+ * @param ollamaModels - Models returned by fetchOllamaModels()
+ */
+declare function mergeOllamaModels(ollamaModels: Record<string, ModelConfig>): void;
+/**
+ * One-shot: fetch Ollama models and merge them into the registry.
+ * Returns the combined model map.
+ *
+ * @param baseUrl - Ollama server URL (default: http://localhost:11434)
+ */
+declare function discoverOllamaModels(baseUrl?: string): Promise<Record<string, ModelConfig>>;
 
-export { DEFAULT_MODEL, DEFAULT_MODEL_ID, MODELS, type ModelConfig, type ModelId, THINKING_MODELS, type UIModelConfig, getModelsByProvider, getModelsForUI, isOllamaModel, supportsThinking };
+export { DEFAULT_MODEL, DEFAULT_MODEL_ID, MODELS, type ModelConfig, type ModelId, THINKING_MODELS, type UIModelConfig, discoverOllamaModels, fetchOllamaModels, getModelsByProvider, getModelsForUI, isOllamaModel, mergeOllamaModels, supportsThinking };

package/dist/models.js

@@ -3,19 +3,25 @@ import {
   DEFAULT_MODEL_ID,
   MODELS,
   THINKING_MODELS,
+  discoverOllamaModels,
+  fetchOllamaModels,
   getModelsByProvider,
   getModelsForUI,
   isOllamaModel,
+  mergeOllamaModels,
   supportsThinking
-} from "./chunk-ECRY7XDR.js";
+} from "./chunk-GK5KZOHB.js";
 export {
   DEFAULT_MODEL,
   DEFAULT_MODEL_ID,
   MODELS,
   THINKING_MODELS,
+  discoverOllamaModels,
+  fetchOllamaModels,
   getModelsByProvider,
   getModelsForUI,
   isOllamaModel,
+  mergeOllamaModels,
   supportsThinking
 };
 //# sourceMappingURL=models.js.map