@ashdev/codex-plugin-sdk 1.18.1 → 1.19.1

package/dist/host-rpc.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Generic host reverse-RPC client.
+ *
+ * Plugins use this to call host methods outside the storage namespace —
+ * notably `releases/list_tracked`, `releases/record`,
+ * `releases/source_state/get`, and `releases/source_state/set`. The class is
+ * intentionally generic so future reverse-RPC namespaces can reuse it
+ * without a per-namespace client.
+ *
+ * Wire-format and lifecycle mirror `PluginStorage`: send a JSON-RPC request
+ * over stdout with a unique id, and resolve when the host's response with
+ * the matching id arrives on stdin. The plugin server's main loop calls
+ * `handleResponse(line)` on every incoming response; whichever client owns
+ * the id resolves it (others no-op silently).
+ *
+ * The id counter starts at a high value (`1_000_000_000`) so it can never
+ * collide with `PluginStorage`'s sequence (`1, 2, 3, ...`). This means the
+ * dispatch in the server doesn't need to know which client a response
+ * belongs to — it can fan out to both, and at most one will match.
+ */
+/** Write function signature for sending JSON-RPC requests. */
+type WriteFn = (line: string) => void;
+/**
+ * Error thrown when a reverse-RPC call fails (host returned a JSON-RPC error,
+ * or the client was canceled).
+ */
+export declare class HostRpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown | undefined;
+    constructor(message: string, code: number, data?: unknown | undefined);
+}
+/**
+ * Generic reverse-RPC client. Construct one per plugin instance and pass it
+ * around via `InitializeParams`.
+ */
+export declare class HostRpcClient {
+    private nextId;
+    private pendingRequests;
+    private writeFn;
+    /**
+     * @param writeFn - Optional custom write function (defaults to
+     *   `process.stdout.write`). Useful for testing.
+     */
+    constructor(writeFn?: WriteFn);
+    /**
+     * Send a JSON-RPC request to the host and resolve with the result.
+     *
+     * @param method - JSON-RPC method name (e.g. `"releases/list_tracked"`).
+     * @param params - Method-specific params. Pass `undefined` when the method
+     *   takes no params.
+     */
+    call<T = unknown>(method: string, params?: unknown): Promise<T>;
+    /**
+     * Process an incoming JSON-RPC response line. Returns `true` if this
+     * client owned the response id and resolved it, `false` otherwise (so
+     * other clients can try).
+     *
+     * Called by the plugin server's main loop on every response.
+     */
+    handleResponse(line: string): boolean;
+    /** Reject all pending requests (e.g. on shutdown). */
+    cancelAll(): void;
+}
+export {};
+//# sourceMappingURL=host-rpc.d.ts.map

package/dist/host-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-rpc.d.ts","sourceRoot":"","sources":["../src/host-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,8DAA8D;AAC9D,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtC;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;aACZ,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC;AAED;;;GAGG;AACH,qBAAa,aAAa;IAKxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,eAAe,CAMnB;IACJ,OAAO,CAAC,OAAO,CAAU;IAEzB;;;OAGG;gBACS,OAAO,CAAC,EAAE,OAAO;IAQ7B;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IA8BrE;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IA8BrC,sDAAsD;IACtD,SAAS,IAAI,IAAI;CAMlB"}

package/dist/host-rpc.js

@@ -0,0 +1,142 @@
+/**
+ * Generic host reverse-RPC client.
+ *
+ * Plugins use this to call host methods outside the storage namespace —
+ * notably `releases/list_tracked`, `releases/record`,
+ * `releases/source_state/get`, and `releases/source_state/set`. The class is
+ * intentionally generic so future reverse-RPC namespaces can reuse it
+ * without a per-namespace client.
+ *
+ * Wire-format and lifecycle mirror `PluginStorage`: send a JSON-RPC request
+ * over stdout with a unique id, and resolve when the host's response with
+ * the matching id arrives on stdin. The plugin server's main loop calls
+ * `handleResponse(line)` on every incoming response; whichever client owns
+ * the id resolves it (others no-op silently).
+ *
+ * The id counter starts at a high value (`1_000_000_000`) so it can never
+ * collide with `PluginStorage`'s sequence (`1, 2, 3, ...`). This means the
+ * dispatch in the server doesn't need to know which client a response
+ * belongs to — it can fan out to both, and at most one will match.
+ */
+import { currentParentRequestId } from "./request-context.js";
+/**
+ * Error thrown when a reverse-RPC call fails (host returned a JSON-RPC error,
+ * or the client was canceled).
+ */
+export class HostRpcError extends Error {
+    code;
+    data;
+    constructor(message, code, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = "HostRpcError";
+    }
+}
+/**
+ * Generic reverse-RPC client. Construct one per plugin instance and pass it
+ * around via `InitializeParams`.
+ */
+export class HostRpcClient {
+    // Start the counter high so it can't collide with PluginStorage's id space.
+    // `Number.MAX_SAFE_INTEGER` is far above this, so we have plenty of room
+    // before wrapping (and we never expect a single plugin lifetime to issue
+    // more than ~9 quintillion calls).
+    nextId = 1_000_000_000;
+    pendingRequests = new Map();
+    writeFn;
+    /**
+     * @param writeFn - Optional custom write function (defaults to
+     *   `process.stdout.write`). Useful for testing.
+     */
+    constructor(writeFn) {
+        this.writeFn =
+            writeFn ??
+                ((line) => {
+                    process.stdout.write(line);
+                });
+    }
+    /**
+     * Send a JSON-RPC request to the host and resolve with the result.
+     *
+     * @param method - JSON-RPC method name (e.g. `"releases/list_tracked"`).
+     * @param params - Method-specific params. Pass `undefined` when the method
+     *   takes no params.
+     */
+    async call(method, params) {
+        const id = this.nextId++;
+        // Stamp the forward call we're inside so the host can route this
+        // reverse-RPC back to the originating caller's task. Lifted from the
+        // `request-context` async-local storage that `server.ts` sets around
+        // every forward-request handler.
+        const parent = currentParentRequestId();
+        const request = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            params,
+            ...(parent !== undefined ? { parentRequestId: parent } : {}),
+        };
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, {
+                resolve: (v) => resolve(v),
+                reject,
+            });
+            try {
+                this.writeFn(`${JSON.stringify(request)}\n`);
+            }
+            catch (err) {
+                this.pendingRequests.delete(id);
+                const message = err instanceof Error ? err.message : "Unknown write error";
+                reject(new HostRpcError(`Failed to send request: ${message}`, -1));
+            }
+        });
+    }
+    /**
+     * Process an incoming JSON-RPC response line. Returns `true` if this
+     * client owned the response id and resolved it, `false` otherwise (so
+     * other clients can try).
+     *
+     * Called by the plugin server's main loop on every response.
+     */
+    handleResponse(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return false;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            return false;
+        }
+        const obj = parsed;
+        if (obj.method !== undefined)
+            return false; // not a response
+        const rawId = obj.id;
+        if (typeof rawId !== "number")
+            return false;
+        if (!this.pendingRequests.has(rawId))
+            return false;
+        const pending = this.pendingRequests.get(rawId);
+        if (!pending)
+            return false;
+        this.pendingRequests.delete(rawId);
+        if ("error" in obj && obj.error) {
+            const err = obj.error;
+            pending.reject(new HostRpcError(err.message, err.code, err.data));
+        }
+        else {
+            pending.resolve(obj.result);
+        }
+        return true;
+    }
+    /** Reject all pending requests (e.g. on shutdown). */
+    cancelAll() {
+        for (const [, pending] of this.pendingRequests) {
+            pending.reject(new HostRpcError("Host RPC client stopped", -1));
+        }
+        this.pendingRequests.clear();
+    }
+}
+//# sourceMappingURL=host-rpc.js.map

package/dist/host-rpc.js.map

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

package/dist/index.d.ts

@@ -53,8 +53,9 @@
  * @packageDocumentation
  */
 export { ApiError, AuthError, ConfigError, NotFoundError, PluginError, RateLimitError, } from "./errors.js";
+export { HostRpcClient, HostRpcError } from "./host-rpc.js";
 export { createLogger, Logger, type LoggerOptions, type LogLevel } from "./logger.js";
-export { createMetadataPlugin, createRecommendationPlugin, createSyncPlugin, type InitializeParams, type MetadataPluginOptions, type RecommendationPluginOptions, type SyncPluginOptions, } from "./server.js";
+export { createMetadataPlugin, createRecommendationPlugin, createReleaseSourcePlugin, createSyncPlugin, type InitializeParams, type MetadataPluginOptions, type RecommendationPluginOptions, type ReleaseSourcePluginOptions, type SyncPluginOptions, } from "./server.js";
 export { PluginStorage, type StorageClearResponse, type StorageDeleteResponse, StorageError, type StorageGetResponse, type StorageKeyEntry, type StorageListResponse, type StorageSetResponse, } from "./storage.js";
 export * from "./types/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGtF,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AAGtB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGtF,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AAGtB,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -54,10 +54,12 @@
  */
 // Errors
 export { ApiError, AuthError, ConfigError, NotFoundError, PluginError, RateLimitError, } from "./errors.js";
+// Host RPC (generic reverse-RPC client for non-storage host methods)
+export { HostRpcClient, HostRpcError } from "./host-rpc.js";
 // Logger
 export { createLogger, Logger } from "./logger.js";
 // Server
-export { createMetadataPlugin, createRecommendationPlugin, createSyncPlugin, } from "./server.js";
+export { createMetadataPlugin, createRecommendationPlugin, createReleaseSourcePlugin, createSyncPlugin, } from "./server.js";
 // Storage
 export { PluginStorage, StorageError, } from "./storage.js";
 // Types (all types re-exported from barrel)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,SAAS;AACT,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,EAAqC,MAAM,aAAa,CAAC;AAEtF,SAAS;AACT,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,gBAAgB,GAKjB,MAAM,aAAa,CAAC;AAErB,UAAU;AACV,OAAO,EACL,aAAa,EAGb,YAAY,GAKb,MAAM,cAAc,CAAC;AAEtB,4CAA4C;AAC5C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,SAAS;AACT,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,qEAAqE;AACrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE5D,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,EAAqC,MAAM,aAAa,CAAC;AAEtF,SAAS;AACT,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,GAMjB,MAAM,aAAa,CAAC;AAErB,UAAU;AACV,OAAO,EACL,aAAa,EAGb,YAAY,GAKb,MAAM,cAAc,CAAC;AAEtB,4CAA4C;AAC5C,cAAc,kBAAkB,CAAC"}

package/dist/request-context.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Async-local context for the currently-handled forward request.
+ *
+ * When the SDK dispatches a forward call (e.g. `releases/poll`), it stores
+ * the call's `id` in this context for the duration of the handler. Any
+ * reverse-RPC the plugin makes while servicing that call (e.g.
+ * `releases/record` via `HostRpcClient.call`) reads the id and stamps it as
+ * `parentRequestId` on the outgoing request.
+ *
+ * The host uses `parentRequestId` to route the reverse-RPC back to the
+ * originating caller's tokio task, so emitted events land in the recording
+ * broadcaster scoped to that task and replay correctly in distributed
+ * deployments. Without this stamping, plugins that emit events via
+ * reverse-RPC would silently lose them on the worker.
+ *
+ * Plugin authors don't interact with this directly. The SDK's request
+ * dispatch (`server.ts`) sets it; `HostRpcClient.call` reads it.
+ */
+/**
+ * Run `fn` with `forwardRequestId` as the current parent. Calls to
+ * `currentParentRequestId()` made inside `fn` (or anything it awaits) will
+ * see this value.
+ */
+export declare function runWithParentRequestId<T>(forwardRequestId: string | number | null, fn: () => Promise<T>): Promise<T>;
+/**
+ * Snapshot the current forward request id, or `undefined` if no forward
+ * request is on the call stack (e.g. background timers in the plugin that
+ * fire reverse-RPCs outside a forward-call context — those won't be replay-
+ * eligible, by design, since they don't belong to any task).
+ */
+export declare function currentParentRequestId(): string | number | null | undefined;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EACxC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAE3E"}

package/dist/request-context.js

@@ -0,0 +1,38 @@
+/**
+ * Async-local context for the currently-handled forward request.
+ *
+ * When the SDK dispatches a forward call (e.g. `releases/poll`), it stores
+ * the call's `id` in this context for the duration of the handler. Any
+ * reverse-RPC the plugin makes while servicing that call (e.g.
+ * `releases/record` via `HostRpcClient.call`) reads the id and stamps it as
+ * `parentRequestId` on the outgoing request.
+ *
+ * The host uses `parentRequestId` to route the reverse-RPC back to the
+ * originating caller's tokio task, so emitted events land in the recording
+ * broadcaster scoped to that task and replay correctly in distributed
+ * deployments. Without this stamping, plugins that emit events via
+ * reverse-RPC would silently lose them on the worker.
+ *
+ * Plugin authors don't interact with this directly. The SDK's request
+ * dispatch (`server.ts`) sets it; `HostRpcClient.call` reads it.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+const store = new AsyncLocalStorage();
+/**
+ * Run `fn` with `forwardRequestId` as the current parent. Calls to
+ * `currentParentRequestId()` made inside `fn` (or anything it awaits) will
+ * see this value.
+ */
+export function runWithParentRequestId(forwardRequestId, fn) {
+    return store.run(forwardRequestId, fn);
+}
+/**
+ * Snapshot the current forward request id, or `undefined` if no forward
+ * request is on the call stack (e.g. background timers in the plugin that
+ * fire reverse-RPCs outside a forward-call context — those won't be replay-
+ * eligible, by design, since they don't belong to any task).
+ */
+export function currentParentRequestId() {
+    return store.getStore();
+}
+//# sourceMappingURL=request-context.js.map

package/dist/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAA0B,CAAC;AAE9D;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,gBAAwC,EACxC,EAAoB;IAEpB,OAAO,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/server.d.ts

@@ -9,9 +9,10 @@
  *
  * Each plugin type adds its own method routing on top.
  */
+import { HostRpcClient } from "./host-rpc.js";
 import { PluginStorage } from "./storage.js";
-import type { BookMetadataProvider, MetadataContentType, MetadataProvider, RecommendationProvider, SyncProvider } from "./types/capabilities.js";
-import type { PluginManifest } from "./types/manifest.js";
+import type { BookMetadataProvider, MetadataContentType, MetadataProvider, RecommendationProvider, ReleaseSourceProvider, SyncProvider } from "./types/capabilities.js";
+import type { PluginManifest, ReleaseSourceCapability } from "./types/manifest.js";
 /**
  * Initialize parameters received from Codex
  */
@@ -30,6 +31,15 @@ export interface InitializeParams {
      * instance — the host resolves the user context automatically.
      */
     storage: PluginStorage;
+    /**
+     * Generic host reverse-RPC client.
+     *
+     * Use this to call host methods outside the storage namespace, notably
+     * the `releases/*` methods (`releases/list_tracked`, `releases/record`,
+     * `releases/source_state/get`, `releases/source_state/set`) for plugins
+     * declaring the `releaseSource` capability.
+     */
+    hostRpc: HostRpcClient;
 }
 /**
  * Options for creating a metadata plugin
@@ -178,4 +188,54 @@ export interface RecommendationPluginOptions {
  * for recommendation operations (get recommendations, update profile, dismiss).
  */
 export declare function createRecommendationPlugin(options: RecommendationPluginOptions): void;
+/**
+ * Options for creating a release-source plugin.
+ */
+export interface ReleaseSourcePluginOptions {
+    /** Plugin manifest. Must declare `capabilities.releaseSource`. */
+    manifest: PluginManifest & {
+        capabilities: {
+            releaseSource: ReleaseSourceCapability;
+        };
+    };
+    /** ReleaseSourceProvider implementation. */
+    provider: ReleaseSourceProvider;
+    /** Called when plugin receives initialize with credentials/config. */
+    onInitialize?: (params: InitializeParams) => void | Promise<void>;
+    /** Log level (default: "info"). */
+    logLevel?: "debug" | "info" | "warn" | "error";
+}
+/**
+ * Create and run a release-source plugin.
+ *
+ * The host calls `releases/poll` on a schedule (per `release_sources` row).
+ * The plugin returns candidates either inline (in the poll response) or by
+ * streaming `releases/record` reverse-RPC calls during the poll. Both styles
+ * are supported by the host.
+ *
+ * Plugins typically:
+ *   1. Fetch tracked series via `releases/list_tracked`.
+ *   2. For each series, GET the upstream feed (with `If-None-Match` from the
+ *      previous ETag).
+ *   3. Parse + filter (language, group blocklist, etc.).
+ *   4. Either return all candidates in the poll response or call
+ *      `releases/record` for each.
+ *   5. Persist the new ETag via `releases/source_state/set` (or include it on
+ *      the poll response).
+ *
+ * @example
+ * ```typescript
+ * import { createReleaseSourcePlugin, type ReleaseSourceProvider } from "@ashdev/codex-plugin-sdk";
+ *
+ * const provider: ReleaseSourceProvider = {
+ *   async poll({ sourceId, etag }) {
+ *     // ...fetch + parse...
+ *     return { candidates: [...], etag: "new-etag" };
+ *   },
+ * };
+ *
+ * createReleaseSourcePlugin({ manifest, provider });
+ * ```
+ */
+export declare function createReleaseSourcePlugin(options: ReleaseSourcePluginOptions): void;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA0H1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,OAAO,EAAE,aAAa,CAAC;CACxB;AAkOD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mFAAmF;IACnF,QAAQ,EAAE,cAAc,GAAG;QACzB,YAAY,EAAE;YAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAA;SAAE,CAAC;KAC3D,CAAC;IACF,wFAAwF;IACxF,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,oFAAoF;IACpF,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,qEAAqE;IACrE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAmEzE;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,QAAQ,EAAE,cAAc,GAAG;QACzB,YAAY,EAAE;YAAE,YAAY,EAAE,IAAI,CAAA;SAAE,CAAC;KACtC,CAAC;IACF,kCAAkC;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAqBjE;AAMD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,QAAQ,EAAE,cAAc,GAAG;QACzB,YAAY,EAAE;YAAE,0BAA0B,EAAE,IAAI,CAAA;SAAE,CAAC;KACpD,CAAC;IACF,4CAA4C;IAC5C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,qEAAqE;IACrE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CA8BrF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -11,7 +11,9 @@
  */
 import { createInterface } from "node:readline";
 import { PluginError } from "./errors.js";
+import { HostRpcClient } from "./host-rpc.js";
 import { createLogger } from "./logger.js";
+import { runWithParentRequestId } from "./request-context.js";
 import { PluginStorage } from "./storage.js";
 import { JSON_RPC_ERROR_CODES } from "./types/rpc.js";
 /**
@@ -106,17 +108,19 @@ function createPluginServer(options) {
     const logger = createLogger({ name: manifest.name, level: logLevel });
     const prefix = label ? `${label} plugin` : "plugin";
     const storage = new PluginStorage();
+    const hostRpc = new HostRpcClient();
     logger.info(`Starting ${prefix}: ${manifest.displayName} v${manifest.version}`);
     const rl = createInterface({
         input: process.stdin,
         terminal: false,
     });
     rl.on("line", (line) => {
-        void handleLine(line, manifest, onInitialize, router, logger, storage);
+        void handleLine(line, manifest, onInitialize, router, logger, storage, hostRpc);
     });
     rl.on("close", () => {
         logger.info("stdin closed, shutting down");
         storage.cancelAll();
+        hostRpc.cancelAll();
         process.exit(0);
     });
     process.on("uncaughtException", (error) => {
@@ -140,13 +144,14 @@ function isJsonRpcResponse(obj) {
         return false;
     return "result" in obj || "error" in obj;
 }
-async function handleLine(line, manifest, onInitialize, router, logger, storage) {
+async function handleLine(line, manifest, onInitialize, router, logger, storage, hostRpc) {
     const trimmed = line.trim();
     if (!trimmed)
         return;
-    // Try to detect storage responses before full request handling.
-    // Storage responses come from the host on stdin — they have id + (result|error)
-    // but no method field.
+    // Try to detect responses (storage or host-rpc) before full request handling.
+    // Both come from the host on stdin — they have id + (result|error) but no
+    // method field. The two clients use disjoint id ranges so each can claim
+    // ownership without coordination; whichever owns the id resolves it.
     let parsed;
     try {
         parsed = JSON.parse(trimmed);
@@ -155,8 +160,10 @@ async function handleLine(line, manifest, onInitialize, router, logger, storage)
         // Will be handled as a parse error below
     }
     if (parsed && isJsonRpcResponse(parsed)) {
-        logger.debug("Routing storage response", { id: parsed.id });
-        storage.handleResponse(trimmed);
+        logger.debug("Routing reverse-RPC response", { id: parsed.id });
+        if (!hostRpc.handleResponse(trimmed)) {
+            storage.handleResponse(trimmed);
+        }
         return;
     }
     let id = null;
@@ -164,7 +171,11 @@ async function handleLine(line, manifest, onInitialize, router, logger, storage)
         const request = (parsed ?? JSON.parse(trimmed));
         id = request.id;
         logger.debug(`Received request: ${request.method}`, { id: request.id });
-        const response = await handleRequest(request, manifest, onInitialize, router, logger, storage);
+        // Run the request handler inside the parent-request async-local context.
+        // Reverse-RPCs the handler issues via `HostRpcClient.call` will read this
+        // and stamp `parentRequestId` so the host can route the call back to the
+        // originating task. See `request-context.ts`.
+        const response = await runWithParentRequestId(request.id, () => handleRequest(request, manifest, onInitialize, router, logger, storage, hostRpc));
         if (response !== null) {
             writeResponse(response);
         }
@@ -201,14 +212,16 @@ async function handleLine(line, manifest, onInitialize, router, logger, storage)
         }
     }
 }
-async function handleRequest(request, manifest, onInitialize, router, logger, storage) {
+async function handleRequest(request, manifest, onInitialize, router, logger, storage, hostRpc) {
     const { method, params, id } = request;
     // Common lifecycle methods
     switch (method) {
         case "initialize": {
             const initParams = (params ?? {});
-            // Inject the storage client so plugins can persist data
+            // Inject the reverse-RPC clients so plugins can persist data and
+            // call host-side methods (e.g. releases/list_tracked).
             initParams.storage = storage;
+            initParams.hostRpc = hostRpc;
             if (onInitialize) {
                 await onInitialize(initParams);
             }
@@ -219,6 +232,7 @@ async function handleRequest(request, manifest, onInitialize, router, logger, st
         case "shutdown": {
             logger.info("Shutdown requested");
             storage.cancelAll();
+            hostRpc.cancelAll();
             const response = { jsonrpc: "2.0", id, result: null };
             process.stdout.write(`${JSON.stringify(response)}\n`, () => {
                 process.exit(0);
@@ -475,4 +489,65 @@ export function createRecommendationPlugin(options) {
     };
     createPluginServer({ manifest, onInitialize, logLevel, label: "recommendation", router });
 }
+// =============================================================================
+// Release Source Plugin
+// =============================================================================
+/**
+ * Validate `releases/poll` parameters. Requires a non-empty `sourceId` string;
+ * `etag` is optional.
+ */
+function validateReleasePollParams(params) {
+    return validateStringFields(params, ["sourceId"]);
+}
+/**
+ * Create and run a release-source plugin.
+ *
+ * The host calls `releases/poll` on a schedule (per `release_sources` row).
+ * The plugin returns candidates either inline (in the poll response) or by
+ * streaming `releases/record` reverse-RPC calls during the poll. Both styles
+ * are supported by the host.
+ *
+ * Plugins typically:
+ *   1. Fetch tracked series via `releases/list_tracked`.
+ *   2. For each series, GET the upstream feed (with `If-None-Match` from the
+ *      previous ETag).
+ *   3. Parse + filter (language, group blocklist, etc.).
+ *   4. Either return all candidates in the poll response or call
+ *      `releases/record` for each.
+ *   5. Persist the new ETag via `releases/source_state/set` (or include it on
+ *      the poll response).
+ *
+ * @example
+ * ```typescript
+ * import { createReleaseSourcePlugin, type ReleaseSourceProvider } from "@ashdev/codex-plugin-sdk";
+ *
+ * const provider: ReleaseSourceProvider = {
+ *   async poll({ sourceId, etag }) {
+ *     // ...fetch + parse...
+ *     return { candidates: [...], etag: "new-etag" };
+ *   },
+ * };
+ *
+ * createReleaseSourcePlugin({ manifest, provider });
+ * ```
+ */
+export function createReleaseSourcePlugin(options) {
+    const { manifest, provider, onInitialize, logLevel } = options;
+    if (!manifest.capabilities.releaseSource) {
+        throw new Error("manifest.capabilities.releaseSource is required for createReleaseSourcePlugin");
+    }
+    const router = async (method, params, id) => {
+        switch (method) {
+            case "releases/poll": {
+                const err = validateReleasePollParams(params);
+                if (err)
+                    return invalidParamsError(id, err);
+                return success(id, await provider.poll(params));
+            }
+            default:
+                return null;
+        }
+    };
+    createPluginServer({ manifest, onInitialize, logLevel, label: "release-source", router });
+}
 //# sourceMappingURL=server.js.map