@fdcn/sourcefed 0.3.5 → 0.3.7

package/dist.dts/adapters/opencode/bridge.d.ts

@@ -1,34 +1,80 @@
+import { type QueuedMonitorEvent } from "@fdcn/sourcefed/core";
 import { type Plugin } from "@opencode/plugin";
+import { OpenCodeSubscriptions, type SessionLocation } from "./subscriptions.js";
 type SessionDomain = Plugin.Context["session"];
-type RpcDomain = Plugin.Context["rpc"];
+type RpcDomain = (definition: typeof ChauffeurGate) => {
+    gate(input: unknown, options: {
+        signal: AbortSignal;
+    }): Promise<unknown>;
+};
+/**
+ * Chauffeur's gate, declared here so sourcefed does not depend on Chauffeur.
+ * When the Chauffeur plugin runs in this OpenCode process, it decides which
+ * events reach the session; otherwise every event is delivered.
+ */
+declare const ChauffeurGate: {
+    readonly id: "chauffeur";
+    readonly methods: {
+        readonly gate: {
+            readonly input: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly sessionID: {
+                        readonly type: "string";
+                    };
+                    readonly monitorID: {
+                        readonly type: "string";
+                    };
+                    readonly source: {
+                        readonly type: "string";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                    };
+                    readonly summary: {
+                        readonly type: "string";
+                    };
+                    readonly body: {
+                        readonly type: "string";
+                    };
+                    readonly actionable: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly required: readonly ["sessionID", "source", "kind", "summary", "actionable"];
+            };
+            readonly output: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly deliver: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly required: readonly ["deliver"];
+            };
+        };
+    };
+    readonly events: {};
+};
 export declare class OpenCodeBridge {
     private readonly session;
-    private readonly rpc?;
-    private daemon?;
-    private readonly listeners;
-    private lastAttemptAt;
-    private lastError;
-    private timer;
-    constructor(session: SessionDomain, rpc?: RpcDomain | undefined);
+    private readonly rpc;
+    readonly location: SessionLocation;
+    private readonly hub;
+    private started;
+    private closed;
+    private closing;
+    constructor(session: Pick<SessionDomain, "get" | "synthetic">, rpc: RpcDomain | undefined, location: SessionLocation, hub?: OpenCodeSubscriptions);
     /**
      * Chauffeur or the CLI can create a monitor for a session here at any time,
      * without this bridge's tools, so check for new targets periodically too.
      */
     start(): Promise<void>;
-    ensureTarget(sessionID: string): Promise<void>;
     callTool(name: string, arguments_: Record<string, unknown>, sessionID: string): Promise<unknown>;
     close(): Promise<void>;
-    private refresh;
-    private ensureDaemon;
-    /**
-     * Monitors outlive this process, so after a restart nothing listens for their
-     * sessions until something subscribes. Subscribe every session that has an
-     * enabled monitor and still exists here; a deleted session is skipped, since
-     * delivering to it would fail and retry forever.
-     */
-    private resubscribe;
-    private resubscribeTarget;
-    private routeEvents;
+    refresh(): Promise<void>;
+    getSession(sessionID: string, signal: AbortSignal): Promise<import("@opencode/client").SessionInfo>;
+    routeEvents(events: QueuedMonitorEvent[]): Promise<void>;
     /**
      * Ask Chauffeur's gate, when it runs in this process. Only an explicit
      * `deliver: false` withholds the event; no gate, an error, or a slow answer
@@ -37,6 +83,4 @@ export declare class OpenCodeBridge {
     private admitted;
     private target;
 }
-export declare function setOpenCodeBridge(bridge: OpenCodeBridge): void;
-export declare function getOpenCodeBridge(): OpenCodeBridge;
 export {};

package/dist.dts/adapters/opencode/subscriptions.d.ts

@@ -0,0 +1,46 @@
+import type { QueuedMonitorEvent } from "@fdcn/sourcefed/core";
+import type { DaemonClient } from "@fdcn/sourcefed/daemon";
+export type SessionLocation = {
+    directory: string;
+    project: {
+        id: string;
+    };
+};
+type SessionInfo = {
+    projectID: string;
+    location: {
+        directory: string;
+    };
+};
+export interface SubscriptionOwner {
+    readonly location: SessionLocation;
+    getSession(sessionID: string, signal: AbortSignal): Promise<SessionInfo>;
+    routeEvents(events: QueuedMonitorEvent[]): Promise<void>;
+}
+/** One client, timer and stream per enabled session, shared by all plugin locations. */
+export declare class OpenCodeSubscriptions {
+    private readonly connect;
+    private readonly owners;
+    private readonly subscriptions;
+    private readonly lifetime;
+    private daemon;
+    private connecting;
+    private refreshing;
+    private dirty;
+    private lastAttemptAt;
+    private timer;
+    constructor(connect: () => Promise<DaemonClient>);
+    get closed(): boolean;
+    add(owner: SubscriptionOwner): Promise<void>;
+    remove(owner: SubscriptionOwner): Promise<void>;
+    request(method: string, params: Record<string, unknown>): Promise<unknown>;
+    refresh(): Promise<void>;
+    private refreshLoop;
+    private ensureDaemon;
+    private reconcile;
+    private ownerFor;
+    private subscribe;
+    private route;
+    private closeSubscription;
+}
+export {};

package/dist.dts/adapters/opencode/tool-result.d.ts

@@ -1 +1,2 @@
-export declare function callMonitorTool(name: string, arguments_: Record<string, unknown>, sessionID: string): Promise<string>;
+import type { OpenCodeBridge } from "./bridge.js";
+export declare function callMonitorTool(bridge: OpenCodeBridge, name: string, arguments_: Record<string, unknown>, sessionID: string): Promise<string>;

package/dist.dts/adapters/opencode/tools/monitor_create.d.ts

@@ -1,5 +1,6 @@
 import type { ToolContext } from "@opencode/plugin/promise/tool";
-declare const definition: {
+import type { OpenCodeBridge } from "../bridge.js";
+declare const _default: (bridge: OpenCodeBridge) => {
     name: string;
     description: string;
     input: {
@@ -50,4 +51,4 @@ declare const definition: {
         content: string;
     }>;
 };
-export default definition;
+export default _default;

package/dist.dts/adapters/opencode/tools/monitor_list.d.ts

@@ -1,5 +1,6 @@
 import type { ToolContext } from "@opencode/plugin/promise/tool";
-declare const definition: {
+import type { OpenCodeBridge } from "../bridge.js";
+declare const _default: (bridge: OpenCodeBridge) => {
     name: string;
     description: string;
     input: {
@@ -11,4 +12,4 @@ declare const definition: {
         content: string;
     }>;
 };
-export default definition;
+export default _default;

package/dist.dts/adapters/opencode/tools/monitor_start.d.ts

@@ -1,5 +1,6 @@
 import type { ToolContext } from "@opencode/plugin/promise/tool";
-declare const definition: {
+import type { OpenCodeBridge } from "../bridge.js";
+declare const _default: (bridge: OpenCodeBridge) => {
     name: string;
     description: string;
     input: {
@@ -17,4 +18,4 @@ declare const definition: {
         content: string;
     }>;
 };
-export default definition;
+export default _default;

package/dist.dts/adapters/opencode/tools/monitor_status.d.ts

@@ -1,5 +1,6 @@
 import type { ToolContext } from "@opencode/plugin/promise/tool";
-declare const definition: {
+import type { OpenCodeBridge } from "../bridge.js";
+declare const _default: (bridge: OpenCodeBridge) => {
     name: string;
     description: string;
     input: {
@@ -17,4 +18,4 @@ declare const definition: {
         content: string;
     }>;
 };
-export default definition;
+export default _default;

package/dist.dts/adapters/opencode/tools/monitor_stop.d.ts

@@ -1,5 +1,6 @@
 import type { ToolContext } from "@opencode/plugin/promise/tool";
-declare const definition: {
+import type { OpenCodeBridge } from "../bridge.js";
+declare const _default: (bridge: OpenCodeBridge) => {
     name: string;
     description: string;
     input: {
@@ -17,4 +18,4 @@ declare const definition: {
         content: string;
     }>;
 };
-export default definition;
+export default _default;

package/dist.dts/packages/cli/src/utils/setup.d.ts

@@ -1,3 +1,2 @@
 export declare function setupSpec(): string;
 export declare function setupHost(name: string, args: string[], spec: string): Promise<boolean>;
-export declare function configureOpenCodeCliPlugin(spec: string): void;

package/dist.dts/packages/daemon/src/event-stream.d.ts

@@ -0,0 +1,26 @@
+import type { QueuedMonitorEvent } from "@fdcn/sourcefed/core";
+/** Owns one SSE connection, its setup, serialized delivery and reconnect loop. */
+export declare class DaemonEventStream {
+    private readonly url;
+    private readonly headers;
+    private readonly onEvents;
+    private readonly acknowledge;
+    private readonly onClose;
+    private readonly controller;
+    private readonly subscribed;
+    private stream;
+    private delivering;
+    private closing;
+    private ready;
+    private failedDelivery;
+    constructor(url: string, headers: Record<string, string>, onEvents: (events: QueuedMonitorEvent[]) => Promise<void>, acknowledge: (events: QueuedMonitorEvent[], signal: AbortSignal) => Promise<void>, onClose: () => void);
+    start(signal?: AbortSignal): Promise<void>;
+    close(): Promise<void>;
+    private drain;
+    private run;
+    private read;
+    private frame;
+    private deliver;
+    private waitForDelivery;
+}
+export declare function pause(ms: number, signal: AbortSignal): Promise<void>;

package/dist.dts/packages/daemon/src/types/client.d.ts

@@ -10,7 +10,9 @@ export type DaemonClientOptions = {
 };
 export interface DaemonClient {
     request(method: string, params?: Record<string, unknown>): Promise<unknown>;
-    subscribe(target: MonitorTarget, onEvents: (events: QueuedMonitorEvent[]) => Promise<void>): Promise<{
+    subscribe(target: MonitorTarget, onEvents: (events: QueuedMonitorEvent[]) => Promise<void>, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
         close(): Promise<void>;
     }>;
     close(): Promise<void>;

package/dist.dts/packages/daemon/src/utils/index.d.ts

@@ -1,6 +1,5 @@
 export { daemonEnvironment } from "./env.js";
 export { serveHttp, type HttpServer, type HttpServerOptions } from "./http-server.js";
-export { RequestRouter } from "./request-router.js";
 export { DEFAULT_DAEMON_URL, daemonCommand, defaultDaemonUrl, sleep, spawnLocalDaemon, withTimeout } from "./spawn.js";
 export { NotifyingEventSink } from "./sink.js";
 export { decodeTarget, encodeTarget, targetKey } from "./target.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fdcn/sourcefed",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Live Jira, GitHub, and Slack monitoring for agent hosts: CLI, daemon, MCP server, and host plugins.",
   "license": "MIT",
   "type": "module",

package/dist.dts/packages/daemon/src/utils/forward.d.ts

@@ -1,32 +0,0 @@
-import type { MonitorEvent, MonitorEventSink, MonitorRecord } from "@fdcn/sourcefed/core";
-export type ForwardOptions = {
-    url: string;
-    token?: string;
-    fetch?: typeof fetch;
-};
-/** The JSON body POSTed for each delivered event. */
-export type ForwardedEvent = {
-    target: MonitorRecord["target"];
-    monitorID: string;
-    source: MonitorRecord["source"];
-    event: MonitorEvent;
-};
-/** `SOURCEFED_FORWARD_URL` (and optional `SOURCEFED_FORWARD_TOKEN`), when set. */
-export declare function forwardFromEnv(): ForwardOptions | undefined;
-/**
- * Delivers to `inner`, then POSTs a copy of each delivered event to another
- * local consumer. Forwarding never blocks or fails delivery.
- */
-export declare class ForwardingEventSink implements MonitorEventSink {
-    private readonly inner;
-    private readonly options;
-    constructor(inner: MonitorEventSink, options: ForwardOptions);
-    deliver(input: {
-        monitor: MonitorRecord;
-        event: MonitorEvent;
-    }): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    private forward;
-}

package/dist.dts/packages/daemon/src/utils/gate.d.ts

@@ -1,33 +0,0 @@
-import type { MonitorEvent, MonitorEventSink, MonitorRecord } from "@fdcn/sourcefed/core";
-export type GateOptions = {
-    url: string;
-    token?: string;
-    fetch?: typeof fetch;
-};
-/** The JSON body POSTed for each event; the gate replies `{ "deliver": boolean }`. */
-export type GatedEvent = {
-    target: MonitorRecord["target"];
-    monitorID: string;
-    source: MonitorRecord["source"];
-    event: MonitorEvent;
-};
-/** `SOURCEFED_GATE_URL` (and optional `SOURCEFED_GATE_TOKEN`), when set. */
-export declare function gateFromEnv(): GateOptions | undefined;
-/**
- * Asks another local consumer whether each event should reach the session.
- * Only an explicit `{ "deliver": false }` withholds it; a failed, slow, or
- * unclear answer delivers, so the gate can never lose an event.
- */
-export declare class GatedEventSink implements MonitorEventSink {
-    private readonly inner;
-    private readonly options;
-    constructor(inner: MonitorEventSink, options: GateOptions);
-    deliver(input: {
-        monitor: MonitorRecord;
-        event: MonitorEvent;
-    }): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    private withheld;
-}

package/dist.dts/packages/daemon/src/utils/request-router.d.ts

@@ -1,11 +0,0 @@
-export declare class RequestRouter {
-    private readonly pending;
-    private cursor;
-    nextID(): number;
-    register(id: number): Promise<unknown>;
-    settle(id: number, frame: {
-        result?: unknown;
-        error?: string;
-    }): void;
-    rejectAll(error: Error): void;
-}