@h-rig/server 0.0.6-alpha.0

package/dist/src/server-helpers/run-steering.js

@@ -0,0 +1,176 @@
+// @bun
+// packages/server/src/server-helpers/run-steering.ts
+import { dirname as dirname2, resolve as resolve3 } from "path";
+import { existsSync, mkdirSync, readFileSync } from "fs";
+import { appendJsonlRecord as appendJsonlRecord2, readAuthorityRun as readAuthorityRun3, resolveAuthorityRunDir as resolveAuthorityRunDir3 } from "@rig/runtime/control-plane/authority-files";
+
+// packages/server/src/server-helpers/run-writers.ts
+import { resolve as resolve2 } from "path";
+import {
+  appendJsonlRecord,
+  readAuthorityRun as readAuthorityRun2,
+  resolveAuthorityRunDir as resolveAuthorityRunDir2,
+  writeJsonFile
+} from "@rig/runtime/control-plane/authority-files";
+
+// packages/server/src/server-helpers/normalizers.ts
+function normalizeString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+
+// packages/server/src/server-helpers/run-io.ts
+import { dirname, resolve } from "path";
+import {
+  listAuthorityRuns,
+  readAuthorityRun,
+  readJsonlFile,
+  resolveAuthorityRunDir
+} from "@rig/runtime/control-plane/authority-files";
+function runTimelinePath(projectRoot, runId) {
+  return resolve(resolveAuthorityRunDir(projectRoot, runId), "timeline.jsonl");
+}
+var INITIAL_RUN_LOG_TAIL_MAX_BYTES = 8 * 1024 * 1024;
+
+// packages/server/src/server-helpers/run-writers.ts
+function appendRunTimelineEntry(projectRoot, runId, value) {
+  if (!readAuthorityRun2(projectRoot, runId)) {
+    return;
+  }
+  appendJsonlRecord(runTimelinePath(projectRoot, runId), value);
+  patchRunRecord(projectRoot, runId, {});
+}
+function patchRunRecord(projectRoot, runId, patch) {
+  const current = readAuthorityRun2(projectRoot, runId);
+  if (!current) {
+    throw new Error(`Run not found: ${runId}`);
+  }
+  const next = {
+    ...current,
+    ...patch,
+    updatedAt: normalizeString(patch.updatedAt) ?? new Date().toISOString()
+  };
+  writeJsonFile(resolve2(resolveAuthorityRunDir2(projectRoot, runId), "run.json"), next);
+  return next;
+}
+
+// packages/server/src/server-helpers/run-steering.ts
+var steeringSequence = 0;
+function runSteeringPath(projectRoot, runId) {
+  return resolve3(resolveAuthorityRunDir3(projectRoot, runId), "steering.jsonl");
+}
+function readJsonl(path) {
+  if (!existsSync(path))
+    return [];
+  return readFileSync(path, "utf8").split(/\r?\n/).map((line) => line.trim()).filter(Boolean).flatMap((line) => {
+    try {
+      const value = JSON.parse(line);
+      return value && typeof value === "object" && !Array.isArray(value) ? [value] : [];
+    } catch {
+      return [];
+    }
+  });
+}
+function normalizeQueuedMessage(record) {
+  const id = typeof record.id === "string" ? record.id : null;
+  const runId = typeof record.runId === "string" ? record.runId : null;
+  const message = typeof record.message === "string" ? record.message : null;
+  if (!id || !runId || !message)
+    return null;
+  return {
+    id,
+    runId,
+    message,
+    actor: typeof record.actor === "string" ? record.actor : "operator",
+    createdAt: typeof record.createdAt === "string" ? record.createdAt : new Date().toISOString(),
+    delivered: record.delivered === true
+  };
+}
+function readQueuedRunSteeringMessages(projectRoot, runId) {
+  const latestById = new Map;
+  for (const record of readJsonl(runSteeringPath(projectRoot, runId))) {
+    const message = normalizeQueuedMessage(record);
+    if (message)
+      latestById.set(message.id, message);
+  }
+  return Array.from(latestById.values());
+}
+function markQueuedRunSteeringMessagesDelivered(projectRoot, runId, ids) {
+  const requested = new Set(ids.map((id) => id.trim()).filter(Boolean));
+  if (requested.size === 0)
+    return [];
+  const existing = readQueuedRunSteeringMessages(projectRoot, runId);
+  const deliveredAt = new Date().toISOString();
+  const path = runSteeringPath(projectRoot, runId);
+  const delivered = [];
+  for (const entry of existing) {
+    if (!requested.has(entry.id) || entry.delivered)
+      continue;
+    appendJsonlRecord2(path, { ...entry, delivered: true, deliveredAt });
+    delivered.push(entry.id);
+  }
+  if (delivered.length > 0) {
+    appendRunTimelineEntry(projectRoot, runId, {
+      id: `steering-ack:${runId}:${Date.now()}`,
+      type: "rig_bridge_event",
+      text: `Delivered ${delivered.length} steering message${delivered.length === 1 ? "" : "s"}`,
+      createdAt: deliveredAt,
+      state: "completed",
+      payload: { kind: "steering-delivered", messageIds: delivered }
+    });
+    patchRunRecord(projectRoot, runId, { latestSteeringDeliveredAt: deliveredAt });
+  }
+  return delivered;
+}
+function queueRunSteeringMessage(projectRoot, runId, input) {
+  const run = readAuthorityRun3(projectRoot, runId);
+  if (!run)
+    throw new Error(`Run not found: ${runId}`);
+  const text = input.message.trim();
+  if (!text)
+    throw new Error("message is required");
+  const createdAt = new Date().toISOString();
+  const entry = {
+    id: `steer:${runId}:${Date.now()}:${++steeringSequence}`,
+    runId,
+    message: text,
+    actor: input.actor?.trim() || "operator",
+    createdAt,
+    delivered: false
+  };
+  const path = runSteeringPath(projectRoot, runId);
+  mkdirSync(dirname2(path), { recursive: true });
+  appendJsonlRecord2(path, entry);
+  appendRunTimelineEntry(projectRoot, runId, {
+    id: entry.id,
+    type: "operator_message",
+    text,
+    createdAt,
+    state: "queued"
+  });
+  patchRunRecord(projectRoot, runId, { latestSteeringAt: createdAt });
+  return entry;
+}
+function appendRunBridgeEvent(projectRoot, runId, event) {
+  const kind = typeof event.kind === "string" ? event.kind : "event";
+  const createdAt = typeof event.createdAt === "string" ? event.createdAt : new Date().toISOString();
+  if (kind === "status") {
+    patchRunRecord(projectRoot, runId, { statusDetail: event.message ?? event.status ?? null, updatedAt: createdAt });
+  }
+  if (kind === "artifact" || kind === "task-metadata" || kind === "status") {
+    appendRunTimelineEntry(projectRoot, runId, {
+      id: `pi-rig:${kind}:${Date.now()}`,
+      type: "rig_bridge_event",
+      text: typeof event.message === "string" ? event.message : JSON.stringify(event),
+      createdAt,
+      state: "completed",
+      payload: event
+    });
+  }
+}
+export {
+  runSteeringPath,
+  readQueuedRunSteeringMessages,
+  queueRunSteeringMessage,
+  markQueuedRunSteeringMessagesDelivered,
+  appendRunBridgeEvent
+};

package/dist/src/server-helpers/run-writers.js

@@ -0,0 +1,75 @@
+// @bun
+// packages/server/src/server-helpers/run-writers.ts
+import { resolve as resolve2 } from "path";
+import {
+  appendJsonlRecord,
+  readAuthorityRun as readAuthorityRun2,
+  resolveAuthorityRunDir as resolveAuthorityRunDir2,
+  writeJsonFile
+} from "@rig/runtime/control-plane/authority-files";
+
+// packages/server/src/server-helpers/normalizers.ts
+function normalizeString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+
+// packages/server/src/server-helpers/run-io.ts
+import { dirname, resolve } from "path";
+import {
+  listAuthorityRuns,
+  readAuthorityRun,
+  readJsonlFile,
+  resolveAuthorityRunDir
+} from "@rig/runtime/control-plane/authority-files";
+function runTimelinePath(projectRoot, runId) {
+  return resolve(resolveAuthorityRunDir(projectRoot, runId), "timeline.jsonl");
+}
+function runLogsPath(projectRoot, runId) {
+  return resolve(resolveAuthorityRunDir(projectRoot, runId), "logs.jsonl");
+}
+var INITIAL_RUN_LOG_TAIL_MAX_BYTES = 8 * 1024 * 1024;
+
+// packages/server/src/server-helpers/run-writers.ts
+function appendRunTimelineEntry(projectRoot, runId, value) {
+  if (!readAuthorityRun2(projectRoot, runId)) {
+    return;
+  }
+  appendJsonlRecord(runTimelinePath(projectRoot, runId), value);
+  patchRunRecord(projectRoot, runId, {});
+}
+function appendRunLogEntry(projectRoot, runId, value) {
+  if (!readAuthorityRun2(projectRoot, runId)) {
+    return;
+  }
+  appendJsonlRecord(runLogsPath(projectRoot, runId), value);
+  patchRunRecord(projectRoot, runId, {});
+  return value;
+}
+function patchRunRecord(projectRoot, runId, patch) {
+  const current = readAuthorityRun2(projectRoot, runId);
+  if (!current) {
+    throw new Error(`Run not found: ${runId}`);
+  }
+  const next = {
+    ...current,
+    ...patch,
+    updatedAt: normalizeString(patch.updatedAt) ?? new Date().toISOString()
+  };
+  writeJsonFile(resolve2(resolveAuthorityRunDir2(projectRoot, runId), "run.json"), next);
+  return next;
+}
+function buildRunStartPatch(startedAt) {
+  return {
+    status: "preparing",
+    startedAt,
+    completedAt: null,
+    errorText: null,
+    serverPid: process.pid
+  };
+}
+export {
+  patchRunRecord,
+  buildRunStartPatch,
+  appendRunTimelineEntry,
+  appendRunLogEntry
+};

package/dist/src/server-helpers/server-paths.js

@@ -0,0 +1,27 @@
+// @bun
+// packages/server/src/server-helpers/server-paths.ts
+import { dirname, resolve } from "path";
+import { resolveMonorepoRoot } from "@rig/runtime/control-plane/native/utils";
+function resolveServerAuthorityPaths(projectRoot) {
+  const taskWorkspace = process.env.RIG_TASK_WORKSPACE?.trim();
+  const explicitStateDir = process.env.RIG_STATE_DIR?.trim();
+  const explicitLogsDir = process.env.RIG_LOGS_DIR?.trim();
+  const explicitSessionFile = process.env.RIG_SESSION_FILE?.trim();
+  const monorepoRoot = resolveMonorepoRoot(projectRoot);
+  const stateRoot = taskWorkspace ? resolve(taskWorkspace, ".rig") : explicitStateDir ? dirname(resolve(explicitStateDir)) : explicitLogsDir ? dirname(resolve(explicitLogsDir)) : explicitSessionFile ? dirname(dirname(resolve(explicitSessionFile))) : resolve(monorepoRoot, ".rig");
+  const stateDir = explicitStateDir ? resolve(explicitStateDir) : resolve(stateRoot, "state");
+  const logsDir = explicitLogsDir ? resolve(explicitLogsDir) : resolve(stateRoot, "logs");
+  const sessionFile = explicitSessionFile ? resolve(explicitSessionFile) : resolve(stateRoot, "session", "session.json");
+  const artifactsDir = taskWorkspace ? resolve(taskWorkspace, "artifacts") : resolve(monorepoRoot, "artifacts");
+  return {
+    stateRoot,
+    stateDir,
+    logsDir,
+    controlPlaneEventsFile: resolve(logsDir, "control-plane.events.jsonl"),
+    sessionFile,
+    artifactsDir
+  };
+}
+export {
+  resolveServerAuthorityPaths
+};