octoflow-core 1.0.0

package/dist/config/server-config.d.ts

@@ -0,0 +1,66 @@
+import type { OctoFlowAgentCardVisibility } from './config.js';
+import type { ResolvedOctoFlowConfig } from './config.js';
+export interface OctoFlowServerAuthConfig {
+    bearerTokens?: string[];
+    headerName?: string;
+    mode?: 'none' | 'bearer' | 'mtls';
+}
+export interface OctoFlowServerTlsConfig {
+    caPath?: string;
+    certPath?: string;
+    keyPath?: string;
+    passphrase?: string;
+    rejectUnauthorized?: boolean;
+    requestCert?: boolean;
+}
+export interface OctoFlowServerRateLimitConfig {
+    enabled?: boolean;
+    ipv6SubnetBits?: number;
+    maxConcurrent?: number;
+    maxRequests?: number;
+    windowMs?: number;
+}
+export interface OctoFlowServerConfig {
+    a2aVersion?: string;
+    agentCardVisibility?: OctoFlowAgentCardVisibility;
+    auth?: OctoFlowServerAuthConfig;
+    baseUrl?: string;
+    cacheControl?: string;
+    host?: string;
+    /** Maximum request body size in bytes. Default: 1048576 (1 MB). */
+    maxBodyBytes?: number;
+    port?: number;
+    rateLimit?: OctoFlowServerRateLimitConfig;
+    tls?: OctoFlowServerTlsConfig;
+}
+export interface ResolvedOctoFlowServerConfig {
+    a2aVersion: string;
+    agentCardVisibility: OctoFlowAgentCardVisibility;
+    auth: {
+        bearerTokens: string[];
+        headerName: string;
+        mode: 'none' | 'bearer' | 'mtls';
+    };
+    baseUrl?: string;
+    cacheControl: string;
+    host: string;
+    maxBodyBytes: number;
+    port: number;
+    rateLimit: {
+        enabled: boolean;
+        ipv6SubnetBits: number;
+        maxConcurrent: number | null;
+        maxRequests: number;
+        windowMs: number;
+    };
+    tls?: {
+        caPath?: string;
+        certPath?: string;
+        keyPath?: string;
+        passphrase?: string;
+        rejectUnauthorized: boolean;
+        requestCert: boolean;
+    };
+}
+export declare function resolveServerConfig(config?: ResolvedOctoFlowConfig): ResolvedOctoFlowServerConfig;
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,6BAA6B,CAAC;IAC1C,GAAG,CAAC,EAAE,uBAAuB,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,2BAA2B,CAAC;IACjD,IAAI,EAAE;QACJ,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;KAClC,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,sBAAwC,GAC/C,4BAA4B,CAE9B"}

package/dist/config/server-config.js

@@ -0,0 +1,9 @@
+import { cloneValue } from "../utils/clone.js";
+import { resolveConfig } from "./config.js";
+function resolveServerConfig(config = resolveConfig()) {
+  return cloneValue(config.server);
+}
+export {
+  resolveServerConfig
+};
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/config/server-config.ts"],
+  "sourcesContent": ["import { cloneValue } from '../utils/clone.js';\nimport type { OctoFlowAgentCardVisibility } from './config.js';\nimport type { ResolvedOctoFlowConfig } from './config.js';\nimport { resolveConfig } from './config.js';\n\nexport interface OctoFlowServerAuthConfig {\n  bearerTokens?: string[];\n  headerName?: string;\n  mode?: 'none' | 'bearer' | 'mtls';\n}\n\nexport interface OctoFlowServerTlsConfig {\n  caPath?: string;\n  certPath?: string;\n  keyPath?: string;\n  passphrase?: string;\n  rejectUnauthorized?: boolean;\n  requestCert?: boolean;\n}\n\nexport interface OctoFlowServerRateLimitConfig {\n  enabled?: boolean;\n  ipv6SubnetBits?: number;\n  maxConcurrent?: number;\n  maxRequests?: number;\n  windowMs?: number;\n}\n\nexport interface OctoFlowServerConfig {\n  a2aVersion?: string;\n  agentCardVisibility?: OctoFlowAgentCardVisibility;\n  auth?: OctoFlowServerAuthConfig;\n  baseUrl?: string;\n  cacheControl?: string;\n  host?: string;\n  /** Maximum request body size in bytes. Default: 1048576 (1 MB). */\n  maxBodyBytes?: number;\n  port?: number;\n  rateLimit?: OctoFlowServerRateLimitConfig;\n  tls?: OctoFlowServerTlsConfig;\n}\n\nexport interface ResolvedOctoFlowServerConfig {\n  a2aVersion: string;\n  agentCardVisibility: OctoFlowAgentCardVisibility;\n  auth: {\n    bearerTokens: string[];\n    headerName: string;\n    mode: 'none' | 'bearer' | 'mtls';\n  };\n  baseUrl?: string;\n  cacheControl: string;\n  host: string;\n  maxBodyBytes: number;\n  port: number;\n  rateLimit: {\n    enabled: boolean;\n    ipv6SubnetBits: number;\n    maxConcurrent: number | null;\n    maxRequests: number;\n    windowMs: number;\n  };\n  tls?: {\n    caPath?: string;\n    certPath?: string;\n    keyPath?: string;\n    passphrase?: string;\n    rejectUnauthorized: boolean;\n    requestCert: boolean;\n  };\n}\n\nexport function resolveServerConfig(\n  config: ResolvedOctoFlowConfig = resolveConfig()\n): ResolvedOctoFlowServerConfig {\n  return cloneValue(config.server);\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAG3B,SAAS,qBAAqB;AAqEvB,SAAS,oBACd,SAAiC,cAAc,GACjB;AAC9B,SAAO,WAAW,OAAO,MAAM;AACjC;",
+  "names": []
+}

package/dist/config/tools.d.ts

@@ -0,0 +1,3 @@
+export declare const TOOL_ICONS: Record<string, string>;
+export declare function getToolIcon(name: string, extraIcons?: Record<string, string>): string;
+//# sourceMappingURL=tools.d.ts.map

package/dist/config/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/config/tools.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW7C,CAAC;AAEF,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,CAQR"}

package/dist/config/tools.js

@@ -0,0 +1,26 @@
+const TOOL_ICONS = {
+  Bash: "\u{1F4BB}",
+  Read: "\u{1F4D6}",
+  Edit: "\u270F\uFE0F",
+  Write: "\u{1F4DD}",
+  Grep: "\u{1F50D}",
+  Glob: "\u{1F4C2}",
+  WebFetch: "\u{1F310}",
+  WebSearch: "\u{1F310}",
+  Skill: "\u26A1",
+  Task: "\u{1F500}"
+};
+function getToolIcon(name, extraIcons) {
+  const allIcons = extraIcons ? { ...TOOL_ICONS, ...extraIcons } : TOOL_ICONS;
+  if (allIcons[name]) return allIcons[name];
+  for (const [key, icon] of Object.entries(allIcons)) {
+    if (name.toLowerCase().includes(key.toLowerCase())) return icon;
+  }
+  if (name.startsWith("mcp__")) return "\u{1F50C}";
+  return "\u{1F527}";
+}
+export {
+  TOOL_ICONS,
+  getToolIcon
+};
+//# sourceMappingURL=tools.js.map

package/dist/config/tools.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/config/tools.ts"],
+  "sourcesContent": ["export const TOOL_ICONS: Record<string, string> = {\n  Bash: '\uD83D\uDCBB',\n  Read: '\uD83D\uDCD6',\n  Edit: '\u270F\uFE0F',\n  Write: '\uD83D\uDCDD',\n  Grep: '\uD83D\uDD0D',\n  Glob: '\uD83D\uDCC2',\n  WebFetch: '\uD83C\uDF10',\n  WebSearch: '\uD83C\uDF10',\n  Skill: '\u26A1',\n  Task: '\uD83D\uDD00',\n};\n\nexport function getToolIcon(\n  name: string,\n  extraIcons?: Record<string, string>\n): string {\n  const allIcons = extraIcons ? { ...TOOL_ICONS, ...extraIcons } : TOOL_ICONS;\n  if (allIcons[name]) return allIcons[name];\n  for (const [key, icon] of Object.entries(allIcons)) {\n    if (name.toLowerCase().includes(key.toLowerCase())) return icon;\n  }\n  if (name.startsWith('mcp__')) return '\uD83D\uDD0C';\n  return '\uD83D\uDD27';\n}\n"],
+  "mappings": "AAAO,MAAM,aAAqC;AAAA,EAChD,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,UAAU;AAAA,EACV,WAAW;AAAA,EACX,OAAO;AAAA,EACP,MAAM;AACR;AAEO,SAAS,YACd,MACA,YACQ;AACR,QAAM,WAAW,aAAa,EAAE,GAAG,YAAY,GAAG,WAAW,IAAI;AACjE,MAAI,SAAS,IAAI,EAAG,QAAO,SAAS,IAAI;AACxC,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,QAAQ,GAAG;AAClD,QAAI,KAAK,YAAY,EAAE,SAAS,IAAI,YAAY,CAAC,EAAG,QAAO;AAAA,EAC7D;AACA,MAAI,KAAK,WAAW,OAAO,EAAG,QAAO;AACrC,SAAO;AACT;",
+  "names": []
+}

package/dist/domain/acp-elicitation.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ACP elicitation domain types — the callback shapes shared between
+ * `BridgeOptions.onAcpElicitation`, `AgentClientOptions.onAcpElicitation`,
+ * and the `acp-cli` backend adapter.
+ *
+ * Defined here in `domain/` so the strict layer rule (domain must not import
+ * from adapters) is respected everywhere.
+ */
+/** A single field in an ACP elicitation form. */
+export type AcpElicitationField = {
+    key: string;
+    type: 'string' | 'number' | 'integer' | 'boolean' | 'array';
+    title?: string;
+    description?: string;
+    required: boolean;
+    options?: string[];
+    multiOptions?: string[];
+};
+/**
+ * Parsed elicitation request dispatched to `onAcpElicitation`.
+ *
+ * - `mode: 'form'` — agent wants structured input from the user.
+ * - `mode: 'url'`  — agent wants the user to visit a URL (e.g. OAuth).
+ */
+export type AcpElicitationRequest = {
+    mode: 'form';
+    sessionId?: string;
+    title?: string;
+    description?: string;
+    message: string;
+    fields: AcpElicitationField[];
+} | {
+    mode: 'url';
+    sessionId?: string;
+    url: string;
+    elicitationId: string;
+    message: string;
+};
+/**
+ * Response returned by `onAcpElicitation` to forward to the agent.
+ *
+ * - `accept`  — user completed the form / finished the OAuth flow.
+ * - `decline` — user explicitly refused.
+ * - `cancel`  — default when no callback is registered.
+ */
+export type AcpElicitationResponse = {
+    action: 'accept';
+    values?: Record<string, string | number | boolean | string[]>;
+} | {
+    action: 'decline';
+} | {
+    action: 'cancel';
+};
+//# sourceMappingURL=acp-elicitation.d.ts.map

package/dist/domain/acp-elicitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-elicitation.d.ts","sourceRoot":"","sources":["../../src/domain/acp-elicitation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iDAAiD;AACjD,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IACE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;CAAE,GACnF;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC"}

package/dist/domain/acp-elicitation.js

@@ -0,0 +1 @@
+//# sourceMappingURL=acp-elicitation.js.map

package/dist/domain/acp-elicitation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/domain/agent-event.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedEvent } from './contracts/messages.js';
+/** A single streaming event from the agent. Extends ParsedEvent with tool args. */
+export interface AgentEvent extends ParsedEvent {
+    /** Tool call arguments. Present on `tool` events when the backend provides them. */
+    args?: Record<string, unknown>;
+}
+export type StreamCallback = (event: AgentEvent) => void | Promise<void>;
+//# sourceMappingURL=agent-event.d.ts.map

package/dist/domain/agent-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-event.d.ts","sourceRoot":"","sources":["../../src/domain/agent-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,mFAAmF;AACnF,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/domain/agent-event.js

@@ -0,0 +1 @@
+//# sourceMappingURL=agent-event.js.map

package/dist/domain/agent-event.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/domain/agent-registry.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Pure-data types for the agent registry (definitions, lineage, tree).
+ *
+ * Behaviour (createRootLineage, forkLineage, AgentRegistry implementations)
+ * lives in `adapters/agents/registry/` — this file stays type-only so any
+ * layer can import it without pulling the registry runtime.
+ */
+import type { EffortLevel } from './contracts/backends.js';
+export type AgentDefinitionSource = 'built-in' | 'project' | 'user';
+export type AgentIsolationStrategy = 'none' | 'context' | 'git-branch' | 'process';
+export type RegistryMemoryScope = 'user' | 'project' | 'local';
+export type AgentNodeStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Per-agent approval policy. Mirrors the shape of bridge-level approval
+ * configuration so callers can surface the field without inventing a new
+ * wire format.
+ *
+ * - `always`: every tool call requires approval.
+ * - `never`: no tool call requires approval.
+ * - `tools`: only the named tools require approval.
+ */
+export type AgentApprovalMode = 'always' | 'never' | 'tools';
+export interface AgentApprovalPolicy {
+    mode: AgentApprovalMode;
+    /** Tool names that require approval when `mode === 'tools'`. Ignored otherwise. */
+    tools?: readonly string[];
+}
+export interface AgentDefinition {
+    role: string;
+    whenToUse: string;
+    getSystemPrompt: () => string;
+    /** Tool whitelist. `'*'` means all tools. */
+    tools: string[] | '*';
+    disallowedTools?: string[];
+    source: AgentDefinitionSource;
+    model?: string;
+    effort?: EffortLevel;
+    maxTurns?: number;
+    /** Reserved for future agent coordination. Not yet consumed by any runtime code. */
+    background?: boolean;
+    memory?: RegistryMemoryScope;
+    isolation?: AgentIsolationStrategy;
+    permissionMode?: string;
+    color?: string;
+    /**
+     * Backend-id priority list overriding the bridge default for this agent.
+     * Consumed by callers that opt in (the registry surfaces the value;
+     * runtime wiring is up to the consumer).
+     */
+    backendPriority?: readonly string[];
+    /**
+     * Skill names this agent expects bound at run-time. Skills themselves
+     * remain loaded by `discoverLocalSkills`/`SkillRegistry`; this field is
+     * the bridge between the named-agent definition and the skill catalog.
+     */
+    skills?: readonly string[];
+    /** Per-agent HITL approval policy. Surfaced for callers that route per agent. */
+    approvals?: AgentApprovalPolicy;
+}
+export interface AgentLineage {
+    agentId: string;
+    agentName: string;
+    parentAgentId?: string;
+    parentSessionId?: string;
+    parentContextId?: string;
+    parentTaskId?: string;
+    rootAgentId?: string;
+    depth: number;
+    spawnedAt: string;
+    isolation?: AgentIsolationStrategy;
+}
+export interface AgentTreeNode {
+    lineage: AgentLineage;
+    status: AgentNodeStatus;
+    children: AgentTreeNode[];
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/domain/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/domain/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AACpE,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,SAAS,GACT,YAAY,GACZ,SAAS,CAAC;AACd,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAC/D,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE/E;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,mFAAmF;IACnF,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,iFAAiF;IACjF,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B"}

package/dist/domain/agent-registry.js

@@ -0,0 +1 @@
+//# sourceMappingURL=agent-registry.js.map

package/dist/domain/agent-registry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/domain/backend-runtime.d.ts

@@ -0,0 +1,135 @@
+import type { BackendName } from './core-task.js';
+import type { BackendType, LlmProvider } from './protocol.js';
+export type BackendRuntimeMeta = {
+    backendType: BackendType;
+    llmProvider: LlmProvider;
+    nativeTools: boolean;
+    nativeMcp: boolean;
+    needsWrapper: boolean;
+};
+export declare const BACKEND_RUNTIME_METADATA: {
+    readonly 'claude-code-cli': {
+        readonly backendType: "cli";
+        readonly llmProvider: "anthropic";
+        readonly nativeTools: true;
+        readonly nativeMcp: true;
+        readonly needsWrapper: false;
+    };
+    readonly 'codex-cli': {
+        readonly backendType: "cli";
+        readonly llmProvider: "openai";
+        readonly nativeTools: true;
+        readonly nativeMcp: true;
+        readonly needsWrapper: false;
+    };
+    readonly 'cursor-cli': {
+        readonly backendType: "cli";
+        readonly llmProvider: "cursor";
+        readonly nativeTools: true;
+        readonly nativeMcp: true;
+        readonly needsWrapper: false;
+    };
+    readonly 'gemini-cli': {
+        readonly backendType: "cli";
+        readonly llmProvider: "google";
+        readonly nativeTools: true;
+        readonly nativeMcp: true;
+        readonly needsWrapper: false;
+    };
+    readonly 'gemini-api': {
+        readonly backendType: "api";
+        readonly llmProvider: "google";
+        readonly nativeTools: false;
+        readonly nativeMcp: false;
+        readonly needsWrapper: true;
+    };
+    readonly ollama: {
+        readonly backendType: "local";
+        readonly llmProvider: "ollama";
+        readonly nativeTools: true;
+        readonly nativeMcp: false;
+        readonly needsWrapper: true;
+    };
+    readonly 'openai-api': {
+        readonly backendType: "api";
+        readonly llmProvider: "openai";
+        readonly nativeTools: false;
+        readonly nativeMcp: false;
+        readonly needsWrapper: true;
+    };
+    readonly 'anthropic-api': {
+        readonly backendType: "api";
+        readonly llmProvider: "anthropic";
+        readonly nativeTools: false;
+        readonly nativeMcp: false;
+        readonly needsWrapper: true;
+    };
+    readonly 'vercel-ai:anthropic': {
+        readonly backendType: "sdk";
+        readonly llmProvider: "anthropic";
+        readonly nativeTools: false;
+        readonly nativeMcp: false;
+        readonly needsWrapper: true;
+    };
+    readonly 'vercel-ai:openai': {
+        readonly backendType: "sdk";
+        readonly llmProvider: "openai";
+        readonly nativeTools: false;
+        readonly nativeMcp: false;
+        readonly needsWrapper: true;
+    };
+    readonly 'vercel-ai:google': {
+        readonly backendType: "sdk";
+        readonly llmProvider: "google";
+        readonly nativeTools: false;
+        readonly nativeMcp: false;
+        readonly needsWrapper: true;
+    };
+    readonly custom: {
+        readonly backendType: "cli";
+        readonly llmProvider: "custom";
+        readonly nativeTools: true;
+        readonly nativeMcp: true;
+        readonly needsWrapper: false;
+    };
+    readonly 'custom-api': {
+        readonly backendType: "api";
+        readonly llmProvider: "custom";
+        readonly nativeTools: false;
+        readonly nativeMcp: false;
+        readonly needsWrapper: true;
+    };
+    readonly a2a: {
+        readonly backendType: "api";
+        readonly llmProvider: "custom";
+        readonly nativeTools: false;
+        readonly nativeMcp: false;
+        readonly needsWrapper: false;
+    };
+    readonly 'acp-cli': {
+        readonly backendType: "cli";
+        readonly llmProvider: "custom";
+        readonly nativeTools: true;
+        readonly nativeMcp: false;
+        readonly needsWrapper: false;
+    };
+};
+export declare const LLM_PROVIDER_PRIORITY: {
+    readonly anthropic: readonly ["claude-code-cli", "anthropic-api", "vercel-ai:anthropic"];
+    readonly openai: readonly ["codex-cli", "openai-api", "vercel-ai:openai"];
+    readonly google: readonly ["gemini-cli", "gemini-api", "vercel-ai:google"];
+    readonly ollama: readonly ["ollama"];
+    readonly cursor: readonly ["cursor-cli"];
+    readonly custom: readonly ["custom", "custom-api", "a2a", "acp-cli"];
+};
+export declare function isCliRuntimeBackend(name: BackendName): boolean;
+export declare function isNativeCliRuntimeBackend(name: BackendName): boolean;
+export declare function isAllNativeCliBackends(priority: readonly BackendName[] | undefined): boolean;
+export type PriorityFilterInput = {
+    priority?: readonly BackendName[];
+    llmProvider?: LlmProvider;
+    backendType?: BackendType;
+    order?: readonly BackendName[];
+};
+export declare function resolvePriorityFilters(input: PriorityFilterInput): BackendName[] | undefined;
+//# sourceMappingURL=backend-runtime.d.ts.map

package/dist/domain/backend-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-runtime.d.ts","sourceRoot":"","sources":["../../src/domain/backend-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0GuB,CAAC;AAE7D,eAAO,MAAM,qBAAqB;;;;;;;CAO8B,CAAC;AAEjE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAOpE;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,GAC3C,OAAO,CAGT;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAChC,CAAC;AAiBF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GACzB,WAAW,EAAE,GAAG,SAAS,CAsC3B"}

package/dist/domain/backend-runtime.js

@@ -0,0 +1,175 @@
+import { OctoFlowError } from "./errors/base.js";
+const BACKEND_RUNTIME_METADATA = {
+  "claude-code-cli": {
+    backendType: "cli",
+    llmProvider: "anthropic",
+    nativeTools: true,
+    nativeMcp: true,
+    needsWrapper: false
+  },
+  "codex-cli": {
+    backendType: "cli",
+    llmProvider: "openai",
+    nativeTools: true,
+    nativeMcp: true,
+    needsWrapper: false
+  },
+  "cursor-cli": {
+    backendType: "cli",
+    llmProvider: "cursor",
+    nativeTools: true,
+    nativeMcp: true,
+    needsWrapper: false
+  },
+  "gemini-cli": {
+    backendType: "cli",
+    llmProvider: "google",
+    nativeTools: true,
+    nativeMcp: true,
+    needsWrapper: false
+  },
+  "gemini-api": {
+    backendType: "api",
+    llmProvider: "google",
+    nativeTools: false,
+    nativeMcp: false,
+    needsWrapper: true
+  },
+  ollama: {
+    backendType: "local",
+    llmProvider: "ollama",
+    nativeTools: true,
+    nativeMcp: false,
+    needsWrapper: true
+  },
+  "openai-api": {
+    backendType: "api",
+    llmProvider: "openai",
+    nativeTools: false,
+    nativeMcp: false,
+    needsWrapper: true
+  },
+  "anthropic-api": {
+    backendType: "api",
+    llmProvider: "anthropic",
+    nativeTools: false,
+    nativeMcp: false,
+    needsWrapper: true
+  },
+  "vercel-ai:anthropic": {
+    backendType: "sdk",
+    llmProvider: "anthropic",
+    nativeTools: false,
+    nativeMcp: false,
+    needsWrapper: true
+  },
+  "vercel-ai:openai": {
+    backendType: "sdk",
+    llmProvider: "openai",
+    nativeTools: false,
+    nativeMcp: false,
+    needsWrapper: true
+  },
+  "vercel-ai:google": {
+    backendType: "sdk",
+    llmProvider: "google",
+    nativeTools: false,
+    nativeMcp: false,
+    needsWrapper: true
+  },
+  custom: {
+    backendType: "cli",
+    llmProvider: "custom",
+    nativeTools: true,
+    nativeMcp: true,
+    needsWrapper: false
+  },
+  "custom-api": {
+    backendType: "api",
+    llmProvider: "custom",
+    nativeTools: false,
+    nativeMcp: false,
+    needsWrapper: true
+  },
+  a2a: {
+    backendType: "api",
+    llmProvider: "custom",
+    nativeTools: false,
+    nativeMcp: false,
+    needsWrapper: false
+  },
+  "acp-cli": {
+    backendType: "cli",
+    llmProvider: "custom",
+    nativeTools: true,
+    nativeMcp: false,
+    needsWrapper: false
+  }
+};
+const LLM_PROVIDER_PRIORITY = {
+  anthropic: ["claude-code-cli", "anthropic-api", "vercel-ai:anthropic"],
+  openai: ["codex-cli", "openai-api", "vercel-ai:openai"],
+  google: ["gemini-cli", "gemini-api", "vercel-ai:google"],
+  ollama: ["ollama"],
+  cursor: ["cursor-cli"],
+  custom: ["custom", "custom-api", "a2a", "acp-cli"]
+};
+function isCliRuntimeBackend(name) {
+  return BACKEND_RUNTIME_METADATA[name].backendType === "cli";
+}
+function isNativeCliRuntimeBackend(name) {
+  const meta = BACKEND_RUNTIME_METADATA[name];
+  return meta.backendType === "cli" && meta.nativeTools === true && meta.needsWrapper === false;
+}
+function isAllNativeCliBackends(priority) {
+  if (!priority || priority.length === 0) return false;
+  return priority.every(isNativeCliRuntimeBackend);
+}
+function filterOrder(order) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  const append = (name) => {
+    if (seen.has(name)) return;
+    seen.add(name);
+    result.push(name);
+  };
+  for (const name of order ?? []) append(name);
+  for (const name of Object.keys(BACKEND_RUNTIME_METADATA)) {
+    append(name);
+  }
+  return result;
+}
+function resolvePriorityFilters(input) {
+  if (input.priority) return [...input.priority];
+  if (!input.llmProvider && !input.backendType) return void 0;
+  const ordered = filterOrder(input.order);
+  const providerSet = input.llmProvider ? new Set(LLM_PROVIDER_PRIORITY[input.llmProvider]) : void 0;
+  const backendTypeSet = input.backendType ? new Set(
+    ordered.filter(
+      (name) => BACKEND_RUNTIME_METADATA[name].backendType === input.backendType
+    )
+  ) : void 0;
+  const resolved = providerSet && backendTypeSet ? ordered.filter(
+    (name) => providerSet.has(name) && backendTypeSet.has(name)
+  ) : providerSet ? [...LLM_PROVIDER_PRIORITY[input.llmProvider]] : ordered.filter((name) => backendTypeSet.has(name));
+  if (resolved.length === 0) {
+    throw new OctoFlowError(
+      "NO_BACKEND_FOR_FILTER",
+      "No backend matches the requested llmProvider/backendType filters.",
+      {
+        ...input.llmProvider ? { llmProvider: input.llmProvider } : {},
+        ...input.backendType ? { backendType: input.backendType } : {}
+      }
+    );
+  }
+  return resolved;
+}
+export {
+  BACKEND_RUNTIME_METADATA,
+  LLM_PROVIDER_PRIORITY,
+  isAllNativeCliBackends,
+  isCliRuntimeBackend,
+  isNativeCliRuntimeBackend,
+  resolvePriorityFilters
+};
+//# sourceMappingURL=backend-runtime.js.map