@granular-software/sdk 0.4.67 → 0.4.69

package/dist/index.mjs

@@ -20409,6 +20409,258 @@ var Granular = class _Granular {
   }
 };
 
+// src/environment-setup.ts
+var EnvironmentSetupTerminalError = class extends Error {
+  constructor(setup) {
+    super(
+      setup?.errorMessage?.trim() || "Environment setup failed before all records were imported."
+    );
+    this.name = "EnvironmentSetupTerminalError";
+  }
+};
+function environmentSetupFailedError(setup) {
+  return new EnvironmentSetupTerminalError(setup);
+}
+function environmentSetupAbortError() {
+  const error = new Error("Environment setup polling was aborted.");
+  error.name = "AbortError";
+  return error;
+}
+function throwIfAborted(signal) {
+  if (signal.aborted) {
+    throw environmentSetupAbortError();
+  }
+}
+function abortableSleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal.aborted) {
+      reject(environmentSetupAbortError());
+      return;
+    }
+    const timeout = setTimeout(() => {
+      signal.removeEventListener("abort", abort);
+      resolve();
+    }, ms);
+    const abort = () => {
+      clearTimeout(timeout);
+      signal.removeEventListener("abort", abort);
+      reject(environmentSetupAbortError());
+    };
+    signal.addEventListener("abort", abort, { once: true });
+  });
+}
+function setupIsRunning(setup) {
+  return setup?.lifecycleStatus === "running";
+}
+function setupHasFailed(setup) {
+  return setup?.lifecycleStatus === "failed";
+}
+function hasRecordFailures(setup) {
+  return Boolean(
+    setup && (setup.failedRecords > 0 || setup.canceledRecords > 0)
+  );
+}
+function setupHasTerminalLifecycleFailure(setup) {
+  return setupHasFailed(setup);
+}
+function importsAreActive(summary) {
+  return Boolean(
+    summary && (summary.awaitingRecords > 0 || summary.activeImports > 0)
+  );
+}
+function numericRetryAfter(value) {
+  return typeof value === "number" && Number.isFinite(value) ? Math.max(0, Math.round(value)) : null;
+}
+function environmentSetupTimeoutError(maxDurationMs) {
+  return new Error(`Environment setup timed out after ${maxDurationMs}ms.`);
+}
+function environmentSetupProgressFromResponse(environment, response, retryAfterMs) {
+  const readiness = response.readiness;
+  const nextEnvironment = {
+    ...environment,
+    ...response.environment || {}
+  };
+  const explicitReady = typeof readiness?.ready === "boolean" ? readiness.ready : typeof response.ready === "boolean" ? response.ready : void 0;
+  const hasResponseSetup = Object.prototype.hasOwnProperty.call(
+    response,
+    "setup"
+  );
+  const hasReadinessSetup = readiness !== null && typeof readiness === "object" && Object.prototype.hasOwnProperty.call(readiness, "setup");
+  const hasEnvironmentSetup = response.environment !== null && typeof response.environment === "object" && Object.prototype.hasOwnProperty.call(response.environment, "setup");
+  const setup = hasResponseSetup ? response.setup ?? null : hasReadinessSetup ? readiness?.setup ?? null : hasEnvironmentSetup ? response.environment?.setup ?? null : explicitReady === true ? null : nextEnvironment.setup ?? null;
+  nextEnvironment.setup = setup;
+  const summary = response.summary ?? readiness?.summary ?? null;
+  const retry = [
+    retryAfterMs,
+    response.retryAfterMs,
+    readiness?.retryAfterMs
+  ].find((value) => typeof value === "number" && Number.isFinite(value));
+  const recordFailures = hasRecordFailures(setup) || hasRecordFailures(summary);
+  return {
+    environment: nextEnvironment,
+    setup,
+    summary,
+    ready: explicitReady !== false && !setupIsRunning(setup) && !setupHasFailed(setup) && (explicitReady === true || !recordFailures) && !importsAreActive(summary),
+    retryAfterMs: numericRetryAfter(retry)
+  };
+}
+function environmentSetupProgressFromError(environment, error) {
+  if (!error || typeof error !== "object") return null;
+  const candidate = error;
+  if (candidate.status !== 503 && candidate.status !== 202 || typeof candidate.body !== "string") {
+    return null;
+  }
+  try {
+    const response = JSON.parse(candidate.body);
+    const explicitReady = response?.readiness?.ready ?? (typeof response?.ready === "boolean" ? response.ready : void 0);
+    if (candidate.status === 202) {
+      const progress = environmentSetupProgressFromResponse(
+        environment,
+        response,
+        numericRetryAfter(candidate.retryAfterMs)
+      );
+      return explicitReady === void 0 ? { ...progress, ready: false } : progress;
+    }
+    return explicitReady === false ? environmentSetupProgressFromResponse(
+      environment,
+      response,
+      numericRetryAfter(candidate.retryAfterMs)
+    ) : null;
+  } catch {
+    return null;
+  }
+}
+function defaultTransientError(error) {
+  if (!error) return false;
+  const status = typeof error === "object" ? error.status : void 0;
+  if (typeof status === "number") {
+    return status === 408 || status === 425 || status === 429 || status >= 500;
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  return /failed to fetch|network error|network connection lost|connection (?:reset|closed|refused)|econnreset|socket hang up|socket connection was closed unexpectedly|dns|timed out/i.test(
+    message
+  );
+}
+async function pollEnvironmentSetup(input) {
+  const maxAttempts = Math.max(1, input.maxAttempts ?? 3);
+  const maxDurationMs = Math.max(1, input.maxDurationMs ?? 12e4);
+  const sleep2 = input.sleep || ((ms, signal2) => abortableSleep(ms, signal2 || new AbortController().signal));
+  const now = input.now || (() => Date.now());
+  const isTransientError = input.isTransientError || defaultTransientError;
+  const internalController = input.signal ? null : new AbortController();
+  const signal = input.signal || internalController.signal;
+  const startedAt = now();
+  let currentEnvironment = input.environment;
+  let transientFailures = 0;
+  let attempt = 0;
+  const waitForNextAttempt = async (requestedDelayMs) => {
+    throwIfAborted(signal);
+    const remainingMs = maxDurationMs - Math.max(0, now() - startedAt);
+    if (remainingMs <= 0) {
+      throw environmentSetupTimeoutError(maxDurationMs);
+    }
+    await sleep2(Math.min(Math.max(0, requestedDelayMs), remainingMs), signal);
+    throwIfAborted(signal);
+  };
+  const requestWithinDeadline = async (requestAttempt) => {
+    throwIfAborted(signal);
+    const remainingMs = maxDurationMs - Math.max(0, now() - startedAt);
+    if (remainingMs <= 0) {
+      throw environmentSetupTimeoutError(maxDurationMs);
+    }
+    const requestController = new AbortController();
+    let timeoutHandle = null;
+    let abortHandler = null;
+    const requestPromise = Promise.resolve().then(
+      () => input.request(requestAttempt, requestController.signal)
+    );
+    const timeoutPromise = new Promise((_, reject) => {
+      if (!Number.isFinite(remainingMs)) return;
+      timeoutHandle = setTimeout(
+        () => {
+          reject(environmentSetupTimeoutError(maxDurationMs));
+          requestController.abort();
+        },
+        Math.max(1, Math.ceil(remainingMs))
+      );
+    });
+    const abortPromise = new Promise((_, reject) => {
+      abortHandler = () => {
+        requestController.abort();
+        reject(environmentSetupAbortError());
+      };
+      signal.addEventListener("abort", abortHandler, { once: true });
+    });
+    try {
+      return await Promise.race([requestPromise, timeoutPromise, abortPromise]);
+    } finally {
+      if (timeoutHandle !== null) {
+        clearTimeout(timeoutHandle);
+      }
+      if (abortHandler !== null) {
+        signal.removeEventListener("abort", abortHandler);
+      }
+    }
+  };
+  while (true) {
+    throwIfAborted(signal);
+    if (now() - startedAt >= maxDurationMs) {
+      throw environmentSetupTimeoutError(maxDurationMs);
+    }
+    attempt += 1;
+    try {
+      const progress = environmentSetupProgressFromResponse(
+        currentEnvironment,
+        await requestWithinDeadline(attempt)
+      );
+      throwIfAborted(signal);
+      currentEnvironment = progress.environment;
+      input.onProgress?.(progress);
+      if (setupHasTerminalLifecycleFailure(progress.setup) && !progress.ready) {
+        throw environmentSetupFailedError(progress.setup);
+      }
+      if (progress.ready) return progress.environment;
+      transientFailures = 0;
+      await waitForNextAttempt(
+        progress.retryAfterMs ?? input.pollIntervalMs ?? 1e3
+      );
+    } catch (error) {
+      throwIfAborted(signal);
+      if (error instanceof EnvironmentSetupTerminalError) {
+        throw error;
+      }
+      const pending = environmentSetupProgressFromError(
+        currentEnvironment,
+        error
+      );
+      if (pending) {
+        currentEnvironment = pending.environment;
+        input.onProgress?.(pending);
+        if (setupHasTerminalLifecycleFailure(pending.setup) && !pending.ready) {
+          throw environmentSetupFailedError(pending.setup);
+        }
+        if (pending.ready) return pending.environment;
+        transientFailures = 0;
+        await waitForNextAttempt(
+          pending.retryAfterMs ?? input.pollIntervalMs ?? 1e3
+        );
+        continue;
+      }
+      if (!isTransientError(error) || transientFailures + 1 >= maxAttempts) {
+        throw error;
+      }
+      transientFailures += 1;
+      input.onRetry?.({ attempt: transientFailures, error });
+      const retryAfterMs = numericRetryAfter(
+        error && typeof error === "object" ? error.retryAfterMs : null
+      );
+      await waitForNextAttempt(
+        retryAfterMs ?? (input.retryDelayMs ?? 1500) * transientFailures
+      );
+    }
+  }
+}
+
 // src/record-snapshot-projection.ts
 function stableValue(value) {
   if (Array.isArray(value)) return value.map(stableValue);
@@ -23692,6 +23944,6 @@ function calculateOpenAITokenSpend(model, rawUsage) {
   };
 }
 
-export { Environment, EnvironmentSession, GRANULAR_FEED_DIAGNOSTIC_EVENT, Granular, OPENAI_MODEL_PRICING_USD_PER_MILLION, OntologyHandle, Session, SessionFeedController, WSClient, buildContinuationInstruction, buildContinuationInstructionFromTemplate, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentFileBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentManualActionBlock, buildGranularAgentManualActionMemorySummary, buildGranularAgentReferentBlock, buildGranularAgentRuntimeImportsBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentSystemPromptFromTemplate, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, buildOpenAISpendEventId, buildSessionTranscript, buildSessionTranscriptFromFeedItems, calculateOpenAITokenSpend, canonicalizeCommitValue, changedRecordSnapshots, consumeGranularReasoningOnlyChunk, consumeGranularReasoningTraceChunk, createFeedPublisher, createHarnessVerifierSnapshot, defineEffect, defineProjection, defineStateMachine, emitFeedDiagnostic, emitFeedDiagnosticToDefaultSink, emptyFeedSnapshot, evaluateContinuation, evaluateValidationRule, extractPromptTokens, getCurrentClosureId, getDefaultHarnessTemplateId, getExclusivePromptTarget, getOpenAIModelPricing, hasCanonicalSessionFeedActivation, hasOpenPrompt, hashHarnessTemplateValue, invokeRegisteredEffect, isCanonicalSessionFeedDocument, isGraphQLMutationDocument, isLocalApiUrl, listHarnessTemplates, mergeFeedItemsBySequence, normalizeEffectBehaviors, normalizeFeedDiagnostic, normalizeFeedDiagnosticKind, normalizeFeedPage, normalizeOpenAIUsage, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, orderTransientFeedItems, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectRecordSnapshotMutation, projectSessionFileSummary, projectWorkflowFocus, projectWorkflowSummary, readSessionFeedSnapshot, recordOpenAIUsageSpend, renderContinuationInstructionFromTemplate, renderGranularAgentSystemPromptFromTemplate, resolveApiUrl, resolveAuthTokenForApiUrl, resolveHarnessTemplate, resolveJobPresentation, resolvePromptAnswer, reviewGeneratedJobCode, scorePromptChoiceMatch, stripGranularReasoningTrace, toGranularHttpBase, validateHarnessTemplateManifest, validateProjectionResult, validationRuleFailureMessage };
+export { Environment, EnvironmentSession, GRANULAR_FEED_DIAGNOSTIC_EVENT, Granular, OPENAI_MODEL_PRICING_USD_PER_MILLION, OntologyHandle, Session, SessionFeedController, WSClient, buildContinuationInstruction, buildContinuationInstructionFromTemplate, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentFileBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentManualActionBlock, buildGranularAgentManualActionMemorySummary, buildGranularAgentReferentBlock, buildGranularAgentRuntimeImportsBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentSystemPromptFromTemplate, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, buildOpenAISpendEventId, buildSessionTranscript, buildSessionTranscriptFromFeedItems, calculateOpenAITokenSpend, canonicalizeCommitValue, changedRecordSnapshots, consumeGranularReasoningOnlyChunk, consumeGranularReasoningTraceChunk, createFeedPublisher, createHarnessVerifierSnapshot, defineEffect, defineProjection, defineStateMachine, emitFeedDiagnostic, emitFeedDiagnosticToDefaultSink, emptyFeedSnapshot, environmentSetupProgressFromError, environmentSetupProgressFromResponse, evaluateContinuation, evaluateValidationRule, extractPromptTokens, getCurrentClosureId, getDefaultHarnessTemplateId, getExclusivePromptTarget, getOpenAIModelPricing, hasCanonicalSessionFeedActivation, hasOpenPrompt, hashHarnessTemplateValue, invokeRegisteredEffect, isCanonicalSessionFeedDocument, isGraphQLMutationDocument, isLocalApiUrl, listHarnessTemplates, mergeFeedItemsBySequence, normalizeEffectBehaviors, normalizeFeedDiagnostic, normalizeFeedDiagnosticKind, normalizeFeedPage, normalizeOpenAIUsage, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, orderTransientFeedItems, pollEnvironmentSetup, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectRecordSnapshotMutation, projectSessionFileSummary, projectWorkflowFocus, projectWorkflowSummary, readSessionFeedSnapshot, recordOpenAIUsageSpend, renderContinuationInstructionFromTemplate, renderGranularAgentSystemPromptFromTemplate, resolveApiUrl, resolveAuthTokenForApiUrl, resolveHarnessTemplate, resolveJobPresentation, resolvePromptAnswer, reviewGeneratedJobCode, scorePromptChoiceMatch, stripGranularReasoningTrace, toGranularHttpBase, validateHarnessTemplateManifest, validateProjectionResult, validationRuleFailureMessage };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map