octoflow-core 1.0.0

package/dist/adapters/agents/parsers/openai.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/parsers/openai.ts"],
+  "sourcesContent": ["import { TOOL_ICONS } from '../../../config/tools.js';\nimport type {\n  ParsedEvent,\n  StreamParser,\n} from '../../../domain/contracts/messages.js';\nimport { parseError } from '../../../domain/contracts/messages.js';\nimport { detectLifecycleEvent } from './lifecycle.js';\n\nconst openaiParser: StreamParser = {\n  name: 'openai',\n  toolIcons: TOOL_ICONS,\n\n  parseLine(line: string): ParsedEvent | null {\n    if (!line.trim()) return null;\n\n    try {\n      const data = JSON.parse(line) as ParsedEvent & {\n        is_error?: boolean;\n        result?: string;\n        session_id?: string;\n        status?: string;\n        subtype?: string;\n      };\n\n      const lifecycle = detectLifecycleEvent({\n        type: data.type,\n        subtype: data.subtype,\n        status: data.status,\n        text: data.text ?? data.result,\n        isError: data.isError ?? data.is_error,\n        sessionId: data.sessionId ?? data.session_id,\n      });\n      if (lifecycle) return lifecycle;\n\n      if (\n        data.type === 'text' ||\n        data.type === 'result' ||\n        data.type === 'input-required' ||\n        data.type === 'auth-required'\n      ) {\n        return data;\n      }\n\n      return null;\n    } catch (err) {\n      return parseError('openai', line, err);\n    }\n  },\n\n  getToolIcon(name: string): string {\n    return TOOL_ICONS[name] || '\uD83D\uDD27';\n  },\n};\n\nexport default openaiParser;\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAK3B,SAAS,kBAAkB;AAC3B,SAAS,4BAA4B;AAErC,MAAM,eAA6B;AAAA,EACjC,MAAM;AAAA,EACN,WAAW;AAAA,EAEX,UAAU,MAAkC;AAC1C,QAAI,CAAC,KAAK,KAAK,EAAG,QAAO;AAEzB,QAAI;AACF,YAAM,OAAO,KAAK,MAAM,IAAI;AAQ5B,YAAM,YAAY,qBAAqB;AAAA,QACrC,MAAM,KAAK;AAAA,QACX,SAAS,KAAK;AAAA,QACd,QAAQ,KAAK;AAAA,QACb,MAAM,KAAK,QAAQ,KAAK;AAAA,QACxB,SAAS,KAAK,WAAW,KAAK;AAAA,QAC9B,WAAW,KAAK,aAAa,KAAK;AAAA,MACpC,CAAC;AACD,UAAI,UAAW,QAAO;AAEtB,UACE,KAAK,SAAS,UACd,KAAK,SAAS,YACd,KAAK,SAAS,oBACd,KAAK,SAAS,iBACd;AACA,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,aAAO,WAAW,UAAU,MAAM,GAAG;AAAA,IACvC;AAAA,EACF;AAAA,EAEA,YAAY,MAAsB;AAChC,WAAO,WAAW,IAAI,KAAK;AAAA,EAC7B;AACF;AAEA,IAAO,iBAAQ;",
+  "names": []
+}

package/dist/adapters/agents/registry/built-in.d.ts

@@ -0,0 +1,14 @@
+import type { AgentRegistry } from './loader.js';
+import type { AgentDefinition } from './types.js';
+export declare const BUILT_IN_AGENTS: readonly AgentDefinition[];
+export declare function getBuiltInAgent(role: string): AgentDefinition | undefined;
+/**
+ * Synchronous AgentRegistry containing only the shipped built-in agents
+ * (`general-purpose`, `explore`, `plan`, `search`).
+ *
+ * Prefer this helper when you need a registry inside a synchronous code path
+ * (e.g. the `Bridge` constructor wiring the `subagents` option). For project
+ * and user-level agent files use the async `loadAgentRegistry()`.
+ */
+export declare function builtInAgentRegistry(): AgentRegistry;
+//# sourceMappingURL=built-in.d.ts.map

package/dist/adapters/agents/registry/built-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/registry/built-in.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAqClD,eAAO,MAAM,eAAe,EAAE,SAAS,eAAe,EAuC5C,CAAC;AAEX,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAOpD"}

package/dist/adapters/agents/registry/built-in.js

@@ -0,0 +1,86 @@
+const GENERAL_PURPOSE_PROMPT = [
+  "You are a general-purpose AI agent with full tool access.",
+  "You can research complex questions, search code, and execute multi-step tasks.",
+  "Use all available tools as needed to complete the task thoroughly."
+].join("\n");
+const EXPLORE_PROMPT = [
+  "You are a fast, read-only exploration agent.",
+  "Your job is to quickly find files, search code, and answer questions about the codebase.",
+  "You operate in read-only mode and cannot modify files.",
+  'Specify thoroughness: "quick" for basic searches, "medium" for moderate exploration,',
+  '"very thorough" for comprehensive analysis across multiple locations.'
+].join("\n");
+const PLAN_PROMPT = [
+  "You are a read-only planning agent for designing implementation approaches.",
+  "Analyze the codebase, identify architectural decisions, and propose implementation plans.",
+  "You cannot modify files \u2014 your output is a structured plan, not code changes."
+].join("\n");
+const SEARCH_PROMPT = [
+  "You are a targeted search agent optimized for fast code and file discovery.",
+  "Find specific symbols, patterns, and files efficiently.",
+  "Return precise results with file paths and line numbers."
+].join("\n");
+const READ_ONLY_DISALLOWED = [
+  "filesystem",
+  "create_directory",
+  "bash",
+  "tmux_exec",
+  "git_commit",
+  "git_push"
+];
+const BUILT_IN_AGENTS = [
+  {
+    role: "general-purpose",
+    whenToUse: "Complex research, multi-step tasks requiring full tool access",
+    getSystemPrompt: () => GENERAL_PURPOSE_PROMPT,
+    tools: "*",
+    source: "built-in",
+    model: "inherit"
+  },
+  {
+    role: "explore",
+    whenToUse: "Fast codebase exploration, file search, read-only analysis",
+    getSystemPrompt: () => EXPLORE_PROMPT,
+    tools: "*",
+    disallowedTools: READ_ONLY_DISALLOWED,
+    source: "built-in",
+    model: "fast",
+    effort: "low"
+  },
+  {
+    role: "plan",
+    whenToUse: "Architecture planning, implementation design, read-only analysis",
+    getSystemPrompt: () => PLAN_PROMPT,
+    tools: "*",
+    disallowedTools: READ_ONLY_DISALLOWED,
+    source: "built-in",
+    model: "inherit"
+  },
+  {
+    role: "search",
+    whenToUse: "Targeted code/file search, symbol lookup",
+    getSystemPrompt: () => SEARCH_PROMPT,
+    tools: "*",
+    disallowedTools: READ_ONLY_DISALLOWED,
+    source: "built-in",
+    model: "fast",
+    effort: "low"
+  }
+];
+function getBuiltInAgent(role) {
+  return BUILT_IN_AGENTS.find((a) => a.role === role);
+}
+function builtInAgentRegistry() {
+  const agents = [...BUILT_IN_AGENTS];
+  return {
+    agents,
+    get: (role) => agents.find((a) => a.role === role),
+    getBySource: (s) => agents.filter((a) => a.source === s)
+  };
+}
+export {
+  BUILT_IN_AGENTS,
+  builtInAgentRegistry,
+  getBuiltInAgent
+};
+//# sourceMappingURL=built-in.js.map

package/dist/adapters/agents/registry/built-in.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/registry/built-in.ts"],
+  "sourcesContent": ["import type { AgentRegistry } from './loader.js';\nimport type { AgentDefinition } from './types.js';\n\nconst GENERAL_PURPOSE_PROMPT = [\n  'You are a general-purpose AI agent with full tool access.',\n  'You can research complex questions, search code, and execute multi-step tasks.',\n  'Use all available tools as needed to complete the task thoroughly.',\n].join('\\n');\n\nconst EXPLORE_PROMPT = [\n  'You are a fast, read-only exploration agent.',\n  'Your job is to quickly find files, search code, and answer questions about the codebase.',\n  'You operate in read-only mode and cannot modify files.',\n  'Specify thoroughness: \"quick\" for basic searches, \"medium\" for moderate exploration,',\n  '\"very thorough\" for comprehensive analysis across multiple locations.',\n].join('\\n');\n\nconst PLAN_PROMPT = [\n  'You are a read-only planning agent for designing implementation approaches.',\n  'Analyze the codebase, identify architectural decisions, and propose implementation plans.',\n  'You cannot modify files \u2014 your output is a structured plan, not code changes.',\n].join('\\n');\n\nconst SEARCH_PROMPT = [\n  'You are a targeted search agent optimized for fast code and file discovery.',\n  'Find specific symbols, patterns, and files efficiently.',\n  'Return precise results with file paths and line numbers.',\n].join('\\n');\n\nconst READ_ONLY_DISALLOWED = [\n  'filesystem',\n  'create_directory',\n  'bash',\n  'tmux_exec',\n  'git_commit',\n  'git_push',\n];\n\nexport const BUILT_IN_AGENTS: readonly AgentDefinition[] = [\n  {\n    role: 'general-purpose',\n    whenToUse: 'Complex research, multi-step tasks requiring full tool access',\n    getSystemPrompt: () => GENERAL_PURPOSE_PROMPT,\n    tools: '*',\n    source: 'built-in',\n    model: 'inherit',\n  },\n  {\n    role: 'explore',\n    whenToUse: 'Fast codebase exploration, file search, read-only analysis',\n    getSystemPrompt: () => EXPLORE_PROMPT,\n    tools: '*',\n    disallowedTools: READ_ONLY_DISALLOWED,\n    source: 'built-in',\n    model: 'fast',\n    effort: 'low',\n  },\n  {\n    role: 'plan',\n    whenToUse:\n      'Architecture planning, implementation design, read-only analysis',\n    getSystemPrompt: () => PLAN_PROMPT,\n    tools: '*',\n    disallowedTools: READ_ONLY_DISALLOWED,\n    source: 'built-in',\n    model: 'inherit',\n  },\n  {\n    role: 'search',\n    whenToUse: 'Targeted code/file search, symbol lookup',\n    getSystemPrompt: () => SEARCH_PROMPT,\n    tools: '*',\n    disallowedTools: READ_ONLY_DISALLOWED,\n    source: 'built-in',\n    model: 'fast',\n    effort: 'low',\n  },\n] as const;\n\nexport function getBuiltInAgent(role: string): AgentDefinition | undefined {\n  return BUILT_IN_AGENTS.find((a) => a.role === role);\n}\n\n/**\n * Synchronous AgentRegistry containing only the shipped built-in agents\n * (`general-purpose`, `explore`, `plan`, `search`).\n *\n * Prefer this helper when you need a registry inside a synchronous code path\n * (e.g. the `Bridge` constructor wiring the `subagents` option). For project\n * and user-level agent files use the async `loadAgentRegistry()`.\n */\nexport function builtInAgentRegistry(): AgentRegistry {\n  const agents: AgentDefinition[] = [...BUILT_IN_AGENTS];\n  return {\n    agents,\n    get: (role) => agents.find((a) => a.role === role),\n    getBySource: (s) => agents.filter((a) => a.source === s),\n  };\n}\n"],
+  "mappings": "AAGA,MAAM,yBAAyB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,MAAM,iBAAiB;AAAA,EACrB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,MAAM,cAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,MAAM,gBAAgB;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,MAAM,uBAAuB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,kBAA8C;AAAA,EACzD;AAAA,IACE,MAAM;AAAA,IACN,WAAW;AAAA,IACX,iBAAiB,MAAM;AAAA,IACvB,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,WAAW;AAAA,IACX,iBAAiB,MAAM;AAAA,IACvB,OAAO;AAAA,IACP,iBAAiB;AAAA,IACjB,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,WACE;AAAA,IACF,iBAAiB,MAAM;AAAA,IACvB,OAAO;AAAA,IACP,iBAAiB;AAAA,IACjB,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,WAAW;AAAA,IACX,iBAAiB,MAAM;AAAA,IACvB,OAAO;AAAA,IACP,iBAAiB;AAAA,IACjB,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,QAAQ;AAAA,EACV;AACF;AAEO,SAAS,gBAAgB,MAA2C;AACzE,SAAO,gBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AACpD;AAUO,SAAS,uBAAsC;AACpD,QAAM,SAA4B,CAAC,GAAG,eAAe;AACrD,SAAO;AAAA,IACL;AAAA,IACA,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AAAA,IACjD,aAAa,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC;AAAA,EACzD;AACF;",
+  "names": []
+}

package/dist/adapters/agents/registry/loader.d.ts

@@ -0,0 +1,26 @@
+import type { AgentDefinition, AgentDefinitionSource } from './types.js';
+export interface AgentRegistryOptions {
+    projectRoot?: string;
+    userHome?: string;
+    skipBuiltIn?: boolean;
+    skipProject?: boolean;
+    skipUser?: boolean;
+    /**
+     * Walk parent directories from `cwd` (or {@link AgentRegistryOptions.start})
+     * looking for a project workspace sentinel — `.octoflow/`, `AGENTS.md`,
+     * `package.json`, or `.git`. The first match becomes `projectRoot`.
+     *
+     * Off by default to keep callers explicit. Ignored when `projectRoot` is
+     * passed, when `skipProject` is true, or when no sentinel is found.
+     */
+    autoDiscoverProject?: boolean;
+    /** Starting directory for `autoDiscoverProject`. Defaults to `process.cwd()`. */
+    start?: string;
+}
+export interface AgentRegistry {
+    readonly agents: ReadonlyArray<AgentDefinition>;
+    get(role: string): AgentDefinition | undefined;
+    getBySource(source: AgentDefinitionSource): AgentDefinition[];
+}
+export declare function loadAgentRegistry(options?: AgentRegistryOptions): Promise<AgentRegistry>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/adapters/agents/registry/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/registry/loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AA+GpB,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAC/C,WAAW,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,EAAE,CAAC;CAC/D;AAUD,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAwCxB"}

package/dist/adapters/agents/registry/loader.js

@@ -0,0 +1,114 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { OctoFlowError } from "../../../domain/errors/index.js";
+import { BUILT_IN_AGENTS, getBuiltInAgent } from "./built-in.js";
+import { findProjectRoot } from "./project-discovery.js";
+const PROJECT_AGENTS_DIR = ".octoflow/agents";
+const USER_AGENTS_DIR = ".octoflow/agents";
+async function loadYaml(text) {
+  try {
+    const jsYaml = await import("js-yaml");
+    return jsYaml.load(text);
+  } catch {
+    throw new Error(
+      "YAML agent loading requires the optional `js-yaml` package.\nInstall: npm install js-yaml"
+    );
+  }
+}
+function parseAgentYaml(raw, source, _file) {
+  if (!raw.role || !raw.whenToUse) return null;
+  const systemPrompt = raw.systemPrompt ?? "";
+  return {
+    role: raw.role,
+    whenToUse: raw.whenToUse,
+    getSystemPrompt: () => systemPrompt,
+    tools: raw.tools ?? "*",
+    disallowedTools: raw.disallowedTools,
+    source,
+    model: raw.model,
+    effort: raw.effort,
+    maxTurns: raw.maxTurns,
+    background: raw.background,
+    memory: raw.memory,
+    isolation: raw.isolation,
+    permissionMode: raw.permissionMode,
+    color: raw.color,
+    backendPriority: raw.backendPriority,
+    skills: raw.skills,
+    approvals: parseApprovalPolicy(raw.approvals)
+  };
+}
+function parseApprovalPolicy(raw) {
+  if (!raw || typeof raw.mode !== "string") return void 0;
+  if (raw.mode !== "always" && raw.mode !== "never" && raw.mode !== "tools") {
+    return void 0;
+  }
+  return {
+    mode: raw.mode,
+    tools: raw.mode === "tools" && Array.isArray(raw.tools) ? raw.tools : void 0
+  };
+}
+async function loadAgentsFromDir(dir, source) {
+  const agents = [];
+  let entries;
+  try {
+    entries = await fs.readdir(dir);
+  } catch {
+    return agents;
+  }
+  for (const entry of entries) {
+    if (!entry.endsWith(".yaml") && !entry.endsWith(".yml")) continue;
+    try {
+      const text = await fs.readFile(path.join(dir, entry), "utf-8");
+      const raw = await loadYaml(text);
+      if (raw && typeof raw === "object") {
+        const def = parseAgentYaml(raw, source, path.join(dir, entry));
+        if (def) agents.push(def);
+      }
+    } catch (error) {
+      if (error instanceof OctoFlowError) throw error;
+    }
+  }
+  return agents;
+}
+async function resolveProjectRoot(options) {
+  if (options.projectRoot) return options.projectRoot;
+  if (!options.autoDiscoverProject || options.skipProject) return void 0;
+  return findProjectRoot({ start: options.start });
+}
+async function loadAgentRegistry(options = {}) {
+  const agents = [];
+  if (!options.skipBuiltIn) {
+    agents.push(...BUILT_IN_AGENTS);
+  }
+  const resolvedProjectRoot = await resolveProjectRoot(options);
+  if (!options.skipProject && resolvedProjectRoot) {
+    const projectDir = path.join(resolvedProjectRoot, PROJECT_AGENTS_DIR);
+    const projectAgents = await loadAgentsFromDir(projectDir, "project");
+    agents.push(...projectAgents);
+  }
+  if (!options.skipUser) {
+    const home = options.userHome ?? process.env["HOME"] ?? process.env["USERPROFILE"] ?? "";
+    if (home) {
+      const userDir = path.join(home, USER_AGENTS_DIR);
+      const userAgents = await loadAgentsFromDir(userDir, "user");
+      agents.push(...userAgents);
+    }
+  }
+  return {
+    agents,
+    get(role) {
+      for (let i = agents.length - 1; i >= 0; i--) {
+        if (agents[i].role === role) return agents[i];
+      }
+      return getBuiltInAgent(role);
+    },
+    getBySource(source) {
+      return agents.filter((a) => a.source === source);
+    }
+  };
+}
+export {
+  loadAgentRegistry
+};
+//# sourceMappingURL=loader.js.map

package/dist/adapters/agents/registry/loader.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/registry/loader.ts"],
+  "sourcesContent": ["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { OctoFlowError } from '../../../domain/errors/index.js';\nimport { BUILT_IN_AGENTS, getBuiltInAgent } from './built-in.js';\nimport { findProjectRoot } from './project-discovery.js';\nimport type {\n  AgentApprovalPolicy,\n  AgentDefinition,\n  AgentDefinitionSource,\n} from './types.js';\n\nconst PROJECT_AGENTS_DIR = '.octoflow/agents';\nconst USER_AGENTS_DIR = '.octoflow/agents';\n\ninterface RawAgentYaml {\n  role?: string;\n  whenToUse?: string;\n  systemPrompt?: string;\n  tools?: string[] | '*';\n  disallowedTools?: string[];\n  model?: string;\n  effort?: string;\n  maxTurns?: number;\n  background?: boolean;\n  memory?: string;\n  isolation?: string;\n  permissionMode?: string;\n  color?: string;\n  backendPriority?: string[];\n  skills?: string[];\n  approvals?: { mode?: string; tools?: string[] };\n}\n\nasync function loadYaml(text: string): Promise<unknown> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion -- `as string` forces dynamic import (optional dep; avoids type-check requirement on @types/js-yaml).\n    const jsYaml = await (import('js-yaml' as string) as Promise<{\n      load: (s: string) => unknown;\n    }>);\n    return jsYaml.load(text);\n  } catch {\n    throw new Error(\n      'YAML agent loading requires the optional `js-yaml` package.\\n' +\n        'Install: npm install js-yaml'\n    );\n  }\n}\n\nfunction parseAgentYaml(\n  raw: RawAgentYaml,\n  source: AgentDefinitionSource,\n  _file: string\n): AgentDefinition | null {\n  if (!raw.role || !raw.whenToUse) return null;\n\n  const systemPrompt = raw.systemPrompt ?? '';\n  return {\n    role: raw.role,\n    whenToUse: raw.whenToUse,\n    getSystemPrompt: () => systemPrompt,\n    tools: raw.tools ?? '*',\n    disallowedTools: raw.disallowedTools,\n    source,\n    model: raw.model,\n    effort: raw.effort as AgentDefinition['effort'],\n    maxTurns: raw.maxTurns,\n    background: raw.background,\n    memory: raw.memory as AgentDefinition['memory'],\n    isolation: raw.isolation as AgentDefinition['isolation'],\n    permissionMode: raw.permissionMode,\n    color: raw.color,\n    backendPriority: raw.backendPriority,\n    skills: raw.skills,\n    approvals: parseApprovalPolicy(raw.approvals),\n  };\n}\n\nfunction parseApprovalPolicy(\n  raw: RawAgentYaml['approvals']\n): AgentApprovalPolicy | undefined {\n  if (!raw || typeof raw.mode !== 'string') return undefined;\n  if (raw.mode !== 'always' && raw.mode !== 'never' && raw.mode !== 'tools') {\n    return undefined;\n  }\n  return {\n    mode: raw.mode,\n    tools:\n      raw.mode === 'tools' && Array.isArray(raw.tools) ? raw.tools : undefined,\n  };\n}\n\nasync function loadAgentsFromDir(\n  dir: string,\n  source: AgentDefinitionSource\n): Promise<AgentDefinition[]> {\n  const agents: AgentDefinition[] = [];\n  let entries: string[];\n  try {\n    entries = await fs.readdir(dir);\n  } catch {\n    return agents;\n  }\n\n  for (const entry of entries) {\n    if (!entry.endsWith('.yaml') && !entry.endsWith('.yml')) continue;\n    try {\n      const text = await fs.readFile(path.join(dir, entry), 'utf-8');\n      const raw = (await loadYaml(text)) as RawAgentYaml;\n      if (raw && typeof raw === 'object') {\n        const def = parseAgentYaml(raw, source, path.join(dir, entry));\n        if (def) agents.push(def);\n      }\n    } catch (error) {\n      if (error instanceof OctoFlowError) throw error;\n      // skip malformed files\n    }\n  }\n  return agents;\n}\n\nexport interface AgentRegistryOptions {\n  projectRoot?: string;\n  userHome?: string;\n  skipBuiltIn?: boolean;\n  skipProject?: boolean;\n  skipUser?: boolean;\n  /**\n   * Walk parent directories from `cwd` (or {@link AgentRegistryOptions.start})\n   * looking for a project workspace sentinel \u2014 `.octoflow/`, `AGENTS.md`,\n   * `package.json`, or `.git`. The first match becomes `projectRoot`.\n   *\n   * Off by default to keep callers explicit. Ignored when `projectRoot` is\n   * passed, when `skipProject` is true, or when no sentinel is found.\n   */\n  autoDiscoverProject?: boolean;\n  /** Starting directory for `autoDiscoverProject`. Defaults to `process.cwd()`. */\n  start?: string;\n}\n\nexport interface AgentRegistry {\n  readonly agents: ReadonlyArray<AgentDefinition>;\n  get(role: string): AgentDefinition | undefined;\n  getBySource(source: AgentDefinitionSource): AgentDefinition[];\n}\n\nasync function resolveProjectRoot(\n  options: AgentRegistryOptions\n): Promise<string | undefined> {\n  if (options.projectRoot) return options.projectRoot;\n  if (!options.autoDiscoverProject || options.skipProject) return undefined;\n  return findProjectRoot({ start: options.start });\n}\n\nexport async function loadAgentRegistry(\n  options: AgentRegistryOptions = {}\n): Promise<AgentRegistry> {\n  const agents: AgentDefinition[] = [];\n\n  if (!options.skipBuiltIn) {\n    agents.push(...BUILT_IN_AGENTS);\n  }\n\n  const resolvedProjectRoot = await resolveProjectRoot(options);\n\n  if (!options.skipProject && resolvedProjectRoot) {\n    const projectDir = path.join(resolvedProjectRoot, PROJECT_AGENTS_DIR);\n    const projectAgents = await loadAgentsFromDir(projectDir, 'project');\n    agents.push(...projectAgents);\n  }\n\n  if (!options.skipUser) {\n    const home =\n      options.userHome ??\n      process.env['HOME'] ??\n      process.env['USERPROFILE'] ??\n      '';\n    if (home) {\n      const userDir = path.join(home, USER_AGENTS_DIR);\n      const userAgents = await loadAgentsFromDir(userDir, 'user');\n      agents.push(...userAgents);\n    }\n  }\n\n  return {\n    agents,\n    get(role: string): AgentDefinition | undefined {\n      for (let i = agents.length - 1; i >= 0; i--) {\n        if (agents[i]!.role === role) return agents[i];\n      }\n      return getBuiltInAgent(role);\n    },\n    getBySource(source: AgentDefinitionSource): AgentDefinition[] {\n      return agents.filter((a) => a.source === source);\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/adapters/agents/registry/project-discovery.d.ts

@@ -0,0 +1,30 @@
+export interface FindProjectRootOptions {
+    /** Starting directory. Defaults to `process.cwd()`. */
+    start?: string;
+    /** Cap on parent walk (defense-in-depth). Defaults to 32 levels. */
+    maxDepth?: number;
+}
+export declare function findProjectRoot(options?: FindProjectRootOptions): Promise<string | undefined>;
+export interface ProjectWorkspace {
+    root: string;
+    /** `<root>/.octoflow` if present. */
+    octoFlowDir?: string;
+    /** `<root>/.octoflow/agents` if present. */
+    agentsDir?: string;
+    /** `<root>/.octoflow/skills` if present. */
+    skillsDir?: string;
+    /** `<root>/.octoflow/mcp.json` if present. */
+    mcpConfigPath?: string;
+    /** `<root>/AGENTS.md` if present. */
+    agentsMdPath?: string;
+    /** `<root>/MEMORY.md` if present. */
+    memoryFilePath?: string;
+    /** `<root>/memory/` if present (recursive markdown discovery left to indexer). */
+    memoryDir?: string;
+}
+export interface DiscoverProjectWorkspaceOptions extends FindProjectRootOptions {
+    /** Skip `findProjectRoot()` and use this directory directly. */
+    root?: string;
+}
+export declare function discoverProjectWorkspace(options?: DiscoverProjectWorkspaceOptions): Promise<ProjectWorkspace | undefined>;
+//# sourceMappingURL=project-discovery.d.ts.map

package/dist/adapters/agents/registry/project-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-discovery.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/registry/project-discovery.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B;AAWD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAAgC,SAAQ,sBAAsB;IAC7E,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA6CvC"}

package/dist/adapters/agents/registry/project-discovery.js

@@ -0,0 +1,93 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const PROJECT_OCTOFLOW_DIR = ".octoflow";
+const PROJECT_AGENTS_DIR = path.join(PROJECT_OCTOFLOW_DIR, "agents");
+const PROJECT_SKILLS_DIR = path.join(PROJECT_OCTOFLOW_DIR, "skills");
+const PROJECT_MCP_FILE = path.join(PROJECT_OCTOFLOW_DIR, "mcp.json");
+const PROJECT_MEMORY_FILE = "MEMORY.md";
+const PROJECT_AGENTS_MD = "AGENTS.md";
+const PROJECT_MEMORY_DIR = "memory";
+const ROOT_SENTINELS = [
+  PROJECT_OCTOFLOW_DIR,
+  PROJECT_AGENTS_MD,
+  "package.json",
+  ".git"
+];
+async function findProjectRoot(options = {}) {
+  const start = path.resolve(options.start ?? process.cwd());
+  const maxDepth = options.maxDepth ?? 32;
+  let current = start;
+  for (let depth = 0; depth <= maxDepth; depth += 1) {
+    if (await hasAnySentinel(current)) {
+      return current;
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      return void 0;
+    }
+    current = parent;
+  }
+  return void 0;
+}
+async function hasAnySentinel(dir) {
+  for (const sentinel of ROOT_SENTINELS) {
+    if (await pathExists(path.join(dir, sentinel))) {
+      return true;
+    }
+  }
+  return false;
+}
+async function discoverProjectWorkspace(options = {}) {
+  const root = options.root ? path.resolve(options.root) : await findProjectRoot({
+    start: options.start,
+    maxDepth: options.maxDepth
+  });
+  if (!root) return void 0;
+  const octoFlowDir = path.join(root, PROJECT_OCTOFLOW_DIR);
+  const agentsDir = path.join(root, PROJECT_AGENTS_DIR);
+  const skillsDir = path.join(root, PROJECT_SKILLS_DIR);
+  const mcpConfigPath = path.join(root, PROJECT_MCP_FILE);
+  const agentsMdPath = path.join(root, PROJECT_AGENTS_MD);
+  const memoryFilePath = path.join(root, PROJECT_MEMORY_FILE);
+  const memoryDir = path.join(root, PROJECT_MEMORY_DIR);
+  const [
+    hasOctoFlow,
+    hasAgents,
+    hasSkills,
+    hasMcp,
+    hasAgentsMd,
+    hasMemoryFile,
+    hasMemoryDir
+  ] = await Promise.all([
+    pathExists(octoFlowDir),
+    pathExists(agentsDir),
+    pathExists(skillsDir),
+    pathExists(mcpConfigPath),
+    pathExists(agentsMdPath),
+    pathExists(memoryFilePath),
+    pathExists(memoryDir)
+  ]);
+  return {
+    root,
+    octoFlowDir: hasOctoFlow ? octoFlowDir : void 0,
+    agentsDir: hasAgents ? agentsDir : void 0,
+    skillsDir: hasSkills ? skillsDir : void 0,
+    mcpConfigPath: hasMcp ? mcpConfigPath : void 0,
+    agentsMdPath: hasAgentsMd ? agentsMdPath : void 0,
+    memoryFilePath: hasMemoryFile ? memoryFilePath : void 0,
+    memoryDir: hasMemoryDir ? memoryDir : void 0
+  };
+}
+async function pathExists(target) {
+  try {
+    await fs.stat(target);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  discoverProjectWorkspace,
+  findProjectRoot
+};
+//# sourceMappingURL=project-discovery.js.map

package/dist/adapters/agents/registry/project-discovery.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/registry/project-discovery.ts"],
+  "sourcesContent": ["/**\n * Upward project-root discovery and convention-based workspace probing.\n *\n * `findProjectRoot()` walks parents from a starting directory looking for\n * sentinel files in priority order. `discoverProjectWorkspace()` reports the\n * locations of agent definitions, skills, MCP config, AGENTS.md, and\n * `MEMORY.md` / `memory/` files for that root, so callers can wire local\n * conventions without extra plumbing.\n *\n * No file is read here beyond `stat` \u2014 content loading lives elsewhere\n * (`loadAgentRegistry()` for agents, `indexMemoryFiles()` for memory).\n */\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\nconst PROJECT_OCTOFLOW_DIR = '.octoflow';\nconst PROJECT_AGENTS_DIR = path.join(PROJECT_OCTOFLOW_DIR, 'agents');\nconst PROJECT_SKILLS_DIR = path.join(PROJECT_OCTOFLOW_DIR, 'skills');\nconst PROJECT_MCP_FILE = path.join(PROJECT_OCTOFLOW_DIR, 'mcp.json');\nconst PROJECT_MEMORY_FILE = 'MEMORY.md';\nconst PROJECT_AGENTS_MD = 'AGENTS.md';\nconst PROJECT_MEMORY_DIR = 'memory';\n\n/**\n * Sentinels examined when walking upward, highest priority first.\n *\n * `.octoflow/` and `AGENTS.md` are the strong signals \u2014 they're\n * intentional repo-level conventions. `package.json` and `.git` are\n * weaker fallbacks for \"the workspace probably starts here\".\n */\nconst ROOT_SENTINELS = [\n  PROJECT_OCTOFLOW_DIR,\n  PROJECT_AGENTS_MD,\n  'package.json',\n  '.git',\n] as const;\n\nexport interface FindProjectRootOptions {\n  /** Starting directory. Defaults to `process.cwd()`. */\n  start?: string;\n  /** Cap on parent walk (defense-in-depth). Defaults to 32 levels. */\n  maxDepth?: number;\n}\n\nexport async function findProjectRoot(\n  options: FindProjectRootOptions = {}\n): Promise<string | undefined> {\n  const start = path.resolve(options.start ?? process.cwd());\n  const maxDepth = options.maxDepth ?? 32;\n  let current = start;\n\n  for (let depth = 0; depth <= maxDepth; depth += 1) {\n    if (await hasAnySentinel(current)) {\n      return current;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) {\n      return undefined;\n    }\n    current = parent;\n  }\n  return undefined;\n}\n\nasync function hasAnySentinel(dir: string): Promise<boolean> {\n  for (const sentinel of ROOT_SENTINELS) {\n    if (await pathExists(path.join(dir, sentinel))) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport interface ProjectWorkspace {\n  root: string;\n  /** `<root>/.octoflow` if present. */\n  octoFlowDir?: string;\n  /** `<root>/.octoflow/agents` if present. */\n  agentsDir?: string;\n  /** `<root>/.octoflow/skills` if present. */\n  skillsDir?: string;\n  /** `<root>/.octoflow/mcp.json` if present. */\n  mcpConfigPath?: string;\n  /** `<root>/AGENTS.md` if present. */\n  agentsMdPath?: string;\n  /** `<root>/MEMORY.md` if present. */\n  memoryFilePath?: string;\n  /** `<root>/memory/` if present (recursive markdown discovery left to indexer). */\n  memoryDir?: string;\n}\n\nexport interface DiscoverProjectWorkspaceOptions extends FindProjectRootOptions {\n  /** Skip `findProjectRoot()` and use this directory directly. */\n  root?: string;\n}\n\nexport async function discoverProjectWorkspace(\n  options: DiscoverProjectWorkspaceOptions = {}\n): Promise<ProjectWorkspace | undefined> {\n  const root = options.root\n    ? path.resolve(options.root)\n    : await findProjectRoot({\n        start: options.start,\n        maxDepth: options.maxDepth,\n      });\n  if (!root) return undefined;\n\n  const octoFlowDir = path.join(root, PROJECT_OCTOFLOW_DIR);\n  const agentsDir = path.join(root, PROJECT_AGENTS_DIR);\n  const skillsDir = path.join(root, PROJECT_SKILLS_DIR);\n  const mcpConfigPath = path.join(root, PROJECT_MCP_FILE);\n  const agentsMdPath = path.join(root, PROJECT_AGENTS_MD);\n  const memoryFilePath = path.join(root, PROJECT_MEMORY_FILE);\n  const memoryDir = path.join(root, PROJECT_MEMORY_DIR);\n\n  const [\n    hasOctoFlow,\n    hasAgents,\n    hasSkills,\n    hasMcp,\n    hasAgentsMd,\n    hasMemoryFile,\n    hasMemoryDir,\n  ] = await Promise.all([\n    pathExists(octoFlowDir),\n    pathExists(agentsDir),\n    pathExists(skillsDir),\n    pathExists(mcpConfigPath),\n    pathExists(agentsMdPath),\n    pathExists(memoryFilePath),\n    pathExists(memoryDir),\n  ]);\n\n  return {\n    root,\n    octoFlowDir: hasOctoFlow ? octoFlowDir : undefined,\n    agentsDir: hasAgents ? agentsDir : undefined,\n    skillsDir: hasSkills ? skillsDir : undefined,\n    mcpConfigPath: hasMcp ? mcpConfigPath : undefined,\n    agentsMdPath: hasAgentsMd ? agentsMdPath : undefined,\n    memoryFilePath: hasMemoryFile ? memoryFilePath : undefined,\n    memoryDir: hasMemoryDir ? memoryDir : undefined,\n  };\n}\n\nasync function pathExists(target: string): Promise<boolean> {\n  try {\n    await fs.stat(target);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],
+  "mappings": "AAYA,OAAO,QAAQ;AACf,OAAO,UAAU;AAEjB,MAAM,uBAAuB;AAC7B,MAAM,qBAAqB,KAAK,KAAK,sBAAsB,QAAQ;AACnE,MAAM,qBAAqB,KAAK,KAAK,sBAAsB,QAAQ;AACnE,MAAM,mBAAmB,KAAK,KAAK,sBAAsB,UAAU;AACnE,MAAM,sBAAsB;AAC5B,MAAM,oBAAoB;AAC1B,MAAM,qBAAqB;AAS3B,MAAM,iBAAiB;AAAA,EACrB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AASA,eAAsB,gBACpB,UAAkC,CAAC,GACN;AAC7B,QAAM,QAAQ,KAAK,QAAQ,QAAQ,SAAS,QAAQ,IAAI,CAAC;AACzD,QAAM,WAAW,QAAQ,YAAY;AACrC,MAAI,UAAU;AAEd,WAAS,QAAQ,GAAG,SAAS,UAAU,SAAS,GAAG;AACjD,QAAI,MAAM,eAAe,OAAO,GAAG;AACjC,aAAO;AAAA,IACT;AACA,UAAM,SAAS,KAAK,QAAQ,OAAO;AACnC,QAAI,WAAW,SAAS;AACtB,aAAO;AAAA,IACT;AACA,cAAU;AAAA,EACZ;AACA,SAAO;AACT;AAEA,eAAe,eAAe,KAA+B;AAC3D,aAAW,YAAY,gBAAgB;AACrC,QAAI,MAAM,WAAW,KAAK,KAAK,KAAK,QAAQ,CAAC,GAAG;AAC9C,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAyBA,eAAsB,yBACpB,UAA2C,CAAC,GACL;AACvC,QAAM,OAAO,QAAQ,OACjB,KAAK,QAAQ,QAAQ,IAAI,IACzB,MAAM,gBAAgB;AAAA,IACpB,OAAO,QAAQ;AAAA,IACf,UAAU,QAAQ;AAAA,EACpB,CAAC;AACL,MAAI,CAAC,KAAM,QAAO;AAElB,QAAM,cAAc,KAAK,KAAK,MAAM,oBAAoB;AACxD,QAAM,YAAY,KAAK,KAAK,MAAM,kBAAkB;AACpD,QAAM,YAAY,KAAK,KAAK,MAAM,kBAAkB;AACpD,QAAM,gBAAgB,KAAK,KAAK,MAAM,gBAAgB;AACtD,QAAM,eAAe,KAAK,KAAK,MAAM,iBAAiB;AACtD,QAAM,iBAAiB,KAAK,KAAK,MAAM,mBAAmB;AAC1D,QAAM,YAAY,KAAK,KAAK,MAAM,kBAAkB;AAEpD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,MAAM,QAAQ,IAAI;AAAA,IACpB,WAAW,WAAW;AAAA,IACtB,WAAW,SAAS;AAAA,IACpB,WAAW,SAAS;AAAA,IACpB,WAAW,aAAa;AAAA,IACxB,WAAW,YAAY;AAAA,IACvB,WAAW,cAAc;AAAA,IACzB,WAAW,SAAS;AAAA,EACtB,CAAC;AAED,SAAO;AAAA,IACL;AAAA,IACA,aAAa,cAAc,cAAc;AAAA,IACzC,WAAW,YAAY,YAAY;AAAA,IACnC,WAAW,YAAY,YAAY;AAAA,IACnC,eAAe,SAAS,gBAAgB;AAAA,IACxC,cAAc,cAAc,eAAe;AAAA,IAC3C,gBAAgB,gBAAgB,iBAAiB;AAAA,IACjD,WAAW,eAAe,YAAY;AAAA,EACxC;AACF;AAEA,eAAe,WAAW,QAAkC;AAC1D,MAAI;AACF,UAAM,GAAG,KAAK,MAAM;AACpB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/dist/adapters/agents/registry/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Agent registry types: definitions, lineage, and tree query.
+ *
+ * These types power the agent registry (built-in + project + user agents),
+ * unified lineage tracking across Pack / DeepAgents / standalone harness,
+ * and the agent tree query API.
+ */
+import type { EffortLevel } from '../../../domain/contracts/backends.js';
+export type { EffortLevel };
+export type { AgentApprovalMode, AgentApprovalPolicy, AgentDefinition, AgentDefinitionSource, AgentIsolationStrategy, AgentLineage, AgentNodeStatus, AgentTreeNode, RegistryMemoryScope, } from '../../../domain/agent-registry.js';
+import type { AgentIsolationStrategy, AgentLineage } from '../../../domain/agent-registry.js';
+export declare function createRootLineage(agentName: string, agentId?: string): AgentLineage;
+export declare function forkLineage(parent: AgentLineage, childName: string, opts?: {
+    sessionId?: string;
+    contextId?: string;
+    taskId?: string;
+    isolation?: AgentIsolationStrategy;
+}): AgentLineage;
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/agents/registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/registry/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,sBAAsB,EACtB,YAAY,EACb,MAAM,mCAAmC,CAAC;AAC3C,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,YAAY,CASd;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IACL,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC,GACA,YAAY,CAcd"}

package/dist/adapters/agents/registry/types.js

@@ -0,0 +1,30 @@
+function createRootLineage(agentName, agentId) {
+  const id = agentId ?? crypto.randomUUID();
+  return {
+    agentId: id,
+    agentName,
+    rootAgentId: id,
+    depth: 0,
+    spawnedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function forkLineage(parent, childName, opts) {
+  const childId = crypto.randomUUID();
+  return {
+    agentId: childId,
+    agentName: childName,
+    parentAgentId: parent.agentId,
+    parentSessionId: opts?.sessionId,
+    parentContextId: opts?.contextId,
+    parentTaskId: opts?.taskId,
+    rootAgentId: parent.rootAgentId ?? parent.agentId,
+    depth: parent.depth + 1,
+    spawnedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    isolation: opts?.isolation
+  };
+}
+export {
+  createRootLineage,
+  forkLineage
+};
+//# sourceMappingURL=types.js.map

package/dist/adapters/agents/registry/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/registry/types.ts"],
+  "sourcesContent": ["/**\n * Agent registry types: definitions, lineage, and tree query.\n *\n * These types power the agent registry (built-in + project + user agents),\n * unified lineage tracking across Pack / DeepAgents / standalone harness,\n * and the agent tree query API.\n */\n\nimport type { EffortLevel } from '../../../domain/contracts/backends.js';\n\nexport type { EffortLevel };\nexport type {\n  AgentApprovalMode,\n  AgentApprovalPolicy,\n  AgentDefinition,\n  AgentDefinitionSource,\n  AgentIsolationStrategy,\n  AgentLineage,\n  AgentNodeStatus,\n  AgentTreeNode,\n  RegistryMemoryScope,\n} from '../../../domain/agent-registry.js';\nimport type {\n  AgentIsolationStrategy,\n  AgentLineage,\n} from '../../../domain/agent-registry.js';\nexport function createRootLineage(\n  agentName: string,\n  agentId?: string\n): AgentLineage {\n  const id = agentId ?? crypto.randomUUID();\n  return {\n    agentId: id,\n    agentName,\n    rootAgentId: id,\n    depth: 0,\n    spawnedAt: new Date().toISOString(),\n  };\n}\n\nexport function forkLineage(\n  parent: AgentLineage,\n  childName: string,\n  opts?: {\n    sessionId?: string;\n    contextId?: string;\n    taskId?: string;\n    isolation?: AgentIsolationStrategy;\n  }\n): AgentLineage {\n  const childId = crypto.randomUUID();\n  return {\n    agentId: childId,\n    agentName: childName,\n    parentAgentId: parent.agentId,\n    parentSessionId: opts?.sessionId,\n    parentContextId: opts?.contextId,\n    parentTaskId: opts?.taskId,\n    rootAgentId: parent.rootAgentId ?? parent.agentId,\n    depth: parent.depth + 1,\n    spawnedAt: new Date().toISOString(),\n    isolation: opts?.isolation,\n  };\n}\n"],
+  "mappings": "AA0BO,SAAS,kBACd,WACA,SACc;AACd,QAAM,KAAK,WAAW,OAAO,WAAW;AACxC,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,aAAa;AAAA,IACb,OAAO;AAAA,IACP,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AACF;AAEO,SAAS,YACd,QACA,WACA,MAMc;AACd,QAAM,UAAU,OAAO,WAAW;AAClC,SAAO;AAAA,IACL,SAAS;AAAA,IACT,WAAW;AAAA,IACX,eAAe,OAAO;AAAA,IACtB,iBAAiB,MAAM;AAAA,IACvB,iBAAiB,MAAM;AAAA,IACvB,cAAc,MAAM;AAAA,IACpB,aAAa,OAAO,eAAe,OAAO;AAAA,IAC1C,OAAO,OAAO,QAAQ;AAAA,IACtB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,WAAW,MAAM;AAAA,EACnB;AACF;",
+  "names": []
+}

package/dist/adapters/agents/routing.d.ts

@@ -0,0 +1,28 @@
+import type { BackendName } from '../../domain/core-client.js';
+/**
+ * A routing strategy examines the message content and optionally overrides
+ * the priority-based backend selection. Return a BackendName to route to
+ * that backend, or `null` to fall through to the default priority loop.
+ */
+export interface RoutingStrategy {
+    route(message: string): BackendName | null;
+    /** Model override applied when the strategy routes to a cheap backend. */
+    routedModel?: string;
+}
+export interface ComplexityRoutingConfig {
+    strategy: 'complexity';
+    /** Backend to route simple messages to. */
+    cheapBackend: BackendName;
+    /** Model override for the cheap backend. */
+    cheapModel?: string;
+    /** Max characters for a message to be classified as simple. Default: 160. */
+    maxSimpleChars?: number;
+    /** Max words for a message to be classified as simple. Default: 28. */
+    maxSimpleWords?: number;
+    /** Keywords that force a message to be classified as complex. */
+    complexKeywords?: string[];
+    /** Regex patterns that force a message to be classified as complex. */
+    alwaysComplex?: RegExp[];
+}
+export declare function complexityRouter(config: ComplexityRoutingConfig): RoutingStrategy;
+//# sourceMappingURL=routing.d.ts.map

package/dist/adapters/agents/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAC3C,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,YAAY,CAAC;IACvB,2CAA2C;IAC3C,YAAY,EAAE,WAAW,CAAC;IAC1B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAiDD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,uBAAuB,GAC9B,eAAe,CAOjB"}

package/dist/adapters/agents/routing.js

@@ -0,0 +1,48 @@
+const DEFAULT_COMPLEX_KEYWORDS = [
+  "debug",
+  "implement",
+  "refactor",
+  "analyze",
+  "investigate",
+  "architecture",
+  "optimize",
+  "review",
+  "test",
+  "plan",
+  "delegate",
+  "docker",
+  "kubernetes",
+  "deploy",
+  "migrate",
+  "benchmark"
+];
+const URL_PATTERN = /https?:\/\//;
+const CODE_FENCE_PATTERN = /`/;
+function isSimpleMessage(message, config) {
+  const maxChars = config.maxSimpleChars ?? 160;
+  const maxWords = config.maxSimpleWords ?? 28;
+  const keywords = config.complexKeywords ?? DEFAULT_COMPLEX_KEYWORDS;
+  if (message.length > maxChars) return false;
+  const wordCount = message.split(/\s+/).filter(Boolean).length;
+  if (wordCount > maxWords) return false;
+  if (CODE_FENCE_PATTERN.test(message)) return false;
+  if (URL_PATTERN.test(message)) return false;
+  const newlineCount = (message.match(/\n/g) ?? []).length;
+  if (newlineCount > 1) return false;
+  const lower = message.toLowerCase();
+  if (keywords.some((kw) => lower.includes(kw))) return false;
+  if (config.alwaysComplex?.some((re) => re.test(message))) return false;
+  return true;
+}
+function complexityRouter(config) {
+  return {
+    routedModel: config.cheapModel,
+    route(message) {
+      return isSimpleMessage(message, config) ? config.cheapBackend : null;
+    }
+  };
+}
+export {
+  complexityRouter
+};
+//# sourceMappingURL=routing.js.map

package/dist/adapters/agents/routing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/agents/routing.ts"],
+  "sourcesContent": ["import type { BackendName } from '../../domain/core-client.js';\n/**\n * A routing strategy examines the message content and optionally overrides\n * the priority-based backend selection. Return a BackendName to route to\n * that backend, or `null` to fall through to the default priority loop.\n */\nexport interface RoutingStrategy {\n  route(message: string): BackendName | null;\n  /** Model override applied when the strategy routes to a cheap backend. */\n  routedModel?: string;\n}\nexport interface ComplexityRoutingConfig {\n  strategy: 'complexity';\n  /** Backend to route simple messages to. */\n  cheapBackend: BackendName;\n  /** Model override for the cheap backend. */\n  cheapModel?: string;\n  /** Max characters for a message to be classified as simple. Default: 160. */\n  maxSimpleChars?: number;\n  /** Max words for a message to be classified as simple. Default: 28. */\n  maxSimpleWords?: number;\n  /** Keywords that force a message to be classified as complex. */\n  complexKeywords?: string[];\n  /** Regex patterns that force a message to be classified as complex. */\n  alwaysComplex?: RegExp[];\n}\nconst DEFAULT_COMPLEX_KEYWORDS: string[] = [\n  'debug',\n  'implement',\n  'refactor',\n  'analyze',\n  'investigate',\n  'architecture',\n  'optimize',\n  'review',\n  'test',\n  'plan',\n  'delegate',\n  'docker',\n  'kubernetes',\n  'deploy',\n  'migrate',\n  'benchmark',\n];\n\nconst URL_PATTERN = /https?:\\/\\//;\nconst CODE_FENCE_PATTERN = /`/;\nfunction isSimpleMessage(\n  message: string,\n  config: ComplexityRoutingConfig\n): boolean {\n  const maxChars = config.maxSimpleChars ?? 160;\n  const maxWords = config.maxSimpleWords ?? 28;\n  const keywords = config.complexKeywords ?? DEFAULT_COMPLEX_KEYWORDS;\n\n  if (message.length > maxChars) return false;\n\n  const wordCount = message.split(/\\s+/).filter(Boolean).length;\n  if (wordCount > maxWords) return false;\n\n  if (CODE_FENCE_PATTERN.test(message)) return false;\n  if (URL_PATTERN.test(message)) return false;\n\n  const newlineCount = (message.match(/\\n/g) ?? []).length;\n  if (newlineCount > 1) return false;\n\n  const lower = message.toLowerCase();\n  if (keywords.some((kw) => lower.includes(kw))) return false;\n\n  if (config.alwaysComplex?.some((re) => re.test(message))) return false;\n\n  return true;\n}\n\nexport function complexityRouter(\n  config: ComplexityRoutingConfig\n): RoutingStrategy {\n  return {\n    routedModel: config.cheapModel,\n    route(message: string): BackendName | null {\n      return isSimpleMessage(message, config) ? config.cheapBackend : null;\n    },\n  };\n}\n"],
+  "mappings": "AA0BA,MAAM,2BAAqC;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,cAAc;AACpB,MAAM,qBAAqB;AAC3B,SAAS,gBACP,SACA,QACS;AACT,QAAM,WAAW,OAAO,kBAAkB;AAC1C,QAAM,WAAW,OAAO,kBAAkB;AAC1C,QAAM,WAAW,OAAO,mBAAmB;AAE3C,MAAI,QAAQ,SAAS,SAAU,QAAO;AAEtC,QAAM,YAAY,QAAQ,MAAM,KAAK,EAAE,OAAO,OAAO,EAAE;AACvD,MAAI,YAAY,SAAU,QAAO;AAEjC,MAAI,mBAAmB,KAAK,OAAO,EAAG,QAAO;AAC7C,MAAI,YAAY,KAAK,OAAO,EAAG,QAAO;AAEtC,QAAM,gBAAgB,QAAQ,MAAM,KAAK,KAAK,CAAC,GAAG;AAClD,MAAI,eAAe,EAAG,QAAO;AAE7B,QAAM,QAAQ,QAAQ,YAAY;AAClC,MAAI,SAAS,KAAK,CAAC,OAAO,MAAM,SAAS,EAAE,CAAC,EAAG,QAAO;AAEtD,MAAI,OAAO,eAAe,KAAK,CAAC,OAAO,GAAG,KAAK,OAAO,CAAC,EAAG,QAAO;AAEjE,SAAO;AACT;AAEO,SAAS,iBACd,QACiB;AACjB,SAAO;AAAA,IACL,aAAa,OAAO;AAAA,IACpB,MAAM,SAAqC;AACzC,aAAO,gBAAgB,SAAS,MAAM,IAAI,OAAO,eAAe;AAAA,IAClE;AAAA,EACF;AACF;",
+  "names": []
+}