@a5c-ai/babysitter-sdk 0.0.16

package/dist/cli/nodeTaskRunner.d.ts

@@ -0,0 +1,16 @@
+import { TaskDef } from "../tasks/types";
+import { RunNodeTaskOptions, RunNodeTaskResult } from "../runner/nodeRunner";
+import { CommitEffectResultArtifacts, ProcessLogger } from "../runtime/types";
+export interface CliRunNodeTaskOptions extends Omit<RunNodeTaskOptions, "task" | "hydration" | "baseEnv"> {
+    task?: TaskDef;
+    baseEnv?: NodeJS.ProcessEnv;
+    invocationKey?: string;
+    logger?: ProcessLogger;
+}
+export interface CliRunNodeTaskResult extends RunNodeTaskResult {
+    hydratedKeys: string[];
+    missingKeys: string[];
+    committed?: CommitEffectResultArtifacts;
+}
+export declare function runNodeTaskFromCli(options: CliRunNodeTaskOptions): Promise<CliRunNodeTaskResult>;
+//# sourceMappingURL=nodeTaskRunner.d.ts.map

package/dist/cli/nodeTaskRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeTaskRunner.d.ts","sourceRoot":"","sources":["../../src/cli/nodeTaskRunner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAiC,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACvG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,2BAA2B,CAAC;CACzC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4BtG"}

package/dist/cli/nodeTaskRunner.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runNodeTaskFromCli = runNodeTaskFromCli;
+const tasks_1 = require("../storage/tasks");
+const env_1 = require("../runner/env");
+const nodeRunner_1 = require("../runner/nodeRunner");
+async function runNodeTaskFromCli(options) {
+    const task = options.task ?? (await loadTaskDefinition(options.runDir, options.effectId));
+    const hydration = (0, env_1.hydrateCliNodeTaskEnv)(task, {
+        cleanEnv: options.cleanEnv,
+        envOverrides: options.envOverrides,
+        baseEnv: options.baseEnv ?? process.env,
+    });
+    const result = await (0, nodeRunner_1.runNodeTask)({
+        ...options,
+        task,
+        hydration,
+    });
+    let committed;
+    if (!options.dryRun) {
+        committed = await (0, nodeRunner_1.commitNodeResult)({
+            runDir: options.runDir,
+            effectId: options.effectId,
+            invocationKey: options.invocationKey ?? extractInvocationKey(task),
+            logger: options.logger,
+            result,
+        });
+    }
+    return {
+        ...result,
+        hydratedKeys: hydration.hydratedKeys,
+        missingKeys: hydration.missingKeys,
+        committed,
+    };
+}
+async function loadTaskDefinition(runDir, effectId) {
+    const def = await (0, tasks_1.readTaskDefinition)(runDir, effectId);
+    if (!def) {
+        throw new Error(`Task definition for effect ${effectId} is missing`);
+    }
+    return def;
+}
+function extractInvocationKey(task) {
+    const raw = task?.invocationKey;
+    return typeof raw === "string" && raw.trim().length > 0 ? raw : undefined;
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./runtime";
+export * from "./runtime/types";
+export * from "./storage";
+export * from "./storage/types";
+export * from "./tasks";
+export * from "./runner";
+export * from "./cli/nodeTaskRunner";
+export * from "./cli/main";
+export * from "./testing";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./runtime"), exports);
+__exportStar(require("./runtime/types"), exports);
+__exportStar(require("./storage"), exports);
+__exportStar(require("./storage/types"), exports);
+__exportStar(require("./tasks"), exports);
+__exportStar(require("./runner"), exports);
+__exportStar(require("./cli/nodeTaskRunner"), exports);
+__exportStar(require("./cli/main"), exports);
+__exportStar(require("./testing"), exports);

package/dist/runner/env.d.ts

@@ -0,0 +1,58 @@
+import { JsonRecord } from "../storage/types";
+import { TaskDef } from "../tasks/types";
+export interface NodeEnvHydrationOptions {
+    /**
+     * Env map already present on the TaskDef (safe, non-secret values).
+     */
+    nodeEnv?: Record<string, string | undefined>;
+    /**
+     * Task metadata containing the `redactedEnvKeys` array emitted by the node helper.
+     */
+    metadata?: JsonRecord;
+    /**
+     * Source environment to inherit values from (defaults to `process.env`).
+     */
+    baseEnv?: NodeJS.ProcessEnv;
+    /**
+     * Explicit overrides (e.g., CLI --env) that should win over `baseEnv` for hydrated keys.
+     */
+    overrides?: Record<string, string | undefined>;
+    /**
+     * When false, the returned env starts empty (aside from sanitized + hydrated keys).
+     * Redacted keys may still be sourced from `baseEnv`/`overrides` even if inheritance is disabled.
+     */
+    inheritProcessEnv?: boolean;
+}
+export interface NodeEnvHydrationResult {
+    env: Record<string, string>;
+    hydratedKeys: string[];
+    missingKeys: string[];
+}
+export interface ResolveNodeTaskEnvOptions extends Omit<NodeEnvHydrationOptions, "nodeEnv" | "metadata"> {
+    /**
+     * Optional metadata override; defaults to task.metadata.
+     */
+    metadata?: JsonRecord;
+}
+export interface CliHydratedEnvOptions {
+    /**
+     * When true, start from an empty env (aside from overrides and hydrated keys).
+     */
+    cleanEnv?: boolean;
+    /**
+     * Additional env pairs provided via CLI flags.
+     */
+    envOverrides?: Record<string, string | undefined>;
+    /**
+      * Base env for hydration (defaults to process.env).
+      */
+    baseEnv?: NodeJS.ProcessEnv;
+}
+/**
+ * Merge the sanitized TaskDef env map with any redacted keys pulled from the caller's environment.
+ */
+export declare function hydrateNodeTaskEnv(options?: NodeEnvHydrationOptions): NodeEnvHydrationResult;
+export declare function resolveNodeTaskEnv(task: TaskDef, options?: ResolveNodeTaskEnvOptions): NodeEnvHydrationResult;
+export declare function hydrateCliNodeTaskEnv(task: TaskDef, options?: CliHydratedEnvOptions): NodeEnvHydrationResult;
+export declare function extractRedactedEnvKeys(metadata?: JsonRecord): string[];
+//# sourceMappingURL=env.d.ts.map

package/dist/runner/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/runner/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,UAAU,CAAC;IACtG;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD;;QAEI;IACJ,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,uBAA4B,GAAG,sBAAsB,CAuChG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,yBAA8B,GAAG,sBAAsB,CASjH;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B,GAAG,sBAAsB,CAMhH;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAqBtE"}

package/dist/runner/env.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hydrateNodeTaskEnv = hydrateNodeTaskEnv;
+exports.resolveNodeTaskEnv = resolveNodeTaskEnv;
+exports.hydrateCliNodeTaskEnv = hydrateCliNodeTaskEnv;
+exports.extractRedactedEnvKeys = extractRedactedEnvKeys;
+/**
+ * Merge the sanitized TaskDef env map with any redacted keys pulled from the caller's environment.
+ */
+function hydrateNodeTaskEnv(options = {}) {
+    const inherit = options.inheritProcessEnv !== false;
+    const baseEnv = options.baseEnv ?? process.env;
+    const env = inherit ? cloneProcessEnv(baseEnv) : {};
+    if (options.nodeEnv) {
+        for (const [key, value] of Object.entries(options.nodeEnv)) {
+            if (!key || value === undefined || value === null)
+                continue;
+            env[key] = String(value);
+        }
+    }
+    const overrides = normalizeOverrides(options.overrides);
+    const metadataKeys = extractRedactedEnvKeys(options.metadata);
+    const hydratedKeys = [];
+    const missingKeys = [];
+    for (const key of metadataKeys) {
+        const overrideValue = overrides[key];
+        const sourceValue = overrideValue !== undefined ? overrideValue : baseEnv?.[key];
+        if (sourceValue === undefined) {
+            delete env[key];
+            missingKeys.push(key);
+            continue;
+        }
+        env[key] = sourceValue;
+        hydratedKeys.push(key);
+    }
+    for (const [key, value] of Object.entries(overrides)) {
+        if (!key)
+            continue;
+        env[key] = value;
+    }
+    return {
+        env,
+        hydratedKeys,
+        missingKeys,
+    };
+}
+function resolveNodeTaskEnv(task, options = {}) {
+    const metadata = options.metadata ?? task.metadata;
+    return hydrateNodeTaskEnv({
+        nodeEnv: task.node?.env,
+        metadata,
+        baseEnv: options.baseEnv,
+        overrides: options.overrides,
+        inheritProcessEnv: options.inheritProcessEnv,
+    });
+}
+function hydrateCliNodeTaskEnv(task, options = {}) {
+    return resolveNodeTaskEnv(task, {
+        baseEnv: options.baseEnv,
+        overrides: options.envOverrides,
+        inheritProcessEnv: options.cleanEnv ? false : true,
+    });
+}
+function extractRedactedEnvKeys(metadata) {
+    if (!metadata) {
+        return [];
+    }
+    const value = metadata["redactedEnvKeys"];
+    const raw = Array.isArray(value) ? value : [];
+    const seen = new Set();
+    const keys = [];
+    for (const entry of raw) {
+        if (typeof entry !== "string")
+            continue;
+        const key = entry.trim();
+        if (!key || seen.has(key))
+            continue;
+        seen.add(key);
+        keys.push(key);
+    }
+    keys.sort((a, b) => {
+        if (a < b)
+            return -1;
+        if (a > b)
+            return 1;
+        return 0;
+    });
+    return keys;
+}
+function cloneProcessEnv(source) {
+    if (!source) {
+        return {};
+    }
+    const env = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (!key || typeof value !== "string")
+            continue;
+        env[key] = value;
+    }
+    return env;
+}
+function normalizeOverrides(overrides) {
+    if (!overrides) {
+        return {};
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(overrides)) {
+        if (!key || value === undefined || value === null)
+            continue;
+        result[key] = String(value);
+    }
+    return result;
+}

package/dist/runner/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./env";
+export * from "./nodeRunner";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC"}

package/dist/runner/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./env"), exports);
+__exportStar(require("./nodeRunner"), exports);

package/dist/runner/nodeRunner.d.ts

@@ -0,0 +1,60 @@
+import { CommitEffectResultArtifacts, ProcessLogger } from "../runtime/types";
+import { TaskDef } from "../tasks/types";
+import { NodeEnvHydrationResult } from "./env";
+export interface NodeCommandDetails {
+    binary: string;
+    args: string[];
+    cwd: string;
+}
+export interface RunNodeTaskOptions {
+    runDir: string;
+    effectId: string;
+    task?: TaskDef;
+    workspaceRoot?: string;
+    nodeBinaryPath?: string;
+    envOverrides?: Record<string, string | undefined>;
+    cleanEnv?: boolean;
+    inheritProcessEnv?: boolean;
+    baseEnv?: NodeJS.ProcessEnv;
+    hydration?: NodeEnvHydrationResult;
+    timeoutMs?: number;
+    dryRun?: boolean;
+    onStdoutChunk?: (chunk: string) => void;
+    onStderrChunk?: (chunk: string) => void;
+}
+export interface RunNodeTaskResult {
+    task: TaskDef;
+    command: NodeCommandDetails;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    timedOut: boolean;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    timeoutMs: number;
+    output?: unknown;
+    io: ResolvedIoPaths;
+    hydrated: NodeEnvHydrationResult;
+}
+export declare class NodeTaskRunnerError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare function runNodeTask(options: RunNodeTaskOptions): Promise<RunNodeTaskResult>;
+export interface CommitNodeResultOptions {
+    runDir: string;
+    effectId: string;
+    invocationKey?: string;
+    logger?: ProcessLogger;
+    result: RunNodeTaskResult;
+}
+export declare function commitNodeResult(options: CommitNodeResultOptions): Promise<CommitEffectResultArtifacts>;
+export interface ResolvedIoPaths {
+    inputJsonPath: string;
+    outputJsonPath: string;
+    stdoutPath: string;
+    stderrPath: string;
+}
+//# sourceMappingURL=nodeRunner.d.ts.map

package/dist/runner/nodeRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeRunner.d.ts","sourceRoot":"","sources":["../../src/runner/nodeRunner.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAe,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAsB,MAAM,OAAO,CAAC;AAInE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC5B,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,eAAe,CAAC;IACpB,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aACC,IAAI,EAAE,MAAM;gBAA7C,OAAO,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM;CAI1D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwGzF;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAmC7G;AA8CD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}