octoflow-core 1.0.0

package/dist/runtime/bridge/agent-handle.js

@@ -0,0 +1,164 @@
+import { OctoFlowError } from "../../domain/errors/index.js";
+import { createWorkflowRegistry } from "./workflow-cleanup.js";
+function bridgeAgentHandle(agentType, bridge, runDefaults = {}) {
+  const handle = {
+    agentType,
+    runtime: bridge,
+    /** @internal Not part of AgentHandle interface — escape hatch for framework internals only. */
+    bridge,
+    events: bridge.events,
+    on: bridge.on,
+    once: bridge.once,
+    off: bridge.off,
+    onAny: bridge.events.onAny.bind(bridge.events),
+    offAny: bridge.events.offAny.bind(bridge.events),
+    registry: bridge.registry,
+    topics: void 0,
+    packId: void 0,
+    getStatus: () => bridge.getStatus(),
+    info: () => bridge.info(),
+    inspect: async () => ({
+      backends: await bridge.inspectBackends(),
+      config: { ...bridge.getConfig(), agentType }
+    }),
+    inspectHarness: () => bridge.inspectHarness(agentType),
+    inspectBackends: () => bridge.inspectBackends(),
+    getConfig: () => ({ ...bridge.getConfig(), agentType }),
+    use: (plugin) => bridge.use(plugin),
+    session: (contextId, options) => bridge.session(contextId, options),
+    resumeSession: (sessionId) => bridge.resumeSession(sessionId),
+    getSessionRecord: (sessionId) => bridge.getSessionRecord(sessionId),
+    listSessions: (options) => bridge.listSessions(options),
+    getAllSessions: (options) => bridge.getAllSessions(options),
+    addWorkflow: (context, schedule) => bridge.addWorkflow(context, schedule),
+    configure: (input) => bridge.configure(input),
+    sendMessage: (params) => bridge.sendMessage(
+      typeof params === "string" ? { message: params } : params
+    ),
+    stream: (params) => bridge.stream(
+      typeof params === "string" ? { message: params } : params
+    ),
+    run: (params) => bridge.run({
+      ...runDefaults,
+      ...typeof params === "string" ? { message: params } : params
+    }),
+    runStream: (params) => bridge.runStream({
+      ...runDefaults,
+      ...typeof params === "string" ? { message: params } : params
+    }),
+    getTask: (taskId, options) => bridge.getTask(taskId, options),
+    listTasks: (options) => bridge.listTasks(options),
+    cancelTask: (taskId, options) => bridge.cancelTask(taskId, options),
+    subscribeToTask: (taskId, options) => bridge.subscribeToTask(taskId, options),
+    getConversation: (contextId, options) => bridge.getConversation(contextId, options),
+    listConversations: (options) => bridge.listConversations(options),
+    getMcpPool: () => bridge.getMcpPool(),
+    getMcpConnection: (name) => bridge.getMcpConnection(name),
+    getLocalContextResult: () => bridge.getLocalContextResult(),
+    listAgentSkills: () => bridge.listAgentSkills(),
+    getAgentSkill: (name) => bridge.getAgentSkill(name),
+    activateAgentSkill: (name) => bridge.activateAgentSkill(name),
+    openAiGateway: async (options) => {
+      const { createOpenAiGatewayServer } = await import("./openai-gateway.js");
+      return createOpenAiGatewayServer({ ...options, agent: handle });
+    },
+    makeGateway: async (options) => {
+      const { createGatewayServer } = await import("./make-gateway.js");
+      return createGatewayServer(handle, options);
+    },
+    close: async () => {
+      await bridge.events.emit("agent:close", { agentType, runtime: "bridge" });
+      await bridge.close();
+    }
+  };
+  return handle;
+}
+function packAgentHandle(agentType, pack) {
+  const workflowRegistry = createWorkflowRegistry({
+    sender: (params) => pack.sendMessage(params)
+  });
+  const handle = {
+    agentType,
+    runtime: pack,
+    /** @internal Not part of AgentHandle interface — escape hatch for framework internals only. */
+    bridge: pack.leader,
+    events: pack.leader.events,
+    on: pack.leader.on,
+    once: pack.leader.once,
+    off: pack.leader.off,
+    onAny: pack.leader.events.onAny.bind(pack.leader.events),
+    offAny: pack.leader.events.offAny.bind(pack.leader.events),
+    registry: pack.leader.registry,
+    topics: pack.topics,
+    packId: pack.getPackId(),
+    getStatus: () => pack.leader.getStatus(),
+    info: () => pack.leader.info(),
+    inspect: async () => ({
+      backends: await pack.leader.inspectBackends(),
+      config: { ...pack.getConfig(), agentType },
+      workers: pack.inspectWorkers()
+    }),
+    inspectHarness: () => pack.leader.inspectHarness(agentType, pack.inspectWorkers(), {
+      ...pack.getConfig(),
+      agentType
+    }),
+    inspectBackends: () => pack.leader.inspectBackends(),
+    getConfig: () => ({ ...pack.getConfig(), agentType }),
+    use: (plugin) => pack.leader.use(plugin),
+    session: (contextId) => pack.session(contextId),
+    resumeSession: (sessionId) => pack.leader.resumeSession(sessionId),
+    getSessionRecord: (sessionId) => pack.leader.getSessionRecord(sessionId),
+    listSessions: (options) => pack.leader.listSessions(options),
+    getAllSessions: (options) => pack.leader.getAllSessions(options),
+    addWorkflow: (context, schedule) => workflowRegistry.add(context, schedule),
+    configure: (_input) => Promise.reject(
+      new OctoFlowError(
+        "AGENT_CONFIG_UNSUPPORTED_RUNTIME",
+        `Agent type "${agentType}" does not support runtime configure yet.`,
+        { agentType }
+      )
+    ),
+    sendMessage: (params) => pack.sendMessage(
+      typeof params === "string" ? { message: params } : params
+    ),
+    stream: (params) => pack.stream(
+      typeof params === "string" ? { message: params } : params
+    ),
+    run: (params) => pack.run(typeof params === "string" ? { message: params } : params),
+    runStream: (params) => pack.runStream(typeof params === "string" ? { message: params } : params),
+    getTask: (taskId, options) => pack.leader.getTask(taskId, options),
+    listTasks: (options) => pack.leader.listTasks(options),
+    cancelTask: (taskId, options) => pack.leader.cancelTask(taskId, options),
+    subscribeToTask: (taskId, options) => pack.leader.subscribeToTask(taskId, options),
+    getConversation: (contextId, options) => pack.leader.getConversation(contextId, options),
+    listConversations: (options) => pack.leader.listConversations(options),
+    getMcpPool: () => pack.leader.getMcpPool(),
+    getMcpConnection: (name) => pack.leader.getMcpConnection(name),
+    getLocalContextResult: () => pack.leader.getLocalContextResult(),
+    listAgentSkills: () => pack.leader.listAgentSkills(),
+    getAgentSkill: (name) => pack.leader.getAgentSkill(name),
+    activateAgentSkill: (name) => pack.leader.activateAgentSkill(name),
+    openAiGateway: async (options) => {
+      const { createOpenAiGatewayServer } = await import("./openai-gateway.js");
+      return createOpenAiGatewayServer({ ...options, agent: handle });
+    },
+    makeGateway: async (options) => {
+      const { createGatewayServer } = await import("./make-gateway.js");
+      return createGatewayServer(handle, options);
+    },
+    close: async () => {
+      await pack.leader.events.emit("agent:close", {
+        agentType,
+        runtime: "pack"
+      });
+      await workflowRegistry.stopAll();
+      await pack.closeAsync();
+    }
+  };
+  return handle;
+}
+export {
+  bridgeAgentHandle,
+  packAgentHandle
+};
+//# sourceMappingURL=agent-handle.js.map

package/dist/runtime/bridge/agent-handle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/agent-handle.ts"],
+  "sourcesContent": ["/**\n * `bridgeAgentHandle` and `packAgentHandle` \u2014 factory functions that wrap a\n * `Bridge` or `Pack` instance into the unified {@link AgentHandle} interface.\n *\n * The public contract lives in {@link ./agent-handle-types.ts}.\n */\nimport { OctoFlowError } from '../../domain/errors/index.js';\nimport type { Pack } from '../orchestration/pack.js';\nimport type { BridgeRunParams } from '../orchestration/run/types.js';\nimport type {\n  AgentHandle,\n  AgentRunParams,\n  AgentSendParams,\n  AgentSession,\n  AgentStreamEvent,\n  BridgeBackedAgentType,\n  PackBackedAgentType,\n} from './agent-handle-types.js';\nimport type { Bridge } from './bridge.js';\nimport type { AgentConfigureResult } from './configure.js';\nimport type { BridgePlugin } from './plugins.js';\nimport type { TopicChannel } from './topic-channel.js';\nimport { createWorkflowRegistry } from './workflow-cleanup.js';\n\nexport type {\n  AgentHandle,\n  AgentHarnessActionInspection,\n  AgentHarnessActionSource,\n  AgentHarnessBackendConformanceInspection,\n  AgentHarnessBackendFeatureInspection,\n  AgentHarnessBrainInspection,\n  AgentHarnessCapabilityDefinition,\n  AgentHarnessCapabilityId,\n  AgentHarnessCapabilityInspection,\n  AgentHarnessCapabilityStatus,\n  AgentHarnessConformanceInspection,\n  AgentHarnessFeatureDefinition,\n  AgentHarnessFeatureId,\n  AgentHarnessInspection,\n  AgentHarnessMcpInspection,\n  AgentHarnessMcpToolInspection,\n  AgentHarnessPluginInspection,\n  AgentHarnessSkillInspection,\n  AgentInfo,\n  AgentInspection,\n  AgentRunParams,\n  AgentRuntimeConfigSnapshot,\n  AgentSendParams,\n  AgentSendResult,\n  AgentSession,\n  AgentStreamEvent,\n  BridgeBackedAgentType,\n  PackBackedAgentType,\n} from './agent-handle-types.js';\n\nexport function bridgeAgentHandle<T extends BridgeBackedAgentType>(\n  agentType: T,\n  bridge: Bridge,\n  runDefaults: Partial<BridgeRunParams> = {}\n): AgentHandle<T> {\n  const handle: AgentHandle<T> & { readonly bridge: Bridge } = {\n    agentType,\n    runtime: bridge,\n    /** @internal Not part of AgentHandle interface \u2014 escape hatch for framework internals only. */\n    bridge,\n    events: bridge.events,\n    on: bridge.on,\n    once: bridge.once,\n    off: bridge.off,\n    onAny: bridge.events.onAny.bind(bridge.events),\n    offAny: bridge.events.offAny.bind(bridge.events),\n    registry: bridge.registry,\n    topics: undefined as T extends PackBackedAgentType\n      ? TopicChannel\n      : undefined,\n    packId: undefined as T extends PackBackedAgentType ? string : undefined,\n    getStatus: () => bridge.getStatus(),\n    info: () => bridge.info(),\n    inspect: async () => ({\n      backends: await bridge.inspectBackends(),\n      config: { ...bridge.getConfig(), agentType },\n    }),\n    inspectHarness: () => bridge.inspectHarness(agentType),\n    inspectBackends: () => bridge.inspectBackends(),\n    getConfig: () => ({ ...bridge.getConfig(), agentType }),\n    use: (plugin: BridgePlugin) => bridge.use(plugin),\n    session: (contextId, options) =>\n      bridge.session(contextId, options) as AgentSession<T>,\n    resumeSession: (sessionId) => bridge.resumeSession(sessionId),\n    getSessionRecord: (sessionId) => bridge.getSessionRecord(sessionId),\n    listSessions: (options) => bridge.listSessions(options),\n    getAllSessions: (options) => bridge.getAllSessions(options),\n    addWorkflow: (context, schedule) => bridge.addWorkflow(context, schedule),\n    configure: (input): Promise<AgentConfigureResult> =>\n      bridge.configure(input),\n    sendMessage: (params: AgentSendParams<T> | string) =>\n      bridge.sendMessage(\n        typeof params === 'string' ? { message: params } : params\n      ),\n    stream: (params: AgentSendParams<T> | string) =>\n      bridge.stream(\n        typeof params === 'string' ? { message: params } : params\n      ) as AsyncGenerator<AgentStreamEvent<T>>,\n    run: (params: AgentRunParams<T> | string) =>\n      bridge.run({\n        ...runDefaults,\n        ...(typeof params === 'string' ? { message: params } : params),\n      }),\n    runStream: (params: AgentRunParams<T> | string) =>\n      bridge.runStream({\n        ...runDefaults,\n        ...(typeof params === 'string' ? { message: params } : params),\n      }),\n    getTask: (taskId, options) => bridge.getTask(taskId, options),\n    listTasks: (options) => bridge.listTasks(options),\n    cancelTask: (taskId, options) => bridge.cancelTask(taskId, options),\n    subscribeToTask: (taskId, options) =>\n      bridge.subscribeToTask(taskId, options),\n    getConversation: (contextId, options) =>\n      bridge.getConversation(contextId, options),\n    listConversations: (options) => bridge.listConversations(options),\n    getMcpPool: () => bridge.getMcpPool(),\n    getMcpConnection: (name) => bridge.getMcpConnection(name),\n    getLocalContextResult: () => bridge.getLocalContextResult(),\n    listAgentSkills: () => bridge.listAgentSkills(),\n    getAgentSkill: (name) => bridge.getAgentSkill(name),\n    activateAgentSkill: (name) => bridge.activateAgentSkill(name),\n    openAiGateway: async (options) => {\n      const { createOpenAiGatewayServer } = await import('./openai-gateway.js');\n      return createOpenAiGatewayServer({ ...options, agent: handle });\n    },\n    makeGateway: async (options) => {\n      const { createGatewayServer } = await import('./make-gateway.js');\n      return createGatewayServer(handle, options);\n    },\n    close: async () => {\n      await bridge.events.emit('agent:close', { agentType, runtime: 'bridge' });\n      await bridge.close();\n    },\n  };\n  return handle;\n}\n\nexport function packAgentHandle<T extends PackBackedAgentType>(\n  agentType: T,\n  pack: Pack\n): AgentHandle<T> {\n  const workflowRegistry = createWorkflowRegistry({\n    sender: (params) => pack.sendMessage(params),\n  });\n\n  const handle: AgentHandle<T> & { readonly bridge: Bridge } = {\n    agentType,\n    runtime: pack,\n    /** @internal Not part of AgentHandle interface \u2014 escape hatch for framework internals only. */\n    bridge: pack.leader,\n    events: pack.leader.events,\n    on: pack.leader.on,\n    once: pack.leader.once,\n    off: pack.leader.off,\n    onAny: pack.leader.events.onAny.bind(pack.leader.events),\n    offAny: pack.leader.events.offAny.bind(pack.leader.events),\n    registry: pack.leader.registry,\n    topics: pack.topics as T extends PackBackedAgentType\n      ? TopicChannel\n      : undefined,\n    packId: pack.getPackId() as T extends PackBackedAgentType\n      ? string\n      : undefined,\n    getStatus: () => pack.leader.getStatus(),\n    info: () => pack.leader.info(),\n    inspect: async () => ({\n      backends: await pack.leader.inspectBackends(),\n      config: { ...pack.getConfig(), agentType },\n      workers: pack.inspectWorkers(),\n    }),\n    inspectHarness: () =>\n      pack.leader.inspectHarness(agentType, pack.inspectWorkers(), {\n        ...pack.getConfig(),\n        agentType,\n      }),\n    inspectBackends: () => pack.leader.inspectBackends(),\n    getConfig: () => ({ ...pack.getConfig(), agentType }),\n    use: (plugin: BridgePlugin) => pack.leader.use(plugin),\n    session: (contextId) => pack.session(contextId) as AgentSession<T>,\n    resumeSession: (sessionId) => pack.leader.resumeSession(sessionId),\n    getSessionRecord: (sessionId) => pack.leader.getSessionRecord(sessionId),\n    listSessions: (options) => pack.leader.listSessions(options),\n    getAllSessions: (options) => pack.leader.getAllSessions(options),\n    addWorkflow: (context, schedule) => workflowRegistry.add(context, schedule),\n    configure: (_input: never): Promise<AgentConfigureResult> =>\n      Promise.reject(\n        new OctoFlowError(\n          'AGENT_CONFIG_UNSUPPORTED_RUNTIME',\n          `Agent type \"${agentType}\" does not support runtime configure yet.`,\n          { agentType }\n        )\n      ),\n    sendMessage: (params: AgentSendParams<T> | string) =>\n      pack.sendMessage(\n        typeof params === 'string' ? { message: params } : params\n      ),\n    stream: (params: AgentSendParams<T> | string) =>\n      pack.stream(\n        typeof params === 'string' ? { message: params } : params\n      ) as AsyncGenerator<AgentStreamEvent<T>>,\n    run: (params: AgentRunParams<T> | string) =>\n      pack.run(typeof params === 'string' ? { message: params } : params),\n    runStream: (params: AgentRunParams<T> | string) =>\n      pack.runStream(typeof params === 'string' ? { message: params } : params),\n    getTask: (taskId, options) => pack.leader.getTask(taskId, options),\n    listTasks: (options) => pack.leader.listTasks(options),\n    cancelTask: (taskId, options) => pack.leader.cancelTask(taskId, options),\n    subscribeToTask: (taskId, options) =>\n      pack.leader.subscribeToTask(taskId, options),\n    getConversation: (contextId, options) =>\n      pack.leader.getConversation(contextId, options),\n    listConversations: (options) => pack.leader.listConversations(options),\n    getMcpPool: () => pack.leader.getMcpPool(),\n    getMcpConnection: (name) => pack.leader.getMcpConnection(name),\n    getLocalContextResult: () => pack.leader.getLocalContextResult(),\n    listAgentSkills: () => pack.leader.listAgentSkills(),\n    getAgentSkill: (name) => pack.leader.getAgentSkill(name),\n    activateAgentSkill: (name) => pack.leader.activateAgentSkill(name),\n    openAiGateway: async (options) => {\n      const { createOpenAiGatewayServer } = await import('./openai-gateway.js');\n      return createOpenAiGatewayServer({ ...options, agent: handle });\n    },\n    makeGateway: async (options) => {\n      const { createGatewayServer } = await import('./make-gateway.js');\n      return createGatewayServer(handle, options);\n    },\n    close: async () => {\n      await pack.leader.events.emit('agent:close', {\n        agentType,\n        runtime: 'pack',\n      });\n      await workflowRegistry.stopAll();\n      await pack.closeAsync();\n    },\n  };\n  return handle;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/agent-info-types.d.ts

@@ -0,0 +1,87 @@
+import type { AgentSkillMetadata } from '../../capabilities/skills/types.js';
+import type { BackendInspection } from '../../domain/bridge-api.js';
+import type { BackendInfo } from '../../domain/protocol.js';
+import type { PackRuntimeConfigSnapshot, WorkerInspection } from '../orchestration/pack.js';
+import type { AgentType } from './agent-routes.js';
+import type { BridgeRuntimeConfigSnapshot } from './bridge.js';
+import type { AgentHarnessCapabilityInspection } from './harness-capabilities.js';
+import type { AgentHarnessConformanceInspection } from './harness-conformance.js';
+export type { AgentHarnessBackendConformanceInspection, AgentHarnessBackendFeatureInspection, AgentHarnessConformanceInspection, AgentHarnessFeatureDefinition, AgentHarnessFeatureId, } from './harness-conformance.js';
+export interface AgentInfo {
+    selected: BackendInfo | null;
+    candidates: BackendInfo[];
+}
+export type AgentRuntimeConfigSnapshot<T extends AgentType = AgentType> = (BridgeRuntimeConfigSnapshot & {
+    agentType: T;
+}) | (PackRuntimeConfigSnapshot & {
+    agentType: T;
+});
+export interface AgentInspection {
+    backends: BackendInspection[];
+    config: AgentRuntimeConfigSnapshot;
+    workers?: WorkerInspection[];
+}
+export type AgentHarnessActionSource = {
+    type: 'function';
+} | {
+    type: 'cli';
+} | {
+    server: string;
+    tool: string;
+    type: 'mcp';
+};
+export interface AgentHarnessActionInspection {
+    name: string;
+    description: string;
+    permission?: 'allow' | 'deny' | 'ask';
+    requireApproval?: boolean;
+    source: AgentHarnessActionSource;
+    tags: readonly string[];
+}
+export interface AgentHarnessSkillInspection {
+    actions: readonly string[];
+    description?: string;
+    name: string;
+    tags: readonly string[];
+    version?: string;
+}
+export interface AgentHarnessPluginInspection {
+    actions: readonly string[];
+    after: readonly string[];
+    before: readonly string[];
+    enabled: boolean;
+    events: readonly string[];
+    hasMiddleware: boolean;
+    mcpServers: readonly string[];
+    name: string;
+    priority: number;
+    skills: readonly string[];
+    version?: string;
+}
+export interface AgentHarnessMcpToolInspection {
+    description: string;
+    name: string;
+    originalName?: string;
+    serverName?: string;
+}
+export interface AgentHarnessMcpInspection {
+    configuredServers: readonly string[];
+    connectedServers: readonly string[];
+    tools: readonly AgentHarnessMcpToolInspection[];
+}
+export interface AgentHarnessBrainInspection {
+    contractVersion?: string;
+    enabled: boolean;
+}
+export interface AgentHarnessInspection extends AgentInspection {
+    actions: readonly AgentHarnessActionInspection[];
+    agentSkills: readonly AgentSkillMetadata[];
+    brain: AgentHarnessBrainInspection;
+    capabilities: readonly AgentHarnessCapabilityInspection[];
+    conformance: AgentHarnessConformanceInspection;
+    mcp: AgentHarnessMcpInspection;
+    plugins: readonly AgentHarnessPluginInspection[];
+    runtime: 'bridge' | 'pack';
+    skills: readonly AgentHarnessSkillInspection[];
+}
+//# sourceMappingURL=agent-info-types.d.ts.map

package/dist/runtime/bridge/agent-info-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-info-types.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/agent-info-types.ts"],"names":[],"mappings":"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"}

package/dist/runtime/bridge/agent-info-types.js

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

package/dist/runtime/bridge/agent-info-types.js.map

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

package/dist/runtime/bridge/agent-presets.d.ts

@@ -0,0 +1,16 @@
+import type { PackWorkerConfig } from '../orchestration/pack.js';
+import type { AgentHandle } from './agent-handle-types.js';
+import type { CreateAgentOptions } from './agent-route-types.js';
+export type CreateCodingAgentOptions = CreateAgentOptions<'tool-loop'>;
+export type CreateSupportAgentOptions = CreateAgentOptions<'tool-loop'>;
+export type CreateResearchAgentOptions = CreateAgentOptions<'tool-loop'>;
+export type CreateSecureToolAgentOptions = CreateAgentOptions<'tool-loop'>;
+export type CreateSupervisorTeamOptions = Omit<CreateAgentOptions<'supervisor'>, 'agentType' | 'workers'> & {
+    workers?: PackWorkerConfig[];
+};
+export declare function createCodingAgent(options?: CreateCodingAgentOptions): Promise<AgentHandle<'tool-loop'>>;
+export declare function createSupportAgent(options?: CreateSupportAgentOptions): Promise<AgentHandle<'tool-loop'>>;
+export declare function createResearchAgent(options?: CreateResearchAgentOptions): Promise<AgentHandle<'tool-loop'>>;
+export declare function createSecureToolAgent(options?: CreateSecureToolAgentOptions): Promise<AgentHandle<'tool-loop'>>;
+export declare function createSupervisorTeam(options?: CreateSupervisorTeamOptions): Promise<AgentHandle<'supervisor'>>;
+//# sourceMappingURL=agent-presets.d.ts.map

package/dist/runtime/bridge/agent-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-presets.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/agent-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;AACvE,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;AACxE,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;AACzE,MAAM,MAAM,4BAA4B,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;AAE3E,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,kBAAkB,CAAC,YAAY,CAAC,EAChC,WAAW,GAAG,SAAS,CACxB,GAAG;IACF,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAQnC;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAQnC;AAED,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAQnC;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAUnC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAwBpC"}

package/dist/runtime/bridge/agent-presets.js

@@ -0,0 +1,79 @@
+import { createAgent } from "./create-agent.js";
+function createCodingAgent(options = {}) {
+  return createAgent({
+    ...options,
+    agentType: "tool-loop",
+    systemPrompt: options.systemPrompt ?? "You are a pragmatic coding agent. Prefer small diffs, cite files, run relevant checks, and explain tradeoffs briefly."
+  });
+}
+function createSupportAgent(options = {}) {
+  return createAgent({
+    ...options,
+    agentType: "tool-loop",
+    systemPrompt: options.systemPrompt ?? "You are a support agent. Diagnose the user issue, ask only necessary clarifying questions, use tools for account or product facts, and end with clear next steps."
+  });
+}
+function createResearchAgent(options = {}) {
+  return createAgent({
+    ...options,
+    agentType: "tool-loop",
+    systemPrompt: options.systemPrompt ?? "You are a research agent. Separate evidence from inference, cite sources or file paths, compare alternatives, and call out uncertainty."
+  });
+}
+function createSecureToolAgent(options = {}) {
+  return createAgent({
+    ...options,
+    agentType: "tool-loop",
+    permission: options.permission ?? "ask",
+    profile: options.profile ?? "local-sandboxed",
+    systemPrompt: options.systemPrompt ?? "You are a cautious tool-using agent. Prefer read-only inspection first, request approval before writes or shell actions, and keep secrets out of prompts and logs."
+  });
+}
+function createSupervisorTeam(options = {}) {
+  const {
+    leader,
+    shared,
+    workers = defaultSupervisorWorkers(),
+    ...rest
+  } = options;
+  return createAgent({
+    ...rest,
+    agentType: "supervisor",
+    leader: {
+      systemPrompt: "You coordinate specialists. Delegate only when parallel expertise helps, then synthesize a concise final answer.",
+      ...leader
+    },
+    shared: {
+      protocol: [
+        "Use worker results as evidence.",
+        "Keep delegation tasks specific and bounded."
+      ],
+      ...shared
+    },
+    workers
+  });
+}
+function defaultSupervisorWorkers() {
+  return [
+    {
+      name: "researcher",
+      description: "Finds evidence, compares options, and cites sources.",
+      systemPrompt: "You are the research worker. Gather evidence, cite concrete sources or paths, and distinguish facts from judgment.",
+      tags: ["research"]
+    },
+    {
+      name: "implementer",
+      description: "Plans implementation steps and checks risks.",
+      systemPrompt: "You are the implementation worker. Propose practical steps, identify risks, and prefer small reversible changes.",
+      tags: ["implementation"]
+    }
+  ];
+}
+export {
+  createCodingAgent,
+  createResearchAgent,
+  createSecureToolAgent,
+  createSupervisorTeam,
+  createSupportAgent
+};
+//# sourceMappingURL=agent-presets.js.map

package/dist/runtime/bridge/agent-presets.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/agent-presets.ts"],
+  "sourcesContent": ["import type { PackWorkerConfig } from '../orchestration/pack.js';\nimport type { AgentHandle } from './agent-handle-types.js';\nimport type { CreateAgentOptions } from './agent-route-types.js';\nimport { createAgent } from './create-agent.js';\n\nexport type CreateCodingAgentOptions = CreateAgentOptions<'tool-loop'>;\nexport type CreateSupportAgentOptions = CreateAgentOptions<'tool-loop'>;\nexport type CreateResearchAgentOptions = CreateAgentOptions<'tool-loop'>;\nexport type CreateSecureToolAgentOptions = CreateAgentOptions<'tool-loop'>;\n\nexport type CreateSupervisorTeamOptions = Omit<\n  CreateAgentOptions<'supervisor'>,\n  'agentType' | 'workers'\n> & {\n  workers?: PackWorkerConfig[];\n};\n\nexport function createCodingAgent(\n  options: CreateCodingAgentOptions = {}\n): Promise<AgentHandle<'tool-loop'>> {\n  return createAgent({\n    ...options,\n    agentType: 'tool-loop',\n    systemPrompt:\n      options.systemPrompt ??\n      'You are a pragmatic coding agent. Prefer small diffs, cite files, run relevant checks, and explain tradeoffs briefly.',\n  });\n}\n\nexport function createSupportAgent(\n  options: CreateSupportAgentOptions = {}\n): Promise<AgentHandle<'tool-loop'>> {\n  return createAgent({\n    ...options,\n    agentType: 'tool-loop',\n    systemPrompt:\n      options.systemPrompt ??\n      'You are a support agent. Diagnose the user issue, ask only necessary clarifying questions, use tools for account or product facts, and end with clear next steps.',\n  });\n}\n\nexport function createResearchAgent(\n  options: CreateResearchAgentOptions = {}\n): Promise<AgentHandle<'tool-loop'>> {\n  return createAgent({\n    ...options,\n    agentType: 'tool-loop',\n    systemPrompt:\n      options.systemPrompt ??\n      'You are a research agent. Separate evidence from inference, cite sources or file paths, compare alternatives, and call out uncertainty.',\n  });\n}\n\nexport function createSecureToolAgent(\n  options: CreateSecureToolAgentOptions = {}\n): Promise<AgentHandle<'tool-loop'>> {\n  return createAgent({\n    ...options,\n    agentType: 'tool-loop',\n    permission: options.permission ?? 'ask',\n    profile: options.profile ?? 'local-sandboxed',\n    systemPrompt:\n      options.systemPrompt ??\n      'You are a cautious tool-using agent. Prefer read-only inspection first, request approval before writes or shell actions, and keep secrets out of prompts and logs.',\n  });\n}\n\nexport function createSupervisorTeam(\n  options: CreateSupervisorTeamOptions = {}\n): Promise<AgentHandle<'supervisor'>> {\n  const {\n    leader,\n    shared,\n    workers = defaultSupervisorWorkers(),\n    ...rest\n  } = options;\n  return createAgent({\n    ...rest,\n    agentType: 'supervisor',\n    leader: {\n      systemPrompt:\n        'You coordinate specialists. Delegate only when parallel expertise helps, then synthesize a concise final answer.',\n      ...leader,\n    },\n    shared: {\n      protocol: [\n        'Use worker results as evidence.',\n        'Keep delegation tasks specific and bounded.',\n      ],\n      ...shared,\n    },\n    workers,\n  });\n}\n\nfunction defaultSupervisorWorkers(): PackWorkerConfig[] {\n  return [\n    {\n      name: 'researcher',\n      description: 'Finds evidence, compares options, and cites sources.',\n      systemPrompt:\n        'You are the research worker. Gather evidence, cite concrete sources or paths, and distinguish facts from judgment.',\n      tags: ['research'],\n    },\n    {\n      name: 'implementer',\n      description: 'Plans implementation steps and checks risks.',\n      systemPrompt:\n        'You are the implementation worker. Propose practical steps, identify risks, and prefer small reversible changes.',\n      tags: ['implementation'],\n    },\n  ];\n}\n"],
+  "mappings": "AAGA,SAAS,mBAAmB;AAcrB,SAAS,kBACd,UAAoC,CAAC,GACF;AACnC,SAAO,YAAY;AAAA,IACjB,GAAG;AAAA,IACH,WAAW;AAAA,IACX,cACE,QAAQ,gBACR;AAAA,EACJ,CAAC;AACH;AAEO,SAAS,mBACd,UAAqC,CAAC,GACH;AACnC,SAAO,YAAY;AAAA,IACjB,GAAG;AAAA,IACH,WAAW;AAAA,IACX,cACE,QAAQ,gBACR;AAAA,EACJ,CAAC;AACH;AAEO,SAAS,oBACd,UAAsC,CAAC,GACJ;AACnC,SAAO,YAAY;AAAA,IACjB,GAAG;AAAA,IACH,WAAW;AAAA,IACX,cACE,QAAQ,gBACR;AAAA,EACJ,CAAC;AACH;AAEO,SAAS,sBACd,UAAwC,CAAC,GACN;AACnC,SAAO,YAAY;AAAA,IACjB,GAAG;AAAA,IACH,WAAW;AAAA,IACX,YAAY,QAAQ,cAAc;AAAA,IAClC,SAAS,QAAQ,WAAW;AAAA,IAC5B,cACE,QAAQ,gBACR;AAAA,EACJ,CAAC;AACH;AAEO,SAAS,qBACd,UAAuC,CAAC,GACJ;AACpC,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,UAAU,yBAAyB;AAAA,IACnC,GAAG;AAAA,EACL,IAAI;AACJ,SAAO,YAAY;AAAA,IACjB,GAAG;AAAA,IACH,WAAW;AAAA,IACX,QAAQ;AAAA,MACN,cACE;AAAA,MACF,GAAG;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,MACA,GAAG;AAAA,IACL;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA,SAAS,2BAA+C;AACtD,SAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,cACE;AAAA,MACF,MAAM,CAAC,UAAU;AAAA,IACnB;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,cACE;AAAA,MACF,MAAM,CAAC,gBAAgB;AAAA,IACzB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/runtime/bridge/agent-route-builders.d.ts

@@ -0,0 +1,19 @@
+import type { BackendName } from '../../domain/core-client.js';
+import { type Pack, type PackOptions } from '../orchestration/pack.js';
+import type { BridgeOptions } from '../sessions/context-types.js';
+import type { AgentType, AgentTypeOptions, CreateAgentCommonOptions, CreateAgentOptions } from './agent-route-types.js';
+/** Expand `backend`/`apiKey`/`host` shorthands and resolve priority. */
+export declare function bridgePriority<T extends BridgeOptions & CreateAgentCommonOptions>(options: T): T;
+export declare function stripAgentType<T extends AgentType>(options: CreateAgentOptions<T>): AgentTypeOptions<T> & CreateAgentCommonOptions;
+export declare function stripAgentKeys<T extends AgentType>(options: CreateAgentOptions<T>): AgentTypeOptions<T>;
+/**
+ * Returns true when every backend in the priority list manages its own tool
+ * loop and MCP natively (`nativeTools: true`, `backendType: 'cli'`).
+ */
+export declare function isAllNativeCli(priority: readonly BackendName[] | undefined): boolean;
+export declare function bridgeOptions<T extends AgentType>(agentType: T, options: CreateAgentOptions<T>): BridgeOptions;
+export declare function packOptions<T extends AgentType>(agentType: T, options: PackOptions & CreateAgentCommonOptions): PackOptions;
+export declare function rehydratePackAsync(pack: Pack): Promise<Pack>;
+export declare function requireNonEmptyArray(value: unknown, key: string, agentType: string): void;
+export declare function registerBuiltInAgentRoutes(): void;
+//# sourceMappingURL=agent-route-builders.d.ts.map

package/dist/runtime/bridge/agent-route-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-route-builders.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/agent-route-builders.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAM/D,OAAO,EAQL,KAAK,IAAI,EAET,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAInB,MAAM,wBAAwB,CAAC;AAMhC,wEAAwE;AACxE,wBAAgB,cAAc,CAC5B,CAAC,SAAS,aAAa,GAAG,wBAAwB,EAClD,OAAO,EAAE,CAAC,GAAG,CAAC,CAgCf;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAChD,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,gBAAgB,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAGhD;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAChD,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,gBAAgB,CAAC,CAAC,CAAC,CAiBrB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,GAC3C,OAAO,CAET;AA6BD,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,EAC/C,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,aAAa,CAQf;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAC7C,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,WAAW,GAAG,wBAAwB,GAC9C,WAAW,CA+Cb;AAGD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,IAAI,CAQN;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAgLjD"}