octoflow-core 1.0.0

package/dist/retrieval/vector-store.d.ts

@@ -0,0 +1,54 @@
+import type { ActionDefinition } from '../actions/types.js';
+import type { GatewayEmbedFn } from '../runtime/bridge/embedders/types.js';
+export interface RetrievalDocument {
+    id?: string;
+    metadata?: Record<string, unknown>;
+    source?: string;
+    text: string;
+}
+export interface RetrievalChunk {
+    documentId: string;
+    id: string;
+    index: number;
+    metadata?: Record<string, unknown>;
+    source?: string;
+    text: string;
+}
+export interface VectorStoreRecord extends RetrievalChunk {
+    embedding: readonly number[];
+}
+export interface VectorSearchResult extends RetrievalChunk {
+    score: number;
+}
+export interface ChunkTextOptions {
+    maxChars?: number;
+    overlapChars?: number;
+}
+export interface VectorSearchOptions {
+    minScore?: number;
+    topK?: number;
+}
+export interface CreateVectorStoreOptions {
+    chunk?: ChunkTextOptions | false;
+    dimensions?: number;
+    embed: GatewayEmbedFn;
+    model?: string;
+}
+export interface VectorStoreStats {
+    chunks: number;
+    documents: number;
+}
+export interface VectorStore {
+    addDocuments(documents: readonly RetrievalDocument[]): Promise<RetrievalChunk[]>;
+    clear(): void;
+    records(): readonly VectorStoreRecord[];
+    search(query: string, options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    stats(): VectorStoreStats;
+}
+export declare function chunkText(text: string, options?: ChunkTextOptions): string[];
+export declare function createVectorStore(options: CreateVectorStoreOptions): VectorStore;
+export declare function createRetrievalActions(store: VectorStore, options?: {
+    addName?: string;
+    searchName?: string;
+}): ActionDefinition[];
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/retrieval/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../src/retrieval/vector-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CACV,SAAS,EAAE,SAAS,iBAAiB,EAAE,GACtC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAAC;IACxC,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,KAAK,IAAI,gBAAgB,CAAC;CAC3B;AAKD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,MAAM,EAAE,CAmBV;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,WAAW,CA+Db;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,gBAAgB,EAAE,CA+CpB"}

package/dist/retrieval/vector-store.js

@@ -0,0 +1,160 @@
+import { defineAction } from "../actions/define.js";
+const DEFAULT_MAX_CHARS = 1200;
+const DEFAULT_OVERLAP_CHARS = 120;
+function chunkText(text, options = {}) {
+  const normalized = text.replace(/\s+/g, " ").trim();
+  if (!normalized) return [];
+  const maxChars = Math.max(1, options.maxChars ?? DEFAULT_MAX_CHARS);
+  const overlapChars = Math.max(
+    0,
+    options.overlapChars ?? DEFAULT_OVERLAP_CHARS
+  );
+  if (normalized.length <= maxChars) return [normalized];
+  const chunks = [];
+  let start = 0;
+  while (start < normalized.length) {
+    const end = Math.min(start + maxChars, normalized.length);
+    chunks.push(normalized.slice(start, end).trim());
+    if (end >= normalized.length) break;
+    start = Math.max(end - overlapChars, start + 1);
+  }
+  return chunks.filter((chunk) => chunk.length > 0);
+}
+function createVectorStore(options) {
+  const records = [];
+  const documentIds = /* @__PURE__ */ new Set();
+  let sequence = 0;
+  const embed = async (input) => options.embed([...input], {
+    ...options.dimensions != null ? { dimensions: options.dimensions } : {},
+    ...options.model ? { model: options.model } : {}
+  });
+  return {
+    async addDocuments(documents) {
+      const chunks = documents.flatMap(
+        (document) => toChunks(document, options.chunk, () => {
+          sequence += 1;
+          return `doc-${sequence}`;
+        })
+      );
+      if (chunks.length === 0) return [];
+      const embeddings = await embed(chunks.map((chunk) => chunk.text));
+      if (embeddings.length !== chunks.length) {
+        throw new Error(
+          `Vector store expected ${chunks.length} embeddings, got ${embeddings.length}`
+        );
+      }
+      for (let i = 0; i < chunks.length; i += 1) {
+        const chunk = chunks[i];
+        records.push({ ...chunk, embedding: embeddings[i] });
+        documentIds.add(chunk.documentId);
+      }
+      return chunks;
+    },
+    clear() {
+      records.length = 0;
+      documentIds.clear();
+    },
+    records() {
+      return [...records];
+    },
+    async search(query, searchOptions = {}) {
+      const [queryEmbedding] = await embed([query]);
+      if (!queryEmbedding) return [];
+      const topK = Math.max(1, searchOptions.topK ?? 5);
+      const minScore = searchOptions.minScore ?? Number.NEGATIVE_INFINITY;
+      return records.map((record) => ({
+        documentId: record.documentId,
+        id: record.id,
+        index: record.index,
+        ...record.metadata ? { metadata: record.metadata } : {},
+        score: cosineSimilarity(queryEmbedding, record.embedding),
+        ...record.source ? { source: record.source } : {},
+        text: record.text
+      })).filter((result) => result.score >= minScore).sort((a, b) => b.score - a.score).slice(0, topK);
+    },
+    stats() {
+      return { chunks: records.length, documents: documentIds.size };
+    }
+  };
+}
+function createRetrievalActions(store, options = {}) {
+  return [
+    defineAction({
+      name: options.searchName ?? "retrieve_search",
+      description: "Search indexed retrieval documents by semantic similarity.",
+      parameters: {
+        type: "object",
+        properties: {
+          query: { type: "string" },
+          topK: { type: "number" }
+        },
+        required: ["query"]
+      },
+      execute: async (args) => store.search(typeof args.query === "string" ? args.query : "", {
+        topK: toPositiveInteger(args.topK)
+      })
+    }),
+    defineAction({
+      name: options.addName ?? "retrieve_add_text",
+      description: "Add text to the retrieval vector store.",
+      parameters: {
+        type: "object",
+        properties: {
+          id: { type: "string" },
+          metadata: { type: "object" },
+          source: { type: "string" },
+          text: { type: "string" }
+        },
+        required: ["text"]
+      },
+      execute: async (args) => {
+        const added = await store.addDocuments([
+          {
+            id: typeof args.id === "string" ? args.id : void 0,
+            metadata: typeof args.metadata === "object" && args.metadata !== null ? args.metadata : void 0,
+            source: typeof args.source === "string" ? args.source : void 0,
+            text: typeof args.text === "string" ? args.text : ""
+          }
+        ]);
+        return { added: added.length, stats: store.stats() };
+      }
+    })
+  ];
+}
+function toChunks(document, chunkOptions, nextId) {
+  const documentId = document.id ?? nextId();
+  const texts = chunkOptions === false ? [document.text.trim()] : chunkText(document.text, chunkOptions);
+  return texts.map((text, index) => ({
+    documentId,
+    id: `${documentId}#${index}`,
+    index,
+    ...document.metadata ? { metadata: document.metadata } : {},
+    ...document.source ? { source: document.source } : {},
+    text
+  }));
+}
+function toPositiveInteger(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : void 0;
+}
+function cosineSimilarity(a, b) {
+  const length = Math.min(a.length, b.length);
+  if (length === 0) return 0;
+  let dot = 0;
+  let magA = 0;
+  let magB = 0;
+  for (let i = 0; i < length; i += 1) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    dot += av * bv;
+    magA += av * av;
+    magB += bv * bv;
+  }
+  if (magA === 0 || magB === 0) return 0;
+  return dot / (Math.sqrt(magA) * Math.sqrt(magB));
+}
+export {
+  chunkText,
+  createRetrievalActions,
+  createVectorStore
+};
+//# sourceMappingURL=vector-store.js.map

package/dist/retrieval/vector-store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/retrieval/vector-store.ts"],
+  "sourcesContent": ["import { defineAction } from '../actions/define.js';\nimport type { ActionDefinition } from '../actions/types.js';\nimport type { GatewayEmbedFn } from '../runtime/bridge/embedders/types.js';\n\nexport interface RetrievalDocument {\n  id?: string;\n  metadata?: Record<string, unknown>;\n  source?: string;\n  text: string;\n}\n\nexport interface RetrievalChunk {\n  documentId: string;\n  id: string;\n  index: number;\n  metadata?: Record<string, unknown>;\n  source?: string;\n  text: string;\n}\n\nexport interface VectorStoreRecord extends RetrievalChunk {\n  embedding: readonly number[];\n}\n\nexport interface VectorSearchResult extends RetrievalChunk {\n  score: number;\n}\n\nexport interface ChunkTextOptions {\n  maxChars?: number;\n  overlapChars?: number;\n}\n\nexport interface VectorSearchOptions {\n  minScore?: number;\n  topK?: number;\n}\n\nexport interface CreateVectorStoreOptions {\n  chunk?: ChunkTextOptions | false;\n  dimensions?: number;\n  embed: GatewayEmbedFn;\n  model?: string;\n}\n\nexport interface VectorStoreStats {\n  chunks: number;\n  documents: number;\n}\n\nexport interface VectorStore {\n  addDocuments(\n    documents: readonly RetrievalDocument[]\n  ): Promise<RetrievalChunk[]>;\n  clear(): void;\n  records(): readonly VectorStoreRecord[];\n  search(\n    query: string,\n    options?: VectorSearchOptions\n  ): Promise<VectorSearchResult[]>;\n  stats(): VectorStoreStats;\n}\n\nconst DEFAULT_MAX_CHARS = 1_200;\nconst DEFAULT_OVERLAP_CHARS = 120;\n\nexport function chunkText(\n  text: string,\n  options: ChunkTextOptions = {}\n): string[] {\n  const normalized = text.replace(/\\s+/g, ' ').trim();\n  if (!normalized) return [];\n  const maxChars = Math.max(1, options.maxChars ?? DEFAULT_MAX_CHARS);\n  const overlapChars = Math.max(\n    0,\n    options.overlapChars ?? DEFAULT_OVERLAP_CHARS\n  );\n  if (normalized.length <= maxChars) return [normalized];\n\n  const chunks: string[] = [];\n  let start = 0;\n  while (start < normalized.length) {\n    const end = Math.min(start + maxChars, normalized.length);\n    chunks.push(normalized.slice(start, end).trim());\n    if (end >= normalized.length) break;\n    start = Math.max(end - overlapChars, start + 1);\n  }\n  return chunks.filter((chunk) => chunk.length > 0);\n}\n\nexport function createVectorStore(\n  options: CreateVectorStoreOptions\n): VectorStore {\n  const records: VectorStoreRecord[] = [];\n  const documentIds = new Set<string>();\n  let sequence = 0;\n\n  const embed = async (input: readonly string[]) =>\n    options.embed([...input], {\n      ...(options.dimensions != null ? { dimensions: options.dimensions } : {}),\n      ...(options.model ? { model: options.model } : {}),\n    });\n\n  return {\n    async addDocuments(documents) {\n      const chunks = documents.flatMap((document) =>\n        toChunks(document, options.chunk, () => {\n          sequence += 1;\n          return `doc-${sequence}`;\n        })\n      );\n      if (chunks.length === 0) return [];\n      const embeddings = await embed(chunks.map((chunk) => chunk.text));\n      if (embeddings.length !== chunks.length) {\n        throw new Error(\n          `Vector store expected ${chunks.length} embeddings, got ${embeddings.length}`\n        );\n      }\n      for (let i = 0; i < chunks.length; i += 1) {\n        const chunk = chunks[i]!;\n        records.push({ ...chunk, embedding: embeddings[i]! });\n        documentIds.add(chunk.documentId);\n      }\n      return chunks;\n    },\n    clear() {\n      records.length = 0;\n      documentIds.clear();\n    },\n    records() {\n      return [...records];\n    },\n    async search(query, searchOptions = {}) {\n      const [queryEmbedding] = await embed([query]);\n      if (!queryEmbedding) return [];\n      const topK = Math.max(1, searchOptions.topK ?? 5);\n      const minScore = searchOptions.minScore ?? Number.NEGATIVE_INFINITY;\n      return records\n        .map((record) => ({\n          documentId: record.documentId,\n          id: record.id,\n          index: record.index,\n          ...(record.metadata ? { metadata: record.metadata } : {}),\n          score: cosineSimilarity(queryEmbedding, record.embedding),\n          ...(record.source ? { source: record.source } : {}),\n          text: record.text,\n        }))\n        .filter((result) => result.score >= minScore)\n        .sort((a, b) => b.score - a.score)\n        .slice(0, topK);\n    },\n    stats() {\n      return { chunks: records.length, documents: documentIds.size };\n    },\n  };\n}\n\nexport function createRetrievalActions(\n  store: VectorStore,\n  options: { addName?: string; searchName?: string } = {}\n): ActionDefinition[] {\n  return [\n    defineAction({\n      name: options.searchName ?? 'retrieve_search',\n      description: 'Search indexed retrieval documents by semantic similarity.',\n      parameters: {\n        type: 'object',\n        properties: {\n          query: { type: 'string' },\n          topK: { type: 'number' },\n        },\n        required: ['query'],\n      },\n      execute: async (args) =>\n        store.search(typeof args.query === 'string' ? args.query : '', {\n          topK: toPositiveInteger(args.topK),\n        }),\n    }),\n    defineAction({\n      name: options.addName ?? 'retrieve_add_text',\n      description: 'Add text to the retrieval vector store.',\n      parameters: {\n        type: 'object',\n        properties: {\n          id: { type: 'string' },\n          metadata: { type: 'object' },\n          source: { type: 'string' },\n          text: { type: 'string' },\n        },\n        required: ['text'],\n      },\n      execute: async (args) => {\n        const added = await store.addDocuments([\n          {\n            id: typeof args.id === 'string' ? args.id : undefined,\n            metadata:\n              typeof args.metadata === 'object' && args.metadata !== null\n                ? (args.metadata as Record<string, unknown>)\n                : undefined,\n            source: typeof args.source === 'string' ? args.source : undefined,\n            text: typeof args.text === 'string' ? args.text : '',\n          },\n        ]);\n        return { added: added.length, stats: store.stats() };\n      },\n    }),\n  ];\n}\n\nfunction toChunks(\n  document: RetrievalDocument,\n  chunkOptions: ChunkTextOptions | false | undefined,\n  nextId: () => string\n): RetrievalChunk[] {\n  const documentId = document.id ?? nextId();\n  const texts =\n    chunkOptions === false\n      ? [document.text.trim()]\n      : chunkText(document.text, chunkOptions);\n  return texts.map((text, index) => ({\n    documentId,\n    id: `${documentId}#${index}`,\n    index,\n    ...(document.metadata ? { metadata: document.metadata } : {}),\n    ...(document.source ? { source: document.source } : {}),\n    text,\n  }));\n}\n\nfunction toPositiveInteger(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) && value > 0\n    ? Math.trunc(value)\n    : undefined;\n}\n\nfunction cosineSimilarity(a: readonly number[], b: readonly number[]): number {\n  const length = Math.min(a.length, b.length);\n  if (length === 0) return 0;\n  let dot = 0;\n  let magA = 0;\n  let magB = 0;\n  for (let i = 0; i < length; i += 1) {\n    const av = a[i] ?? 0;\n    const bv = b[i] ?? 0;\n    dot += av * bv;\n    magA += av * av;\n    magB += bv * bv;\n  }\n  if (magA === 0 || magB === 0) return 0;\n  return dot / (Math.sqrt(magA) * Math.sqrt(magB));\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/action-helpers.d.ts

@@ -0,0 +1,9 @@
+import { ActionRegistry } from '../../actions/registry.js';
+import type { BridgeOptions } from '../sessions/context-types.js';
+/**
+ * Build and populate an ActionRegistry from BridgeOptions.
+ * Registers built-in actions (based on feature flags) then user-defined actions.
+ * User-defined actions win by name without registering duplicate built-ins first.
+ */
+export declare function initializeActionRegistry(opts: BridgeOptions): ActionRegistry;
+//# sourceMappingURL=action-helpers.d.ts.map

package/dist/runtime/bridge/action-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-helpers.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/action-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAsB5E"}

package/dist/runtime/bridge/action-helpers.js

@@ -0,0 +1,25 @@
+import { loadBuiltinActions } from "../../actions/builtin/index.js";
+import { ActionRegistry } from "../../actions/registry.js";
+function initializeActionRegistry(opts) {
+  const registry = new ActionRegistry();
+  const explicitActionNames = new Set(
+    opts.actions?.map((action) => action.name)
+  );
+  const builtinActions = loadBuiltinActions(opts.builtinActions, {
+    hasAuth: !!opts.auth,
+    hasApproval: !!opts.approval?.enabled,
+    workspace: opts.workspace,
+    dangerouslyDisableBashSecurity: opts.security?.dangerouslyDisableBashSecurity
+  });
+  for (const action of builtinActions) {
+    if (!explicitActionNames.has(action.name)) registry.register(action);
+  }
+  if (opts.actions) {
+    for (const action of opts.actions) registry.register(action);
+  }
+  return registry;
+}
+export {
+  initializeActionRegistry
+};
+//# sourceMappingURL=action-helpers.js.map

package/dist/runtime/bridge/action-helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/action-helpers.ts"],
+  "sourcesContent": ["import { loadBuiltinActions } from '../../actions/builtin/index.js';\nimport { ActionRegistry } from '../../actions/registry.js';\nimport type { BridgeOptions } from '../sessions/context-types.js';\n\n/**\n * Build and populate an ActionRegistry from BridgeOptions.\n * Registers built-in actions (based on feature flags) then user-defined actions.\n * User-defined actions win by name without registering duplicate built-ins first.\n */\nexport function initializeActionRegistry(opts: BridgeOptions): ActionRegistry {\n  const registry = new ActionRegistry();\n  const explicitActionNames = new Set(\n    opts.actions?.map((action) => action.name)\n  );\n\n  const builtinActions = loadBuiltinActions(opts.builtinActions, {\n    hasAuth: !!opts.auth,\n    hasApproval: !!opts.approval?.enabled,\n    workspace: opts.workspace,\n    dangerouslyDisableBashSecurity:\n      opts.security?.dangerouslyDisableBashSecurity,\n  });\n  for (const action of builtinActions) {\n    if (!explicitActionNames.has(action.name)) registry.register(action);\n  }\n\n  if (opts.actions) {\n    for (const action of opts.actions) registry.register(action);\n  }\n\n  return registry;\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AACnC,SAAS,sBAAsB;AAQxB,SAAS,yBAAyB,MAAqC;AAC5E,QAAM,WAAW,IAAI,eAAe;AACpC,QAAM,sBAAsB,IAAI;AAAA,IAC9B,KAAK,SAAS,IAAI,CAAC,WAAW,OAAO,IAAI;AAAA,EAC3C;AAEA,QAAM,iBAAiB,mBAAmB,KAAK,gBAAgB;AAAA,IAC7D,SAAS,CAAC,CAAC,KAAK;AAAA,IAChB,aAAa,CAAC,CAAC,KAAK,UAAU;AAAA,IAC9B,WAAW,KAAK;AAAA,IAChB,gCACE,KAAK,UAAU;AAAA,EACnB,CAAC;AACD,aAAW,UAAU,gBAAgB;AACnC,QAAI,CAAC,oBAAoB,IAAI,OAAO,IAAI,EAAG,UAAS,SAAS,MAAM;AAAA,EACrE;AAEA,MAAI,KAAK,SAAS;AAChB,eAAW,UAAU,KAAK,QAAS,UAAS,SAAS,MAAM;AAAA,EAC7D;AAEA,SAAO;AACT;",
+  "names": []
+}

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

@@ -0,0 +1,239 @@
+/**
+ * Public interface types for {@link AgentHandle}.
+ * Implementation lives in `agent-handle.ts`.
+ */
+import type { ListSessionsOptions, SessionListResult, SessionRecord } from '../../adapters/data/session-store/types.js';
+import type { LocalContextResult } from '../../capabilities/local-context/types.js';
+import type { McpConnection } from '../../capabilities/mcp/connection.js';
+import type { McpConnectionPool } from '../../capabilities/mcp/pool.js';
+import type { AgentSkillMetadata } from '../../capabilities/skills/types.js';
+import type { AgentStatus, BackendInspection, BridgeConversation, BridgeConversationSnapshotOptions, BridgeListConversationsOptions, BridgeListConversationsResult, BridgeListTasksOptions, BridgeListTasksResult, BridgeSendMessageParams, BridgeSendResult, BridgeSubscriptionEvent, BridgeTaskSnapshotOptions, BridgeTaskSubscriptionOptions, GetAllSessionsOptions, SessionSummary } from '../../domain/bridge-api.js';
+import type { Task } from '../../domain/core-task.js';
+import type { PackEvent, PackResult, PackSendParams, PackSession } from '../orchestration/pack.js';
+import type { BridgeRunParams, PackRunParams, RunEvent } from '../orchestration/run/types.js';
+import type { AgentHarnessInspection, AgentInfo, AgentInspection, AgentRuntimeConfigSnapshot } from './agent-info-types.js';
+import type { AgentRunResult, AgentRuntime, AgentType } from './agent-routes.js';
+import type { Bridge } from './bridge.js';
+import type { AgentConfigureInput, AgentConfigureResult } from './configure.js';
+import type { BridgeAnyEventHandler, BridgeEventEmitter } from './events.js';
+import type { MakeGatewayHandle, MakeGatewayOptions } from './make-gateway.js';
+import type { OpenAiGatewayServerHandle, OpenAiGatewayServerOptions } from './openai-gateway.js';
+import type { BridgePlugin } from './plugins.js';
+import type { BridgeRegistryFacade } from './registry-facade.js';
+import type { BridgeSession } from './session.js';
+import type { TopicChannel } from './topic-channel.js';
+import type { WorkflowCronOptions, WorkflowHandle } from './workflows/index.js';
+export type { AgentStatus } from '../../domain/bridge-api.js';
+export type { AgentHarnessActionInspection, AgentHarnessActionSource, AgentHarnessBackendConformanceInspection, AgentHarnessBackendFeatureInspection, AgentHarnessBrainInspection, AgentHarnessConformanceInspection, AgentHarnessFeatureDefinition, AgentHarnessFeatureId, AgentHarnessInspection, AgentHarnessMcpInspection, AgentHarnessMcpToolInspection, AgentHarnessPluginInspection, AgentHarnessSkillInspection, AgentInfo, AgentInspection, AgentRuntimeConfigSnapshot, } from './agent-info-types.js';
+export type { AgentHarnessCapabilityDefinition, AgentHarnessCapabilityId, AgentHarnessCapabilityInspection, AgentHarnessCapabilityStatus, } from './harness-capabilities.js';
+export type BridgeBackedAgentType = 'tool-loop' | 'sequential' | 'loop' | 'code-act' | 'react';
+export type PackBackedAgentType = Exclude<AgentType, BridgeBackedAgentType>;
+export type AgentSendParams<T extends AgentType> = T extends BridgeBackedAgentType ? BridgeSendMessageParams : PackSendParams;
+export type AgentSendResult<T extends AgentType> = T extends BridgeBackedAgentType ? BridgeSendResult : PackResult;
+export type AgentStreamEvent<T extends AgentType> = T extends BridgeBackedAgentType ? BridgeSubscriptionEvent : PackEvent;
+export type AgentSession<T extends AgentType = AgentType> = T extends BridgeBackedAgentType ? BridgeSession : PackSession;
+/**
+ * Discriminated run-params type: `BridgeRunParams` for Bridge-backed agents,
+ * `PackRunParams` for Pack-backed agents. Prevents passing Bridge-only fields
+ * (e.g. `systemPrompt`, `effort`, `readOnly`) to multi-agent Pack types.
+ */
+export type AgentRunParams<T extends AgentType> = T extends BridgeBackedAgentType ? BridgeRunParams : PackRunParams;
+export interface AgentHandle<T extends AgentType = AgentType> {
+    /** Discriminant tag — narrows generic T at the call site. */
+    readonly agentType: T;
+    /**
+     * Underlying runtime powering this agent.
+     * `Bridge` for `tool-loop`, `loop`, `sequential`, `code-act`;
+     * `Pack` for `supervisor`, `swarm`, `parallel`, `plan-execute`, `reflection`.
+     */
+    readonly runtime: AgentRuntime<T>;
+    /**
+     * The leader `Bridge` instance.
+     * For Bridge-backed agents this is the same object as `runtime`.
+     * For Pack-backed agents this is `pack.leader`.
+     *
+     * @internal Framework internals only — use the typed `AgentHandle` API surface instead.
+     */
+    readonly bridge: Bridge;
+    /** Typed event bus — subscribe to task, backend, memory, MCP, and approval events. */
+    readonly events: BridgeEventEmitter;
+    /** Attach an event listener. Returns an unsubscribe function. */
+    readonly on: Bridge['on'];
+    /** Attach a one-shot event listener. Returns an unsubscribe function. */
+    readonly once: Bridge['once'];
+    /** Remove a previously registered event listener. */
+    readonly off: Bridge['off'];
+    /** Attach a wildcard listener for every emitted event object. */
+    readonly onAny: (handler: BridgeAnyEventHandler) => () => void;
+    /** Remove a previously registered wildcard listener. */
+    readonly offAny: (handler: BridgeAnyEventHandler) => void;
+    /** Skill registry facade — register, list, and remove agent skills at runtime. */
+    readonly registry: BridgeRegistryFacade;
+    /**
+     * Pub/sub coordination bus shared across all workers in this agent's Pack.
+     * Present (`TopicChannel`) for Pack-backed agents; `undefined` for Bridge-backed agents.
+     * TypeScript narrows this based on `T` — no optional chaining needed on Pack agents.
+     */
+    readonly topics: T extends PackBackedAgentType ? TopicChannel : undefined;
+    /**
+     * Stable UUID of the underlying Pack instance.
+     * Present (`string`) for Pack-backed agents; `undefined` for Bridge-backed agents.
+     * TypeScript narrows this based on `T`.
+     */
+    readonly packId: T extends PackBackedAgentType ? string : undefined;
+    /**
+     * Single-call health snapshot: model readiness, session count, lifetime
+     * token/cost totals, and agent uptime. Non-mutating — safe to poll.
+     */
+    getStatus(): Promise<AgentStatus>;
+    /**
+     * Return live backend info: which backend is selected and all candidates
+     * with their readiness state.
+     */
+    info(): Promise<AgentInfo>;
+    /**
+     * Full inspection snapshot — backends, runtime config, and (for Pack agents)
+     * worker details. Useful for diagnostics and health checks.
+     */
+    inspect(): Promise<AgentInspection>;
+    /** Full harness inventory: backends, config, plugins, actions, skills, MCP, brain, and Pack workers. */
+    inspectHarness(): Promise<AgentHarnessInspection>;
+    /** Probe backend readiness — returns the full inspection array directly. */
+    inspectBackends(): Promise<BackendInspection[]>;
+    /**
+     * Return the current runtime configuration snapshot, including the
+     * resolved `agentType` discriminant.
+     */
+    getConfig(): AgentRuntimeConfigSnapshot<T>;
+    /**
+     * Install a plugin into the agent's Bridge.
+     * Plugins can register actions, inject middleware, and subscribe to events.
+     */
+    use(plugin: BridgePlugin): Promise<void>;
+    /**
+     * Open a persistent session scoped to `contextId`.
+     * Subsequent calls with the same ID resume the same conversation history.
+     *
+     * @param contextId - Optional context identifier. Auto-generated when omitted.
+     * @param options   - Optional tenant scoping.
+     */
+    session(contextId?: string, options?: {
+        tenant?: string;
+    }): AgentSession<T>;
+    /**
+     * Resume a session that was previously persisted via a session store.
+     * Returns a `BridgeSession` regardless of agent type.
+     */
+    resumeSession(sessionId: string): BridgeSession;
+    /** Retrieve a stored session record, or `undefined` if not found. */
+    getSessionRecord(sessionId: string): Promise<SessionRecord | undefined>;
+    /** List sessions with optional filtering and pagination. */
+    listSessions(options?: ListSessionsOptions): Promise<SessionListResult>;
+    /** Return all session summaries, including cross-context sessions. */
+    getAllSessions(options?: GetAllSessionsOptions): Promise<SessionSummary[]>;
+    /**
+     * Register a recurring workflow on `context` either by timeout (ms) or
+     * cron expression. The workflow fires `sendMessage` on the schedule.
+     */
+    addWorkflow(context: string, timeoutMs: number): WorkflowHandle;
+    addWorkflow(context: string, cronOpts: WorkflowCronOptions): WorkflowHandle;
+    /**
+     * Hot-patch agent configuration without restarting the runtime.
+     * Only available on Bridge-backed agents. Passing any value to a Pack-backed
+     * agent is a **compile-time error** (the parameter type resolves to `never`).
+     */
+    configure(input: T extends PackBackedAgentType ? never : AgentConfigureInput): Promise<AgentConfigureResult>;
+    /** Send a single message and return the full result. */
+    sendMessage(message: string): Promise<AgentSendResult<T>>;
+    sendMessage(params: AgentSendParams<T>): Promise<AgentSendResult<T>>;
+    /** Stream a single message, yielding events as they arrive. */
+    stream(message: string): AsyncGenerator<AgentStreamEvent<T>>;
+    stream(params: AgentSendParams<T>): AsyncGenerator<AgentStreamEvent<T>>;
+    /**
+     * Fire a one-shot run (single turn, no persistent session).
+     * Accepts a plain string shorthand or a typed params object.
+     *
+     * The params type is discriminated by `T`:
+     * - Bridge-backed agents (`tool-loop`, `loop`, `code-act`, `react`, `sequential`):
+     *   accepts `BridgeRunParams` — includes `systemPrompt`, `model`, `effort`, `readOnly`, etc.
+     * - Pack-backed agents (`supervisor`, `swarm`, `parallel`, `plan-execute`, `reflection`):
+     *   accepts `PackRunParams` — subset: `message`, `contextId`, `loop`, `flow`, `tasks`.
+     *
+     * ```ts
+     * // One-shot (default) — calls the LLM once:
+     * const result = await agent.run('Summarise this file');
+     *
+     * // Multi-turn loop — keeps running until completion promise is met:
+     * const result = await agent.run({
+     *   message: 'Fix all lint errors in the repo',
+     *   loop: { completionPromise: 'ALL_DONE', maxIterations: 20 },
+     * });
+     * ```
+     */
+    run(message: string): Promise<AgentRunResult<T>>;
+    run(params: AgentRunParams<T>): Promise<AgentRunResult<T>>;
+    /** Stream a one-shot run, yielding `RunEvent` objects until completion. */
+    runStream(message: string): AsyncGenerator<RunEvent>;
+    runStream(params: AgentRunParams<T>): AsyncGenerator<RunEvent>;
+    /** Fetch a task snapshot by ID. */
+    getTask(taskId: string, options?: BridgeTaskSnapshotOptions): Promise<Task>;
+    /** List tasks with optional status and pagination filters. */
+    listTasks(options?: BridgeListTasksOptions): Promise<BridgeListTasksResult>;
+    /** Cancel a running or pending task. Returns the updated task snapshot. */
+    cancelTask(taskId: string, options?: Pick<BridgeTaskSnapshotOptions, 'contextId' | 'tenant' | 'subject'>): Promise<Task>;
+    /**
+     * Subscribe to live status updates for a task.
+     * The returned `AsyncIterable` yields `BridgeSubscriptionEvent` objects
+     * until the task reaches a terminal state.
+     */
+    subscribeToTask(taskId: string, options?: BridgeTaskSubscriptionOptions): Promise<AsyncIterable<BridgeSubscriptionEvent>>;
+    /** Fetch the full conversation history for a context. */
+    getConversation(contextId: string, options?: BridgeConversationSnapshotOptions): Promise<BridgeConversation>;
+    /** List conversations across contexts with optional filters. */
+    listConversations(options?: BridgeListConversationsOptions): Promise<BridgeListConversationsResult>;
+    /** Return the active MCP connection pool, or `undefined` if MCP is not configured. */
+    getMcpPool(): McpConnectionPool | undefined;
+    /** Return a named MCP connection, or `undefined` if not found. */
+    getMcpConnection(name: string): McpConnection | undefined;
+    /**
+     * Return the last local-context resolution result (file tree, git info, etc.),
+     * or `undefined` if local context has not been resolved yet.
+     */
+    getLocalContextResult(): LocalContextResult | undefined;
+    /** List all registered agent skills with their metadata. */
+    listAgentSkills(): AgentSkillMetadata[];
+    /** Look up a skill by name, or `undefined` if not registered. */
+    getAgentSkill(name: string): AgentSkillMetadata | undefined;
+    /**
+     * Activate a named skill, injecting its tools and instructions into the agent.
+     * Returns the skill activation summary.
+     */
+    activateAgentSkill(name: string): Promise<string>;
+    /**
+     * Start an OpenAI-compatible HTTP gateway in front of this agent.
+     * Useful for connecting third-party tools that speak the OpenAI Chat API.
+     *
+     * @see {@link makeGateway} for the unified version that also supports the
+     *   native Anthropic Messages API inbound format.
+     */
+    openAiGateway(options?: Omit<OpenAiGatewayServerOptions, 'agent' | 'agentOptions'>): Promise<OpenAiGatewayServerHandle>;
+    /**
+     * Start an HTTP gateway in front of this agent with an explicit inbound
+     * protocol.
+     *
+     * `inboundProtocol` controls the **HTTP wire format** callers use — it is
+     * fully independent of which LLM or CLI backend the agent uses internally.
+     *
+     * ```ts
+     * // OpenAI Chat API inbound → any backend outbound (default)
+     * const gw = await agent.makeGateway({ inboundProtocol: 'openai', port: 3456 });
+     *
+     * // Anthropic Messages API inbound → any backend outbound
+     * const gw = await agent.makeGateway({ inboundProtocol: 'anthropic', port: 3456 });
+     * ```
+     */
+    makeGateway(options?: MakeGatewayOptions): Promise<MakeGatewayHandle>;
+    /** Gracefully shut down the agent and release all resources. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=agent-handle-types.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,8 @@
+import type { Pack } from '../orchestration/pack.js';
+import type { BridgeRunParams } from '../orchestration/run/types.js';
+import type { AgentHandle, BridgeBackedAgentType, PackBackedAgentType } from './agent-handle-types.js';
+import type { Bridge } from './bridge.js';
+export type { AgentHandle, AgentHarnessActionInspection, AgentHarnessActionSource, AgentHarnessBackendConformanceInspection, AgentHarnessBackendFeatureInspection, AgentHarnessBrainInspection, AgentHarnessCapabilityDefinition, AgentHarnessCapabilityId, AgentHarnessCapabilityInspection, AgentHarnessCapabilityStatus, AgentHarnessConformanceInspection, AgentHarnessFeatureDefinition, AgentHarnessFeatureId, AgentHarnessInspection, AgentHarnessMcpInspection, AgentHarnessMcpToolInspection, AgentHarnessPluginInspection, AgentHarnessSkillInspection, AgentInfo, AgentInspection, AgentRunParams, AgentRuntimeConfigSnapshot, AgentSendParams, AgentSendResult, AgentSession, AgentStreamEvent, BridgeBackedAgentType, PackBackedAgentType, } from './agent-handle-types.js';
+export declare function bridgeAgentHandle<T extends BridgeBackedAgentType>(agentType: T, bridge: Bridge, runDefaults?: Partial<BridgeRunParams>): AgentHandle<T>;
+export declare function packAgentHandle<T extends PackBackedAgentType>(agentType: T, pack: Pack): AgentHandle<T>;
+//# sourceMappingURL=agent-handle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-handle.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/agent-handle.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EACV,WAAW,EAKX,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,YAAY,EACV,WAAW,EACX,4BAA4B,EAC5B,wBAAwB,EACxB,wCAAwC,EACxC,oCAAoC,EACpC,2BAA2B,EAC3B,gCAAgC,EAChC,wBAAwB,EACxB,gCAAgC,EAChC,4BAA4B,EAC5B,iCAAiC,EACjC,6BAA6B,EAC7B,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,EAC5B,2BAA2B,EAC3B,SAAS,EACT,eAAe,EACf,cAAc,EACd,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,qBAAqB,EAC/D,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,OAAO,CAAC,eAAe,CAAM,GACzC,WAAW,CAAC,CAAC,CAAC,CAkFhB;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,mBAAmB,EAC3D,SAAS,EAAE,CAAC,EACZ,IAAI,EAAE,IAAI,GACT,WAAW,CAAC,CAAC,CAAC,CAgGhB"}