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

package/dist/internal/dual/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","names":[],"sources":["../../../src/internal/dual/actions.ts"],"sourcesContent":["import type * as Action from \"../../Action.ts\";\nimport type * as AuthMethod from \"../../AuthMethod.ts\";\nimport type { PluginInstallation } from \"../../DualRuntime.ts\";\nimport type * as Group from \"../../Group.ts\";\nimport type * as Plugin from \"../../Plugin.ts\";\nimport { walkCapabilities } from \"../capabilities.ts\";\nimport type { MachineIdSeparator } from \"../identifier.ts\";\nimport type { IsAny, IsGenericArray } from \"../types.ts\";\n\ninterface ActionEntry<Id extends string = string, ActionDef extends Action.Any = Action.Any> {\n  readonly actionId: Id;\n  readonly action: ActionDef;\n}\n\ntype ActionEntriesFromActions<Actions extends readonly Action.Any[], Prefix extends string> =\n  IsGenericArray<Actions> extends true\n    ? ActionEntry\n    : Actions[number] extends infer ActionDef\n      ? ActionDef extends Action.Any\n        ? ActionEntry<`${Prefix}${typeof MachineIdSeparator}${ActionDef[\"identifier\"]}`, ActionDef>\n        : never\n      : never;\n\ntype ActionEntriesFromGroups<Groups extends readonly Group.Any[], Prefix extends string> =\n  IsGenericArray<Groups> extends true\n    ? ActionEntry\n    : Groups[number] extends infer GroupDef\n      ? GroupDef extends Group.Any\n        ? GroupActionEntries<\n            GroupDef,\n            `${Prefix}${typeof MachineIdSeparator}${GroupDef[\"identifier\"]}`\n          >\n        : never\n      : never;\n\ntype GroupActionEntries<GroupDef extends Group.Any, Prefix extends string> =\n  | ActionEntriesFromActions<GroupDef[\"actions\"], Prefix>\n  | ActionEntriesFromGroups<GroupDef[\"groups\"], Prefix>;\n\nexport type PluginActionEntries<P extends Plugin.Any> =\n  | ActionEntriesFromActions<P[\"actions\"], P[\"identifier\"]>\n  | ActionEntriesFromGroups<P[\"groups\"], P[\"identifier\"]>;\n\nexport type AllActionEntries<Plugins extends readonly Plugin.Any[]> =\n  IsAny<Plugins> extends true\n    ? ActionEntry\n    : IsGenericArray<Plugins> extends true\n      ? ActionEntry\n      : Plugins[number] extends infer P\n        ? P extends Plugin.Any\n          ? PluginActionEntries<P>\n          : never\n        : never;\n\ntype GroupActions<Groups extends readonly Group.Any[]> =\n  IsGenericArray<Groups> extends true\n    ? Action.Any\n    : Groups[number] extends infer GroupDef\n      ? GroupDef extends Group.Any\n        ? GroupDef[\"actions\"][number] | GroupActions<GroupDef[\"groups\"]>\n        : never\n      : never;\n\nexport type PluginActions<P extends Plugin.Any> = P[\"actions\"][number] | GroupActions<P[\"groups\"]>;\n\nexport interface RuntimeActionEntry<\n  out ActionId extends string = string,\n  out ProviderId extends string = string,\n  out ActionDef extends Action.Any = Action.Any,\n  out AllowedMethods extends readonly AuthMethod.Any[] = readonly AuthMethod.Any[],\n> {\n  readonly actionId: ActionId;\n  readonly providerId: ProviderId;\n  readonly localId: string;\n  readonly pluginVersion: string;\n  readonly action: ActionDef;\n  readonly authMethods: AllowedMethods;\n}\n\nconst entriesOf = (installation: PluginInstallation): readonly RuntimeActionEntry[] =>\n  walkCapabilities(installation.plugin, owner => owner.actions).map(\n    ({ localId, canonicalId, node }) => ({\n      action: node,\n      actionId: canonicalId,\n      authMethods: installation.plugin.authMethods,\n      localId,\n      pluginVersion: installation.version,\n      providerId: installation.plugin.identifier,\n    }),\n  );\n\nexport const collectActionEntries = (\n  installations: readonly PluginInstallation[],\n): readonly RuntimeActionEntry[] => installations.flatMap(entriesOf);\n\nconst actionIndex = new WeakMap<\n  readonly PluginInstallation[],\n  ReadonlyMap<string, RuntimeActionEntry>\n>();\n\n/** An action of the installed releases, or of the exact `version` when the caller pins one. */\nexport const resolveAction = (\n  installations: readonly PluginInstallation[],\n  actionId: string,\n  version?: string,\n): RuntimeActionEntry | undefined => {\n  let index = actionIndex.get(installations);\n  if (index === undefined) {\n    index = new Map(collectActionEntries(installations).map(entry => [entry.actionId, entry]));\n    actionIndex.set(installations, index);\n  }\n  const entry = index.get(actionId);\n  return entry === undefined || (version !== undefined && entry.pluginVersion !== version)\n    ? undefined\n    : entry;\n};\n"],"mappings":";;AA+EA,MAAM,aAAa,iBACjB,iBAAiB,aAAa,SAAQ,UAAS,MAAM,OAAO,CAAC,CAAC,KAC3D,EAAE,SAAS,aAAa,YAAY;CACnC,QAAQ;CACR,UAAU;CACV,aAAa,aAAa,OAAO;CACjC;CACA,eAAe,aAAa;CAC5B,YAAY,aAAa,OAAO;AAClC,EACF;AAEF,MAAa,wBACX,kBACkC,cAAc,QAAQ,SAAS;AAEnE,MAAM,8BAAc,IAAI,QAGtB;;AAGF,MAAa,iBACX,eACA,UACA,YACmC;CACnC,IAAI,QAAQ,YAAY,IAAI,aAAa;CACzC,IAAI,UAAU,KAAA,GAAW;EACvB,QAAQ,IAAI,IAAI,qBAAqB,aAAa,CAAC,CAAC,KAAI,UAAS,CAAC,MAAM,UAAU,KAAK,CAAC,CAAC;EACzF,YAAY,IAAI,eAAe,KAAK;CACtC;CACA,MAAM,QAAQ,MAAM,IAAI,QAAQ;CAChC,OAAO,UAAU,KAAA,KAAc,YAAY,KAAA,KAAa,MAAM,kBAAkB,UAC5E,KAAA,IACA;AACN"}

package/dist/internal/dual/invoke.d.ts

@@ -0,0 +1,63 @@
+import { Any } from "../../AuthMethod.js";
+import { Action, ActionHandlerFailure, Any as Any$1, Handler, InputSchema, OutputSchema } from "../../Action.js";
+import { ConnectionError, ConnectionResolutionContext, Service } from "../../ConnectionResolver.js";
+import { AuthResolutionRequirements, AuthSchemaRequirements } from "../auth-execution.js";
+import { ActionHandlerServiceOf } from "../plugin-handlers.js";
+import { Any as Any$2 } from "../../Plugin.js";
+import { PluginActionEntries } from "./actions.js";
+import { Effect, Schema } from "effect";
+//#region src/internal/dual/invoke.d.ts
+export interface InvokeRequest {
+  readonly actionId: string;
+  /** The exact plugin release the caller pinned; another installed release does not run. */
+  readonly actionVersion?: string;
+  readonly pluginKey?: string;
+  readonly input: unknown;
+  readonly connectionId?: string;
+  readonly context?: ConnectionResolutionContext;
+}
+export interface InvokeMeta<ActionId extends string = string> {
+  readonly actionId: ActionId;
+  readonly providerId: string;
+  readonly pluginVersion: string;
+}
+export interface InvokeSuccess<ActionId extends string = string, Data = unknown> {
+  readonly data: Data;
+  readonly meta: InvokeMeta<ActionId>;
+}
+declare const FieldIssue_base: Schema.Class<FieldIssue, Schema.Struct<{
+  readonly message: Schema.String;
+  readonly path: Schema.String;
+}>, {}>;
+export declare class FieldIssue extends FieldIssue_base {}
+declare const ActionNotFoundError_base: Schema.Class<ActionNotFoundError, Schema.TaggedStruct<"ActionNotFoundError", {
+  readonly actionId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ActionNotFoundError extends ActionNotFoundError_base {}
+declare const InvalidActionInputError_base: Schema.Class<InvalidActionInputError, Schema.TaggedStruct<"InvalidActionInputError", {
+  readonly actionId: Schema.String;
+  readonly description: Schema.String;
+  readonly fields: Schema.$Array<typeof FieldIssue>;
+}>, import("effect/Cause").YieldableError>;
+export declare class InvalidActionInputError extends InvalidActionInputError_base {}
+declare const ActionHandlerNotFoundError_base: Schema.Class<ActionHandlerNotFoundError, Schema.TaggedStruct<"ActionHandlerNotFoundError", {
+  readonly actionId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ActionHandlerNotFoundError extends ActionHandlerNotFoundError_base {}
+declare const InvalidActionOutputError_base: Schema.Class<InvalidActionOutputError, Schema.TaggedStruct<"InvalidActionOutputError", {
+  readonly actionId: Schema.String;
+  readonly description: Schema.String;
+  readonly fields: Schema.$Array<typeof FieldIssue>;
+}>, import("effect/Cause").YieldableError>;
+export declare class InvalidActionOutputError extends InvalidActionOutputError_base {}
+type InvokeResolvedActionError = InvalidActionInputError | InvalidActionOutputError | ActionHandlerNotFoundError | ActionHandlerFailure | ConnectionError;
+export type InvokeError = ActionNotFoundError | InvokeResolvedActionError;
+export type InvokeRequirementsFor<Plugins extends readonly Any$2[], ActionId extends string> = Plugins[number] extends (infer P) ? P extends Any$2 ? PluginRequirements<P, Extract<PluginActionEntries<P>, {
+  readonly actionId: ActionId;
+}>["action"]> : never : never;
+export type PluginRequirements<P extends Any$2, ActionDef extends Any$1> = [ActionDef] extends [never] ? never : ActionHandlerServiceOf<P> | InputSchema<ActionDef>["DecodingServices"] | OutputSchema<ActionDef>["EncodingServices"] | ([P["authMethods"][number]] extends [never] ? never : Service | AuthSchemaRequirements<P["authMethods"]> | AuthResolutionRequirements<P["authMethods"]>);
+export declare const invokeResolvedAction: <ActionId extends string, Input extends Schema.Top, Output extends Schema.Top, ActionAuthMethods extends readonly Any[]>(providerId: string, actionId: ActionId, pluginVersion: string, action: Action<string, Input, Output>, authMethods: ActionAuthMethods, request: InvokeRequest) => Effect.Effect<InvokeSuccess<ActionId, Output["Type"]>, InvokeResolvedActionError, Handler<ActionId> | Input["DecodingServices"] | Output["EncodingServices"] | ([ActionAuthMethods[number]] extends [never] ? never : Service | AuthResolutionRequirements<ActionAuthMethods> | AuthSchemaRequirements<ActionAuthMethods>)>;
+export declare const invokeResolvedActionJson: <ActionId extends string, Input extends Schema.Top, Output extends Schema.Top, ActionAuthMethods extends readonly Any[]>(providerId: string, actionId: ActionId, pluginVersion: string, action: Action<string, Input, Output>, authMethods: ActionAuthMethods, request: InvokeRequest) => Effect.Effect<InvokeSuccess<ActionId, Schema.Json>, InvokeResolvedActionError, Handler<ActionId> | Input["DecodingServices"] | Output["EncodingServices"] | ([ActionAuthMethods[number]] extends [never] ? never : Service | AuthResolutionRequirements<ActionAuthMethods> | AuthSchemaRequirements<ActionAuthMethods>)>;
+//#endregion
+export {};
+//# sourceMappingURL=invoke.d.ts.map

package/dist/internal/dual/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","names":["Action.ActionHandlerFailure","Plugin.Any","Action.Any","Action.InputSchema","Action.OutputSchema","ConnectionResolverService","AuthMethod.Any","Action.Action","Action.Handler"],"sources":["../../../src/internal/dual/invoke.ts"],"mappings":";;;;;;;;;iBAyBiB;WACN;;WAEA;WACA;WACA;WACA;WACA,UAAU;;iBAGJ,WAAW;WACjB,UAAU;WACV;WACA;;iBAGM,cAAc,kCAAkC;WACtD,MAAM;WACN,MAAM,WAAW;;;;;;qBAGf,mBAAmB;;;;qBAKnB,4BAA4B;;;;;;qBAK5B,gCAAgC;;;;qBAKhC,mCAAmC;;;;;;qBAKnC,iCAAiC;KAKzC,4BACD,0BACA,2BACA,6BACAA,uBACA;YAEQ,cAAc,sBAAsB;YAEpC,sBACV,yBAAyBC,SACzB,2BACE,+BAA8B,KAC9B,UAAUA,QACR,mBACE,GACA,QAAQ,oBAAoB;WAAe,UAAU;;YAKjD,mBAAmB,UAAUA,OAAY,kBAAkBC,UACrE,qCAIM,uBAAuB,KACvBC,YAAmB,iCACnBC,aAAoB,mCAClB,oDAGMC,UACA,uBAAuB,oBACvB,2BAA2B;qBAoJ9B,uBACX,yBACA,cAAc,OAAO,KACrB,eAAe,OAAO,KACtB,mCAAmCC,OAAgB,oBAEjC,UACR,UAAQ,uBACG,QACbC,eAAsB,OAAO,SAAO,aAC/B,mBAAiB,SACrB,kBAAa,OAAA,OAAA,cAAA,UAAA,iBAAA,2BAAAC,QAAA,YAAA,4BAAA,+BAAA,qDAAAH,UAAA,2BAAA,qBAAA,uBAAA;qBAYX,2BACX,yBACA,cAAc,OAAO,KACrB,eAAe,OAAO,KACtB,mCAAmCC,OAAgB,oBAEjC,UACR,UAAQ,uBACG,QACbC,eAAsB,OAAO,SAAO,aAC/B,mBAAiB,SACrB,kBAAa,OAAA,OAAA,cAAA,UAAA,OAAA,OAAA,2BAAAC,QAAA,YAAA,4BAAA,+BAAA,qDAAAH,UAAA,2BAAA,qBAAA,uBAAA"}

package/dist/internal/dual/invoke.js

@@ -0,0 +1,75 @@
+import { handlerKey } from "../../Action.js";
+import { findHandler, mergeUnder } from "../handler-context.js";
+import { decodeJsonMapError } from "../schema-runtime.js";
+import { authRuntimeContext, failConnectionIdNotAllowed, noAuthRuntimeContext, resolveRuntimeConnection, toNonEmptyArray } from "../auth-execution.js";
+import { Effect, Schema, SchemaIssue } from "effect";
+//#region src/internal/dual/invoke.ts
+var FieldIssue = class extends Schema.Class("FieldIssue")({
+	message: Schema.String,
+	path: Schema.String
+}) {};
+var ActionNotFoundError = class extends Schema.TaggedError()("ActionNotFoundError", { actionId: Schema.String }) {};
+var InvalidActionInputError = class extends Schema.TaggedError()("InvalidActionInputError", {
+	actionId: Schema.String,
+	description: Schema.String,
+	fields: Schema.Array(FieldIssue)
+}) {};
+var ActionHandlerNotFoundError = class extends Schema.TaggedError()("ActionHandlerNotFoundError", { actionId: Schema.String }) {};
+var InvalidActionOutputError = class extends Schema.TaggedError()("InvalidActionOutputError", {
+	actionId: Schema.String,
+	description: Schema.String,
+	fields: Schema.Array(FieldIssue)
+}) {};
+const schemaIssueFormatter = SchemaIssue.makeFormatterStandardSchemaV1();
+const formatFieldPath = (path) => {
+	let current = "$";
+	for (const segment of path) {
+		if (typeof segment === "number") {
+			current += `[${segment}]`;
+			continue;
+		}
+		const key = String(segment);
+		current += /^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(key) ? `.${key}` : `[${JSON.stringify(key)}]`;
+	}
+	return current;
+};
+const schemaErrorFields = (error) => schemaIssueFormatter(error.issue).issues.map((issue) => new FieldIssue({
+	message: issue.message,
+	path: formatFieldPath(issue.path ?? [])
+}));
+const decodeActionInput = (actionId, schema, input) => decodeJsonMapError(schema, input, (error) => new InvalidActionInputError({
+	actionId,
+	description: error.message,
+	fields: schemaErrorFields(error)
+}));
+const validateActionOutput = (actionId, schema, output) => Schema.encodeEffect(schema)(output).pipe(Effect.as(output), Effect.mapError((error) => new InvalidActionOutputError({
+	actionId,
+	description: error.message,
+	fields: schemaErrorFields(error)
+})));
+const getActionHandler = (providerId, actionId) => Effect.context().pipe(Effect.flatMap((context) => {
+	const handler = findHandler(context, providerId, handlerKey(actionId));
+	return handler === void 0 ? Effect.fail(new ActionHandlerNotFoundError({ actionId })) : Effect.succeed(handler);
+}));
+const invokeResolvedActionWithOutput = (providerId, actionId, pluginVersion, action, authMethods, request, finish) => {
+	const requiredAuthMethods = toNonEmptyArray(authMethods);
+	if (requiredAuthMethods === void 0 && request.connectionId !== void 0) return failConnectionIdNotAllowed("action", actionId, void 0, providerId, request.connectionId);
+	return getActionHandler(providerId, actionId).pipe(Effect.flatMap((handler) => decodeActionInput(actionId, action.input, request.input).pipe(Effect.flatMap((decodedInput) => requiredAuthMethods === void 0 || action.requireAuth === false && request.connectionId === void 0 ? Effect.suspend(() => handler.handler(decodedInput, noAuthRuntimeContext())) : resolveRuntimeConnection("action", actionId, void 0, providerId, requiredAuthMethods, request.connectionId, request.context).pipe(Effect.flatMap((binding) => Effect.suspend(() => handler.handler(decodedInput, authRuntimeContext(binding)))))), Effect.updateContext((input) => mergeUnder(handler.context, input)))), Effect.flatMap(finish), Effect.map((data) => ({
+		data,
+		meta: {
+			actionId,
+			pluginVersion,
+			providerId
+		}
+	})));
+};
+const invokeResolvedAction = (providerId, actionId, pluginVersion, action, authMethods, request) => invokeResolvedActionWithOutput(providerId, actionId, pluginVersion, action, authMethods, request, (data) => validateActionOutput(actionId, action.output, data));
+const invokeResolvedActionJson = (providerId, actionId, pluginVersion, action, authMethods, request) => invokeResolvedActionWithOutput(providerId, actionId, pluginVersion, action, authMethods, request, (data) => Schema.encodeUnknownEffect(Schema.toCodecJson(action.output))(data).pipe(Effect.mapError((error) => InvalidActionOutputError.make({
+	actionId,
+	description: error.message,
+	fields: schemaErrorFields(error)
+}))));
+//#endregion
+export { ActionHandlerNotFoundError, ActionNotFoundError, FieldIssue, InvalidActionInputError, InvalidActionOutputError, invokeResolvedAction, invokeResolvedActionJson };
+
+//# sourceMappingURL=invoke.js.map

package/dist/internal/dual/invoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.js","names":["Action.handlerKey"],"sources":["../../../src/internal/dual/invoke.ts"],"sourcesContent":["import { Effect, Schema, SchemaIssue } from \"effect\";\n\nimport * as Action from \"../../Action.ts\";\nimport type * as AuthMethod from \"../../AuthMethod.ts\";\nimport type {\n  ConnectionError,\n  ConnectionResolutionContext,\n  Service as ConnectionResolverService,\n} from \"../../ConnectionResolver.ts\";\nimport type * as Plugin from \"../../Plugin.ts\";\nimport {\n  authRuntimeContext,\n  failConnectionIdNotAllowed,\n  noAuthRuntimeContext,\n  resolveRuntimeConnection,\n  type AuthResolutionRequirements,\n  type AuthSchemaRequirements,\n  toNonEmptyArray,\n} from \"../auth-execution.ts\";\nimport { findHandler, mergeUnder } from \"../handler-context.ts\";\nimport type { ActionHandlerServiceOf } from \"../plugin-handlers.ts\";\nimport { decodeJsonMapError } from \"../schema-runtime.ts\";\n\nimport type { PluginActionEntries } from \"./actions.ts\";\n\nexport interface InvokeRequest {\n  readonly actionId: string;\n  /** The exact plugin release the caller pinned; another installed release does not run. */\n  readonly actionVersion?: string;\n  readonly pluginKey?: string;\n  readonly input: unknown;\n  readonly connectionId?: string;\n  readonly context?: ConnectionResolutionContext;\n}\n\nexport interface InvokeMeta<ActionId extends string = string> {\n  readonly actionId: ActionId;\n  readonly providerId: string;\n  readonly pluginVersion: string;\n}\n\nexport interface InvokeSuccess<ActionId extends string = string, Data = unknown> {\n  readonly data: Data;\n  readonly meta: InvokeMeta<ActionId>;\n}\n\nexport class FieldIssue extends Schema.Class<FieldIssue>(\"FieldIssue\")({\n  message: Schema.String,\n  path: Schema.String,\n}) {}\n\nexport class ActionNotFoundError extends Schema.TaggedError<ActionNotFoundError>()(\n  \"ActionNotFoundError\",\n  { actionId: Schema.String },\n) {}\n\nexport class InvalidActionInputError extends Schema.TaggedError<InvalidActionInputError>()(\n  \"InvalidActionInputError\",\n  { actionId: Schema.String, description: Schema.String, fields: Schema.Array(FieldIssue) },\n) {}\n\nexport class ActionHandlerNotFoundError extends Schema.TaggedError<ActionHandlerNotFoundError>()(\n  \"ActionHandlerNotFoundError\",\n  { actionId: Schema.String },\n) {}\n\nexport class InvalidActionOutputError extends Schema.TaggedError<InvalidActionOutputError>()(\n  \"InvalidActionOutputError\",\n  { actionId: Schema.String, description: Schema.String, fields: Schema.Array(FieldIssue) },\n) {}\n\ntype InvokeResolvedActionError =\n  | InvalidActionInputError\n  | InvalidActionOutputError\n  | ActionHandlerNotFoundError\n  | Action.ActionHandlerFailure\n  | ConnectionError;\n\nexport type InvokeError = ActionNotFoundError | InvokeResolvedActionError;\n\nexport type InvokeRequirementsFor<\n  Plugins extends readonly Plugin.Any[],\n  ActionId extends string,\n> = Plugins[number] extends infer P\n  ? P extends Plugin.Any\n    ? PluginRequirements<\n        P,\n        Extract<PluginActionEntries<P>, { readonly actionId: ActionId }>[\"action\"]\n      >\n    : never\n  : never;\n\nexport type PluginRequirements<P extends Plugin.Any, ActionDef extends Action.Any> = [\n  ActionDef,\n] extends [never]\n  ? never\n  :\n      | ActionHandlerServiceOf<P>\n      | Action.InputSchema<ActionDef>[\"DecodingServices\"]\n      | Action.OutputSchema<ActionDef>[\"EncodingServices\"]\n      | ([P[\"authMethods\"][number]] extends [never]\n          ? never\n          :\n              | ConnectionResolverService\n              | AuthSchemaRequirements<P[\"authMethods\"]>\n              | AuthResolutionRequirements<P[\"authMethods\"]>);\n\nconst schemaIssueFormatter = SchemaIssue.makeFormatterStandardSchemaV1();\n\nconst formatFieldPath = (path: readonly unknown[]): string => {\n  let current = \"$\";\n\n  for (const segment of path) {\n    if (typeof segment === \"number\") {\n      current += `[${segment}]`;\n      continue;\n    }\n\n    const key = String(segment);\n    current += /^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(key) ? `.${key}` : `[${JSON.stringify(key)}]`;\n  }\n\n  return current;\n};\n\nconst schemaErrorFields = (error: Schema.SchemaError): readonly FieldIssue[] =>\n  schemaIssueFormatter(error.issue).issues.map(\n    issue => new FieldIssue({ message: issue.message, path: formatFieldPath(issue.path ?? []) }),\n  );\n\nconst decodeActionInput = <Input extends Schema.Top>(\n  actionId: string,\n  schema: Input,\n  input: unknown,\n): Effect.Effect<Input[\"Type\"], InvalidActionInputError, Input[\"DecodingServices\"]> =>\n  decodeJsonMapError(\n    schema,\n    input,\n    error =>\n      new InvalidActionInputError({\n        actionId,\n        description: error.message,\n        fields: schemaErrorFields(error),\n      }),\n  );\n\nconst validateActionOutput = <Output extends Schema.Top>(\n  actionId: string,\n  schema: Output,\n  output: Output[\"Type\"],\n): Effect.Effect<Output[\"Type\"], InvalidActionOutputError, Output[\"EncodingServices\"]> =>\n  Schema.encodeEffect(schema)(output).pipe(\n    Effect.as(output),\n    Effect.mapError(\n      error =>\n        new InvalidActionOutputError({\n          actionId,\n          description: error.message,\n          fields: schemaErrorFields(error),\n        }),\n    ),\n  );\n\nconst getActionHandler = <ActionId extends string>(\n  providerId: string,\n  actionId: ActionId,\n): Effect.Effect<Action.Handler<ActionId>, ActionHandlerNotFoundError, Action.Handler<ActionId>> =>\n  Effect.context<Action.Handler<ActionId>>().pipe(\n    Effect.flatMap(context => {\n      const handler = findHandler(context, providerId, Action.handlerKey(actionId)) as\n        | Action.Handler<ActionId>\n        | undefined;\n\n      return handler === undefined\n        ? Effect.fail(new ActionHandlerNotFoundError({ actionId }))\n        : Effect.succeed(handler);\n    }),\n  );\n\nconst invokeResolvedActionWithOutput = <\n  ActionId extends string,\n  Input extends Schema.Top,\n  Output extends Schema.Top,\n  ActionAuthMethods extends readonly AuthMethod.Any[],\n  OutputValue,\n>(\n  providerId: string,\n  actionId: ActionId,\n  pluginVersion: string,\n  action: Action.Action<string, Input, Output>,\n  authMethods: ActionAuthMethods,\n  request: InvokeRequest,\n  finish: (\n    output: unknown,\n  ) => Effect.Effect<OutputValue, InvalidActionOutputError, Output[\"EncodingServices\"]>,\n): Effect.Effect<\n  InvokeSuccess<ActionId, OutputValue>,\n  InvokeResolvedActionError,\n  | Action.Handler<ActionId>\n  | Input[\"DecodingServices\"]\n  | Output[\"EncodingServices\"]\n  | ([ActionAuthMethods[number]] extends [never]\n      ? never\n      :\n          | ConnectionResolverService\n          | AuthSchemaRequirements<ActionAuthMethods>\n          | AuthResolutionRequirements<ActionAuthMethods>)\n> => {\n  const requiredAuthMethods = toNonEmptyArray(authMethods);\n\n  if (requiredAuthMethods === undefined && request.connectionId !== undefined) {\n    return failConnectionIdNotAllowed(\n      \"action\",\n      actionId,\n      undefined,\n      providerId,\n      request.connectionId,\n    );\n  }\n\n  return getActionHandler(providerId, actionId).pipe(\n    Effect.flatMap(handler =>\n      decodeActionInput(actionId, action.input, request.input).pipe(\n        Effect.flatMap(decodedInput =>\n          requiredAuthMethods === undefined ||\n          // Only an explicit false skips auth for definitions built outside the SDK.\n          (action.requireAuth === false && request.connectionId === undefined)\n            ? Effect.suspend(() => handler.handler(decodedInput, noAuthRuntimeContext()))\n            : resolveRuntimeConnection(\n                \"action\",\n                actionId,\n                undefined,\n                providerId,\n                requiredAuthMethods,\n                request.connectionId,\n                request.context,\n              ).pipe(\n                Effect.flatMap(binding =>\n                  Effect.suspend(() => handler.handler(decodedInput, authRuntimeContext(binding))),\n                ),\n              ),\n        ),\n        Effect.updateContext(input => mergeUnder(handler.context, input)),\n      ),\n    ),\n    Effect.flatMap(finish),\n    Effect.map((data): InvokeSuccess<ActionId, OutputValue> => ({\n      data,\n      meta: { actionId, pluginVersion, providerId },\n    })),\n  );\n};\n\nexport const invokeResolvedAction = <\n  ActionId extends string,\n  Input extends Schema.Top,\n  Output extends Schema.Top,\n  ActionAuthMethods extends readonly AuthMethod.Any[],\n>(\n  providerId: string,\n  actionId: ActionId,\n  pluginVersion: string,\n  action: Action.Action<string, Input, Output>,\n  authMethods: ActionAuthMethods,\n  request: InvokeRequest,\n) =>\n  invokeResolvedActionWithOutput(\n    providerId,\n    actionId,\n    pluginVersion,\n    action,\n    authMethods,\n    request,\n    data => validateActionOutput(actionId, action.output, data as Output[\"Type\"]),\n  );\n\nexport const invokeResolvedActionJson = <\n  ActionId extends string,\n  Input extends Schema.Top,\n  Output extends Schema.Top,\n  ActionAuthMethods extends readonly AuthMethod.Any[],\n>(\n  providerId: string,\n  actionId: ActionId,\n  pluginVersion: string,\n  action: Action.Action<string, Input, Output>,\n  authMethods: ActionAuthMethods,\n  request: InvokeRequest,\n) =>\n  invokeResolvedActionWithOutput(\n    providerId,\n    actionId,\n    pluginVersion,\n    action,\n    authMethods,\n    request,\n    data =>\n      Schema.encodeUnknownEffect(Schema.toCodecJson(action.output))(data).pipe(\n        Effect.mapError(error =>\n          InvalidActionOutputError.make({\n            actionId,\n            description: error.message,\n            fields: schemaErrorFields(error),\n          }),\n        ),\n      ),\n  );\n"],"mappings":"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"}

package/dist/internal/dual/registry.d.ts

@@ -0,0 +1,125 @@
+import { AuthMethodKind } from "../../AuthMethod.js";
+import { Exposure, Features, Protocol, RequiredChecks } from "../../AgentChannel.js";
+import { Category } from "../../Plugin.js";
+import { Any } from "../../AiProvider.js";
+import { PluginInstallation } from "../../DualRuntime.js";
+import { Schema } from "effect";
+//#region src/internal/dual/registry.d.ts
+export interface MaterializedRegistryOptions {
+  readonly schemaJson?: ((schema: Schema.Top) => unknown) | undefined;
+  readonly projections?: Map<Schema.Top, unknown> | undefined;
+  /** Selects the capability versions whose schemas are projected; the others carry `undefined` schemas. */
+  readonly projectSchemas?: ((capabilityId: string, version: string) => boolean) | undefined;
+}
+/** @since 0.0.0 @category registry */
+export interface MaterializedAuthMethod {
+  readonly id: string;
+  readonly providerId: string;
+  readonly key: string;
+  readonly name: string | undefined;
+  readonly description: string | undefined;
+  readonly kind: AuthMethodKind;
+  readonly setupSchemaJson: unknown | null;
+  readonly inputSchemaJson: unknown | null;
+  readonly materialSchemaJson: unknown;
+  readonly metadataJson: unknown;
+}
+/** @since 0.0.0 @category registry */
+export interface MaterializedProvider {
+  readonly kind: "tools" | "ai";
+  readonly id: string;
+  readonly key: string;
+  readonly name: string | undefined;
+  readonly description: string | undefined;
+  readonly iconUrl: string | undefined;
+  readonly iconUrlDark: string | undefined;
+  readonly categories: readonly Category[];
+  readonly homepageUrl: string | undefined;
+  readonly docsUrl: string | undefined;
+  /** Whether a shell in a run sandbox may use the provider's Connections through Dual's gateway. */
+  readonly sandboxAccess: boolean;
+  readonly sourcePluginKey: string | undefined;
+  readonly sourcePluginVersion: string | undefined;
+  readonly authMethods: readonly MaterializedAuthMethod[];
+  readonly capabilityVersions: readonly MaterializedCapabilityVersion[];
+}
+/** @since 0.0.0 @category registry */
+export interface MaterializedActionCapabilityVersion {
+  readonly kind: "action";
+  readonly requireAuth: boolean;
+  readonly capabilityId: string;
+  readonly key: string;
+  readonly name: string | undefined;
+  readonly description: string | undefined;
+  readonly version: string;
+  readonly sourcePluginKey: string | undefined;
+  readonly sourcePluginVersion: string | undefined;
+  readonly authMethodIds: readonly string[];
+  readonly inputSchemaJson: unknown;
+  readonly outputSchemaJson: unknown;
+  readonly examplesJson: unknown;
+}
+/** @since 0.0.0 @category registry */
+export interface MaterializedTriggerCapabilityVersion {
+  readonly kind: "trigger";
+  readonly requireAuth: boolean;
+  readonly capabilityId: string;
+  readonly key: string;
+  readonly name: string | undefined;
+  readonly description: string | undefined;
+  readonly version: string;
+  readonly sourcePluginKey: string | undefined;
+  readonly sourcePluginVersion: string | undefined;
+  readonly authMethodIds: readonly string[];
+  readonly triggerKind: "webhook" | "polling";
+  readonly configSchemaJson: unknown;
+  readonly outputSchemaJson: unknown;
+  readonly stateSchemaJson: unknown | undefined;
+}
+/** @since 0.0.0 @category registry */
+export interface MaterializedChannelCapabilityVersion {
+  readonly kind: "agent_channel";
+  readonly requireAuth: boolean;
+  readonly capabilityId: string;
+  readonly key: string;
+  readonly name: string | undefined;
+  readonly description: string | undefined;
+  readonly version: string;
+  readonly sourcePluginKey: string | undefined;
+  readonly sourcePluginVersion: string | undefined;
+  readonly authMethodIds: readonly string[];
+  readonly definitionSettingsSchemaJson: unknown;
+  readonly deploymentSettingsSchemaJson: unknown;
+  readonly stateSchemaJson: unknown;
+  readonly operationInputSchemaJson: unknown;
+  readonly operationOutputSchemaJson: unknown;
+  readonly extensionsSchemaJson: Readonly<Record<string, unknown>>;
+  readonly featuresJson: Features;
+  readonly exposure: typeof Exposure.Type;
+  /** Absent for the original protocol. */
+  readonly protocol?: Protocol;
+  readonly requiredChecks: typeof RequiredChecks.Type;
+}
+export type MaterializedCapabilityVersion = MaterializedChannelCapabilityVersion | MaterializedActionCapabilityVersion | MaterializedTriggerCapabilityVersion;
+/** @since 0.0.0 @category registry */
+export interface MaterializedRegistry {
+  readonly dualIdentifier: string;
+  readonly providers: readonly MaterializedProvider[];
+}
+/**
+ * Materialize the provider/capability registry of the installed plugin releases. This is the
+ * canonical SDK-owned resolver used by server persistence/bootstrap code.
+ *
+ * @since 0.0.0
+ * @category registry
+ */
+export declare const materializeResolvedRegistry: (input: {
+  readonly dualIdentifier: string;
+  readonly plugins: readonly PluginInstallation[];
+  readonly aiProviders: readonly Any[];
+  readonly schemaJson?: ((schema: Schema.Top) => unknown) | undefined;
+  readonly projections?: Map<Schema.Top, unknown> | undefined;
+  readonly projectSchemas?: ((capabilityId: string, version: string) => boolean) | undefined;
+}) => MaterializedRegistry;
+//#endregion
+//# sourceMappingURL=registry.d.ts.map

package/dist/internal/dual/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":["AuthMethod.AuthMethodKind","Plugin.Category","AgentChannel.Features","AgentChannel.Protocol","AiProvider.Any"],"sources":["../../../src/internal/dual/registry.ts"],"mappings":";;;;;;;iBAYiB;WACN,eAAe,QAAQ,OAAO;WAC9B,cAAc,IAAI,OAAO;;WAEzB,mBAAmB,sBAAsB;;;iBAInC;WACN;WACA;WACA;WACA;WACA;WACA,MAAMA;WACN;WACA;WACA;WACA;;;iBAIM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA,qBAAqBC;WACrB;WACA;;WAEA;WACA;WACA;WACA,sBAAsB;WACtB,6BAA6B;;;iBAIvB;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;;iBAIM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;;iBAIM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA,sBAAsB,SAAS;WAC/B,cAAcC;WACd,iBAAuC,SAAA;;WAEvC,WAAWC;WACX,uBAAmD,eAAA;;YAElD,gCACR,uCACA,sCACA;;iBAGa;WACN;WACA,oBAAoB;;;;;;;;;qBAsDlB,8BAA2B;WAC7B;WACA,kBAAkB;WAClB,sBAAsBC;WACtB,eAAe,QAAQ,OAAO;WAC9B,cAAc,IAAI,OAAO;WACzB,mBAAmB,sBAAsB;MAChD"}

package/dist/internal/dual/registry.js

@@ -0,0 +1,172 @@
+import { projectContract, validateDefinition } from "../../AgentChannel.js";
+import { registryId } from "../../AiProvider.js";
+import { collectActionEntries } from "./actions.js";
+import { collectTriggerEntries } from "./triggers.js";
+import { Schema } from "effect";
+//#region src/internal/dual/registry.ts
+/** Materialized Dual registry DTOs and resolver. */
+const authMethodId = (providerId, methodId) => `${providerId}/${methodId}`;
+const schemaJson = (schema) => Schema.toJsonSchemaDocument(schema, { onExcessProperty: "error" });
+const authMethodMetadataJson = (method) => {
+	if (method.oauth2 === void 0) return {};
+	const staticClient = typeof method.oauth2.client === "function" ? void 0 : method.oauth2.client;
+	const staticEndpoint = (endpoint) => typeof endpoint === "function" ? void 0 : endpoint;
+	const discoveryUrl = staticEndpoint(method.oauth2.discoveryUrl);
+	const authorizationUrl = staticEndpoint(method.oauth2.authorizationUrl);
+	const tokenUrl = staticEndpoint(method.oauth2.tokenUrl);
+	return { oauth2: {
+		scopes: method.oauth2.scopes,
+		...staticClient === void 0 ? {} : { clientAuthentication: staticClient.authentication ?? "basic" },
+		...discoveryUrl === void 0 ? {} : { discoveryUrl },
+		...authorizationUrl === void 0 ? {} : { authorizationUrl },
+		...tokenUrl === void 0 ? {} : { tokenUrl },
+		...method.oauth2.pkce === void 0 ? {} : { pkce: method.oauth2.pkce },
+		...method.oauth2.authorizationParams === void 0 ? {} : { authorizationParams: method.oauth2.authorizationParams },
+		...method.oauth2.tokenParams === void 0 ? {} : { tokenParams: method.oauth2.tokenParams }
+	} };
+};
+/**
+* Materialize the provider/capability registry of the installed plugin releases. This is the
+* canonical SDK-owned resolver used by server persistence/bootstrap code.
+*
+* @since 0.0.0
+* @category registry
+*/
+const materializeResolvedRegistry = (input) => {
+	const projectedSchemas = input.projections ?? /* @__PURE__ */ new Map();
+	const projectSchemaUncached = input.schemaJson ?? schemaJson;
+	const projectSchema = (schema) => {
+		if (projectedSchemas.has(schema)) return projectedSchemas.get(schema);
+		const projected = projectSchemaUncached(schema);
+		projectedSchemas.set(schema, projected);
+		return projected;
+	};
+	const projectSchemasFor = input.projectSchemas ?? (() => true);
+	const capabilityVersionsByProvider = /* @__PURE__ */ new Map();
+	const addCapabilityVersion = (providerId, capabilityVersion) => {
+		const versions = capabilityVersionsByProvider.get(providerId) ?? [];
+		versions.push(capabilityVersion);
+		capabilityVersionsByProvider.set(providerId, versions);
+	};
+	for (const entry of collectActionEntries(input.plugins)) {
+		const projected = projectSchemasFor(entry.actionId, entry.pluginVersion);
+		addCapabilityVersion(entry.providerId, {
+			authMethodIds: entry.authMethods.map((method) => authMethodId(entry.providerId, method.identifier)),
+			capabilityId: entry.actionId,
+			description: entry.action.description,
+			examplesJson: entry.action.examples,
+			inputSchemaJson: projected ? projectSchema(entry.action.input) : void 0,
+			key: entry.localId,
+			kind: "action",
+			requireAuth: entry.action.requireAuth !== false,
+			name: entry.action.name,
+			outputSchemaJson: projected ? projectSchema(entry.action.output) : void 0,
+			sourcePluginKey: entry.providerId,
+			sourcePluginVersion: entry.pluginVersion,
+			version: entry.pluginVersion
+		});
+	}
+	for (const entry of collectTriggerEntries(input.plugins)) {
+		const projected = projectSchemasFor(entry.triggerId, entry.pluginVersion);
+		addCapabilityVersion(entry.providerId, {
+			authMethodIds: entry.authMethods.map((method) => authMethodId(entry.providerId, method.identifier)),
+			capabilityId: entry.triggerId,
+			configSchemaJson: projected ? projectSchema(entry.trigger.config) : void 0,
+			description: entry.trigger.description,
+			key: entry.localId,
+			kind: "trigger",
+			requireAuth: entry.trigger.requireAuth !== false,
+			name: entry.trigger.name,
+			outputSchemaJson: projected ? projectSchema(entry.trigger.output) : void 0,
+			sourcePluginKey: entry.providerId,
+			sourcePluginVersion: entry.pluginVersion,
+			stateSchemaJson: projected && entry.trigger.state !== void 0 ? projectSchema(entry.trigger.state) : void 0,
+			triggerKind: entry.trigger.kind,
+			version: entry.pluginVersion
+		});
+	}
+	for (const { plugin, version } of input.plugins) for (const channel of plugin.agentChannels) {
+		const definition = channel.definition;
+		validateDefinition(definition, plugin.identifier, plugin.authMethods);
+		addCapabilityVersion(plugin.identifier, {
+			authMethodIds: definition.authMethods.map((method) => authMethodId(plugin.identifier, method.identifier)),
+			capabilityId: `${plugin.identifier}/${channel.identifier}`,
+			description: channel.description,
+			key: channel.identifier,
+			kind: "agent_channel",
+			requireAuth: true,
+			name: channel.name,
+			sourcePluginKey: plugin.identifier,
+			sourcePluginVersion: version,
+			version,
+			...projectContract(definition, projectSchema)
+		});
+	}
+	const toolProviders = input.plugins.map(({ plugin, version }) => ({
+		authMethods: plugin.authMethods.map((method) => ({
+			description: method.description,
+			id: authMethodId(plugin.identifier, method.identifier),
+			inputSchemaJson: method.input === void 0 ? null : projectSchema(method.input),
+			key: method.identifier,
+			kind: method.kind,
+			materialSchemaJson: projectSchema(method.material),
+			metadataJson: authMethodMetadataJson(method),
+			name: method.name,
+			providerId: plugin.identifier,
+			setupSchemaJson: method.setup === void 0 ? null : projectSchema(method.setup)
+		})),
+		capabilityVersions: capabilityVersionsByProvider.get(plugin.identifier) ?? [],
+		categories: plugin.categories,
+		description: plugin.description,
+		docsUrl: plugin.docsUrl,
+		homepageUrl: plugin.homepageUrl,
+		iconUrl: plugin.iconUrl,
+		iconUrlDark: plugin.iconUrlDark,
+		id: plugin.identifier,
+		key: plugin.identifier,
+		kind: "tools",
+		name: plugin.name,
+		sandboxAccess: plugin.sandboxAccess !== void 0,
+		sourcePluginKey: plugin.identifier,
+		sourcePluginVersion: version
+	}));
+	const aiProviders = input.aiProviders.flatMap((provider) => {
+		const id = registryId(provider.identifier);
+		return [{
+			authMethods: provider.authMethods.map((method) => ({
+				description: method.description,
+				id: authMethodId(id, method.identifier),
+				inputSchemaJson: method.input === void 0 ? null : projectSchema(method.input),
+				key: method.identifier,
+				kind: method.kind,
+				materialSchemaJson: projectSchema(method.material),
+				metadataJson: authMethodMetadataJson(method),
+				name: method.name,
+				providerId: id,
+				setupSchemaJson: method.setup === void 0 ? null : projectSchema(method.setup)
+			})),
+			capabilityVersions: [],
+			categories: provider.categories,
+			description: provider.description,
+			docsUrl: provider.docsUrl,
+			homepageUrl: provider.homepageUrl,
+			iconUrl: provider.iconUrl,
+			iconUrlDark: provider.iconUrlDark,
+			id,
+			key: provider.identifier,
+			kind: "ai",
+			name: provider.name,
+			sandboxAccess: false,
+			sourcePluginKey: void 0,
+			sourcePluginVersion: void 0
+		}];
+	});
+	return {
+		dualIdentifier: input.dualIdentifier,
+		providers: [...toolProviders, ...aiProviders]
+	};
+};
+//#endregion
+export { materializeResolvedRegistry };
+
+//# sourceMappingURL=registry.js.map

package/dist/internal/dual/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":["AgentChannel.projectContract","AiProvider.registryId"],"sources":["../../../src/internal/dual/registry.ts"],"sourcesContent":["/** Materialized Dual registry DTOs and resolver. */\nimport { Schema } from \"effect\";\n\nimport * as AgentChannel from \"../../AgentChannel.ts\";\nimport * as AiProvider from \"../../AiProvider.ts\";\nimport type * as AuthMethod from \"../../AuthMethod.ts\";\nimport type { PluginInstallation } from \"../../DualRuntime.ts\";\nimport type * as Plugin from \"../../Plugin.ts\";\n\nimport { collectActionEntries } from \"./actions.ts\";\nimport { collectTriggerEntries } from \"./triggers.ts\";\n\nexport interface MaterializedRegistryOptions {\n  readonly schemaJson?: ((schema: Schema.Top) => unknown) | undefined;\n  readonly projections?: Map<Schema.Top, unknown> | undefined;\n  /** Selects the capability versions whose schemas are projected; the others carry `undefined` schemas. */\n  readonly projectSchemas?: ((capabilityId: string, version: string) => boolean) | undefined;\n}\n\n/** @since 0.0.0 @category registry */\nexport interface MaterializedAuthMethod {\n  readonly id: string;\n  readonly providerId: string;\n  readonly key: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly kind: AuthMethod.AuthMethodKind;\n  readonly setupSchemaJson: unknown | null;\n  readonly inputSchemaJson: unknown | null;\n  readonly materialSchemaJson: unknown;\n  readonly metadataJson: unknown;\n}\n\n/** @since 0.0.0 @category registry */\nexport interface MaterializedProvider {\n  readonly kind: \"tools\" | \"ai\";\n  readonly id: string;\n  readonly key: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly iconUrl: string | undefined;\n  readonly iconUrlDark: string | undefined;\n  readonly categories: readonly Plugin.Category[];\n  readonly homepageUrl: string | undefined;\n  readonly docsUrl: string | undefined;\n  /** Whether a shell in a run sandbox may use the provider's Connections through Dual's gateway. */\n  readonly sandboxAccess: boolean;\n  readonly sourcePluginKey: string | undefined;\n  readonly sourcePluginVersion: string | undefined;\n  readonly authMethods: readonly MaterializedAuthMethod[];\n  readonly capabilityVersions: readonly MaterializedCapabilityVersion[];\n}\n\n/** @since 0.0.0 @category registry */\nexport interface MaterializedActionCapabilityVersion {\n  readonly kind: \"action\";\n  readonly requireAuth: boolean;\n  readonly capabilityId: string;\n  readonly key: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly version: string;\n  readonly sourcePluginKey: string | undefined;\n  readonly sourcePluginVersion: string | undefined;\n  readonly authMethodIds: readonly string[];\n  readonly inputSchemaJson: unknown;\n  readonly outputSchemaJson: unknown;\n  readonly examplesJson: unknown;\n}\n\n/** @since 0.0.0 @category registry */\nexport interface MaterializedTriggerCapabilityVersion {\n  readonly kind: \"trigger\";\n  readonly requireAuth: boolean;\n  readonly capabilityId: string;\n  readonly key: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly version: string;\n  readonly sourcePluginKey: string | undefined;\n  readonly sourcePluginVersion: string | undefined;\n  readonly authMethodIds: readonly string[];\n  readonly triggerKind: \"webhook\" | \"polling\";\n  readonly configSchemaJson: unknown;\n  readonly outputSchemaJson: unknown;\n  readonly stateSchemaJson: unknown | undefined;\n}\n\n/** @since 0.0.0 @category registry */\nexport interface MaterializedChannelCapabilityVersion {\n  readonly kind: \"agent_channel\";\n  readonly requireAuth: boolean;\n  readonly capabilityId: string;\n  readonly key: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly version: string;\n  readonly sourcePluginKey: string | undefined;\n  readonly sourcePluginVersion: string | undefined;\n  readonly authMethodIds: readonly string[];\n  readonly definitionSettingsSchemaJson: unknown;\n  readonly deploymentSettingsSchemaJson: unknown;\n  readonly stateSchemaJson: unknown;\n  readonly operationInputSchemaJson: unknown;\n  readonly operationOutputSchemaJson: unknown;\n  readonly extensionsSchemaJson: Readonly<Record<string, unknown>>;\n  readonly featuresJson: AgentChannel.Features;\n  readonly exposure: typeof AgentChannel.Exposure.Type;\n  /** Absent for the original protocol. */\n  readonly protocol?: AgentChannel.Protocol;\n  readonly requiredChecks: typeof AgentChannel.RequiredChecks.Type;\n}\nexport type MaterializedCapabilityVersion =\n  | MaterializedChannelCapabilityVersion\n  | MaterializedActionCapabilityVersion\n  | MaterializedTriggerCapabilityVersion;\n\n/** @since 0.0.0 @category registry */\nexport interface MaterializedRegistry {\n  readonly dualIdentifier: string;\n  readonly providers: readonly MaterializedProvider[];\n}\n\nconst authMethodId = (providerId: string, methodId: string): string => `${providerId}/${methodId}`;\n\n// FIXME(live-schema-validation): this JSON Schema is a lossy catalog/snapshot projection.\n// Hard validation must use the live SDK Schema declarations for the pinned version.\nconst schemaJson = (schema: Schema.Top): unknown =>\n  Schema.toJsonSchemaDocument(schema, { onExcessProperty: \"error\" });\n\nconst authMethodMetadataJson = (method: AuthMethod.Any): unknown => {\n  if (method.oauth2 === undefined) {\n    return {};\n  }\n\n  const staticClient =\n    typeof method.oauth2.client === \"function\" ? undefined : method.oauth2.client;\n\n  // An endpoint derived from the setup has no value until a connection supplies\n  // one, so the registry — which describes the method, not a connection — omits\n  // it, exactly as it already omits a client built by a hook.\n  const staticEndpoint = (endpoint: string | ((...args: never) => string) | undefined) =>\n    typeof endpoint === \"function\" ? undefined : endpoint;\n  const discoveryUrl = staticEndpoint(method.oauth2.discoveryUrl);\n  const authorizationUrl = staticEndpoint(method.oauth2.authorizationUrl);\n  const tokenUrl = staticEndpoint(method.oauth2.tokenUrl);\n\n  return {\n    oauth2: {\n      scopes: method.oauth2.scopes,\n      ...(staticClient === undefined\n        ? {}\n        : { clientAuthentication: staticClient.authentication ?? \"basic\" }),\n      ...(discoveryUrl === undefined ? {} : { discoveryUrl }),\n      ...(authorizationUrl === undefined ? {} : { authorizationUrl }),\n      ...(tokenUrl === undefined ? {} : { tokenUrl }),\n      ...(method.oauth2.pkce === undefined ? {} : { pkce: method.oauth2.pkce }),\n      ...(method.oauth2.authorizationParams === undefined\n        ? {}\n        : { authorizationParams: method.oauth2.authorizationParams }),\n      ...(method.oauth2.tokenParams === undefined\n        ? {}\n        : { tokenParams: method.oauth2.tokenParams }),\n    },\n  };\n};\n\n/**\n * Materialize the provider/capability registry of the installed plugin releases. This is the\n * canonical SDK-owned resolver used by server persistence/bootstrap code.\n *\n * @since 0.0.0\n * @category registry\n */\nexport const materializeResolvedRegistry = (input: {\n  readonly dualIdentifier: string;\n  readonly plugins: readonly PluginInstallation[];\n  readonly aiProviders: readonly AiProvider.Any[];\n  readonly schemaJson?: ((schema: Schema.Top) => unknown) | undefined;\n  readonly projections?: Map<Schema.Top, unknown> | undefined;\n  readonly projectSchemas?: ((capabilityId: string, version: string) => boolean) | undefined;\n}): MaterializedRegistry => {\n  // Plugins reuse schema values across capabilities, auth methods and app\n  // versions, so project each one once per materialization. The memo is dropped\n  // with the caller's materialization rather than retaining every projection for\n  // the lifetime of the app definition.\n  const projectedSchemas = input.projections ?? new Map<Schema.Top, unknown>();\n  const projectSchemaUncached = input.schemaJson ?? schemaJson;\n  const projectSchema = (schema: Schema.Top): unknown => {\n    if (projectedSchemas.has(schema)) return projectedSchemas.get(schema);\n    const projected = projectSchemaUncached(schema);\n    projectedSchemas.set(schema, projected);\n    return projected;\n  };\n  const projectSchemasFor = input.projectSchemas ?? (() => true);\n  const capabilityVersionsByProvider = new Map<string, MaterializedCapabilityVersion[]>();\n  const addCapabilityVersion = (\n    providerId: string,\n    capabilityVersion: MaterializedCapabilityVersion,\n  ) => {\n    const versions = capabilityVersionsByProvider.get(providerId) ?? [];\n    versions.push(capabilityVersion);\n    capabilityVersionsByProvider.set(providerId, versions);\n  };\n\n  for (const entry of collectActionEntries(input.plugins)) {\n    const projected = projectSchemasFor(entry.actionId, entry.pluginVersion);\n    addCapabilityVersion(entry.providerId, {\n      authMethodIds: entry.authMethods.map(method =>\n        authMethodId(entry.providerId, method.identifier),\n      ),\n      capabilityId: entry.actionId,\n      description: entry.action.description,\n      examplesJson: entry.action.examples,\n      inputSchemaJson: projected ? projectSchema(entry.action.input) : undefined,\n      key: entry.localId,\n      kind: \"action\" as const,\n      requireAuth: entry.action.requireAuth !== false,\n      name: entry.action.name,\n      outputSchemaJson: projected ? projectSchema(entry.action.output) : undefined,\n      sourcePluginKey: entry.providerId,\n      sourcePluginVersion: entry.pluginVersion,\n      version: entry.pluginVersion,\n    });\n  }\n\n  for (const entry of collectTriggerEntries(input.plugins)) {\n    const projected = projectSchemasFor(entry.triggerId, entry.pluginVersion);\n    addCapabilityVersion(entry.providerId, {\n      authMethodIds: entry.authMethods.map(method =>\n        authMethodId(entry.providerId, method.identifier),\n      ),\n      capabilityId: entry.triggerId,\n      configSchemaJson: projected ? projectSchema(entry.trigger.config) : undefined,\n      description: entry.trigger.description,\n      key: entry.localId,\n      kind: \"trigger\" as const,\n      requireAuth: entry.trigger.requireAuth !== false,\n      name: entry.trigger.name,\n      outputSchemaJson: projected ? projectSchema(entry.trigger.output) : undefined,\n      sourcePluginKey: entry.providerId,\n      sourcePluginVersion: entry.pluginVersion,\n      stateSchemaJson:\n        projected && entry.trigger.state !== undefined\n          ? projectSchema(entry.trigger.state)\n          : undefined,\n      triggerKind: entry.trigger.kind,\n      version: entry.pluginVersion,\n    });\n  }\n\n  for (const { plugin, version } of input.plugins) {\n    for (const channel of plugin.agentChannels) {\n      const definition = channel.definition;\n      AgentChannel.validateDefinition(definition, plugin.identifier, plugin.authMethods);\n      addCapabilityVersion(plugin.identifier, {\n        authMethodIds: definition.authMethods.map(method =>\n          authMethodId(plugin.identifier, method.identifier),\n        ),\n        capabilityId: `${plugin.identifier}/${channel.identifier}`,\n        description: channel.description,\n        key: channel.identifier,\n        kind: \"agent_channel\",\n        requireAuth: true,\n        name: channel.name,\n        sourcePluginKey: plugin.identifier,\n        sourcePluginVersion: version,\n        version,\n        ...AgentChannel.projectContract(definition, projectSchema),\n      });\n    }\n  }\n  const toolProviders: readonly MaterializedProvider[] = input.plugins.map(\n    ({ plugin, version }) => ({\n      authMethods: plugin.authMethods.map(method => ({\n        description: method.description,\n        id: authMethodId(plugin.identifier, method.identifier),\n        inputSchemaJson: method.input === undefined ? null : projectSchema(method.input),\n        key: method.identifier,\n        kind: method.kind,\n        materialSchemaJson: projectSchema(method.material),\n        metadataJson: authMethodMetadataJson(method),\n        name: method.name,\n        providerId: plugin.identifier,\n        setupSchemaJson: method.setup === undefined ? null : projectSchema(method.setup),\n      })),\n      capabilityVersions: capabilityVersionsByProvider.get(plugin.identifier) ?? [],\n      categories: plugin.categories,\n      description: plugin.description,\n      docsUrl: plugin.docsUrl,\n      homepageUrl: plugin.homepageUrl,\n      iconUrl: plugin.iconUrl,\n      iconUrlDark: plugin.iconUrlDark,\n      id: plugin.identifier,\n      key: plugin.identifier,\n      kind: \"tools\" as const,\n      name: plugin.name,\n      sandboxAccess: plugin.sandboxAccess !== undefined,\n      sourcePluginKey: plugin.identifier,\n      sourcePluginVersion: version,\n    }),\n  );\n\n  const aiProviders: readonly MaterializedProvider[] = input.aiProviders.flatMap(provider => {\n    const id = AiProvider.registryId(provider.identifier);\n\n    return [\n      {\n        authMethods: provider.authMethods.map(method => ({\n          description: method.description,\n          id: authMethodId(id, method.identifier),\n          inputSchemaJson: method.input === undefined ? null : projectSchema(method.input),\n          key: method.identifier,\n          kind: method.kind,\n          materialSchemaJson: projectSchema(method.material),\n          metadataJson: authMethodMetadataJson(method),\n          name: method.name,\n          providerId: id,\n          setupSchemaJson: method.setup === undefined ? null : projectSchema(method.setup),\n        })),\n        capabilityVersions: [],\n        categories: provider.categories,\n        description: provider.description,\n        docsUrl: provider.docsUrl,\n        homepageUrl: provider.homepageUrl,\n        iconUrl: provider.iconUrl,\n        iconUrlDark: provider.iconUrlDark,\n        id,\n        key: provider.identifier,\n        kind: \"ai\" as const,\n        name: provider.name,\n        sandboxAccess: false,\n        sourcePluginKey: undefined,\n        sourcePluginVersion: undefined,\n      },\n    ];\n  });\n\n  return { dualIdentifier: input.dualIdentifier, providers: [...toolProviders, ...aiProviders] };\n};\n"],"mappings":";;;;;;;AA2HA,MAAM,gBAAgB,YAAoB,aAA6B,GAAG,WAAW,GAAG;AAIxF,MAAM,cAAc,WAClB,OAAO,qBAAqB,QAAQ,EAAE,kBAAkB,QAAQ,CAAC;AAEnE,MAAM,0BAA0B,WAAoC;CAClE,IAAI,OAAO,WAAW,KAAA,GACpB,OAAO,CAAC;CAGV,MAAM,eACJ,OAAO,OAAO,OAAO,WAAW,aAAa,KAAA,IAAY,OAAO,OAAO;CAKzE,MAAM,kBAAkB,aACtB,OAAO,aAAa,aAAa,KAAA,IAAY;CAC/C,MAAM,eAAe,eAAe,OAAO,OAAO,YAAY;CAC9D,MAAM,mBAAmB,eAAe,OAAO,OAAO,gBAAgB;CACtE,MAAM,WAAW,eAAe,OAAO,OAAO,QAAQ;CAEtD,OAAO,EACL,QAAQ;EACN,QAAQ,OAAO,OAAO;EACtB,GAAI,iBAAiB,KAAA,IACjB,CAAC,IACD,EAAE,sBAAsB,aAAa,kBAAkB,QAAQ;EACnE,GAAI,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa;EACrD,GAAI,qBAAqB,KAAA,IAAY,CAAC,IAAI,EAAE,iBAAiB;EAC7D,GAAI,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS;EAC7C,GAAI,OAAO,OAAO,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,OAAO,OAAO,KAAK;EACvE,GAAI,OAAO,OAAO,wBAAwB,KAAA,IACtC,CAAC,IACD,EAAE,qBAAqB,OAAO,OAAO,oBAAoB;EAC7D,GAAI,OAAO,OAAO,gBAAgB,KAAA,IAC9B,CAAC,IACD,EAAE,aAAa,OAAO,OAAO,YAAY;CAC/C,EACF;AACF;;;;;;;;AASA,MAAa,+BAA+B,UAOhB;CAK1B,MAAM,mBAAmB,MAAM,+BAAe,IAAI,IAAyB;CAC3E,MAAM,wBAAwB,MAAM,cAAc;CAClD,MAAM,iBAAiB,WAAgC;EACrD,IAAI,iBAAiB,IAAI,MAAM,GAAG,OAAO,iBAAiB,IAAI,MAAM;EACpE,MAAM,YAAY,sBAAsB,MAAM;EAC9C,iBAAiB,IAAI,QAAQ,SAAS;EACtC,OAAO;CACT;CACA,MAAM,oBAAoB,MAAM,yBAAyB;CACzD,MAAM,+CAA+B,IAAI,IAA6C;CACtF,MAAM,wBACJ,YACA,sBACG;EACH,MAAM,WAAW,6BAA6B,IAAI,UAAU,KAAK,CAAC;EAClE,SAAS,KAAK,iBAAiB;EAC/B,6BAA6B,IAAI,YAAY,QAAQ;CACvD;CAEA,KAAK,MAAM,SAAS,qBAAqB,MAAM,OAAO,GAAG;EACvD,MAAM,YAAY,kBAAkB,MAAM,UAAU,MAAM,aAAa;EACvE,qBAAqB,MAAM,YAAY;GACrC,eAAe,MAAM,YAAY,KAAI,WACnC,aAAa,MAAM,YAAY,OAAO,UAAU,CAClD;GACA,cAAc,MAAM;GACpB,aAAa,MAAM,OAAO;GAC1B,cAAc,MAAM,OAAO;GAC3B,iBAAiB,YAAY,cAAc,MAAM,OAAO,KAAK,IAAI,KAAA;GACjE,KAAK,MAAM;GACX,MAAM;GACN,aAAa,MAAM,OAAO,gBAAgB;GAC1C,MAAM,MAAM,OAAO;GACnB,kBAAkB,YAAY,cAAc,MAAM,OAAO,MAAM,IAAI,KAAA;GACnE,iBAAiB,MAAM;GACvB,qBAAqB,MAAM;GAC3B,SAAS,MAAM;EACjB,CAAC;CACH;CAEA,KAAK,MAAM,SAAS,sBAAsB,MAAM,OAAO,GAAG;EACxD,MAAM,YAAY,kBAAkB,MAAM,WAAW,MAAM,aAAa;EACxE,qBAAqB,MAAM,YAAY;GACrC,eAAe,MAAM,YAAY,KAAI,WACnC,aAAa,MAAM,YAAY,OAAO,UAAU,CAClD;GACA,cAAc,MAAM;GACpB,kBAAkB,YAAY,cAAc,MAAM,QAAQ,MAAM,IAAI,KAAA;GACpE,aAAa,MAAM,QAAQ;GAC3B,KAAK,MAAM;GACX,MAAM;GACN,aAAa,MAAM,QAAQ,gBAAgB;GAC3C,MAAM,MAAM,QAAQ;GACpB,kBAAkB,YAAY,cAAc,MAAM,QAAQ,MAAM,IAAI,KAAA;GACpE,iBAAiB,MAAM;GACvB,qBAAqB,MAAM;GAC3B,iBACE,aAAa,MAAM,QAAQ,UAAU,KAAA,IACjC,cAAc,MAAM,QAAQ,KAAK,IACjC,KAAA;GACN,aAAa,MAAM,QAAQ;GAC3B,SAAS,MAAM;EACjB,CAAC;CACH;CAEA,KAAK,MAAM,EAAE,QAAQ,aAAa,MAAM,SACtC,KAAK,MAAM,WAAW,OAAO,eAAe;EAC1C,MAAM,aAAa,QAAQ;EAC3B,mBAAgC,YAAY,OAAO,YAAY,OAAO,WAAW;EACjF,qBAAqB,OAAO,YAAY;GACtC,eAAe,WAAW,YAAY,KAAI,WACxC,aAAa,OAAO,YAAY,OAAO,UAAU,CACnD;GACA,cAAc,GAAG,OAAO,WAAW,GAAG,QAAQ;GAC9C,aAAa,QAAQ;GACrB,KAAK,QAAQ;GACb,MAAM;GACN,aAAa;GACb,MAAM,QAAQ;GACd,iBAAiB,OAAO;GACxB,qBAAqB;GACrB;GACA,GAAGA,gBAA6B,YAAY,aAAa;EAC3D,CAAC;CACH;CAEF,MAAM,gBAAiD,MAAM,QAAQ,KAClE,EAAE,QAAQ,eAAe;EACxB,aAAa,OAAO,YAAY,KAAI,YAAW;GAC7C,aAAa,OAAO;GACpB,IAAI,aAAa,OAAO,YAAY,OAAO,UAAU;GACrD,iBAAiB,OAAO,UAAU,KAAA,IAAY,OAAO,cAAc,OAAO,KAAK;GAC/E,KAAK,OAAO;GACZ,MAAM,OAAO;GACb,oBAAoB,cAAc,OAAO,QAAQ;GACjD,cAAc,uBAAuB,MAAM;GAC3C,MAAM,OAAO;GACb,YAAY,OAAO;GACnB,iBAAiB,OAAO,UAAU,KAAA,IAAY,OAAO,cAAc,OAAO,KAAK;EACjF,EAAE;EACF,oBAAoB,6BAA6B,IAAI,OAAO,UAAU,KAAK,CAAC;EAC5E,YAAY,OAAO;EACnB,aAAa,OAAO;EACpB,SAAS,OAAO;EAChB,aAAa,OAAO;EACpB,SAAS,OAAO;EAChB,aAAa,OAAO;EACpB,IAAI,OAAO;EACX,KAAK,OAAO;EACZ,MAAM;EACN,MAAM,OAAO;EACb,eAAe,OAAO,kBAAkB,KAAA;EACxC,iBAAiB,OAAO;EACxB,qBAAqB;CACvB,EACF;CAEA,MAAM,cAA+C,MAAM,YAAY,SAAQ,aAAY;EACzF,MAAM,KAAKC,WAAsB,SAAS,UAAU;EAEpD,OAAO,CACL;GACE,aAAa,SAAS,YAAY,KAAI,YAAW;IAC/C,aAAa,OAAO;IACpB,IAAI,aAAa,IAAI,OAAO,UAAU;IACtC,iBAAiB,OAAO,UAAU,KAAA,IAAY,OAAO,cAAc,OAAO,KAAK;IAC/E,KAAK,OAAO;IACZ,MAAM,OAAO;IACb,oBAAoB,cAAc,OAAO,QAAQ;IACjD,cAAc,uBAAuB,MAAM;IAC3C,MAAM,OAAO;IACb,YAAY;IACZ,iBAAiB,OAAO,UAAU,KAAA,IAAY,OAAO,cAAc,OAAO,KAAK;GACjF,EAAE;GACF,oBAAoB,CAAC;GACrB,YAAY,SAAS;GACrB,aAAa,SAAS;GACtB,SAAS,SAAS;GAClB,aAAa,SAAS;GACtB,SAAS,SAAS;GAClB,aAAa,SAAS;GACtB;GACA,KAAK,SAAS;GACd,MAAM;GACN,MAAM,SAAS;GACf,eAAe;GACf,iBAAiB,KAAA;GACjB,qBAAqB,KAAA;EACvB,CACF;CACF,CAAC;CAED,OAAO;EAAE,gBAAgB,MAAM;EAAgB,WAAW,CAAC,GAAG,eAAe,GAAG,WAAW;CAAE;AAC/F"}

package/dist/internal/dual/triggers.d.ts

@@ -0,0 +1,29 @@
+import { Any } from "../../AuthMethod.js";
+import { Any as Any$1, RuntimeTriggerEntry as RuntimeTriggerEntry$1 } from "../../Trigger.js";
+import { Any as Any$2 } from "../../Group.js";
+import { MachineIdSeparator } from "../identifier.js";
+import { IsAny, IsGenericArray } from "../types.js";
+import { Any as Any$3 } from "../../Plugin.js";
+import { PluginInstallation } from "../../DualRuntime.js";
+//#region src/internal/dual/triggers.d.ts
+export interface TriggerEntry<Id extends string = string, ProviderId extends string = string, TriggerDef extends Any$1 = Any$1, AllowedMethods extends readonly Any[] = readonly Any[]> {
+  readonly triggerId: Id;
+  readonly providerId: ProviderId;
+  readonly trigger: TriggerDef;
+  readonly authMethods: AllowedMethods;
+}
+type TriggerEntriesFromTriggers<Triggers extends readonly Any$1[], ProviderId extends string, Prefix extends string, AllowedMethods extends readonly Any[]> = IsGenericArray<Triggers> extends true ? TriggerEntry<string, ProviderId, Any$1, AllowedMethods> : Triggers[number] extends (infer TriggerDef) ? TriggerDef extends Any$1 ? TriggerEntry<`${Prefix}${typeof MachineIdSeparator}${TriggerDef["identifier"]}`, ProviderId, TriggerDef, AllowedMethods> : never : never;
+type TriggerEntriesFromGroups<Groups extends readonly Any$2[], ProviderId extends string, Prefix extends string, AllowedMethods extends readonly Any[]> = IsGenericArray<Groups> extends true ? TriggerEntry<string, ProviderId, Any$1, AllowedMethods> : Groups[number] extends (infer GroupDef) ? GroupDef extends Any$2 ? GroupTriggerEntries<GroupDef, ProviderId, `${Prefix}${typeof MachineIdSeparator}${GroupDef["identifier"]}`, AllowedMethods> : never : never;
+type GroupTriggerEntries<GroupDef extends Any$2, ProviderId extends string, Prefix extends string, AllowedMethods extends readonly Any[]> = TriggerEntriesFromTriggers<GroupDef["triggers"], ProviderId, Prefix, AllowedMethods> | TriggerEntriesFromGroups<GroupDef["groups"], ProviderId, Prefix, AllowedMethods>;
+type PluginTriggerEntries<P extends Any$3> = TriggerEntriesFromTriggers<P["triggers"], P["identifier"], P["identifier"], P["authMethods"]> | TriggerEntriesFromGroups<P["groups"], P["identifier"], P["identifier"], P["authMethods"]>;
+export type AllTriggerEntries<Plugins extends readonly Any$3[]> = IsAny<Plugins> extends true ? TriggerEntry : IsGenericArray<Plugins> extends true ? TriggerEntry : Plugins[number] extends (infer P) ? P extends Any$3 ? PluginTriggerEntries<P> : never : never;
+export interface RuntimeTriggerEntry<out TriggerDef extends Any$1 = Any$1, out AllowedMethods extends readonly Any[] = readonly Any[], out TriggerId extends string = string, out ProviderId extends string = string> extends RuntimeTriggerEntry$1<TriggerDef, AllowedMethods, TriggerId, ProviderId> {
+  readonly localId: string;
+  readonly pluginVersion: string;
+}
+export declare const collectTriggerEntries: (installations: readonly PluginInstallation[]) => readonly RuntimeTriggerEntry[];
+/** A trigger of the installed releases, or of the exact `version` when the caller pins one. */
+export declare const resolveRuntimeTrigger: (installations: readonly PluginInstallation[], triggerId: string, version?: string) => RuntimeTriggerEntry | undefined;
+//#endregion
+export {};
+//# sourceMappingURL=triggers.d.ts.map

package/dist/internal/dual/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","names":["Trigger.Any","AuthMethod.Any","Group.Any","Plugin.Any","Trigger.RuntimeTriggerEntry"],"sources":["../../../src/internal/dual/triggers.ts"],"mappings":";;;;;;;;iBASiB,aACf,4BACA,oCACA,mBAAmBA,QAAcA,OACjC,gCAAgCC,iBAA4BA;WAEnD,WAAW;WACX,YAAY;WACZ,SAAS;WACT,aAAa;;KAGnB,2BACH,0BAA0BD,SAC1B,2BACA,uBACA,gCAAgCC,SAEhC,eAAe,yBACX,qBAAqB,YAAYD,OAAa,kBAC9C,gCAA+B,cAC7B,mBAAmBA,QACjB,gBACK,gBAAgB,qBAAqB,4BACxC,YACA,YACA;KAKP,yBACH,wBAAwBE,SACxB,2BACA,uBACA,gCAAgCD,SAEhC,eAAe,uBACX,qBAAqB,YAAYD,OAAa,kBAC9C,8BAA6B,YAC3B,iBAAiBE,QACf,oBACE,UACA,eACG,gBAAgB,qBAAqB,0BACxC;KAKP,oBACH,iBAAiBA,OACjB,2BACA,uBACA,gCAAgCD,SAE9B,2BAA2B,sBAAsB,YAAY,QAAQ,kBACrE,yBAAyB,oBAAoB,YAAY,QAAQ;KAEhE,qBAAqB,UAAUE,SAChC,2BAA2B,eAAe,iBAAiB,iBAAiB,oBAC5E,yBAAyB,aAAa,iBAAiB,iBAAiB;YAEhE,kBAAkB,yBAAyBA,WACrD,MAAM,wBACF,eACA,eAAe,wBACb,eACA,+BAA8B,KAC5B,UAAUA,QACR,qBAAqB;iBAIhB,wBACX,mBAAmBH,QAAcA,WACjC,gCAAgCC,iBAA4BA,WAC5D,uCACA,4CACIG,sBAA4B,YAAY,gBAAgB,WAAW;WAClE;WACA;;qBAaE,wBAAqB,wBACR,kCACd;;qBAQC,wBAAqB,wBACR,sBAAoB,mBAC3B,qBAEhB"}

package/dist/internal/dual/triggers.js

@@ -0,0 +1,26 @@
+import { walkCapabilities } from "../capabilities.js";
+//#region src/internal/dual/triggers.ts
+const entriesOf = (installation) => walkCapabilities(installation.plugin, (owner) => owner.triggers).map((walked) => ({
+	authMethods: installation.plugin.authMethods,
+	localId: walked.localId,
+	pluginVersion: installation.version,
+	providerId: installation.plugin.identifier,
+	trigger: walked.node,
+	triggerId: walked.canonicalId
+}));
+const collectTriggerEntries = (installations) => installations.flatMap(entriesOf);
+const triggerIndex = /* @__PURE__ */ new WeakMap();
+/** A trigger of the installed releases, or of the exact `version` when the caller pins one. */
+const resolveRuntimeTrigger = (installations, triggerId, version) => {
+	let index = triggerIndex.get(installations);
+	if (index === void 0) {
+		index = new Map(collectTriggerEntries(installations).map((entry) => [entry.triggerId, entry]));
+		triggerIndex.set(installations, index);
+	}
+	const entry = index.get(triggerId);
+	return entry === void 0 || version !== void 0 && entry.pluginVersion !== version ? void 0 : entry;
+};
+//#endregion
+export { collectTriggerEntries, resolveRuntimeTrigger };
+
+//# sourceMappingURL=triggers.js.map

package/dist/internal/dual/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","names":[],"sources":["../../../src/internal/dual/triggers.ts"],"sourcesContent":["import type * as AuthMethod from \"../../AuthMethod.ts\";\nimport type { PluginInstallation } from \"../../DualRuntime.ts\";\nimport type * as Group from \"../../Group.ts\";\nimport type * as Plugin from \"../../Plugin.ts\";\nimport type * as Trigger from \"../../Trigger.ts\";\nimport { walkCapabilities } from \"../capabilities.ts\";\nimport type { MachineIdSeparator } from \"../identifier.ts\";\nimport type { IsAny, IsGenericArray } from \"../types.ts\";\n\nexport interface TriggerEntry<\n  Id extends string = string,\n  ProviderId extends string = string,\n  TriggerDef extends Trigger.Any = Trigger.Any,\n  AllowedMethods extends readonly AuthMethod.Any[] = readonly AuthMethod.Any[],\n> {\n  readonly triggerId: Id;\n  readonly providerId: ProviderId;\n  readonly trigger: TriggerDef;\n  readonly authMethods: AllowedMethods;\n}\n\ntype TriggerEntriesFromTriggers<\n  Triggers extends readonly Trigger.Any[],\n  ProviderId extends string,\n  Prefix extends string,\n  AllowedMethods extends readonly AuthMethod.Any[],\n> =\n  IsGenericArray<Triggers> extends true\n    ? TriggerEntry<string, ProviderId, Trigger.Any, AllowedMethods>\n    : Triggers[number] extends infer TriggerDef\n      ? TriggerDef extends Trigger.Any\n        ? TriggerEntry<\n            `${Prefix}${typeof MachineIdSeparator}${TriggerDef[\"identifier\"]}`,\n            ProviderId,\n            TriggerDef,\n            AllowedMethods\n          >\n        : never\n      : never;\n\ntype TriggerEntriesFromGroups<\n  Groups extends readonly Group.Any[],\n  ProviderId extends string,\n  Prefix extends string,\n  AllowedMethods extends readonly AuthMethod.Any[],\n> =\n  IsGenericArray<Groups> extends true\n    ? TriggerEntry<string, ProviderId, Trigger.Any, AllowedMethods>\n    : Groups[number] extends infer GroupDef\n      ? GroupDef extends Group.Any\n        ? GroupTriggerEntries<\n            GroupDef,\n            ProviderId,\n            `${Prefix}${typeof MachineIdSeparator}${GroupDef[\"identifier\"]}`,\n            AllowedMethods\n          >\n        : never\n      : never;\n\ntype GroupTriggerEntries<\n  GroupDef extends Group.Any,\n  ProviderId extends string,\n  Prefix extends string,\n  AllowedMethods extends readonly AuthMethod.Any[],\n> =\n  | TriggerEntriesFromTriggers<GroupDef[\"triggers\"], ProviderId, Prefix, AllowedMethods>\n  | TriggerEntriesFromGroups<GroupDef[\"groups\"], ProviderId, Prefix, AllowedMethods>;\n\ntype PluginTriggerEntries<P extends Plugin.Any> =\n  | TriggerEntriesFromTriggers<P[\"triggers\"], P[\"identifier\"], P[\"identifier\"], P[\"authMethods\"]>\n  | TriggerEntriesFromGroups<P[\"groups\"], P[\"identifier\"], P[\"identifier\"], P[\"authMethods\"]>;\n\nexport type AllTriggerEntries<Plugins extends readonly Plugin.Any[]> =\n  IsAny<Plugins> extends true\n    ? TriggerEntry\n    : IsGenericArray<Plugins> extends true\n      ? TriggerEntry\n      : Plugins[number] extends infer P\n        ? P extends Plugin.Any\n          ? PluginTriggerEntries<P>\n          : never\n        : never;\n\nexport interface RuntimeTriggerEntry<\n  out TriggerDef extends Trigger.Any = Trigger.Any,\n  out AllowedMethods extends readonly AuthMethod.Any[] = readonly AuthMethod.Any[],\n  out TriggerId extends string = string,\n  out ProviderId extends string = string,\n> extends Trigger.RuntimeTriggerEntry<TriggerDef, AllowedMethods, TriggerId, ProviderId> {\n  readonly localId: string;\n  readonly pluginVersion: string;\n}\n\nconst entriesOf = (installation: PluginInstallation): readonly RuntimeTriggerEntry[] =>\n  walkCapabilities(installation.plugin, owner => owner.triggers).map(walked => ({\n    authMethods: installation.plugin.authMethods,\n    localId: walked.localId,\n    pluginVersion: installation.version,\n    providerId: installation.plugin.identifier,\n    trigger: walked.node,\n    triggerId: walked.canonicalId,\n  }));\n\nexport const collectTriggerEntries = (\n  installations: readonly PluginInstallation[],\n): readonly RuntimeTriggerEntry[] => installations.flatMap(entriesOf);\n\nconst triggerIndex = new WeakMap<\n  readonly PluginInstallation[],\n  ReadonlyMap<string, RuntimeTriggerEntry>\n>();\n\n/** A trigger of the installed releases, or of the exact `version` when the caller pins one. */\nexport const resolveRuntimeTrigger = (\n  installations: readonly PluginInstallation[],\n  triggerId: string,\n  version?: string,\n): RuntimeTriggerEntry | undefined => {\n  let index = triggerIndex.get(installations);\n  if (index === undefined) {\n    index = new Map(collectTriggerEntries(installations).map(entry => [entry.triggerId, entry]));\n    triggerIndex.set(installations, index);\n  }\n  const entry = index.get(triggerId);\n  return entry === undefined || (version !== undefined && entry.pluginVersion !== version)\n    ? undefined\n    : entry;\n};\n"],"mappings":";;AA6FA,MAAM,aAAa,iBACjB,iBAAiB,aAAa,SAAQ,UAAS,MAAM,QAAQ,CAAC,CAAC,KAAI,YAAW;CAC5E,aAAa,aAAa,OAAO;CACjC,SAAS,OAAO;CAChB,eAAe,aAAa;CAC5B,YAAY,aAAa,OAAO;CAChC,SAAS,OAAO;CAChB,WAAW,OAAO;AACpB,EAAE;AAEJ,MAAa,yBACX,kBACmC,cAAc,QAAQ,SAAS;AAEpE,MAAM,+BAAe,IAAI,QAGvB;;AAGF,MAAa,yBACX,eACA,WACA,YACoC;CACpC,IAAI,QAAQ,aAAa,IAAI,aAAa;CAC1C,IAAI,UAAU,KAAA,GAAW;EACvB,QAAQ,IAAI,IAAI,sBAAsB,aAAa,CAAC,CAAC,KAAI,UAAS,CAAC,MAAM,WAAW,KAAK,CAAC,CAAC;EAC3F,aAAa,IAAI,eAAe,KAAK;CACvC;CACA,MAAM,QAAQ,MAAM,IAAI,SAAS;CACjC,OAAO,UAAU,KAAA,KAAc,YAAY,KAAA,KAAa,MAAM,kBAAkB,UAC5E,KAAA,IACA;AACN"}

package/dist/internal/handler-context.d.ts

@@ -0,0 +1,9 @@
+import { Context } from "effect";
+//#region src/internal/handler-context.d.ts
+export declare const handlerGroupKey: (pluginId: string) => string;
+export declare const withoutGroups: (context: Context.Context<never>) => Context.Context<never>;
+export declare const indexGroups: (context: Context.Context<never>) => Context.Context<never>;
+export declare const mergeUnder: <Input>(lower: Context.Context<never>, input: Context.Context<Input>) => Context.Context<Input>;
+export declare const findHandler: (context: Context.Context<never>, providerId: string, handlerKey: string) => unknown;
+//#endregion
+//# sourceMappingURL=handler-context.d.ts.map

package/dist/internal/handler-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-context.d.ts","names":[],"sources":["../../src/internal/handler-context.ts"],"mappings":";;qBAWa,kBAAe;qBAQf,gBAAa,SAAa,QAAQ,mBAAiB,QAAQ;qBAU3D,cAAW,SAAa,QAAQ,mBAAiB,QAAQ;qBASzD,aAAc,OAAK,OACvB,QAAQ,gBAAc,OACtB,QAAQ,QAAQ,WACtB,QAAQ,QAAQ;qBAKN,cAAW,SACb,QAAQ,gBAAc,oBACb"}