shiplightai 0.1.49 → 0.1.50

package/dist/fixture.d.ts

@@ -43,6 +43,30 @@ interface TestContext {
     [key: string]: any;
 }
 declare function createTestContext(variableStore: VariableStore): TestContext;
+/**
+ * Explicit allowlist of environment variable names that Shiplight forwards
+ * from `process.env` into sdk-core's internal `SdkConfig.env`. sdk-core is
+ * strict — it reads env vars only from `SdkConfig.env`, never from
+ * `process.env` directly — so this allowlist is the single point where
+ * user-visible env state crosses into the agent runtime.
+ *
+ * To add a new env var that sdk-core should honor, append it here AND make
+ * sure a corresponding consumer exists in `packages/sdk-core/src`. Do NOT
+ * spread `process.env` into this object — the allowlist exists so that user
+ * test code cannot exfiltrate arbitrary shell state through the SDK.
+ *
+ * Keep in sync with the "Environment variables" section of the public
+ * documentation at `docs.shiplight.ai/local/cli-reference`.
+ */
+declare const SDK_ENV_ALLOWLIST: readonly ["GOOGLE_API_KEY", "ANTHROPIC_API_KEY", "OPENAI_API_KEY", "OPENAI_BASE_URL", "ANTHROPIC_MODELS_USE_VERTEXAI", "GOOGLE_GENAI_USE_VERTEXAI", "GOOGLE_CLOUD_PROJECT", "GOOGLE_CLOUD_LOCATION", "MAILGUN_API_KEY", "MAILGUN_DOMAIN"];
+/**
+ * Pick the allowlisted env vars out of a source record (defaults to
+ * `process.env`) and return them as a plain object with empty-string
+ * fallbacks. The empty-string default is deliberate — sdk-core checks
+ * `config.env?.KEY` for truthiness, and an empty string is falsy, so an
+ * unset allowlisted key behaves the same as an entirely missing key.
+ */
+declare function buildSdkEnv(source?: Record<string, string | undefined>): Record<string, string>;
 type ShiplightFixtures = {
     agent: WebAgent;
     testContext: TestContext;
@@ -56,4 +80,4 @@ type ShiplightFixtures = {
 };
 declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & ShiplightFixtures, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
 
-export { type AuthSpec, type TestContext, createTestContext, resolveAuthState, test };
+export { type AuthSpec, SDK_ENV_ALLOWLIST, type TestContext, buildSdkEnv, createTestContext, resolveAuthState, test };