@trayai/helix-sdk 1.15.0 → 1.16.0

package/dist/define-agent-BEUgQ_5-.d.ts

@@ -1,911 +0,0 @@
-import { z, ZodType } from 'zod';
-import { P as PlatformContext } from './types-BSbvztCi.js';
-
-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;
-    /**
-     * Email of the calling user for the current invocation. Set via
-     * `setSdkConfig(...)` at handler entry in lambda mode. In `dev` mode,
-     * define-function reads from the `x-tray-user-email` header. Only exposed
-     * on `ctx.identity` when `userId` is also set.
-     */
-    userEmail?: string;
-    /**
-     * Display name of the calling user for the current invocation. Set via
-     * `setSdkConfig(...)` at handler entry in lambda mode. In `dev` mode,
-     * define-function reads from the `x-tray-user-name` header. Only exposed
-     * on `ctx.identity` when `userId` is also set.
-     */
-    userName?: 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;
-/**
- * Agent session storage (helix-spec 14 → Sessions & Memory → Pluggable
- * Backend). v1 supports only the bring-your-own-DynamoDB backend — the
- * managed Helix session store does not exist yet, so `store: "dynamodb"` is
- * currently the only durable option (in-memory otherwise). The table is
- * accessed through the credentials broker with the named authentication's
- * AWS credentials; no keys in the runtime.
- */
-declare const agentSessionsSchema: z.ZodDiscriminatedUnion<"store", [z.ZodObject<{
-    store: z.ZodLiteral<"managed">;
-}, "strip", z.ZodTypeAny, {
-    store: "managed";
-}, {
-    store: "managed";
-}>, z.ZodObject<{
-    store: z.ZodLiteral<"dynamodb">;
-    /** Authentication alias (from `authentications`) holding AWS credentials. */
-    auth: z.ZodString;
-    table: z.ZodString;
-    region: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    auth: string;
-    store: "dynamodb";
-    table: string;
-    region: string;
-}, {
-    auth: string;
-    store: "dynamodb";
-    table: string;
-    region: string;
-}>]>;
-type AgentSessionsConfig = z.infer<typeof agentSessionsSchema>;
-/**
- * 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. `bedrock` likewise
- * needs the object form: the provider package derives the regional runtime
- * endpoint (`bedrock-runtime.<region>.amazonaws.com`) from `region`, or takes
- * `baseUrl` verbatim for VPC / custom endpoints.
- *
- * `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", "bedrock", "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.ZodEffects<z.ZodEffects<z.ZodObject<{
-    service: z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere", "bedrock", "openai-compatible"]>;
-    baseUrl: z.ZodOptional<z.ZodString>;
-    region: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}>, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}>, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}>, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}>, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    baseUrl?: string | undefined;
-}, {
-    service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-    region?: string | undefined;
-    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>>>;
-    agentSessions: z.ZodOptional<z.ZodDiscriminatedUnion<"store", [z.ZodObject<{
-        store: z.ZodLiteral<"managed">;
-    }, "strip", z.ZodTypeAny, {
-        store: "managed";
-    }, {
-        store: "managed";
-    }>, z.ZodObject<{
-        store: z.ZodLiteral<"dynamodb">;
-        /** Authentication alias (from `authentications`) holding AWS credentials. */
-        auth: z.ZodString;
-        table: z.ZodString;
-        region: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    }, {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    }>]>>;
-    aiProviders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere"]>, z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
-        service: z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere", "bedrock", "openai-compatible"]>;
-        baseUrl: z.ZodOptional<z.ZodString>;
-        region: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>]>>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    authentications: Record<string, string>;
-    config: Record<string, unknown>;
-    region?: string | undefined;
-    projectId?: string | undefined;
-    workspaceId?: string | undefined;
-    env?: "production" | undefined;
-    agentSessions?: {
-        store: "managed";
-    } | {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    } | undefined;
-    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }> | undefined;
-}, {
-    name: string;
-    region?: string | undefined;
-    projectId?: string | undefined;
-    workspaceId?: string | undefined;
-    env?: "production" | undefined;
-    authentications?: Record<string, string> | undefined;
-    config?: Record<string, unknown> | undefined;
-    agentSessions?: {
-        store: "managed";
-    } | {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    } | undefined;
-    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }> | undefined;
-}>, {
-    region: string;
-    name: string;
-    authentications: Record<string, string>;
-    config: Record<string, unknown>;
-    projectId?: string | undefined;
-    workspaceId?: string | undefined;
-    agentSessions?: {
-        store: "managed";
-    } | {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    } | undefined;
-    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }> | undefined;
-}, {
-    name: string;
-    region?: string | undefined;
-    projectId?: string | undefined;
-    workspaceId?: string | undefined;
-    env?: "production" | undefined;
-    authentications?: Record<string, string> | undefined;
-    config?: Record<string, unknown> | undefined;
-    agentSessions?: {
-        store: "managed";
-    } | {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    } | undefined;
-    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        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>;
-    agentSessions: z.ZodOptional<z.ZodDiscriminatedUnion<"store", [z.ZodObject<{
-        store: z.ZodLiteral<"managed">;
-    }, "strip", z.ZodTypeAny, {
-        store: "managed";
-    }, {
-        store: "managed";
-    }>, z.ZodObject<{
-        store: z.ZodLiteral<"dynamodb">;
-        /** Authentication alias (from `authentications`) holding AWS credentials. */
-        auth: z.ZodString;
-        table: z.ZodString;
-        region: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    }, {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    }>]>>;
-    aiProviders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere"]>, z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
-        service: z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere", "bedrock", "openai-compatible"]>;
-        baseUrl: z.ZodOptional<z.ZodString>;
-        region: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>]>>>;
-} & {
-    kind: z.ZodLiteral<"provisioned">;
-    projectId: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    kind: "provisioned";
-    region: string;
-    name: string;
-    projectId: string;
-    authentications: Record<string, string>;
-    config: Record<string, unknown>;
-    workspaceId?: string | undefined;
-    agentSessions?: {
-        store: "managed";
-    } | {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    } | undefined;
-    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }> | undefined;
-}, {
-    kind: "provisioned";
-    region: string;
-    name: string;
-    projectId: string;
-    authentications: Record<string, string>;
-    config: Record<string, unknown>;
-    workspaceId?: string | undefined;
-    agentSessions?: {
-        store: "managed";
-    } | {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    } | undefined;
-    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        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>;
-    agentSessions: z.ZodOptional<z.ZodDiscriminatedUnion<"store", [z.ZodObject<{
-        store: z.ZodLiteral<"managed">;
-    }, "strip", z.ZodTypeAny, {
-        store: "managed";
-    }, {
-        store: "managed";
-    }>, z.ZodObject<{
-        store: z.ZodLiteral<"dynamodb">;
-        /** Authentication alias (from `authentications`) holding AWS credentials. */
-        auth: z.ZodString;
-        table: z.ZodString;
-        region: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    }, {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    }>]>>;
-    aiProviders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere"]>, z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
-        service: z.ZodEnum<["openai", "anthropic", "google", "mistral", "cohere", "bedrock", "openai-compatible"]>;
-        baseUrl: z.ZodOptional<z.ZodString>;
-        region: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }>]>>>;
-} & {
-    kind: z.ZodLiteral<"unprovisioned">;
-}, "strip", z.ZodTypeAny, {
-    kind: "unprovisioned";
-    region: string;
-    name: string;
-    authentications: Record<string, string>;
-    config: Record<string, unknown>;
-    workspaceId?: string | undefined;
-    agentSessions?: {
-        store: "managed";
-    } | {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    } | undefined;
-    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        baseUrl?: string | undefined;
-    }> | undefined;
-}, {
-    kind: "unprovisioned";
-    region: string;
-    name: string;
-    authentications: Record<string, string>;
-    config: Record<string, unknown>;
-    workspaceId?: string | undefined;
-    agentSessions?: {
-        store: "managed";
-    } | {
-        auth: string;
-        store: "dynamodb";
-        table: string;
-        region: string;
-    } | undefined;
-    aiProviders?: Record<string, "openai" | "anthropic" | "google" | "mistral" | "cohere" | {
-        service: "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openai-compatible";
-        region?: string | undefined;
-        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;
-
-/**
- * `defineTool` (helix-spec 12) — the subset agents consume (helix-spec 14).
- *
- * A tool is a *definition*: name, description, input schema, approval policy,
- * and handler together in one default export. Tools are:
- *
- * - invoked **in-process** by importing the definition and calling it — the
- *   handler runs inside the current execution with the caller's context (via
- *   getContext()), input validated against the schema;
- * - given to agents via `defineAgent({ tools: [...] })`, where the agent
- *   runtime compiles them to AI SDK tools (the same validation + handler,
- *   `needsApproval` compiled to the loop's native approval mechanism).
- *
- * MCP exposure (spec 12's `mcp.tools`) is not built yet — tools exist today
- * for in-process use and agents.
- */
-declare const TOOL_DEFINITION_KIND = "helix-tool";
-interface DefineToolConfig<TSchema extends ZodType = ZodType> {
-    /** Tool name (snake_case convention). */
-    name: string;
-    /** Human-readable description for AI agents. */
-    description: string;
-    /** Input schema (Zod), validated before the handler runs. */
-    input: TSchema;
-    /**
-     * Require human approval before an agent may execute this tool — boolean,
-     * or an (optionally async) predicate of the validated input. Enforced in
-     * agent loops (the loop pauses; see ctx.agent). Direct in-process
-     * invocation is not gated — calling the tool yourself is the confirmation.
-     */
-    needsApproval?: boolean | ((input: z.infer<TSchema>) => boolean | Promise<boolean>);
-    /** Handler — receives the caller's ctx with `input` validated and typed. */
-    handler: (ctx: PlatformContext & {
-        input: z.infer<TSchema>;
-    }) => Promise<unknown> | unknown;
-}
-interface HelixTool<TSchema extends ZodType = ZodType> {
-    /** In-process invocation: validate input, run handler with the caller's ctx. */
-    (input: z.infer<TSchema>): Promise<unknown>;
-    readonly kind: typeof TOOL_DEFINITION_KIND;
-    readonly name: string;
-    readonly description: string;
-    readonly inputSchema: TSchema;
-    readonly needsApproval?: DefineToolConfig<TSchema>["needsApproval"];
-    /** Validate + execute with an explicit ctx (used by the agent runtime). */
-    readonly execute: (input: unknown, ctx: PlatformContext) => Promise<unknown>;
-}
-/**
- * Type-erased view of a tool definition — what agent definitions accept.
- * (HelixTool<TSchema> is invariant in its schema because of the callable's
- * input position; this structural view is what `tools: [...]` is typed as.)
- */
-interface HelixToolLike {
-    readonly kind: typeof TOOL_DEFINITION_KIND;
-    readonly name: string;
-    readonly description: string;
-    readonly inputSchema: ZodType;
-    readonly needsApproval?: boolean | ((input: never) => boolean | Promise<boolean>);
-    readonly execute: (input: unknown, ctx: PlatformContext) => Promise<unknown>;
-}
-/**
- * Define a tool an agent can call (or that your code can invoke in-process).
- */
-declare function defineTool<TSchema extends ZodType>(config: DefineToolConfig<TSchema>): HelixTool<TSchema>;
-/** Structural check for defineTool output — see TOOL_DEFINITION_KIND. */
-declare function isToolDefinition(value: unknown): value is HelixTool;
-
-/**
- * `defineAgent` (helix-spec 14) — one file per agent under
- * `functions/_agents/`, definitions in code, the file system as the source of
- * truth.
- *
- * Like `defineSchedule`, the SDK owns the definition + runtime and the
- * host (dev server, lambda router) owns discovery: importing the module
- * registers the agent by name.
- *
- * v1 deviations from the spec, both enforced with clear errors:
- * - `name` is required (filename defaulting needs build-time discovery, which
- *   arrives with the deploy-side scan);
- * - `instructionsFile` resolution requires the host to record the agent
- *   file's directory (the dev server does; direct imports in tests should use
- *   inline `instructions`).
- */
-declare const AGENT_DEFINITION_KIND = "helix-agent";
-declare const agentConfigSchema: z.ZodEffects<z.ZodObject<{
-    name: z.ZodString;
-    description: z.ZodString;
-    model: z.ZodString;
-    auth: z.ZodString;
-    fallbacks: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        model: z.ZodString;
-        auth: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        auth: string;
-        model: string;
-    }, {
-        auth: string;
-        model: string;
-    }>, "many">>;
-    instructions: z.ZodOptional<z.ZodString>;
-    instructionsFile: z.ZodOptional<z.ZodString>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodType<HelixToolLike, z.ZodTypeDef, HelixToolLike>, "many">>;
-    agents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    memory: z.ZodOptional<z.ZodObject<{
-        /**
-         * Cap on the messages the MODEL is sent each turn (default 200) — the
-         * latest stretch of the conversation, always starting on a user
-         * message so no turn is cut in half. It does not limit what is
-         * stored: the session keeps the whole conversation.
-         */
-        maxSessionMessages: z.ZodOptional<z.ZodNumber>;
-        /**
-         * Opt-in idle retention, in seconds: a session untouched for this
-         * long expires. Omitted (the default) = sessions never expire, so a
-         * user can always return to an earlier conversation.
-         */
-        ttl: z.ZodOptional<z.ZodNumber>;
-        /**
-         * `"user"` declares the agent is executed BY a user: sessions are
-         * keyed by (and only visible to) the `ctx.userId` of the invoking
-         * execution, and `agent.sessions()` lists the calling user's recent
-         * sessions. Invoking a user-scoped agent without a user identity
-         * (schedules) is a caller error. Default `"project"`: sessions are
-         * shared across the project's executions.
-         */
-        scope: z.ZodOptional<z.ZodEnum<["user", "project"]>>;
-    }, "strip", z.ZodTypeAny, {
-        scope?: "user" | "project" | undefined;
-        ttl?: number | undefined;
-        maxSessionMessages?: number | undefined;
-    }, {
-        scope?: "user" | "project" | undefined;
-        ttl?: number | undefined;
-        maxSessionMessages?: number | undefined;
-    }>>;
-    limits: z.ZodOptional<z.ZodObject<{
-        maxIterations: z.ZodOptional<z.ZodNumber>;
-        maxToolCalls: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        maxIterations?: number | undefined;
-        maxToolCalls?: number | undefined;
-    }, {
-        maxIterations?: number | undefined;
-        maxToolCalls?: number | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    auth: string;
-    name: string;
-    model: string;
-    description: string;
-    instructions?: string | undefined;
-    tools?: HelixToolLike[] | undefined;
-    fallbacks?: {
-        auth: string;
-        model: string;
-    }[] | undefined;
-    instructionsFile?: string | undefined;
-    agents?: string[] | undefined;
-    memory?: {
-        scope?: "user" | "project" | undefined;
-        ttl?: number | undefined;
-        maxSessionMessages?: number | undefined;
-    } | undefined;
-    limits?: {
-        maxIterations?: number | undefined;
-        maxToolCalls?: number | undefined;
-    } | undefined;
-}, {
-    auth: string;
-    name: string;
-    model: string;
-    description: string;
-    instructions?: string | undefined;
-    tools?: HelixToolLike[] | undefined;
-    fallbacks?: {
-        auth: string;
-        model: string;
-    }[] | undefined;
-    instructionsFile?: string | undefined;
-    agents?: string[] | undefined;
-    memory?: {
-        scope?: "user" | "project" | undefined;
-        ttl?: number | undefined;
-        maxSessionMessages?: number | undefined;
-    } | undefined;
-    limits?: {
-        maxIterations?: number | undefined;
-        maxToolCalls?: number | undefined;
-    } | undefined;
-}>, {
-    auth: string;
-    name: string;
-    model: string;
-    description: string;
-    instructions?: string | undefined;
-    tools?: HelixToolLike[] | undefined;
-    fallbacks?: {
-        auth: string;
-        model: string;
-    }[] | undefined;
-    instructionsFile?: string | undefined;
-    agents?: string[] | undefined;
-    memory?: {
-        scope?: "user" | "project" | undefined;
-        ttl?: number | undefined;
-        maxSessionMessages?: number | undefined;
-    } | undefined;
-    limits?: {
-        maxIterations?: number | undefined;
-        maxToolCalls?: number | undefined;
-    } | undefined;
-}, {
-    auth: string;
-    name: string;
-    model: string;
-    description: string;
-    instructions?: string | undefined;
-    tools?: HelixToolLike[] | undefined;
-    fallbacks?: {
-        auth: string;
-        model: string;
-    }[] | undefined;
-    instructionsFile?: string | undefined;
-    agents?: string[] | undefined;
-    memory?: {
-        scope?: "user" | "project" | undefined;
-        ttl?: number | undefined;
-        maxSessionMessages?: number | undefined;
-    } | undefined;
-    limits?: {
-        maxIterations?: number | undefined;
-        maxToolCalls?: number | undefined;
-    } | undefined;
-}>;
-type AgentDefinitionConfig = z.input<typeof agentConfigSchema>;
-interface AgentDefinition extends z.output<typeof agentConfigSchema> {
-    kind: typeof AGENT_DEFINITION_KIND;
-}
-/**
- * Define an agent (default export of a file under `functions/_agents/`).
- */
-declare function defineAgent(config: AgentDefinitionConfig): AgentDefinition;
-/** Structural check for defineAgent output — see AGENT_DEFINITION_KIND. */
-declare function isAgentDefinition(value: unknown): value is AgentDefinition;
-
-export { AGENT_DEFINITION_KIND as A, setSdkConfig as B, type ConfigFileOptions as C, type DefineToolConfig as D, 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, AI_SERVICES as a, type AgentDefinition as b, type AgentDefinitionConfig as c, type AgentSessionsConfig as d, type AiProviderEntry as e, type AiService as f, type HelixTool as g, type HelixToolLike as h, TOOL_DEFINITION_KIND as i, WORKSPACE_ID_REQUIRED_CODE as j, type WorkspaceIdRequiredError as k, agentSessionsSchema as l, aiProviderEntrySchema as m, defineAgent as n, defineTool as o, getSdkConfig as p, isAgentDefinition as q, isToolDefinition as r, loadConfig as s, loadedTrayConfigSchema as t, projectIdSchema as u, requireWorkspaceId as v, resolveConfigFile as w, resolveConfigOverride as x, workspaceIdSchema as y, type SdkConfigInput as z };