@xandout/libra-harness 0.1.8

package/dist/extras/extensions/otel/jsonl-span-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-span-exporter.js","sourceRoot":"","sources":["../../../../src/extras/extensions/otel/jsonl-span-exporter.ts"],"names":[],"mappings":"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"}

package/dist/extras/extensions/scripts/extension.d.ts

@@ -0,0 +1,180 @@
+import type { Extension } from '../../../extension.js';
+/**
+ * A registered data-processing script, persisted to disk.
+ */
+export interface ScriptRecord {
+    /** Unique script name (also the on-disk filename stem). */
+    name: string;
+    /** Human-readable description of what the script does. */
+    description: string;
+    /** JavaScript source — the body of a function that receives `input`. */
+    code: string;
+    /** ISO timestamp of creation. */
+    createdAt: string;
+    /** ISO timestamp of last update. */
+    updatedAt: string;
+}
+/**
+ * Result of running a script.
+ */
+export interface ScriptRunResult {
+    /** Whether execution succeeded. */
+    ok: boolean;
+    /** The script's return value (JSON-serialized), or an error message. */
+    output: string;
+    /** Elapsed wall-clock time in milliseconds. */
+    elapsedMs: number;
+    /** When `outputPath` was used, the path the result was written to. */
+    outputPath?: string;
+}
+/**
+ * Result of a single stage within a pipeline run.
+ */
+export interface PipelineStageResult {
+    /** Script name for this stage. */
+    name: string;
+    /** Whether this stage succeeded. */
+    ok: boolean;
+    /** Elapsed wall-clock time in milliseconds. */
+    elapsedMs: number;
+    /** Inline output preview (truncated to `maxOutputChars`). */
+    output: string;
+    /** Error message when `ok` is false. */
+    error?: string;
+}
+/**
+ * Result of running a pipeline of scripts.
+ *
+ * Each stage receives the previous stage's return value as its `input`.
+ * If any stage fails, the pipeline stops — `ok` is false and `output`
+ * contains the error from the failing stage. `stages` always contains
+ * one entry per stage that was attempted.
+ */
+export interface PipelineResult {
+    /** Whether every stage succeeded. */
+    ok: boolean;
+    /** Final output (JSON-serialized), or the error from the failed stage. */
+    output: string;
+    /** Total elapsed wall-clock time in milliseconds. */
+    elapsedMs: number;
+    /** Per-stage results, in execution order. */
+    stages: PipelineStageResult[];
+    /** When `outputPath` was used, the path the final result was written to. */
+    outputPath?: string;
+}
+/**
+ * Filesystem helper surface the scripts extension reuses. This matches
+ * the shape exposed by the `filesystem` extension, so the same sandboxed
+ * directories used by the filesystem and slack-files extensions can be
+ * used to pass data to/from scripts by disk path.
+ */
+export interface FsHelper {
+    /** Resolve a sandbox-relative path to an absolute path (throws on traversal). */
+    resolvePath(path: string): string;
+    /** Save raw bytes to a sandbox. Returns the full sandbox-prefixed path. */
+    saveBytes(path: string, data: Buffer, mimetype?: string): string;
+}
+/**
+ * Configuration for {@link createScriptsExtension}.
+ */
+export interface ScriptsConfig {
+    /**
+     * Directory where registered scripts are persisted (one JSON file per
+     * script). Created if it doesn't exist. Required.
+     */
+    registryDir: string;
+    /**
+     * The filesystem extension helper, to allow scripts to read input
+     * from and write output to the sandboxed directories. When provided,
+     * {@link allowedFsDirs} gates which sandbox directory names may be
+     * used for `inputPath` / `outputPath`.
+     */
+    fs?: FsHelper;
+    /**
+     * Sandbox directory names (as configured on the filesystem extension)
+     * that scripts are allowed to read from / write to via `inputPath` /
+     * `outputPath`. Required when `fs` is provided and disk paths are
+     * used. Example: `['slack-files', 'documents']`.
+     */
+    allowedFsDirs?: string[];
+    /**
+     * Absolute parent paths allowed for direct disk reads/writes when no
+     * `fs` helper is configured. Paths supplied via `inputPath` /
+     * `outputPath` must resolve within one of these. Use this for
+     * standalone deployments without the filesystem extension.
+     */
+    allowedDirs?: string[];
+    /**
+     * Max size of an input file read from disk (bytes). Default: 10MB.
+     */
+    maxInputBytes?: number;
+    /**
+     * Max chars of script output returned inline to the agent. Output
+     * longer than this is truncated (and, if `outputPath` is given,
+     * written to disk in full). Default: 50000.
+     */
+    maxOutputChars?: number;
+    /**
+     * QuickJS memory limit in bytes. Default: 128MB.
+     */
+    memoryLimitBytes?: number;
+    /**
+     * Execution deadline in milliseconds. Scripts that run longer are
+     * interrupted. Default: 5000.
+     */
+    interruptMs?: number;
+    /**
+     * Tool name prefix. Default: 'script'.
+     */
+    toolPrefix?: string;
+}
+/**
+ * Create a scripts extension that implements a durable, on-disk script
+ * registry and a focused tool interface for agents to write their own
+ * data-processing scripts.
+ *
+ * Scripts are JavaScript functions (written as the function body) that
+ * receive an `input` value and return a JSON-serializable result. They
+ * are executed in a sandboxed QuickJS WASM runtime with a memory limit
+ * and execution deadline, so agent-authored code cannot access the
+ * host process, filesystem, or network.
+ *
+ * Data can be passed to a script either:
+ * - inline, via the `input` argument (any JSON value), or
+ * - by disk path, via `inputPath` (the file is read and parsed).
+ *
+ * Disk path access is gated by an allowlist. When the `filesystem`
+ * extension is provided via {@link ScriptsConfig.fs}, paths are
+ * sandbox-relative (e.g. `"slack-files/data.json"`) and only the
+ * sandbox directory names listed in {@link ScriptsConfig.allowedFsDirs}
+ * are permitted — the same sandboxes the filesystem and slack-files
+ * extensions use. Without `fs`, {@link ScriptsConfig.allowedDirs}
+ * gates absolute parent paths.
+ *
+ * Scripts are persisted as JSON files under {@link ScriptsConfig.registryDir}
+ * and survive across sessions and process restarts.
+ *
+ * Tools provided (prefix defaults to `script`):
+ * - `script_save` — create or update a named script
+ * - `script_list` — list registered scripts
+ * - `script_get` — view a script's source and description
+ * - `script_delete` — remove a script
+ * - `script_run` — execute a script by name with inline or disk input
+ * - `script_pipeline` — run a chain of scripts, feeding each stage's
+ *   output into the next stage's input
+ */
+export default function createScriptsExtension(config: ScriptsConfig): Extension & {
+    /** Run a registered script by name with a given input value. */
+    runScript(name: string, input: unknown, opts?: {
+        outputPath?: string;
+    }): Promise<ScriptRunResult>;
+    /** Run a pipeline of scripts, chaining each stage's output to the next. */
+    runPipeline(stages: string[], input: unknown, opts?: {
+        outputPath?: string;
+    }): Promise<PipelineResult>;
+    /** Read a script record from the registry. */
+    getScript(name: string): ScriptRecord | undefined;
+    /** List all registered scripts. */
+    listScripts(): ScriptRecord[];
+};
+//# sourceMappingURL=extension.d.ts.map

package/dist/extras/extensions/scripts/extension.d.ts.map

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