@dual-os/sdk 0.0.0-stage → 0.8.0-next.0

package/dist/DualRegistry.js

@@ -0,0 +1,96 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { collectActionEntries } from "./internal/dual/actions.js";
+import { collectTriggerEntries, resolveRuntimeTrigger } from "./internal/dual/triggers.js";
+import { materializeResolvedRegistry } from "./internal/dual/registry.js";
+import "./DualRegistry.js";
+import { Schema } from "effect";
+//#region src/DualRegistry.ts
+/**
+* Dual registry resolution and materialization.
+*
+* @since 0.0.0
+*/
+var DualRegistry_exports = /* @__PURE__ */ __exportAll({
+	DualRegistry: () => DualRegistry_exports,
+	TriggerNotFoundError: () => TriggerNotFoundError,
+	actionIds: () => actionIds,
+	materializePlugin: () => materializePlugin,
+	materializePlugins: () => materializePlugins,
+	materializeRegistry: () => materializeRegistry,
+	resolveTrigger: () => resolveTrigger,
+	triggerIds: () => triggerIds
+});
+/** Raised when a trigger lifecycle request references an unknown trigger id. */
+var TriggerNotFoundError = class extends Schema.TaggedError()("TriggerNotFoundError", { triggerId: Schema.String }) {};
+/**
+* Enumerate the canonical machine ids for every action in the app.
+*
+* @since 0.0.0
+* @category getters
+*/
+const actionIds = (app) => collectActionEntries(app.plugins).map((entry) => entry.actionId);
+/**
+* Enumerate the canonical machine ids for every trigger in the app.
+*
+* @since 0.0.0
+* @category getters
+*/
+const triggerIds = (app) => collectTriggerEntries(app.plugins).map((entry) => entry.triggerId);
+/**
+* Resolve one trigger entry from the app, including its auth methods.
+*
+* @since 0.0.0
+* @category getters
+*/
+const resolveTrigger = (app, triggerId, options = {}) => resolveRuntimeTrigger(app.plugins, triggerId, options.triggerVersion);
+/**
+* Materialize the capability catalog of an app's installed releases.
+*
+* @since 0.0.0
+* @category registry
+*/
+const materializeRegistry = (app, options = {}) => materializeResolvedRegistry({
+	aiProviders: app.aiProviders,
+	dualIdentifier: app.identifier,
+	plugins: app.plugins,
+	projectSchemas: options.projectSchemas,
+	projections: options.projections,
+	schemaJson: options.schemaJson
+});
+/**
+* Extract a release's contracts without building Layers or running handlers.
+*
+* @since 0.0.0
+* @category registry
+*/
+const materializePlugin = (plugin, options) => ({
+	pluginIdentifier: plugin.identifier,
+	pluginVersion: options.version,
+	providers: materializeResolvedRegistry({
+		aiProviders: [],
+		dualIdentifier: plugin.identifier,
+		plugins: [{
+			plugin,
+			version: options.version
+		}],
+		projectSchemas: options.projectSchemas,
+		projections: options.projections,
+		schemaJson: options.schemaJson
+	}).providers
+});
+/** Every installed plugin release and its contracts. @since 0.0.0 @category registry */
+const materializePlugins = (app, options = {}) => {
+	const projections = options.projections ?? /* @__PURE__ */ new Map();
+	return app.plugins.map((installation) => ({
+		...materializePlugin(installation.plugin, {
+			...options,
+			projections,
+			version: installation.version
+		}),
+		ordinal: 0
+	}));
+};
+//#endregion
+export { DualRegistry_exports as DualRegistry, DualRegistry_exports, TriggerNotFoundError, actionIds, materializePlugin, materializePlugins, materializeRegistry, resolveTrigger, triggerIds };
+
+//# sourceMappingURL=DualRegistry.js.map

package/dist/DualRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DualRegistry.js","names":[],"sources":["../src/DualRegistry.ts"],"sourcesContent":["/**\n * Dual registry resolution and materialization.\n *\n * @since 0.0.0\n */\nimport { Schema } from \"effect\";\n\nimport type * as AiProvider from \"./AiProvider.ts\";\nimport type { AnyApp, App } from \"./DualRuntime.ts\";\nimport { collectActionEntries, type AllActionEntries } from \"./internal/dual/actions.ts\";\nimport {\n  materializeResolvedRegistry,\n  type MaterializedRegistry,\n  type MaterializedRegistryOptions,\n} from \"./internal/dual/registry.ts\";\nimport {\n  type AllTriggerEntries,\n  collectTriggerEntries,\n  type RuntimeTriggerEntry,\n  resolveRuntimeTrigger,\n} from \"./internal/dual/triggers.ts\";\nimport type * as Plugin from \"./Plugin.ts\";\n\n/** Raised when a trigger lifecycle request references an unknown trigger id. */\nexport class TriggerNotFoundError extends Schema.TaggedError<TriggerNotFoundError>()(\n  \"TriggerNotFoundError\",\n  { triggerId: Schema.String },\n) {}\n\n/**\n * Enumerate the canonical machine ids for every action in the app.\n *\n * @since 0.0.0\n * @category getters\n */\nexport const actionIds = <\n  const P extends Plugin.Any,\n  LayerOutput,\n  LayerError,\n  LayerRequirements,\n  const AiProviders extends readonly AiProvider.Any[],\n>(\n  app: App<P, LayerOutput, LayerError, LayerRequirements, AiProviders>,\n): readonly AllActionEntries<readonly [P]>[\"actionId\"][] =>\n  // The ids are walked from the erased plugin trees; the signature carries their literal types.\n  collectActionEntries(app.plugins).map(entry => entry.actionId) as never;\n\n/**\n * Enumerate the canonical machine ids for every trigger in the app.\n *\n * @since 0.0.0\n * @category getters\n */\nexport const triggerIds = <\n  const P extends Plugin.Any,\n  LayerOutput,\n  LayerError,\n  LayerRequirements,\n  const AiProviders extends readonly AiProvider.Any[],\n>(\n  app: App<P, LayerOutput, LayerError, LayerRequirements, AiProviders>,\n): readonly AllTriggerEntries<readonly [P]>[\"triggerId\"][] =>\n  // The ids are walked from the erased plugin trees; the signature carries their literal types.\n  collectTriggerEntries(app.plugins).map(entry => entry.triggerId) as never;\n\n/**\n * Resolve one trigger entry from the app, including its auth methods.\n *\n * @since 0.0.0\n * @category getters\n */\nexport const resolveTrigger = (\n  app: AnyApp,\n  triggerId: string,\n  options: { readonly triggerVersion?: string } = {},\n): RuntimeTriggerEntry | undefined =>\n  resolveRuntimeTrigger(app.plugins, triggerId, options.triggerVersion);\n\n/** @since 0.0.0 @category registry */\nexport type {\n  MaterializedActionCapabilityVersion,\n  MaterializedChannelCapabilityVersion,\n  MaterializedAuthMethod,\n  MaterializedCapabilityVersion,\n  MaterializedProvider,\n  MaterializedRegistry,\n  MaterializedRegistryOptions,\n  MaterializedTriggerCapabilityVersion,\n} from \"./internal/dual/registry.ts\";\n\n/**\n * Materialize the capability catalog of an app's installed releases.\n *\n * @since 0.0.0\n * @category registry\n */\nexport const materializeRegistry = (\n  app: AnyApp,\n  options: MaterializedRegistryOptions = {},\n): MaterializedRegistry =>\n  materializeResolvedRegistry({\n    aiProviders: app.aiProviders,\n    dualIdentifier: app.identifier,\n    plugins: app.plugins,\n    projectSchemas: options.projectSchemas,\n    projections: options.projections,\n    schemaJson: options.schemaJson,\n  });\n\n/** The contracts of one plugin release. @since 0.0.0 @category registry */\nexport interface MaterializedPlugin {\n  readonly pluginIdentifier: string;\n  readonly pluginVersion: string;\n  readonly providers: readonly MaterializedRegistry[\"providers\"][number][];\n}\n\n/**\n * Extract a release's contracts without building Layers or running handlers.\n *\n * @since 0.0.0\n * @category registry\n */\nexport const materializePlugin = (\n  plugin: Plugin.Any,\n  options: MaterializedRegistryOptions & { readonly version: string },\n): MaterializedPlugin => ({\n  pluginIdentifier: plugin.identifier,\n  pluginVersion: options.version,\n  providers: materializeResolvedRegistry({\n    aiProviders: [],\n    dualIdentifier: plugin.identifier,\n    plugins: [{ plugin, version: options.version }],\n    projectSchemas: options.projectSchemas,\n    projections: options.projections,\n    schemaJson: options.schemaJson,\n  }).providers,\n});\n\n/** Every installed plugin release and its contracts. @since 0.0.0 @category registry */\nexport const materializePlugins = (app: AnyApp, options: MaterializedRegistryOptions = {}) => {\n  const projections = options.projections ?? new Map<Schema.Top, unknown>();\n  return app.plugins.map(installation => ({\n    ...materializePlugin(installation.plugin, {\n      ...options,\n      projections,\n      version: installation.version,\n    }),\n    ordinal: 0,\n  }));\n};\n\nexport * as DualRegistry from \"./DualRegistry.ts\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAa,uBAAb,cAA0C,OAAO,YAAkC,CAAC,CAClF,wBACA,EAAE,WAAW,OAAO,OAAO,CAC7B,CAAC,CAAC,CAAC;;;;;;;AAQH,MAAa,aAOX,QAGA,qBAAqB,IAAI,OAAO,CAAC,CAAC,KAAI,UAAS,MAAM,QAAQ;;;;;;;AAQ/D,MAAa,cAOX,QAGA,sBAAsB,IAAI,OAAO,CAAC,CAAC,KAAI,UAAS,MAAM,SAAS;;;;;;;AAQjE,MAAa,kBACX,KACA,WACA,UAAgD,CAAC,MAEjD,sBAAsB,IAAI,SAAS,WAAW,QAAQ,cAAc;;;;;;;AAoBtE,MAAa,uBACX,KACA,UAAuC,CAAC,MAExC,4BAA4B;CAC1B,aAAa,IAAI;CACjB,gBAAgB,IAAI;CACpB,SAAS,IAAI;CACb,gBAAgB,QAAQ;CACxB,aAAa,QAAQ;CACrB,YAAY,QAAQ;AACtB,CAAC;;;;;;;AAeH,MAAa,qBACX,QACA,aACwB;CACxB,kBAAkB,OAAO;CACzB,eAAe,QAAQ;CACvB,WAAW,4BAA4B;EACrC,aAAa,CAAC;EACd,gBAAgB,OAAO;EACvB,SAAS,CAAC;GAAE;GAAQ,SAAS,QAAQ;EAAQ,CAAC;EAC9C,gBAAgB,QAAQ;EACxB,aAAa,QAAQ;EACrB,YAAY,QAAQ;CACtB,CAAC,CAAC,CAAC;AACL;;AAGA,MAAa,sBAAsB,KAAa,UAAuC,CAAC,MAAM;CAC5F,MAAM,cAAc,QAAQ,+BAAe,IAAI,IAAyB;CACxE,OAAO,IAAI,QAAQ,KAAI,kBAAiB;EACtC,GAAG,kBAAkB,aAAa,QAAQ;GACxC,GAAG;GACH;GACA,SAAS,aAAa;EACxB,CAAC;EACD,SAAS;CACX,EAAE;AACJ"}

package/dist/DualRuntime.d.ts

@@ -0,0 +1,279 @@
+import { Binding } from "./AuthMethodBinding.js";
+import { JsonRequest } from "./AuthMethodExecution.js";
+import { Any, AuthMethodHookError, ExpectedOAuth2MethodError, InputSchema, MaterialSchema, OAuth2RefreshTokenUnavailableError, OAuth2TokenResponse, RefreshReason, Requirements, SetupSchema, ValueSchema } from "./AuthMethod.js";
+import { ActionHandlerError, ActionHandlerFailure, RetryableActionHandlerError } from "./Action.js";
+import { ConnectionIdNotAllowedError, ConnectionReauthorizationRequiredError, ConnectionRequiredError, ConnectionResolutionContext, ConnectionResolverStoreError, ConnectionSelectionRequiredError, InvalidConnectionIdError, InvalidResolvedConnectionError } from "./ConnectionResolver.js";
+import { ActivateSuccess, DeactivateSuccess, EmittedEventsSuccess, VerifySuccess, WebhookRequest } from "./Trigger.js";
+import { Any as Any$1, LayerError, LayerOutput as LayerOutput$1, LayerRequirements as LayerRequirements$1 } from "./Plugin.js";
+import { Interface, Requirements as Requirements$1 } from "./AgentChannelRuntime.js";
+import { Any as Any$2, RuntimeConfig, RuntimeModel } from "./AiProvider.js";
+import { PluginActions } from "./internal/dual/actions.js";
+import { ActionHandlerNotFoundError, ActionNotFoundError, FieldIssue, InvalidActionInputError, InvalidActionOutputError, InvokeError, InvokeMeta, InvokeRequest, InvokeRequirementsFor, InvokeSuccess, PluginRequirements } from "./internal/dual/invoke.js";
+import "./DualRuntime.js";
+import { Context, Effect, Layer, Schema } from "effect";
+import { HttpClientRequest } from "effect/http";
+declare namespace DualRuntime_d_exports {
+  export { ActionHandlerError, ActionHandlerFailure, ActionHandlerNotFoundError, ActionNotFoundError, AiModelConfigError, AiProviderRuntimeNotConfiguredError, AnyApp, App, AuthMethodExecutionError, AuthMethodNotFoundError, AuthMethodRequest, ConnectionIdNotAllowedError, ConnectionReauthorizationRequiredError, ConnectionRequiredError, ConnectionResolverStoreError, ConnectionSelectionRequiredError, DecodeAuthMethodSetupRequest, DualRuntime_d_exports as DualRuntime, FieldIssue, InvalidActionInputError, InvalidActionOutputError, InvalidConnectionIdError, InvalidResolvedConnectionError, InvokeError, InvokeMeta, InvokeRequest, InvokeRequirementsFor, InvokeSuccess, PluginInstallation, PrepareAuthMethodRequest, PrepareOAuth2TokensRequest, RefreshAuthMethodRequest, ResolveAiModelConfigRequest, ResolveAuthMethodRequest, ResolvedSandboxAccess, RetryableActionHandlerError, RuntimeInvokeRequest, RuntimeRequirementsFor, RuntimeService, RuntimeTriggerLifecycleRequest, RuntimeWebhookActivationRequest, RuntimeWebhookTriggerLifecycleRequest, SandboxAccessError, SandboxAccessNotDeclaredError, SandboxRequestNotAllowedError, Service, ToLayerError, ToLayerRequirements, WithPlugin, WithPlugins, fromPlugin, install, invoke, make, toLayer, withPlugin, withPlugins };
+}
+/**
+ * One installed plugin release.
+ *
+ * @since 0.7.0
+ * @category models
+ */
+export interface PluginInstallation<P extends Any$1 = Any$1> {
+  readonly plugin: P;
+  /** The plugin's package version. */
+  readonly version: string;
+}
+/**
+ * The plugin releases and AI providers one runtime executes, with the services their handlers need.
+ *
+ * @since 0.7.0
+ * @category models
+ */
+export interface App<out P extends Any$1 = Any$1, LayerOutput = never, out LayerError = never, out LayerRequirements = never, out AiProviders extends readonly Any$2[] = readonly Any$2[]> {
+  readonly identifier: string;
+  readonly aiProviders: AiProviders;
+  readonly plugins: readonly PluginInstallation<P>[];
+  readonly layer: Layer.Layer<LayerOutput, LayerError, LayerRequirements>;
+}
+/**
+ * Constraint type for working with any {@link App}.
+ *
+ * @since 0.7.0
+ * @category type-level
+ */
+export interface AnyApp extends App<Any$1, never, any, any, readonly Any$2[]> {}
+/**
+ * Install one plugin release.
+ *
+ * @since 0.7.0
+ * @category constructors
+ */
+export declare const install: <P extends Any$1>(plugin: P, version: string) => PluginInstallation<P>;
+/**
+ * The runtime of one plugin release, as the plugin's own process runs it. `version` defaults to
+ * `0.0.0` for tests that do not need the package version.
+ *
+ * @since 0.7.0
+ * @category constructors
+ */
+export declare const fromPlugin: <const P extends Any$1>(plugin: P, version?: string) => App<P, LayerOutput$1<readonly [P]>, LayerError<readonly [P]>, LayerRequirements$1<readonly [P]>, readonly []>;
+/**
+ * An app runtime without plugins, for {@link withPlugin} and {@link withPlugins} to fill.
+ *
+ * @since 0.7.0
+ * @category constructors
+ */
+export declare const make: (identifier: string) => App<never, never, never, never, readonly []>;
+type AppPlugin<A extends AnyApp> = A extends App<infer P, any, any, any, any> ? P : never;
+type AppLayerOutput<A extends AnyApp> = A extends App<any, infer Output, any, any, any> ? Output : never;
+type AppLayerError<A extends AnyApp> = A extends App<any, any, infer Error, any, any> ? Error : never;
+type AppLayerRequirements<A extends AnyApp> = A extends App<any, any, any, infer Requirements, any> ? Requirements : never;
+/**
+ * Result of adding a plugin release to an app runtime. A named interface keeps declaration emit
+ * from expanding every plugin and layer member at large call sites.
+ *
+ * @since 0.7.0
+ * @category type-level
+ */
+export interface WithPlugin<Self extends AnyApp, Added extends Any$1> extends App<AppPlugin<Self> | Added, AppLayerOutput<Self> | LayerOutput$1<readonly [Added]>, AppLayerError<Self> | LayerError<readonly [Added]>, LayerRequirements$1<readonly [Added]> | Exclude<AppLayerRequirements<Self>, LayerOutput$1<readonly [Added]>>, Self["aiProviders"]> {}
+type BulkLayerRequirements<Added extends readonly Any$1[], Requirements> = number extends Added["length"] ? Requirements | Layer.Services<Added[number]["layer"]> : Added extends readonly [infer Head extends Any$1, ...infer Tail extends readonly Any$1[]] ? BulkLayerRequirements<Tail, Layer.Services<Head["layer"]> | Exclude<Requirements, Layer.Success<Head["layer"]>>> : Requirements;
+/**
+ * Result of adding several plugin releases to an app runtime in one step.
+ *
+ * @since 0.7.0
+ * @category type-level
+ */
+export interface WithPlugins<Self extends AnyApp, Added extends readonly Any$1[]> extends App<AppPlugin<Self> | Added[number], AppLayerOutput<Self> | Layer.Success<Added[number]["layer"]>, AppLayerError<Self> | Layer.Error<Added[number]["layer"]>, BulkLayerRequirements<Added, AppLayerRequirements<Self>>, Self["aiProviders"]> {}
+/** A plugin and the package version of its release. */
+type PluginEntry = readonly [plugin: Any$1, version: string];
+type PluginsOf<Entries extends readonly PluginEntry[]> = { readonly [K in keyof Entries]: Entries[K][0]; };
+/**
+ * Add one plugin release: the plugin and its package version.
+ *
+ * @since 0.7.0
+ * @category combinators
+ */
+export declare const withPlugin: {
+  <const P extends Any$1>(plugin: P, version: string): <Self extends AnyApp>(app: Self) => WithPlugin<Self, P>;
+  <Self extends AnyApp, const P extends Any$1>(app: Self, plugin: P, version: string): WithPlugin<Self, P>;
+};
+/**
+ * Add several plugin releases in one step, which keeps a large app's inferred type compact.
+ *
+ * @since 0.7.0
+ * @category combinators
+ */
+export declare const withPlugins: {
+  <const E extends readonly PluginEntry[]>(entries: E): <Self extends AnyApp>(app: Self) => WithPlugins<Self, PluginsOf<E>>;
+  <Self extends AnyApp, const E extends readonly PluginEntry[]>(app: Self, entries: E): WithPlugins<Self, PluginsOf<E>>;
+};
+export declare const invoke: <const P extends Any$1, LayerOutput, LayerError, LayerRequirements, const AiProviders extends readonly Any$2[]>(app: App<P, LayerOutput, LayerError, LayerRequirements, AiProviders>, request: InvokeRequest) => Effect.Effect<InvokeSuccess, InvokeError | LayerError, LayerRequirements | Exclude<RuntimeRequirementsFor<P>, LayerOutput>>;
+/**
+ * Runtime-first invocation request accepted by {@link Service}.
+ *
+ * @since 0.0.0
+ * @category models
+ */
+export type RuntimeInvokeRequest = InvokeRequest;
+/**
+ * Runtime-first trigger lifecycle request accepted by {@link Service}.
+ *
+ * @since 0.0.0
+ * @category models
+ */
+export interface RuntimeTriggerLifecycleRequest {
+  readonly triggerId: string;
+  readonly pluginKey?: string;
+  /** The exact plugin release the caller pinned; another installed release does not run. */
+  readonly triggerVersion?: string | undefined;
+  readonly config: unknown;
+  readonly state?: unknown | undefined;
+  readonly connectionId?: string | undefined;
+  readonly context?: ConnectionResolutionContext | undefined;
+}
+export interface RuntimeWebhookActivationRequest extends RuntimeTriggerLifecycleRequest {
+  readonly webhookUrl: string;
+}
+export interface RuntimeWebhookTriggerLifecycleRequest extends RuntimeWebhookActivationRequest {
+  readonly request: WebhookRequest;
+}
+export interface AuthMethodRequest {
+  readonly providerId: string;
+  readonly authMethodId: string;
+}
+export interface DecodeAuthMethodSetupRequest extends AuthMethodRequest {
+  readonly encoding?: "json";
+  readonly setup: unknown;
+}
+export interface PrepareAuthMethodRequest extends AuthMethodRequest {
+  readonly input: unknown;
+  readonly setup: unknown;
+}
+export interface PrepareOAuth2TokensRequest extends AuthMethodRequest {
+  readonly tokens: OAuth2TokenResponse;
+  readonly setup: unknown;
+}
+export interface RefreshAuthMethodRequest extends AuthMethodRequest {
+  readonly material: unknown;
+  readonly setup: unknown;
+  readonly now: number;
+  readonly minValidityMs: number;
+  readonly reason: RefreshReason;
+}
+export interface ResolveAuthMethodRequest extends AuthMethodRequest {
+  /** `json` when the material and setup arrive in their canonical JSON encoding, as in the sandbox. */
+  readonly encoding?: "json";
+  readonly material: unknown;
+  readonly setup: unknown;
+}
+export interface ResolveAiModelConfigRequest extends ResolveAuthMethodRequest {
+  readonly model: RuntimeModel;
+}
+declare const AuthMethodNotFoundError_base: Schema.Class<AuthMethodNotFoundError, Schema.TaggedStruct<"AuthMethodNotFoundError", {
+  readonly authMethodId: Schema.String;
+  readonly providerId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class AuthMethodNotFoundError extends AuthMethodNotFoundError_base {}
+export type AuthMethodExecutionError = AuthMethodNotFoundError | Schema.SchemaError | ExpectedOAuth2MethodError | OAuth2RefreshTokenUnavailableError | AuthMethodHookError;
+declare const AiProviderRuntimeNotConfiguredError_base: Schema.Class<AiProviderRuntimeNotConfiguredError, Schema.TaggedStruct<"AiProviderRuntimeNotConfiguredError", {
+  readonly providerId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class AiProviderRuntimeNotConfiguredError extends AiProviderRuntimeNotConfiguredError_base {}
+export type AiModelConfigError = AuthMethodExecutionError | AiProviderRuntimeNotConfiguredError;
+declare const SandboxAccessNotDeclaredError_base: Schema.Class<SandboxAccessNotDeclaredError, Schema.TaggedStruct<"SandboxAccessNotDeclaredError", {
+  readonly providerId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Raised when a provider declares no sandbox access. */
+export declare class SandboxAccessNotDeclaredError extends SandboxAccessNotDeclaredError_base {}
+declare const SandboxRequestNotAllowedError_base: Schema.Class<SandboxRequestNotAllowedError, Schema.TaggedStruct<"SandboxRequestNotAllowedError", {
+  readonly origin: Schema.String;
+  readonly path: Schema.String;
+  readonly providerId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Raised when the Connection may not be sent with a sandbox request: another origin, or a request the provider refuses. */
+export declare class SandboxRequestNotAllowedError extends SandboxRequestNotAllowedError_base {}
+export type SandboxAccessError = AuthMethodExecutionError | SandboxAccessNotDeclaredError;
+/** One Connection's sandbox access: where its credential may go, and how a request gets it. */
+export interface ResolvedSandboxAccess {
+  readonly origins: readonly string[];
+  readonly authorize: (request: HttpClientRequest.HttpClientRequest) => Effect.Effect<HttpClientRequest.HttpClientRequest, SandboxRequestNotAllowedError>;
+}
+/**
+ * Runtime service materialized from an {@link App}.
+ *
+ * @since 0.0.0
+ * @category services
+ */
+export interface RuntimeService {
+  readonly executeAuthJson: (request: JsonRequest) => Effect.Effect<unknown, AuthMethodExecutionError>;
+  readonly invokeJson: (request: RuntimeInvokeRequest) => Effect.Effect<InvokeSuccess<string, Schema.Json>, InvokeError | Schema.SchemaError>;
+  readonly decodeAgentChannelDefinitionSettings: Interface["decodeDefinitionSettings"];
+  readonly decodeAgentChannelDeploymentSettings: Interface["decodeDeploymentSettings"];
+  readonly getAgentChannel: Interface["get"];
+  readonly checkAccessAgentChannel: Interface["checkAccess"];
+  readonly executeAgentChannel: Interface["execute"];
+  readonly invoke: (request: RuntimeInvokeRequest) => Effect.Effect<InvokeSuccess, InvokeError>;
+  readonly activateTrigger: (request: RuntimeWebhookActivationRequest) => Effect.Effect<ActivateSuccess, unknown>;
+  readonly deactivateTrigger: (request: RuntimeWebhookActivationRequest) => Effect.Effect<DeactivateSuccess, unknown>;
+  readonly verifyTrigger: (request: RuntimeWebhookTriggerLifecycleRequest) => Effect.Effect<VerifySuccess, unknown>;
+  readonly parseTrigger: (request: RuntimeWebhookTriggerLifecycleRequest) => Effect.Effect<EmittedEventsSuccess<string, "parse">, unknown>;
+  readonly pollTrigger: (request: RuntimeTriggerLifecycleRequest) => Effect.Effect<EmittedEventsSuccess<string, "poll">, unknown>;
+  readonly getAuthMethod: (request: AuthMethodRequest) => Effect.Effect<Any, AuthMethodNotFoundError>;
+  readonly decodeAuthMethodSetup: (request: DecodeAuthMethodSetupRequest) => Effect.Effect<unknown, AuthMethodExecutionError>;
+  readonly prepareAuthMethod: (request: PrepareAuthMethodRequest) => Effect.Effect<unknown, AuthMethodExecutionError>;
+  readonly prepareOAuth2Tokens: (request: PrepareOAuth2TokensRequest) => Effect.Effect<unknown, AuthMethodExecutionError>;
+  readonly refreshAuthMethod: (request: RefreshAuthMethodRequest) => Effect.Effect<unknown | undefined, AuthMethodExecutionError>;
+  readonly resolveAuthMethod: (request: ResolveAuthMethodRequest) => Effect.Effect<Binding, AuthMethodExecutionError>;
+  readonly resolveAiModelConfig: (request: ResolveAiModelConfigRequest) => Effect.Effect<RuntimeConfig, AiModelConfigError>;
+  readonly resolveSandboxAccess: (request: ResolveAuthMethodRequest) => Effect.Effect<ResolvedSandboxAccess, SandboxAccessError>;
+}
+declare const Service_base: Context.ServiceClass<Service, "@dual-os/sdk/Dual/Service", RuntimeService>;
+/**
+ * Effect service provided by {@link toLayer}.
+ *
+ * @since 0.0.0
+ * @category services
+ */
+export declare class Service extends Service_base {}
+export type RuntimeRequirementsFor<P extends Any$1> = Requirements$1<P> | (P extends Any$1 ? PluginRequirements<P, PluginActions<P>> : never);
+type AuthProvider = Any$1 | Any$2;
+type AuthMethodFor<Providers extends AuthProvider> = Providers["authMethods"][number];
+type AuthMethodSetupDecodeRequirements<Method extends Any> = SetupSchema<Method> extends Schema.Top ? Schema.Codec.DecodingServices<SetupSchema<Method>> : never;
+type AuthMethodInputDecodeRequirements<Method extends Any> = InputSchema<Method> extends Schema.Top ? Schema.Codec.DecodingServices<InputSchema<Method>> : never;
+type AuthMethodExecutionRequirementsFor<Providers extends AuthProvider> = AuthMethodFor<Providers> extends (infer Method) ? Method extends Any ? Requirements<Method> | AuthMethodSetupDecodeRequirements<Method> | AuthMethodInputDecodeRequirements<Method> | Schema.Codec.DecodingServices<MaterialSchema<Method>> | Schema.Codec.DecodingServices<ValueSchema<Method>> | Schema.Codec.EncodingServices<MaterialSchema<Method>> | Schema.Codec.EncodingServices<ValueSchema<Method>> | (SetupSchema<Method> extends Schema.Top ? Schema.Codec.EncodingServices<SetupSchema<Method>> : never) : never : never;
+/**
+ * Requirements still needed by {@link toLayer} for an app.
+ *
+ * Hosts (the server, a worker, a test harness) never know an app's concrete
+ * implementations: they talk to it exclusively through the generic
+ * {@link Service} layer. App-specific dependencies — a plugin's API client, an
+ * auth hook's token service — are discharged where they are known, at the
+ * plugin or app definition (the `Exclude<..., LayerOutput>` below cancels
+ * them). Only what the definition did not discharge surfaces here,
+ * generically, and the host entrypoint forces it to `never` before anything
+ * runs.
+ *
+ * @since 0.0.0
+ * @category type-level
+ */
+export type ToLayerRequirements<A extends AnyApp> = A extends App<infer P extends Any$1, infer LayerOutput, any, infer LayerRequirements, infer AiProviders extends readonly Any$2[]> ? LayerRequirements | Exclude<RuntimeRequirementsFor<P>, LayerOutput> | Exclude<AuthMethodExecutionRequirementsFor<P | AiProviders[number]>, LayerOutput> : never;
+/**
+ * Layer-construction errors surfaced by {@link toLayer} for an app.
+ *
+ * @since 0.0.0
+ * @category type-level
+ */
+export type ToLayerError<A extends AnyApp> = A extends App<any, any, infer LayerError, any, any> ? LayerError : never;
+/**
+ * Turn an {@link App} into a runtime Effect service layer.
+ *
+ * @since 0.0.0
+ * @category layers
+ */
+export declare const toLayer: <const P extends Any$1, LayerOutput, LayerError, LayerRequirements, const AiProviders extends readonly Any$2[]>(app: App<P, LayerOutput, LayerError, LayerRequirements, AiProviders>) => Layer.Layer<Service, LayerError, LayerRequirements | Exclude<RuntimeRequirementsFor<P>, LayerOutput> | Exclude<AuthMethodExecutionRequirementsFor<P | AiProviders[number]>, LayerOutput>>;
+//#endregion
+export { ActionHandlerError, type ActionHandlerFailure, ActionHandlerNotFoundError, ActionNotFoundError, ConnectionIdNotAllowedError, ConnectionReauthorizationRequiredError, ConnectionRequiredError, ConnectionResolverStoreError, ConnectionSelectionRequiredError, DualRuntime_d_exports as DualRuntime, DualRuntime_d_exports, FieldIssue, InvalidActionInputError, InvalidActionOutputError, InvalidConnectionIdError, InvalidResolvedConnectionError, type InvokeError, type InvokeMeta, type InvokeRequest, type InvokeRequirementsFor, type InvokeSuccess, RetryableActionHandlerError };
+//# sourceMappingURL=DualRuntime.d.ts.map

package/dist/DualRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DualRuntime.d.ts","names":["Plugin.Any","AiProvider.Any","Plugin.LayerOutput","Plugin.LayerError","Plugin.LayerRequirements","Trigger.WebhookRequest","AuthMethod.OAuth2TokenResponse","AuthMethod.RefreshReason","AiProvider.RuntimeModel","AuthMethod.ExpectedOAuth2MethodError","AuthMethod.OAuth2RefreshTokenUnavailableError","AuthMethod.AuthMethodHookError","AuthMethodExecution.JsonRequest","AgentChannelRuntime.Interface","Trigger.ActivateSuccess","Trigger.DeactivateSuccess","Trigger.VerifySuccess","Trigger.EmittedEventsSuccess","AuthMethod.Any","AuthMethodBinding.Binding","AiProvider.RuntimeConfig","AgentChannelRuntime.Requirements","AuthMethod.SetupSchema","AuthMethod.InputSchema","AuthMethod.Requirements","AuthMethod.MaterialSchema","AuthMethod.ValueSchema"],"sources":["../src/DualRuntime.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;iBAqEiB,mBAAmB,UAAUA,QAAaA;WAChD,QAAQ;;WAER;;;;;;;;iBASM,QACX,UAAUA,QAAaA,OAC3B,yBACI,wBACA,+BACA,6BAA6BC,mBAA4BA;WAEpD;WACA,aAAa;WACb,kBAAkB,mBAAmB;WACrC,OAAO,MAAM,MAAM,aAAa,YAAY;;;;;;;;iBAStC,eAAe,IAAID,iCAAsCC;;;;;;;qBAQ7D,UAAW,UAAUD,OAAU,QAClC,GAAC,oBAER,mBAAmB;;;;;;;;qBAST,mBAAoB,UAAUA,OAAU,QAC3C,GAAC,qBAER,IACD,GACAE,wBAA6B,KAC7BC,qBAA4B,KAC5BC,8BAAmC;;;;;;;qBAgBxB,OAAI,uBAAyB;KAOrC,UAAU,UAAU,UAAU,UAAU,UAAU,yBAAyB;KAC3E,eAAe,UAAU,UAC5B,UAAU,eAAe,yBAAyB;KAC/C,cAAc,UAAU,UAC3B,UAAU,oBAAoB,mBAAmB;KAC9C,qBAAqB,UAAU,UAClC,UAAU,yBAAyB,qBAAqB;;;;;;;;iBASzC,WAAW,aAAa,QAAQ,cAAcJ,eAAoB,IACjF,UAAU,QAAQ,OAClB,eAAe,QAAQE,wBAA6B,SACpD,cAAc,QAAQC,qBAA4B,SAChDC,8BAAmC,UACnC,QAAQ,qBAAqB,OAAOF,wBAA6B,UACnE;KAMG,sBACH,uBAAuBF,SACvB,+BACiB,kBACf,eAAe,MAAM,SAAS,0BAC9B,8BACU,aAAaA,gBACV,sBAAsBA,WAEjC,sBACE,MACA,MAAM,SAAS,iBAAiB,QAAQ,cAAc,MAAM,QAAQ,mBAEtE;;;;;;;iBAQW,YAAY,aAAa,QAAQ,uBAAuBA,iBAAsB,IAC7F,UAAU,QAAQ,eAClB,eAAe,QAAQ,MAAM,QAAQ,yBACrC,cAAc,QAAQ,MAAM,MAAM,yBAClC,sBAAsB,OAAO,qBAAqB,QAClD;;KAKG,wBAAwB,QAAQA,OAAY;KAE5C,UAAU,yBAAyB,6BAC5B,WAAW,UAAU,QAAQ;;;;;;;qBAmC5B;SACJ,UAAUA,OACf,QAAQ,GACR,mBACE,aAAa,QAAQ,KAAK,SAAS,WAAW,MAAM;GACvD,aAAa,cAAc,UAAUA,OACpC,KAAK,MACL,QAAQ,GACR,kBACC,WAAW,MAAM;;;;;;;;qBAWT;SACJ,mBAAmB,eACxB,SAAS,KACP,aAAa,QAAQ,KAAK,SAAS,YAAY,MAAM,UAAU;GAClE,aAAa,cAAc,mBAAmB,eAC7C,KAAK,MACL,SAAS,IACR,YAAY,MAAM,UAAU;;qBAqNpB,eACL,UAAUA,OAChB,aACA,YACA,yBACM,6BAA6BC,SAAgB,KAE9C,IAAI,GAAG,aAAa,YAAY,mBAAmB,cAAY,SAC3D,kBACR,OAAO,OACR,eACA,cAAc,YACd,oBAAoB,QAAQ,uBAAuB,IAAI;;;;;;;YAS7C,uBAAuB;;;;;;;iBAQlB;WACN;WACA;;WAEA;WACA;WACA;WACA;WACA,UAAU;;iBAGJ,wCAAwC;WAC9C;;iBAGM,8CAA8C;WACpD,SAASI;;iBAGH;WACN;WACA;;iBAGM,qCAAqC;WAC3C;WACA;;iBAGM,iCAAiC;WACvC;WACA;;iBAGM,mCAAmC;WACzC,QAAQC;WACR;;iBAGM,iCAAiC;WACvC;WACA;WACA;WACA;WACA,QAAQC;;iBAGF,iCAAiC;;WAEvC;WACA;WACA;;iBAGM,oCAAoC;WAC1C,OAAOC;;;;;;qBAGL,gCAAgC;YAKjC,2BACR,0BACA,OAAO,cACPC,4BACAC,qCACAC;;;;qBAES,4CAA4C;YAK7C,qBAAqB,2BAA2B;;;;;qBAG/C,sCAAsC;;;;;;;qBAMtC,sCAAsC;YAKvC,qBAAqB,2BAA2B;;iBAG3C;WACN;WACA,YACP,SAAS,kBAAkB,sBACxB,OAAO,OAAO,kBAAkB,mBAAmB;;;;;;;;iBASzC;WACN,kBACP,SAASC,gBACN,OAAO,gBAAgB;WACnB,aACP,SAAS,yBACN,OAAO,OAAO,sBAAsB,OAAO,OAAO,cAAc,OAAO;WACnE,sCAAsCC;WACtC,sCAAsCA;WACtC,iBAAiBA;WACjB,yBAAyBA;WACzB,qBAAqBA;WACrB,SAAS,SAAS,yBAAyB,OAAO,OAAO,eAAe;WACxE,kBACP,SAAS,oCACN,OAAO,OAAOC;WACV,oBACP,SAAS,oCACN,OAAO,OAAOC;WACV,gBACP,SAAS,0CACN,OAAO,OAAOC;WACV,eACP,SAAS,0CACN,OAAO,OAAOC;WACV,cACP,SAAS,mCACN,OAAO,OAAOA;WACV,gBACP,SAAS,sBACN,OAAO,OAAOC,KAAgB;WAG1B,wBACP,SAAS,iCACN,OAAO,gBAAgB;WACnB,oBACP,SAAS,6BACN,OAAO,gBAAgB;WACnB,sBACP,SAAS,+BACN,OAAO,gBAAgB;WACnB,oBACP,SAAS,6BACN,OAAO,4BAA4B;WAC/B,oBACP,SAAS,6BACN,OAAO,OAAOC,SAA2B;WACrC,uBACP,SAAS,gCACN,OAAO,OAAOC,eAA0B;WACpC,uBACP,SAAS,6BACN,OAAO,OAAO,uBAAuB;;;;;;;;;qBAS/B,gBAAgB;YAIjB,uBAAuB,UAAUpB,SACzCqB,eAAiC,MAChC,UAAUrB,QAAa,mBAAmB,GAAG,cAAc;KAE3D,eAAeA,QAAaC;KAE5B,cAAc,kBAAkB,gBAAgB;KAEhD,kCAAkC,eAAeiB,OACpDI,YAAuB,gBAAgB,OAAO,MAC1C,OAAO,MAAM,iBAAiBA,YAAuB;KAGtD,kCAAkC,eAAeJ,OACpDK,YAAuB,gBAAgB,OAAO,MAC1C,OAAO,MAAM,iBAAiBA,YAAuB;KAGtD,mCAAmC,kBAAkB,gBACxD,cAAc,0BAAyB,UACnC,eAAeL,MAETM,aAAwB,UACxB,kCAAkC,UAClC,kCAAkC,UAClC,OAAO,MAAM,iBAAiBC,eAA0B,WACxD,OAAO,MAAM,iBAAiBC,YAAuB,WACrD,OAAO,MAAM,iBAAiBD,eAA0B,WACxD,OAAO,MAAM,iBAAiBC,YAAuB,YACpDJ,YAAuB,gBAAgB,OAAO,MAC3C,OAAO,MAAM,iBAAiBA,YAAuB;;;;;;;;;;;;;;;;YAoBzD,oBAAoB,UAAU,UACxC,UAAU,UACF,UAAUtB,aACV,wBAEA,yBACA,6BAA6BC,WAG7B,oBACA,QAAQ,uBAAuB,IAAI,eACnC,QAAQ,mCAAmC,IAAI,sBAAsB;;;;;;;YASnE,aAAa,UAAU,UACjC,UAAU,oBAAoB,wBAAwB;;;;;;;qBAQ3C,gBACL,UAAUD,OAChB,aACA,YACA,yBACM,6BAA6BC,SAAgB,KAE9C,IAAI,GAAG,aAAa,YAAY,mBAAmB,iBACvD,MAAM,MACP,SACA,YACE,oBACA,QAAQ,uBAAuB,IAAI,eACnC,QAAQ,mCAAmC,IAAI,sBAAsB"}