@treeseed/sdk 0.13.0-rc.5 → 0.13.0-rc.8

package/dist/platform-operation-store/platform-operation-store.js

@@ -1,224 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { PLATFORM_OPERATION_SCHEMA_SQL, isoNow, normalizeOperationCapabilities, rowEvent, rowOperation } from "./database-provider.js";
-class PlatformOperationStore {
-  initialized = false;
-  database;
-  now;
-  initializeSchema;
-  constructor(options) {
-    this.database = options.database;
-    this.now = options.now ?? (() => /* @__PURE__ */ new Date());
-    this.initializeSchema = options.initializeSchema ?? true;
-  }
-  async close() {
-    await this.database.close?.();
-  }
-  async ensureInitialized() {
-    if (this.initialized) return;
-    if (this.initializeSchema) {
-      if (this.database.exec) await this.database.exec(PLATFORM_OPERATION_SCHEMA_SQL);
-      else {
-        for (const statement of PLATFORM_OPERATION_SCHEMA_SQL.split(/;\s*/u).map((entry) => entry.trim()).filter(Boolean)) {
-          await this.database.run(statement);
-        }
-      }
-    }
-    this.initialized = true;
-  }
-  async appendPlatformOperationEvent(operationId, kind, data = {}) {
-    await this.ensureInitialized();
-    const timestamp = isoNow(this.now);
-    const id = randomUUID();
-    for (let attempt = 0; ; attempt += 1) {
-      const row = await this.database.first(
-        `SELECT COALESCE(MAX(seq), 0) + 1 AS next_seq FROM platform_operation_events WHERE operation_id = ?`,
-        [operationId]
-      );
-      try {
-        await this.database.run(
-          `INSERT INTO platform_operation_events (id, operation_id, seq, kind, data_json, created_at)
-					 VALUES (?, ?, ?, ?, ?, ?)`,
-          [id, operationId, Number(row?.next_seq ?? 1), kind, JSON.stringify(data ?? {}), timestamp]
-        );
-        break;
-      } catch (error) {
-        const conflict = String(error.code ?? "") === "23505" || /idx_platform_operation_events_seq|operation_id.*seq/iu.test(error instanceof Error ? error.message : String(error));
-        if (!conflict || attempt >= 63) throw error;
-        await new Promise((resolveWait) => setTimeout(resolveWait, Math.min(attempt + 1, 8)));
-      }
-    }
-    return rowEvent(await this.database.first(`SELECT * FROM platform_operation_events WHERE id = ?`, [id]));
-  }
-  async register(request) {
-    return { ok: true, runner: await this.upsertRunner(request) };
-  }
-  async heartbeat(request) {
-    return { ok: true, runner: await this.upsertRunner(request) };
-  }
-  async upsertRunner(input) {
-    await this.ensureInitialized();
-    const timestamp = isoNow(this.now);
-    const id = input.runnerId;
-    await this.database.run(
-      `INSERT INTO market_operation_runners (
-				id, runner_key, name, environment, status, version, capabilities_json,
-				active_job_count, max_concurrent_jobs, heartbeat_at, metadata_json, created_at, updated_at
-			) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-			ON CONFLICT(id) DO UPDATE SET
-				runner_key = excluded.runner_key,
-				name = excluded.name,
-				environment = excluded.environment,
-				status = excluded.status,
-				version = excluded.version,
-				capabilities_json = excluded.capabilities_json,
-				active_job_count = excluded.active_job_count,
-				max_concurrent_jobs = excluded.max_concurrent_jobs,
-				heartbeat_at = excluded.heartbeat_at,
-				metadata_json = excluded.metadata_json,
-				updated_at = excluded.updated_at`,
-      [
-        id,
-        ("runnerKey" in input ? input.runnerKey : void 0) ?? id,
-        ("name" in input ? input.name : void 0) ?? id,
-        input.environment ?? "unknown",
-        ("status" in input ? input.status : void 0) ?? "online",
-        input.version ?? null,
-        JSON.stringify(Array.isArray(input.capabilities) ? input.capabilities : []),
-        Math.max(0, Number(("activeJobCount" in input ? input.activeJobCount : void 0) ?? 0) || 0),
-        Math.max(1, Number(input.maxConcurrentJobs ?? 1) || 1),
-        timestamp,
-        JSON.stringify(input.metadata ?? {}),
-        timestamp,
-        timestamp
-      ]
-    );
-    return this.database.first(`SELECT * FROM market_operation_runners WHERE id = ?`, [id]);
-  }
-  async getOperation(operationId) {
-    await this.ensureInitialized();
-    const operation = rowOperation(await this.database.first(`SELECT * FROM platform_operations WHERE id = ?`, [operationId]));
-    if (!operation) throw new Error(`Unknown platform operation "${operationId}".`);
-    return { ok: true, operation };
-  }
-  async claimJob(input) {
-    await this.ensureInitialized();
-    const runnerId = input.runnerId;
-    const leaseSeconds = Math.max(30, Math.min(Number(input.leaseSeconds ?? 300), 3600));
-    const now = isoNow(this.now);
-    const leaseExpiresAt = new Date(this.now().getTime() + leaseSeconds * 1e3).toISOString();
-    const capabilities = normalizeOperationCapabilities(input.capabilities);
-    const capabilityWhere = capabilities.length > 0 ? ` AND (${capabilities.map(() => `(namespace || ':' || operation) = ?`).join(" OR ")})` : "";
-    const capabilityParams = capabilities;
-    const rows = input.operationId ? await this.database.all(
-      `SELECT * FROM platform_operations
-				 WHERE id = ? AND (
-				    status = 'queued'
-				    OR (status IN ('leased', 'running') AND lease_expires_at IS NOT NULL AND lease_expires_at < ?)
-				 )
-				 ${capabilityWhere}
-				 ORDER BY created_at ASC LIMIT 1`,
-      [input.operationId, now, ...capabilityParams]
-    ) : await this.database.all(
-      `SELECT * FROM platform_operations
-				 WHERE (
-				    status = 'queued'
-				    OR (status IN ('leased', 'running') AND lease_expires_at IS NOT NULL AND lease_expires_at < ?)
-				 )
-				 ${capabilityWhere}
-				 ORDER BY created_at ASC LIMIT 1`,
-      [now, ...capabilityParams]
-    );
-    const row = rows[0];
-    if (!row) return { ok: true, operation: null };
-    await this.database.run(
-      `UPDATE platform_operations
-			 SET status = 'leased',
-			     assigned_runner_id = ?,
-			     lease_expires_at = ?,
-			     started_at = COALESCE(started_at, ?),
-			     updated_at = ?
-			 WHERE id = ?`,
-      [runnerId, leaseExpiresAt, now, now, row.id]
-    );
-    const reclaimed = ["leased", "running"].includes(String(row.status));
-    await this.appendPlatformOperationEvent(String(row.id), reclaimed ? "runner.lease_reclaimed" : "claimed", {
-      runnerId,
-      leaseExpiresAt,
-      ...reclaimed ? { previousRunnerId: row.assigned_runner_id ?? null, previousStatus: row.status } : {}
-    });
-    const operation = rowOperation(await this.database.first(`SELECT * FROM platform_operations WHERE id = ?`, [row.id]));
-    return { ok: true, operation };
-  }
-  async assertRunnerUpdate(operationId, runnerId) {
-    const operation = (await this.getOperation(operationId)).operation;
-    if (!runnerId) throw new Error("runnerId is required.");
-    if (operation.assignedRunnerId !== runnerId) throw new Error("Platform operation is assigned to a different runner.");
-    if (["succeeded", "failed", "cancelled"].includes(operation.status)) throw new Error(`Platform operation is already ${operation.status}.`);
-    return operation;
-  }
-  async appendEvent(operationId, request) {
-    await this.assertRunnerUpdate(operationId, request.runnerId);
-    return { ok: true, event: await this.appendPlatformOperationEvent(operationId, request.event?.kind ?? "event", request.event?.data ?? {}) };
-  }
-  async renewLease(operationId, request) {
-    await this.assertRunnerUpdate(operationId, request.runnerId);
-    const leaseSeconds = Math.max(30, Math.min(Number(request.leaseSeconds ?? 300), 3600));
-    const timestamp = isoNow(this.now);
-    const leaseExpiresAt = new Date(this.now().getTime() + leaseSeconds * 1e3).toISOString();
-    await this.database.run(
-      `UPDATE platform_operations SET lease_expires_at = ?, updated_at = ? WHERE id = ?`,
-      [leaseExpiresAt, timestamp, operationId]
-    );
-    await this.appendPlatformOperationEvent(operationId, request.event?.kind ?? "runner.lease_renewed", request.event?.data ?? { runnerId: request.runnerId, leaseExpiresAt });
-    return this.getOperation(operationId);
-  }
-  async checkpoint(operationId, request) {
-    await this.assertRunnerUpdate(operationId, request.runnerId);
-    const timestamp = isoNow(this.now);
-    await this.database.run(
-      `UPDATE platform_operations SET status = 'running', output_json = ?, updated_at = ? WHERE id = ?`,
-      [JSON.stringify(request.output ?? null), timestamp, operationId]
-    );
-    await this.appendPlatformOperationEvent(operationId, request.event?.kind ?? "checkpoint", request.event?.data ?? { runnerId: request.runnerId ?? null });
-    return this.getOperation(operationId);
-  }
-  async complete(operationId, request) {
-    await this.assertRunnerUpdate(operationId, request.runnerId);
-    const timestamp = isoNow(this.now);
-    await this.database.run(
-      `UPDATE platform_operations
-			 SET status = 'succeeded', output_json = ?, error_json = NULL, lease_expires_at = NULL, updated_at = ?, finished_at = ?
-			 WHERE id = ?`,
-      [JSON.stringify(request.output ?? null), timestamp, timestamp, operationId]
-    );
-    await this.appendPlatformOperationEvent(operationId, request.event?.kind ?? "completed", request.event?.data ?? {});
-    return this.getOperation(operationId);
-  }
-  async fail(operationId, request) {
-    await this.assertRunnerUpdate(operationId, request.runnerId);
-    const timestamp = isoNow(this.now);
-    await this.database.run(
-      `UPDATE platform_operations
-			 SET status = 'failed', error_json = ?, lease_expires_at = NULL, updated_at = ?, finished_at = ?
-			 WHERE id = ?`,
-      [JSON.stringify(request.error ?? { message: "Platform operation failed." }), timestamp, timestamp, operationId]
-    );
-    await this.appendPlatformOperationEvent(operationId, request.event?.kind ?? "failed", request.event?.data ?? {});
-    return this.getOperation(operationId);
-  }
-  async cancel(operationId, request) {
-    await this.assertRunnerUpdate(operationId, request.runnerId);
-    const timestamp = isoNow(this.now);
-    await this.database.run(
-      `UPDATE platform_operations
-			 SET status = 'cancelled', error_json = ?, lease_expires_at = NULL, cancelled_at = COALESCE(cancelled_at, ?), updated_at = ?, finished_at = COALESCE(finished_at, ?)
-			 WHERE id = ?`,
-      [JSON.stringify(request.error ?? { message: "Platform operation was cancelled." }), timestamp, timestamp, timestamp, operationId]
-    );
-    await this.appendPlatformOperationEvent(operationId, request.event?.kind ?? "runner.cancelled", request.event?.data ?? {});
-    return this.getOperation(operationId);
-  }
-}
-export {
-  PlatformOperationStore
-};

package/dist/platform-operations/nested-record.d.ts

@@ -1,21 +0,0 @@
-import { PlatformOperation, PlatformOperationEvent, PlatformOperationExecutor, PlatformOperationNavigationResult, PlatformOperationPollOptions, PlatformOperationPollResult, PlatformOperationRunOnceResult, PlatformOperationRunnerCoreOptions } from './platform-operation-endpoints.js';
-export declare function nestedRecord(value: unknown, keys: string[]): Record<string, unknown> | null;
-export declare function firstString(...values: unknown[]): string | null;
-export declare function stringArray(value: unknown): string[];
-export declare function derivePlatformOperationNavigation(operation: PlatformOperation): PlatformOperationNavigationResult;
-export declare function pollPlatformOperation(options: PlatformOperationPollOptions): Promise<PlatformOperationPollResult>;
-export declare function normalizeBaseUrl(value: string): string;
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
-export declare class PlatformOperationApiError extends Error {
-    readonly status: number;
-    readonly payload: unknown;
-    constructor(message: string, status: number, payload: unknown);
-}
-export declare function assertPlatformOperationOkEnvelope(value: unknown, label?: string): void;
-export declare function assertPlatformOperation(value: unknown, label?: string): asserts value is PlatformOperation;
-export declare function assertPlatformOperationEvent(value: unknown, label?: string): asserts value is PlatformOperationEvent;
-export declare function createPlatformOperationExecutorRegistry(executors: PlatformOperationExecutor[]): {
-    get(operation: PlatformOperation): PlatformOperationExecutor<Record<string, unknown>, unknown> | null;
-    keys(): string[];
-};
-export declare function runPlatformOperationOnce(options: PlatformOperationRunnerCoreOptions): Promise<PlatformOperationRunOnceResult>;

package/dist/platform-operations/nested-record.js

@@ -1,262 +0,0 @@
-import { isPlatformOperationTerminal } from "./platform-operation-endpoints.js";
-function nestedRecord(value, keys) {
-  let current = value;
-  for (const key of keys) {
-    if (!isRecord(current)) return null;
-    current = current[key];
-  }
-  return isRecord(current) ? current : null;
-}
-function firstString(...values) {
-  for (const value of values) {
-    if (typeof value === "string" && value.trim()) return value.trim();
-  }
-  return null;
-}
-function stringArray(value) {
-  return Array.isArray(value) ? value.map((entry) => String(entry).trim()).filter(Boolean) : [];
-}
-function derivePlatformOperationNavigation(operation) {
-  const output = isRecord(operation.output) ? operation.output : {};
-  const nestedOutput = nestedRecord(output, ["output"]) ?? {};
-  const record = nestedRecord(output, ["record"]) ?? nestedRecord(nestedOutput, ["record"]);
-  const child = nestedRecord(output, ["child"]) ?? nestedRecord(nestedOutput, ["child"]);
-  const decision = nestedRecord(output, ["decision"]) ?? nestedRecord(nestedOutput, ["decision"]);
-  const changedPaths = [
-    ...stringArray(output.changedPaths),
-    ...stringArray(nestedOutput.changedPaths)
-  ];
-  return {
-    href: firstString(output.href, nestedOutput.href, record?.href, child?.href, decision?.href),
-    changedPaths: [...new Set(changedPaths)],
-    branch: firstString(output.branch, nestedOutput.branch),
-    commitSha: firstString(output.commitSha, nestedOutput.commitSha)
-  };
-}
-async function pollPlatformOperation(options) {
-  const intervalMs = Math.max(0, options.intervalMs ?? 1e3);
-  const timeoutMs = Math.max(intervalMs, options.timeoutMs ?? 12e4);
-  const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
-  const startedAt = Date.now();
-  let latestOperation = null;
-  let latestEvents = [];
-  while (Date.now() - startedAt <= timeoutMs) {
-    latestOperation = await options.fetchOperation(options.operationId);
-    latestEvents = options.fetchEvents ? await options.fetchEvents(options.operationId) : [];
-    const terminal = isPlatformOperationTerminal(latestOperation);
-    await options.onUpdate?.({ operation: latestOperation, events: latestEvents, terminal });
-    if (terminal) {
-      return {
-        operation: latestOperation,
-        events: latestEvents,
-        terminal,
-        navigation: derivePlatformOperationNavigation(latestOperation)
-      };
-    }
-    await sleep(intervalMs);
-  }
-  if (!latestOperation) {
-    throw new Error(`Platform operation "${options.operationId}" was not found before polling timed out.`);
-  }
-  return {
-    operation: latestOperation,
-    events: latestEvents,
-    terminal: false,
-    navigation: derivePlatformOperationNavigation(latestOperation)
-  };
-}
-function normalizeBaseUrl(value) {
-  return value.trim().replace(/\/+$/u, "");
-}
-function isRecord(value) {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-class PlatformOperationApiError extends Error {
-  status;
-  payload;
-  constructor(message, status, payload) {
-    super(message);
-    this.name = "PlatformOperationApiError";
-    this.status = status;
-    this.payload = payload;
-  }
-}
-function assertPlatformOperationOkEnvelope(value, label = "Platform operation response") {
-  if (!isRecord(value) || value.ok !== true) {
-    throw new Error(`${label} is missing ok: true.`);
-  }
-}
-function assertPlatformOperation(value, label = "Platform operation") {
-  if (!isRecord(value)) throw new Error(`${label} must be an object.`);
-  for (const key of ["id", "namespace", "operation", "status", "target", "createdAt", "updatedAt"]) {
-    if (typeof value[key] !== "string" || !String(value[key]).trim()) {
-      throw new Error(`${label} is missing ${key}.`);
-    }
-  }
-  if (!isRecord(value.input)) throw new Error(`${label} is missing input.`);
-}
-function assertPlatformOperationEvent(value, label = "Platform operation event") {
-  if (!isRecord(value)) throw new Error(`${label} must be an object.`);
-  for (const key of ["id", "operationId", "kind", "createdAt"]) {
-    if (typeof value[key] !== "string" || !String(value[key]).trim()) {
-      throw new Error(`${label} is missing ${key}.`);
-    }
-  }
-  if (!Number.isFinite(Number(value.seq))) throw new Error(`${label} is missing seq.`);
-  if (!isRecord(value.data)) throw new Error(`${label} is missing data.`);
-}
-function createPlatformOperationExecutorRegistry(executors) {
-  const registry = /* @__PURE__ */ new Map();
-  for (const executor of executors) {
-    registry.set(`${executor.namespace}:${executor.operation}`, executor);
-  }
-  return {
-    get(operation) {
-      return registry.get(`${operation.namespace}:${operation.operation}`) ?? null;
-    },
-    keys() {
-      return [...registry.keys()];
-    }
-  };
-}
-async function runPlatformOperationOnce(options) {
-  const registry = createPlatformOperationExecutorRegistry(options.executors);
-  const claimed = await options.client.claimJob({
-    runnerId: options.runnerId,
-    operationId: options.operationId ?? void 0,
-    capabilities: registry.keys(),
-    limit: options.limit ?? 1,
-    leaseSeconds: options.leaseSeconds ?? 300
-  });
-  let operation = claimed.operation;
-  if (!operation) {
-    return { ok: true, claimed: false, operation: null };
-  }
-  const executor = registry.get(operation);
-  if (!executor) {
-    const message = `No executor registered for platform operation "${operation.namespace}:${operation.operation}".`;
-    const failed = await options.client.fail(operation.id, {
-      runnerId: options.runnerId,
-      error: { message },
-      event: { kind: "runner.executor_missing", data: { namespace: operation.namespace, operation: operation.operation } }
-    });
-    return { ok: false, claimed: true, operation: failed.operation, error: { message } };
-  }
-  const context = {
-    operation,
-    operationId: operation.id,
-    workspaceRoot: options.workspaceRoot,
-    environment: options.environment,
-    emit: async (event) => {
-      await options.client.appendEvent(operation.id, {
-        runnerId: options.runnerId,
-        event
-      });
-    },
-    checkpoint: async (output, event) => {
-      await context.throwIfCancelled();
-      await options.client.checkpoint(operation.id, {
-        runnerId: options.runnerId,
-        output,
-        event
-      });
-    },
-    renewLease: async (leaseSeconds2) => {
-      if (!options.client.renewLease) return operation;
-      const renewed = await options.client.renewLease(operation.id, {
-        runnerId: options.runnerId,
-        leaseSeconds: leaseSeconds2,
-        event: { kind: "runner.lease_renewed", data: { leaseSeconds: leaseSeconds2 ?? options.leaseSeconds ?? 300 } }
-      });
-      operation = renewed.operation;
-      return renewed.operation;
-    },
-    throwIfCancelled: async () => {
-      const latest = options.client.getOperation ? (await options.client.getOperation(operation.id)).operation : operation;
-      operation = latest;
-      if (latest.status === "cancelled") throw new Error("Platform operation was cancelled.");
-      await options.throwIfCancelled?.(operation);
-    }
-  };
-  const leaseSeconds = Math.max(30, Math.min(Number(options.leaseSeconds ?? 300), 3600));
-  const leaseRenewalIntervalMs = Math.max(1, options.leaseRenewalIntervalMs ?? Math.min(6e4, Math.floor(leaseSeconds * 1e3 / 3)));
-  let leaseRenewalFailure = null;
-  let leaseRenewal = Promise.resolve();
-  let leaseTimer = null;
-  const assertLeaseRenewal = () => {
-    if (leaseRenewalFailure) throw leaseRenewalFailure;
-  };
-  try {
-    await context.emit({ kind: "runner.started", data: { namespace: operation.namespace, operation: operation.operation } });
-    await context.throwIfCancelled();
-    await context.renewLease(leaseSeconds);
-    if (options.client.renewLease) {
-      leaseTimer = setInterval(() => {
-        leaseRenewal = leaseRenewal.then(async () => {
-          if (leaseRenewalFailure) return;
-          try {
-            await context.renewLease(leaseSeconds);
-          } catch (error) {
-            leaseRenewalFailure = new Error(`Platform operation lease renewal failed: ${error instanceof Error ? error.message : String(error)}`);
-          }
-        });
-      }, leaseRenewalIntervalMs);
-      leaseTimer.unref?.();
-    }
-    const output = await executor.run(operation.input, context);
-    assertLeaseRenewal();
-    await context.throwIfCancelled();
-    assertLeaseRenewal();
-    const completed = await options.client.complete(operation.id, {
-      runnerId: options.runnerId,
-      output
-    });
-    return { ok: true, claimed: true, operation: completed.operation, output };
-  } catch (error) {
-    const failure = {
-      message: error instanceof Error ? error.message : String(error)
-    };
-    const eventKind = failure.message.toLowerCase().includes("cancel") ? "runner.cancelled" : "runner.retry_safe_failure";
-    if (eventKind === "runner.cancelled" && options.client.cancel) {
-      const cancelled = await options.client.cancel(operation.id, {
-        runnerId: options.runnerId,
-        error: failure,
-        event: { kind: eventKind, data: failure }
-      });
-      return { ok: false, claimed: true, operation: cancelled.operation, error: failure };
-    }
-    if (eventKind === "runner.cancelled" && options.client.getOperation) {
-      await options.client.appendEvent(operation.id, {
-        runnerId: options.runnerId,
-        event: { kind: eventKind, data: failure }
-      }).catch(() => {
-      });
-      const latest = await options.client.getOperation(operation.id);
-      return { ok: false, claimed: true, operation: latest.operation, error: failure };
-    }
-    const failed = await options.client.fail(operation.id, {
-      runnerId: options.runnerId,
-      error: failure,
-      event: { kind: eventKind, data: failure }
-    });
-    return { ok: false, claimed: true, operation: failed.operation, error: failure };
-  } finally {
-    if (leaseTimer) clearInterval(leaseTimer);
-    await leaseRenewal;
-  }
-}
-export {
-  PlatformOperationApiError,
-  assertPlatformOperation,
-  assertPlatformOperationEvent,
-  assertPlatformOperationOkEnvelope,
-  createPlatformOperationExecutorRegistry,
-  derivePlatformOperationNavigation,
-  firstString,
-  isRecord,
-  nestedRecord,
-  normalizeBaseUrl,
-  pollPlatformOperation,
-  runPlatformOperationOnce,
-  stringArray
-};