@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/platform-operations.js

@@ -1,440 +0,0 @@
-import {
-  TREESEED_REMOTE_CONTRACT_HEADER,
-  TREESEED_REMOTE_CONTRACT_VERSION
-} from "./remote.js";
-const PLATFORM_OPERATION_ENDPOINTS = {
-  operations: "/v1/platform/operations",
-  operation: (operationId) => `/v1/platform/operations/${encodeURIComponent(operationId)}`,
-  operationEvents: (operationId) => `/v1/platform/operations/${encodeURIComponent(operationId)}/events`,
-  cancelOperation: (operationId) => `/v1/platform/operations/${encodeURIComponent(operationId)}/cancel`,
-  retryOperation: (operationId) => `/v1/platform/operations/${encodeURIComponent(operationId)}/retry`,
-  registerRunner: "/v1/platform/runners/register",
-  heartbeatRunner: "/v1/platform/runners/heartbeat",
-  claimJob: "/v1/platform/runners/jobs/claim",
-  runnerJob: (operationId) => `/v1/platform/runners/jobs/${encodeURIComponent(operationId)}`,
-  jobEvents: (operationId) => `/v1/platform/runners/jobs/${encodeURIComponent(operationId)}/events`,
-  renewLeaseJob: (operationId) => `/v1/platform/runners/jobs/${encodeURIComponent(operationId)}/renew-lease`,
-  checkpointJob: (operationId) => `/v1/platform/runners/jobs/${encodeURIComponent(operationId)}/checkpoint`,
-  completeJob: (operationId) => `/v1/platform/runners/jobs/${encodeURIComponent(operationId)}/complete`,
-  failJob: (operationId) => `/v1/platform/runners/jobs/${encodeURIComponent(operationId)}/fail`
-};
-const PLATFORM_OPERATION_SCOPES = [
-  "platform:runners:register",
-  "platform:runners:claim",
-  "platform:runners:update",
-  "platform:operations:create",
-  "platform:operations:read",
-  "platform:operations:cancel",
-  "platform:operations:retry",
-  "platform:repository:write",
-  "platform:deploy:write",
-  "platform:database:migrate"
-];
-const PLATFORM_OPERATION_NAMESPACES = [
-  "market",
-  "repository",
-  "deploy",
-  "database",
-  "seed",
-  "infrastructure",
-  "catalog"
-];
-const PLATFORM_OPERATION_STATUSES = [
-  "queued",
-  "leased",
-  "running",
-  "waiting_for_approval",
-  "succeeded",
-  "failed",
-  "cancelled"
-];
-const PLATFORM_OPERATION_TARGETS = [
-  "market_operations_runner",
-  "github_actions",
-  "cli",
-  "railway_job"
-];
-function buildPlatformRunnerAuthHeaders(secret) {
-  return {
-    authorization: `Bearer ${secret}`
-  };
-}
-function isPlatformOperationTerminal(operation) {
-  return ["succeeded", "failed", "cancelled"].includes(String(operation?.status ?? ""));
-}
-function isPlatformOperationSuccessful(operation) {
-  return String(operation?.status ?? "") === "succeeded";
-}
-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 (leaseSeconds) => {
-      if (!options.client.renewLease) return operation;
-      const renewed = await options.client.renewLease(operation.id, {
-        runnerId: options.runnerId,
-        leaseSeconds,
-        event: { kind: "runner.lease_renewed", data: { leaseSeconds: leaseSeconds ?? 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);
-    }
-  };
-  try {
-    await context.emit({ kind: "runner.started", data: { namespace: operation.namespace, operation: operation.operation } });
-    await context.throwIfCancelled();
-    await context.renewLease(options.leaseSeconds);
-    const output = await executor.run(operation.input, context);
-    await context.throwIfCancelled();
-    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 };
-  }
-}
-class PlatformRunnerClient {
-  marketUrl;
-  marketId;
-  runnerSecret;
-  fetchImpl;
-  userAgent;
-  constructor(options) {
-    this.marketUrl = normalizeBaseUrl(options.marketUrl);
-    this.marketId = options.marketId.trim();
-    this.runnerSecret = options.runnerSecret.trim();
-    if (!this.marketUrl) throw new Error("API URL is required.");
-    if (!this.marketId) throw new Error("Market ID is required.");
-    if (!this.runnerSecret) throw new Error("Platform runner secret is required.");
-    this.fetchImpl = options.fetchImpl ?? fetch;
-    this.userAgent = options.userAgent;
-  }
-  async requestJson(path, options = {}) {
-    const headers = {
-      accept: "application/json",
-      [TREESEED_REMOTE_CONTRACT_HEADER]: String(TREESEED_REMOTE_CONTRACT_VERSION),
-      ...buildPlatformRunnerAuthHeaders(this.runnerSecret)
-    };
-    if (this.userAgent) headers["user-agent"] = this.userAgent;
-    if (options.body !== void 0) headers["content-type"] = "application/json";
-    const response = await this.fetchImpl(`${this.marketUrl}${path}`, {
-      method: options.method ?? "GET",
-      headers,
-      body: options.body === void 0 ? void 0 : JSON.stringify(options.body)
-    });
-    const payload = await response.json().catch(() => ({}));
-    if (!response.ok) {
-      const message = isRecord(payload) && typeof payload.error === "string" ? payload.error : `Platform operation request failed with ${response.status}.`;
-      throw new PlatformOperationApiError(message, response.status, payload);
-    }
-    return payload;
-  }
-  register(request) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.registerRunner, {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform runner registration response");
-      return response;
-    });
-  }
-  heartbeat(request) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.heartbeatRunner, {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform runner heartbeat response");
-      return response;
-    });
-  }
-  claimJob(request) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.claimJob, {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform runner claim response");
-      if (response.operation !== null) assertPlatformOperation(response.operation, "Claimed platform operation");
-      return response;
-    });
-  }
-  getOperation(operationId) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.runnerJob(operationId), {
-      method: "GET"
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform operation response");
-      assertPlatformOperation(response.operation);
-      return response;
-    });
-  }
-  appendEvent(operationId, request) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.jobEvents(operationId), {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform operation event response");
-      assertPlatformOperationEvent(response.event);
-      return response;
-    });
-  }
-  renewLease(operationId, request) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.renewLeaseJob(operationId), {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform operation lease renewal response");
-      assertPlatformOperation(response.operation);
-      return response;
-    });
-  }
-  checkpoint(operationId, request) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.checkpointJob(operationId), {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform operation checkpoint response");
-      assertPlatformOperation(response.operation);
-      return response;
-    });
-  }
-  complete(operationId, request) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.completeJob(operationId), {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform operation completion response");
-      assertPlatformOperation(response.operation);
-      return response;
-    });
-  }
-  fail(operationId, request) {
-    return this.requestJson(PLATFORM_OPERATION_ENDPOINTS.failJob(operationId), {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform operation failure response");
-      assertPlatformOperation(response.operation);
-      return response;
-    });
-  }
-  cancel(operationId, request) {
-    return this.requestJson(`${PLATFORM_OPERATION_ENDPOINTS.runnerJob(operationId)}/cancel`, {
-      method: "POST",
-      body: { ...request, marketId: this.marketId }
-    }).then((response) => {
-      assertPlatformOperationOkEnvelope(response, "Platform operation cancellation response");
-      assertPlatformOperation(response.operation);
-      return response;
-    });
-  }
-}
-export {
-  PLATFORM_OPERATION_ENDPOINTS,
-  PLATFORM_OPERATION_NAMESPACES,
-  PLATFORM_OPERATION_SCOPES,
-  PLATFORM_OPERATION_STATUSES,
-  PLATFORM_OPERATION_TARGETS,
-  PlatformOperationApiError,
-  PlatformRunnerClient,
-  assertPlatformOperation,
-  assertPlatformOperationEvent,
-  assertPlatformOperationOkEnvelope,
-  buildPlatformRunnerAuthHeaders,
-  createPlatformOperationExecutorRegistry,
-  derivePlatformOperationNavigation,
-  isPlatformOperationSuccessful,
-  isPlatformOperationTerminal,
-  pollPlatformOperation,
-  runPlatformOperationOnce
-};

package/dist/plugin-default.d.ts

@@ -1,28 +0,0 @@
-declare const _default: {
-    id: string;
-    provides: {
-        forms: string[];
-        operations: string[];
-        agents: {
-            execution: string[];
-            mutation: string[];
-            repository: string[];
-            verification: string[];
-            notification: string[];
-            research: string[];
-            handlers: string[];
-        };
-        deploy: string[];
-        dns: string[];
-        content: {
-            runtime: string[];
-            publish: string[];
-            docs: string[];
-        };
-        site: string[];
-    };
-    graphRankingProviders: {
-        default: import("./sdk-types.js").SdkGraphRankingProvider;
-    };
-};
-export default _default;

package/dist/plugin-default.js

@@ -1,55 +0,0 @@
-import { createDefaultGraphRankingProvider } from "./graph/ranking.js";
-import { defineTreeseedPlugin } from "./platform/plugin.js";
-var plugin_default_default = defineTreeseedPlugin({
-  id: "treeseed-sdk-default",
-  provides: {
-    forms: ["store_only", "notify_admin", "full_email"],
-    operations: ["default"],
-    agents: {
-      execution: [
-        "copilot",
-        "codex",
-        "codex_subscription",
-        "jira",
-        "jira_issue_queue",
-        "human_issue_queue",
-        "github_issues",
-        "github_issue_queue",
-        "issue_queue",
-        "discord",
-        "discord_thread",
-        "workflow",
-        "workflow_operation",
-        "deterministic_workflow",
-        "github_actions",
-        "github_actions_workflow"
-      ],
-      mutation: ["local_branch"],
-      repository: ["git"],
-      verification: ["local"],
-      notification: ["sdk_message"],
-      research: ["project_graph"],
-      handlers: [
-        "plan",
-        "research",
-        "act",
-        "review",
-        "report"
-      ]
-    },
-    deploy: ["cloudflare"],
-    dns: ["cloudflare-dns"],
-    content: {
-      runtime: ["filesystem", "team_scoped_r2_overlay"],
-      publish: ["filesystem", "team_scoped_r2_overlay"],
-      docs: ["default"]
-    },
-    site: ["default"]
-  },
-  graphRankingProviders: {
-    default: createDefaultGraphRankingProvider()
-  }
-});
-export {
-  plugin_default_default as default
-};

package/dist/project-import.d.ts

@@ -1,91 +0,0 @@
-import type { SeedProjectArchitecture, SeedProjectContentPublishTarget } from './seeds/types.js';
-export { githubRepositoryCredentialEnvName } from './operations/services/github-credentials.js';
-export type TreeseedRepositoryImportProvider = 'github';
-export type TreeseedRepositoryImportVisibility = 'public' | 'private';
-export interface TreeseedGitHubRepositoryObservation {
-    provider?: TreeseedRepositoryImportProvider | string;
-    owner?: string;
-    name?: string;
-    repository?: string;
-    defaultBranch?: string;
-    visibility?: TreeseedRepositoryImportVisibility | string;
-    htmlUrl?: string;
-    cloneUrl?: string;
-    files?: string[];
-    directories?: string[];
-    manifests?: Record<string, unknown>;
-}
-export interface TreeseedRepositoryImportInput {
-    team: string;
-    repository: string;
-    observation?: TreeseedGitHubRepositoryObservation;
-    rootPath?: string;
-    sitePath?: string;
-    contentPath?: string | null;
-    visibility?: TreeseedRepositoryImportVisibility | string;
-    credentialRef?: string;
-    contentPublishTarget?: SeedProjectContentPublishTarget;
-    env?: Record<string, string | undefined>;
-}
-export interface TreeseedRepositoryImportDiagnostic {
-    severity: 'info' | 'warning' | 'error';
-    code: string;
-    message: string;
-    path?: string;
-}
-export interface TreeseedRepositoryImportPathCandidates {
-    rootPath: string[];
-    sitePath: string[];
-    contentPath: string[];
-    manifests: string[];
-}
-export interface TreeseedRepositoryImportPlan {
-    ok: boolean;
-    provider: TreeseedRepositoryImportProvider;
-    team: string;
-    repository: {
-        owner: string;
-        name: string;
-        slug: string;
-        defaultBranch: string;
-        visibility: TreeseedRepositoryImportVisibility;
-        htmlUrl: string;
-        cloneUrl: string;
-    };
-    credentialRef: string;
-    credential: {
-        ref: string;
-        configured: boolean;
-        source: 'repository' | 'fallback' | 'missing' | 'explicit';
-        repositoryScopedRef: string;
-    };
-    architecture: SeedProjectArchitecture;
-    candidates: TreeseedRepositoryImportPathCandidates;
-    diagnostics: TreeseedRepositoryImportDiagnostic[];
-    plannedRecords: {
-        project: {
-            slug: string;
-            name: string;
-            visibility: TreeseedRepositoryImportVisibility;
-        };
-        hubRepository: {
-            role: 'software';
-            provider: 'github';
-            owner: string;
-            name: string;
-            url: string;
-            defaultBranch: string;
-            credentialRef: string;
-        };
-        contentSource: {
-            contentRuntimeSource: SeedProjectArchitecture['contentRuntimeSource'];
-            contentPath: string | null;
-            contentPublishTarget: SeedProjectContentPublishTarget | null;
-        };
-        treeDxLibrary: {
-            libraryId: string;
-            contentPath: string | null;
-        };
-    };
-}
-export declare function planTreeseedRepositoryImport(input: TreeseedRepositoryImportInput): TreeseedRepositoryImportPlan;