octoflow-core 1.0.0

package/dist/capabilities/mcp/transport-factory.js

@@ -0,0 +1,75 @@
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { DEFAULT_ALLOWED_ENV_VARS } from "../../config/defaults.js";
+import { resolveChildEnv } from "../../config/env-resolver.js";
+function resolveTransportKind(config) {
+  if (config.transport === "sse") return "sse";
+  if (config.transport === "streamable-http" || config.transport === "http") {
+    return "streamable-http";
+  }
+  if (config.transport === "stdio") return "stdio";
+  if (config.url) return "streamable-http";
+  return "stdio";
+}
+function buildMcpEnv(configEnv, options) {
+  if (options.envMode === "inherit") {
+    return { ...process.env, ...configEnv ?? {} };
+  }
+  if (options.envMode === "profile" && options.profile && options.workspace) {
+    return resolveChildEnv({
+      callEnv: configEnv,
+      profile: options.profile,
+      backend: "claude-code-cli",
+      workspace: options.workspace
+    });
+  }
+  const base = {};
+  for (const key of DEFAULT_ALLOWED_ENV_VARS) {
+    const val = process.env[key];
+    if (val !== void 0) base[key] = val;
+  }
+  return { ...base, ...configEnv ?? {} };
+}
+async function resolveBearerToken(auth) {
+  if (!auth || auth.type !== "bearer") return void 0;
+  return typeof auth.token === "string" ? auth.token : await auth.token();
+}
+async function createTransport(input) {
+  const { config, options } = input;
+  const kind = resolveTransportKind(config);
+  if (kind === "stdio") {
+    if (!config.command) {
+      throw new Error(
+        `MCP server "${input.serverName}": stdio transport requires "command"`
+      );
+    }
+    return new StdioClientTransport({
+      command: config.command,
+      args: config.args ?? [],
+      env: buildMcpEnv(config.env, options),
+      cwd: config.cwd
+    });
+  }
+  if (!config.url) {
+    throw new Error(
+      `MCP server "${input.serverName}": "${kind}" transport requires "url"`
+    );
+  }
+  const url = new URL(config.url);
+  const bearer = await resolveBearerToken(config.auth);
+  const headers = {};
+  if (bearer) headers["Authorization"] = `Bearer ${bearer}`;
+  if (kind === "sse") {
+    return new SSEClientTransport(url, {
+      requestInit: bearer ? { headers } : void 0
+    });
+  }
+  return new StreamableHTTPClientTransport(url, {
+    requestInit: bearer ? { headers } : void 0
+  });
+}
+export {
+  createTransport
+};
+//# sourceMappingURL=transport-factory.js.map

package/dist/capabilities/mcp/transport-factory.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/mcp/transport-factory.ts"],
+  "sourcesContent": ["import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';\nimport { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';\n\nimport { DEFAULT_ALLOWED_ENV_VARS } from '../../config/defaults.js';\nimport { resolveChildEnv } from '../../config/env-resolver.js';\nimport type { BridgeMcpLoadOptions, BridgeMcpServerConfig } from '../types.js';\n\ntype McpTransportKind = 'stdio' | 'streamable-http' | 'sse';\n\nfunction resolveTransportKind(config: BridgeMcpServerConfig): McpTransportKind {\n  if (config.transport === 'sse') return 'sse';\n  if (config.transport === 'streamable-http' || config.transport === 'http') {\n    return 'streamable-http';\n  }\n  if (config.transport === 'stdio') return 'stdio';\n  if (config.url) return 'streamable-http';\n  return 'stdio';\n}\n\nfunction buildMcpEnv(\n  configEnv: Record<string, string> | undefined,\n  options: BridgeMcpLoadOptions\n): Record<string, string> {\n  if (options.envMode === 'inherit') {\n    return { ...(process.env as Record<string, string>), ...(configEnv ?? {}) };\n  }\n\n  if (options.envMode === 'profile' && options.profile && options.workspace) {\n    return resolveChildEnv({\n      callEnv: configEnv,\n      profile: options.profile,\n      backend: 'claude-code-cli',\n      workspace: options.workspace,\n    });\n  }\n\n  const base: Record<string, string> = {};\n  for (const key of DEFAULT_ALLOWED_ENV_VARS) {\n    const val = process.env[key];\n    if (val !== undefined) base[key] = val;\n  }\n  return { ...base, ...(configEnv ?? {}) };\n}\n\ninterface BearerAuth {\n  type: 'bearer';\n  token: string | (() => Promise<string>);\n}\n\ninterface CreateTransportInput {\n  serverName: string;\n  config: BridgeMcpServerConfig & { auth?: BearerAuth };\n  options: BridgeMcpLoadOptions;\n}\n\nasync function resolveBearerToken(\n  auth: BearerAuth | undefined\n): Promise<string | undefined> {\n  if (!auth || auth.type !== 'bearer') return undefined;\n  return typeof auth.token === 'string' ? auth.token : await auth.token();\n}\n\nexport async function createTransport(\n  input: CreateTransportInput\n): Promise<Transport> {\n  const { config, options } = input;\n  const kind = resolveTransportKind(config);\n\n  if (kind === 'stdio') {\n    if (!config.command) {\n      throw new Error(\n        `MCP server \"${input.serverName}\": stdio transport requires \"command\"`\n      );\n    }\n    return new StdioClientTransport({\n      command: config.command,\n      args: config.args ?? [],\n      env: buildMcpEnv(config.env, options),\n      cwd: config.cwd,\n    });\n  }\n\n  if (!config.url) {\n    throw new Error(\n      `MCP server \"${input.serverName}\": \"${kind}\" transport requires \"url\"`\n    );\n  }\n  const url = new URL(config.url);\n  const bearer = await resolveBearerToken(config.auth);\n  const headers: Record<string, string> = {};\n  if (bearer) headers['Authorization'] = `Bearer ${bearer}`;\n\n  if (kind === 'sse') {\n    return new SSEClientTransport(url, {\n      requestInit: bearer ? { headers } : undefined,\n    });\n  }\n  return new StreamableHTTPClientTransport(url, {\n    requestInit: bearer ? { headers } : undefined,\n  });\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AACnC,SAAS,4BAA4B;AACrC,SAAS,qCAAqC;AAG9C,SAAS,gCAAgC;AACzC,SAAS,uBAAuB;AAKhC,SAAS,qBAAqB,QAAiD;AAC7E,MAAI,OAAO,cAAc,MAAO,QAAO;AACvC,MAAI,OAAO,cAAc,qBAAqB,OAAO,cAAc,QAAQ;AACzE,WAAO;AAAA,EACT;AACA,MAAI,OAAO,cAAc,QAAS,QAAO;AACzC,MAAI,OAAO,IAAK,QAAO;AACvB,SAAO;AACT;AAEA,SAAS,YACP,WACA,SACwB;AACxB,MAAI,QAAQ,YAAY,WAAW;AACjC,WAAO,EAAE,GAAI,QAAQ,KAAgC,GAAI,aAAa,CAAC,EAAG;AAAA,EAC5E;AAEA,MAAI,QAAQ,YAAY,aAAa,QAAQ,WAAW,QAAQ,WAAW;AACzE,WAAO,gBAAgB;AAAA,MACrB,SAAS;AAAA,MACT,SAAS,QAAQ;AAAA,MACjB,SAAS;AAAA,MACT,WAAW,QAAQ;AAAA,IACrB,CAAC;AAAA,EACH;AAEA,QAAM,OAA+B,CAAC;AACtC,aAAW,OAAO,0BAA0B;AAC1C,UAAM,MAAM,QAAQ,IAAI,GAAG;AAC3B,QAAI,QAAQ,OAAW,MAAK,GAAG,IAAI;AAAA,EACrC;AACA,SAAO,EAAE,GAAG,MAAM,GAAI,aAAa,CAAC,EAAG;AACzC;AAaA,eAAe,mBACb,MAC6B;AAC7B,MAAI,CAAC,QAAQ,KAAK,SAAS,SAAU,QAAO;AAC5C,SAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,MAAM,KAAK,MAAM;AACxE;AAEA,eAAsB,gBACpB,OACoB;AACpB,QAAM,EAAE,QAAQ,QAAQ,IAAI;AAC5B,QAAM,OAAO,qBAAqB,MAAM;AAExC,MAAI,SAAS,SAAS;AACpB,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,IAAI;AAAA,QACR,eAAe,MAAM,UAAU;AAAA,MACjC;AAAA,IACF;AACA,WAAO,IAAI,qBAAqB;AAAA,MAC9B,SAAS,OAAO;AAAA,MAChB,MAAM,OAAO,QAAQ,CAAC;AAAA,MACtB,KAAK,YAAY,OAAO,KAAK,OAAO;AAAA,MACpC,KAAK,OAAO;AAAA,IACd,CAAC;AAAA,EACH;AAEA,MAAI,CAAC,OAAO,KAAK;AACf,UAAM,IAAI;AAAA,MACR,eAAe,MAAM,UAAU,OAAO,IAAI;AAAA,IAC5C;AAAA,EACF;AACA,QAAM,MAAM,IAAI,IAAI,OAAO,GAAG;AAC9B,QAAM,SAAS,MAAM,mBAAmB,OAAO,IAAI;AACnD,QAAM,UAAkC,CAAC;AACzC,MAAI,OAAQ,SAAQ,eAAe,IAAI,UAAU,MAAM;AAEvD,MAAI,SAAS,OAAO;AAClB,WAAO,IAAI,mBAAmB,KAAK;AAAA,MACjC,aAAa,SAAS,EAAE,QAAQ,IAAI;AAAA,IACtC,CAAC;AAAA,EACH;AACA,SAAO,IAAI,8BAA8B,KAAK;AAAA,IAC5C,aAAa,SAAS,EAAE,QAAQ,IAAI;AAAA,EACtC,CAAC;AACH;",
+  "names": []
+}

package/dist/capabilities/mcp/types.d.ts

@@ -0,0 +1,80 @@
+export interface McpToolEntry {
+    server: string;
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface McpResourceEntry {
+    server: string;
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface McpPromptEntry {
+    server: string;
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+export interface McpResourceContent {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+}
+export interface McpPromptMessages {
+    description?: string;
+    messages: Array<{
+        role: 'user' | 'assistant';
+        content: {
+            type: 'text';
+            text: string;
+        };
+    }>;
+}
+export type McpContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+};
+export interface McpToolResult {
+    content: McpContentBlock[];
+    isError?: boolean;
+}
+export interface McpConnectionCallbacks {
+    onElicitation?: (req: {
+        server: string;
+        message: string;
+        requestedSchema?: Record<string, unknown>;
+    }) => Promise<{
+        action: 'accept' | 'decline' | 'cancel';
+        content?: Record<string, unknown>;
+    }>;
+}
+export interface McpSdkOverrides {
+    /** Forwarded to the SDK `Client` constructor (e.g. client name/version). */
+    clientInfo?: {
+        name?: string;
+        version?: string;
+    };
+    /** Additional SDK `Client` options — e.g. `enforceStrictCapabilities`. */
+    clientOptions?: Record<string, unknown>;
+    /** Extra headers for HTTP-based transports. */
+    requestInit?: Record<string, unknown>;
+}
+export interface McpPoolOptions {
+    onConnectionError?: 'throw' | 'ignore';
+    callbacks?: McpConnectionCallbacks;
+    sdkOverrides?: McpSdkOverrides;
+    /** Optional JSON schema validator applied before tool invocation. */
+    jsonSchemaValidator?: (schema: Record<string, unknown>, args: Record<string, unknown>) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/mcp/types.d.ts.map

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

package/dist/capabilities/mcp/types.js

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

package/dist/capabilities/mcp/types.js.map

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

package/dist/capabilities/mcp-loader.d.ts

@@ -0,0 +1,15 @@
+import { type SharedMcpTool } from './mcp/pool.js';
+import type { McpPoolOptions } from './mcp/types.js';
+import type { BridgeMcpLoadOptions, BridgeMcpServerConfig } from './types.js';
+export type { SharedMcpTool } from './mcp/pool.js';
+export { McpConnectionPool } from './mcp/pool.js';
+/**
+ * Convenience entry point that wraps `McpConnectionPool` and returns the
+ * tools plus a cleanup callback. The pool delegates the MCP wire to
+ * `@modelcontextprotocol/sdk`.
+ */
+export declare function loadMcpTools(servers: Record<string, BridgeMcpServerConfig>, options?: BridgeMcpLoadOptions, poolOptions?: McpPoolOptions): Promise<{
+    tools: SharedMcpTool[];
+    cleanup: () => Promise<void>;
+}>;
+//# sourceMappingURL=mcp-loader.d.ts.map

package/dist/capabilities/mcp-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-loader.d.ts","sourceRoot":"","sources":["../../src/capabilities/mcp-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE9E,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAC9C,OAAO,GAAE,oBAAyB,EAClC,WAAW,GAAE,cAAmB,GAC/B,OAAO,CAAC;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAYnE"}

package/dist/capabilities/mcp-loader.js

@@ -0,0 +1,20 @@
+import { McpConnectionPool } from "./mcp/pool.js";
+import { McpConnectionPool as McpConnectionPool2 } from "./mcp/pool.js";
+async function loadMcpTools(servers, options = {}, poolOptions = {}) {
+  const pool = new McpConnectionPool(servers, options, poolOptions);
+  try {
+    await pool.loadAll();
+  } catch (err) {
+    await pool.closeAll();
+    throw err;
+  }
+  return {
+    tools: pool.toActions(),
+    cleanup: () => pool.closeAll()
+  };
+}
+export {
+  McpConnectionPool2 as McpConnectionPool,
+  loadMcpTools
+};
+//# sourceMappingURL=mcp-loader.js.map

package/dist/capabilities/mcp-loader.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/capabilities/mcp-loader.ts"],
+  "sourcesContent": ["import { McpConnectionPool, type SharedMcpTool } from './mcp/pool.js';\nimport type { McpPoolOptions } from './mcp/types.js';\nimport type { BridgeMcpLoadOptions, BridgeMcpServerConfig } from './types.js';\n\nexport type { SharedMcpTool } from './mcp/pool.js';\nexport { McpConnectionPool } from './mcp/pool.js';\n\n/**\n * Convenience entry point that wraps `McpConnectionPool` and returns the\n * tools plus a cleanup callback. The pool delegates the MCP wire to\n * `@modelcontextprotocol/sdk`.\n */\nexport async function loadMcpTools(\n  servers: Record<string, BridgeMcpServerConfig>,\n  options: BridgeMcpLoadOptions = {},\n  poolOptions: McpPoolOptions = {}\n): Promise<{ tools: SharedMcpTool[]; cleanup: () => Promise<void> }> {\n  const pool = new McpConnectionPool(servers, options, poolOptions);\n  try {\n    await pool.loadAll();\n  } catch (err) {\n    await pool.closeAll();\n    throw err;\n  }\n  return {\n    tools: pool.toActions(),\n    cleanup: () => pool.closeAll(),\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,yBAA6C;AAKtD,SAAS,qBAAAA,0BAAyB;AAOlC,eAAsB,aACpB,SACA,UAAgC,CAAC,GACjC,cAA8B,CAAC,GACoC;AACnE,QAAM,OAAO,IAAI,kBAAkB,SAAS,SAAS,WAAW;AAChE,MAAI;AACF,UAAM,KAAK,QAAQ;AAAA,EACrB,SAAS,KAAK;AACZ,UAAM,KAAK,SAAS;AACpB,UAAM;AAAA,EACR;AACA,SAAO;AAAA,IACL,OAAO,KAAK,UAAU;AAAA,IACtB,SAAS,MAAM,KAAK,SAAS;AAAA,EAC/B;AACF;",
+  "names": ["McpConnectionPool"]
+}

package/dist/capabilities/memory-indexer.d.ts

@@ -0,0 +1,62 @@
+import type { MemoryKind } from 'octoflow-protocols';
+import type { CognitiveMemoryLike } from '../runtime/bridge/brain-contract.js';
+export interface MemoryIndexerSource {
+    /** Project-relative or absolute path to a file or directory. */
+    path: string;
+    /** When true, walk a directory recursively. Ignored for files. Default: true. */
+    recursive?: boolean;
+}
+export type MemoryIndexerScope = 'global' | 'context' | 'tenant';
+export type MemoryIndexerMode = 'append' | 'replace-source';
+export interface MemoryIndexerOptions {
+    /** Root directory to resolve relative source paths against. */
+    root: string;
+    /** Brain (or compatible) into which to write memories. */
+    brain: CognitiveMemoryLike;
+    /**
+     * Idempotency mode. Default `append` preserves the original behavior and
+     * writes a fresh record for every chunk on every run. `replace-source`
+     * first asks the brain to remove records for each file's stable source key;
+     * brains without that optional hook fail closed rather than duplicating.
+     */
+    mode?: MemoryIndexerMode;
+    /**
+     * Source list. Defaults to:
+     *  - `MEMORY.md`
+     *  - `AGENTS.md`
+     *  - `memory/` (recursive)
+     *  - `docs/` (recursive)
+     */
+    sources?: MemoryIndexerSource[];
+    /** File extensions to consider when walking directories. Default: `.md`, `.markdown`. */
+    extensions?: string[];
+    /** Memory scope used for `remember()`. Default `'global'`. */
+    scope?: MemoryIndexerScope;
+    /** `scopeId` for non-global scopes (e.g. project key). */
+    scopeId?: string;
+    /** Memory kind for stored chunks. Default `'fact'`. */
+    kind?: MemoryKind;
+    /** Trust tier 1-4. Default `3` (project-curated). */
+    trustTier?: 1 | 2 | 3 | 4;
+    /** Skip files larger than this. Default 256 KiB. */
+    maxFileBytes?: number;
+    /** Skip individual chunks longer than this many bytes (after trimming). Default 32 KiB. */
+    maxChunkBytes?: number;
+    /** Optional progress callback fired once per file. */
+    onProgress?: (event: MemoryIndexerEvent) => void;
+}
+export interface MemoryIndexerEvent {
+    file: string;
+    status: 'indexed' | 'skipped' | 'failed';
+    reason?: string;
+    recordIds?: string[];
+}
+export interface MemoryIndexerResult {
+    indexedFiles: number;
+    indexedRecords: number;
+    skippedFiles: number;
+    failedFiles: number;
+    events: MemoryIndexerEvent[];
+}
+export declare function indexMemoryFiles(options: MemoryIndexerOptions): Promise<MemoryIndexerResult>;
+//# sourceMappingURL=memory-indexer.d.ts.map

package/dist/capabilities/memory-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-indexer.d.ts","sourceRoot":"","sources":["../../src/capabilities/memory-indexer.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAYD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA+C9B"}

package/dist/capabilities/memory-indexer.js

@@ -0,0 +1,220 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+const DEFAULT_SOURCES = [
+  { path: "MEMORY.md" },
+  { path: "AGENTS.md" },
+  { path: "memory", recursive: true },
+  { path: "docs", recursive: true }
+];
+const DEFAULT_EXTS = [".md", ".markdown"];
+const DEFAULT_MAX_FILE_BYTES = 256 * 1024;
+const DEFAULT_MAX_CHUNK_BYTES = 32 * 1024;
+async function indexMemoryFiles(options) {
+  const sources = options.sources ?? DEFAULT_SOURCES;
+  const extensions = (options.extensions ?? DEFAULT_EXTS).map(
+    (e) => e.toLowerCase()
+  );
+  const maxFileBytes = options.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;
+  const maxChunkBytes = options.maxChunkBytes ?? DEFAULT_MAX_CHUNK_BYTES;
+  const scope = options.scope ?? "global";
+  const kind = options.kind ?? "fact";
+  const trustTier = options.trustTier ?? 3;
+  const mode = options.mode ?? "append";
+  const collected = await collectFiles(options.root, sources, extensions);
+  const result = {
+    indexedFiles: 0,
+    indexedRecords: 0,
+    skippedFiles: 0,
+    failedFiles: 0,
+    events: []
+  };
+  const events = await Promise.all(
+    collected.map(
+      (file) => indexOne(file, options, {
+        maxFileBytes,
+        maxChunkBytes,
+        scope,
+        kind,
+        trustTier,
+        mode
+      })
+    )
+  );
+  for (const event of events) {
+    result.events.push(event);
+    if (event.status === "indexed") {
+      result.indexedFiles += 1;
+      result.indexedRecords += event.recordIds?.length ?? 0;
+    } else if (event.status === "skipped") {
+      result.skippedFiles += 1;
+    } else {
+      result.failedFiles += 1;
+    }
+    options.onProgress?.(event);
+  }
+  return result;
+}
+async function indexOne(file, options, settings) {
+  let stat;
+  try {
+    stat = await fs.stat(file);
+  } catch (err) {
+    return { file, status: "failed", reason: errorMessage(err) };
+  }
+  if (stat.size > settings.maxFileBytes) {
+    return {
+      file,
+      status: "skipped",
+      reason: `file > ${settings.maxFileBytes}B`
+    };
+  }
+  let text;
+  try {
+    text = await fs.readFile(file, "utf8");
+  } catch (err) {
+    return { file, status: "failed", reason: errorMessage(err) };
+  }
+  const chunks = splitMarkdown(text, settings.maxChunkBytes);
+  if (chunks.length === 0) {
+    return { file, status: "skipped", reason: "empty after chunking" };
+  }
+  const sourceKey = path.relative(options.root, file);
+  if (settings.mode === "replace-source") {
+    await forgetIndexedSource(options.brain, sourceKey);
+  }
+  const recordIds = [];
+  for (let chunkIndex = 0; chunkIndex < chunks.length; chunkIndex += 1) {
+    const chunk = chunks[chunkIndex];
+    const contentHash = crypto.createHash("sha256").update(chunk.text).digest("hex");
+    try {
+      const result = await options.brain.remember({
+        text: chunk.text,
+        kind: settings.kind,
+        source: "external",
+        scope: settings.scope,
+        scopeId: options.scopeId,
+        trustTier: settings.trustTier,
+        metadata: {
+          file: sourceKey,
+          heading: chunk.heading,
+          indexer: "octoflow-core/memory-indexer",
+          sourceKey,
+          chunkIndex,
+          contentHash
+        }
+      });
+      if (result.accepted) {
+        recordIds.push(result.recordId);
+      }
+    } catch (err) {
+      return { file, status: "failed", reason: errorMessage(err), recordIds };
+    }
+  }
+  if (recordIds.length === 0) {
+    return {
+      file,
+      status: "skipped",
+      reason: "all chunks rejected",
+      recordIds
+    };
+  }
+  return { file, status: "indexed", recordIds };
+}
+async function forgetIndexedSource(brain, sourceKey) {
+  const replacementBrain = brain;
+  if (typeof replacementBrain.forgetBySource !== "function") {
+    throw new Error(
+      "memory indexer mode `replace-source` requires brain.forgetBySource(sourceKey)"
+    );
+  }
+  await replacementBrain.forgetBySource(sourceKey);
+}
+function splitMarkdown(source, maxChunkBytes) {
+  const trimmed = source.trim();
+  if (!trimmed) return [];
+  const lines = trimmed.split(/\r?\n/);
+  const sections = [{ lines: [] }];
+  for (const line of lines) {
+    const match = /^##\s+(.+?)\s*#*\s*$/.exec(line);
+    if (match) {
+      sections.push({ heading: match[1], lines: [] });
+    } else {
+      sections[sections.length - 1].lines.push(line);
+    }
+  }
+  const start = sections.length > 1 ? 1 : 0;
+  const chunks = [];
+  for (let i = start; i < sections.length; i += 1) {
+    const section = sections[i];
+    const body = section.lines.join("\n").trim();
+    if (!body) continue;
+    if (Buffer.byteLength(body, "utf8") > maxChunkBytes) continue;
+    chunks.push({ heading: section.heading, text: body });
+  }
+  return chunks;
+}
+async function collectFiles(root, sources, extensions) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const source of sources) {
+    const target = path.isAbsolute(source.path) ? source.path : path.join(root, source.path);
+    let stat;
+    try {
+      stat = await fs.stat(target);
+    } catch {
+      continue;
+    }
+    if (stat.isFile()) {
+      if (matchesExtension(target, extensions) && !seen.has(target)) {
+        seen.add(target);
+        out.push(target);
+      }
+      continue;
+    }
+    if (stat.isDirectory()) {
+      const recursive = source.recursive !== false;
+      await walkDir(target, recursive, extensions, seen, out);
+    }
+  }
+  return out;
+}
+async function walkDir(dir, recursive, extensions, seen, out) {
+  let names;
+  try {
+    names = await fs.readdir(dir);
+  } catch {
+    return;
+  }
+  for (const name of names) {
+    if (name.startsWith(".")) continue;
+    const full = path.join(dir, name);
+    let stat;
+    try {
+      stat = await fs.stat(full);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      if (recursive) {
+        await walkDir(full, recursive, extensions, seen, out);
+      }
+      continue;
+    }
+    if (stat.isFile() && matchesExtension(full, extensions) && !seen.has(full)) {
+      seen.add(full);
+      out.push(full);
+    }
+  }
+}
+function matchesExtension(file, extensions) {
+  const ext = path.extname(file).toLowerCase();
+  return extensions.includes(ext);
+}
+function errorMessage(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+export {
+  indexMemoryFiles
+};
+//# sourceMappingURL=memory-indexer.js.map

package/dist/capabilities/memory-indexer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/capabilities/memory-indexer.ts"],
+  "sourcesContent": ["/**\n * Index local memory files into a `CognitiveMemory` (typically `octoflow-brain`).\n *\n * Walks a project for `MEMORY.md`, `memory/**\\/*.md`, `AGENTS.md`, and\n * `docs/**\\/*.md` (configurable), splits each markdown file into chunks\n * by `^## ` headings, and pushes them through `brain.remember()`.\n *\n * Pure glue \u2014 no glob library, no embedder selection, no chunking strategy\n * beyond H2 splitting. Brings the brain `remember()` sink to project files\n * without forcing callers to write their own walker.\n */\nimport crypto from 'node:crypto';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type { MemoryKind } from 'octoflow-protocols';\n\nimport type { CognitiveMemoryLike } from '../runtime/bridge/brain-contract.js';\n\nexport interface MemoryIndexerSource {\n  /** Project-relative or absolute path to a file or directory. */\n  path: string;\n  /** When true, walk a directory recursively. Ignored for files. Default: true. */\n  recursive?: boolean;\n}\n\nexport type MemoryIndexerScope = 'global' | 'context' | 'tenant';\nexport type MemoryIndexerMode = 'append' | 'replace-source';\n\nexport interface MemoryIndexerOptions {\n  /** Root directory to resolve relative source paths against. */\n  root: string;\n  /** Brain (or compatible) into which to write memories. */\n  brain: CognitiveMemoryLike;\n  /**\n   * Idempotency mode. Default `append` preserves the original behavior and\n   * writes a fresh record for every chunk on every run. `replace-source`\n   * first asks the brain to remove records for each file's stable source key;\n   * brains without that optional hook fail closed rather than duplicating.\n   */\n  mode?: MemoryIndexerMode;\n  /**\n   * Source list. Defaults to:\n   *  - `MEMORY.md`\n   *  - `AGENTS.md`\n   *  - `memory/` (recursive)\n   *  - `docs/` (recursive)\n   */\n  sources?: MemoryIndexerSource[];\n  /** File extensions to consider when walking directories. Default: `.md`, `.markdown`. */\n  extensions?: string[];\n  /** Memory scope used for `remember()`. Default `'global'`. */\n  scope?: MemoryIndexerScope;\n  /** `scopeId` for non-global scopes (e.g. project key). */\n  scopeId?: string;\n  /** Memory kind for stored chunks. Default `'fact'`. */\n  kind?: MemoryKind;\n  /** Trust tier 1-4. Default `3` (project-curated). */\n  trustTier?: 1 | 2 | 3 | 4;\n  /** Skip files larger than this. Default 256 KiB. */\n  maxFileBytes?: number;\n  /** Skip individual chunks longer than this many bytes (after trimming). Default 32 KiB. */\n  maxChunkBytes?: number;\n  /** Optional progress callback fired once per file. */\n  onProgress?: (event: MemoryIndexerEvent) => void;\n}\n\nexport interface MemoryIndexerEvent {\n  file: string;\n  status: 'indexed' | 'skipped' | 'failed';\n  reason?: string;\n  recordIds?: string[];\n}\n\nexport interface MemoryIndexerResult {\n  indexedFiles: number;\n  indexedRecords: number;\n  skippedFiles: number;\n  failedFiles: number;\n  events: MemoryIndexerEvent[];\n}\n\nconst DEFAULT_SOURCES: MemoryIndexerSource[] = [\n  { path: 'MEMORY.md' },\n  { path: 'AGENTS.md' },\n  { path: 'memory', recursive: true },\n  { path: 'docs', recursive: true },\n];\nconst DEFAULT_EXTS = ['.md', '.markdown'];\nconst DEFAULT_MAX_FILE_BYTES = 256 * 1024;\nconst DEFAULT_MAX_CHUNK_BYTES = 32 * 1024;\n\nexport async function indexMemoryFiles(\n  options: MemoryIndexerOptions\n): Promise<MemoryIndexerResult> {\n  const sources = options.sources ?? DEFAULT_SOURCES;\n  const extensions = (options.extensions ?? DEFAULT_EXTS).map((e) =>\n    e.toLowerCase()\n  );\n  const maxFileBytes = options.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;\n  const maxChunkBytes = options.maxChunkBytes ?? DEFAULT_MAX_CHUNK_BYTES;\n  const scope = options.scope ?? 'global';\n  const kind = options.kind ?? 'fact';\n  const trustTier = options.trustTier ?? 3;\n  const mode = options.mode ?? 'append';\n\n  const collected = await collectFiles(options.root, sources, extensions);\n  const result: MemoryIndexerResult = {\n    indexedFiles: 0,\n    indexedRecords: 0,\n    skippedFiles: 0,\n    failedFiles: 0,\n    events: [],\n  };\n\n  const events = await Promise.all(\n    collected.map((file) =>\n      indexOne(file, options, {\n        maxFileBytes,\n        maxChunkBytes,\n        scope,\n        kind,\n        trustTier,\n        mode,\n      })\n    )\n  );\n  for (const event of events) {\n    result.events.push(event);\n    if (event.status === 'indexed') {\n      result.indexedFiles += 1;\n      result.indexedRecords += event.recordIds?.length ?? 0;\n    } else if (event.status === 'skipped') {\n      result.skippedFiles += 1;\n    } else {\n      result.failedFiles += 1;\n    }\n    options.onProgress?.(event);\n  }\n\n  return result;\n}\n\ninterface IndexerSettings {\n  maxFileBytes: number;\n  maxChunkBytes: number;\n  scope: MemoryIndexerScope;\n  kind: MemoryKind;\n  trustTier: 1 | 2 | 3 | 4;\n  mode: MemoryIndexerMode;\n}\n\ninterface ReplaceSourceBrain {\n  forgetBySource(sourceKey: string): Promise<number> | number;\n}\n\nasync function indexOne(\n  file: string,\n  options: MemoryIndexerOptions,\n  settings: IndexerSettings\n): Promise<MemoryIndexerEvent> {\n  let stat: Awaited<ReturnType<typeof fs.stat>>;\n  try {\n    stat = await fs.stat(file);\n  } catch (err) {\n    return { file, status: 'failed', reason: errorMessage(err) };\n  }\n\n  if (stat.size > settings.maxFileBytes) {\n    return {\n      file,\n      status: 'skipped',\n      reason: `file > ${settings.maxFileBytes}B`,\n    };\n  }\n\n  let text: string;\n  try {\n    text = await fs.readFile(file, 'utf8');\n  } catch (err) {\n    return { file, status: 'failed', reason: errorMessage(err) };\n  }\n\n  const chunks = splitMarkdown(text, settings.maxChunkBytes);\n  if (chunks.length === 0) {\n    return { file, status: 'skipped', reason: 'empty after chunking' };\n  }\n\n  const sourceKey = path.relative(options.root, file);\n  if (settings.mode === 'replace-source') {\n    await forgetIndexedSource(options.brain, sourceKey);\n  }\n\n  const recordIds: string[] = [];\n  // sequential: fail-fast on first chunk error; avoid concurrent remember calls for the same file\n  for (let chunkIndex = 0; chunkIndex < chunks.length; chunkIndex += 1) {\n    const chunk = chunks[chunkIndex]!;\n    const contentHash = crypto\n      .createHash('sha256')\n      .update(chunk.text)\n      .digest('hex');\n    try {\n      const result = await options.brain.remember({\n        text: chunk.text,\n        kind: settings.kind,\n        source: 'external',\n        scope: settings.scope,\n        scopeId: options.scopeId,\n        trustTier: settings.trustTier,\n        metadata: {\n          file: sourceKey,\n          heading: chunk.heading,\n          indexer: 'octoflow-core/memory-indexer',\n          sourceKey,\n          chunkIndex,\n          contentHash,\n        },\n      });\n      if (result.accepted) {\n        recordIds.push(result.recordId);\n      }\n    } catch (err) {\n      return { file, status: 'failed', reason: errorMessage(err), recordIds };\n    }\n  }\n\n  if (recordIds.length === 0) {\n    return {\n      file,\n      status: 'skipped',\n      reason: 'all chunks rejected',\n      recordIds,\n    };\n  }\n\n  return { file, status: 'indexed', recordIds };\n}\n\nasync function forgetIndexedSource(\n  brain: CognitiveMemoryLike,\n  sourceKey: string\n): Promise<void> {\n  const replacementBrain = brain as CognitiveMemoryLike &\n    Partial<ReplaceSourceBrain>;\n  if (typeof replacementBrain.forgetBySource !== 'function') {\n    throw new Error(\n      'memory indexer mode `replace-source` requires brain.forgetBySource(sourceKey)'\n    );\n  }\n  await replacementBrain.forgetBySource(sourceKey);\n}\n\ninterface MarkdownChunk {\n  heading?: string;\n  text: string;\n}\n\nfunction splitMarkdown(source: string, maxChunkBytes: number): MarkdownChunk[] {\n  const trimmed = source.trim();\n  if (!trimmed) return [];\n\n  const lines = trimmed.split(/\\r?\\n/);\n  const sections: { heading?: string; lines: string[] }[] = [{ lines: [] }];\n  for (const line of lines) {\n    const match = /^##\\s+(.+?)\\s*#*\\s*$/.exec(line);\n    if (match) {\n      sections.push({ heading: match[1], lines: [] });\n    } else {\n      sections[sections.length - 1]!.lines.push(line);\n    }\n  }\n\n  // Drop the leading pre-H2 preamble whenever at least one H2 was seen.\n  // Files with no H2 fall back to a single chunk covering the whole body.\n  const start = sections.length > 1 ? 1 : 0;\n  const chunks: MarkdownChunk[] = [];\n  for (let i = start; i < sections.length; i += 1) {\n    const section = sections[i]!;\n    const body = section.lines.join('\\n').trim();\n    if (!body) continue;\n    if (Buffer.byteLength(body, 'utf8') > maxChunkBytes) continue;\n    chunks.push({ heading: section.heading, text: body });\n  }\n  return chunks;\n}\n\nasync function collectFiles(\n  root: string,\n  sources: MemoryIndexerSource[],\n  extensions: string[]\n): Promise<string[]> {\n  const out: string[] = [];\n  const seen = new Set<string>();\n\n  // sequential: shared seen/out dedupe must not race across concurrent walks\n  for (const source of sources) {\n    const target = path.isAbsolute(source.path)\n      ? source.path\n      : path.join(root, source.path);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(target);\n    } catch {\n      continue;\n    }\n\n    if (stat.isFile()) {\n      if (matchesExtension(target, extensions) && !seen.has(target)) {\n        seen.add(target);\n        out.push(target);\n      }\n      continue;\n    }\n\n    if (stat.isDirectory()) {\n      const recursive = source.recursive !== false;\n      await walkDir(target, recursive, extensions, seen, out);\n    }\n  }\n\n  return out;\n}\n\nasync function walkDir(\n  dir: string,\n  recursive: boolean,\n  extensions: string[],\n  seen: Set<string>,\n  out: string[]\n): Promise<void> {\n  let names: string[];\n  try {\n    names = await fs.readdir(dir);\n  } catch {\n    return;\n  }\n\n  // sequential: directory walk; stat/recurse order keeps traversal predictable\n  for (const name of names) {\n    if (name.startsWith('.')) continue;\n    const full = path.join(dir, name);\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(full);\n    } catch {\n      continue;\n    }\n    if (stat.isDirectory()) {\n      if (recursive) {\n        await walkDir(full, recursive, extensions, seen, out);\n      }\n      continue;\n    }\n    if (\n      stat.isFile() &&\n      matchesExtension(full, extensions) &&\n      !seen.has(full)\n    ) {\n      seen.add(full);\n      out.push(full);\n    }\n  }\n}\n\nfunction matchesExtension(file: string, extensions: string[]): boolean {\n  const ext = path.extname(file).toLowerCase();\n  return extensions.includes(ext);\n}\n\nfunction errorMessage(err: unknown): string {\n  return err instanceof Error ? err.message : String(err);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/capabilities/skill-delivery.d.ts

@@ -0,0 +1,18 @@
+import type { BackendName } from '../domain/core-client.js';
+import { type SkillDefinition, type SkillDeliveryResult } from './skill-types.js';
+import type { CapabilityState } from './types.js';
+/**
+ * Resolve the active skill actions and determine the delivery strategy for
+ * the target backend.
+ *
+ * Strategy table (mirrors tool-delivery.ts):
+ * ```
+ *   API backends              → native          (structured tool definitions)
+ *   claude-code-cli           → native          (action injection)
+ *   codex-cli / cursor-cli    → prompt-injection
+ *   custom / a2a / unknown    → prompt-injection
+ * ```
+ *
+ */
+export declare function prepareSkillDelivery(skills: SkillDefinition[], backend: BackendName, state: CapabilityState): Promise<SkillDeliveryResult>;
+//# sourceMappingURL=skill-delivery.d.ts.map

package/dist/capabilities/skill-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-delivery.d.ts","sourceRoot":"","sources":["../../src/capabilities/skill-delivery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuBlD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAwB9B"}

package/dist/capabilities/skill-delivery.js

@@ -0,0 +1,38 @@
+import { buildSkillPromptBlock } from "../prompts/skills.js";
+import {
+  classifyBackendForSkills
+} from "./skill-types.js";
+async function collectActiveActions(skills, state) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const skill of skills) {
+    const enabled = skill.condition ? await skill.condition(state) : true;
+    if (!enabled) continue;
+    for (const action of skill.actions) {
+      if (!seen.has(action.name)) seen.set(action.name, action);
+    }
+  }
+  return [...seen.values()];
+}
+async function prepareSkillDelivery(skills, backend, state) {
+  if (skills.length === 0) {
+    return { strategy: "none", injectedActions: [] };
+  }
+  const activeActions = await collectActiveActions(skills, state);
+  if (activeActions.length === 0) {
+    return { strategy: "none", injectedActions: [] };
+  }
+  const family = classifyBackendForSkills(backend);
+  if (family === "api" || family === "claude-code-cli") {
+    return { strategy: "native", injectedActions: activeActions };
+  }
+  const systemPromptSuffix = buildSkillPromptBlock(activeActions) || void 0;
+  return {
+    strategy: "prompt-injection",
+    injectedActions: activeActions,
+    systemPromptSuffix
+  };
+}
+export {
+  prepareSkillDelivery
+};
+//# sourceMappingURL=skill-delivery.js.map

package/dist/capabilities/skill-delivery.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/capabilities/skill-delivery.ts"],
+  "sourcesContent": ["import type { ActionDefinition } from '../actions/types.js';\nimport type { BackendName } from '../domain/core-client.js';\nimport { buildSkillPromptBlock } from '../prompts/skills.js';\nimport {\n  classifyBackendForSkills,\n  type SkillDefinition,\n  type SkillDeliveryResult,\n} from './skill-types.js';\nimport type { CapabilityState } from './types.js';\n\n/**\n * Collect the union of actions across all active skills.\n *\n * Uses a Map for O(n) deduplication \u2014 first skill's action wins on name\n * collision, mirroring the precedence rule in resolveSkillActions().\n */\nasync function collectActiveActions(\n  skills: SkillDefinition[],\n  state: CapabilityState\n): Promise<ActionDefinition[]> {\n  const seen = new Map<string, ActionDefinition>();\n  for (const skill of skills) {\n    const enabled = skill.condition ? await skill.condition(state) : true;\n    if (!enabled) continue;\n    for (const action of skill.actions) {\n      if (!seen.has(action.name)) seen.set(action.name, action);\n    }\n  }\n  return [...seen.values()];\n}\n\n/**\n * Resolve the active skill actions and determine the delivery strategy for\n * the target backend.\n *\n * Strategy table (mirrors tool-delivery.ts):\n * ```\n *   API backends              \u2192 native          (structured tool definitions)\n *   claude-code-cli           \u2192 native          (action injection)\n *   codex-cli / cursor-cli    \u2192 prompt-injection\n *   custom / a2a / unknown    \u2192 prompt-injection\n * ```\n *\n */\nexport async function prepareSkillDelivery(\n  skills: SkillDefinition[],\n  backend: BackendName,\n  state: CapabilityState\n): Promise<SkillDeliveryResult> {\n  if (skills.length === 0) {\n    return { strategy: 'none', injectedActions: [] };\n  }\n\n  const activeActions = await collectActiveActions(skills, state);\n\n  if (activeActions.length === 0) {\n    return { strategy: 'none', injectedActions: [] };\n  }\n\n  const family = classifyBackendForSkills(backend);\n\n  if (family === 'api' || family === 'claude-code-cli') {\n    return { strategy: 'native', injectedActions: activeActions };\n  }\n\n  // other-cli / custom / a2a \u2192 prompt injection\n  const systemPromptSuffix = buildSkillPromptBlock(activeActions) || undefined;\n  return {\n    strategy: 'prompt-injection',\n    injectedActions: activeActions,\n    systemPromptSuffix,\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,OAGK;AASP,eAAe,qBACb,QACA,OAC6B;AAC7B,QAAM,OAAO,oBAAI,IAA8B;AAC/C,aAAW,SAAS,QAAQ;AAC1B,UAAM,UAAU,MAAM,YAAY,MAAM,MAAM,UAAU,KAAK,IAAI;AACjE,QAAI,CAAC,QAAS;AACd,eAAW,UAAU,MAAM,SAAS;AAClC,UAAI,CAAC,KAAK,IAAI,OAAO,IAAI,EAAG,MAAK,IAAI,OAAO,MAAM,MAAM;AAAA,IAC1D;AAAA,EACF;AACA,SAAO,CAAC,GAAG,KAAK,OAAO,CAAC;AAC1B;AAeA,eAAsB,qBACpB,QACA,SACA,OAC8B;AAC9B,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO,EAAE,UAAU,QAAQ,iBAAiB,CAAC,EAAE;AAAA,EACjD;AAEA,QAAM,gBAAgB,MAAM,qBAAqB,QAAQ,KAAK;AAE9D,MAAI,cAAc,WAAW,GAAG;AAC9B,WAAO,EAAE,UAAU,QAAQ,iBAAiB,CAAC,EAAE;AAAA,EACjD;AAEA,QAAM,SAAS,yBAAyB,OAAO;AAE/C,MAAI,WAAW,SAAS,WAAW,mBAAmB;AACpD,WAAO,EAAE,UAAU,UAAU,iBAAiB,cAAc;AAAA,EAC9D;AAGA,QAAM,qBAAqB,sBAAsB,aAAa,KAAK;AACnE,SAAO;AAAA,IACL,UAAU;AAAA,IACV,iBAAiB;AAAA,IACjB;AAAA,EACF;AACF;",
+  "names": []
+}