@mulmoclaude/core 0.2.0 → 0.2.5

package/dist/feeds/server/host.d.ts

@@ -0,0 +1,51 @@
+/** Outcome of launching one hidden/visible agent-ingest worker. `chatId` lets
+ *  the caller register a completion hook so a failed refresh doesn't die
+ *  silently. */
+export type AgentWorkerResult = {
+    ok: true;
+    chatId: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** Launches a worker chat. Injected at boot to keep the feeds engine from
+ *  importing a host's routes/session layer. `hidden` chooses an invisible
+ *  system worker (scheduled refresh) vs a visible session the user can watch
+ *  (manual Refresh — debuggable). `onComplete` is a one-shot completion hook
+ *  (only honoured for hidden workers) so the dispatcher learns success/failure.
+ *  Returns `ok:false` on the concurrency-cap miss or a launch error — the caller
+ *  leaves state untouched and retries next tick. */
+export type AgentWorkerRunner = (args: {
+    message: string;
+    roleId: string;
+    hidden: boolean;
+    onComplete?: (outcome: {
+        didError: boolean;
+    }) => void | Promise<void>;
+}) => Promise<AgentWorkerResult>;
+/** Structured logger, `(prefix, msg, data?)` — same shape as `CollectionLogger`. */
+export interface FeedsLogger {
+    error: (prefix: string, message: string, data?: Record<string, unknown>) => void;
+    warn: (prefix: string, message: string, data?: Record<string, unknown>) => void;
+    info: (prefix: string, message: string, data?: Record<string, unknown>) => void;
+    debug: (prefix: string, message: string, data?: Record<string, unknown>) => void;
+}
+export interface FeedsHost {
+    /** Absolute workspace root — the default for `refreshDue()` and state paths. */
+    workspaceRoot: string;
+    /** Host logger. */
+    log: FeedsLogger;
+    /** Host atomic file writer (state files). */
+    writeFileAtomic: (filePath: string, content: string) => Promise<void>;
+    /** Launches the agent-ingest worker (was `setAgentWorkerRunner`). */
+    spawnWorker: AgentWorkerRunner;
+}
+/** Wire the feeds engine to a host. Call once at startup, before any refresh. */
+export declare function configureFeedsHost(host: FeedsHost): void;
+/** The configured host, or throw if `configureFeedsHost` was never called. */
+export declare function requireFeedsHost(): FeedsHost;
+/** Test-only: clear the configured host. */
+export declare function resetFeedsHostForTesting(): void;
+/** Forwarding logger so engine modules can `import { log }` without each
+ *  reaching for `requireFeedsHost().log`. */
+export declare const log: FeedsLogger;