@hassangameryt/freeflow 0.3.0 → 0.5.0

package/router/dist/routing/run-reducers.js

@@ -1,110 +1,122 @@
 import { byteLength, countLines } from "../evidence/evidence.js";
 import { selectProcessingReducer } from "../processing/reducers.js";
 export function selectRunReducerRoute(options) {
-    if (options.preserve === "full") {
-        return { status: "not_selected", reason: "preserve=full requires exact command output routing." };
-    }
-    if (options.executionStatus !== "success") {
-        return { status: "not_selected", reason: "command did not succeed; preserve parser-selected failure evidence." };
-    }
-    if (options.hasFilters) {
-        return { status: "not_selected", reason: "declarative filters already define the routed command output." };
-    }
-    if (options.hasScriptFilter) {
-        return { status: "not_selected", reason: "scriptFilter already defines the routed command output." };
-    }
-    const source = reducerSourceText(options.stdout, options.stderr, options.combined);
-    if (source === undefined) {
-        return { status: "not_selected", reason: "mixed stdout/stderr success output stays near-raw to avoid hiding warnings." };
-    }
-    const selection = selectProcessingReducer({ text: source.text, ...(options.goal !== undefined ? { goal: options.goal } : {}) });
-    if (selection.status !== "selected") {
-        return { status: "not_selected", reason: selection.reason };
-    }
-    const goalText = (options.goal ?? "").toLowerCase();
-    const commandTextValue = commandText(options.command).toLowerCase();
-    const outputIsLarge = byteLength(source.text) > options.thresholds.largeOutputBytes || countLines(source.text) > options.thresholds.largeOutputLines;
-    const intentAllowsReducer = reducerIntentAllowsSelection(goalText, commandTextValue, selection.result.name);
-    const largeOutputAllowsReducer = outputIsLarge && reducerLargeOutputAllowsSelection(goalText, selection.result);
-    if (!largeOutputAllowsReducer && !intentAllowsReducer) {
-        return {
-            status: "not_selected",
-            reason: `Reducer ${selection.result.name}@${selection.result.version} matched, but neither output size nor reducer-oriented goal/command intent allowed automatic reduction.`,
-        };
-    }
+  if (options.preserve === "full") {
+    return { status: "not_selected", reason: "preserve=full requires exact command output routing." };
+  }
+  if (options.executionStatus !== "success") {
+    return { status: "not_selected", reason: "command did not succeed; preserve parser-selected failure evidence." };
+  }
+  if (options.hasFilters) {
+    return { status: "not_selected", reason: "declarative filters already define the routed command output." };
+  }
+  if (options.hasScriptFilter) {
+    return { status: "not_selected", reason: "scriptFilter already defines the routed command output." };
+  }
+  const source = reducerSourceText(options.stdout, options.stderr, options.combined);
+  if (source === undefined) {
     return {
-        status: "selected",
-        result: selection.result,
-        sourceStream: source.stream,
-        reason: `Selected ${selection.result.name}@${selection.result.version} reducer for successful command output (confidence=${selection.result.confidence.toFixed(2)}; ${largeOutputAllowsReducer ? "large output" : "goal/command intent"}).`,
+      status: "not_selected",
+      reason: "mixed stdout/stderr success output stays near-raw to avoid hiding warnings.",
     };
+  }
+  const selection = selectProcessingReducer({
+    text: source.text,
+    ...(options.goal !== undefined ? { goal: options.goal } : {}),
+  });
+  if (selection.status !== "selected") {
+    return { status: "not_selected", reason: selection.reason };
+  }
+  const goalText = (options.goal ?? "").toLowerCase();
+  const commandTextValue = commandText(options.command).toLowerCase();
+  const outputIsLarge =
+    byteLength(source.text) > options.thresholds.largeOutputBytes ||
+    countLines(source.text) > options.thresholds.largeOutputLines;
+  const intentAllowsReducer = reducerIntentAllowsSelection(goalText, commandTextValue, selection.result.name);
+  const largeOutputAllowsReducer = outputIsLarge && reducerLargeOutputAllowsSelection(goalText, selection.result);
+  if (!largeOutputAllowsReducer && !intentAllowsReducer) {
+    return {
+      status: "not_selected",
+      reason: `Reducer ${selection.result.name}@${selection.result.version} matched, but neither output size nor reducer-oriented goal/command intent allowed automatic reduction.`,
+    };
+  }
+  return {
+    status: "selected",
+    result: selection.result,
+    sourceStream: source.stream,
+    reason: `Selected ${selection.result.name}@${selection.result.version} reducer for successful command output (confidence=${selection.result.confidence.toFixed(2)}; ${largeOutputAllowsReducer ? "large output" : "goal/command intent"}).`,
+  };
 }
 export function reducerImportantLines(route) {
-    return [{
-            stream: route.sourceStream,
-            lines: lineRangeForText(route.result.visibleText),
-            excerpt: route.result.visibleText,
-        }];
+  return [
+    {
+      stream: route.sourceStream,
+      lines: lineRangeForText(route.result.visibleText),
+      excerpt: route.result.visibleText,
+    },
+  ];
 }
 export function parserWithReducer(parser, route) {
-    return {
-        ...parser,
-        name: `${parser.name}+reducer:${route.result.name}`,
-        confidence: Math.max(parser.confidence, route.result.confidence),
-        fidelity: "exact",
-        compressed: true,
-        counts: {
-            ...(parser.counts ?? {}),
-            reducerFacts: route.result.facts.length,
-        },
-    };
+  return {
+    ...parser,
+    name: `${parser.name}+reducer:${route.result.name}`,
+    confidence: Math.max(parser.confidence, route.result.confidence),
+    fidelity: "exact",
+    compressed: true,
+    counts: {
+      ...(parser.counts ?? {}),
+      reducerFacts: route.result.facts.length,
+    },
+  };
 }
 function reducerSourceText(stdout, stderr, combined) {
-    if (stdout.length > 0 && stderr.length === 0) {
-        return { stream: "stdout", text: stdout };
-    }
-    if (stderr.length > 0 && stdout.length === 0) {
-        return { stream: "stderr", text: stderr };
-    }
-    if (stdout.length === 0 && stderr.length === 0 && combined.length > 0) {
-        return { stream: "combined", text: combined };
-    }
-    return undefined;
+  if (stdout.length > 0 && stderr.length === 0) {
+    return { stream: "stdout", text: stdout };
+  }
+  if (stderr.length > 0 && stdout.length === 0) {
+    return { stream: "stderr", text: stderr };
+  }
+  if (stdout.length === 0 && stderr.length === 0 && combined.length > 0) {
+    return { stream: "combined", text: combined };
+  }
+  return undefined;
 }
 function reducerIntentAllowsSelection(goalText, commandTextValue, reducerName) {
-    switch (reducerName) {
-        case "test-output":
-            return /\b(test|tests|vitest|jest|pytest)\b/.test(goalText);
-        case "diagnostics":
-            return /\b(typecheck|type-check|tsc|lint|eslint|diagnostic)\b/.test(goalText);
-        case "build-output":
-            return /\b(build|compile|bundle|next)\b/.test(goalText);
-        case "access-log":
-            return /\b(log|logs|access|nginx|apache)\b/.test(goalText);
-        case "table":
-            return /\b(csv|json|table|analytics)\b/.test(goalText);
-        case "mcp-tools":
-            return /\b(mcp|tools?|schema|signatures?)\b/.test(goalText);
-        case "json-query":
-            return /\b(json|github|issues?|labels?|repo|repository|summary|summarize|summarise|analysis|analyze|analyse)\b/.test(goalText);
-        case "browser-snapshot":
-            return /\b(browser|snapshot|playwright|accessibility|dom)\b/.test(goalText);
-        case "git-log":
-            return /\b(git\s+log|commits?|history|changelog)\b/.test(goalText) || /\bgit\s+log\b/.test(commandTextValue);
-        default:
-            return false;
-    }
+  switch (reducerName) {
+    case "test-output":
+      return /\b(test|tests|vitest|jest|pytest)\b/.test(goalText);
+    case "diagnostics":
+      return /\b(typecheck|type-check|tsc|lint|eslint|diagnostic)\b/.test(goalText);
+    case "build-output":
+      return /\b(build|compile|bundle|next)\b/.test(goalText);
+    case "access-log":
+      return /\b(log|logs|access|nginx|apache)\b/.test(goalText);
+    case "table":
+      return /\b(csv|json|table|analytics)\b/.test(goalText);
+    case "mcp-tools":
+      return /\b(mcp|tools?|schema|signatures?)\b/.test(goalText);
+    case "json-query":
+      return /\b(json|github|issues?|labels?|repo|repository|summary|summarize|summarise|analysis|analyze|analyse)\b/.test(
+        goalText,
+      );
+    case "browser-snapshot":
+      return /\b(browser|snapshot|playwright|accessibility|dom)\b/.test(goalText);
+    case "git-log":
+      return /\b(git\s+log|commits?|history|changelog)\b/.test(goalText) || /\bgit\s+log\b/.test(commandTextValue);
+    default:
+      return false;
+  }
 }
 function reducerLargeOutputAllowsSelection(goalText, result) {
-    if (result.name === "json-query") {
-        return result.confidence >= 0.8;
-    }
-    return true;
+  if (result.name === "json-query") {
+    return result.confidence >= 0.8;
+  }
+  return true;
 }
 function lineRangeForText(text) {
-    const lines = Math.max(1, countLines(text));
-    return `1-${lines}`;
+  const lines = Math.max(1, countLines(text));
+  return `1-${lines}`;
 }
 function commandText(command) {
-    return typeof command === "string" ? command : command.join(" ");
+  return typeof command === "string" ? command : command.join(" ");
 }

package/router/dist/sandbox/adapter-roots.d.ts

@@ -1,38 +1,46 @@
 export declare const SCRIPT_TRANSFORM_ADAPTERS_HOME_ENV = "FREEFLOW_SCRIPT_TRANSFORM_ADAPTERS_HOME";
 export declare const SCRIPT_TRANSFORM_NODE_ENV = "FREEFLOW_SCRIPT_TRANSFORM_NODE";
 export declare const SCRIPT_TRANSFORM_ADAPTER_PACKAGES: {
-    readonly javascript: {
-        readonly packageName: "quickjs-wasi";
-        readonly version: "3.0.1";
-        readonly env: "FREEFLOW_QUICKJS_WASI_ROOT";
-    };
-    readonly jq: {
-        readonly packageName: "jq-wasm";
-        readonly version: "1.2.0-jq-1.8.2";
-        readonly env: "FREEFLOW_JQ_WASM_ROOT";
-    };
-    readonly python: {
-        readonly packageName: "@bsull/eryx";
-        readonly version: "0.5.0";
-        readonly env: "FREEFLOW_ERYX_ROOT";
-    };
+  readonly javascript: {
+    readonly packageName: "quickjs-wasi";
+    readonly version: "3.0.1";
+    readonly env: "FREEFLOW_QUICKJS_WASI_ROOT";
+  };
+  readonly jq: {
+    readonly packageName: "jq-wasm";
+    readonly version: "1.2.0-jq-1.8.2";
+    readonly env: "FREEFLOW_JQ_WASM_ROOT";
+  };
+  readonly python: {
+    readonly packageName: "@bsull/eryx";
+    readonly version: "0.5.0";
+    readonly env: "FREEFLOW_ERYX_ROOT";
+  };
 };
 export declare const SCRIPT_TRANSFORM_SUPPORT_PACKAGES: {
-    readonly node: {
-        readonly packageName: "node";
-        readonly version: "24";
-        readonly env: "FREEFLOW_SCRIPT_TRANSFORM_NODE";
-    };
+  readonly node: {
+    readonly packageName: "node";
+    readonly version: "24";
+    readonly env: "FREEFLOW_SCRIPT_TRANSFORM_NODE";
+  };
 };
 export type ScriptTransformAdapterLanguage = keyof typeof SCRIPT_TRANSFORM_ADAPTER_PACKAGES;
 export interface ScriptTransformAdapterRootCandidate {
-    packageRoot: string;
-    source: "env" | "global-cache";
-    envVar: string;
+  packageRoot: string;
+  source: "env" | "global-cache";
+  envVar: string;
 }
 export declare function defaultScriptTransformAdaptersHome(env?: NodeJS.ProcessEnv): string;
-export declare function defaultScriptTransformAdapterRoot(language: ScriptTransformAdapterLanguage, env?: NodeJS.ProcessEnv): string;
-export declare function resolveScriptTransformAdapterRoot(language: ScriptTransformAdapterLanguage, env?: NodeJS.ProcessEnv): Promise<ScriptTransformAdapterRootCandidate | null>;
+export declare function defaultScriptTransformAdapterRoot(
+  language: ScriptTransformAdapterLanguage,
+  env?: NodeJS.ProcessEnv,
+): string;
+export declare function resolveScriptTransformAdapterRoot(
+  language: ScriptTransformAdapterLanguage,
+  env?: NodeJS.ProcessEnv,
+): Promise<ScriptTransformAdapterRootCandidate | null>;
 export declare function defaultScriptTransformNodeBinary(env?: NodeJS.ProcessEnv): string;
-export declare function scriptTransformAdapterInstallSpecs(languages?: readonly ScriptTransformAdapterLanguage[]): string[];
+export declare function scriptTransformAdapterInstallSpecs(
+  languages?: readonly ScriptTransformAdapterLanguage[],
+): string[];
 export declare function scriptTransformAdapterEnvExports(home?: string): Record<string, string>;

package/router/dist/sandbox/adapter-roots.js

@@ -4,61 +4,63 @@ import { join } from "node:path";
 export const SCRIPT_TRANSFORM_ADAPTERS_HOME_ENV = "FREEFLOW_SCRIPT_TRANSFORM_ADAPTERS_HOME";
 export const SCRIPT_TRANSFORM_NODE_ENV = "FREEFLOW_SCRIPT_TRANSFORM_NODE";
 export const SCRIPT_TRANSFORM_ADAPTER_PACKAGES = {
-    javascript: { packageName: "quickjs-wasi", version: "3.0.1", env: "FREEFLOW_QUICKJS_WASI_ROOT" },
-    jq: { packageName: "jq-wasm", version: "1.2.0-jq-1.8.2", env: "FREEFLOW_JQ_WASM_ROOT" },
-    python: { packageName: "@bsull/eryx", version: "0.5.0", env: "FREEFLOW_ERYX_ROOT" },
+  javascript: { packageName: "quickjs-wasi", version: "3.0.1", env: "FREEFLOW_QUICKJS_WASI_ROOT" },
+  jq: { packageName: "jq-wasm", version: "1.2.0-jq-1.8.2", env: "FREEFLOW_JQ_WASM_ROOT" },
+  python: { packageName: "@bsull/eryx", version: "0.5.0", env: "FREEFLOW_ERYX_ROOT" },
 };
 export const SCRIPT_TRANSFORM_SUPPORT_PACKAGES = {
-    node: { packageName: "node", version: "24", env: SCRIPT_TRANSFORM_NODE_ENV },
+  node: { packageName: "node", version: "24", env: SCRIPT_TRANSFORM_NODE_ENV },
 };
 export function defaultScriptTransformAdaptersHome(env = process.env) {
-    return env[SCRIPT_TRANSFORM_ADAPTERS_HOME_ENV] || join(homedir(), ".cache", "freeflow-script-adapters");
+  return env[SCRIPT_TRANSFORM_ADAPTERS_HOME_ENV] || join(homedir(), ".cache", "freeflow-script-adapters");
 }
 export function defaultScriptTransformAdapterRoot(language, env = process.env) {
-    const packageName = SCRIPT_TRANSFORM_ADAPTER_PACKAGES[language].packageName;
-    return join(defaultScriptTransformAdaptersHome(env), "node_modules", ...packageName.split("/"));
+  const packageName = SCRIPT_TRANSFORM_ADAPTER_PACKAGES[language].packageName;
+  return join(defaultScriptTransformAdaptersHome(env), "node_modules", ...packageName.split("/"));
 }
 export async function resolveScriptTransformAdapterRoot(language, env = process.env) {
-    const adapter = SCRIPT_TRANSFORM_ADAPTER_PACKAGES[language];
-    const explicitRoot = env[adapter.env];
-    if (explicitRoot) {
-        return { packageRoot: explicitRoot, source: "env", envVar: adapter.env };
-    }
-    const packageRoot = defaultScriptTransformAdapterRoot(language, env);
-    if (await packageRootExists(packageRoot)) {
-        return { packageRoot, source: "global-cache", envVar: adapter.env };
-    }
-    return null;
+  const adapter = SCRIPT_TRANSFORM_ADAPTER_PACKAGES[language];
+  const explicitRoot = env[adapter.env];
+  if (explicitRoot) {
+    return { packageRoot: explicitRoot, source: "env", envVar: adapter.env };
+  }
+  const packageRoot = defaultScriptTransformAdapterRoot(language, env);
+  if (await packageRootExists(packageRoot)) {
+    return { packageRoot, source: "global-cache", envVar: adapter.env };
+  }
+  return null;
 }
 export function defaultScriptTransformNodeBinary(env = process.env) {
-    return env[SCRIPT_TRANSFORM_NODE_ENV] || join(defaultScriptTransformAdaptersHome(env), "node_modules", "node", "bin", "node");
+  return (
+    env[SCRIPT_TRANSFORM_NODE_ENV] ||
+    join(defaultScriptTransformAdaptersHome(env), "node_modules", "node", "bin", "node")
+  );
 }
 export function scriptTransformAdapterInstallSpecs(languages = ["javascript", "jq", "python"]) {
-    const specs = languages.map((language) => {
-        const adapter = SCRIPT_TRANSFORM_ADAPTER_PACKAGES[language];
-        return `${adapter.packageName}@${adapter.version}`;
-    });
-    if (languages.includes("python")) {
-        const node = SCRIPT_TRANSFORM_SUPPORT_PACKAGES.node;
-        specs.push(`${node.packageName}@${node.version}`);
-    }
-    return specs;
+  const specs = languages.map((language) => {
+    const adapter = SCRIPT_TRANSFORM_ADAPTER_PACKAGES[language];
+    return `${adapter.packageName}@${adapter.version}`;
+  });
+  if (languages.includes("python")) {
+    const node = SCRIPT_TRANSFORM_SUPPORT_PACKAGES.node;
+    specs.push(`${node.packageName}@${node.version}`);
+  }
+  return specs;
 }
 export function scriptTransformAdapterEnvExports(home = defaultScriptTransformAdaptersHome()) {
-    return {
-        [SCRIPT_TRANSFORM_ADAPTERS_HOME_ENV]: home,
-        [SCRIPT_TRANSFORM_ADAPTER_PACKAGES.javascript.env]: join(home, "node_modules", "quickjs-wasi"),
-        [SCRIPT_TRANSFORM_ADAPTER_PACKAGES.jq.env]: join(home, "node_modules", "jq-wasm"),
-        [SCRIPT_TRANSFORM_ADAPTER_PACKAGES.python.env]: join(home, "node_modules", "@bsull", "eryx"),
-        [SCRIPT_TRANSFORM_NODE_ENV]: join(home, "node_modules", "node", "bin", "node"),
-    };
+  return {
+    [SCRIPT_TRANSFORM_ADAPTERS_HOME_ENV]: home,
+    [SCRIPT_TRANSFORM_ADAPTER_PACKAGES.javascript.env]: join(home, "node_modules", "quickjs-wasi"),
+    [SCRIPT_TRANSFORM_ADAPTER_PACKAGES.jq.env]: join(home, "node_modules", "jq-wasm"),
+    [SCRIPT_TRANSFORM_ADAPTER_PACKAGES.python.env]: join(home, "node_modules", "@bsull", "eryx"),
+    [SCRIPT_TRANSFORM_NODE_ENV]: join(home, "node_modules", "node", "bin", "node"),
+  };
 }
 async function packageRootExists(packageRoot) {
-    try {
-        await access(join(packageRoot, "package.json"));
-        return true;
-    }
-    catch {
-        return false;
-    }
+  try {
+    await access(join(packageRoot, "package.json"));
+    return true;
+  } catch {
+    return false;
+  }
 }

package/router/dist/sandbox/eryx-python-adapter.d.ts

@@ -1,9 +1,13 @@
 import type { ScriptSandboxAdapter } from "./script-sandbox.js";
 export declare const ERYX_ROOT_ENV = "FREEFLOW_ERYX_ROOT";
 export interface EryxPythonSandboxAdapterOptions {
-    packageRoot: string;
-    id?: string;
-    version?: string;
+  packageRoot: string;
+  id?: string;
+  version?: string;
 }
-export declare function discoverEryxPythonSandboxAdaptersFromEnv(env?: NodeJS.ProcessEnv): Promise<ScriptSandboxAdapter[]>;
-export declare function createEryxPythonSandboxAdapter(options: EryxPythonSandboxAdapterOptions): Promise<ScriptSandboxAdapter>;
+export declare function discoverEryxPythonSandboxAdaptersFromEnv(
+  env?: NodeJS.ProcessEnv,
+): Promise<ScriptSandboxAdapter[]>;
+export declare function createEryxPythonSandboxAdapter(
+  options: EryxPythonSandboxAdapterOptions,
+): Promise<ScriptSandboxAdapter>;