@trayai/helix-sdk 0.113.0 → 0.115.0

package/dist/config-loader-BqIGpFg8.d.ts

@@ -0,0 +1,383 @@
+import { z } from 'zod';
+
+interface SdkRuntimeConfig {
+    /**
+     * Execution mode. `"lambda"` is set via `setSdkConfig({ mode: "lambda", ... })`
+     * before the first handler invocation. `"dev"` is the default for `helix dev`
+     * and local invocations.
+     */
+    mode: "lambda" | "dev";
+    /**
+     * Execution ID for the current invocation. Set via `setSdkConfig(...)` at
+     * handler entry in lambda mode. In `dev` mode, define-function falls back to
+     * the `x-tray-execution-id` header (or a random UUID).
+     */
+    executionId?: string;
+    /**
+     * User ID for the current invocation. Set via `setSdkConfig(...)` at handler
+     * entry in lambda mode. In `dev` mode, define-function reads from the
+     * `x-tray-user-id` header.
+     */
+    userId?: string;
+    /**
+     * Deployment ID for the current invocation. Set via `setSdkConfig(...)` at
+     * handler entry. Only meaningful in `lambda` mode; `dev` mode has no
+     * deployment concept yet.
+     */
+    deploymentId?: string | null;
+    /**
+     * Running dev server's own base URL (e.g. `http://localhost:3000`). Set by
+     * the CLI's `sdk-context` Nitro plugin in `dev` mode so `ctx.files()` can
+     * build local signed URLs pointing at `/_helix/files/**`. Absent in `lambda`
+     * mode — production signed URLs point at the platform API host instead.
+     */
+    devServerUrl?: string;
+    /**
+     * Absolute path to the project root in `dev` mode, set by the CLI's
+     * `sdk-context` Nitro plugin. Used by `ctx.files()`'s local dev store to
+     * resolve `.helix/files/` on disk. Absent in `lambda` mode.
+     */
+    projectRoot?: string;
+    /**
+     * The calling execution's id, set via `setSdkConfig(...)` only for a
+     * function-call-triggered invocation (`ctx.callFunctionAsync`, SUR-929).
+     * The shim explicitly clears this (passes `undefined`) on every other
+     * invocation kind so a warm container never leaks a prior call's parentage.
+     */
+    parentExecutionId?: string | null;
+}
+interface BrokerSecrets {
+    internalJwt?: string;
+    helixExecutionJwt?: string;
+    devToken?: string;
+}
+interface SdkConfigInput extends Partial<SdkRuntimeConfig>, BrokerSecrets {
+}
+declare function setSdkConfig(options: SdkConfigInput): void;
+declare function getSdkConfig(): Readonly<SdkRuntimeConfig>;
+
+declare const projectIdSchema: z.ZodString;
+declare const workspaceIdSchema: z.ZodString;
+/**
+ * AI provider declaration (helix-spec 11). The Vercel AI SDK builds
+ * provider-native requests client-side, so `ctx.ai(alias)` must know which
+ * `@ai-sdk/*` package serves the alias BEFORE any request exists — and
+ * platform authentications carry no service identifier, so the project
+ * declares it here: `aiProviders: { <authAlias>: "<service>" }`. The
+ * `openai-compatible` service (self-hosted vLLM, Ollama, …) additionally
+ * needs the endpoint base URL, so it uses the object form.
+ *
+ * `baseUrl` must be https: every `ctx.ai` request egresses through the
+ * credentials broker's raw forward proxy, and `createBrokerFetch` rejects
+ * non-https destinations unconditionally (no dev/local exception) — so an
+ * http endpoint (a bare local Ollama/vLLM instance, say) would load fine here
+ * and then fail on every request. Catching it in the schema turns that into
+ * one clear config error instead of a confusing first-call failure.
+ */
+declare const AI_SERVICES: readonly ["openai", "anthropic", "google", "mistral", "cohere", "openai-compatible"];
+type AiService = (typeof AI_SERVICES)[number];
+declare const aiProviderEntrySchema: z.ZodUnion<[z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere"]>, z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    service: z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere", "openai-compatible"]>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+    baseUrl?: string | undefined;
+}, {
+    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+    baseUrl?: string | undefined;
+}>, {
+    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+    baseUrl?: string | undefined;
+}, {
+    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+    baseUrl?: string | undefined;
+}>, {
+    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+    baseUrl?: string | undefined;
+}, {
+    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+    baseUrl?: string | undefined;
+}>]>;
+type AiProviderEntry = z.infer<typeof aiProviderEntrySchema>;
+declare const trayConfigSchema: z.ZodEffects<z.ZodObject<{
+    name: z.ZodString;
+    projectId: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    /**
+     * @deprecated Renamed to `region` (SUR-1069). `env`'s only legal value,
+     * pre-rename, was `"production"` (the sole environment before regions
+     * existed) — which is exactly the same physical region as `region`'s
+     * default, `"us1"`. So `env`'s value never needs translating: its mere
+     * presence (validated below) is enough to keep old configs building;
+     * the transform below defaults `region` to `"us1"` whether `env` was
+     * `"production"` or simply absent. Kept for one release cycle.
+     */
+    env: z.ZodOptional<z.ZodLiteral<"production">>;
+    authentications: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    config: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    aiProviders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere"]>, z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        service: z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere", "openai-compatible"]>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>]>>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    authentications: Record<string, string>;
+    config: Record<string, unknown>;
+    projectId?: string | undefined;
+    workspaceId?: string | undefined;
+    region?: string | undefined;
+    env?: "production" | undefined;
+    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }> | undefined;
+}, {
+    name: string;
+    projectId?: string | undefined;
+    workspaceId?: string | undefined;
+    region?: string | undefined;
+    env?: "production" | undefined;
+    authentications?: Record<string, string> | undefined;
+    config?: Record<string, unknown> | undefined;
+    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }> | undefined;
+}>, {
+    region: string;
+    name: string;
+    authentications: Record<string, string>;
+    config: Record<string, unknown>;
+    projectId?: string | undefined;
+    workspaceId?: string | undefined;
+    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }> | undefined;
+}, {
+    name: string;
+    projectId?: string | undefined;
+    workspaceId?: string | undefined;
+    region?: string | undefined;
+    env?: "production" | undefined;
+    authentications?: Record<string, string> | undefined;
+    config?: Record<string, unknown> | undefined;
+    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }> | undefined;
+}>;
+/** User-facing config type — auth/config optional; Zod defaults fill at load time. */
+type TrayConfig = z.input<typeof trayConfigSchema>;
+/**
+ * Runtime validator for the LoadedTrayConfig discriminated union.
+ * Used to validate BroadcastChannel payloads before calling setActiveConfig —
+ * prevents malformed cross-channel data from corrupting the worker-local
+ * config slot.
+ */
+declare const loadedTrayConfigSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    name: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    region: z.ZodEffects<z.ZodString, string, string>;
+    authentications: z.ZodRecord<z.ZodString, z.ZodString>;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    aiProviders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere"]>, z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        service: z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere", "openai-compatible"]>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>]>>>;
+} & {
+    kind: z.ZodLiteral<"provisioned">;
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "provisioned";
+    name: string;
+    projectId: string;
+    region: string;
+    authentications: Record<string, string>;
+    config: Record<string, unknown>;
+    workspaceId?: string | undefined;
+    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }> | undefined;
+}, {
+    kind: "provisioned";
+    name: string;
+    projectId: string;
+    region: string;
+    authentications: Record<string, string>;
+    config: Record<string, unknown>;
+    workspaceId?: string | undefined;
+    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }> | undefined;
+}>, z.ZodObject<{
+    name: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    region: z.ZodEffects<z.ZodString, string, string>;
+    authentications: z.ZodRecord<z.ZodString, z.ZodString>;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    aiProviders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere"]>, z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        service: z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere", "openai-compatible"]>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }, {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }>]>>>;
+} & {
+    kind: z.ZodLiteral<"unprovisioned">;
+}, "strip", z.ZodTypeAny, {
+    kind: "unprovisioned";
+    name: string;
+    region: string;
+    authentications: Record<string, string>;
+    config: Record<string, unknown>;
+    workspaceId?: string | undefined;
+    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }> | undefined;
+}, {
+    kind: "unprovisioned";
+    name: string;
+    region: string;
+    authentications: Record<string, string>;
+    config: Record<string, unknown>;
+    workspaceId?: string | undefined;
+    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
+        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "openai-compatible";
+        baseUrl?: string | undefined;
+    }> | undefined;
+}>]>;
+/** Base fields on all config variants — schema output minus projectId. */
+type LoadedTrayConfigBase = Omit<z.output<typeof trayConfigSchema>, "projectId">;
+/**
+ * Discriminated union returned by loadConfig / ConfigService#get.
+ * - "provisioned" — projectId present, no optional-chaining needed.
+ * - "unprovisioned" — `projectId?: never` structurally excludes it.
+ * workspaceId is optional on both variants — independent of provisioning.
+ */
+type LoadedTrayConfig = ({
+    kind: "provisioned";
+    projectId: string;
+} & LoadedTrayConfigBase) | ({
+    kind: "unprovisioned";
+    projectId?: never;
+} & LoadedTrayConfigBase);
+type ProvisionedTrayConfig = Extract<LoadedTrayConfig, {
+    kind: "provisioned";
+}>;
+type UnprovisionedTrayConfig = Extract<LoadedTrayConfig, {
+    kind: "unprovisioned";
+}>;
+/**
+ * Env var naming an alternate config file (relative paths resolve against cwd).
+ * Sits between the explicit `configFile` option (the CLI's `--config` flag) and
+ * the `helix.config.ts` default in resolution precedence.
+ */
+declare const HELIX_CONFIG_ENV = "HELIX_CONFIG";
+/** Options accepted by every config entry point that resolves the config file. */
+interface ConfigFileOptions {
+    /**
+     * Explicit config file path (the CLI's `--config` flag). Resolution
+     * precedence: this option → `HELIX_CONFIG` env var → `helix.config.ts`
+     * (then legacy `tray.config.*`) in cwd.
+     */
+    configFile?: string;
+}
+/**
+ * The effective config-file override, if any: the explicit `configFile` option
+ * (CLI `--config` flag) wins over the `HELIX_CONFIG` env var. Returns the raw
+ * (possibly relative) path — callers resolve it against their cwd.
+ */
+declare function resolveConfigOverride(configFile?: string): string | undefined;
+/**
+ * Absolute path of the project config file in `cwd`, preferring `helix.config.*`
+ * and falling back to a legacy `tray.config.*`. Returns undefined when neither exists.
+ * A config-file override (option or HELIX_CONFIG) replaces the default search
+ * entirely: only the named file is considered.
+ */
+declare function resolveConfigFile(cwd: string, options?: ConfigFileOptions): string | undefined;
+/**
+ * One-shot stateless read of the project config. NO caching — every call hits disk.
+ * Reads `helix.config.ts` (legacy `tray.config.*` fallback) unless an override
+ * names another file — `options.configFile` (CLI `--config` flag) first, then
+ * the `HELIX_CONFIG` env var. For hot-reload or stable snapshot, use
+ * {@link createConfigService} instead.
+ */
+declare function loadConfig(cwd?: string, options?: ConfigFileOptions): Promise<LoadedTrayConfig>;
+/** Phase that surfaced an error inside ConfigService watcher. */
+type WatchErrorPhase = "attach" | "reload" | "validation";
+/** Stable code on errors thrown by {@link requireWorkspaceId}. Narrow by this, not instanceof. */
+declare const WORKSPACE_ID_REQUIRED_CODE: "WORKSPACE_ID_REQUIRED";
+/**
+ * Shape of errors thrown by {@link requireWorkspaceId}.
+ * Type alias — no class hierarchy; callers narrow via `error.code === WORKSPACE_ID_REQUIRED_CODE`.
+ *
+ * The thrown message references CLI (`helix workspace select` / `helix workspace set`)
+ * and MCP (`tray_list_workspaces` / `tray_set_workspace_id`) commands — keep those
+ * names in sync with the message literal in requireWorkspaceId.
+ */
+type WorkspaceIdRequiredError = Error & {
+    readonly code: typeof WORKSPACE_ID_REQUIRED_CODE;
+};
+/**
+ * Returns workspaceId from config, or throws a plain Error with code WORKSPACE_ID_REQUIRED.
+ * Pure, no I/O. workspaceId is independent of provisioning state.
+ */
+declare function requireWorkspaceId(config: LoadedTrayConfig): string;
+
+export { AI_SERVICES as A, type ConfigFileOptions as C, HELIX_CONFIG_ENV as H, type LoadedTrayConfig as L, type ProvisionedTrayConfig as P, type SdkRuntimeConfig as S, type TrayConfig as T, type UnprovisionedTrayConfig as U, type WatchErrorPhase as W, type AiProviderEntry as a, type AiService as b, WORKSPACE_ID_REQUIRED_CODE as c, type WorkspaceIdRequiredError as d, aiProviderEntrySchema as e, loadedTrayConfigSchema as f, getSdkConfig as g, resolveConfigFile as h, resolveConfigOverride as i, type SdkConfigInput as j, loadConfig as l, projectIdSchema as p, requireWorkspaceId as r, setSdkConfig as s, workspaceIdSchema as w };

package/dist/index.d.ts

@@ -1,11 +1,13 @@
 import * as h3 from 'h3';
 import { ZodType } from 'zod';
-import { F as FunctionHandler, D as DefineFunctionOptions, a as DefineScheduleConfig, S as ScheduleDefinition, P as PlatformContext } from './types-DoNQWbb9.js';
-export { B as BrokerAuthedClient, b as BrokerCallOptions, c as BrokerCallResult, C as CallFunctionAsync, d as DbCallParameters, e as DbClient, f as FileSystemClient, H as HttpClient, K as KeyValueStore, L as Logger, g as S3SignOptions, h as S3SignResult, i as ScheduleContext, j as ScheduleHandler, k as ScheduleTrigger, l as SqlBuilder, T as TrayContext, U as UnvalidatedInput } from './types-DoNQWbb9.js';
-import { T as TrayConfig, L as LoadedTrayConfig, W as WatchErrorPhase } from './sdk-config-DU6cWbLW.js';
-export { C as ConfigFileOptions, H as HELIX_CONFIG_ENV, P as ProvisionedTrayConfig, S as SdkRuntimeConfig, U as UnprovisionedTrayConfig, a as WORKSPACE_ID_REQUIRED_CODE, b as WorkspaceIdRequiredError, g as getSdkConfig, l as loadConfig, c as loadedTrayConfigSchema, p as projectIdSchema, r as requireWorkspaceId, d as resolveConfigFile, e as resolveConfigOverride, w as workspaceIdSchema } from './sdk-config-DU6cWbLW.js';
-export { a as ENVIRONMENT_VALUES, E as Environment, e as environmentSchema } from './env-schema-DkgTG5b0.js';
+import { F as FunctionHandler, D as DefineFunctionOptions, a as DefineScheduleConfig, S as ScheduleDefinition, P as PlatformContext } from './types-B9ZTUx-H.js';
+export { A as AiEmbeddingModelInstance, b as AiImageModelInstance, c as AiLanguageModelInstance, d as AiSpeechModelInstance, e as AiTranscriptionModelInstance, B as BrokerAuthedClient, f as BrokerCallOptions, g as BrokerCallResult, C as CallFunctionAsync, h as DbCallParameters, i as DbClient, j as FileSystemClient, H as HelixAI, k as HelixAIProvider, l as HelixCost, m as HelixResultMeta, n as HttpClient, K as KeyValueStore, L as Logger, o as S3SignOptions, p as S3SignResult, q as ScheduleContext, r as ScheduleHandler, s as ScheduleTrigger, t as SqlBuilder, T as TrayContext, U as UnvalidatedInput } from './types-B9ZTUx-H.js';
+import { T as TrayConfig, L as LoadedTrayConfig, W as WatchErrorPhase } from './config-loader-BqIGpFg8.js';
+export { A as AI_SERVICES, a as AiProviderEntry, b as AiService, C as ConfigFileOptions, H as HELIX_CONFIG_ENV, P as ProvisionedTrayConfig, S as SdkRuntimeConfig, U as UnprovisionedTrayConfig, c as WORKSPACE_ID_REQUIRED_CODE, d as WorkspaceIdRequiredError, e as aiProviderEntrySchema, g as getSdkConfig, l as loadConfig, f as loadedTrayConfigSchema, p as projectIdSchema, r as requireWorkspaceId, h as resolveConfigFile, i as resolveConfigOverride, w as workspaceIdSchema } from './config-loader-BqIGpFg8.js';
+export { a as REGION_VALUES, R as Region, r as regionSchema } from './region-schema-COfWyGI9.js';
+export { EmbedManyResult, EmbedResult, EmbeddingModel, FinishReason, GenerateImageResult, GenerateObjectResult, GenerateTextResult, ImageModel, LanguageModel, LanguageModelUsage, ModelMessage, Output, PrepareStepFunction, SpeechModel, SpeechResult, StopCondition, StreamObjectResult, StreamTextResult, TextStreamPart, ToolChoice, ToolSet, TranscriptionModel, TranscriptionResult, UIMessage, convertToModelMessages, cosineSimilarity, dynamicTool, hasToolCall, jsonSchema, smoothStream, stepCountIs, tool, zodSchema } from 'ai';
 import 'ky';
+import '@ai-sdk/provider';
 
 declare function defineFunction<TInput extends ZodType | undefined = undefined, TOutput extends ZodType | undefined = undefined>(handler: FunctionHandler<TInput extends ZodType ? ReturnType<TInput["parse"]> : Record<string, unknown>>, schemaOrOptions?: ZodType | DefineFunctionOptions<TInput, TOutput>): h3.EventHandler<h3.EventHandlerRequest, Promise<unknown>>;
 

package/dist/index.js

@@ -1,4 +1,4 @@
-import{A as ke,B as Se,C as xe,D as _e,b as R,h as M,i as F,j as Z,k as E,l as B,m as K,n as V,o as z,p as Ee,q as J,r as Q,s as Y,t as ee,u as te,y as re,z as ne}from"./chunk-QWCCRTLO.js";import{a as G,b as we}from"./chunk-WUCX7RZO.js";import{b as U,e as $,i as q,l as g,m as X}from"./chunk-KUXDW5ED.js";import{randomUUID as je}from"crypto";import{SpanStatusCode as de,SpanKind as De}from"@opentelemetry/api";import{defineEventHandler as Ae,getMethod as He,getRequestURL as We,getHeaders as ue,getHeader as ce}from"h3";import{readBody as Ie,getQuery as be,getRouterParams as Te}from"h3";async function oe(e,t){let r=await Re(e),n=be(e),o=Te(e)??{},i={...n,...r,...o};return t?Fe(i,t):i}async function Re(e){try{let t=await Ie(e);return t&&typeof t=="object"?t:(t!=null&&t!==""&&console.warn("[helix-sdk] Request body present but not a JSON object \u2014 ignored"),{})}catch(t){if(t instanceof Error&&"statusCode"in t&&t.statusCode===400){let n=new Error("Malformed request body");throw n.statusCode=400,n.data={message:"Request body is not valid JSON"},n}let r=e.method?.toUpperCase();if(r==="GET"||r==="HEAD"||r==="DELETE")return{};throw t}}function Fe(e,t){let r=t.safeParse(e);if(!r.success){let n=new Error("Input validation failed");throw n.statusCode=400,n.data=r.error.flatten(),n}return r.data}var w=class extends Error{statusCode;constructor(t,r){super(r),this.statusCode=t,this.name="HttpError"}};function ie(e){return t=>{e.node.res.statusCode=t}}function se(){return(e,t)=>{throw new w(e,t)}}function ae(e,t){let{statusCode:r,message:n}=Pe(t.detail);return e.node.res.statusCode=r,{error:n,statusCode:r}}function Pe(e){switch(e.kind){case"unknown_alias":return{statusCode:400,message:"Unknown authentication alias"};case"input_validation_failed":return{statusCode:400,message:"Input validation failed"};case"output_validation_failed":return{statusCode:500,message:"Internal server error"};case"config_load_failed":return{statusCode:500,message:"Configuration error"};case"broker_error":return{statusCode:502,message:"Broker error"};case"unsupported_body_type":return{statusCode:400,message:"Unsupported request body type"};case"unsupported_scheme":return{statusCode:400,message:"Unsupported URL scheme"};case"missing_execution_credentials":return{statusCode:401,message:"Missing execution credentials"};case"missing_tray_token":return{statusCode:500,message:"Missing Tray token"};case"db_call_failed":return{statusCode:502,message:e.message};case"db_query_failed":return{statusCode:502,message:`Database query failed: ${e.message}`};case"db_invalid_parameters":return{statusCode:400,message:e.message};case"kv_key_invalid":return{statusCode:400,message:e.message};case"kv_value_invalid":return{statusCode:400,message:e.message};case"kv_value_too_large":return{statusCode:400,message:e.message};case"kv_ttl_invalid":return{statusCode:400,message:e.message};case"kv_not_available":return{statusCode:501,message:"Key-value store is not available in this environment"};case"kv_call_failed":return{statusCode:502,message:"Key-value store request failed"};case"kv_requires_provisioning":return{statusCode:500,message:"Internal server error"};case"files_path_invalid":return{statusCode:400,message:e.message};case"files_value_invalid":return{statusCode:400,message:e.message};case"files_value_too_large":return{statusCode:400,message:e.message};case"files_not_available":return{statusCode:501,message:"File storage is not available in this environment"};case"files_call_failed":return{statusCode:502,message:"File storage request failed"};case"files_requires_provisioning":return{statusCode:500,message:"Internal server error"};case"call_function_path_invalid":return{statusCode:400,message:e.message};case"call_function_call_failed":return{statusCode:502,message:"Async function call failed"};case"call_function_requires_provisioning":return{statusCode:500,message:"Internal server error"};case"call_function_not_available":return{statusCode:501,message:"callFunctionAsync is not available in this environment"};case"call_function_missing_execution_jwt":return{statusCode:401,message:"Missing execution credentials"};default:return{statusCode:500,message:`Unhandled error kind: ${e.kind}`}}}var Le=["authorization","x-tray-token","set-cookie","x-kong-request-id","traceparent","x-real-ip","cookie"];function Oe(e){return e.toLowerCase().includes("tray_lid")}function P(e){let t={};for(let[r,n]of Object.entries(e))if(!Le.includes(r.toLowerCase())){if(r.toLowerCase()==="cookie"&&n){let o=n.split(";").map(i=>i.trim()).filter(i=>{let d=i.split("=")[0].trim();return!Oe(d)}).join("; ");o&&(t[r]=o);continue}t[r]=n}return t}function Ne(e,t){let{inputSchema:r,outputSchema:n}=Be(t),o=e;return Ae(async i=>{let d=R(),{executionId:s,userId:a,deploymentId:f}=Ke(d,i),l=d.mode==="lambda"?d.parentExecutionId??null:null,y=Date.now(),S=new Date().toISOString(),p=He(i),u=We(i).pathname,C=Q(),v=J(),Ce=`${p} ${u}`;B();let N={hasDb:!1,hasExternal:!1,hasAuth:!1,hasError:!1};return Ue(()=>F.run(N,()=>M.run(s,async()=>{let x=await $e(i,r);if(!x.ok)return{response:x.response,errored:!1,errorMessage:null};let ve=ze(i,x.input,C,v,p,u,s,f,a,l);return qe(o,ve,n,i,v,s,f,{method:p,path:u,rawInput:x.input})})),{executionId:s,deploymentId:f,routeOrJob:Ce,startedAt:S,startMs:y,userId:a,flags:N})})}async function Ue(e,t){let r=!1,n=null;try{let o=await e();return r=o.errored,n=o.errorMessage,o.response}finally{z({...t,errored:r,errorMessage:n}),await K()}}async function $e(e,t){try{return{ok:!0,input:await oe(e,t)}}catch(r){let n=Ve(e,r);if(n)return{ok:!1,response:n};throw r}}async function qe(e,t,r,n,o,i,d,s){return V.startActiveSpan("function",{root:!0,kind:De.SERVER,attributes:{method:s.method,route:s.path,executionId:i,...d?{deploymentId:d}:{}}},async a=>{t.traceId=a.spanContext().traceId;let f=P(ue(n));E(a,"input",s.rawInput),E(a,"request",{method:s.method,path:s.path,headers:f,body:s.rawInput});let l=!1,y=null,S,p;try{let u=await G.run(t,()=>e(t));if(S=u,u==null)n.node.res.statusCode=204,p="";else if(u instanceof Response)p=u;else if(r){let C=r.safeParse(u);if(!C.success){let v=Object.keys(C.error.flatten().fieldErrors);throw o.error("Output validation failed",{fields:v,executionId:i}),g.outputValidationFailed(v)}p=C.data}else p=u}catch(u){l=!0,y=u instanceof Error?u.message:String(u),Z("hasError"),p=Me(u,n,o,i)}finally{Ze(a,n,{errored:l,errorMessage:y,handlerResult:S,response:p})}return{response:p,errored:l,errorMessage:y}})}function Me(e,t,r,n){if(e instanceof w)return t.node.res.statusCode=e.statusCode,{error:e.message,statusCode:e.statusCode};if(X(e))return ae(t,e);r.error("Unhandled error in handler",{error:e instanceof Error?e.message:String(e),executionId:n}),t.node.res.statusCode=500;let o=process.env.NODE_ENV==="development";return{error:o&&e instanceof Error?e.message:"Internal server error",statusCode:500,...o&&e instanceof Error&&e.stack?{stack:e.stack}:{}}}function Ze(e,t,r){e.setAttribute("statusCode",t.node.res.statusCode),!r.errored&&r.handlerResult!==void 0&&E(e,"output",r.handlerResult),E(e,"response",r.response);let n=F.getStore();e.setAttribute("hasAuth",n?.hasAuth??!1),e.setAttribute("hasExternal",n?.hasExternal??!1),e.setAttribute("hasDb",n?.hasDb??!1),e.setAttribute("status",r.errored?"error":"success");let o=r.errored||(n?.hasError??!1);e.setStatus({code:o?de.ERROR:de.OK,...r.errorMessage?{message:r.errorMessage}:{}}),e.end()}function Be(e){if(!e)return{inputSchema:void 0,outputSchema:void 0};if(e instanceof Object&&"_def"in e)return{inputSchema:e,outputSchema:void 0};if(typeof e=="object"&&("input"in e||"output"in e)){let t=e;return{inputSchema:t.input,outputSchema:t.output}}return{inputSchema:e,outputSchema:void 0}}function Ke(e,t){let r=e.mode==="lambda",n=(r?e.executionId:ce(t,"x-tray-execution-id"))??je(),o=(r?e.userId:ce(t,"x-tray-user-id"))??null,i=r?e.deploymentId??null:null;return{executionId:n,userId:o,deploymentId:i}}function Ve(e,t){if(!(t instanceof Error)||!("statusCode"in t)||!("data"in t))return null;let r=t.statusCode,n=t.data;e.node.res.statusCode=r;let o=n&&typeof n=="object"&&"fieldErrors"in n?n.fieldErrors:void 0;return{error:"Input validation failed",statusCode:r,...o?{fields:Object.keys(o)}:{}}}function ze(e,t,r,n,o,i,d,s,a,f){return{input:t,method:o,path:i,headers:P(ue(e)),http:Y(),db:l=>ee(l),kv:()=>te(),files:()=>re(),callFunctionAsync:ne(),log:n,config:r,status:ie(e),error:se(),state:{},request:e,executionId:d,deploymentId:s,userId:a,parentExecutionId:f,identity:a!==null?{user:{id:a}}:null,traceId:""}}function Ge(e){return e}import{resolve as m}from"path";import{existsSync as I,realpathSync as fe}from"fs";import{loadConfig as Xe}from"c12";import{z as c}from"zod";import{z as Je}from"zod";var Qe=["production"],_=Je.string().refine(e=>U(e),e=>({message:`Invalid enum value. Expected ${$().map(t=>`'${t}'`).join(" | ")}, received '${e}'`}));var L=c.string().uuid("projectId must be a valid UUID"),O=c.string().min(1,"workspaceId must be a non-empty string"),Ye=c.object({name:c.string().min(1,"name is required"),projectId:L.optional(),workspaceId:O.optional(),env:_.default("production"),authentications:c.record(c.string()).optional().default({}),config:c.record(c.unknown()).optional().default({})}),le=c.object({name:c.string().min(1,"name is required"),workspaceId:O.optional(),env:_,authentications:c.record(c.string()),config:c.record(c.unknown())}),et=c.discriminatedUnion("kind",[le.extend({kind:c.literal("provisioned"),projectId:L}),le.extend({kind:c.literal("unprovisioned")})]),pe=["helix","tray"],ge=["ts","mts","cts","js","mjs","cjs"],j="HELIX_CONFIG";function h(e){let t=e?.trim();return t||process.env[j]?.trim()||void 0}function b(e,t){let r=h(t?.configFile);if(r!==void 0){let n=m(e,r);return I(n)?n:void 0}for(let n of pe)for(let o of ge){let i=m(e,`${n}.config.${o}`);if(I(i))return i}}function tt(e){for(let t of pe)if(ge.some(r=>I(m(e,`${t}.config.${r}`))))return t;return"helix"}function rt(e,t){return m(e,t).replace(/\.(?:m|c)?[jt]s$/,"")}function D(e,t){let r=h(t?.configFile);return{name:tt(e),cwd:e,...r!==void 0?{configFile:rt(e,r)}:{},rcFile:!1,globalRc:!1,packageJson:!1,dotenv:!1,extend:!1}}function A(e,t){if(e!==null&&typeof e=="object"&&"extends"in e)throw g.configLoadFailed(`helix.config.ts at ${t}: 'extends' is not supported \u2014 remove the field`);let r=Ye.safeParse(e);if(!r.success){let f=r.error.issues.map(l=>l.message).join("; ");throw g.configLoadFailed(`Invalid helix.config.ts at ${t}: ${f}`)}let{projectId:n,workspaceId:o,...i}=r.data,d=o!==void 0?{workspaceId:o}:{},s=q(),a=s!==void 0?{...i,env:s}:i;return n!==void 0?{kind:"provisioned",projectId:n,...a,...d}:{kind:"unprovisioned",...a,...d}}async function k(e,t){let r=e??process.cwd(),n=h(t?.configFile),o=n!==void 0?m(r,n):void 0;if(o!==void 0&&!I(o)){let s=t?.configFile?.trim()?"":` (from ${j})`;throw g.configLoadFailed(`Config file not found: ${o}${s}`)}let i;try{i=await Xe(D(r,t))}catch(s){throw g.configLoadFailed(`Failed to load helix.config.ts: ${s instanceof Error?s.message:String(s)}`)}let d=i._configFile??b(r,t);if(!d)throw g.configLoadFailed(`helix.config.ts not found at ${m(r,"helix.config.ts")}`);if(o!==void 0&&i._configFile!==void 0){let s=fe(o);if(fe(m(i._configFile))!==s)throw g.configLoadFailed(`Config file conflict: requested ${o} but ${m(i._configFile)} takes extension-resolution precedence \u2014 remove or rename the sibling file`)}return A(i.config,d)}var me="WORKSPACE_ID_REQUIRED";function nt(e){if(e.workspaceId===void 0)throw Object.assign(new Error("No workspaceId found in helix.config.ts. Discover & choose one \u2014 self-serve fix: run `helix workspace select`; agent-driven fix: call the `tray_list_workspaces` MCP tool. Already know the id? Run `helix workspace set <id>` or call the `tray_set_workspace_id` MCP tool. deploy cannot proceed without a workspace."),{code:me});return e.workspaceId}import{existsSync as ot,watch as it,writeSync as st}from"fs";import{basename as at,dirname as dt,join as ct,resolve as T}from"path";import{watchConfig as ut}from"c12";function ft(e,t){let r=e instanceof Error?e.message:String(e);st(2,`[helix-watch] ${t.phase} error: ${r}
-`)}function H(){return{kind:"unprovisioned",name:"",authentications:{},config:{},env:"production"}}var lt=/^(?:helix|tray)\.config\.(?:m|c)?[jt]s$/,he=new Set;function ye(e,t){return b(e,{configFile:t})!==void 0}async function pt(e,t,r){if(ye(e.cwd,t))try{return{current:await k(e.cwd,{configFile:t}),initialLoadSucceeded:!0}}catch(n){return r(n,{phase:"reload"}),{current:H(),initialLoadSucceeded:!1}}if(e.watch){let n=t!==void 0?T(e.cwd,t):T(e.cwd);he.has(n)||(process.stderr.write(t!==void 0?`warning: config file ${T(e.cwd,t)} not found; tray running with default config
+import{A as ce,B as le,C as fe,D as pe,E as ge,F as me,G as _,H as x,I as V,J as z,K as y,L as he,M as ye,N as B,O as Ce,P as ve,Q as we,R as Se,f as P,g as k,h as A,i as h,j as H,k as F,l as L,m as O,n as ae,o as M,p as D,q,r as Z,s as N,w as $,x as K,y as de,z as ue}from"./chunk-CYG3GXE2.js";import{a as j,b as ie}from"./chunk-WUCX7RZO.js";import{d as E,r as W,s as U}from"./chunk-HEA646WT.js";import{randomUUID as Pe}from"crypto";import{SpanStatusCode as Y,SpanKind as Ae}from"@opentelemetry/api";import{defineEventHandler as He,getMethod as Fe,getRequestURL as Le,getHeaders as te,getHeader as ee}from"h3";import{readBody as Ee,getQuery as ke,getRouterParams as _e}from"h3";async function G(e,t){let r=await xe(e),n=ke(e),o=_e(e)??{},s={...n,...r,...o};return t?be(s,t):s}async function xe(e){try{let t=await Ee(e);return t&&typeof t=="object"?t:(t!=null&&t!==""&&console.warn("[helix-sdk] Request body present but not a JSON object \u2014 ignored"),{})}catch(t){if(t instanceof Error&&"statusCode"in t&&t.statusCode===400){let n=new Error("Malformed request body");throw n.statusCode=400,n.data={message:"Request body is not valid JSON"},n}let r=e.method?.toUpperCase();if(r==="GET"||r==="HEAD"||r==="DELETE")return{};throw t}}function be(e,t){let r=t.safeParse(e);if(!r.success){let n=new Error("Input validation failed");throw n.statusCode=400,n.data=r.error.flatten(),n}return r.data}var C=class extends Error{statusCode;constructor(t,r){super(r),this.statusCode=t,this.name="HttpError"}};function J(e){return t=>{e.node.res.statusCode=t}}function Q(){return(e,t)=>{throw new C(e,t)}}function X(e,t){let{statusCode:r,message:n}=Te(t.detail);return e.node.res.statusCode=r,{error:n,statusCode:r}}function Te(e){switch(e.kind){case"unknown_alias":return{statusCode:400,message:"Unknown authentication alias"};case"input_validation_failed":return{statusCode:400,message:"Input validation failed"};case"output_validation_failed":return{statusCode:500,message:"Internal server error"};case"config_load_failed":return{statusCode:500,message:"Configuration error"};case"broker_error":return{statusCode:502,message:"Broker error"};case"unsupported_body_type":return{statusCode:400,message:"Unsupported request body type"};case"unsupported_scheme":return{statusCode:400,message:"Unsupported URL scheme"};case"missing_execution_credentials":return{statusCode:401,message:"Missing execution credentials"};case"missing_tray_token":return{statusCode:500,message:"Missing Tray token"};case"db_call_failed":return{statusCode:502,message:e.message};case"db_query_failed":return{statusCode:502,message:`Database query failed: ${e.message}`};case"db_invalid_parameters":return{statusCode:400,message:e.message};case"kv_key_invalid":return{statusCode:400,message:e.message};case"kv_value_invalid":return{statusCode:400,message:e.message};case"kv_value_too_large":return{statusCode:400,message:e.message};case"kv_ttl_invalid":return{statusCode:400,message:e.message};case"kv_not_available":return{statusCode:501,message:"Key-value store is not available in this environment"};case"kv_call_failed":return{statusCode:502,message:"Key-value store request failed"};case"kv_requires_provisioning":return{statusCode:500,message:"Internal server error"};case"files_path_invalid":return{statusCode:400,message:e.message};case"files_value_invalid":return{statusCode:400,message:e.message};case"files_value_too_large":return{statusCode:400,message:e.message};case"files_not_available":return{statusCode:501,message:"File storage is not available in this environment"};case"files_call_failed":return{statusCode:502,message:"File storage request failed"};case"files_requires_provisioning":return{statusCode:500,message:"Internal server error"};case"call_function_path_invalid":return{statusCode:400,message:e.message};case"call_function_call_failed":return{statusCode:502,message:"Async function call failed"};case"call_function_requires_provisioning":return{statusCode:500,message:"Internal server error"};case"call_function_not_available":return{statusCode:501,message:"callFunctionAsync is not available in this environment"};case"call_function_missing_execution_jwt":return{statusCode:401,message:"Missing execution credentials"};case"ai_unsupported_service":case"ai_model_id_required":case"ai_model_instance_required":case"ai_provider_not_configured":case"ai_foreign_model_rejected":return{statusCode:500,message:e.kind==="ai_unsupported_service"?`AI service not supported for alias "${e.alias}"`:"Internal server error"};default:return{statusCode:500,message:`Unhandled error kind: ${e.kind}`}}}var Ie=["authorization","x-tray-token","set-cookie","x-kong-request-id","traceparent","x-real-ip","cookie"];function Re(e){return e.toLowerCase().includes("tray_lid")}function b(e){let t={};for(let[r,n]of Object.entries(e))if(!Ie.includes(r.toLowerCase())){if(r.toLowerCase()==="cookie"&&n){let o=n.split(";").map(s=>s.trim()).filter(s=>{let d=s.split("=")[0].trim();return!Re(d)}).join("; ");o&&(t[r]=o);continue}t[r]=n}return t}function Oe(e,t){let{inputSchema:r,outputSchema:n}=qe(t),o=e;return He(async s=>{let d=E(),{executionId:i,userId:a,deploymentId:l}=Ze(d,s),f=d.mode==="lambda"?d.parentExecutionId??null:null,p=Date.now(),v=new Date().toISOString(),c=Fe(s),u=Le(s).pathname,g=D(),m=M(),oe=`${c} ${u}`;H();let R={hasDb:!1,hasExternal:!1,hasAuth:!1,hasAi:!1,hasError:!1};return je(()=>k.run(R,()=>P.run(i,async()=>{let w=await Me(s,r);if(!w.ok)return{response:w.response,errored:!1,errorMessage:null};let se=$e(s,w.input,g,m,c,u,i,l,a,f);return De(o,se,n,s,m,i,l,{method:c,path:u,rawInput:w.input})})),{executionId:i,deploymentId:l,routeOrJob:oe,startedAt:v,startMs:p,userId:a,flags:R})})}async function je(e,t){let r=!1,n=null;try{let o=await e();return r=o.errored,n=o.errorMessage,o.response}finally{O({...t,errored:r,errorMessage:n}),await F()}}async function Me(e,t){try{return{ok:!0,input:await G(e,t)}}catch(r){let n=Ne(e,r);if(n)return{ok:!1,response:n};throw r}}async function De(e,t,r,n,o,s,d,i){return L.startActiveSpan("function",{root:!0,kind:Ae.SERVER,attributes:{method:i.method,route:i.path,executionId:s,...d?{deploymentId:d}:{}}},async a=>{t.traceId=a.spanContext().traceId;let l=b(te(n));h(a,"input",i.rawInput),h(a,"request",{method:i.method,path:i.path,headers:l,body:i.rawInput});let f=!1,p=null,v,c;try{let u=await j.run(t,()=>e(t));if(v=u,u==null)n.node.res.statusCode=204,c="";else if(u instanceof Response)c=u;else if(r){let g=r.safeParse(u);if(!g.success){let m=Object.keys(g.error.flatten().fieldErrors);throw o.error("Output validation failed",{fields:m,executionId:s}),W.outputValidationFailed(m)}c=g.data}else c=u}catch(u){f=!0,p=u instanceof Error?u.message:String(u),A("hasError"),c=We(u,n,o,s)}finally{Ue(a,n,{errored:f,errorMessage:p,handlerResult:v,response:c})}return{response:c,errored:f,errorMessage:p}})}function We(e,t,r,n){if(e instanceof C)return t.node.res.statusCode=e.statusCode,{error:e.message,statusCode:e.statusCode};if(U(e))return X(t,e);r.error("Unhandled error in handler",{error:e instanceof Error?e.message:String(e),executionId:n}),t.node.res.statusCode=500;let o=process.env.NODE_ENV==="development";return{error:o&&e instanceof Error?e.message:"Internal server error",statusCode:500,...o&&e instanceof Error&&e.stack?{stack:e.stack}:{}}}function Ue(e,t,r){e.setAttribute("statusCode",t.node.res.statusCode),!r.errored&&r.handlerResult!==void 0&&h(e,"output",r.handlerResult),h(e,"response",r.response);let n=k.getStore();e.setAttribute("hasAuth",n?.hasAuth??!1),e.setAttribute("hasAi",n?.hasAi??!1),e.setAttribute("hasExternal",n?.hasExternal??!1),e.setAttribute("hasDb",n?.hasDb??!1),e.setAttribute("status",r.errored?"error":"success");let o=r.errored||(n?.hasError??!1);e.setStatus({code:o?Y.ERROR:Y.OK,...r.errorMessage?{message:r.errorMessage}:{}}),e.end()}function qe(e){if(!e)return{inputSchema:void 0,outputSchema:void 0};if(e instanceof Object&&"_def"in e)return{inputSchema:e,outputSchema:void 0};if(typeof e=="object"&&("input"in e||"output"in e)){let t=e;return{inputSchema:t.input,outputSchema:t.output}}return{inputSchema:e,outputSchema:void 0}}function Ze(e,t){let r=e.mode==="lambda",n=(r?e.executionId:ee(t,"x-tray-execution-id"))??Pe(),o=(r?e.userId:ee(t,"x-tray-user-id"))??null,s=r?e.deploymentId??null:null;return{executionId:n,userId:o,deploymentId:s}}function Ne(e,t){if(!(t instanceof Error)||!("statusCode"in t)||!("data"in t))return null;let r=t.statusCode,n=t.data;e.node.res.statusCode=r;let o=n&&typeof n=="object"&&"fieldErrors"in n?n.fieldErrors:void 0;return{error:"Input validation failed",statusCode:r,...o?{fields:Object.keys(o)}:{}}}function $e(e,t,r,n,o,s,d,i,a,l){return{input:t,method:o,path:s,headers:b(te(e)),http:q(),db:f=>Z(f),kv:()=>N(),files:()=>$(),callFunctionAsync:K(),ai:B(),log:n,config:r,status:J(e),error:Q(),state:{},request:e,executionId:d,deploymentId:i,userId:a,parentExecutionId:l,identity:a!==null?{user:{id:a}}:null,traceId:""}}function Ke(e){return e}import{existsSync as Ve,watch as ze,writeSync as Be}from"fs";import{basename as Ge,dirname as Je,join as Qe,resolve as S}from"path";import{watchConfig as Xe}from"c12";function Ye(e,t){let r=e instanceof Error?e.message:String(e);Be(2,`[helix-watch] ${t.phase} error: ${r}
+`)}function T(){return{kind:"unprovisioned",name:"",authentications:{},config:{},region:"us1"}}var et=/^(?:helix|tray)\.config\.(?:m|c)?[jt]s$/,re=new Set;function ne(e,t){return x(e,{configFile:t})!==void 0}async function tt(e,t,r){if(ne(e.cwd,t))try{return{current:await y(e.cwd,{configFile:t}),initialLoadSucceeded:!0}}catch(n){return r(n,{phase:"reload"}),{current:T(),initialLoadSucceeded:!1}}if(e.watch){let n=t!==void 0?S(e.cwd,t):S(e.cwd);re.has(n)||(process.stderr.write(t!==void 0?`warning: config file ${S(e.cwd,t)} not found; tray running with default config
 `:`warning: no helix.config.ts found at ${e.cwd}; tray running with default config \u2014 create one via \`helix init\`
-`),he.add(n))}return{current:H(),initialLoadSucceeded:!1}}var W=class{constructor(t,r,n,o){this.cwd=t;this.configFile=r;this.onError=n;this.emit=o}cwd;configFile;onError;emit;stopped=!1;directoryWatcher=null;c12Unwatch=null;c12AttachPromise=null;updateChain=Promise.resolve();start(t){t?this.attachC12Watcher():this.attachCreationWatcher()}watcherReady(){return this.c12AttachPromise===null?Promise.resolve():this.c12AttachPromise.catch(()=>{})}async stop(){this.stopped=!0,this.directoryWatcher&&(this.directoryWatcher.close(),this.directoryWatcher=null),this.c12AttachPromise&&await this.c12AttachPromise.catch(t=>this.onError(t,{phase:"attach"})),this.c12Unwatch&&(await this.c12Unwatch(),this.c12Unwatch=null)}attachC12Watcher(){this.c12AttachPromise===null&&(this.c12AttachPromise=ut({...D(this.cwd,{configFile:this.configFile}),onUpdate:({newConfig:t})=>{this.stopped||(this.updateChain=this.updateChain.then(async()=>{if(this.stopped)return;let r;try{r=A(t.config,this.cwd)}catch(n){this.onError(n,{phase:"validation"});return}try{this.emit(r)}catch(n){this.onError(n,{phase:"reload"})}}))}}).then(async t=>{if(this.stopped){t.unwatch();return}this.c12Unwatch=t.unwatch;let{watch:r}=await import("chokidar"),n=r(this.cwd,{persistent:!1,depth:0});try{await new Promise((o,i)=>{n.once("ready",o),n.once("error",i)})}finally{await n.close()}}).catch(t=>{this.onError(t,{phase:"attach"})}))}attachCreationWatcher(){let t=this.configFile!==void 0?T(this.cwd,this.configFile):void 0,r=t!==void 0?dt(t):this.cwd;try{this.directoryWatcher=it(r,{persistent:!1},(n,o)=>{if(this.stopped||!o)return;let i=o.toString();if(t!==void 0){if(i!==at(t))return}else if(!lt.test(i))return;ot(ct(r,i))&&(this.updateChain=this.updateChain.then(async()=>{if(this.stopped)return;let d;try{d=await k(this.cwd,{configFile:this.configFile})}catch(a){this.onError(a,{phase:"reload"});return}if(this.stopped)return;this.emit(d);let s=this.directoryWatcher;s&&(this.directoryWatcher=null,s.close()),this.attachC12Watcher()}))}),this.directoryWatcher.on("error",n=>{this.onError(n,{phase:"attach"})})}catch(n){this.onError(n,{phase:"attach"})}}};async function gt(e){let t=e.onError??ft,r=new Set,n=h(e.configFile),o=await pt(e,n,t),i=o.current;function d(a){i=a;for(let f of[...r])try{f(a)}catch(l){t(l,{phase:"reload"})}}let s=new W(e.cwd,n,t,d);return e.watch&&s.start(o.initialLoadSucceeded),{get(){return i},async reload(){if(!ye(e.cwd,n)){let a=H();return d(a),a}try{let a=await k(e.cwd,{configFile:n});return d(a),a}catch(a){return t(a,{phase:"reload"}),i}},subscribe(a){return r.add(a),()=>{r.delete(a)}},async stop(){r.clear(),await s.stop()},ready(){return s.watcherReady()}}}export{Qe as ENVIRONMENT_VALUES,j as HELIX_CONFIG_ENV,ke as SCHEDULE_DEFINITION_KIND,Se as ScheduleConfigError,me as WORKSPACE_ID_REQUIRED_CODE,gt as createConfigService,Ge as defineConfig,Ne as defineFunction,xe as defineSchedule,_ as environmentSchema,we as getContext,R as getSdkConfig,_e as isScheduleDefinition,k as loadConfig,et as loadedTrayConfigSchema,L as projectIdSchema,nt as requireWorkspaceId,b as resolveConfigFile,h as resolveConfigOverride,Ee as runWithinAppSpan,O as workspaceIdSchema};
+`),re.add(n))}return{current:T(),initialLoadSucceeded:!1}}var I=class{constructor(t,r,n,o){this.cwd=t;this.configFile=r;this.onError=n;this.emit=o}cwd;configFile;onError;emit;stopped=!1;directoryWatcher=null;c12Unwatch=null;c12AttachPromise=null;updateChain=Promise.resolve();start(t){t?this.attachC12Watcher():this.attachCreationWatcher()}watcherReady(){return this.c12AttachPromise===null?Promise.resolve():this.c12AttachPromise.catch(()=>{})}async stop(){this.stopped=!0,this.directoryWatcher&&(this.directoryWatcher.close(),this.directoryWatcher=null),this.c12AttachPromise&&await this.c12AttachPromise.catch(t=>this.onError(t,{phase:"attach"})),this.c12Unwatch&&(await this.c12Unwatch(),this.c12Unwatch=null)}attachC12Watcher(){this.c12AttachPromise===null&&(this.c12AttachPromise=Xe({...V(this.cwd,{configFile:this.configFile}),onUpdate:({newConfig:t})=>{this.stopped||(this.updateChain=this.updateChain.then(async()=>{if(this.stopped)return;let r;try{r=z(t.config,this.cwd)}catch(n){this.onError(n,{phase:"validation"});return}try{this.emit(r)}catch(n){this.onError(n,{phase:"reload"})}}))}}).then(async t=>{if(this.stopped){t.unwatch();return}this.c12Unwatch=t.unwatch;let{watch:r}=await import("chokidar"),n=r(this.cwd,{persistent:!1,depth:0});try{await new Promise((o,s)=>{n.once("ready",o),n.once("error",s)})}finally{await n.close()}}).catch(t=>{this.onError(t,{phase:"attach"})}))}attachCreationWatcher(){let t=this.configFile!==void 0?S(this.cwd,this.configFile):void 0,r=t!==void 0?Je(t):this.cwd;try{this.directoryWatcher=ze(r,{persistent:!1},(n,o)=>{if(this.stopped||!o)return;let s=o.toString();if(t!==void 0){if(s!==Ge(t))return}else if(!et.test(s))return;Ve(Qe(r,s))&&(this.updateChain=this.updateChain.then(async()=>{if(this.stopped)return;let d;try{d=await y(this.cwd,{configFile:this.configFile})}catch(a){this.onError(a,{phase:"reload"});return}if(this.stopped)return;this.emit(d);let i=this.directoryWatcher;i&&(this.directoryWatcher=null,i.close()),this.attachC12Watcher()}))}),this.directoryWatcher.on("error",n=>{this.onError(n,{phase:"attach"})})}catch(n){this.onError(n,{phase:"attach"})}}};async function rt(e){let t=e.onError??Ye,r=new Set,n=_(e.configFile),o=await tt(e,n,t),s=o.current;function d(a){s=a;for(let l of[...r])try{l(a)}catch(f){t(f,{phase:"reload"})}}let i=new I(e.cwd,n,t,d);return e.watch&&i.start(o.initialLoadSucceeded),{get(){return s},async reload(){if(!ne(e.cwd,n)){let a=T();return d(a),a}try{let a=await y(e.cwd,{configFile:n});return d(a),a}catch(a){return t(a,{phase:"reload"}),s}},subscribe(a){return r.add(a),()=>{r.delete(a)}},async stop(){r.clear(),await i.stop()},ready(){return i.watcherReady()}}}import{tool as Vt,dynamicTool as zt,jsonSchema as Bt,zodSchema as Gt,stepCountIs as Jt,hasToolCall as Qt,convertToModelMessages as Xt,cosineSimilarity as Yt,smoothStream as er,Output as tr}from"ai";export{fe as AI_SERVICES,me as HELIX_CONFIG_ENV,tr as Output,de as REGION_VALUES,Ce as SCHEDULE_DEFINITION_KIND,ve as ScheduleConfigError,he as WORKSPACE_ID_REQUIRED_CODE,pe as aiProviderEntrySchema,Xt as convertToModelMessages,Yt as cosineSimilarity,rt as createConfigService,Ke as defineConfig,Oe as defineFunction,we as defineSchedule,zt as dynamicTool,ie as getContext,E as getSdkConfig,Qt as hasToolCall,Se as isScheduleDefinition,Bt as jsonSchema,y as loadConfig,ge as loadedTrayConfigSchema,ce as projectIdSchema,ue as regionSchema,ye as requireWorkspaceId,x as resolveConfigFile,_ as resolveConfigOverride,ae as runWithinAppSpan,er as smoothStream,Jt as stepCountIs,Vt as tool,le as workspaceIdSchema,Gt as zodSchema};

package/dist/internal/index.d.ts

@@ -1,5 +1,5 @@
-import { L as LoadedTrayConfig } from '../sdk-config-DU6cWbLW.js';
-export { f as SdkConfigInput, s as setSdkConfig } from '../sdk-config-DU6cWbLW.js';
+import { L as LoadedTrayConfig } from '../config-loader-BqIGpFg8.js';
+export { j as SdkConfigInput, s as setSdkConfig } from '../config-loader-BqIGpFg8.js';
 import 'zod';
 
 /** BroadcastChannel name for parent→worker config updates. */
@@ -140,6 +140,24 @@ type SdkErrorDetail = {
     readonly kind: "call_function_not_available";
 } | {
     readonly kind: "call_function_missing_execution_jwt";
+} | {
+    readonly kind: "ai_unsupported_service";
+    alias: string;
+    service: string;
+    supported: string[];
+} | {
+    readonly kind: "ai_model_id_required";
+    alias: string;
+    operation: string;
+} | {
+    readonly kind: "ai_model_instance_required";
+    modelId: string;
+} | {
+    readonly kind: "ai_provider_not_configured";
+    alias: string;
+    supported: string[];
+} | {
+    readonly kind: "ai_foreign_model_rejected";
 };
 declare class SdkError extends Error {
     readonly detail: SdkErrorDetail;
@@ -175,6 +193,11 @@ declare class SdkError extends Error {
     static callFunctionRequiresProvisioning(): SdkError;
     static callFunctionNotAvailable(): SdkError;
     static callFunctionMissingExecutionJwt(): SdkError;
+    static aiUnsupportedService(alias: string, service: string, supported: string[]): SdkError;
+    static aiModelIdRequired(alias: string, operation: string): SdkError;
+    static aiModelInstanceRequired(modelId: string): SdkError;
+    static aiProviderNotConfigured(alias: string, supported: string[]): SdkError;
+    static aiForeignModelRejected(): SdkError;
 }
 declare function isSdkError(err: unknown): err is SdkError;
 
@@ -182,7 +205,7 @@ declare function isSdkError(err: unknown): err is SdkError;
 declare function contentFilePath(projectRoot: string, path: string): string;
 declare function metaFilePath(projectRoot: string, path: string): string;
 
-interface EnvironmentHosts {
+interface RegionHosts {
     api: string;
     broker: string;
     ingest: string;
@@ -192,38 +215,38 @@ interface EnvironmentHosts {
     dashboard: string;
     auth?: string;
 }
-interface EnvironmentLoginInfo {
+interface RegionLoginInfo {
     storePrefix: string;
     appUrl: string;
     cookieName: string;
     cookieDomain: string;
 }
-interface EnvironmentProfile {
+interface RegionProfile {
     name: string;
     exposedName: string;
     displayName: string;
-    hosts: EnvironmentHosts;
-    login: EnvironmentLoginInfo;
+    hosts: RegionHosts;
+    login: RegionLoginInfo;
 }
 /**
- * Register an environment profile. Idempotent when the same profile is
+ * Register a region profile. Idempotent when the same profile is
  * registered again; throws if a different profile reuses the same `name` or
  * `exposedName`.
  */
-declare function registerEnvironmentProfile(profile: EnvironmentProfile): void;
-declare function isKnownEnvironment(name: string): boolean;
-declare function getEnvironmentProfile(name: string): EnvironmentProfile | undefined;
-declare function requireEnvironmentProfile(name: string): EnvironmentProfile;
+declare function registerRegionProfile(profile: RegionProfile): void;
+declare function isKnownRegion(name: string): boolean;
+declare function getRegionProfile(name: string): RegionProfile | undefined;
+declare function requireRegionProfile(name: string): RegionProfile;
 /** Internal config env names currently registered (includes built-ins). */
-declare function listEnvironmentNames(): string[];
-/** User-facing `--env` values for all registered profiles. */
-declare function listExposedEnvNames(): string[];
-/** Resolve user-facing `--env` value → internal env name. */
-declare function parseExposedEnvironment(value: string): string | undefined;
-declare function setForcedEnvironment(name: string | undefined): void;
-declare function resolveForcedEnvironment(): string | undefined;
-declare function getAdditionalEnvironmentProfiles(): EnvironmentProfile[];
-/** Test helper: drop non-builtin profiles and restore production. */
-declare function resetEnvironmentRegistryForTests(): void;
+declare function listRegionNames(): string[];
+/** User-facing `--region` values for all registered profiles. */
+declare function listExposedRegionNames(): string[];
+/** Resolve user-facing `--region` value → internal region name. */
+declare function parseExposedRegionName(value: string): string | undefined;
+declare function setForcedRegion(name: string | undefined): void;
+declare function resolveForcedRegion(): string | undefined;
+declare function getAdditionalRegionProfiles(): RegionProfile[];
+/** Test helper: drop non-builtin profiles and restore the built-in regions. */
+declare function resetRegionRegistryForTests(): void;
 
-export { CONFIG_BRIDGE_CHANNEL, DEV_TOKEN_BRIDGE_CHANNEL, type EnvironmentProfile, type ScheduleInvocation, ScheduleInvocationError, assertValidPath, clearActiveConfig, contentFilePath, getActiveConfig, getAdditionalEnvironmentProfiles, getEnvironmentProfile, isKnownEnvironment, isSdkError, listEnvironmentNames, listExposedEnvNames, metaFilePath, parseExposedEnvironment, registerEnvironmentProfile, requireEnvironmentProfile, resetEnvironmentRegistryForTests, resolveForcedEnvironment, runScheduledFunction, setActiveConfig, setForcedEnvironment };
+export { CONFIG_BRIDGE_CHANNEL, DEV_TOKEN_BRIDGE_CHANNEL, type RegionProfile, type ScheduleInvocation, ScheduleInvocationError, assertValidPath, clearActiveConfig, contentFilePath, getActiveConfig, getAdditionalRegionProfiles, getRegionProfile, isKnownRegion, isSdkError, listExposedRegionNames, listRegionNames, metaFilePath, parseExposedRegionName, registerRegionProfile, requireRegionProfile, resetRegionRegistryForTests, resolveForcedRegion, runScheduledFunction, setActiveConfig, setForcedRegion };

package/dist/internal/index.js

@@ -1 +1 @@
-import{D as P,a as L,b as m,c as T,d as G,e as J,f as U,g as V,h,i as p,j as g,k as E,l as S,m as y,n as x,o as A,q as I,r as w,s as C,t as v,u as D,v as nt,w as st,x as it,y as F,z as N}from"../chunk-QWCCRTLO.js";import{a as b}from"../chunk-WUCX7RZO.js";import{a as B,b as q,c as z,d as Q,e as W,f as X,g as Y,h as Z,i as tt,j as et,k as rt,m as ot}from"../chunk-KUXDW5ED.js";import{randomUUID as at}from"crypto";import{SpanStatusCode as O,SpanKind as lt}from"@opentelemetry/api";var e=class extends Error{constructor(t){super(`runScheduledFunction: ${t}`),this.name="ScheduleInvocationError"}};async function ct(s,t){if(typeof t!="object"||t===null)throw new e("`invocation` must be an object");let{schedulePath:r}=t;if(typeof r!="string"||r.length===0)throw new e("`schedulePath` must be a non-empty string");if(typeof t.isManual!="boolean")throw new e("`isManual` must be a boolean");if(!P(s))throw new e(`default export of "${r}" is not a defineSchedule definition`);let M=k("scheduledAt",t.scheduledAt),R=k("firedAt",t.firedAt),d=m(),a=d.executionId??at(),l=d.deploymentId??null,j=Date.now(),$=new Date().toISOString(),K=w(),_=I();S();let i={hasDb:!1,hasExternal:!1,hasAuth:!1,hasError:!1},c=!1,u=null;try{await p.run(i,()=>h.run(a,()=>x.startActiveSpan("schedule",{root:!0,kind:lt.SERVER,attributes:{method:"SCHEDULE",route:r,executionId:a,...l?{deploymentId:l}:{}}},async o=>{let H={type:"schedule",scheduledAt:M,firedAt:R,isManual:t.isManual},f={http:C(),db:n=>v(n),kv:()=>D(),files:()=>F(),callFunctionAsync:N(),log:_,config:K,state:{},executionId:a,deploymentId:l,traceId:o.spanContext().traceId,parentExecutionId:null,trigger:H};E(o,"input",{scheduledAt:t.scheduledAt,firedAt:t.firedAt,isManual:t.isManual});try{await b.run(f,()=>s.handler(f))}catch(n){throw c=!0,u=n instanceof Error?n.message:String(n),g("hasError"),n}finally{o.setAttribute("hasAuth",i.hasAuth),o.setAttribute("hasExternal",i.hasExternal),o.setAttribute("hasDb",i.hasDb),o.setAttribute("status",c?"error":"success");let n=c||i.hasError;o.setStatus({code:n?O.ERROR:O.OK,...u?{message:u}:{}}),o.end()}})))}finally{A({executionId:a,deploymentId:l,triggerType:"schedule",routeOrJob:r,startedAt:$,startMs:j,errored:c,errorMessage:u,userId:null,flags:i}),await y()}}function k(s,t){if(typeof t!="string"||t.length===0)throw new e(`\`${s}\` must be a timestamp string; got ${JSON.stringify(t)}`);let r=new Date(t);if(Number.isNaN(r.getTime()))throw new e(`\`${s}\` must be a Date-parseable timestamp; got ${JSON.stringify(t)}`);return r}export{T as CONFIG_BRIDGE_CHANNEL,G as DEV_TOKEN_BRIDGE_CHANNEL,e as ScheduleInvocationError,nt as assertValidPath,V as clearActiveConfig,st as contentFilePath,U as getActiveConfig,et as getAdditionalEnvironmentProfiles,z as getEnvironmentProfile,q as isKnownEnvironment,ot as isSdkError,W as listEnvironmentNames,X as listExposedEnvNames,it as metaFilePath,Y as parseExposedEnvironment,B as registerEnvironmentProfile,Q as requireEnvironmentProfile,rt as resetEnvironmentRegistryForTests,tt as resolveForcedEnvironment,ct as runScheduledFunction,J as setActiveConfig,Z as setForcedEnvironment,L as setSdkConfig};
+import{N as P,R as O,a as G,b as J,c as U,d as V,e as B,f as g,g as h,h as p,i as S,j as A,k as x,l as y,m as E,o as I,p as w,q as R,r as C,s as D,t as se,u as ie,v as ae,w as F,x as N}from"../chunk-CYG3GXE2.js";import{a as b}from"../chunk-WUCX7RZO.js";import{c as T,d as m,g as q,h as z,i as Q,j as W,k as X,l as Y,m as Z,n as ee,o as te,p as re,q as oe,s as ne}from"../chunk-HEA646WT.js";import{randomUUID as le}from"crypto";import{SpanStatusCode as k,SpanKind as ce}from"@opentelemetry/api";var r=class extends Error{constructor(e){super(`runScheduledFunction: ${e}`),this.name="ScheduleInvocationError"}};async function ue(i,e){if(typeof e!="object"||e===null)throw new r("`invocation` must be an object");let{schedulePath:o}=e;if(typeof o!="string"||o.length===0)throw new r("`schedulePath` must be a non-empty string");if(typeof e.isManual!="boolean")throw new r("`isManual` must be a boolean");if(!O(i))throw new r(`default export of "${o}" is not a defineSchedule definition`);let j=M("scheduledAt",e.scheduledAt),$=M("firedAt",e.firedAt),d=m(),a=d.executionId??le(),l=d.deploymentId??null,H=Date.now(),K=new Date().toISOString(),_=w(),v=I();A();let s={hasDb:!1,hasExternal:!1,hasAuth:!1,hasAi:!1,hasError:!1},c=!1,u=null;try{await h.run(s,()=>g.run(a,()=>y.startActiveSpan("schedule",{root:!0,kind:ce.SERVER,attributes:{method:"SCHEDULE",route:o,executionId:a,...l?{deploymentId:l}:{}}},async t=>{let L={type:"schedule",scheduledAt:j,firedAt:$,isManual:e.isManual},f={http:R(),db:n=>C(n),kv:()=>D(),files:()=>F(),callFunctionAsync:N(),ai:P(),log:v,config:_,state:{},executionId:a,deploymentId:l,traceId:t.spanContext().traceId,parentExecutionId:null,trigger:L};S(t,"input",{scheduledAt:e.scheduledAt,firedAt:e.firedAt,isManual:e.isManual});try{await b.run(f,()=>i.handler(f))}catch(n){throw c=!0,u=n instanceof Error?n.message:String(n),p("hasError"),n}finally{t.setAttribute("hasAuth",s.hasAuth),t.setAttribute("hasAi",s.hasAi),t.setAttribute("hasExternal",s.hasExternal),t.setAttribute("hasDb",s.hasDb),t.setAttribute("status",c?"error":"success");let n=c||s.hasError;t.setStatus({code:n?k.ERROR:k.OK,...u?{message:u}:{}}),t.end()}})))}finally{E({executionId:a,deploymentId:l,triggerType:"schedule",routeOrJob:o,startedAt:K,startMs:H,errored:c,errorMessage:u,userId:null,flags:s}),await x()}}function M(i,e){if(typeof e!="string"||e.length===0)throw new r(`\`${i}\` must be a timestamp string; got ${JSON.stringify(e)}`);let o=new Date(e);if(Number.isNaN(o.getTime()))throw new r(`\`${i}\` must be a Date-parseable timestamp; got ${JSON.stringify(e)}`);return o}export{G as CONFIG_BRIDGE_CHANNEL,J as DEV_TOKEN_BRIDGE_CHANNEL,r as ScheduleInvocationError,se as assertValidPath,B as clearActiveConfig,ie as contentFilePath,V as getActiveConfig,re as getAdditionalRegionProfiles,Q as getRegionProfile,z as isKnownRegion,ne as isSdkError,Y as listExposedRegionNames,X as listRegionNames,ae as metaFilePath,Z as parseExposedRegionName,q as registerRegionProfile,W as requireRegionProfile,oe as resetRegionRegistryForTests,te as resolveForcedRegion,ue as runScheduledFunction,U as setActiveConfig,ee as setForcedRegion,T as setSdkConfig};

package/dist/region-schema-COfWyGI9.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+/** Built-in regions shipped in the published SDK. */
+declare const REGION_VALUES: readonly ["us1", "eu1", "ap1", "ap2"];
+/** Runtime region name (built-ins plus any registered profiles). */
+type Region = string;
+declare const regionSchema: z.ZodEffects<z.ZodString, string, string>;
+
+export { type Region as R, REGION_VALUES as a, regionSchema as r };