@h-rig/run-worker 0.0.6-alpha.157 → 0.0.6-alpha.159

package/dist/src/host-kernel.d.ts

@@ -0,0 +1,22 @@
+import type { JournalCapability, TransportCapability } from "@rig/contracts";
+import type { CapabilityProviderPlugin } from "@rig/kernel-seed/plugin-abi";
+import { type DefaultKernelBootRecord } from "@rig/kernel-seed/boot-default";
+export type RunWorkerHydrationResult = {
+    readonly projectRoot: string;
+    readonly dotenvLoaded: boolean;
+    readonly configLoaded: boolean;
+    readonly errors: readonly string[];
+};
+export type RunWorkerHydrateProjectEnvOptions = {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly dotenvPath?: string;
+};
+export type AdoptRunWorkerKernelOptions = RunWorkerHydrateProjectEnvOptions & {
+    readonly entrypoint?: string;
+    readonly journal?: JournalCapability;
+    readonly transport?: TransportCapability;
+    readonly hydrateEnv?: boolean;
+};
+export declare function createRunWorkerPlacementTransportPlugin(transport: TransportCapability): CapabilityProviderPlugin;
+export declare function hydrateRunWorkerProjectEnv(projectRoot: string, options?: RunWorkerHydrateProjectEnvOptions): Promise<RunWorkerHydrationResult>;
+export declare function adoptRunWorkerKernel(root?: string, options?: AdoptRunWorkerKernelOptions): Promise<DefaultKernelBootRecord>;

package/dist/src/host-kernel.js

@@ -0,0 +1,78 @@
+// @bun
+// packages/run-worker/src/host-kernel.ts
+import { existsSync, readFileSync } from "fs";
+import { resolve } from "path";
+import { applyConfigEnv } from "@rig/core/config-env";
+import { loadConfig } from "@rig/core/load-config";
+import { bootDefaultKernelIntoProcess } from "@rig/kernel-seed/boot-default";
+import { createPlacementTransportPlugin } from "@rig/kernel-seed/default-kernel";
+function unquoteDotenvValue(value) {
+  const trimmed = value.trim();
+  if (trimmed.length >= 2 && (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+    return trimmed.slice(1, -1);
+  }
+  return trimmed;
+}
+function hydrateDotenv(path, env) {
+  if (!existsSync(path))
+    return false;
+  const source = readFileSync(path, "utf8");
+  for (const rawLine of source.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#"))
+      continue;
+    const assignment = line.startsWith("export ") ? line.slice("export ".length).trim() : line;
+    const equals = assignment.indexOf("=");
+    if (equals <= 0)
+      continue;
+    const key = assignment.slice(0, equals).trim();
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key) || env[key])
+      continue;
+    env[key] = unquoteDotenvValue(assignment.slice(equals + 1));
+  }
+  return true;
+}
+function createRunWorkerPlacementTransportPlugin(transport) {
+  return createPlacementTransportPlugin(transport);
+}
+async function hydrateRunWorkerProjectEnv(projectRoot, options = {}) {
+  const normalizedRoot = resolve(projectRoot);
+  const env = options.env ?? process.env;
+  const errors = [];
+  let dotenvLoaded = false;
+  let configLoaded = false;
+  try {
+    dotenvLoaded = hydrateDotenv(resolve(normalizedRoot, options.dotenvPath ?? ".env"), env);
+  } catch (error) {
+    errors.push(`dotenv: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  try {
+    applyConfigEnv(await loadConfig(normalizedRoot), env);
+    configLoaded = true;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (!message.includes("no rig.config"))
+      errors.push(`config: ${message}`);
+  }
+  return { projectRoot: normalizedRoot, dotenvLoaded, configLoaded, errors };
+}
+async function adoptRunWorkerKernel(root, options = {}) {
+  if (options.hydrateEnv === true && root !== undefined) {
+    await hydrateRunWorkerProjectEnv(root, options);
+  }
+  const bootInput = {
+    ...options.entrypoint !== undefined ? { entrypoint: options.entrypoint } : {},
+    ...options.journal !== undefined ? { journal: options.journal } : {}
+  };
+  if (options.transport === undefined)
+    return await bootDefaultKernelIntoProcess(bootInput);
+  return await bootDefaultKernelIntoProcess({
+    ...bootInput,
+    extraPlugins: [createRunWorkerPlacementTransportPlugin(options.transport)]
+  });
+}
+export {
+  hydrateRunWorkerProjectEnv,
+  createRunWorkerPlacementTransportPlugin,
+  adoptRunWorkerKernel
+};

package/dist/src/host.d.ts

@@ -0,0 +1,2 @@
+export { adoptRunWorkerKernel, createRunWorkerPlacementTransportPlugin, hydrateRunWorkerProjectEnv, type AdoptRunWorkerKernelOptions, type RunWorkerHydrateProjectEnvOptions, type RunWorkerHydrationResult, } from "./host-kernel";
+export { createRunJournal, sessionIdFromSessionFile, type JournalSessionProvider, type RunJournal, } from "./session-journal";

package/dist/src/host.js

@@ -0,0 +1,419 @@
+// @bun
+// packages/run-worker/src/host-kernel.ts
+import { existsSync, readFileSync } from "fs";
+import { resolve } from "path";
+import { applyConfigEnv } from "@rig/core/config-env";
+import { loadConfig } from "@rig/core/load-config";
+import { bootDefaultKernelIntoProcess } from "@rig/kernel-seed/boot-default";
+import { createPlacementTransportPlugin } from "@rig/kernel-seed/default-kernel";
+function unquoteDotenvValue(value) {
+  const trimmed = value.trim();
+  if (trimmed.length >= 2 && (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+    return trimmed.slice(1, -1);
+  }
+  return trimmed;
+}
+function hydrateDotenv(path, env) {
+  if (!existsSync(path))
+    return false;
+  const source = readFileSync(path, "utf8");
+  for (const rawLine of source.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#"))
+      continue;
+    const assignment = line.startsWith("export ") ? line.slice("export ".length).trim() : line;
+    const equals = assignment.indexOf("=");
+    if (equals <= 0)
+      continue;
+    const key = assignment.slice(0, equals).trim();
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key) || env[key])
+      continue;
+    env[key] = unquoteDotenvValue(assignment.slice(equals + 1));
+  }
+  return true;
+}
+function createRunWorkerPlacementTransportPlugin(transport) {
+  return createPlacementTransportPlugin(transport);
+}
+async function hydrateRunWorkerProjectEnv(projectRoot, options = {}) {
+  const normalizedRoot = resolve(projectRoot);
+  const env = options.env ?? process.env;
+  const errors = [];
+  let dotenvLoaded = false;
+  let configLoaded = false;
+  try {
+    dotenvLoaded = hydrateDotenv(resolve(normalizedRoot, options.dotenvPath ?? ".env"), env);
+  } catch (error) {
+    errors.push(`dotenv: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  try {
+    applyConfigEnv(await loadConfig(normalizedRoot), env);
+    configLoaded = true;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (!message.includes("no rig.config"))
+      errors.push(`config: ${message}`);
+  }
+  return { projectRoot: normalizedRoot, dotenvLoaded, configLoaded, errors };
+}
+async function adoptRunWorkerKernel(root, options = {}) {
+  if (options.hydrateEnv === true && root !== undefined) {
+    await hydrateRunWorkerProjectEnv(root, options);
+  }
+  const bootInput = {
+    ...options.entrypoint !== undefined ? { entrypoint: options.entrypoint } : {},
+    ...options.journal !== undefined ? { journal: options.journal } : {}
+  };
+  if (options.transport === undefined)
+    return await bootDefaultKernelIntoProcess(bootInput);
+  return await bootDefaultKernelIntoProcess({
+    ...bootInput,
+    extraPlugins: [createRunWorkerPlacementTransportPlugin(options.transport)]
+  });
+}
+// packages/run-worker/src/session-journal.ts
+import { Schema } from "effect";
+import {
+  CUSTOM_TYPE_FOR,
+  RIG_CONTROL_SENTINEL_END,
+  RIG_INBOX_RESOLUTION_SENTINEL,
+  RIG_PAUSE_SENTINEL,
+  RIG_RESUME_SENTINEL,
+  RIG_STOP_SENTINEL,
+  RIG_STOP_SENTINEL_END,
+  RIG_WORKFLOW_STATUS_CHANGED,
+  RunJournalEvent,
+  TYPE_FOR_CUSTOM
+} from "@rig/contracts";
+var decodeRunJournalEvent = Schema.decodeUnknownSync(RunJournalEvent);
+var RUN_STATUS_TRANSITIONS = {
+  created: ["queued", "preparing", "running", "failed", "stopped"],
+  queued: ["preparing", "running", "failed", "stopped"],
+  preparing: ["queued", "running", "needs-attention", "failed", "stopped"],
+  running: [
+    "queued",
+    "waiting-approval",
+    "waiting-user-input",
+    "paused",
+    "validating",
+    "reviewing",
+    "closing-out",
+    "needs-attention",
+    "completed",
+    "failed",
+    "stopped"
+  ],
+  "waiting-approval": ["running", "needs-attention", "failed", "stopped"],
+  "waiting-user-input": ["running", "needs-attention", "failed", "stopped"],
+  paused: ["running", "failed", "stopped"],
+  validating: ["running", "reviewing", "closing-out", "needs-attention", "completed", "failed", "stopped"],
+  reviewing: ["running", "validating", "closing-out", "needs-attention", "completed", "failed", "stopped"],
+  "closing-out": ["running", "needs-attention", "completed", "failed", "stopped"],
+  "needs-attention": ["queued", "preparing", "running", "closing-out", "completed", "failed", "stopped"],
+  completed: [],
+  failed: ["queued", "preparing", "running", "closing-out"],
+  stopped: ["queued", "preparing", "running", "closing-out"]
+};
+var TERMINAL_RUN_STATUSES = ["completed", "failed", "stopped"];
+function isTerminalRunStatus(status) {
+  return TERMINAL_RUN_STATUSES.includes(status);
+}
+function canTransitionRunStatus(from, to) {
+  if (from === null)
+    return true;
+  if (from === to)
+    return true;
+  return RUN_STATUS_TRANSITIONS[from].includes(to);
+}
+function assertRunStatusTransition(from, to) {
+  if (!canTransitionRunStatus(from, to)) {
+    throw new Error(`Illegal run status transition: ${from ?? "(none)"} -> ${to}. ` + `Allowed from ${from ?? "(none)"}: ${from ? RUN_STATUS_TRANSITIONS[from].join(", ") : "(any)"}.`);
+  }
+}
+function reduceRunJournal(events, runId = null) {
+  let record = {};
+  let status = null;
+  const statusHistory = [];
+  const pendingApprovals = new Map;
+  const resolvedApprovals = [];
+  const pendingUserInputs = new Map;
+  const resolvedUserInputs = [];
+  const closeoutPhases = [];
+  let resolvedPipeline = null;
+  const stageOutcomes = [];
+  const anomalies = [];
+  let steeringCount = 0;
+  let stallCount = 0;
+  let lastSeq = 0;
+  let lastEventAt = null;
+  const projectedRunId = runId ?? events[0]?.runId ?? null;
+  for (const event of events) {
+    lastSeq = event.seq;
+    lastEventAt = event.at;
+    switch (event.type) {
+      case "status-changed": {
+        if (!canTransitionRunStatus(status, event.to)) {
+          anomalies.push({ seq: event.seq, kind: "illegal-transition", detail: `${status ?? "(none)"} -> ${event.to}` });
+        }
+        statusHistory.push({ seq: event.seq, at: event.at, from: status, to: event.to, reason: event.reason ?? null });
+        const wasTerminal = status !== null && isTerminalRunStatus(status);
+        status = event.to;
+        record = { ...record, updatedAt: event.at };
+        if (isTerminalRunStatus(event.to) && !record.completedAt)
+          record = { ...record, completedAt: event.at };
+        if (!isTerminalRunStatus(event.to) && wasTerminal)
+          record = { ...record, completedAt: null };
+        if (event.to === "running" && !record.startedAt)
+          record = { ...record, startedAt: event.at };
+        break;
+      }
+      case "record-patch": {
+        const next = { ...record };
+        for (const [key, value] of Object.entries(event.patch)) {
+          if (value !== undefined)
+            next[key] = value;
+        }
+        next.updatedAt = event.patch.updatedAt ?? event.at;
+        record = next;
+        break;
+      }
+      case "approval-requested": {
+        pendingApprovals.set(event.requestId, {
+          requestId: event.requestId,
+          requestKind: event.requestKind,
+          actionId: event.actionId ?? null,
+          payload: event.payload,
+          requestedAt: event.at
+        });
+        break;
+      }
+      case "approval-resolved": {
+        const pending = pendingApprovals.get(event.requestId);
+        if (!pending) {
+          const alreadyResolved = resolvedApprovals.some((entry) => entry.requestId === event.requestId);
+          anomalies.push({ seq: event.seq, kind: alreadyResolved ? "duplicate-resolution" : "unknown-request", detail: `approval ${event.requestId}` });
+          break;
+        }
+        pendingApprovals.delete(event.requestId);
+        resolvedApprovals.push({ ...pending, decision: event.decision, note: event.note ?? null, actor: event.actor, resolvedAt: event.at });
+        break;
+      }
+      case "input-requested": {
+        pendingUserInputs.set(event.requestId, {
+          requestId: event.requestId,
+          requestKind: "user-input",
+          actionId: null,
+          payload: event.payload,
+          requestedAt: event.at
+        });
+        break;
+      }
+      case "input-resolved": {
+        const pending = pendingUserInputs.get(event.requestId);
+        if (!pending) {
+          const alreadyResolved = resolvedUserInputs.some((entry) => entry.requestId === event.requestId);
+          anomalies.push({ seq: event.seq, kind: alreadyResolved ? "duplicate-resolution" : "unknown-request", detail: `user-input ${event.requestId}` });
+          break;
+        }
+        pendingUserInputs.delete(event.requestId);
+        resolvedUserInputs.push({ ...pending, answers: event.answers, actor: event.actor, resolvedAt: event.at });
+        break;
+      }
+      case "steering":
+        steeringCount += 1;
+        break;
+      case "adopted":
+        record = { ...record, pid: event.pid, updatedAt: event.at };
+        break;
+      case "stall-detected":
+        stallCount += 1;
+        break;
+      case "closeout-phase":
+        closeoutPhases.push({ seq: event.seq, at: event.at, phase: event.phase, outcome: event.outcome, detail: event.detail ?? null });
+        break;
+      case "pipeline-resolved":
+        resolvedPipeline = event.pipeline;
+        break;
+      case "stage-outcome":
+        stageOutcomes.push({ seq: event.seq, at: event.at, outcome: event.outcome });
+        break;
+      case "timeline-entry":
+      case "log-entry":
+        break;
+    }
+  }
+  return {
+    runId: projectedRunId,
+    record,
+    status,
+    statusHistory,
+    pendingApprovals: [...pendingApprovals.values()],
+    resolvedApprovals,
+    pendingUserInputs: [...pendingUserInputs.values()],
+    resolvedUserInputs,
+    steeringCount,
+    stallCount,
+    closeoutPhases,
+    resolvedPipeline,
+    stageOutcomes,
+    lastSeq,
+    lastEventAt,
+    anomalies
+  };
+}
+function sessionIdFromSessionFile(sessionPath) {
+  if (!sessionPath)
+    return null;
+  const file = sessionPath.split(/[\\/]/).pop() ?? "";
+  const match = file.match(/_([0-9a-fA-F][0-9a-fA-F-]{7,})\.jsonl$/);
+  return match?.[1] ?? null;
+}
+function isRunSessionCustomType(customType) {
+  return customType !== undefined && Object.hasOwn(TYPE_FOR_CUSTOM, customType);
+}
+function foldRunSessionEntries(entries, runId) {
+  const events = [];
+  entries.forEach((entry, index) => {
+    if (entry.type !== "custom" || !isRunSessionCustomType(entry.customType))
+      return;
+    const data = entry.data !== null && typeof entry.data === "object" ? entry.data : {};
+    const stamped = {
+      v: 1,
+      seq: index + 1,
+      at: typeof data.at === "string" ? data.at : new Date(0).toISOString(),
+      runId,
+      ...data,
+      type: TYPE_FOR_CUSTOM[entry.customType]
+    };
+    try {
+      events.push(decodeRunJournalEvent(stamped));
+    } catch {}
+  });
+  return reduceRunJournal(events, runId);
+}
+function asCustomEntries(entries) {
+  return entries.filter((entry) => entry.type === "custom");
+}
+
+class RunSessionJournal {
+  sm;
+  runId;
+  constructor(sm, runId) {
+    this.sm = sm;
+    this.runId = runId;
+  }
+  #append(init) {
+    this.sm.appendCustomEntry(CUSTOM_TYPE_FOR[init.type], { ...init, at: new Date().toISOString() });
+  }
+  appendStatus(to, opts = {}) {
+    const from = foldRunSessionEntries(asCustomEntries(this.sm.getEntries()), this.runId).status;
+    if (!opts.force)
+      assertRunStatusTransition(from, to);
+    if (opts.errorText !== undefined)
+      this.#append({ type: "record-patch", patch: { errorText: opts.errorText } });
+    this.#append({
+      type: "status-changed",
+      from,
+      to,
+      ...opts.reason !== undefined ? { reason: opts.reason } : {},
+      ...opts.actor !== undefined ? { actor: opts.actor } : {}
+    });
+  }
+  appendTimeline(payload) {
+    this.#append({ type: "timeline-entry", payload });
+  }
+  appendCloseoutPhase(input) {
+    this.#append({
+      type: "closeout-phase",
+      phase: input.phase,
+      outcome: input.outcome,
+      ...input.detail !== undefined ? { detail: input.detail } : {}
+    });
+  }
+  appendApprovalResolved(input) {
+    this.#append({
+      type: "approval-resolved",
+      requestId: input.requestId,
+      decision: input.decision,
+      actor: input.actor,
+      ...input.note !== undefined ? { note: input.note } : {}
+    });
+  }
+  appendInputResolved(input) {
+    this.#append({ type: "input-resolved", requestId: input.requestId, answers: input.answers, actor: input.actor });
+  }
+  appendStall(input) {
+    this.#append({ type: "stall-detected", detail: input.detail });
+  }
+}
+function isRunJournalEventInit(event) {
+  if (event === null || typeof event !== "object")
+    return false;
+  const type = event.type;
+  return typeof type === "string" && Object.hasOwn(CUSTOM_TYPE_FOR, type);
+}
+function createJournalSessionProvider(options) {
+  const now = options.now ?? (() => new Date);
+  const appendRunEvent = async (event, runId = options.runId) => {
+    options.store.appendCustomEntry(CUSTOM_TYPE_FOR[event.type], { ...event, runId, at: now().toISOString() });
+  };
+  const readEntries = () => asCustomEntries(options.store.getEntries());
+  const entriesForRun = (runId) => readEntries().filter((entry) => {
+    const data = entry.data;
+    if (data === null || typeof data !== "object")
+      return runId === options.runId;
+    const candidate = data.runId;
+    return candidate === undefined ? runId === options.runId : candidate === runId;
+  });
+  return {
+    runId: options.runId,
+    async append(event) {
+      if (isRunJournalEventInit(event))
+        await appendRunEvent(event);
+    },
+    appendRunEvent,
+    async recordPipeline(runId, pipeline) {
+      await appendRunEvent({ type: "pipeline-resolved", pipeline }, runId);
+    },
+    async recordStageOutcome(runId, outcome) {
+      await appendRunEvent({ type: "stage-outcome", outcome }, runId);
+    },
+    async read(runId) {
+      return entriesForRun(runId);
+    },
+    readEntries,
+    readProjection: () => foldRunSessionEntries(entriesForRun(options.runId), options.runId)
+  };
+}
+async function createRunJournal(sessionManager, runId) {
+  try {
+    const writableSessionManager = sessionManager;
+    const journal = new RunSessionJournal(writableSessionManager, runId);
+    const kernel = createJournalSessionProvider({
+      runId,
+      store: {
+        appendCustomEntry: (customType, data) => writableSessionManager.appendCustomEntry(customType, data),
+        getEntries: () => sessionManager.getEntries?.() ?? sessionManager.getBranch?.() ?? []
+      }
+    });
+    return {
+      kernel,
+      appendStatus: journal.appendStatus.bind(journal),
+      appendTimeline: journal.appendTimeline.bind(journal),
+      appendCloseoutPhase: journal.appendCloseoutPhase.bind(journal),
+      appendApprovalResolved: journal.appendApprovalResolved.bind(journal),
+      appendInputResolved: journal.appendInputResolved.bind(journal),
+      appendStall: journal.appendStall.bind(journal)
+    };
+  } catch (error) {
+    console.warn(`[rig-run] RunSessionJournal unavailable; run-state arming deferred: ${error instanceof Error ? error.message : String(error)}`);
+    return null;
+  }
+}
+export {
+  sessionIdFromSessionFile,
+  hydrateRunWorkerProjectEnv,
+  createRunWorkerPlacementTransportPlugin,
+  createRunJournal,
+  adoptRunWorkerKernel
+};

package/dist/src/index.d.ts

@@ -1,8 +1,2 @@
 export { default, __rigExtensionTest, __rigRunWorkerTest } from "./extension";
 export * from "./plugin";
-export * from "./autohost";
-export * from "./constants";
-export * from "./journal";
-export * from "./panel-plugin";
-export * from "./notifications";
-export * from "./stall";