agentic-flow 3.2.0 → 3.3.1

package/dist/config/claudeFlow.d.ts

@@ -26,7 +26,7 @@ export declare function getMemoryConfig(agentName?: string): {
  * Initialize swarm coordination for multi-agent tasks
  */
 export declare function getSwarmConfig(topology?: ClaudeFlowConfig['coordinationTopology']): {
-    topology: "mesh" | "hierarchical" | "ring" | "star";
+    topology: "hierarchical" | "mesh" | "ring" | "star";
     maxAgents: number;
     strategy: "balanced";
 };

package/dist/integrations/index.d.ts

@@ -6,8 +6,8 @@ export { scanPromptInjection, promptInjectionEngine, getInjectionPolicy } from '
 export type { InjectionScan, InjectionThreat, InjectionPolicy, InjectionSeverity } from './prompt-injection.js';
 export { partitionTaskGraph } from './task-partition.js';
 export type { TaskDependency, TaskPartition } from './task-partition.js';
-export { solveLinearSystem, pageRank } from './sublinear.js';
-export type { LinearSolveResult, PageRankResult, MatrixInput, SparseEntry } from './sublinear.js';
+export { solveLinearSystem, pageRank, loadSublinearCore } from './sublinear.js';
+export type { LinearSolveResult, PageRankResult, PageRankOptions, PageRankEdge, MatrixInput, SparseEntry, SolveMethod, SublinearEngine } from './sublinear.js';
 export { applyAgentBoosterEdit, getAgentBoosterLibrary } from './agent-booster.js';
 export type { BoosterEditResult } from './agent-booster.js';
 export { OnnxWasmTextEmbedder, getOnnxWasmEmbedder, loadOnnxWasmModule, onnxWasmModelCached } from './onnx-wasm-embedder.js';

package/dist/integrations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvG,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAChH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC7H,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvG,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAChH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/J,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC7H,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/integrations/index.js

@@ -4,7 +4,7 @@
  */
 export { scanPromptInjection, promptInjectionEngine, getInjectionPolicy } from './prompt-injection.js';
 export { partitionTaskGraph } from './task-partition.js';
-export { solveLinearSystem, pageRank } from './sublinear.js';
+export { solveLinearSystem, pageRank, loadSublinearCore } from './sublinear.js';
 export { applyAgentBoosterEdit, getAgentBoosterLibrary } from './agent-booster.js';
 export { OnnxWasmTextEmbedder, getOnnxWasmEmbedder, loadOnnxWasmModule, onnxWasmModelCached } from './onnx-wasm-embedder.js';
 export { isOptionalInstalled } from './optional.js';

package/dist/integrations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEvG,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC7H,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/**\n * agentic-flow/integrations — programmatic access to the optional ruvnet\n * package integrations (each with a built-in fallback).\n */\n\nexport { scanPromptInjection, promptInjectionEngine, getInjectionPolicy } from './prompt-injection.js';\nexport type { InjectionScan, InjectionThreat, InjectionPolicy, InjectionSeverity } from './prompt-injection.js';\nexport { partitionTaskGraph } from './task-partition.js';\nexport type { TaskDependency, TaskPartition } from './task-partition.js';\nexport { solveLinearSystem, pageRank } from './sublinear.js';\nexport type { LinearSolveResult, PageRankResult, MatrixInput, SparseEntry } from './sublinear.js';\nexport { applyAgentBoosterEdit, getAgentBoosterLibrary } from './agent-booster.js';\nexport type { BoosterEditResult } from './agent-booster.js';\nexport { OnnxWasmTextEmbedder, getOnnxWasmEmbedder, loadOnnxWasmModule, onnxWasmModelCached } from './onnx-wasm-embedder.js';\nexport { isOptionalInstalled } from './optional.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEvG,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC7H,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/**\n * agentic-flow/integrations — programmatic access to the optional ruvnet\n * package integrations (each with a built-in fallback).\n */\n\nexport { scanPromptInjection, promptInjectionEngine, getInjectionPolicy } from './prompt-injection.js';\nexport type { InjectionScan, InjectionThreat, InjectionPolicy, InjectionSeverity } from './prompt-injection.js';\nexport { partitionTaskGraph } from './task-partition.js';\nexport type { TaskDependency, TaskPartition } from './task-partition.js';\nexport { solveLinearSystem, pageRank, loadSublinearCore } from './sublinear.js';\nexport type { LinearSolveResult, PageRankResult, PageRankOptions, PageRankEdge, MatrixInput, SparseEntry, SolveMethod, SublinearEngine } from './sublinear.js';\nexport { applyAgentBoosterEdit, getAgentBoosterLibrary } from './agent-booster.js';\nexport type { BoosterEditResult } from './agent-booster.js';\nexport { OnnxWasmTextEmbedder, getOnnxWasmEmbedder, loadOnnxWasmModule, onnxWasmModelCached } from './onnx-wasm-embedder.js';\nexport { isOptionalInstalled } from './optional.js';\n"]}

package/dist/integrations/optional.d.ts

@@ -17,28 +17,16 @@
 export declare function requireOptional<T = any>(specifier: string): T | null;
 /**
  * Whether a package is installed, without loading it. ESM-only packages whose
- * exports map has no require/default condition (sublinear-time-solver) cannot
- * be require.resolve()d, but that error itself proves the package is there.
+ * exports map has no require/default condition cannot be require.resolve()d,
+ * but that error itself proves the package is there.
  */
 export declare function isOptionalInstalled(specifier: string): boolean;
 /** Asynchronously import an optional package (ESM or CJS), or return null. */
-export declare function importOptional<T = any>(specifier: string, options?: {
-    quietStdout?: boolean;
-}): Promise<T | null>;
+export declare function importOptional<T = any>(specifier: string): Promise<T | null>;
 /** Why the last load of `specifier` failed, if it did. */
 export declare function optionalLoadError(specifier: string): string | undefined;
 /** Resolve a package's entry file without loading it, or null if absent. */
 export declare function resolveOptional(specifier: string): string | null;
-/**
- * Run `fn` with `console.log`/`console.info` sent to stderr.
- *
- * The MCP stdio server speaks JSON-RPC over stdout, so a dependency that
- * prints a banner (sublinear-time-solver does, from `console.log`) would
- * corrupt the protocol stream. Only the console methods are patched — never
- * `process.stdout.write` — so a protocol frame written by the server while
- * `fn` is pending still reaches stdout.
- */
-export declare function withStdoutToStderr<T>(fn: () => Promise<T> | T): Promise<T>;
 /** Test hook: forget cached load results. */
 export declare function _resetOptionalCache(): void;
 //# sourceMappingURL=optional.d.ts.map

package/dist/integrations/optional.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optional.d.ts","sourceRoot":"","sources":["../../src/integrations/optional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAWpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO9D;AAED,8EAA8E;AAC9E,wBAAsB,cAAc,CAAC,CAAC,GAAG,GAAG,EAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAenB;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWhF;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}
+{"version":3,"file":"optional.d.ts","sourceRoot":"","sources":["../../src/integrations/optional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAWpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO9D;AAED,8EAA8E;AAC9E,wBAAsB,cAAc,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAalF;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/dist/integrations/optional.js

@@ -34,8 +34,8 @@ export function requireOptional(specifier) {
 }
 /**
  * Whether a package is installed, without loading it. ESM-only packages whose
- * exports map has no require/default condition (sublinear-time-solver) cannot
- * be require.resolve()d, but that error itself proves the package is there.
+ * exports map has no require/default condition cannot be require.resolve()d,
+ * but that error itself proves the package is there.
  */
 export function isOptionalInstalled(specifier) {
     try {
@@ -47,14 +47,12 @@ export function isOptionalInstalled(specifier) {
     }
 }
 /** Asynchronously import an optional package (ESM or CJS), or return null. */
-export async function importOptional(specifier, options = {}) {
+export async function importOptional(specifier) {
     let pending = asyncCache.get(specifier);
     if (!pending) {
         pending = (async () => {
             try {
-                const load = () => import(specifier);
-                const mod = options.quietStdout ? await withStdoutToStderr(load) : await load();
-                return { mod };
+                return { mod: await import(specifier) };
             }
             catch (err) {
                 return { mod: null, error: err?.message ?? String(err) };
@@ -77,28 +75,6 @@ export function resolveOptional(specifier) {
         return null;
     }
 }
-/**
- * Run `fn` with `console.log`/`console.info` sent to stderr.
- *
- * The MCP stdio server speaks JSON-RPC over stdout, so a dependency that
- * prints a banner (sublinear-time-solver does, from `console.log`) would
- * corrupt the protocol stream. Only the console methods are patched — never
- * `process.stdout.write` — so a protocol frame written by the server while
- * `fn` is pending still reaches stdout.
- */
-export async function withStdoutToStderr(fn) {
-    const originalLog = console.log;
-    const originalInfo = console.info;
-    console.log = (...args) => console.error(...args);
-    console.info = (...args) => console.error(...args);
-    try {
-        return await fn();
-    }
-    finally {
-        console.log = originalLog;
-        console.info = originalInfo;
-    }
-}
 /** Test hook: forget cached load results. */
 export function _resetOptionalCache() {
     syncCache.clear();

package/dist/integrations/optional.js.map

@@ -1 +1 @@
-{"version":3,"file":"optional.js","sourceRoot":"","sources":["../../src/integrations/optional.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Optional ecosystem packages — one place to load them.\n *\n * Every package loaded here is an `optionalDependency` of agentic-flow: npm\n * installs it by default, but it may be missing (`--omit=optional`, an\n * unsupported platform, a failed native build). Callers therefore always get\n * either the module or `null`, never a throw, and keep a built-in fallback.\n *\n * Two loaders:\n * - `requireOptional` is synchronous (createRequire) for CommonJS packages that\n *   must be usable from synchronous code paths (e.g. input validation).\n * - `importOptional` is asynchronous for ESM packages.\n *\n * Results (including \"not installed\") are cached per specifier.\n */\n\nimport { createRequire } from 'node:module';\n\nconst nodeRequire = createRequire(import.meta.url);\n\ntype CacheEntry = { mod: any | null; error?: string };\nconst syncCache = new Map<string, CacheEntry>();\nconst asyncCache = new Map<string, Promise<CacheEntry>>();\n\n/** Synchronously load a CommonJS optional package, or return null. */\nexport function requireOptional<T = any>(specifier: string): T | null {\n  const cached = syncCache.get(specifier);\n  if (cached) return cached.mod as T | null;\n  let entry: CacheEntry;\n  try {\n    entry = { mod: nodeRequire(specifier) };\n  } catch (err: any) {\n    entry = { mod: null, error: err?.message ?? String(err) };\n  }\n  syncCache.set(specifier, entry);\n  return entry.mod as T | null;\n}\n\n/**\n * Whether a package is installed, without loading it. ESM-only packages whose\n * exports map has no require/default condition (sublinear-time-solver) cannot\n * be require.resolve()d, but that error itself proves the package is there.\n */\nexport function isOptionalInstalled(specifier: string): boolean {\n  try {\n    nodeRequire.resolve(specifier);\n    return true;\n  } catch (err: any) {\n    return err?.code === 'ERR_PACKAGE_PATH_NOT_EXPORTED';\n  }\n}\n\n/** Asynchronously import an optional package (ESM or CJS), or return null. */\nexport async function importOptional<T = any>(\n  specifier: string,\n  options: { quietStdout?: boolean } = {},\n): Promise<T | null> {\n  let pending = asyncCache.get(specifier);\n  if (!pending) {\n    pending = (async (): Promise<CacheEntry> => {\n      try {\n        const load = () => import(specifier);\n        const mod = options.quietStdout ? await withStdoutToStderr(load) : await load();\n        return { mod };\n      } catch (err: any) {\n        return { mod: null, error: err?.message ?? String(err) };\n      }\n    })();\n    asyncCache.set(specifier, pending);\n  }\n  return (await pending).mod as T | null;\n}\n\n/** Why the last load of `specifier` failed, if it did. */\nexport function optionalLoadError(specifier: string): string | undefined {\n  return syncCache.get(specifier)?.error;\n}\n\n/** Resolve a package's entry file without loading it, or null if absent. */\nexport function resolveOptional(specifier: string): string | null {\n  try {\n    return nodeRequire.resolve(specifier);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Run `fn` with `console.log`/`console.info` sent to stderr.\n *\n * The MCP stdio server speaks JSON-RPC over stdout, so a dependency that\n * prints a banner (sublinear-time-solver does, from `console.log`) would\n * corrupt the protocol stream. Only the console methods are patched — never\n * `process.stdout.write` — so a protocol frame written by the server while\n * `fn` is pending still reaches stdout.\n */\nexport async function withStdoutToStderr<T>(fn: () => Promise<T> | T): Promise<T> {\n  const originalLog = console.log;\n  const originalInfo = console.info;\n  console.log = (...args: unknown[]) => console.error(...args);\n  console.info = (...args: unknown[]) => console.error(...args);\n  try {\n    return await fn();\n  } finally {\n    console.log = originalLog;\n    console.info = originalInfo;\n  }\n}\n\n/** Test hook: forget cached load results. */\nexport function _resetOptionalCache(): void {\n  syncCache.clear();\n  asyncCache.clear();\n}\n"]}
+{"version":3,"file":"optional.js","sourceRoot":"","sources":["../../src/integrations/optional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAGnD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;AAChD,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAC;AAE1D,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAU,SAAiB;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,GAAe,CAAC;IAC1C,IAAI,KAAiB,CAAC;IACtB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5D,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,GAAe,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,IAAI,CAAC;QACH,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,GAAG,EAAE,IAAI,KAAK,+BAA+B,CAAC;IACvD,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAU,SAAiB;IAC7D,IAAI,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,KAAK,IAAyB,EAAE;YACzC,IAAI,CAAC;gBACH,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3D,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,MAAM,OAAO,CAAC,CAAC,GAAe,CAAC;AACzC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;AACzC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,mBAAmB;IACjC,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,UAAU,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC","sourcesContent":["/**\n * Optional ecosystem packages — one place to load them.\n *\n * Every package loaded here is an `optionalDependency` of agentic-flow: npm\n * installs it by default, but it may be missing (`--omit=optional`, an\n * unsupported platform, a failed native build). Callers therefore always get\n * either the module or `null`, never a throw, and keep a built-in fallback.\n *\n * Two loaders:\n * - `requireOptional` is synchronous (createRequire) for CommonJS packages that\n *   must be usable from synchronous code paths (e.g. input validation).\n * - `importOptional` is asynchronous for ESM packages.\n *\n * Results (including \"not installed\") are cached per specifier.\n */\n\nimport { createRequire } from 'node:module';\n\nconst nodeRequire = createRequire(import.meta.url);\n\ntype CacheEntry = { mod: any | null; error?: string };\nconst syncCache = new Map<string, CacheEntry>();\nconst asyncCache = new Map<string, Promise<CacheEntry>>();\n\n/** Synchronously load a CommonJS optional package, or return null. */\nexport function requireOptional<T = any>(specifier: string): T | null {\n  const cached = syncCache.get(specifier);\n  if (cached) return cached.mod as T | null;\n  let entry: CacheEntry;\n  try {\n    entry = { mod: nodeRequire(specifier) };\n  } catch (err: any) {\n    entry = { mod: null, error: err?.message ?? String(err) };\n  }\n  syncCache.set(specifier, entry);\n  return entry.mod as T | null;\n}\n\n/**\n * Whether a package is installed, without loading it. ESM-only packages whose\n * exports map has no require/default condition cannot be require.resolve()d,\n * but that error itself proves the package is there.\n */\nexport function isOptionalInstalled(specifier: string): boolean {\n  try {\n    nodeRequire.resolve(specifier);\n    return true;\n  } catch (err: any) {\n    return err?.code === 'ERR_PACKAGE_PATH_NOT_EXPORTED';\n  }\n}\n\n/** Asynchronously import an optional package (ESM or CJS), or return null. */\nexport async function importOptional<T = any>(specifier: string): Promise<T | null> {\n  let pending = asyncCache.get(specifier);\n  if (!pending) {\n    pending = (async (): Promise<CacheEntry> => {\n      try {\n        return { mod: await import(specifier) };\n      } catch (err: any) {\n        return { mod: null, error: err?.message ?? String(err) };\n      }\n    })();\n    asyncCache.set(specifier, pending);\n  }\n  return (await pending).mod as T | null;\n}\n\n/** Why the last load of `specifier` failed, if it did. */\nexport function optionalLoadError(specifier: string): string | undefined {\n  return syncCache.get(specifier)?.error;\n}\n\n/** Resolve a package's entry file without loading it, or null if absent. */\nexport function resolveOptional(specifier: string): string | null {\n  try {\n    return nodeRequire.resolve(specifier);\n  } catch {\n    return null;\n  }\n}\n\n/** Test hook: forget cached load results. */\nexport function _resetOptionalCache(): void {\n  syncCache.clear();\n  asyncCache.clear();\n}\n"]}

package/dist/integrations/sublinear.d.ts

@@ -1,21 +1,19 @@
 /**
- * Linear solves and PageRank through `sublinear-time-solver`, verified.
+ * Linear solves and PageRank through `@ruvnet/sublinear-core`, verified.
  *
- * sublinear-time-solver (optionalDependency, ~120 MB installed with its own
- * deps) solves diagonally dominant systems with push / random-walk methods.
- * Measured against 1.7.2: `forward-push` is accurate, but the default
- * `neumann` method returned a wrong answer with `converged: false` and
- * `random-walk` threw, and the package logs banners with `console.log`. So:
- * - only `forward-push` is used;
- * - every answer is checked against the residual ||Mx - b||_inf here, and a
- *   built-in Gauss-Seidel solve replaces it when the check fails;
- * - the import, construction and solve run with console output sent to stderr
- *   (the MCP stdio server owns stdout).
+ * @ruvnet/sublinear-core (optionalDependency, zero dependencies, ~220 kB) is
+ * the embeddable core of sublinear-time-solver: sparse iterative solvers
+ * (Gauss-Seidel, conjugate gradient, Jacobi, Neumann), PageRank, personalized
+ * PageRank and local forward push. It reports the residual of the x it
+ * returns, but every answer is still checked here against ||Mx - b||_inf, and
+ * a built-in Gauss-Seidel solve replaces it when the check fails or the
+ * package is not installed.
  *
  * The 5 bundled `sublinear/*` agents name sublinear-time-solver tools; the
  * `sublinear_solve` / `sublinear_pagerank` MCP tools in this package give them
  * a working in-process path without a separate MCP server.
  */
+export declare const SUBLINEAR_CORE = "@ruvnet/sublinear-core";
 export interface SparseEntry {
     row: number;
     col: number;
@@ -25,47 +23,77 @@ export type MatrixInput = number[][] | {
     size: number;
     entries: SparseEntry[];
 };
+export type SolveMethod = 'auto' | 'gauss-seidel' | 'conjugate-gradient' | 'jacobi' | 'neumann';
+export type SublinearEngine = 'sublinear-core' | 'builtin';
 export interface LinearSolveResult {
     solution: number[];
-    /** max_i |(Mx - b)_i| */
+    /** max_i |(Mx - b)_i|, recomputed here from the returned solution. */
     residual: number;
     converged: boolean;
     iterations: number;
     diagonallyDominant: boolean;
-    engine: 'sublinear-time-solver' | 'builtin';
+    engine: SublinearEngine;
+    /** Method that produced the solution. */
+    method: Exclude<SolveMethod, 'auto'>;
     /** Set when the library answered but failed verification. */
     libraryRejected?: string;
 }
+/** The core module, or null when it is not installed. */
+export declare function loadSublinearCore(): Promise<any | null>;
 /**
- * Solve Mx = b. Intended for (row) diagonally dominant M; other matrices are
- * attempted with Gauss-Seidel and reported with `converged: false` if it fails.
+ * Solve Mx = b. Intended for (row) diagonally dominant or symmetric positive
+ * definite M; other matrices are attempted with Gauss-Seidel and reported with
+ * `converged: false` if it fails.
  */
 export declare function solveLinearSystem(matrix: MatrixInput, b: number[], options?: {
     tolerance?: number;
     maxIterations?: number;
+    method?: SolveMethod;
     engine?: 'auto' | 'builtin';
 }): Promise<LinearSolveResult>;
+export interface PageRankEdge {
+    from: string;
+    to: string;
+    weight?: number;
+}
+export interface PageRankOptions {
+    /** Probability of following an out-edge (1 - restart probability). Default 0.85. */
+    damping?: number;
+    /** Extra nodes with no edges. */
+    nodes?: string[];
+    /** Personalized PageRank: restart at these nodes (equal weight) or by weight. */
+    seeds?: string[] | Record<string, number>;
+    /**
+     * With `seeds`: estimate by local forward push instead of power iteration.
+     * Work depends on `epsilon`, not on the graph size; scores of nodes far from
+     * the seeds are left at 0 and `residualMass` bounds the total L1 error.
+     */
+    approximate?: boolean;
+    /** Forward-push residual threshold. Default 1e-6. */
+    epsilon?: number;
+    /** Return only the top N in `ranking` (and `scores`, for approximate runs). */
+    top?: number;
+    engine?: 'auto' | 'builtin';
+}
 export interface PageRankResult {
     scores: Record<string, number>;
     ranking: Array<{
         node: string;
         score: number;
     }>;
-    engine: LinearSolveResult['engine'];
+    engine: SublinearEngine;
+    method: 'power-iteration' | 'forward-push' | 'gauss-seidel';
+    personalized: boolean;
+    /** Linear-system residual (gauss-seidel) or last L1 change (power iteration). */
     residual: number;
+    /** forward-push only: unpushed mass, an upper bound on the total L1 error. */
+    residualMass?: number;
+    /** Set when the library answered but failed verification. */
+    libraryRejected?: string;
 }
 /**
- * PageRank over a directed graph as a linear system:
- * (I - d·Pᵀ) y = 1, then scores = y / Σy. With dangling rows left at zero this
- * equals PageRank with uniform teleport from dangling nodes.
+ * PageRank over a directed graph, or personalized PageRank from `seeds`.
+ * Scores sum to 1 (approximate runs: to 1 - residualMass).
  */
-export declare function pageRank(edges: Array<{
-    from: string;
-    to: string;
-    weight?: number;
-}>, options?: {
-    damping?: number;
-    nodes?: string[];
-    engine?: 'auto' | 'builtin';
-}): Promise<PageRankResult>;
+export declare function pageRank(edges: PageRankEdge[], options?: PageRankOptions): Promise<PageRankResult>;
 //# sourceMappingURL=sublinear.d.ts.map

package/dist/integrations/sublinear.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sublinear.d.ts","sourceRoot":"","sources":["../../src/integrations/sublinear.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,EAAE,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC5C,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsGD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,CAAC,EAAE,MAAM,EAAE,EACX,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GACxF,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC3D,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GAChF,OAAO,CAAC,cAAc,CAAC,CA8CzB"}
+{"version":3,"file":"sublinear.d.ts","sourceRoot":"","sources":["../../src/integrations/sublinear.ts"],"names":[],"mappings":"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"}