every-plugin 0.0.6 → 0.1.0

package/dist/source.d.ts

@@ -1,198 +1,70 @@
+import type { Effect } from "effect";
 import { z } from "zod";
-import type { Config, Input, Output, Plugin } from "./plugin";
+import type { ConfigurationError, PluginExecutionError } from "./errors";
+import type { PluginLoggerTag } from "./plugin";
 /**
- * Zod schema for the Author interface
+ * Source-specific schema creators for contract-based plugins
  */
-export declare const authorSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    username: z.ZodOptional<z.ZodString>;
-    displayName: z.ZodOptional<z.ZodString>;
-    url: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+export declare function createSourceInputSchema<
+	TContract,
+	TStateSchema extends z.ZodTypeAny,
+>(
+	contract: TContract,
+	stateSchema: TStateSchema,
+): z.ZodDiscriminatedUnion<
+	[z.ZodObject<any, z.core.$strip>, ...z.ZodObject<any, z.core.$strip>[]],
+	"procedure"
+>;
 /**
- * Zod schema for PluginSourceItem - defines the structure that plugins must return
+ * Contract-based output schema creator that infers from oRPC contract
  */
-export declare const pluginSourceItemSchema: z.ZodObject<{
-    externalId: z.ZodString;
-    content: z.ZodString;
-    contentType: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodOptional<z.ZodString>;
-    url: z.ZodOptional<z.ZodString>;
-    authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodOptional<z.ZodString>;
-        username: z.ZodOptional<z.ZodString>;
-        displayName: z.ZodOptional<z.ZodString>;
-        url: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    raw: z.ZodUnknown;
-}, z.core.$strip>;
+export declare function createSourceOutputSchema<
+	TContract,
+	TStateSchema extends z.ZodTypeAny,
+>(
+	contract: TContract,
+	stateSchema: TStateSchema,
+): z.ZodUnion<
+	[
+		z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>,
+		...z.ZodType<
+			unknown,
+			unknown,
+			z.core.$ZodTypeInternals<unknown, unknown>
+		>[],
+	]
+>;
 /**
- * Standard content types supported by the system.
- * Plugins can extend this with custom types.
+ * Contract-first source plugin interface following the Plugin pattern
  */
-export declare const ContentType: {
-    readonly POST: "post";
-    readonly ARTICLE: "article";
-    readonly VIDEO: "video";
-    readonly PODCAST: "podcast";
-    readonly WEBSITE: "website";
-    readonly FEED: "feed";
-    readonly DATABASE_ENTRY: "database-entry";
-    readonly UNKNOWN: "unknown";
-};
-export type ContentType = (typeof ContentType)[keyof typeof ContentType];
-/**
- * Represents a single author - derived from the authorSchema
- */
-export type Author = z.infer<typeof authorSchema>;
-/**
- * Base PluginSourceItem type derived from schema (with unknown raw type)
- */
-export type BasePluginSourceItem = z.infer<typeof pluginSourceItemSchema>;
-/**
- * This is the data structure a plugin is responsible for creating.
- * It's generic over the raw data type.
- */
-export interface PluginSourceItem<TRaw = Record<string, any>> extends Omit<BasePluginSourceItem, "raw"> {
-    raw: TRaw;
-}
-/**
- * This is the final, canonical data structure used within the system.
- * It extends PluginSourceItem with system-generated fields.
- */
-export interface SourceItem<TRaw = Record<string, any>> extends PluginSourceItem<TRaw> {
-    id: string;
-    createdAt: string;
-    metadata: {
-        sourcePlugin: string;
-        workflowId: string;
-        runId: string;
-        [key: string]: any;
-    };
-}
-/**
- * Defines the progress of a job submitted to an external asynchronous service (e.g., Masa).
- */
-export interface AsyncJobProgress {
-    workflowId: string;
-    status: "submitted" | "pending" | "processing" | "done" | "error" | "timeout";
-    submittedAt: string;
-    lastCheckedAt?: string;
-    errorMessage?: string;
-}
-export declare const AsyncJobProgressSchema: z.ZodObject<{
-    workflowId: z.ZodString;
-    status: z.ZodEnum<{
-        error: "error";
-        timeout: "timeout";
-        submitted: "submitted";
-        pending: "pending";
-        processing: "processing";
-        done: "done";
-    }>;
-    submittedAt: z.ZodString;
-    lastCheckedAt: z.ZodOptional<z.ZodString>;
-    errorMessage: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Generic platform-specific state for managing resumable searches and long-running jobs.
- */
-export interface PlatformState {
-    latestProcessedId?: string | number | Record<string, any>;
-    currentAsyncJob?: AsyncJobProgress | null;
-    [key: string]: any;
-}
-export declare const PlatformStateSchema: z.ZodObject<{
-    latestProcessedId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
-    currentAsyncJob: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        workflowId: z.ZodString;
-        status: z.ZodEnum<{
-            error: "error";
-            timeout: "timeout";
-            submitted: "submitted";
-            pending: "pending";
-            processing: "processing";
-            done: "done";
-        }>;
-        submittedAt: z.ZodString;
-        lastCheckedAt: z.ZodOptional<z.ZodString>;
-        errorMessage: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-}, z.core.$catchall<z.ZodAny>>;
-/**
- * State passed between search calls to enable resumption.
- * TData is expected to be an object conforming to PlatformState or a derivative.
- */
-export interface LastProcessedState<TData extends PlatformState = PlatformState> {
-    data: TData;
-}
-export type SourceConfig<V extends z.ZodTypeAny = z.ZodRecord<z.ZodString, z.ZodUnknown>, S extends z.ZodTypeAny = z.ZodRecord<z.ZodString, z.ZodUnknown>> = Config<V, S>;
-export interface SourceInput<TSearchOptions extends z.ZodTypeAny = z.ZodTypeAny> extends Input<z.ZodAny> {
-    searchOptions: TSearchOptions;
-    lastProcessedState?: LastProcessedState<PlatformState> | null;
-}
-export interface PluginSourceInput<TSearchOptions = Record<string, unknown>> extends Input<z.ZodAny> {
-    searchOptions: TSearchOptions;
-    lastProcessedState?: LastProcessedState<PlatformState> | null;
-}
-export interface PluginSourceOutputData<TItem extends PluginSourceItem = PluginSourceItem> {
-    items: TItem[];
-    nextLastProcessedState?: PlatformState | null;
-}
-export interface PluginSourceOutput<TItem extends PluginSourceItem = PluginSourceItem> extends Output<z.ZodAny> {
-    success: boolean;
-    data?: PluginSourceOutputData<TItem>;
-    errors?: Array<{
-        message: string;
-        details?: Record<string, unknown>;
-        stack?: string;
-    }>;
-}
-export interface SourceOutputData {
-    items: SourceItem[];
-    nextLastProcessedState?: PlatformState | null;
-}
-export interface SourceOutput extends Output<z.ZodAny> {
-    success: boolean;
-    data?: SourceOutputData;
-    errors?: Array<{
-        message: string;
-        details?: Record<string, unknown>;
-        stack?: string;
-    }>;
-}
-export interface SourcePlugin<TInputSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny, TConfigSchema extends z.ZodTypeAny = z.ZodTypeAny> extends Plugin<TInputSchema, TOutputSchema, TConfigSchema> {
-    readonly type: "source";
+export interface SourcePlugin<
+	TContract = Record<string, any>,
+	TConfigSchema extends z.ZodTypeAny = z.ZodTypeAny,
+	TStateSchema extends z.ZodTypeAny = z.ZodTypeAny,
+> {
+	readonly id: string;
+	readonly type: "source";
+	readonly contract: TContract;
+	readonly configSchema: TConfigSchema;
+	readonly stateSchema: TStateSchema;
+	readonly inputSchema: ReturnType<
+		typeof createSourceInputSchema<TContract, TStateSchema>
+	>;
+	readonly outputSchema: ReturnType<
+		typeof createSourceOutputSchema<TContract, TStateSchema>
+	>;
+	initialize(
+		config?: z.infer<TConfigSchema>,
+	): Effect.Effect<void, ConfigurationError, PluginLoggerTag>;
+	execute(
+		input: z.infer<this["inputSchema"]>,
+	): Effect.Effect<
+		z.infer<this["outputSchema"]>,
+		PluginExecutionError,
+		PluginLoggerTag
+	>;
+	shutdown(): Effect.Effect<void, never, PluginLoggerTag>;
+	createRouter(): any;
+	isStreamable(procedureName: string): boolean;
 }
-export declare const createSourceInputSchema: <TSearchOptions extends z.ZodTypeAny, TState extends z.ZodTypeAny>(searchOptionsSchema: TSearchOptions, stateSchema: TState) => z.ZodObject<{
-    searchOptions: TSearchOptions;
-    lastProcessedState: z.ZodNullable<z.ZodOptional<z.ZodObject<{
-        data: z.ZodNullable<z.ZodOptional<TState>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export declare const createSourceOutputSchema: <TItem extends z.ZodTypeAny, TState extends z.ZodTypeAny>(itemData: TItem, stateSchema: TState) => z.ZodObject<{
-    success: z.ZodBoolean;
-    data: z.ZodOptional<z.ZodObject<{
-        items: z.ZodArray<z.ZodObject<{
-            externalId: z.ZodString;
-            content: z.ZodString;
-            contentType: z.ZodOptional<z.ZodString>;
-            createdAt: z.ZodOptional<z.ZodString>;
-            url: z.ZodOptional<z.ZodString>;
-            authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                id: z.ZodOptional<z.ZodString>;
-                username: z.ZodOptional<z.ZodString>;
-                displayName: z.ZodOptional<z.ZodString>;
-                url: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            raw: TItem;
-        }, z.core.$strip>>;
-        nextLastProcessedState: z.ZodNullable<z.ZodOptional<TState>>;
-    }, z.core.$strip>>;
-    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>;
-//# sourceMappingURL=source.d.ts.map
+//# sourceMappingURL=source.d.ts.map

package/dist/source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG9D;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;iBAQjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAC3D,SAAQ,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC;IAEzC,GAAG,EAAE,IAAI,CAAC;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACrD,SAAQ,gBAAgB,CAAC,IAAI,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAGlB,QAAQ,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CAGtB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;iBAajC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAI7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAG1D,eAAe,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAG1C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACnB;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;8BAOb,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAClC,KAAK,SAAS,aAAa,GAAG,aAAa;IAG3C,IAAI,EAAE,KAAK,CAAC;CAKZ;AAGD,MAAM,MAAM,YAAY,CACvB,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,EAC/D,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,IAC5D,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEjB,MAAM,WAAW,WAAW,CAAC,cAAc,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAC9E,SAAQ,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACvB,aAAa,EAAE,cAAc,CAAC;IAC9B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,iBAAiB,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC1E,SAAQ,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACvB,aAAa,EAAE,cAAc,CAAC;IAC9B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,sBAAsB,CACtC,KAAK,SAAS,gBAAgB,GAAG,gBAAgB;IAEjD,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,sBAAsB,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9C;AAGD,MAAM,WAAW,kBAAkB,CAClC,KAAK,SAAS,gBAAgB,GAAG,gBAAgB,CAChD,SAAQ,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACH;AAGD,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,sBAAsB,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9C;AAGD,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,MAAM,CAAC,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACH;AAGD,MAAM,WAAW,YAAY,CAC5B,YAAY,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAChD,aAAa,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EACjD,aAAa,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAChD,SAAQ,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,aAAa,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACxB;AAGD,eAAO,MAAM,uBAAuB,GACnC,cAAc,SAAS,CAAC,CAAC,UAAU,EACnC,MAAM,SAAS,CAAC,CAAC,UAAU,EAE3B,qBAAqB,cAAc,EACnC,aAAa,MAAM;;;;;iBAUjB,CAAC;AAEJ,eAAO,MAAM,wBAAwB,GACpC,KAAK,SAAS,CAAC,CAAC,UAAU,EAC1B,MAAM,SAAS,CAAC,CAAC,UAAU,EAE3B,UAAU,KAAK,EACf,aAAa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;iBAsBnB,CAAC"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EACT,YAAY,SAAS,CAAC,CAAC,UAAU,EAEjC,QAAQ,EAAE,SAAS,EACnB,WAAW,EAAE,YAAY,iHAwBzB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EACT,YAAY,SAAS,CAAC,CAAC,UAAU,EAEjC,QAAQ,EAAE,SAAS,EACnB,WAAW,EAAE,YAAY,uKAWzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAC5B,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,aAAa,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EACjD,YAAY,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAEhD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAC1F,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAE5F,UAAU,CACT,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;IAE5D,OAAO,CACN,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,GACjC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,oBAAoB,EAAE,eAAe,CAAC,CAAC;IAEvF,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;IAExD,YAAY,IAAI,GAAG,CAAC;IAEpB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C"}

package/dist/source.js

@@ -1,90 +1,37 @@
 import { z } from "zod";
-import { ErrorDetailsSchema } from "./plugin";
 /**
- * Zod schema for the Author interface
+ * Source-specific schema creators for contract-based plugins
  */
-export const authorSchema = z.object({
-    id: z.string().optional(),
-    username: z.string().optional(),
-    displayName: z.string().optional(),
-    url: z.string().optional(),
-});
+export function createSourceInputSchema(contract, stateSchema) {
+	const contractEntries = Object.entries(contract);
+	const procedureSchemas = contractEntries.map(
+		([procedureName, procedureSpec]) => {
+			// Extract input and output schemas from oRPC contract procedure
+			const inputSchema = procedureSpec["~orpc"]?.inputSchema || z.object({});
+			const outputSchema = procedureSpec["~orpc"]?.outputSchema || z.object({});
+			// Check if this procedure is streamable (has nextState in output)
+			const isStreamable = outputSchema._def?.shape?.nextState !== undefined;
+			const baseSchema = z.object({
+				procedure: z.literal(procedureName),
+				input: inputSchema,
+			});
+			// Only add state field for streamable procedures
+			return isStreamable
+				? baseSchema.extend({ state: stateSchema })
+				: baseSchema;
+		},
+	);
+	return z.discriminatedUnion("procedure", procedureSchemas);
+}
 /**
- * Zod schema for PluginSourceItem - defines the structure that plugins must return
+ * Contract-based output schema creator that infers from oRPC contract
  */
-export const pluginSourceItemSchema = z.object({
-    externalId: z.string(),
-    content: z.string(),
-    contentType: z.string().optional(),
-    createdAt: z.string().optional(),
-    url: z.string().optional(),
-    authors: z.array(authorSchema).optional(),
-    raw: z.unknown(),
-});
-/**
- * Standard content types supported by the system.
- * Plugins can extend this with custom types.
- */
-export const ContentType = {
-    POST: "post",
-    ARTICLE: "article",
-    VIDEO: "video",
-    PODCAST: "podcast",
-    WEBSITE: "website",
-    FEED: "feed",
-    DATABASE_ENTRY: "database-entry",
-    UNKNOWN: "unknown",
-};
-export const AsyncJobProgressSchema = z.object({
-    workflowId: z.string(),
-    status: z.enum([
-        "submitted",
-        "pending",
-        "processing",
-        "done",
-        "error",
-        "timeout",
-    ]),
-    submittedAt: z.string(), // ISO timestamp
-    lastCheckedAt: z.string().optional(), // ISO timestamp
-    errorMessage: z.string().optional(),
-});
-export const PlatformStateSchema = z
-    .object({
-    latestProcessedId: z
-        .union([z.string(), z.number(), z.record(z.string(), z.any())])
-        .optional(),
-    currentAsyncJob: AsyncJobProgressSchema.nullable().optional(),
-})
-    .catchall(z.any());
-// Source-specific schema creators
-export const createSourceInputSchema = (searchOptionsSchema, stateSchema) => z.object({
-    searchOptions: searchOptionsSchema,
-    lastProcessedState: z
-        .object({
-        data: stateSchema.optional().nullable(),
-    })
-        .optional()
-        .nullable(),
-});
-export const createSourceOutputSchema = (itemData, stateSchema) => {
-    const pluginSourceItemSchema = z.object({
-        externalId: z.string(),
-        content: z.string(),
-        contentType: z.string().optional(),
-        createdAt: z.string().optional(),
-        url: z.string().optional(),
-        authors: z.array(authorSchema).optional(),
-        raw: itemData,
-    });
-    return z.object({
-        success: z.boolean(),
-        data: z
-            .object({
-            items: z.array(pluginSourceItemSchema),
-            nextLastProcessedState: stateSchema.optional().nullable(),
-        })
-            .optional(),
-        errors: z.array(ErrorDetailsSchema).optional(),
-    });
-};
+export function createSourceOutputSchema(contract, stateSchema) {
+	const contractEntries = Object.entries(contract);
+	const procedureOutputSchemas = contractEntries.map(([_, procedureSpec]) => {
+		// Extract output schema from oRPC contract procedure
+		return procedureSpec["~orpc"]?.outputSchema || z.object({});
+	});
+	// Return union of all procedure output schemas
+	return z.union(procedureOutputSchemas);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "every-plugin",
-	"version": "0.0.6",
+	"version": "0.1.0",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"exports": {
@@ -24,12 +24,16 @@
 		"effect": ">=3.17.0 <4.0.0",
 		"zod": ">=4.0.0",
 		"@module-federation/enhanced": ">=0.18.0",
-		"@module-federation/runtime-core": ">=0.18.0"
+		"@module-federation/runtime-core": ">=0.18.0",
+		"@orpc/server": ">=0.0.1"
 	},
 	"devDependencies": {
 		"@effect/vitest": "^0.25.1",
 		"@module-federation/enhanced": "^0.18.3",
 		"@module-federation/runtime-core": "^0.18.3",
+		"@types/bun": "^1.2.21",
+		"@vitest/ui": "3.2.4",
+		"bun-types": "^1.2.21",
 		"effect": "^3.17.7",
 		"typescript": "^5.0.0",
 		"vitest": "^3.2.4",
@@ -37,6 +41,6 @@
 	},
 	"dependencies": {
 		"@better-fetch/fetch": "^1.1.18",
-		"ajv": "^8.17.1"
+		"@orpc/contract": "^1.8.6"
 	}
 }

package/dist/runtime/runtime.d.ts

@@ -1,58 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,75 +0,0 @@
-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/services/plugin-cache.service.d.ts

@@ -1,18 +0,0 @@
-import { Effect, Layer } from "effect";
-import { PluginRuntimeError } from "../errors";
-import type { PluginConstructor } from "../types";
-import { ModuleFederationService } from "./module-federation.service";
-export interface IPluginCacheService {
-    readonly getCachedConstructor: (cacheKey: string) => Effect.Effect<PluginConstructor, PluginRuntimeError>;
-    readonly invalidate: (cacheKey: string) => Effect.Effect<void>;
-}
-declare const PluginCacheService_base: import("effect/Context").TagClass<PluginCacheService, "PluginCacheService", IPluginCacheService> & Effect.Tag.Proxy<PluginCacheService, IPluginCacheService> & {
-    use: <X>(body: (_: IPluginCacheService) => X) => [X] extends [Effect.Effect<infer A, infer E, infer R>] ? Effect.Effect<A, E, R | PluginCacheService> : [X] extends [PromiseLike<infer A_1>] ? Effect.Effect<A_1, import("effect/Cause").UnknownException, PluginCacheService> : Effect.Effect<X, never, PluginCacheService>;
-};
-export declare class PluginCacheService extends PluginCacheService_base {
-    static Live: Layer.Layer<PluginCacheService, never, ModuleFederationService>;
-}
-export declare const PluginCacheServiceTag: typeof PluginCacheService;
-export declare const PluginCacheServiceLive: Layer.Layer<PluginCacheService, never, ModuleFederationService>;
-export {};
-//# sourceMappingURL=plugin-cache.service.d.ts.map

package/dist/runtime/services/plugin-cache.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-cache.service.d.ts","sourceRoot":"","sources":["../../../src/runtime/services/plugin-cache.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAChE;;;;AAED,qBAAa,kBAAmB,SAAQ,uBAGrC;IACD,MAAM,CAAC,IAAI,kEAoET;CACH;AAED,eAAO,MAAM,qBAAqB,2BAAqB,CAAC;AACxD,eAAO,MAAM,sBAAsB,iEAA0B,CAAC"}

package/dist/runtime/services/plugin-cache.service.js

@@ -1,55 +0,0 @@
-import { Cache, Duration, Effect, Layer } from "effect";
-import { PluginRuntimeError } from "../errors";
-import { ModuleFederationService } from "./module-federation.service";
-export class PluginCacheService extends Effect.Tag("PluginCacheService")() {
-    static Live = Layer.effect(PluginCacheService, Effect.gen(function* () {
-        const mfService = yield* ModuleFederationService;
-        const cache = yield* Cache.make({
-            capacity: 50,
-            timeToLive: Duration.minutes(30),
-            lookup: (cacheKey) => {
-                // Parse cache key: "pluginId:url"
-                const colonIndex = cacheKey.indexOf(":");
-                if (colonIndex === -1) {
-                    return Effect.fail(new PluginRuntimeError({
-                        pluginId: cacheKey,
-                        operation: "cache-lookup",
-                        cause: new Error(`Invalid cache key format: ${cacheKey}`),
-                        retryable: false,
-                    }));
-                }
-                const pluginId = cacheKey.substring(0, colonIndex);
-                const url = cacheKey.substring(colonIndex + 1);
-                return Effect.gen(function* () {
-                    yield* mfService.registerRemote(pluginId, url).pipe(Effect.mapError((mfError) => new PluginRuntimeError({
-                        pluginId,
-                        operation: "register-remote",
-                        cause: mfError.cause,
-                        retryable: true,
-                    })));
-                    const ctor = yield* mfService.loadRemoteConstructor(pluginId, url).pipe(Effect.mapError((mfError) => new PluginRuntimeError({
-                        pluginId,
-                        operation: "load-remote",
-                        cause: mfError.cause,
-                        retryable: true,
-                    })));
-                    return {
-                        ctor,
-                        metadata: {
-                            pluginId,
-                            version: "unknown", // Will be resolved from registry
-                            description: "Loaded from remote",
-                            type: "unknown",
-                        },
-                    };
-                });
-            },
-        });
-        return {
-            getCachedConstructor: (cacheKey) => cache.get(cacheKey),
-            invalidate: (cacheKey) => cache.invalidate(cacheKey),
-        };
-    }));
-}
-export const PluginCacheServiceTag = PluginCacheService;
-export const PluginCacheServiceLive = PluginCacheService.Live;