@mono-agent/web 0.12.0

package/dist/service.d.ts

@@ -0,0 +1,89 @@
+import { type CreateWebUploadInput, type PatchWebAgentInput, type StartWebTurnInput, type WebAgentSummary, type WebAttachment, type WebBootstrap, type WebEvent, type WebThread, type WebThreadDetail } from "./contracts.js";
+import { type DiscoverOperatorAgentsOptions, type DiscoveredOperatorAgent } from "./discovery.js";
+import { type WebStatePathOptions } from "./state-paths.js";
+import { WebStore, type StoredAttachment } from "./store.js";
+export interface WebServiceLogger {
+    debug?(message: string, metadata?: Readonly<Record<string, unknown>>): void;
+    info?(message: string, metadata?: Readonly<Record<string, unknown>>): void;
+    warn?(message: string, metadata?: Readonly<Record<string, unknown>>): void;
+    error?(message: string, metadata?: Readonly<Record<string, unknown>>): void;
+}
+export interface CreateWebServiceOptions extends WebStatePathOptions, DiscoverOperatorAgentsOptions {
+    readonly fetchImpl?: typeof fetch;
+    readonly logger?: WebServiceLogger;
+    readonly clock?: () => Date;
+    readonly discoveryIntervalMs?: number;
+    readonly purgeIntervalMs?: number;
+    readonly discoverImpl?: (options: DiscoverOperatorAgentsOptions) => Promise<readonly DiscoveredOperatorAgent[]>;
+    /** Test/embedding override; production defaults to one 64 MiB weighted attachment turn. */
+    readonly maxActiveAttachmentTurnBytes?: number;
+    readonly maxQueuedAttachmentTurns?: number;
+}
+export interface WebUploadReservation {
+    readonly attachment: StoredAttachment;
+    readonly maxBytes: number;
+    release(): void;
+}
+export declare class WebService {
+    readonly store: WebStore;
+    private readonly options;
+    private readonly lease;
+    private readonly subscribers;
+    private readonly activeTurns;
+    private readonly activeUploads;
+    private readonly allowlist;
+    private readonly attachmentTurnBudget;
+    private connections;
+    private discoveryTimer;
+    private purgeTimer;
+    private purgePromise;
+    private refreshPromise;
+    private refreshController;
+    private eventSequence;
+    private stopped;
+    private constructor();
+    static create(options?: CreateWebServiceOptions): Promise<WebService>;
+    bootstrap(): Promise<WebBootstrap>;
+    createThread(sourceId: string): WebThread;
+    thread(id: string): WebThreadDetail;
+    patchThread(id: string, patch: {
+        readonly title?: string;
+        readonly archived?: boolean;
+    }): WebThread;
+    patchAgent(sourceId: string, patch: PatchWebAgentInput): WebAgentSummary;
+    startTurn(threadId: string, input: StartWebTurnInput): Promise<{
+        readonly thread: WebThread;
+        readonly turn: WebThread["runState"];
+    }>;
+    cancelTurn(threadId: string): Promise<WebThread>;
+    createUpload(input: CreateWebUploadInput): WebAttachment;
+    reserveUpload(id: string): WebUploadReservation;
+    completeUpload(id: string, sizeBytes: number): WebAttachment;
+    storedAttachment(id: string): StoredAttachment;
+    removeUpload(id: string): Promise<void>;
+    subscribe(callback: (event: WebEvent) => boolean | void): () => void;
+    readyEvent(): WebEvent;
+    refreshAgents(): Promise<void>;
+    stop(): Promise<void>;
+    private runTurn;
+    private toAgentAttachment;
+    private refreshAgentsOnce;
+    private startTimers;
+    private purgeOrphans;
+    private purgeOrphansOnce;
+    private emit;
+    private createEvent;
+    private activeReservedUploadBytes;
+}
+/** FIFO weighted semaphore: zero-weight text turns bypass attachment memory pressure. */
+export declare class WeightedTurnBudget {
+    private readonly capacity;
+    private readonly maxQueue;
+    private used;
+    private readonly queue;
+    constructor(capacity: number, maxQueue: number);
+    acquire(weight: number, signal: AbortSignal): Promise<() => void>;
+    private grant;
+    private drain;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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