libre-webui 0.36.0 → 0.37.1

package/backend/dist/cordis/dsh/engine-plugin.d.ts

@@ -0,0 +1,186 @@
+import { Service, type Context } from '@deepseek-ai/cordis';
+import type { DshEngine, EngineAgentSummary, EngineSessionSettings, EngineCreateSessionOptions, EngineMessage, EngineMessageRole, EngineServiceStatus, EngineSession, EngineSessionSummary, EngineStreamChunk, EngineStreamHandle, EngineToolSummary } from '../contracts.js';
+/** Plugin name reported to Cordis diagnostics. */
+export declare const name = "libre-webui-dsh-engine";
+/**
+ * Services this plugin waits for.
+ *
+ * Declaring them is what makes the bridge start only once the engine is
+ * usable, and — just as importantly — refuse to start at all when the engine
+ * is absent. A bridge that published itself against a missing engine would
+ * turn a configuration mistake into silently empty session lists.
+ */
+export declare const inject: readonly ['sessions', 'agents', 'tools', 'llm'];
+/** Configuration accepted by the bridge row. */
+export interface Config {
+    /** Absolute directory used as the default workspace for new sessions. */
+    readonly workspacePath?: string;
+    /** Whether `sendMessage` may start model work. */
+    readonly streaming?: boolean;
+    /** Whether the registry may be listed. */
+    readonly tools?: boolean;
+    /** Exact local store whose session artifacts may be deleted. */
+    readonly sessionStorePath?: string;
+    /** Provider route pinned on agents this bridge creates. */
+    readonly defaultProvider?: string;
+    /** Model pinned on agents this bridge creates. */
+    readonly defaultModel?: string;
+}
+/** The subset of a DSH session this bridge reads. */
+interface DshSessionLike {
+    readonly id: string;
+    readonly header?: {
+        readonly createdAt?: number;
+        readonly cwd?: string;
+    };
+    readonly seq?: number;
+    deriveMessages(): readonly unknown[];
+}
+/**
+ * One in-flight response for a session.
+ *
+ * Chunks are buffered until a subscriber attaches, because the HTTP handler
+ * must await this handle before it can write response headers — a model that
+ * answers faster than the round trip would otherwise lose its opening tokens.
+ */
+export declare class ResponseStream implements EngineStreamHandle {
+    readonly sessionId: string;
+    private readonly onClose?;
+    private readonly onDone?;
+    private readonly buffer;
+    private readonly listeners;
+    private closed;
+    private terminated;
+    private errorReported;
+    private bufferBytes;
+    private static readonly MAX_BUFFER_BYTES;
+    private static readonly MAX_BUFFER_CHUNKS;
+    constructor(sessionId: string, onClose?: (() => void) | undefined, onDone?: (() => void) | undefined);
+    /** Deliver a chunk to the buffer, or straight to attached listeners. */
+    push(chunk: EngineStreamChunk): void;
+    /**
+     * Mark the response finished and release every listener.
+     *
+     * Also called when a client disconnects, so an abandoned response stops
+     * buffering for a reader that is gone.
+     */
+    close(): void;
+    /** Whether the response has already terminated. */
+    get isClosed(): boolean;
+    /** Chunks buffered but not yet delivered. */
+    get pending(): number;
+    subscribe(listener: (chunk: EngineStreamChunk) => void): {
+        unsubscribe(): void;
+    };
+    /** Whether this response has produced its terminal chunk. */
+    get isTerminated(): boolean;
+}
+/** Extract readable text from one DSH message content value. */
+export declare function extractText(content: unknown): string;
+/** Normalize a DSH message role into the contract's role vocabulary. */
+export declare function normalizeRole(role: unknown): EngineMessageRole;
+/** Project one DSH message into the contract's message shape. */
+export declare function projectMessage(raw: unknown, index: number): EngineMessage;
+/**
+ * Map one DSH session event onto a contract stream chunk.
+ *
+ * A durable session event is an envelope: `type` and `seq` sit beside a `data`
+ * object that carries the payload for that type. Reading the payload off the
+ * envelope instead of `data` yields no chunk at all rather than an error, so
+ * each branch unwraps `data` explicitly.
+ * @param event - the session event envelope.
+ * @returns the projected chunk, or undefined for an event the transcript omits.
+ */
+export declare function projectStreamEvent(event: Record<string, unknown>): EngineStreamChunk | undefined;
+/**
+ * Project the failure a finished turn recorded, if it recorded one.
+ *
+ * @param event - the `turn/end` envelope.
+ * @returns the error chunk, or undefined when the turn ended normally.
+ */
+export declare function projectTurnFailure(event: Record<string, unknown>): EngineStreamChunk | undefined;
+/** Project a session into its summary shape. */
+export declare function projectSummary(session: DshSessionLike): EngineSessionSummary;
+/**
+ * The engine contract, published as the `libreDshEngine` Cordis service.
+ *
+ * It is a `Service` rather than a plain object so that Cordis owns its
+ * lifecycle: the name is declared once, `ctx.get('libreDshEngine')` resolves it
+ * for every consumer, and removing the bridge row withdraws it automatically.
+ */
+export declare class LibreDshEngineService extends Service implements DshEngine {
+    /** Contract name under which this service is registered. */
+    static readonly provide: "libreDshEngine";
+    private readonly streams;
+    private readonly handles;
+    /**
+     * Sessions created by the UI that no agent owns yet.
+     *
+     * They are deliberately absent from the DSH store until the first message,
+     * because the agent that will own one must be the component that enters it.
+     */
+    private readonly pending;
+    /** Working directory requested for each not-yet-owned session. */
+    private readonly pendingCwd;
+    private readonly pendingNative;
+    private readonly selections;
+    private readonly settingsUpdates;
+    private readonly approvals;
+    /** Caller identity exists only while a model turn is in flight. */
+    private readonly requestUsers;
+    private readonly agentUsers;
+    private readonly streamedText;
+    private readonly starting;
+    private readonly controllers;
+    private readonly stopping;
+    private readonly deleting;
+    private disposed;
+    private readonly allowTools;
+    private readonly sessionStorePath?;
+    private readonly workspacePath;
+    private readonly allowStreaming;
+    private readonly defaultProvider;
+    private readonly defaultModel;
+    /** Mints session ids unique across every engine in this process. */
+    private readonly mintSessionId;
+    constructor(ctx: Context, config?: Config);
+    /** The DSH session store this bridge reads through. */
+    private get sessions();
+    /** The DSH agent registry this bridge drives. */
+    private get agents();
+    /** The DSH tool runtime this bridge reads through. */
+    private get tools();
+    modelConfiguration(): {
+        readonly provider?: string;
+        readonly model?: string;
+    };
+    status(): readonly EngineServiceStatus[];
+    private get persistence();
+    listSessions(): Promise<readonly EngineSessionSummary[]>;
+    private nativeSession;
+    getSession(sessionId: string): Promise<EngineSession | undefined>;
+    private validateSettings;
+    updateSessionSettings(sessionId: string, settings: Partial<EngineSessionSettings>, options?: {
+        readonly userId?: string;
+    }): Promise<EngineSession>;
+    decideApproval(sessionId: string, approvalId: string, outcome: 'allowed-once' | 'rejected'): Promise<boolean>;
+    private resolveWorkspace;
+    createSession(options: EngineCreateSessionOptions): Promise<EngineSession>;
+    deleteSession(sessionId: string): Promise<boolean>;
+    listAgents(): Promise<readonly EngineAgentSummary[]>;
+    listTools(): Promise<readonly EngineToolSummary[]>;
+    sendMessage(sessionId: string, text: string, options?: {
+        readonly cwd?: string;
+        readonly userId?: string;
+    }): Promise<EngineStreamHandle>;
+    requestUserId(sessionId: string): string | undefined;
+    cancel(sessionId: string): Promise<boolean>;
+}
+/**
+ * Mount the bridge on a context that already provides the engine services.
+ * @param ctx - context carrying `sessions`, `agents`, and `tools`.
+ * @param config - bridge configuration from the composition row.
+ */
+export declare function apply(ctx: Context, config?: Config): void;
+export {};
+//# sourceMappingURL=engine-plugin.d.ts.map

package/backend/dist/cordis/dsh/engine-plugin.d.ts.map

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