@modelprofile.com/flexharness 10.17.1 → 10.19.0

package/dist_ts_chat_harness_server/plugins.d.ts

@@ -0,0 +1,7 @@
+import { FlexHarnessClosedError, FlexHarnessError, FlexHarnessNotFoundError, FlexHarnessSteerRejectedError, FlexHarnessValidationError, modelLimitErrorInfo } from '@modelprofile.com/flexharness';
+import { FlexHarnessChatRequestError, FlexHarnessTranscript, flexHarnessSendIntent, flexSessionToHarnessMeta } from '@modelprofile.com/flexharness/chat/harness';
+import { describeModelFailure } from '@modelprofile.com/flexharness-models';
+export { FlexHarnessChatRequestError, FlexHarnessClosedError, FlexHarnessError, FlexHarnessNotFoundError, FlexHarnessSteerRejectedError, FlexHarnessTranscript, FlexHarnessValidationError, describeModelFailure, flexHarnessSendIntent, flexSessionToHarnessMeta, modelLimitErrorInfo, };
+export type { FlexHarness, IFlexErrorInfo, IFlexExternalErrorContext, IFlexPromptQueueAdmission, IFlexSession, IFlexSessionCreatedEvent, IFlexSessionDeletedEvent, IFlexSessionUpdatedEvent, TFlexExternalErrorProjector, TFlexHarnessEvent, TJsonValue, } from '@modelprofile.com/flexharness';
+export type { IFlexHarnessChatHistoryState, IFlexHarnessChatMethods, IFlexHarnessChatSessionsPush, IFlexHarnessChatSteerOutcome, IFlexHarnessChatToolRequest, IFlexHarnessChatUpdate, TFlexHarnessChatRequest, TFlexHarnessChatResponse, } from '@modelprofile.com/flexharness/chat/harness';
+export type { IHarnessAttachment, IHarnessComposerSendDetail, IHarnessMessage, IHarnessSessionMeta, THarnessStreamDelta, } from '@design.estate/dees-catalog';

package/dist_ts_chat_harness_server/plugins.js

@@ -0,0 +1,6 @@
+// @modelprofile.com scope
+import { FlexHarnessClosedError, FlexHarnessError, FlexHarnessNotFoundError, FlexHarnessSteerRejectedError, FlexHarnessValidationError, modelLimitErrorInfo, } from '@modelprofile.com/flexharness';
+import { FlexHarnessChatRequestError, FlexHarnessTranscript, flexHarnessSendIntent, flexSessionToHarnessMeta, } from '@modelprofile.com/flexharness/chat/harness';
+import { describeModelFailure } from '@modelprofile.com/flexharness-models';
+export { FlexHarnessChatRequestError, FlexHarnessClosedError, FlexHarnessError, FlexHarnessNotFoundError, FlexHarnessSteerRejectedError, FlexHarnessTranscript, FlexHarnessValidationError, describeModelFailure, flexHarnessSendIntent, flexSessionToHarnessMeta, modelLimitErrorInfo, };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2NoYXRfaGFybmVzc19zZXJ2ZXIvcGx1Z2lucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwwQkFBMEI7QUFDMUIsT0FBTyxFQUNMLHNCQUFzQixFQUN0QixnQkFBZ0IsRUFDaEIsd0JBQXdCLEVBQ3hCLDZCQUE2QixFQUM3QiwwQkFBMEIsRUFDMUIsbUJBQW1CLEdBQ3BCLE1BQU0sK0JBQStCLENBQUM7QUFDdkMsT0FBTyxFQUNMLDJCQUEyQixFQUMzQixxQkFBcUIsRUFDckIscUJBQXFCLEVBQ3JCLHdCQUF3QixHQUN6QixNQUFNLDRDQUE0QyxDQUFDO0FBQ3BELE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBRTVFLE9BQU8sRUFDTCwyQkFBMkIsRUFDM0Isc0JBQXNCLEVBQ3RCLGdCQUFnQixFQUNoQix3QkFBd0IsRUFDeEIsNkJBQTZCLEVBQzdCLHFCQUFxQixFQUNyQiwwQkFBMEIsRUFDMUIsb0JBQW9CLEVBQ3BCLHFCQUFxQixFQUNyQix3QkFBd0IsRUFDeEIsbUJBQW1CLEdBQ3BCLENBQUMifQ==

package/dist_ts_chat_harness_typedsocket/classes.clienttransport.d.ts

@@ -0,0 +1,22 @@
+import * as plugins from './plugins.js';
+export interface IFlexHarnessChatTypedSocketTransportOptions {
+    /** The tab's TypedSocket client. */
+    typedsocket: plugins.typedsocket.TypedSocket;
+    /** The router the client was created with; the transport adds its push handlers to it. */
+    typedrouter: plugins.typedrequest.TypedRouter;
+    /** The tab: 16 random bytes in hex. Defaults to a new random id for this transport's lifetime. */
+    tabId?: string;
+    /** The opaque credential the server's `resolve` reads, read for every request. */
+    callerToken?: () => string | undefined;
+}
+/** A `FlexHarnessChatClient` transport over the tab's TypedSocket client. */
+export declare class FlexHarnessChatTypedSocketTransport implements plugins.IFlexHarnessChatClientTransport {
+    readonly tabId: string;
+    private readonly socket;
+    private readonly router;
+    private readonly callerToken;
+    constructor(optionsArg: IFlexHarnessChatTypedSocketTransportOptions);
+    request<TMethod extends plugins.TFlexHarnessChatMethod>(methodArg: TMethod, requestArg: plugins.TFlexHarnessChatRequest<TMethod>): Promise<plugins.TFlexHarnessChatResponse<TMethod>>;
+    listen(handlersArg: plugins.IFlexHarnessChatPushHandlers): () => void;
+    onReconnect(callbackArg: () => void): () => void;
+}

package/dist_ts_chat_harness_typedsocket/classes.clienttransport.js

@@ -0,0 +1,55 @@
+import * as plugins from './plugins.js';
+/** 128 random bits as hex; `getRandomValues` works on plain http too, unlike `randomUUID`. */
+const randomTabId = () => Array.from(globalThis.crypto.getRandomValues(new Uint8Array(16)), (byte) => byte.toString(16).padStart(2, '0')).join('');
+/** A `FlexHarnessChatClient` transport over the tab's TypedSocket client. */
+export class FlexHarnessChatTypedSocketTransport {
+    tabId;
+    socket;
+    router;
+    callerToken;
+    constructor(optionsArg) {
+        this.socket = optionsArg.typedsocket;
+        this.router = optionsArg.typedrouter;
+        this.tabId = optionsArg.tabId ?? randomTabId();
+        this.callerToken = optionsArg.callerToken ?? (() => undefined);
+    }
+    async request(methodArg, requestArg) {
+        const token = this.callerToken();
+        return this.socket.createTypedRequest(methodArg).fire({
+            ...requestArg,
+            caller: { tabId: this.tabId, ...(token === undefined ? {} : { token }) },
+        });
+    }
+    listen(handlersArg) {
+        const pushes = new plugins.typedrequest.TypedRouter();
+        pushes.addTypedHandler(new plugins.typedrequest.TypedHandler('flexHarnessChatUpdate', async (pushArg) => {
+            handlersArg.update(pushArg);
+            return {};
+        }));
+        pushes.addTypedHandler(new plugins.typedrequest.TypedHandler('flexHarnessChatSessions', async (pushArg) => {
+            handlersArg.sessions(pushArg);
+            return {};
+        }));
+        pushes.addTypedHandler(new plugins.typedrequest.TypedHandler('flexHarnessChatTool', async (requestArg, toolsArg) => ({
+            // the server cancels the request when the turn stops or the call times out; the handler then
+            // settles at once, since TypedSocket fails a connection whose handlers outlive their requests
+            output: await handlersArg.tool(requestArg, toolsArg?.abortSignal),
+        })));
+        return this.router.addTypedRouter(pushes);
+    }
+    onReconnect(callbackArg) {
+        let wasConnected = true;
+        const subscription = this.socket.statusSubject.subscribe((statusArg) => {
+            if (statusArg !== 'connected') {
+                wasConnected = false;
+                return;
+            }
+            if (wasConnected)
+                return;
+            wasConnected = true;
+            callbackArg();
+        });
+        return () => subscription.unsubscribe();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jbGllbnR0cmFuc3BvcnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19jaGF0X2hhcm5lc3NfdHlwZWRzb2NrZXQvY2xhc3Nlcy5jbGllbnR0cmFuc3BvcnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFtQnhDLDhGQUE4RjtBQUM5RixNQUFNLFdBQVcsR0FBRyxHQUFXLEVBQUUsQ0FDL0IsS0FBSyxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLGVBQWUsQ0FBQyxJQUFJLFVBQVUsQ0FBQyxFQUFFLENBQUMsQ0FBQyxFQUFFLENBQUMsSUFBSSxFQUFFLEVBQUUsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLEVBQUUsR0FBRyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUM7QUFFM0gsNkVBQTZFO0FBQzdFLE1BQU0sT0FBTyxtQ0FBbUM7SUFDOUIsS0FBSyxDQUFTO0lBRWIsTUFBTSxDQUFrQztJQUN4QyxNQUFNLENBQW1DO0lBQ3pDLFdBQVcsQ0FBMkI7SUFFdkQsWUFBWSxVQUF1RDtRQUNqRSxJQUFJLENBQUMsTUFBTSxHQUFHLFVBQVUsQ0FBQyxXQUFXLENBQUM7UUFDckMsSUFBSSxDQUFDLE1BQU0sR0FBRyxVQUFVLENBQUMsV0FBVyxDQUFDO1FBQ3JDLElBQUksQ0FBQyxLQUFLLEdBQUcsVUFBVSxDQUFDLEtBQUssSUFBSSxXQUFXLEVBQUUsQ0FBQztRQUMvQyxJQUFJLENBQUMsV0FBVyxHQUFHLFVBQVUsQ0FBQyxXQUFXLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUNqRSxDQUFDO0lBRU0sS0FBSyxDQUFDLE9BQU8sQ0FDbEIsU0FBa0IsRUFDbEIsVUFBb0Q7UUFFcEQsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDO1FBQ2pDLE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQyxrQkFBa0IsQ0FBZ0MsU0FBUyxDQUFDLENBQUMsSUFBSSxDQUFDO1lBQ25GLEdBQUcsVUFBVTtZQUNiLE1BQU0sRUFBRSxFQUFFLEtBQUssRUFBRSxJQUFJLENBQUMsS0FBSyxFQUFFLEdBQUcsQ0FBQyxLQUFLLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLENBQUMsRUFBRTtTQUN6RSxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRU0sTUFBTSxDQUFDLFdBQWlEO1FBQzdELE1BQU0sTUFBTSxHQUFHLElBQUksT0FBTyxDQUFDLFlBQVksQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUN0RCxNQUFNLENBQUMsZUFBZSxDQUNwQixJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsWUFBWSxDQUE2Qix1QkFBdUIsRUFBRSxLQUFLLEVBQUUsT0FBTyxFQUFFLEVBQUU7WUFDM0csV0FBVyxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUMsQ0FBQztZQUM1QixPQUFPLEVBQUUsQ0FBQztRQUNaLENBQUMsQ0FBQyxDQUNILENBQUM7UUFDRixNQUFNLENBQUMsZUFBZSxDQUNwQixJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsWUFBWSxDQUErQix5QkFBeUIsRUFBRSxLQUFLLEVBQUUsT0FBTyxFQUFFLEVBQUU7WUFDL0csV0FBVyxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsQ0FBQztZQUM5QixPQUFPLEVBQUUsQ0FBQztRQUNaLENBQUMsQ0FBQyxDQUNILENBQUM7UUFDRixNQUFNLENBQUMsZUFBZSxDQUNwQixJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsWUFBWSxDQUEyQixxQkFBcUIsRUFBRSxLQUFLLEVBQUUsVUFBVSxFQUFFLFFBQVEsRUFBRSxFQUFFLENBQUMsQ0FBQztZQUN0SCw2RkFBNkY7WUFDN0YsOEZBQThGO1lBQzlGLE1BQU0sRUFBRSxNQUFNLFdBQVcsQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLFFBQVEsRUFBRSxXQUFXLENBQUM7U0FDbEUsQ0FBQyxDQUFDLENBQ0osQ0FBQztRQUNGLE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQyxjQUFjLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDNUMsQ0FBQztJQUVNLFdBQVcsQ0FBQyxXQUF1QjtRQUN4QyxJQUFJLFlBQVksR0FBRyxJQUFJLENBQUM7UUFDeEIsTUFBTSxZQUFZLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsU0FBUyxDQUFDLENBQUMsU0FBUyxFQUFFLEVBQUU7WUFDckUsSUFBSSxTQUFTLEtBQUssV0FBVyxFQUFFLENBQUM7Z0JBQzlCLFlBQVksR0FBRyxLQUFLLENBQUM7Z0JBQ3JCLE9BQU87WUFDVCxDQUFDO1lBQ0QsSUFBSSxZQUFZO2dCQUFFLE9BQU87WUFDekIsWUFBWSxHQUFHLElBQUksQ0FBQztZQUNwQixXQUFXLEVBQUUsQ0FBQztRQUNoQixDQUFDLENBQUMsQ0FBQztRQUNILE9BQU8sR0FBRyxFQUFFLENBQUMsWUFBWSxDQUFDLFdBQVcsRUFBRSxDQUFDO0lBQzFDLENBQUM7Q0FDRiJ9

package/dist_ts_chat_harness_typedsocket/classes.serverbinding.d.ts

@@ -0,0 +1,46 @@
+import * as plugins from './plugins.js';
+import type { IFlexHarnessChatCallerPayload } from './interfaces.requests.js';
+/** The hub requests the binding routes; any `FlexHarnessChatHub` serves them. */
+export type TFlexHarnessChatRequestHandler = Pick<plugins.FlexHarnessChatHub<unknown>, 'attach' | 'open' | 'close' | 'send' | 'abort' | 'respondToPermission' | 'moveHistory' | 'renameSession' | 'deleteSession'>;
+/** The hub and scope a request reaches, as the host established them. */
+export interface IFlexHarnessChatResolvedCaller {
+    hub: TFlexHarnessChatRequestHandler;
+    scopeId: string;
+}
+export interface IFlexHarnessChatTypedSocketBindingOptions {
+    /**
+     * Authenticates a request: from the caller payload and the request's TypedSocket context, the hub
+     * and the scope it reaches. Throw a `FlexHarnessChatRequestError` to refuse with a message.
+     */
+    resolve(caller: IFlexHarnessChatCallerPayload, context: plugins.typedsocket.ITypedSocketRequestContext | undefined): Promise<IFlexHarnessChatResolvedCaller>;
+    /** The server-owned connection tag that names a tab. Default: `flexHarnessChatTab`. */
+    tag?: string;
+    /** How long an update or a session-list push may wait for the tab. Default: 30 seconds. */
+    pushTimeoutMs?: number;
+}
+/**
+ * Serves a `FlexHarnessChatHub` over TypedSocket. Add `typedrouter` to the server's router, hand
+ * the server's TypedSocket to `setTypedSocket()` once it runs, and give the hub `peers`. A tab's
+ * connection carries the server-owned tag with its tab id; every request claims it again.
+ */
+export declare class FlexHarnessChatTypedSocketBinding implements plugins.IFlexHarnessChatPeers {
+    readonly typedrouter: plugins.typedrequest.TypedRouter<plugins.typedrequestInterfaces.ITypedRequest>;
+    private readonly resolveCaller;
+    private readonly tag;
+    private readonly pushTimeoutMs;
+    private socket;
+    constructor(optionsArg: IFlexHarnessChatTypedSocketBindingOptions);
+    /** The server's TypedSocket; it exists once the server runs. */
+    setTypedSocket(socketArg: plugins.typedsocket.TypedSocket): void;
+    /** The tab's current connection in its scope, as the hub reaches it. */
+    find(tabArg: plugins.IFlexHarnessChatCaller): Promise<plugins.IFlexHarnessChatPeer | null>;
+    private route;
+    /** Authenticates a request, claims its connection for the tab and runs it on the resolved hub. */
+    private serve;
+    /**
+     * Marks the connection the request came in on as the tab's, and only that one. The tag names the
+     * tab in its resolved scope, so a caller of another scope that sends the same tab id names a tab
+     * of its own and never reaches this one's connection.
+     */
+    private claim;
+}

package/dist_ts_chat_harness_typedsocket/classes.serverbinding.js

@@ -0,0 +1,110 @@
+import * as plugins from './plugins.js';
+const TAB_ID_PATTERN = /^[0-9a-f]{32}$/;
+const BAD_REQUEST_MESSAGE = 'The request is malformed. Reload the page and try again.';
+const NOT_READY_MESSAGE = 'The server is not accepting connections yet.';
+/** The tag payload that names a tab: its scope and its id, in a fixed key order. */
+const tagPayload = (tabArg) => ({
+    scopeId: tabArg.scopeId,
+    tabId: tabArg.tabId,
+});
+class TypedSocketChatPeer {
+    socket;
+    connection;
+    pushTimeoutMs;
+    constructor(socket, connection, pushTimeoutMs) {
+        this.socket = socket;
+        this.connection = connection;
+        this.pushTimeoutMs = pushTimeoutMs;
+    }
+    async update(pushArg) {
+        await this.socket
+            .createTypedRequest('flexHarnessChatUpdate', this.connection, { timeoutMs: this.pushTimeoutMs })
+            .fire(pushArg);
+    }
+    async sessions(pushArg) {
+        await this.socket
+            .createTypedRequest('flexHarnessChatSessions', this.connection, { timeoutMs: this.pushTimeoutMs })
+            .fire(pushArg);
+    }
+    async runTool(requestArg, optionsArg) {
+        const answer = await this.socket
+            .createTypedRequest('flexHarnessChatTool', this.connection, optionsArg)
+            .fire(requestArg);
+        return answer.output;
+    }
+}
+/**
+ * Serves a `FlexHarnessChatHub` over TypedSocket. Add `typedrouter` to the server's router, hand
+ * the server's TypedSocket to `setTypedSocket()` once it runs, and give the hub `peers`. A tab's
+ * connection carries the server-owned tag with its tab id; every request claims it again.
+ */
+export class FlexHarnessChatTypedSocketBinding {
+    typedrouter = new plugins.typedrequest.TypedRouter();
+    resolveCaller;
+    tag;
+    pushTimeoutMs;
+    socket = null;
+    constructor(optionsArg) {
+        this.resolveCaller = optionsArg.resolve;
+        this.tag = optionsArg.tag ?? 'flexHarnessChatTab';
+        this.pushTimeoutMs = optionsArg.pushTimeoutMs ?? 30 * 1000;
+        this.route('flexHarnessChatAttach', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.attach(caller)));
+        this.route('flexHarnessChatOpen', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.open(caller, request)));
+        this.route('flexHarnessChatClose', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.close(caller, request)));
+        this.route('flexHarnessChatSend', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.send(caller, request)));
+        this.route('flexHarnessChatAbort', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.abort(caller, request)));
+        this.route('flexHarnessChatPermission', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.respondToPermission(caller, request)));
+        this.route('flexHarnessChatHistory', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.moveHistory(caller, request)));
+        this.route('flexHarnessChatSessionUpdate', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.renameSession(caller, request)));
+        this.route('flexHarnessChatSessionDelete', (request, tools) => this.serve(request.caller, tools, (hub, caller) => hub.deleteSession(caller, request)));
+    }
+    /** The server's TypedSocket; it exists once the server runs. */
+    setTypedSocket(socketArg) {
+        this.socket = socketArg;
+    }
+    /** The tab's current connection in its scope, as the hub reaches it. */
+    async find(tabArg) {
+        if (!this.socket)
+            return null;
+        const connection = await this.socket.findTargetConnectionByTag(this.tag, tagPayload(tabArg));
+        return connection ? new TypedSocketChatPeer(this.socket, connection, this.pushTimeoutMs) : null;
+    }
+    route(methodArg, handlerArg) {
+        this.typedrouter.addTypedHandler(new plugins.typedrequest.TypedHandler(methodArg, handlerArg));
+    }
+    /** Authenticates a request, claims its connection for the tab and runs it on the resolved hub. */
+    async serve(payloadArg, contextArg, runArg) {
+        try {
+            if (!payloadArg || typeof payloadArg.tabId !== 'string' || !TAB_ID_PATTERN.test(payloadArg.tabId)) {
+                throw new plugins.FlexHarnessChatRequestError(BAD_REQUEST_MESSAGE);
+            }
+            const resolved = await this.resolveCaller(payloadArg, contextArg);
+            const caller = { tabId: payloadArg.tabId, scopeId: resolved.scopeId };
+            await this.claim(contextArg, caller);
+            return await runArg(resolved.hub, caller);
+        }
+        catch (error) {
+            if (error instanceof plugins.FlexHarnessChatRequestError) {
+                throw new plugins.typedrequest.TypedResponseError(error.message);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Marks the connection the request came in on as the tab's, and only that one. The tag names the
+     * tab in its resolved scope, so a caller of another scope that sends the same tab id names a tab
+     * of its own and never reaches this one's connection.
+     */
+    async claim(contextArg, tabArg) {
+        if (!this.socket)
+            throw new plugins.FlexHarnessChatRequestError(NOT_READY_MESSAGE);
+        const connection = this.socket.getServerConnectionForRequest(contextArg);
+        const payload = tagPayload(tabArg);
+        for (const other of await this.socket.findAllTargetConnectionsByTag(this.tag, payload)) {
+            if (other.peer !== connection.peer)
+                this.socket.removeServerTag(other, this.tag);
+        }
+        this.socket.setServerTag(connection, this.tag, payload);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zZXJ2ZXJiaW5kaW5nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfY2hhdF9oYXJuZXNzX3R5cGVkc29ja2V0L2NsYXNzZXMuc2VydmVyYmluZGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQW9DeEMsTUFBTSxjQUFjLEdBQUcsZ0JBQWdCLENBQUM7QUFDeEMsTUFBTSxtQkFBbUIsR0FBRywwREFBMEQsQ0FBQztBQUN2RixNQUFNLGlCQUFpQixHQUFHLDhDQUE4QyxDQUFDO0FBRXpFLG9GQUFvRjtBQUNwRixNQUFNLFVBQVUsR0FBRyxDQUFDLE1BQXNDLEVBQXNDLEVBQUUsQ0FBQyxDQUFDO0lBQ2xHLE9BQU8sRUFBRSxNQUFNLENBQUMsT0FBTztJQUN2QixLQUFLLEVBQUUsTUFBTSxDQUFDLEtBQUs7Q0FDcEIsQ0FBQyxDQUFDO0FBRUgsTUFBTSxtQkFBbUI7SUFFSjtJQUNBO0lBQ0E7SUFIbkIsWUFDbUIsTUFBdUMsRUFDdkMsVUFBNEQsRUFDNUQsYUFBcUI7UUFGckIsV0FBTSxHQUFOLE1BQU0sQ0FBaUM7UUFDdkMsZUFBVSxHQUFWLFVBQVUsQ0FBa0Q7UUFDNUQsa0JBQWEsR0FBYixhQUFhLENBQVE7SUFDckMsQ0FBQztJQUVHLEtBQUssQ0FBQyxNQUFNLENBQUMsT0FBdUM7UUFDekQsTUFBTSxJQUFJLENBQUMsTUFBTTthQUNkLGtCQUFrQixDQUE2Qix1QkFBdUIsRUFBRSxJQUFJLENBQUMsVUFBVSxFQUFFLEVBQUUsU0FBUyxFQUFFLElBQUksQ0FBQyxhQUFhLEVBQUUsQ0FBQzthQUMzSCxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDbkIsQ0FBQztJQUVNLEtBQUssQ0FBQyxRQUFRLENBQUMsT0FBNkM7UUFDakUsTUFBTSxJQUFJLENBQUMsTUFBTTthQUNkLGtCQUFrQixDQUErQix5QkFBeUIsRUFBRSxJQUFJLENBQUMsVUFBVSxFQUFF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

package/dist_ts_chat_harness_typedsocket/index.d.ts

@@ -0,0 +1,3 @@
+export { FlexHarnessChatTypedSocketBinding, type IFlexHarnessChatResolvedCaller, type IFlexHarnessChatTypedSocketBindingOptions, type TFlexHarnessChatRequestHandler, } from './classes.serverbinding.js';
+export { FlexHarnessChatTypedSocketTransport, type IFlexHarnessChatTypedSocketTransportOptions, } from './classes.clienttransport.js';
+export type { IFlexHarnessChatCallerPayload, IReq_FlexHarnessChat, IReq_FlexHarnessChatSessions, IReq_FlexHarnessChatTool, IReq_FlexHarnessChatUpdate, } from './interfaces.requests.js';

package/dist_ts_chat_harness_typedsocket/index.js

@@ -0,0 +1,3 @@
+export { FlexHarnessChatTypedSocketBinding, } from './classes.serverbinding.js';
+export { FlexHarnessChatTypedSocketTransport, } from './classes.clienttransport.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19jaGF0X2hhcm5lc3NfdHlwZWRzb2NrZXQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLGlDQUFpQyxHQUlsQyxNQUFNLDRCQUE0QixDQUFDO0FBQ3BDLE9BQU8sRUFDTCxtQ0FBbUMsR0FFcEMsTUFBTSw4QkFBOEIsQ0FBQyJ9

package/dist_ts_chat_harness_typedsocket/interfaces.requests.d.ts

@@ -0,0 +1,38 @@
+import type * as plugins from './plugins.js';
+/** Who sends a request: the tab, and an opaque credential the host's `resolve` reads. */
+export interface IFlexHarnessChatCallerPayload {
+    /**
+     * The tab: 16 random bytes in hex, kept for the tab's lifetime and never shared. Every request
+     * claims the connection it arrives on for the tab, so pushes and tool calls follow a reconnect.
+     */
+    tabId: string;
+    token?: string;
+}
+/** A tab's request to the hub over TypedSocket. */
+export interface IReq_FlexHarnessChat<TMethod extends plugins.TFlexHarnessChatMethod> extends plugins.typedrequestInterfaces.ITypedRequest {
+    method: TMethod;
+    request: plugins.TFlexHarnessChatRequest<TMethod> & {
+        caller: IFlexHarnessChatCallerPayload;
+    };
+    response: plugins.TFlexHarnessChatResponse<TMethod>;
+}
+/** Push: what changed in the conversation a tab follows. */
+export interface IReq_FlexHarnessChatUpdate extends plugins.typedrequestInterfaces.ITypedRequest {
+    method: 'flexHarnessChatUpdate';
+    request: plugins.IFlexHarnessChatUpdate;
+    response: Record<string, never>;
+}
+/** Push: changes of the tab's conversation list. */
+export interface IReq_FlexHarnessChatSessions extends plugins.typedrequestInterfaces.ITypedRequest {
+    method: 'flexHarnessChatSessions';
+    request: plugins.IFlexHarnessChatSessionsPush;
+    response: Record<string, never>;
+}
+/** Push: run a tool of a turn in the tab; the answer is the tool's output. */
+export interface IReq_FlexHarnessChatTool extends plugins.typedrequestInterfaces.ITypedRequest {
+    method: 'flexHarnessChatTool';
+    request: plugins.IFlexHarnessChatToolRequest;
+    response: {
+        output: plugins.TJsonValue;
+    };
+}

package/dist_ts_chat_harness_typedsocket/interfaces.requests.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5yZXF1ZXN0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2NoYXRfaGFybmVzc190eXBlZHNvY2tldC9pbnRlcmZhY2VzLnJlcXVlc3RzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist_ts_chat_harness_typedsocket/plugins.d.ts

@@ -0,0 +1,9 @@
+import * as typedrequest from '@api.global/typedrequest';
+import * as typedsocket from '@api.global/typedsocket';
+export { typedrequest, typedsocket };
+export type * as typedrequestInterfaces from '@api.global/typedrequest-interfaces';
+import { FlexHarnessChatRequestError } from '@modelprofile.com/flexharness/chat/harness';
+export { FlexHarnessChatRequestError };
+export type { TJsonValue } from '@modelprofile.com/flexharness';
+export type { IFlexHarnessChatClientTransport, IFlexHarnessChatPushHandlers, IFlexHarnessChatSessionsPush, IFlexHarnessChatToolRequest, IFlexHarnessChatUpdate, TFlexHarnessChatMethod, TFlexHarnessChatRequest, TFlexHarnessChatResponse, } from '@modelprofile.com/flexharness/chat/harness';
+export type { FlexHarnessChatHub, IFlexHarnessChatCaller, IFlexHarnessChatPeer, IFlexHarnessChatPeers, } from '@modelprofile.com/flexharness/chat/harness/server';

package/dist_ts_chat_harness_typedsocket/plugins.js

@@ -0,0 +1,8 @@
+// @api.global scope
+import * as typedrequest from '@api.global/typedrequest';
+import * as typedsocket from '@api.global/typedsocket';
+export { typedrequest, typedsocket };
+// @modelprofile.com scope
+import { FlexHarnessChatRequestError } from '@modelprofile.com/flexharness/chat/harness';
+export { FlexHarnessChatRequestError };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2NoYXRfaGFybmVzc190eXBlZHNvY2tldC9wbHVnaW5zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLG9CQUFvQjtBQUNwQixPQUFPLEtBQUssWUFBWSxNQUFNLDBCQUEwQixDQUFDO0FBQ3pELE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFFdkQsT0FBTyxFQUFFLFlBQVksRUFBRSxXQUFXLEVBQUUsQ0FBQztBQUdyQywwQkFBMEI7QUFDMUIsT0FBTyxFQUFFLDJCQUEyQixFQUFFLE1BQU0sNENBQTRDLENBQUM7QUFFekYsT0FBTyxFQUFFLDJCQUEyQixFQUFFLENBQUMifQ==

package/dist_ts_ocr/ocr.mistral.d.ts

@@ -5,6 +5,12 @@ export interface ISmartAiOcrImageInput {
     dataBase64: string;
     mimeType: TSmartAiOcrImageMimeType;
 }
+/** Mistral OCR reads PDF, PPTX, DOCX and other document formats. */
+export type TSmartAiOcrDocumentMimeType = 'application/pdf' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | string;
+export interface ISmartAiOcrDocumentInput {
+    dataBase64: string;
+    mimeType: TSmartAiOcrDocumentMimeType;
+}
 export interface ISmartAiOcrPageResult {
     index: number;
     text: string;
@@ -19,6 +25,10 @@ export interface ISmartAiOcrResult<TRaw = unknown> {
 export interface ISmartAiOcrEngine {
     recognizeImage: (input: ISmartAiOcrImageInput, options?: ISmartAiMistralOcrRecognizeOptions) => Promise<ISmartAiOcrResult<IMistralOcrResponse>>;
 }
+/** The Mistral OCR engine also reads whole documents, such as a PDF with all its pages. */
+export interface ISmartAiMistralOcrEngine extends ISmartAiOcrEngine {
+    recognizeDocument: (input: ISmartAiOcrDocumentInput, options?: ISmartAiMistralOcrRecognizeOptions) => Promise<ISmartAiOcrResult<IMistralOcrResponse>>;
+}
 export interface IMistralOcrPageConfidenceScores {
     average_page_confidence_score?: number;
     averagePageConfidenceScore?: number;
@@ -51,8 +61,17 @@ export interface IMistralOcrRequest {
     extract_footer?: boolean;
     confidence_scores_granularity?: TSmartAiMistralOcrConfidenceScoresGranularity;
 }
+/** A document (PDF, PPTX, DOCX and other formats) as a URL or a base64 data URL; the other fields are those of an image request. */
+export interface IMistralOcrDocumentRequest extends Omit<IMistralOcrRequest, 'document'> {
+    document: {
+        type: 'document_url';
+        document_url: string;
+    };
+}
 export interface ISmartAiMistralOcrTransport {
     process: (request: IMistralOcrRequest) => Promise<IMistralOcrResponse>;
+    /** Reads documents. A transport without it reads images only, and `recognizeDocument` refuses documents. */
+    processDocument?: (request: IMistralOcrDocumentRequest) => Promise<IMistralOcrResponse>;
 }
 export interface ISmartAiMistralOcrOptions {
     apiKey?: string;
@@ -72,4 +91,4 @@ export interface ISmartAiMistralOcrRecognizeOptions {
     extractFooter?: boolean;
     confidenceScoresGranularity?: TSmartAiMistralOcrConfidenceScoresGranularity;
 }
-export declare const createMistralOcrEngine: (options?: ISmartAiMistralOcrOptions) => ISmartAiOcrEngine;
+export declare const createMistralOcrEngine: (options?: ISmartAiMistralOcrOptions) => ISmartAiMistralOcrEngine;

package/dist_ts_ocr/ocr.mistral.js

@@ -1,32 +1,50 @@
 const defaultMistralOcrModel = 'mistral-ocr-latest';
 const defaultMistralOcrEndpointUrl = 'https://api.mistral.ai/v1/ocr';
 const createMistralOcrHttpTransport = (options) => {
-    return {
-        process: async (request) => {
-            if (!options.apiKey) {
-                throw new Error('Mistral OCR requires an apiKey when no custom transport is provided.');
-            }
-            const response = await fetch(options.endpointUrl ?? defaultMistralOcrEndpointUrl, {
-                method: 'POST',
-                headers: {
-                    Authorization: `Bearer ${options.apiKey}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify(request),
-            });
-            if (!response.ok) {
-                const errorBody = await response.text();
-                throw new Error(`Mistral OCR request failed with status ${response.status}: ${errorBody}`);
-            }
-            return (await response.json());
-        },
+    const post = async (request) => {
+        if (!options.apiKey) {
+            throw new Error('Mistral OCR requires an apiKey when no custom transport is provided.');
+        }
+        const response = await fetch(options.endpointUrl ?? defaultMistralOcrEndpointUrl, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${options.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(request),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`Mistral OCR request failed with status ${response.status}: ${errorBody}`);
+        }
+        return (await response.json());
     };
+    return { process: post, processDocument: post };
 };
 const getPageConfidence = (page) => {
     const confidenceScores = page.confidence_scores ?? page.confidenceScores;
     return (confidenceScores?.average_page_confidence_score ??
         confidenceScores?.averagePageConfidenceScore);
 };
+const toOcrResult = (response) => {
+    const pages = response.pages.map((page) => ({
+        index: page.index,
+        text: page.markdown,
+        confidence: getPageConfidence(page),
+    }));
+    const pageConfidences = pages
+        .map((page) => page.confidence)
+        .filter((confidence) => typeof confidence === 'number');
+    const confidence = pageConfidences.length
+        ? pageConfidences.reduce((sum, value) => sum + value, 0) / pageConfidences.length
+        : undefined;
+    return {
+        text: pages.map((page) => page.text).join('\n\n').trim(),
+        confidence,
+        pages,
+        raw: response,
+    };
+};
 export const createMistralOcrEngine = (options = {}) => {
     const transport = options.transport ??
         createMistralOcrHttpTransport({
@@ -34,6 +52,13 @@ export const createMistralOcrEngine = (options = {}) => {
             endpointUrl: options.endpointUrl,
         });
     const model = options.model ?? defaultMistralOcrModel;
+    const settingsOf = (recognizeOptions) => ({
+        include_image_base64: recognizeOptions.includeImageBase64 ?? options.includeImageBase64 ?? false,
+        table_format: recognizeOptions.tableFormat ?? options.tableFormat,
+        extract_header: recognizeOptions.extractHeader ?? options.extractHeader,
+        extract_footer: recognizeOptions.extractFooter ?? options.extractFooter,
+        confidence_scores_granularity: recognizeOptions.confidenceScoresGranularity ?? options.confidenceScoresGranularity,
+    });
     return {
         recognizeImage: async (input, recognizeOptions = {}) => {
             if (!input.dataBase64) {
@@ -42,36 +67,34 @@ export const createMistralOcrEngine = (options = {}) => {
             if (!input.mimeType) {
                 throw new Error('Mistral OCR image input requires mimeType.');
             }
-            const response = await transport.process({
+            return toOcrResult(await transport.process({
                 model,
                 document: {
                     type: 'image_url',
                     image_url: `data:${input.mimeType};base64,${input.dataBase64}`,
                 },
-                include_image_base64: recognizeOptions.includeImageBase64 ?? options.includeImageBase64 ?? false,
-                table_format: recognizeOptions.tableFormat ?? options.tableFormat,
-                extract_header: recognizeOptions.extractHeader ?? options.extractHeader,
-                extract_footer: recognizeOptions.extractFooter ?? options.extractFooter,
-                confidence_scores_granularity: recognizeOptions.confidenceScoresGranularity ?? options.confidenceScoresGranularity,
-            });
-            const pages = response.pages.map((page) => ({
-                index: page.index,
-                text: page.markdown,
-                confidence: getPageConfidence(page),
+                ...settingsOf(recognizeOptions),
+            }));
+        },
+        recognizeDocument: async (input, recognizeOptions = {}) => {
+            if (!transport.processDocument) {
+                throw new Error('This Mistral OCR transport reads images only: it has no processDocument, so it cannot read documents.');
+            }
+            if (!input.dataBase64) {
+                throw new Error('Mistral OCR document input requires dataBase64.');
+            }
+            if (!input.mimeType) {
+                throw new Error('Mistral OCR document input requires mimeType.');
+            }
+            return toOcrResult(await transport.processDocument({
+                model,
+                document: {
+                    type: 'document_url',
+                    document_url: `data:${input.mimeType};base64,${input.dataBase64}`,
+                },
+                ...settingsOf(recognizeOptions),
             }));
-            const pageConfidences = pages
-                .map((page) => page.confidence)
-                .filter((confidence) => typeof confidence === 'number');
-            const confidence = pageConfidences.length
-                ? pageConfidences.reduce((sum, value) => sum + value, 0) / pageConfidences.length
-                : undefined;
-            return {
-                text: pages.map((page) => page.text).join('\n\n').trim(),
-                confidence,
-                pages,
-                raw: response,
-            };
         },
     };
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib2NyLm1pc3RyYWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19vY3Ivb2NyLm1pc3RyYWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBZ0dBLE1BQU0sc0JBQXNCLEdBQUcsb0JBQW9CLENBQUM7QUFDcEQsTUFBTSw0QkFBNEIsR0FBRywrQkFBK0IsQ0FBQztBQUVyRSxNQUFNLDZCQUE2QixHQUFHLENBQUMsT0FHdEMsRUFBK0IsRUFBRTtJQUNoQyxPQUFPO1FBQ0wsT0FBTyxFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUUsRUFBRTtZQUN6QixJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDO2dCQUNwQixNQUFNLElBQUksS0FBSyxDQUFDLHNFQUFzRSxDQUFDLENBQUM7WUFDMUYsQ0FBQztZQUVELE1BQU0sUUFBUSxHQUFHLE1BQU0sS0FBSyxDQUFDLE9BQU8sQ0FBQyxXQUFXLElBQUksNEJBQTRCLEVBQUU7Z0JBQ2hGLE1BQU0sRUFBRSxNQUFNO2dCQUNkLE9BQU8sRUFBRTtvQkFDUCxhQUFhLEVBQUUsVUFBVSxPQUFPLENBQUMsTUFBTSxFQUFFO29CQUN6QyxjQUFjLEVBQUUsa0JBQWtCO2lCQUNuQztnQkFDRCxJQUFJLEVBQUUsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUM7YUFDOUIsQ0FBQyxDQUFDO1lBRUgsSUFBSSxDQUFDLFFBQVEsQ0FBQyxFQUFFLEVBQUUsQ0FBQztnQkFDakIsTUFBTSxTQUFTLEdBQUcsTUFBTSxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7Z0JBQ3hDLE1BQU0sSUFBSSxLQUFLLENBQUMsMENBQTBDLFFBQVEsQ0FBQyxNQUFNLEtBQUssU0FBUyxFQUFFLENBQUMsQ0FBQztZQUM3RixDQUFDO1lBRUQsT0FBTyxDQUFDLE1BQU0sUUFBUSxDQUFDLElBQUksRUFBRSxDQUF3QixDQUFDO1FBQ3hELENBQUM7S0FDRixDQUFDO0FBQ0osQ0FBQyxDQUFDO0FBRUYsTUFBTSxpQkFBaUIsR0FB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib2NyLm1pc3RyYWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19vY3Ivb2NyLm1pc3RyYWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBOEhBLE1BQU0sc0JBQXNCLEdBQUcsb0JBQW9CLENBQUM7QUFDcEQsTUFBTSw0QkFBNEIsR0FBRywrQkFBK0IsQ0FBQztBQUVyRSxNQUFNLDZCQUE2QixHQUFHLENBQUMsT0FHdEMsRUFBK0IsRUFBRTtJQUNoQyxNQUFNLElBQUksR0FBRyxLQUFLLEVBQUUsT0FBd0QsRUFBZ0MsRUFBRTtRQUM1RyxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ3BCLE1BQU0sSUFBSSxLQUFLLENBQUMsc0VBQXNFLENBQUMsQ0FBQztRQUMxRixDQUFDO1FBRUQsTUFBTSxRQUFRLEdBQUcsTUFBTSxLQUFLLENBQUMsT0FBTyxDQUFDLFdBQVcsSUFBSSw0QkFBNEIsRUFBRTtZQUNoRixNQUFNLEVBQUUsTUFBTTtZQUNkLE9BQU8sRUFBRTtnQkFDUCxhQUFhLEVBQUUsVUFBVSxPQUFPLENBQUMsTUFBTSxFQUFFO2dCQUN6QyxjQUFjLEVBQUUsa0JBQWtCO2FBQ25DO1lBQ0QsSUFBSSxFQUFFLElBQUksQ0FBQyxTQUFTLENBQUMsT0FBTyxDQUFDO1NBQzlCLENBQUMsQ0FBQztRQUVILElBQUksQ0FBQyxRQUFRLENBQUMsRUFBRSxFQUFFLENBQUM7WUFDakIsTUFBTSxTQUFTLEdBQUcsTUFBTSxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDeEMsTUFBTSxJQUFJLEtBQUssQ0FBQywwQ0FBMEMsUUFBUSxDQUFDLE1BQU0sS0FBSyxTQUFTLEVBQUUsQ0FBQyxDQUFDO1FBQzdGLENBQUM7UUFFRCxPQUFPLENBQUMsTUFBTSxRQUFRLENBQUMsSUFBSSxFQUFFLENBQXdCLENBQUM7SUFDeEQsQ0FBQyxDQUFDO0lBQ0YsT0FBTyxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsZUFBZSxFQUFFLElBQUks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

package/dist_ts_tools/tool.filesystem.d.ts

@@ -3,6 +3,8 @@ import { type IToolExecutionContext } from './tool.context.js';
 export interface ICreateFilesystemToolsOptions {
     /** Include delete_file. Default: true. */
     includeDelete?: boolean;
+    /** Include edit_file, which replaces an exact snippet of a file. Default: false. */
+    includeEdit?: boolean;
     /** Maximum output lines before truncating. */
     maxLines?: number;
     /** Maximum output bytes before truncating. */