@riddledc/riddle-proof 0.8.77 → 0.8.78

package/dist/receipts.d.ts

@@ -0,0 +1,115 @@
+import { RiddleProofProfileResult } from './profile.js';
+import { JsonValue } from './types.js';
+import './public-state.js';
+
+declare const RIDDLE_PREVIEW_RECEIPT_VERSION: "riddle.preview-receipt.v1";
+declare const RIDDLE_PROOF_OBSERVATION_RECEIPT_VERSION: "riddle-proof.observation-receipt.v1";
+type RiddleProofComparisonRole = "before" | "after" | "standalone";
+interface RiddleProofSourceIdentity {
+    git_revision?: string;
+    repository?: string;
+    dirty?: boolean;
+    label?: string;
+}
+interface RiddlePreviewReceipt {
+    version: typeof RIDDLE_PREVIEW_RECEIPT_VERSION;
+    preview_id: string;
+    url: string;
+    expires_at: string;
+    content_digest: string;
+    source: RiddleProofSourceIdentity;
+    published_at: string;
+}
+type RiddleProofObservationExecutorKind = "local_playwright" | "riddle_hosted" | "browser_api" | "other";
+interface RiddleProofObservationExecutor {
+    kind: RiddleProofObservationExecutorKind;
+    runner?: string;
+    job_id?: string;
+    worker_id?: string;
+}
+interface RiddleProofExecutionPhase {
+    phase: string;
+    at: string;
+}
+interface RiddleProofExecutionTelemetry {
+    enqueued_at?: string;
+    wake_requested_at?: string;
+    claimed_at?: string;
+    browser_started_at?: string;
+    artifacts_ready_at?: string;
+    completed_at?: string;
+    worker_id?: string;
+    cold_start?: boolean;
+    phases?: RiddleProofExecutionPhase[];
+    metadata?: Record<string, JsonValue>;
+}
+interface RiddleProofObservationTarget {
+    kind: "url" | "preview";
+    url: string;
+    preview?: RiddlePreviewReceipt;
+}
+type RiddleProofObservationArtifactRole = "canonical_screenshot" | "setup_screenshot" | "data" | "diagnostic" | "artifact";
+interface RiddleProofObservationArtifact {
+    name: string;
+    role: RiddleProofObservationArtifactRole;
+    url?: string;
+    path?: string;
+    kind?: string;
+    content_type?: string;
+    source?: string;
+}
+interface RiddleProofObservationPublication {
+    kind: "local" | "riddle_cdn" | "github" | "other";
+    url?: string;
+    path?: string;
+}
+interface RiddleProofObservationReceipt {
+    version: typeof RIDDLE_PROOF_OBSERVATION_RECEIPT_VERSION;
+    observation_id: string;
+    comparison_role: RiddleProofComparisonRole;
+    executor: RiddleProofObservationExecutor;
+    target: RiddleProofObservationTarget;
+    source: RiddleProofSourceIdentity;
+    captured_at: string;
+    artifacts: RiddleProofObservationArtifact[];
+    canonical_screenshot?: RiddleProofObservationArtifact;
+    profile_summary?: {
+        profile_name: string;
+        status: string;
+        summary: string;
+        route?: JsonValue;
+        checks: {
+            total: number;
+            passed: number;
+            failed: number;
+            skipped: number;
+            needs_human_review: number;
+        };
+    };
+    proof?: {
+        profile_name: string;
+        result: RiddleProofProfileResult;
+    };
+    publication?: RiddleProofObservationPublication;
+    execution?: RiddleProofExecutionTelemetry;
+    metadata?: Record<string, JsonValue>;
+}
+interface CreateRiddleProofObservationReceiptInput {
+    observation_id?: string;
+    comparison_role: RiddleProofComparisonRole;
+    executor: RiddleProofObservationExecutor;
+    target: RiddleProofObservationTarget;
+    source?: RiddleProofSourceIdentity;
+    profile_result?: RiddleProofProfileResult;
+    artifacts?: RiddleProofObservationArtifact[];
+    canonical_screenshot?: RiddleProofObservationArtifact;
+    publication?: RiddleProofObservationPublication;
+    execution?: RiddleProofExecutionTelemetry;
+    captured_at?: string;
+    metadata?: Record<string, JsonValue>;
+}
+declare function parseRiddlePreviewReceipt(value: unknown): RiddlePreviewReceipt;
+declare function createRiddleProofObservationReceipt(input: CreateRiddleProofObservationReceiptInput): RiddleProofObservationReceipt;
+declare function parseRiddleProofObservationReceipt(value: unknown): RiddleProofObservationReceipt;
+
+export { type CreateRiddleProofObservationReceiptInput, RIDDLE_PREVIEW_RECEIPT_VERSION, RIDDLE_PROOF_OBSERVATION_RECEIPT_VERSION, type RiddlePreviewReceipt, type RiddleProofComparisonRole, type RiddleProofExecutionPhase, type RiddleProofExecutionTelemetry, type RiddleProofObservationArtifact, type RiddleProofObservationArtifactRole, type RiddleProofObservationExecutor, type RiddleProofObservationExecutorKind, type RiddleProofObservationPublication, type RiddleProofObservationReceipt, type RiddleProofObservationTarget, type RiddleProofSourceIdentity, createRiddleProofObservationReceipt, parseRiddlePreviewReceipt, parseRiddleProofObservationReceipt };

package/dist/receipts.js

@@ -0,0 +1,15 @@
+import {
+  RIDDLE_PREVIEW_RECEIPT_VERSION,
+  RIDDLE_PROOF_OBSERVATION_RECEIPT_VERSION,
+  createRiddleProofObservationReceipt,
+  parseRiddlePreviewReceipt,
+  parseRiddleProofObservationReceipt
+} from "./chunk-MEVVL4TI.js";
+import "./chunk-MLKGABMK.js";
+export {
+  RIDDLE_PREVIEW_RECEIPT_VERSION,
+  RIDDLE_PROOF_OBSERVATION_RECEIPT_VERSION,
+  createRiddleProofObservationReceipt,
+  parseRiddlePreviewReceipt,
+  parseRiddleProofObservationReceipt
+};

package/dist/riddle-client.cjs

@@ -38,6 +38,7 @@ __export(riddle_client_exports, {
   createRiddleApiClient: () => createRiddleApiClient,
   deployRiddlePreview: () => deployRiddlePreview,
   deployRiddleStaticPreview: () => deployRiddleStaticPreview,
+  detectRiddlePreviewSource: () => detectRiddlePreviewSource,
   getRiddleBalance: () => getRiddleBalance,
   isTerminalRiddleJobStatus: () => isTerminalRiddleJobStatus,
   parseRiddleViewport: () => parseRiddleViewport,
@@ -53,6 +54,55 @@ var import_node_child_process = require("child_process");
 var import_node_fs = require("fs");
 var import_node_os = require("os");
 var import_node_path = __toESM(require("path"), 1);
+
+// src/receipts.ts
+var RIDDLE_PREVIEW_RECEIPT_VERSION = "riddle.preview-receipt.v1";
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function requiredString(record, key, context) {
+  const value = record[key];
+  if (typeof value !== "string" || !value.trim()) {
+    throw new Error(`${context}.${key} must be a non-empty string.`);
+  }
+  return value.trim();
+}
+function normalizedSourceIdentity(value) {
+  if (!isRecord(value)) return {};
+  return {
+    git_revision: typeof value.git_revision === "string" && value.git_revision.trim() ? value.git_revision.trim() : void 0,
+    repository: typeof value.repository === "string" && value.repository.trim() ? value.repository.trim() : void 0,
+    dirty: typeof value.dirty === "boolean" ? value.dirty : void 0,
+    label: typeof value.label === "string" && value.label.trim() ? value.label.trim() : void 0
+  };
+}
+function parseRiddlePreviewReceipt(value) {
+  if (!isRecord(value)) throw new Error("Preview receipt must be an object.");
+  if (value.version !== RIDDLE_PREVIEW_RECEIPT_VERSION) {
+    throw new Error(`Unsupported Preview receipt version ${String(value.version || "missing")}.`);
+  }
+  if (!isRecord(value.source)) throw new Error("Preview receipt source must be an object.");
+  const expiresAt = requiredString(value, "expires_at", "preview receipt");
+  const publishedAt = requiredString(value, "published_at", "preview receipt");
+  const contentDigest = requiredString(value, "content_digest", "preview receipt");
+  if (!contentDigest.startsWith("sha256:") || contentDigest.length <= "sha256:".length) {
+    throw new Error("preview receipt.content_digest must be a sha256 digest.");
+  }
+  if (!Number.isFinite(Date.parse(expiresAt)) || !Number.isFinite(Date.parse(publishedAt))) {
+    throw new Error("Preview receipt timestamps must be valid ISO date strings.");
+  }
+  return {
+    version: RIDDLE_PREVIEW_RECEIPT_VERSION,
+    preview_id: requiredString(value, "preview_id", "preview receipt"),
+    url: requiredString(value, "url", "preview receipt"),
+    expires_at: expiresAt,
+    content_digest: contentDigest,
+    source: normalizedSourceIdentity(value.source),
+    published_at: publishedAt
+  };
+}
+
+// src/riddle-client.ts
 var DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
 var DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
 var RIDDLE_UNSUBMITTED_WAKE_HINT = "hosted worker may still be waking or waiting for a lease";
@@ -114,6 +164,7 @@ async function getRiddleBalance(config = {}) {
 }
 function previewDeployResultFromRecord(input) {
   const { record, id, label, framework, expiresAt, publishRecovered, publishError } = input;
+  const receipt = record.receipt && typeof record.receipt === "object" ? parseRiddlePreviewReceipt(record.receipt) : void 0;
   return {
     ok: true,
     id: String(record.id || record.preview_id || id),
@@ -122,13 +173,32 @@ function previewDeployResultFromRecord(input) {
     preview_url: String(record.preview_url || ""),
     file_count: typeof record.file_count === "number" ? record.file_count : void 0,
     total_bytes: typeof record.total_bytes === "number" ? record.total_bytes : void 0,
-    expires_at: expiresAt,
+    expires_at: receipt?.expires_at || expiresAt,
+    receipt,
     publish_recovered: publishRecovered || void 0,
     publish_error: publishError,
     warnings: input.warnings?.length ? input.warnings : void 0,
     raw: record
   };
 }
+function gitOutput(directory, args) {
+  try {
+    return (0, import_node_child_process.execFileSync)("git", ["-C", directory, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return "";
+  }
+}
+function detectRiddlePreviewSource(directory) {
+  const gitRevision = gitOutput(directory, ["rev-parse", "HEAD"]);
+  if (!gitRevision) return {};
+  const repository = gitOutput(directory, ["config", "--get", "remote.origin.url"]);
+  const status = gitOutput(directory, ["status", "--porcelain", "--untracked-files=normal"]);
+  return {
+    git_revision: gitRevision,
+    repository: repository || void 0,
+    dirty: Boolean(status)
+  };
+}
 function canRecoverPreviewPublish(error) {
   return error instanceof RiddleApiError && PREVIEW_PUBLISH_RECOVERY_STATUSES.has(error.status);
 }
@@ -211,12 +281,13 @@ async function waitForPublishedPreview(config, input) {
   }
   throw input.publishError;
 }
-async function deployRiddlePreview(config, directory, label, framework = "static") {
+async function deployRiddlePreview(config, directory, label, framework = "static", options = {}) {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
   if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const startedAt = Date.now();
   const warnings = collectRiddlePreviewDeployWarnings(directory, framework);
+  const source = options.source || detectRiddlePreviewSource(directory);
   const emitProgress = previewProgressEmitter(config, { label, framework, directory, startedAt, warnings });
   await emitProgress({ stage: "validating", message: "checking preview input directory" });
   const localSummary = summarizePreviewDirectory(directory);
@@ -228,7 +299,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
   });
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework, label })
+    body: JSON.stringify({ framework, label, source })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -370,8 +441,8 @@ function collectRiddlePreviewDeployWarnings(directory, framework = "static") {
     return [];
   }
 }
-async function deployRiddleStaticPreview(config, directory, label) {
-  return deployRiddlePreview(config, directory, label, "static");
+async function deployRiddleStaticPreview(config, directory, label, options = {}) {
+  return deployRiddlePreview(config, directory, label, "static", options);
 }
 function createTarball(directory, label, exclude = []) {
   const scratch = (0, import_node_fs.mkdtempSync)(import_node_path.default.join((0, import_node_os.tmpdir)(), "riddle-upload-"));
@@ -493,21 +564,31 @@ function parseTimestampMs(value) {
 }
 function buildPollSnapshot(jobId, job, input) {
   const status = job?.status ? String(job.status) : null;
+  const phase = job?.phase ? String(job.phase) : null;
   const terminal = isTerminalRiddleJobStatus(status);
   const createdAt = stringField(job, "created_at");
   const submittedAt = stringField(job, "submitted_at");
   const completedAt = stringField(job, "completed_at");
   const createdMs = parseTimestampMs(createdAt);
   const submittedMs = parseTimestampMs(submittedAt);
+  const rawExecution = job?.execution && typeof job.execution === "object" && !Array.isArray(job.execution) ? job.execution : null;
+  const enqueuedAt = rawExecution ? stringField(rawExecution, "enqueued_at") : null;
+  const enqueuedMs = parseTimestampMs(enqueuedAt);
+  const queueStartedMs = enqueuedMs ?? createdMs;
+  const claimedAt = rawExecution ? stringField(rawExecution, "claimed_at") : null;
+  const claimedMs = parseTimestampMs(claimedAt);
   let queueElapsedMs = null;
-  if (createdMs !== null && submittedMs !== null) {
-    queueElapsedMs = Math.max(0, submittedMs - createdMs);
-  } else if (createdMs !== null && !submittedAt && !terminal) {
-    queueElapsedMs = Math.max(0, input.observedAt - createdMs);
+  if (queueStartedMs !== null && claimedMs !== null) {
+    queueElapsedMs = Math.max(0, claimedMs - queueStartedMs);
+  } else if (queueStartedMs !== null && submittedMs !== null) {
+    queueElapsedMs = Math.max(0, submittedMs - queueStartedMs);
+  } else if (queueStartedMs !== null && !submittedAt && !terminal) {
+    queueElapsedMs = Math.max(0, input.observedAt - queueStartedMs);
   }
   return {
     job_id: jobId,
     status,
+    phase,
     terminal,
     attempt: input.attempt,
     attempts: input.attempts,
@@ -517,7 +598,9 @@ function buildPollSnapshot(jobId, job, input) {
     completed_at: completedAt,
     queue_elapsed_ms: queueElapsedMs,
     pre_submission_elapsed_ms: Math.max(0, Math.floor(input.preSubmissionElapsedMs ?? 0)),
-    running_without_submission: Boolean(status && !terminal && !submittedAt)
+    running_without_submission: Boolean(status && !terminal && !submittedAt),
+    active_execution: Boolean(status === "running" && phase && phase !== "queued"),
+    execution: rawExecution ? rawExecution : void 0
   };
 }
 function pollMessage(snapshot, timedOut) {
@@ -526,7 +609,7 @@ function pollMessage(snapshot, timedOut) {
   const wakeHint = snapshot.running_without_submission && !snapshot.created_at && !snapshot.submitted_at ? ` ${RIDDLE_UNSUBMITTED_WAKE_HINT}.` : "";
   const queue = snapshot.queue_elapsed_ms !== null ? ` queue_elapsed_ms=${snapshot.queue_elapsed_ms}` : "";
   const preSubmit = snapshot.pre_submission_elapsed_ms > 0 ? ` pre_submission_elapsed_ms=${snapshot.pre_submission_elapsed_ms}` : "";
-  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} submitted_at=${submitted}.${wakeHint}${queue}${preSubmit}`;
+  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} phase=${snapshot.phase || "unknown"} submitted_at=${submitted}.${wakeHint}${queue}${preSubmit}`;
 }
 async function pollRiddleJob(config, jobId, options = {}) {
   if (!jobId?.trim()) throw new Error("jobId is required");
@@ -560,6 +643,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
     };
     const progressKey = [
       lastSnapshot.status || "unknown",
+      lastSnapshot.phase || "unknown",
       lastSnapshot.terminal ? "terminal" : "nonterminal",
       lastSnapshot.submitted_at ? "submitted" : "unsubmitted"
     ].join(":");
@@ -626,8 +710,8 @@ function createRiddleApiClient(config = {}) {
     apiKeySource: () => resolveRiddleApiKeySource(config),
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
     getBalance: () => getRiddleBalance(config),
-    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
-    deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
+    deployPreview: (directory, label, framework = "static", options) => deployRiddlePreview(config, directory, label, framework, options),
+    deployStaticPreview: (directory, label, options) => deployRiddleStaticPreview(config, directory, label, options),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
     pollJob: (jobId, options) => pollRiddleJob(config, jobId, options)
@@ -643,6 +727,7 @@ function createRiddleApiClient(config = {}) {
   createRiddleApiClient,
   deployRiddlePreview,
   deployRiddleStaticPreview,
+  detectRiddlePreviewSource,
   getRiddleBalance,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,

package/dist/riddle-client.d.cts

@@ -1,3 +1,8 @@
+import { RiddleProofExecutionTelemetry, RiddleProofSourceIdentity, RiddlePreviewReceipt } from './receipts.cjs';
+import './profile.cjs';
+import './types.cjs';
+import './public-state.cjs';
+
 declare const DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
 declare const DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
 declare const RIDDLE_UNSUBMITTED_WAKE_HINT = "hosted worker may still be waking or waiting for a lease";
@@ -29,6 +34,7 @@ interface RiddleBalanceResult {
 interface RiddlePollProgressSnapshot {
     job_id: string;
     status: string | null;
+    phase: string | null;
     terminal: boolean;
     attempt: number;
     attempts: number;
@@ -39,6 +45,8 @@ interface RiddlePollProgressSnapshot {
     queue_elapsed_ms: number | null;
     pre_submission_elapsed_ms: number;
     running_without_submission: boolean;
+    active_execution: boolean;
+    execution?: RiddleProofExecutionTelemetry;
 }
 interface RiddlePollSummary extends RiddlePollProgressSnapshot {
     timed_out: boolean;
@@ -84,11 +92,15 @@ interface RiddlePreviewDeployResult {
     file_count?: number;
     total_bytes?: number;
     expires_at?: string;
+    receipt?: RiddlePreviewReceipt;
     publish_recovered?: boolean;
     publish_error?: string;
     warnings?: string[];
     raw?: Record<string, unknown>;
 }
+interface RiddlePreviewDeployOptions {
+    source?: RiddleProofSourceIdentity;
+}
 interface RiddleRunScriptInput {
     url: string;
     script: string;
@@ -150,9 +162,10 @@ declare function resolveRiddleApiKeySource(config?: RiddleClientConfig): RiddleA
 declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
 declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
 declare function getRiddleBalance(config?: RiddleClientConfig): Promise<RiddleBalanceResult>;
-declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework): Promise<RiddlePreviewDeployResult>;
+declare function detectRiddlePreviewSource(directory: string): RiddleProofSourceIdentity;
+declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework, options?: RiddlePreviewDeployOptions): Promise<RiddlePreviewDeployResult>;
 declare function collectRiddlePreviewDeployWarnings(directory: string, framework?: RiddlePreviewFramework): string[];
-declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
+declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string, options?: RiddlePreviewDeployOptions): Promise<RiddlePreviewDeployResult>;
 declare function parseRiddleViewport(value?: string): {
     width: number;
     height: number;
@@ -165,11 +178,11 @@ declare function createRiddleApiClient(config?: RiddleClientConfig): {
     apiKeySource: () => RiddleApiKeySource;
     requestJson: <T = unknown>(pathname: string, init?: RequestInit) => Promise<T>;
     getBalance: () => Promise<RiddleBalanceResult>;
-    deployPreview: (directory: string, label: string, framework?: RiddlePreviewFramework) => Promise<RiddlePreviewDeployResult>;
-    deployStaticPreview: (directory: string, label: string) => Promise<RiddlePreviewDeployResult>;
+    deployPreview: (directory: string, label: string, framework?: RiddlePreviewFramework, options?: RiddlePreviewDeployOptions) => Promise<RiddlePreviewDeployResult>;
+    deployStaticPreview: (directory: string, label: string, options?: RiddlePreviewDeployOptions) => Promise<RiddlePreviewDeployResult>;
     runScript: (input: RiddleRunScriptInput) => Promise<Record<string, unknown>>;
     runServerPreview: (input: RiddleServerPreviewInput) => Promise<RiddleServerPreviewResult>;
     pollJob: (jobId: string, options?: RiddlePollJobOptions) => Promise<RiddlePollJobResult>;
 };
 
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployProgressSnapshot, type RiddlePreviewDeployResult, type RiddlePreviewDeployStage, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployOptions, type RiddlePreviewDeployProgressSnapshot, type RiddlePreviewDeployResult, type RiddlePreviewDeployStage, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, detectRiddlePreviewSource, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.d.ts

@@ -1,3 +1,8 @@
+import { RiddleProofExecutionTelemetry, RiddleProofSourceIdentity, RiddlePreviewReceipt } from './receipts.js';
+import './profile.js';
+import './types.js';
+import './public-state.js';
+
 declare const DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
 declare const DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
 declare const RIDDLE_UNSUBMITTED_WAKE_HINT = "hosted worker may still be waking or waiting for a lease";
@@ -29,6 +34,7 @@ interface RiddleBalanceResult {
 interface RiddlePollProgressSnapshot {
     job_id: string;
     status: string | null;
+    phase: string | null;
     terminal: boolean;
     attempt: number;
     attempts: number;
@@ -39,6 +45,8 @@ interface RiddlePollProgressSnapshot {
     queue_elapsed_ms: number | null;
     pre_submission_elapsed_ms: number;
     running_without_submission: boolean;
+    active_execution: boolean;
+    execution?: RiddleProofExecutionTelemetry;
 }
 interface RiddlePollSummary extends RiddlePollProgressSnapshot {
     timed_out: boolean;
@@ -84,11 +92,15 @@ interface RiddlePreviewDeployResult {
     file_count?: number;
     total_bytes?: number;
     expires_at?: string;
+    receipt?: RiddlePreviewReceipt;
     publish_recovered?: boolean;
     publish_error?: string;
     warnings?: string[];
     raw?: Record<string, unknown>;
 }
+interface RiddlePreviewDeployOptions {
+    source?: RiddleProofSourceIdentity;
+}
 interface RiddleRunScriptInput {
     url: string;
     script: string;
@@ -150,9 +162,10 @@ declare function resolveRiddleApiKeySource(config?: RiddleClientConfig): RiddleA
 declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
 declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
 declare function getRiddleBalance(config?: RiddleClientConfig): Promise<RiddleBalanceResult>;
-declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework): Promise<RiddlePreviewDeployResult>;
+declare function detectRiddlePreviewSource(directory: string): RiddleProofSourceIdentity;
+declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework, options?: RiddlePreviewDeployOptions): Promise<RiddlePreviewDeployResult>;
 declare function collectRiddlePreviewDeployWarnings(directory: string, framework?: RiddlePreviewFramework): string[];
-declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
+declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string, options?: RiddlePreviewDeployOptions): Promise<RiddlePreviewDeployResult>;
 declare function parseRiddleViewport(value?: string): {
     width: number;
     height: number;
@@ -165,11 +178,11 @@ declare function createRiddleApiClient(config?: RiddleClientConfig): {
     apiKeySource: () => RiddleApiKeySource;
     requestJson: <T = unknown>(pathname: string, init?: RequestInit) => Promise<T>;
     getBalance: () => Promise<RiddleBalanceResult>;
-    deployPreview: (directory: string, label: string, framework?: RiddlePreviewFramework) => Promise<RiddlePreviewDeployResult>;
-    deployStaticPreview: (directory: string, label: string) => Promise<RiddlePreviewDeployResult>;
+    deployPreview: (directory: string, label: string, framework?: RiddlePreviewFramework, options?: RiddlePreviewDeployOptions) => Promise<RiddlePreviewDeployResult>;
+    deployStaticPreview: (directory: string, label: string, options?: RiddlePreviewDeployOptions) => Promise<RiddlePreviewDeployResult>;
     runScript: (input: RiddleRunScriptInput) => Promise<Record<string, unknown>>;
     runServerPreview: (input: RiddleServerPreviewInput) => Promise<RiddleServerPreviewResult>;
     pollJob: (jobId: string, options?: RiddlePollJobOptions) => Promise<RiddlePollJobResult>;
 };
 
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployProgressSnapshot, type RiddlePreviewDeployResult, type RiddlePreviewDeployStage, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployOptions, type RiddlePreviewDeployProgressSnapshot, type RiddlePreviewDeployResult, type RiddlePreviewDeployStage, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, detectRiddlePreviewSource, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.js

@@ -7,6 +7,7 @@ import {
   createRiddleApiClient,
   deployRiddlePreview,
   deployRiddleStaticPreview,
+  detectRiddlePreviewSource,
   getRiddleBalance,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,
@@ -16,7 +17,8 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-B2DP2LET.js";
+} from "./chunk-5IFZSUPF.js";
+import "./chunk-MEVVL4TI.js";
 import "./chunk-MLKGABMK.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
@@ -27,6 +29,7 @@ export {
   createRiddleApiClient,
   deployRiddlePreview,
   deployRiddleStaticPreview,
+  detectRiddlePreviewSource,
   getRiddleBalance,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,