@dxos/assistant 0.7.4 → 0.7.5-labs.071a3e2

package/dist/types/src/ai-service/client.d.ts

@@ -1,48 +1,32 @@
-import type { SpaceId } from '@dxos/keys';
-import { Message, type GenerateRequest, type ObjectId, type ResultStreamEvent, type Space, type Thread } from './schema';
-export type AIServiceClientParams = {
-    endpoint: string;
-};
+import { Message, type Space, type Thread } from '@dxos/artifact';
+import { type SpaceId } from '@dxos/keys';
+import { type GenerationStream } from './stream';
+import { type GenerateRequest } from './types';
 export interface AIServiceClient {
     getSpace(spaceId: SpaceId): Promise<Space>;
     getThread(spaceId: SpaceId, threadId: string): Promise<Thread>;
-    getMessagesInThread(spaceId: SpaceId, threadId: string): Promise<Message[]>;
-    insertMessages(messages: Message[]): Promise<void>;
+    getMessages(spaceId: SpaceId, threadId: string): Promise<Message[]>;
+    appendMessages(messages: Message[]): Promise<void>;
     updateMessage(spaceId: SpaceId, threadId: string, messageId: string, message: Message): Promise<void>;
     generate(request: GenerateRequest): Promise<GenerationStream>;
 }
+export type AIServiceClientParams = {
+    endpoint: string;
+};
+/**
+ * Edge GPT client.
+ */
 export declare class AIServiceClientImpl implements AIServiceClient {
     private readonly _endpoint;
     constructor({ endpoint }: AIServiceClientParams);
     getSpace(spaceId: SpaceId): Promise<Space>;
     getThread(spaceId: SpaceId, threadId: string): Promise<Thread>;
-    getMessagesInThread(spaceId: SpaceId, threadId: string): Promise<Message[]>;
-    insertMessages(messages: Message[]): Promise<void>;
+    getMessages(spaceId: SpaceId, threadId: string): Promise<Message[]>;
+    appendMessages(messages: Message[]): Promise<void>;
     updateMessage(spaceId: SpaceId, threadId: string, messageId: string, message: Message): Promise<void>;
-    generate(request: GenerateRequest): Promise<GenerationStream>;
-}
-type GenerationParams = {
-    spaceId: SpaceId;
-    threadId: ObjectId;
-};
-export declare class GenerationStream implements AsyncIterable<ResultStreamEvent> {
-    private readonly _params;
-    private readonly _getIterator;
-    static fromSSEResponse(params: GenerationParams, response: Response): GenerationStream;
-    private _previousMessages;
-    private _accumulatedMessage?;
-    private _done;
-    private _iterator?;
-    constructor(_params: GenerationParams, _getIterator: () => AsyncIterableIterator<ResultStreamEvent>);
-    [Symbol.asyncIterator](): AsyncIterator<ResultStreamEvent>;
-    cancel(): void;
-    get accumulatedMessages(): Message[];
     /**
-     * Returns the complete message list generated by the AI service.
+     * Open message stream.
      */
-    complete(): Promise<Message[]>;
-    private _createIterator;
-    private _processEvent;
+    generate(request: GenerateRequest): Promise<GenerationStream>;
 }
-export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/types/src/ai-service/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/client.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EACL,OAAO,EACP,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,KAAK,EACV,KAAK,MAAM,EACZ,MAAM,UAAU,CAAC;AAIlB,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/D;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBACvB,EAAE,QAAQ,EAAE,EAAE,qBAAqB;IAIzC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAI1C,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAK3E,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgBpE;AAED,KAAK,gBAAgB,GAAG;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,qBAAa,gBAAiB,YAAW,aAAa,CAAC,iBAAiB,CAAC;IAkDrE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAlD/B,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ;IA2CnE,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAC,CAA+C;gBAG9C,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,MAAM,qBAAqB,CAAC,iBAAiB,CAAC;IAG/E,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAI1D,MAAM;IAIN,IAAI,mBAAmB,IAAI,OAAO,EAAE,CAGnC;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKpC,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,aAAa;CA4DtB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/D;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AAEH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,EAAE,QAAQ,EAAE,EAAE,qBAAqB;IAKzC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAI1C,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAKnE,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlD,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3G;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAYpE"}

package/dist/types/src/ai-service/index.d.ts

@@ -1,3 +1,6 @@
 export * from './client';
-export * from './schema';
+export * from './parser';
+export * from './stream';
+export * from './transform';
+export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/ai-service/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/types/src/ai-service/parser.d.ts

@@ -0,0 +1,136 @@
+import { type MessageContentBlock } from '@dxos/artifact';
+import { Event } from '@dxos/async';
+import { type GenerationStream } from './stream';
+import { type StreamBlock } from './transform';
+/**
+ * Parse mixed content of plain text, XML fragments, and JSON blocks.
+ */
+export declare class MixedStreamParser {
+    /**
+     * New message.
+     */
+    message: Event<{
+        readonly id: string;
+        spaceId?: import("packages/common/keys/dist/types/src").SpaceId | undefined;
+        content: ({
+            pending?: boolean | undefined;
+            type: "text";
+            text: string;
+            disposition?: string | undefined;
+        } | {
+            pending?: boolean | undefined;
+            type: "json";
+            disposition?: string | undefined;
+            json: string;
+        } | {
+            pending?: boolean | undefined;
+            id?: string | undefined;
+            type: "image";
+            source?: {
+                type: "base64";
+                mediaType: string;
+                data: string;
+            } | undefined;
+        } | {
+            pending?: boolean | undefined;
+            id: string;
+            type: "tool_use";
+            name: string;
+            input: unknown;
+        } | {
+            pending?: boolean | undefined;
+            type: "tool_result";
+            toolUseId: string;
+            content: string;
+            isError?: boolean | undefined;
+        })[];
+        threadId?: string | undefined;
+        foreignId?: string | undefined;
+        role: "user" | "assistant";
+    }>;
+    /**
+     * Complete block added to Message.
+     */
+    block: Event<{
+        pending?: boolean | undefined;
+        type: "text";
+        disposition?: string | undefined;
+        text: string;
+    } | {
+        pending?: boolean | undefined;
+        type: "json";
+        disposition?: string | undefined;
+        json: string;
+    } | {
+        pending?: boolean | undefined;
+        type: "image";
+        id?: string | undefined;
+        source?: {
+            type: "base64";
+            mediaType: string;
+            data: string;
+        } | undefined;
+    } | {
+        pending?: boolean | undefined;
+        name: string;
+        type: "tool_use";
+        id: string;
+        input: unknown;
+    } | {
+        pending?: boolean | undefined;
+        type: "tool_result";
+        content: string;
+        toolUseId: string;
+        isError?: boolean | undefined;
+    }>;
+    /**
+     * Update partial block (while streaming).
+     */
+    update: Event<{
+        pending?: boolean | undefined;
+        type: "text";
+        disposition?: string | undefined;
+        text: string;
+    } | {
+        pending?: boolean | undefined;
+        type: "json";
+        disposition?: string | undefined;
+        json: string;
+    } | {
+        pending?: boolean | undefined;
+        type: "image";
+        id?: string | undefined;
+        source?: {
+            type: "base64";
+            mediaType: string;
+            data: string;
+        } | undefined;
+    } | {
+        pending?: boolean | undefined;
+        name: string;
+        type: "tool_use";
+        id: string;
+        input: unknown;
+    } | {
+        pending?: boolean | undefined;
+        type: "tool_result";
+        content: string;
+        toolUseId: string;
+        isError?: boolean | undefined;
+    }>;
+    /**
+     * Current message.
+     */
+    private _message?;
+    private _emitBlock;
+    private _emitUpdate;
+    /**
+     * Parse stream until end.
+     */
+    parse(stream: GenerationStream): Promise<void>;
+}
+/**
+ * Convert stream block to message content block.
+ */
+export declare const mergeMessageBlock: (contentBlock: MessageContentBlock, streamBlock: StreamBlock) => MessageContentBlock | undefined;
+//# sourceMappingURL=parser.d.ts.map

package/dist/types/src/ai-service/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/parser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAMpC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhE;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACI,OAAO;;;;mBA8IM,CAAH;;;uBACwB,CAAC;;mBAEpB,CAApB;;uBACoB,CAApB;;;mBAC4B,CAAC;cACP,CAAX;;kBACS,CAAN;;;;;;mBAIE,CAAN;;;;;;mBAOI,CAAX;;;;mBAEsC,CAAC;;;;;OAlKN;IAEtC;;OAEG;IACI,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAoC;IAEhD;;OAEG;IACI,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAoC;IAEjD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,CAAsB;IAEvC,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,gBAAgB;CA4LrC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,iBACd,mBAAmB,eACpB,WAAW,KACvB,mBAAmB,GAAG,SA+ExB,CAAC"}

package/dist/types/src/ai-service/stream.d.ts

@@ -0,0 +1,39 @@
+import { type GenerationStreamEvent } from './types';
+/**
+ * Creates a stream from an SSE response.
+ */
+export declare const createGenerationStream: (response: Response, controller?: AbortController) => GenerationStream;
+/**
+ * Server-Sent Events (SSE) stream from the AI service.
+ * https://html.spec.whatwg.org/multipage/server-sent-events.html#server-sent-events
+ */
+export declare class GenerationStream implements AsyncIterable<GenerationStreamEvent> {
+    private readonly _controller;
+    private readonly _getIterator;
+    /**
+     * Trigger event when the stream is done.
+     */
+    private readonly _done;
+    /**
+     * Iterator over the stream.
+     */
+    private _iterator?;
+    constructor(_controller: AbortController, _getIterator: () => AsyncIterableIterator<GenerationStreamEvent>);
+    /**
+     * Returns an iterator over the stream.
+     */
+    [Symbol.asyncIterator](): AsyncIterator<GenerationStreamEvent>;
+    /**
+     * Aborts the stream.
+     */
+    abort(): void;
+    /**
+     * Returns the complete message list generated by the AI service.
+     */
+    complete(): Promise<void>;
+    /**
+     * Creates an iterator over the stream.
+     */
+    private _createIterator;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/types/src/ai-service/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/stream.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGrD;;GAEG;AACH,eAAO,MAAM,sBAAsB,aAAc,QAAQ,mDAuCxD,CAAC;AAEF;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,aAAa,CAAC,qBAAqB,CAAC;IAYzE,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAZ/B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IAEvC;;OAEG;IACH,OAAO,CAAC,SAAS,CAAC,CAAmD;gBAGlD,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,MAAM,qBAAqB,CAAC,qBAAqB,CAAC;IAGnF;;OAEG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,qBAAqB,CAAC;IAI9D;;OAEG;IACH,KAAK;IAIL;;OAEG;IACG,QAAQ;IAId;;OAEG;IACH,OAAO,CAAC,eAAe;CAiBxB"}

package/dist/types/src/ai-service/stream.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stream.test.d.ts.map

package/dist/types/src/ai-service/stream.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.test.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/stream.test.ts"],"names":[],"mappings":""}

package/dist/types/src/ai-service/testing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mock server-side events (SSE) stream.
+ */
+export declare const createTestSSEStream: (pars: (string | object)[], { splitBy }?: {
+    splitBy?: "word" | "character";
+}) => ReadableStream;
+//# sourceMappingURL=testing.d.ts.map

package/dist/types/src/ai-service/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/testing.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,mBAAmB,SACxB,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,gBACH;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,KACvD,cA8EF,CAAC"}

package/dist/types/src/ai-service/transform.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Parsed block.
+ */
+export type StreamBlock = {
+    type: 'tag';
+    tag: string;
+    attributes?: Record<string, string>;
+    content: StreamBlock[];
+    closing?: boolean;
+    selfClosing?: boolean;
+} | {
+    type: 'text';
+    content: string;
+} | {
+    type: 'json';
+    disposition?: string;
+    content: string;
+};
+/**
+ * Permissive streaming transformer that processes mixed content (plain text and XML fragments) from the AI service.
+ */
+export declare class StreamTransform {
+    private _buffer;
+    transform(chunk: string): StreamBlock[];
+    flush(): StreamBlock[];
+}
+//# sourceMappingURL=transform.d.ts.map

package/dist/types/src/ai-service/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/transform.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAiE5D;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAM;IAErB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAkBvC,KAAK,IAAI,WAAW,EAAE;CAYvB"}

package/dist/types/src/ai-service/types.d.ts

@@ -0,0 +1,150 @@
+import { Schema as S } from '@effect/schema';
+import { Message, type MessageContentBlock } from '@dxos/artifact';
+import { ObjectId } from '@dxos/echo-schema';
+export declare const createArtifactElement: (id: ObjectId) => string;
+export declare const LLMModel: S.Literal<["@anthropic/claude-3-5-haiku-20241022", "@anthropic/claude-3-5-sonnet-20241022", "@cf/deepseek-ai/deepseek-r1-distill-qwen-32b", "@hf/nousresearch/hermes-2-pro-mistral-7b", "@ollama/llama-3-2-3b", "@ollama/llama-3-1-nemotron-70b-instruct", "@ollama/llama-3-1-nemotron-mini-4b-instruct"]>;
+export type LLMModel = S.Schema.Type<typeof LLMModel>;
+export declare const ToolTypes: Readonly<{
+    TextToImage: "text_to_image";
+}>;
+/**
+ * Client GPT request.
+ */
+export declare const GenerateRequest: S.Struct<{
+    spaceId: S.optional<S.Schema<import("packages/common/keys/dist/types/src").SpaceId, string, never>>;
+    threadId: S.optional<import("@dxos/echo-schema").ObjectIdClass>;
+    model: S.Literal<["@anthropic/claude-3-5-haiku-20241022", "@anthropic/claude-3-5-sonnet-20241022", "@cf/deepseek-ai/deepseek-r1-distill-qwen-32b", "@hf/nousresearch/hermes-2-pro-mistral-7b", "@ollama/llama-3-2-3b", "@ollama/llama-3-1-nemotron-70b-instruct", "@ollama/llama-3-1-nemotron-mini-4b-instruct"]>;
+    /**
+     * Current request.
+     */
+    /**
+     * System instructions to the LLM.
+     */
+    systemPrompt: S.optional<typeof S.String>;
+    /**
+     * History of messages to include in the context window.
+     */
+    history: S.optional<S.Array$<S.Schema<{
+        readonly id: string;
+        spaceId?: import("packages/common/keys/dist/types/src").SpaceId | undefined;
+        content: ({
+            pending?: boolean | undefined;
+            type: "text";
+            text: string;
+            disposition?: string | undefined;
+        } | {
+            pending?: boolean | undefined;
+            type: "json";
+            disposition?: string | undefined;
+            json: string;
+        } | {
+            pending?: boolean | undefined;
+            id?: string | undefined;
+            type: "image";
+            source?: {
+                type: "base64";
+                mediaType: string;
+                data: string;
+            } | undefined;
+        } | {
+            pending?: boolean | undefined;
+            id: string;
+            type: "tool_use";
+            name: string;
+            input: unknown;
+        } | {
+            pending?: boolean | undefined;
+            type: "tool_result";
+            toolUseId: string;
+            content: string;
+            isError?: boolean | undefined;
+        })[];
+        threadId?: string | undefined;
+        foreignId?: string | undefined;
+        role: "user" | "assistant";
+    }, {
+        readonly id: string;
+        spaceId?: import("packages/common/keys/dist/types/src").SpaceId | undefined;
+        content: ({
+            pending?: boolean | undefined;
+            type: "text";
+            text: string;
+            disposition?: string | undefined;
+        } | {
+            pending?: boolean | undefined;
+            type: "json";
+            disposition?: string | undefined;
+            json: string;
+        } | {
+            pending?: boolean | undefined;
+            id?: string | undefined;
+            type: "image";
+            source?: {
+                type: "base64";
+                mediaType: string;
+                data: string;
+            } | undefined;
+        } | {
+            pending?: boolean | undefined;
+            id: string;
+            type: "tool_use";
+            name: string;
+            input: unknown;
+        } | {
+            pending?: boolean | undefined;
+            type: "tool_result";
+            toolUseId: string;
+            content: string;
+            isError?: boolean | undefined;
+        })[];
+        threadId?: string | undefined;
+        foreignId?: string | undefined;
+        role: "user" | "assistant";
+    }, never>>>;
+    /**
+     * Tools available for the LLM.
+     */
+    tools: S.optional<S.mutable<S.Array$<S.Struct<{
+        name: typeof S.String;
+        type: S.optional<typeof S.String>;
+        description: S.optional<typeof S.String>;
+        parameters: S.optional<S.Schema<import("@dxos/echo-schema").JsonSchemaType, import("@dxos/echo-schema").JsonSchemaType, never>>;
+        options: S.optional<typeof S.Any>;
+    }>>>>;
+}>;
+export type GenerateRequest = S.Schema.Type<typeof GenerateRequest>;
+/**
+ * Server-Sent Events (SSE) stream from the AI service.
+ * https://docs.anthropic.com/en/api/streaming
+ * https://platform.openai.com/docs/api-reference/streaming
+ * https://html.spec.whatwg.org/multipage/server-sent-events.html#server-sent-events
+ */
+export type GenerationStreamEvent = {
+    type: 'message_start';
+    message: Omit<Message, 'spaceId' | 'threadId'>;
+} | {
+    type: 'message_delta';
+    delta: {
+        stopReason: 'tool_use' | 'end_turn';
+    };
+} | {
+    type: 'message_stop';
+} | {
+    type: 'content_block_start';
+    index: number;
+    content: MessageContentBlock;
+} | {
+    type: 'content_block_delta';
+    index: number;
+    delta: {
+        type: 'text_delta';
+        text: string;
+    } | {
+        type: 'input_json_delta';
+        partial_json: string;
+    };
+} | {
+    type: 'content_block_stop';
+    index: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/src/ai-service/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAQ,OAAO,EAAE,KAAK,mBAAmB,EAAiB,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,eAAO,MAAM,qBAAqB,OAAQ,QAAQ,WAA4B,CAAC;AAE/E,eAAO,MAAM,QAAQ,4SAQpB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEtD,eAAO,MAAM,SAAS;;EAIpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;IAO1B;;OAEG;IAIH;;OAEG;;IAGH;;OAEG;;;;;mBAuDoiE,CAAC;;;uBAAsF,CAAC;;mBAA+C,CAAC;;uBAAgE,CAAC;;;mBAAqE,CAAC;cAAiC,CAAC;;kBAA2D,CAAC;;;;;;mBAAyI,CAAC;;;;;;mBAA4I,CAAC;;;;mBAAuH,CAAC;;;;;;;;;mBAAwO,CAAC;;;uBAAsF,CAAC;;mBAA+C,CAAC;;uBAAgE,CAAC;;;mBAAqE,CAAC;cAAiC,CAAC;;kBAA2D,CAAC;;;;;;mBAAyI,CAAC;;;;;;mBAA4I,CAAC;;;;mBAAuH,CAAC;;;;;;IApDvwH;;OAEG;;qBAQmB,EAAG,MAAM;cAS3B,EAAG,QAAQ,QAAO,EAAG,MAAM;qBAKzB,EAAA,QAAK,QAAO,EAAG,MAAM;oBASvB,EAAE,QAAQ,CAAC,EAAE,MAAM;iBAQb,EAAA,QAAA,QAAO,EAAG,GAAG;;EArCvB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC;AAEpE;;;;;GAKG;AAEH,MAAM,MAAM,qBAAqB,GAC7B;IAEE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;CAChD,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE;QACL,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;KACrC,CAAC;CACH,GACD;IACE,IAAI,EAAE,cAAc,CAAC;CACtB,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,mBAAmB,CAAC;CAC9B,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EACD;QACE,IAAI,EAAE,YAAY,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;KACd,GACD;QACE,IAAI,EAAE,kBAAkB,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACP,GACD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/types/src/ai-service/util/index.d.ts

@@ -0,0 +1,2 @@
+export * from './sse';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/ai-service/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,OAAO,CAAC"}

package/dist/types/src/ai-service/{sse.d.ts → util/sse.d.ts}

@@ -1,3 +1,8 @@
+/**
+ * Server sent events (SSE) iterator.
+ * @param response
+ * @param controller
+ */
 export declare function iterSSEMessages(response: Response, controller: AbortController): AsyncGenerator<ServerSentEvent, void, unknown>;
 export type ServerSentEvent = {
     event: string | null;

package/dist/types/src/ai-service/util/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/util/sse.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAuB,eAAe,CACpC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,eAAe,GAC1B,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,OAAO,CAAC,CAyBhD;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;CACf,CAAC;AA8HF,uEAAuE;AACvE,eAAO,MAAM,aAAa,WAAY,MAAM,EAAE,KAAG,MAAM,EAQtD,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,qBAAqB,CAAC,CAAC,CAAC,CA6BpF;AAED,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAElF;;;;;GAKG;AACH,qBAAa,WAAW;IAEtB,MAAM,CAAC,aAAa,cAAyB;IAC7C,MAAM,CAAC,cAAc,SAAkB;IAEvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;;IAOjB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE;IA0C9B,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAuChC,KAAK,IAAI,MAAM,EAAE;CAUlB"}

package/dist/types/src/conversation/conversation.d.ts

@@ -1,23 +1,78 @@
+import { type Tool, Message } from '@dxos/artifact';
+import { ObjectId } from '@dxos/echo-schema';
 import { type SpaceId } from '@dxos/keys';
-import { ObjectId, type LLMTool } from '../ai-service';
-import { type AIServiceClient, type Message, type ResultStreamEvent, type LLMModel } from '../ai-service';
+import { type AIServiceClient, type GenerationStreamEvent, type LLMModel } from '../ai-service';
 export type CreateLLMConversationParams = {
     model: LLMModel;
+    spaceId?: SpaceId;
+    threadId?: ObjectId;
     /**
      * System prompt that specifies instructions for the LLM.
      */
     system?: string;
-    spaceId: SpaceId;
-    threadId: ObjectId;
-    tools: LLMTool[];
+    tools: Tool[];
+    history?: Message[];
     client: AIServiceClient;
     logger?: (event: ConversationEvent) => void;
 };
 export type ConversationEvent = {
     type: 'message';
     message: Message;
-} | ResultStreamEvent;
+} | GenerationStreamEvent;
 export declare const runLLM: (params: CreateLLMConversationParams) => Promise<{
     result: any;
+    history: {
+        readonly id: string;
+        spaceId?: SpaceId | undefined;
+        content: ({
+            pending?: boolean | undefined;
+            type: "text";
+            text: string;
+            disposition?: string | undefined;
+        } | {
+            pending?: boolean | undefined;
+            type: "json";
+            disposition?: string | undefined;
+            json: string;
+        } | {
+            pending?: boolean | undefined;
+            id?: string | undefined;
+            type: "image";
+            source?: {
+                type: "base64";
+                mediaType: string;
+                data: string;
+            } | undefined;
+        } | {
+            pending?: boolean | undefined;
+            id: string;
+            type: "tool_use";
+            name: string;
+            input: unknown;
+        } | {
+            pending?: boolean | undefined;
+            type: "tool_result";
+            toolUseId: string;
+            content: string;
+            isError?: boolean | undefined;
+        })[];
+        threadId?: string | undefined;
+        foreignId?: string | undefined;
+        role: "user" | "assistant";
+    }[];
 }>;
+export declare const isToolUse: (message: Message) => boolean;
+export type RunToolsOptions = {
+    message: Message;
+    tools: Tool[];
+    extensions?: ToolContextExtensions;
+};
+export type RunToolsResult = {
+    type: 'continue';
+    message: Message;
+} | {
+    type: 'break';
+    result: unknown;
+};
+export declare const runTools: ({ message, tools, extensions }: RunToolsOptions) => Promise<RunToolsResult>;
 //# sourceMappingURL=conversation.d.ts.map

package/dist/types/src/conversation/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../../src/conversation/conversation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1G,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,QAAQ,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IAEnB,KAAK,EAAE,OAAO,EAAE,CAAC;IAEjB,MAAM,EAAE,eAAe,CAAC;IAExB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GACD,iBAAiB,CAAC;AAEtB,eAAO,MAAM,MAAM,WAAkB,2BAA2B;;EAgG/D,CAAC"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../../src/conversation/conversation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAc,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAgB,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEhG,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,QAAQ,CAAC;IAEhB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IAExB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GACD,qBAAqB,CAAC;AAG1B,eAAO,MAAM,MAAM,WAAkB,2BAA2B;;;;;;mBAsIY,CAAC;;;uBAGlE,CAAC;;mBAA+C,CAAC;;uBAEjB,CAAC;;;mBAK/B,CAAC;cACI,CAAC;;kBACT,CAAA;;;;;;mBAMN,CAAC;;;;;;mBAGU,CAAC;;;;mBAKH,CAAC;;;;;;EAnDb,CAAC;AAEF,eAAO,MAAM,SAAS,YAAa,OAAO,YAIzC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEN,eAAO,MAAM,QAAQ,mCAA0C,eAAe,KAAG,OAAO,CAAC,cAAc,CAoEtG,CAAC"}

package/dist/types/src/conversation/index.d.ts

@@ -1,3 +1,2 @@
 export * from './conversation';
-export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/conversation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/conversation/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/conversation/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC"}