every-plugin 0.0.4 → 0.0.6

package/README.md

@@ -1,15 +1,265 @@
-# core-sdk
+# every-plugin
 
-To install dependencies:
+A modular plugin runtime & system built with [Effect.TS](https://effect.website/) for loading, initializing, and executing remote plugins via [Module Federation](https://module-federation.io/).
+
+## Installation
 
 ```bash
-bun install
+npm install every-plugin
+# or
+bun add every-plugin
+```
+
+## Quick Start
+
+### Basic Plugin Usage
+
+```typescript
+import { Effect, ManagedRuntime } from "effect";
+import { PluginRuntime } from "every-plugin/runtime";
+
+// Create a managed runtime (do this once per application/worker)
+const runtime = ManagedRuntime.make(PluginRuntime.Live({
+  registry: {
+    "@my-org/data-processor": {
+      version: "1.0.0",
+      remoteUrl: "https://cdn.example.com/plugins/data-processor@latest/remoteEntry.js",
+      description: "Processes data items",
+      type: "pipeline"
+    }
+  },
+  secrets: {
+    API_KEY: "your-secret-key",
+    DATABASE_URL: "postgresql://..."
+  },
+  logger: customLogger // optional
+}));
+
+// Use the runtime to execute plugins
+const result = await runtime.runPromise(
+  Effect.gen(function* () {
+    const pluginRuntime = yield* PluginRuntime;
+    
+    // Use and execute a plugin in one step
+    const plugin = yield* pluginRuntime.usePlugin("@my-org/data-processor", {
+      apiKey: "{{API_KEY}}", // Will be hydrated from secrets
+      batchSize: 100
+    });
+    
+    const output = yield* pluginRuntime.executePlugin(plugin, {
+      items: ["item1", "item2", "item3"]
+    });
+    
+    return output;
+  })
+);
+
+console.log(result);
+
+// Clean up when done
+await runtime.dispose();
+```
+
+### Alternative: Convenience Factory Function
+
+If you prefer a factory function, you can use the convenience wrapper:
+
+```typescript
+import { createPluginRuntime, PluginRuntime } from "every-plugin/runtime";
+
+// This is equivalent to ManagedRuntime.make(PluginRuntime.Live(config))
+const runtime = createPluginRuntime({
+  registry: { /* ... */ },
+  secrets: { /* ... */ }
+});
+
+const result = await runtime.runPromise(
+  Effect.gen(function* () {
+    const pluginRuntime = yield* PluginRuntime;
+    return yield* pluginRuntime.usePlugin(pluginId, config);
+  })
+);
+```
+
+### Advanced Usage - Granular Control
+
+```typescript
+import { Effect } from "effect";
+import { PluginRuntime } from "every-plugin/runtime";
+
+const processWithGranularControl = Effect.gen(function* () {
+  const pluginRuntime = yield* PluginRuntime;
+  
+  // Step-by-step plugin lifecycle
+  const constructor = yield* pluginRuntime.loadPlugin("@my-org/data-processor");
+  const instance = yield* pluginRuntime.instantiatePlugin(constructor);
+  const initialized = yield* pluginRuntime.initializePlugin(instance, config);
+  const output = yield* pluginRuntime.executePlugin(initialized, input);
+  
+  return output;
+});
+
+await runtime.runPromise(processWithGranularControl);
+```
+
+### Worker Integration
+
+Perfect for BullMQ workers or similar job processing systems:
+
+```typescript
+import { Job } from "bullmq";
+import { Effect } from "effect";
+import { createPluginRuntime, PluginRuntime } from "every-plugin/runtime";
+
+// Initialize runtime once per worker
+const runtime = createPluginRuntime({
+  registry: pluginRegistry,
+  secrets: await loadSecrets(),
+});
+
+// Job processor
+const processJob = (job: Job) => 
+  runtime.runPromise(
+    Effect.gen(function* () {
+      const pluginRuntime = yield* PluginRuntime;
+      const { pluginId, config, input } = job.data;
+      
+      const plugin = yield* pluginRuntime.usePlugin(pluginId, config);
+      return yield* pluginRuntime.executePlugin(plugin, input);
+    })
+  );
+
+// Worker setup
+const worker = new Worker("my-queue", processJob);
+
+// Cleanup on shutdown
+process.on("SIGTERM", async () => {
+  await worker.close();
+  await runtime.dispose();
+});
+```
+
+### React/Next.js Integration
+
+```typescript
+import { createPluginRuntime, PluginRuntime } from "every-plugin/runtime";
+import { Effect } from "effect";
+
+// Create runtime at app level
+const pluginRuntime = createPluginRuntime({
+  registry: clientSideRegistry,
+  secrets: {} // No secrets on client side
+});
+
+// In a React component or API route
+export async function executePlugin(pluginId: string, config: any, input: any) {
+  return pluginRuntime.runPromise(
+    Effect.gen(function* () {
+      const runtime = yield* PluginRuntime;
+      const plugin = yield* runtime.usePlugin(pluginId, config);
+      return yield* runtime.executePlugin(plugin, input);
+    })
+  );
+}
+
+// Cleanup in app teardown
+export function cleanup() {
+  return pluginRuntime.dispose();
+}
+```
+
+## Core Concepts
+
+### Plugin Registry
+
+The registry defines available plugins and their remote locations:
+
+```typescript
+type PluginRegistry = {
+  [pluginId: string]: {
+    version: string;
+    remoteUrl: string;
+    description?: string;
+    type?: string;
+  };
+};
+```
+
+### Secret Hydration
+
+Secrets are automatically hydrated using Mustache-style templating:
+
+```typescript
+const config = {
+  apiKey: "{{API_KEY}}", // Will be replaced with actual secret
+  endpoint: "https://api.example.com"
+};
+```
+
+### Plugin Lifecycle
+
+1. **Load**: Download and cache the remote plugin module
+2. **Instantiate**: Create a new instance of the plugin class
+3. **Initialize**: Configure the plugin with validated config and secrets
+4. **Execute**: Run the plugin with validated input, return validated output
+
+### Error Handling
+
+All operations return Effect types with proper error handling:
+
+```typescript
+const result = await runtime.runPromise(
+  Effect.gen(function* () {
+    const pluginRuntime = yield* PluginRuntime;
+    return yield* pluginRuntime.usePlugin(pluginId, config);
+  }).pipe(
+    Effect.catchAll((error) => {
+      console.error("Plugin execution failed:", error);
+      return Effect.succeed(null); // Fallback value
+    })
+  )
+);
 ```
 
-To run:
+## API Reference
+
+### `createPluginRuntime(config)`
+
+Creates a managed runtime for plugin execution.
+
+**Parameters:**
+
+- `config.registry`: Plugin registry mapping
+- `config.secrets`: Secret values for hydration (optional)
+- `config.logger`: Custom logger implementation (optional)
+
+**Returns:** `ManagedRuntime` instance
+
+### `PluginRuntime`
+
+Effect service tag for accessing the plugin runtime within Effect workflows.
+
+### Plugin Runtime Methods
+
+- `loadPlugin(pluginId)`: Load plugin constructor from registry
+- `instantiatePlugin(constructor)`: Create plugin instance
+- `initializePlugin(instance, config)`: Initialize with config and secrets
+- `executePlugin(plugin, input)`: Execute plugin with input
+- `usePlugin(pluginId, config)`: Load + instantiate + initialize in one step
+
+## Development
 
 ```bash
-bun run index.ts
+# Install dependencies
+bun install
+
+# Build the package
+bun run build
+
+# Run tests
+bun test
 ```
 
-This project was created using `bun init` in bun v1.2.14. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+## License
+
+MIT

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class PluginExecutionError extends Error {
+	readonly retryable: boolean;
+	constructor(message: string, retryable?: boolean);
+}
+export declare class ConfigurationError extends PluginExecutionError {
+	constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,qBAAa,oBAAqB,SAAQ,KAAK;aACA,SAAS,EAAE,OAAO;gBAAnD,OAAO,EAAE,MAAM,EAAkB,SAAS,GAAE,OAAc;CAIvE;AAED,qBAAa,kBAAmB,SAAQ,oBAAoB;gBAC9C,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,qBAAa,oBAAqB,SAAQ,KAAK;aAG7B,SAAS,EAAE,OAAO;gBADlC,OAAO,EAAE,MAAM,EACC,SAAS,GAAE,OAAc;CAK1C;AAED,qBAAa,kBAAmB,SAAQ,oBAAoB;gBAC/C,OAAO,EAAE,MAAM;CAI3B"}

package/dist/errors.js

@@ -4,12 +4,12 @@ export class PluginExecutionError extends Error {
     constructor(message, retryable = true) {
         super(message);
         this.retryable = retryable;
-        this.name = 'PluginExecutionError';
+        this.name = "PluginExecutionError";
     }
 }
 export class ConfigurationError extends PluginExecutionError {
     constructor(message) {
         super(message, false); // Configuration errors are not retryable
-        this.name = 'ConfigurationError';
+        this.name = "ConfigurationError";
     }
 }

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Effect } from "effect";
+export { z } from "zod";
+export * from "./errors";
+export * from "./plugin";
+export * from "./source";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,5 @@
 export { Effect } from "effect";
 export { z } from "zod";
-export * from './errors';
-export * from './plugin';
-export * from './source';
+export * from "./errors";
+export * from "./plugin";
+export * from "./source";

package/dist/plugin.d.ts

@@ -0,0 +1,57 @@
+import { Context, type Effect } from "effect";
+import { z } from "zod";
+import type { ConfigurationError, PluginExecutionError } from "./errors";
+export declare const createOutputSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<T>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        stack: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare function createConfigSchema<V extends z.ZodTypeAny, S extends z.ZodTypeAny>(variablesSchema?: V, secretsSchema?: S): z.ZodObject<{
+    variables: z.ZodOptional<V>;
+    secrets: z.ZodOptional<S>;
+}>;
+export declare function createInputSchema<I extends z.ZodTypeAny>(inputSchema: I): I;
+export declare const ErrorDetailsSchema: z.ZodObject<{
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    stack: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ErrorDetails = z.infer<typeof ErrorDetailsSchema>;
+export type Config<V extends z.ZodTypeAny = z.ZodRecord<z.ZodString, z.ZodUnknown>, S extends z.ZodTypeAny = z.ZodRecord<z.ZodString, z.ZodUnknown>> = z.infer<ReturnType<typeof createConfigSchema<V, S>>>;
+export type Input<I extends z.ZodTypeAny> = z.infer<ReturnType<typeof createInputSchema<I>>>;
+export type Output<T extends z.ZodTypeAny> = z.infer<ReturnType<typeof createOutputSchema<T>>>;
+export interface Plugin<TInputSchema extends z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny, TConfigSchema extends z.ZodTypeAny> {
+    readonly id: string;
+    readonly type: PluginType;
+    readonly inputSchema: TInputSchema;
+    readonly outputSchema: TOutputSchema;
+    readonly configSchema: TConfigSchema;
+    initialize(config?: z.infer<TConfigSchema>): Effect.Effect<void, ConfigurationError, PluginLoggerTag>;
+    execute(input: z.infer<TInputSchema>): Effect.Effect<z.infer<TOutputSchema>, PluginExecutionError, PluginLoggerTag>;
+    shutdown(): Effect.Effect<void, never, PluginLoggerTag>;
+}
+export type PluginType = "transformer" | "distributor" | "source";
+export interface PluginMetadata {
+    remoteUrl: string;
+    type?: PluginType;
+    version?: string;
+    description?: string;
+}
+export interface PluginRegistry {
+    [pluginId: string]: PluginMetadata;
+}
+export interface PluginLogger {
+    readonly logInfo: (message: string, context?: unknown) => Effect.Effect<void>;
+    readonly logWarning: (message: string, context?: unknown) => Effect.Effect<void>;
+    readonly logError: (message: string, error?: unknown, context?: unknown) => Effect.Effect<void>;
+    readonly logDebug: (message: string, context?: unknown) => Effect.Effect<void>;
+}
+declare const PluginLoggerTag_base: Context.TagClass<PluginLoggerTag, "PluginLogger", PluginLogger>;
+export declare class PluginLoggerTag extends PluginLoggerTag_base {
+}
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/plugin.js

@@ -1,5 +1,5 @@
 import { Context } from "effect";
-import { z } from 'zod';
+import { z } from "zod";
 // Helpers
 export const createOutputSchema = (dataSchema) => z.object({
     success: z.boolean(),

package/dist/runtime/errors.d.ts

@@ -0,0 +1,41 @@
+import type { z } from "zod";
+declare const PluginRuntimeError_base: new <A extends Record<string, any> = {}>(
+	args: import("effect/Types").Equals<A, {}> extends true
+		? void
+		: { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] },
+) => import("effect/Cause").YieldableError & {
+	readonly _tag: "PluginRuntimeError";
+} & Readonly<A>;
+export declare class PluginRuntimeError extends PluginRuntimeError_base<{
+	readonly pluginId?: string;
+	readonly operation: string;
+	readonly cause?: Error;
+	readonly retryable: boolean;
+}> {}
+declare const ModuleFederationError_base: new <
+	A extends Record<string, any> = {},
+>(
+	args: import("effect/Types").Equals<A, {}> extends true
+		? void
+		: { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] },
+) => import("effect/Cause").YieldableError & {
+	readonly _tag: "ModuleFederationError";
+} & Readonly<A>;
+export declare class ModuleFederationError extends ModuleFederationError_base<{
+	readonly pluginId: string;
+	readonly remoteUrl: string;
+	readonly cause?: Error;
+}> {}
+declare const ValidationError_base: new <A extends Record<string, any> = {}>(
+	args: import("effect/Types").Equals<A, {}> extends true
+		? void
+		: { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] },
+) => import("effect/Cause").YieldableError & {
+	readonly _tag: "ValidationError";
+} & Readonly<A>;
+export declare class ValidationError extends ValidationError_base<{
+	readonly pluginId: string;
+	readonly stage: "config" | "input" | "output";
+	readonly zodError: z.ZodError;
+}> {}
+//# sourceMappingURL=errors.d.ts.map

package/dist/runtime/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAE7B,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;CAAI;;;;AAEN,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB,CAAC;CAAI;;;;AAEN,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC;CAC/B,CAAC;CAAI"}

package/dist/runtime/errors.js

@@ -0,0 +1,7 @@
+import { Data } from "effect";
+export class PluginRuntimeError extends Data.TaggedError("PluginRuntimeError") {
+}
+export class ModuleFederationError extends Data.TaggedError("ModuleFederationError") {
+}
+export class ValidationError extends Data.TaggedError("ValidationError") {
+}

package/dist/runtime/index.d.ts

@@ -0,0 +1,21 @@
+import { Effect, Layer, ManagedRuntime } from "effect";
+import type { z } from "zod";
+import type { PluginRuntimeError } from "./errors";
+import type { AnyPlugin, InitializedPlugin, PluginConstructor, PluginInstance, PluginRuntimeConfig } from "./types";
+export interface IPluginRuntime {
+    readonly loadPlugin: (pluginId: string) => Effect.Effect<PluginConstructor, PluginRuntimeError>;
+    readonly instantiatePlugin: <T extends AnyPlugin>(ctor: PluginConstructor) => Effect.Effect<PluginInstance<T>, PluginRuntimeError>;
+    readonly initializePlugin: <T extends AnyPlugin>(instance: PluginInstance<T>, config: z.infer<T["configSchema"]>) => Effect.Effect<InitializedPlugin<T>, PluginRuntimeError>;
+    readonly executePlugin: <T extends AnyPlugin>(initializedPlugin: InitializedPlugin<T>, input: z.infer<T["inputSchema"]>) => Effect.Effect<z.infer<T["outputSchema"]>, PluginRuntimeError>;
+    readonly createPlugin: <T extends AnyPlugin>(pluginId: string, config: z.infer<T["configSchema"]>) => Effect.Effect<InitializedPlugin<T>, PluginRuntimeError>;
+    readonly shutdown: () => Effect.Effect<void, never>;
+}
+declare const PluginRuntime_base: import("effect/Context").TagClass<PluginRuntime, "PluginRuntime", IPluginRuntime> & Effect.Tag.Proxy<PluginRuntime, IPluginRuntime> & {
+    use: <X>(body: (_: IPluginRuntime) => X) => [X] extends [Effect.Effect<infer A, infer E, infer R>] ? Effect.Effect<A, E, PluginRuntime | R> : [X] extends [PromiseLike<infer A_1>] ? Effect.Effect<A_1, import("effect/Cause").UnknownException, PluginRuntime> : Effect.Effect<X, never, PluginRuntime>;
+};
+export declare class PluginRuntime extends PluginRuntime_base {
+    static Live: (config: PluginRuntimeConfig) => Layer.Layer<PluginRuntime, never, never>;
+}
+export declare const createPluginRuntime: (config: PluginRuntimeConfig) => ManagedRuntime.ManagedRuntime<PluginRuntime, never>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAOnD,OAAO,KAAK,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,MAAM,SAAS,CAAC;AAuBjB,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,UAAU,EAAE,CACpB,QAAQ,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC,SAAS,SAAS,EAC/C,IAAI,EAAE,iBAAiB,KACnB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC,SAAS,SAAS,EAC9C,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,KAC9B,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC7D,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,SAAS,SAAS,EAC3C,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,KAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACnE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,SAAS,SAAS,EAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,KAC9B,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CACpD;;;;AAED,qBAAa,aAAc,SAAQ,kBAGhC;IACF,MAAM,CAAC,IAAI,GAAI,QAAQ,mBAAmB,8CA4CxC;CACF;AAED,eAAO,MAAM,mBAAmB,GAAI,QAAQ,mBAAmB,wDACf,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,34 @@
+import { Effect, Layer, ManagedRuntime } from "effect";
+import { PluginLoggerTag } from "../plugin";
+import { ModuleFederationService, PluginCacheService, PluginService, SecretsService, } from "./services";
+// Default logger implementation
+const createDefaultLogger = () => ({
+    logInfo: (message, context) => Effect.logInfo(message).pipe(Effect.annotateLogs({ source: "plugin", context })),
+    logWarning: (message, context) => Effect.logWarning(message).pipe(Effect.annotateLogs({ source: "plugin", context })),
+    logError: (message, error, context) => Effect.logError(message, error).pipe(Effect.annotateLogs({ source: "plugin", error, context })),
+    logDebug: (message, context) => Effect.logDebug(message).pipe(Effect.annotateLogs({ source: "plugin", context })),
+});
+export class PluginRuntime extends Effect.Tag("PluginRuntime")() {
+    static Live = (config) => {
+        const secrets = config.secrets || {};
+        const logger = config.logger || createDefaultLogger();
+        return Layer.effect(PluginRuntime, Effect.gen(function* () {
+            const pluginService = yield* PluginService;
+            return {
+                loadPlugin: pluginService.loadPlugin,
+                instantiatePlugin: pluginService.instantiatePlugin,
+                initializePlugin: pluginService.initializePlugin,
+                executePlugin: pluginService.executePlugin,
+                createPlugin: (pluginId, config) => Effect.gen(function* () {
+                    const ctor = yield* pluginService.loadPlugin(pluginId);
+                    const instance = yield* pluginService.instantiatePlugin(ctor);
+                    return yield* pluginService.initializePlugin(instance, config);
+                }),
+                shutdown: () => Effect.sync(() => {
+                    // Cleanup handled by Layer disposal
+                }),
+            };
+        })).pipe(Layer.provide(PluginService.Live(config.registry, secrets).pipe(Layer.provide(Layer.mergeAll(ModuleFederationService.Live, PluginCacheService.Live.pipe(Layer.provide(ModuleFederationService.Live)), SecretsService.Live(secrets), Layer.succeed(PluginLoggerTag, logger))))));
+    };
+}
+export const createPluginRuntime = (config) => ManagedRuntime.make(PluginRuntime.Live(config));

package/dist/runtime/runtime.d.ts

@@ -0,0 +1,58 @@
+import { Effect, Layer, ManagedRuntime } from "effect";
+import { z } from "zod";
+import { PluginRuntimeError } from "./errors";
+import type {
+	AnyPlugin,
+	InitializedPlugin,
+	PluginConstructor,
+	PluginInstance,
+	PluginRuntimeConfig,
+} from "./types";
+export interface IPluginRuntime {
+	readonly loadPlugin: (
+		pluginId: string,
+	) => Effect.Effect<PluginConstructor, PluginRuntimeError>;
+	readonly instantiatePlugin: <T extends AnyPlugin>(
+		ctor: PluginConstructor,
+	) => Effect.Effect<PluginInstance<T>, PluginRuntimeError>;
+	readonly initializePlugin: <T extends AnyPlugin>(
+		instance: PluginInstance<T>,
+		config: z.infer<T["configSchema"]>,
+	) => Effect.Effect<InitializedPlugin<T>, PluginRuntimeError>;
+	readonly executePlugin: <T extends AnyPlugin>(
+		initializedPlugin: InitializedPlugin<T>,
+		input: z.infer<T["inputSchema"]>,
+	) => Effect.Effect<z.infer<T["outputSchema"]>, PluginRuntimeError>;
+	readonly createPlugin: <T extends AnyPlugin>(
+		pluginId: string,
+		config: z.infer<T["configSchema"]>,
+	) => Effect.Effect<InitializedPlugin<T>, PluginRuntimeError>;
+	readonly shutdown: () => Effect.Effect<void, never>;
+}
+declare const PluginRuntime_base: import("effect/Context").TagClass<
+	PluginRuntime,
+	"PluginRuntime",
+	IPluginRuntime
+> &
+	Effect.Tag.Proxy<PluginRuntime, IPluginRuntime> & {
+		use: <X>(
+			body: (_: IPluginRuntime) => X,
+		) => [X] extends [Effect.Effect<infer A, infer E, infer R>]
+			? Effect.Effect<A, E, R | PluginRuntime>
+			: [X] extends [PromiseLike<infer A_1>]
+				? Effect.Effect<
+						A_1,
+						import("effect/Cause").UnknownException,
+						PluginRuntime
+					>
+				: Effect.Effect<X, never, PluginRuntime>;
+	};
+export declare class PluginRuntime extends PluginRuntime_base {
+	static Live: (
+		config: PluginRuntimeConfig,
+	) => Layer.Layer<PluginRuntime, never, never>;
+}
+export declare const createManagedPluginRuntime: (
+	config: PluginRuntimeConfig,
+) => ManagedRuntime.ManagedRuntime<PluginRuntime, never>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAO9C,OAAO,KAAK,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EAEnB,MAAM,SAAS,CAAC;AAuBjB,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,UAAU,EAAE,CACpB,QAAQ,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC,SAAS,SAAS,EAC/C,IAAI,EAAE,iBAAiB,KACnB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC,SAAS,SAAS,EAC9C,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,KAC9B,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC7D,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,SAAS,SAAS,EAC3C,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,KAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACnE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,SAAS,SAAS,EAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,KAC9B,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CACpD;;;;AAGD,qBAAa,aAAc,SAAQ,kBAGhC;IACF,MAAM,CAAC,IAAI,GAAI,QAAQ,mBAAmB,8CA4CxC;CACF;AAGD,eAAO,MAAM,0BAA0B,GAAI,QAAQ,mBAAmB,wDACtB,CAAC"}

package/dist/runtime/runtime.js

@@ -0,0 +1,75 @@
+import { Effect, Layer, ManagedRuntime } from "effect";
+import { PluginLoggerTag } from "../plugin";
+import {
+	ModuleFederationService,
+	PluginCacheService,
+	PluginService,
+	SecretsService,
+} from "./services";
+
+// Default logger implementation
+const createDefaultLogger = () => ({
+	logInfo: (message, context) =>
+		Effect.logInfo(message).pipe(
+			Effect.annotateLogs({ source: "plugin", context }),
+		),
+	logWarning: (message, context) =>
+		Effect.logWarning(message).pipe(
+			Effect.annotateLogs({ source: "plugin", context }),
+		),
+	logError: (message, error, context) =>
+		Effect.logError(message, error).pipe(
+			Effect.annotateLogs({ source: "plugin", error, context }),
+		),
+	logDebug: (message, context) =>
+		Effect.logDebug(message).pipe(
+			Effect.annotateLogs({ source: "plugin", context }),
+		),
+});
+// Main PluginRuntime service using Effect.Tag pattern
+export class PluginRuntime extends Effect.Tag("PluginRuntime")() {
+	static Live = (config) => {
+		const secrets = config.secrets || {};
+		const logger = config.logger || createDefaultLogger();
+		return Layer.effect(
+			PluginRuntime,
+			Effect.gen(function* () {
+				const pluginService = yield* PluginService;
+				return {
+					loadPlugin: pluginService.loadPlugin,
+					instantiatePlugin: pluginService.instantiatePlugin,
+					initializePlugin: pluginService.initializePlugin,
+					executePlugin: pluginService.executePlugin,
+					createPlugin: (pluginId, config) =>
+						Effect.gen(function* () {
+							const ctor = yield* pluginService.loadPlugin(pluginId);
+							const instance = yield* pluginService.instantiatePlugin(ctor);
+							return yield* pluginService.initializePlugin(instance, config);
+						}),
+					shutdown: () =>
+						Effect.sync(() => {
+							// Cleanup handled by Layer disposal
+						}),
+				};
+			}),
+		).pipe(
+			Layer.provide(
+				PluginService.Live(config.registry, secrets).pipe(
+					Layer.provide(
+						Layer.mergeAll(
+							ModuleFederationService.Live,
+							PluginCacheService.Live.pipe(
+								Layer.provide(ModuleFederationService.Live),
+							),
+							SecretsService.Live(secrets),
+							Layer.succeed(PluginLoggerTag, logger),
+						),
+					),
+				),
+			),
+		);
+	};
+}
+// ManagedRuntime factory function
+export const createManagedPluginRuntime = (config) =>
+	ManagedRuntime.make(PluginRuntime.Live(config));

package/dist/runtime/runtime.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.test.d.ts.map