@dxos/assistant 0.8.2-main.5885341 → 0.8.2-main.600d381

package/dist/lib/node-esm/{chunk-7JI4MDGL.mjs → chunk-GCJNPQDJ.mjs}

@@ -495,223 +495,57 @@ function* emitMessageAsEvents(message) {
 }
 
 // packages/experimental/assistant/src/ai-service/types.ts
-import { Schema as S } from "effect";
+import { Schema } from "effect";
 import { Tool, Message } from "@dxos/artifact";
 var createArtifactElement = (id) => `<artifact id=${id} />`;
-var LLMModel = S.Literal(...DEFAULT_EDGE_MODELS, ...DEFAULT_OLLAMA_MODELS);
+var LLMModel = Schema.Literal(...DEFAULT_EDGE_MODELS, ...DEFAULT_OLLAMA_MODELS);
 var ToolTypes = Object.freeze({
   // TODO(dmaretskyi): Not implemented yet.
   // DatabaseQuery: 'database_query',
   TextToImage: "text_to_image"
 });
-var GenerateRequest = S.Struct({
+var GenerateRequest = Schema.Struct({
   /**
   * Preferred model or system default.
   */
-  model: S.optional(LLMModel),
+  model: Schema.optional(LLMModel),
   /**
   * Tools available for the LLM.
   */
-  tools: S.optional(S.Array(Tool).pipe(S.mutable)),
+  tools: Schema.optional(Schema.Array(Tool).pipe(Schema.mutable)),
   /**
   * System instructions to the LLM.
   */
-  systemPrompt: S.optional(S.String),
+  systemPrompt: Schema.optional(Schema.String),
   /**
   * History of messages to include in the context window.
   */
   // TODO(burdon): Rename messages.
-  history: S.optional(S.Array(Message)),
+  history: Schema.optional(Schema.Array(Message)),
   /**
   * Current request.
   */
-  prompt: S.optional(Message)
+  prompt: Schema.optional(Message)
 });
-var GenerateResponse = S.Struct({
-  messages: S.Array(Message),
+var GenerateResponse = Schema.Struct({
+  messages: Schema.Array(Message),
   /**
   * Number of tokens used in the response.
   */
-  tokenCount: S.optional(S.Number)
+  tokenCount: Schema.optional(Schema.Number)
 });
 
-// packages/experimental/assistant/src/conversation/conversation.ts
-import { ToolResult, Message as Message2 } from "@dxos/artifact";
-import { create, ObjectId } from "@dxos/echo-schema";
+// packages/experimental/assistant/src/session/tools.ts
+import { Message as Message2, ToolResult } from "@dxos/artifact";
+import { create } from "@dxos/echo-schema";
 import { invariant as invariant2 } from "@dxos/invariant";
 import { log as log3 } from "@dxos/log";
-var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/conversation/conversation.ts";
-var runLLM = async (params) => {
-  let conversationResult = null;
-  const history = params.history ?? [];
-  const generate = async () => {
-    log3("llm generate", {
-      tools: params.tools
-    }, {
-      F: __dxlog_file3,
-      L: 44,
-      S: void 0,
-      C: (f, a) => f(...a)
-    });
-    const beginTs = Date.now();
-    const stream = await params.client.execStream({
-      model: params.model,
-      history,
-      systemPrompt: params.system,
-      tools: params.tools
-    });
-    for await (const event of stream) {
-      params.logger?.(event);
-    }
-    await stream.complete();
-    const messages = [];
-    const message = messages.at(-1);
-    invariant2(message, void 0, {
-      F: __dxlog_file3,
-      L: 61,
-      S: void 0,
-      A: [
-        "message",
-        ""
-      ]
-    });
-    log3("llm result", {
-      time: Date.now() - beginTs,
-      message
-    }, {
-      F: __dxlog_file3,
-      L: 63,
-      S: void 0,
-      C: (f, a) => f(...a)
-    });
-    invariant2(message, void 0, {
-      F: __dxlog_file3,
-      L: 64,
-      S: void 0,
-      A: [
-        "message",
-        ""
-      ]
-    });
-    params.logger?.({
-      type: "message",
-      message
-    });
-    history.push(...messages.map((message2) => ({
-      ...message2,
-      content: message2.content.filter((block) => block.type !== "image")
-    })));
-    const isToolUse2 = message.content.at(-1)?.type === "tool_use";
-    if (isToolUse2) {
-      const toolCalls = message.content.filter((block) => block.type === "tool_use");
-      invariant2(toolCalls.length === 1, void 0, {
-        F: __dxlog_file3,
-        L: 75,
-        S: void 0,
-        A: [
-          "toolCalls.length === 1",
-          ""
-        ]
-      });
-      const toolCall = toolCalls[0];
-      const tool = params.tools.find((tool2) => tool2.name === toolCall.name);
-      if (!tool) {
-        throw new Error(`Tool not found: ${toolCall.name}`);
-      }
-      invariant2(tool.execute, void 0, {
-        F: __dxlog_file3,
-        L: 82,
-        S: void 0,
-        A: [
-          "tool.execute",
-          ""
-        ]
-      });
-      const toolResult = await tool.execute(toolCall.input);
-      switch (toolResult.kind) {
-        case "error": {
-          log3.warn("tool error", {
-            message: toolResult.message
-          }, {
-            F: __dxlog_file3,
-            L: 86,
-            S: void 0,
-            C: (f, a) => f(...a)
-          });
-          const resultMessage = {
-            id: ObjectId.random(),
-            role: "user",
-            content: [
-              {
-                type: "tool_result",
-                toolUseId: toolCall.id,
-                content: toolResult.message,
-                isError: true
-              }
-            ]
-          };
-          params.logger?.({
-            type: "message",
-            message: resultMessage
-          });
-          history.push(resultMessage);
-          return true;
-        }
-        case "success": {
-          log3("tool success", {
-            result: toolResult.result
-          }, {
-            F: __dxlog_file3,
-            L: 106,
-            S: void 0,
-            C: (f, a) => f(...a)
-          });
-          const resultMessage = {
-            id: ObjectId.random(),
-            role: "user",
-            content: [
-              {
-                type: "tool_result",
-                toolUseId: toolCall.id,
-                content: JSON.stringify(toolResult.result)
-              }
-            ]
-          };
-          params.logger?.({
-            type: "message",
-            message: resultMessage
-          });
-          history.push(resultMessage);
-          return true;
-        }
-        case "break": {
-          log3("tool break", {
-            result: toolResult.result
-          }, {
-            F: __dxlog_file3,
-            L: 125,
-            S: void 0,
-            C: (f, a) => f(...a)
-          });
-          conversationResult = toolResult.result;
-          return false;
-        }
-      }
-    }
-    return false;
-  };
-  while (await generate()) {
-  }
-  return {
-    result: conversationResult,
-    history
-  };
-};
+var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/session/tools.ts";
 var isToolUse = (message, { onlyToolNames } = {}) => {
   const block = message.content.at(-1);
   invariant2(block, void 0, {
     F: __dxlog_file3,
-    L: 146,
+    L: 12,
     S: void 0,
     A: [
       "block",
@@ -724,7 +558,7 @@ var runTools = async ({ message, tools, extensions }) => {
   const toolCalls = message.content.filter((block) => block.type === "tool_use");
   invariant2(toolCalls.length === 1, void 0, {
     F: __dxlog_file3,
-    L: 168,
+    L: 34,
     S: void 0,
     A: [
       "toolCalls.length === 1",
@@ -754,7 +588,7 @@ var runTools = async ({ message, tools, extensions }) => {
   try {
     invariant2(tool.execute, void 0, {
       F: __dxlog_file3,
-      L: 193,
+      L: 59,
       S: void 0,
       A: [
         "tool.execute",
@@ -769,7 +603,7 @@ var runTools = async ({ message, tools, extensions }) => {
       error
     }, {
       F: __dxlog_file3,
-      L: 196,
+      L: 62,
       S: void 0,
       C: (f, a) => f(...a)
     });
@@ -781,7 +615,7 @@ var runTools = async ({ message, tools, extensions }) => {
         message: toolResult.message
       }, {
         F: __dxlog_file3,
-        L: 202,
+        L: 68,
         S: void 0,
         C: (f, a) => f(...a)
       });
@@ -806,7 +640,7 @@ var runTools = async ({ message, tools, extensions }) => {
         result: toolResult.result
       }, {
         F: __dxlog_file3,
-        L: 223,
+        L: 89,
         S: void 0,
         C: (f, a) => f(...a)
       });
@@ -831,7 +665,7 @@ var runTools = async ({ message, tools, extensions }) => {
         result: toolResult.result
       }, {
         F: __dxlog_file3,
-        L: 244,
+        L: 110,
         S: void 0,
         C: (f, a) => f(...a)
       });
@@ -843,8 +677,47 @@ var runTools = async ({ message, tools, extensions }) => {
   }
 };
 
+// packages/experimental/assistant/src/session/version-pin.ts
+import { Schema as Schema2 } from "effect";
+import { getVersion } from "@dxos/echo-db";
+import { ObjectId } from "@dxos/echo-schema";
+var ObjectVersionSchema = Schema2.Unknown;
+var VersionPinSchema = Schema2.Struct({
+  // TODO(dmaretskyi): Use Ref when those support encoding.
+  objectId: ObjectId,
+  // TODO(dmaretskyi): Could be opaque
+  version: ObjectVersionSchema
+});
+var VersionPin = class extends VersionPinSchema {
+  static {
+    this.DISPOSITION = "version-pin";
+  }
+  static fromObject(object) {
+    return VersionPin.make({
+      objectId: object.id,
+      version: getVersion(object)
+    });
+  }
+  static createBlock(pin) {
+    return {
+      type: "json",
+      disposition: VersionPin.DISPOSITION,
+      json: JSON.stringify(pin)
+    };
+  }
+};
+
+// packages/experimental/assistant/src/session/session.ts
+import { Option, Schema as Schema4 } from "effect";
+import { defineTool as defineTool2, Message as Message4, structuredOutputParser, ToolResult as ToolResult3 } from "@dxos/artifact";
+import { Event as Event2, synchronized } from "@dxos/async";
+import { ObjectVersion } from "@dxos/echo-db";
+import { create as create3 } from "@dxos/echo-schema";
+import { invariant as invariant5 } from "@dxos/invariant";
+import { log as log6 } from "@dxos/log";
+
 // packages/experimental/assistant/src/ai-service/ollama-client.ts
-import { Schema as S2 } from "effect";
+import { Schema as Schema3 } from "effect";
 import { defineTool, ToolResult as ToolResult2 } from "@dxos/artifact";
 import { ObjectId as ObjectId2 } from "@dxos/echo-schema";
 import { invariant as invariant3 } from "@dxos/invariant";
@@ -1150,8 +1023,8 @@ var WELL_KNOWN_TOOLS = {
   [ToolTypes.TextToImage]: defineTool("system", {
     name: "text-to-image",
     description: "Generate an image from a text prompt",
-    schema: S2.Struct({
-      prompt: S2.String.annotations({
+    schema: Schema3.Struct({
+      prompt: Schema3.String.annotations({
         description: "The text prompt describing the image to generate"
       })
     }),
@@ -1194,12 +1067,12 @@ var OllamaDecoderStream = class extends TransformStream {
     this._buffer = "";
   }
 };
-var ModelDoesNotSupportToolsError = class extends S2.TaggedError()("ModelDoesNotSupportToolsError", {
-  model: S2.String
+var ModelDoesNotSupportToolsError = class extends Schema3.TaggedError()("ModelDoesNotSupportToolsError", {
+  model: Schema3.String
 }) {
 };
-var ModelNotFoundError = class extends S2.TaggedError()("ModelNotFoundError", {
-  model: S2.String
+var ModelNotFoundError = class extends Schema3.TaggedError()("ModelNotFoundError", {
+  model: Schema3.String
 }) {
 };
 var parseOllamaError = (error) => {
@@ -1229,6 +1102,14 @@ var parseErrorResponse2 = async (response) => {
   throw new Error(`Ollama API error: ${response.status} ${response.statusText} ${await response.text()}`);
 };
 
+// packages/experimental/assistant/src/ai-service/parser.ts
+import { Message as Message3 } from "@dxos/artifact";
+import { Event } from "@dxos/async";
+import { create as create2 } from "@dxos/echo-schema";
+import { invariant as invariant4 } from "@dxos/invariant";
+import { log as log5 } from "@dxos/log";
+import { isNotFalsy, safeParseJson } from "@dxos/util";
+
 // packages/experimental/assistant/src/ai-service/transform.ts
 import * as P from "parsimmon";
 var textChunk = P.regexp(/[^<]+/).map((content) => ({
@@ -1319,12 +1200,6 @@ var StreamTransform = class {
 };
 
 // packages/experimental/assistant/src/ai-service/parser.ts
-import { Message as Message3 } from "@dxos/artifact";
-import { Event } from "@dxos/async";
-import { create as create2 } from "@dxos/echo-schema";
-import { invariant as invariant4 } from "@dxos/invariant";
-import { log as log5 } from "@dxos/log";
-import { isNotFalsy, safeParseJson } from "@dxos/util";
 var __dxlog_file5 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/ai-service/parser.ts";
 var MixedStreamParser = class {
   constructor() {
@@ -1736,10 +1611,596 @@ var mergeMessageBlock = (contentBlock, streamBlock) => {
   }
 };
 
-// packages/experimental/assistant/src/cypher/parjs.ts
+// packages/experimental/assistant/src/session/session.ts
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+var __dxlog_file6 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/session/session.ts";
+var AISession = class _AISession {
+  constructor(_options) {
+    this._options = _options;
+    this._parser = new MixedStreamParser();
+    this._pending = [];
+    this._history = [];
+    this.message = this._parser.message;
+    this.block = this._parser.block;
+    this.update = this._parser.update;
+    this.streamEvent = this._parser.streamEvent;
+    this.userMessage = new Event2();
+    this._parser.message.on((message) => {
+      this._pending.push(message);
+    });
+  }
+  async run(options) {
+    const systemTools = [];
+    switch (this._options.operationModel) {
+      case "planning":
+        systemTools.push(this._createQueryArtifactsTool(options.artifacts), this._createPlanningTool(options));
+        break;
+      case "importing":
+        systemTools.push(this._createQueryArtifactsTool(options.artifacts), this._createRequireTool(options.artifacts, (artifactDefinitionIds) => {
+          for (const artifactDefinitionId of artifactDefinitionIds) {
+            requiredArtifactIds.add(artifactDefinitionId);
+          }
+        }));
+        break;
+      case "configured":
+        break;
+      default:
+        throw new TypeError(`Invalid operation model: ${this._options.operationModel}`);
+    }
+    this._history = [
+      ...options.history
+    ];
+    this._pending = [
+      await this._formatUserPrompt(options.artifactDiffResolver, options.prompt, options.history)
+    ];
+    this.userMessage.emit(this._pending.at(-1));
+    this._stream = void 0;
+    let error;
+    const requiredArtifactIds = new Set(options.requiredArtifactIds ?? []);
+    try {
+      let more = false;
+      do {
+        const tools = [
+          ...systemTools,
+          ...options.tools,
+          ...options.artifacts.filter((artifact) => requiredArtifactIds.has(artifact.id)).flatMap((artifact) => artifact.tools)
+        ];
+        log6("request", {
+          pending: this._pending.length,
+          history: this._history.length,
+          tools: tools.map((tool) => tool.name)
+        }, {
+          F: __dxlog_file6,
+          L: 181,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        this._stream = await options.client.execStream({
+          ...options.generationOptions ?? {},
+          // TODO(burdon): Rename messages or separate history/message.
+          history: [
+            ...this._history,
+            ...this._pending
+          ],
+          tools,
+          systemPrompt: options.systemPrompt ?? createBaseInstructions({
+            availableArtifacts: Array.from(requiredArtifactIds),
+            operationModel: this._options.operationModel
+          })
+        });
+        await this._parser.parse(this._stream);
+        await this._stream.complete();
+        log6("response", {
+          pending: this._pending
+        }, {
+          F: __dxlog_file6,
+          L: 206,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        more = false;
+        const message = this._pending.at(-1);
+        invariant5(message, void 0, {
+          F: __dxlog_file6,
+          L: 211,
+          S: this,
+          A: [
+            "message",
+            ""
+          ]
+        });
+        if (isToolUse(message)) {
+          log6("tool request...", void 0, {
+            F: __dxlog_file6,
+            L: 213,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+          const response = await runTools({
+            message: this._pending.at(-1),
+            tools,
+            extensions: options.extensions ?? {}
+          });
+          log6("tool response", {
+            response
+          }, {
+            F: __dxlog_file6,
+            L: 220,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+          switch (response.type) {
+            case "continue": {
+              this._pending = [
+                ...this._pending,
+                response.message
+              ];
+              this.userMessage.emit(response.message);
+              more = true;
+              break;
+            }
+          }
+        }
+      } while (more);
+    } catch (err) {
+      log6.catch(err, void 0, {
+        F: __dxlog_file6,
+        L: 232,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      if (err instanceof Error && err.message.includes("Overloaded")) {
+        error = new AIServiecOverloadedError("AI service overloaded", {
+          cause: err
+        });
+      } else {
+        error = new Error("AI service error", {
+          cause: err
+        });
+      }
+    } finally {
+      this._stream = void 0;
+    }
+    if (error) {
+      throw error;
+    }
+    return this._pending;
+  }
+  async runStructured(schema, options) {
+    const parser = structuredOutputParser(schema);
+    const result = await this.run({
+      ...options,
+      tools: [
+        ...options.tools,
+        parser.tool
+      ]
+    });
+    return parser.getResult(result);
+  }
+  async _formatUserPrompt(artifactDiffResolver, prompt, history) {
+    const prelude = [];
+    if (artifactDiffResolver) {
+      const versions = gatherObjectVersions(history);
+      const artifactDiff = await artifactDiffResolver(Array.from(versions.entries()).map(([id, version]) => ({
+        id,
+        lastVersion: version
+      })));
+      log6.info("vision", {
+        artifactDiff,
+        versions
+      }, {
+        F: __dxlog_file6,
+        L: 272,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      for (const [id, { version }] of [
+        ...artifactDiff.entries()
+      ]) {
+        if (ObjectVersion.equals(version, versions.get(id))) {
+          artifactDiff.delete(id);
+          continue;
+        }
+        prelude.push(VersionPin.createBlock(VersionPin.make({
+          objectId: id,
+          version
+        })));
+      }
+      if (artifactDiff.size > 0) {
+        prelude.push(createArtifactUpdateBlock(artifactDiff));
+      }
+    }
+    return create3(Message4, {
+      role: "user",
+      content: [
+        ...prelude,
+        {
+          type: "text",
+          text: prompt
+        }
+      ]
+    });
+  }
+  _createQueryArtifactsTool(artifacts) {
+    return defineTool2("system", {
+      name: "query_artifact_definitions",
+      description: "Query the available artifact definitions",
+      schema: Schema4.Struct({}),
+      execute: async () => {
+        return ToolResult3.Success({
+          artifactDefinitions: artifacts.map((artifact) => ({
+            id: artifact.id,
+            name: artifact.name,
+            description: artifact.description
+          }))
+        });
+      }
+    });
+  }
+  _createRequireTool(artifacts, onRequire) {
+    return defineTool2("system", {
+      name: "require_artifact_definitions",
+      description: "Require the use of specific artifact definitions. This will allow the model to interact with artifact definitions and use their tools.",
+      schema: Schema4.Struct({
+        artifactDefinitionIds: Schema4.Array(Schema4.String).annotations({
+          description: "The ids of the artifact definitions to require",
+          examples: [
+            [
+              "artifact:dxos.org/example/Test"
+            ]
+          ]
+        })
+      }),
+      execute: async ({ artifactDefinitionIds }) => {
+        const missingArtifactDefinitionIds = artifactDefinitionIds.filter((artifactId) => !artifacts.some((artifact) => artifact.id === artifactId));
+        if (missingArtifactDefinitionIds.length > 0) {
+          return ToolResult3.Error(`One or more artifact definition ids are invalid: ${missingArtifactDefinitionIds.join(", ")}`);
+        }
+        onRequire(artifactDefinitionIds);
+        return ToolResult3.Success({});
+      }
+    });
+  }
+  _createPlanningTool(options) {
+    return defineTool2("system", {
+      name: "create_plan",
+      description: "Create a plan. Make sure that each step is independent and can be executed solely on the data returned by the previous step. The steps only share the data that is specified in the plan.",
+      schema: Schema4.Struct({
+        goal: Schema4.String.annotations({
+          description: "The goal that the plan will achieve."
+        }),
+        steps: Schema4.Array(Schema4.Struct({
+          action: Schema4.String.annotations({
+            description: "Complete, detailed action to perform."
+          }),
+          input: Schema4.String.annotations({
+            description: "The required input data for this step. First step must not require any data."
+          }),
+          output: Schema4.String.annotations({
+            description: "The output data from this step. This is passed to the next step as input."
+          }),
+          requiredArtifactIds: Schema4.Array(Schema4.String).annotations({
+            description: "The ids of the artifacts required to perform this step.",
+            examples: [
+              [
+                "artifact:dxos.org/example/Test"
+              ]
+            ]
+          })
+        })).annotations({
+          description: "Steps"
+        })
+      }),
+      execute: async ({ goal, steps }) => {
+        const missingArtifactIds = steps.flatMap((step) => step.requiredArtifactIds).filter((artifactId) => !options.artifacts.some((artifact) => artifact.id === artifactId));
+        if (missingArtifactIds.length > 0) {
+          return ToolResult3.Error(`One or more artifact ids are invalid: ${missingArtifactIds.join(", ")}`);
+        }
+        const stepResults = [];
+        for (const step of steps) {
+          log6("executing step", {
+            action: step.action
+          }, {
+            F: __dxlog_file6,
+            L: 379,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+          const session = new _AISession({
+            operationModel: "importing"
+          });
+          session.message.on((ev) => this.message.emit(ev));
+          session.block.on((ev) => this.block.emit(ev));
+          session.update.on((ev) => this.update.emit(ev));
+          session.streamEvent.on((ev) => this.streamEvent.emit(ev));
+          session.userMessage.on((ev) => this.userMessage.emit(ev));
+          const messages = await session.run({
+            client: options.client,
+            artifacts: options.artifacts,
+            tools: options.tools,
+            history: options.history,
+            extensions: options.extensions,
+            generationOptions: options.generationOptions,
+            requiredArtifactIds: step.requiredArtifactIds.slice(),
+            artifactDiffResolver: options.artifactDiffResolver,
+            prompt: `
+              You are an agent that executes the subtask in a plan.
+              
+              While you know the plan's goal only focus on your subtask
+              Use the data from the previous step to complete your task.
+              Return all of the data from "output" in your last message.
+              
+              Current step (that you need to complete):
+              ${JSON.stringify({
+              goal,
+              input: step.input,
+              output: step.output,
+              yourTask: step.action
+            }, null, 2)}
+              
+              Previous step results:
+              ${JSON.stringify(stepResults.at(-1))}.
+            `
+          });
+          const result = messages.at(-1);
+          stepResults.push(result);
+        }
+        return ToolResult3.Success({
+          stepResults
+        });
+      }
+    });
+  }
+  abort() {
+    this._stream?.abort();
+  }
+};
+_ts_decorate([
+  synchronized
+], AISession.prototype, "run", null);
+var createBaseInstructions = ({ availableArtifacts, operationModel }) => `
+  You are a friendly, advanced AI assistant capable of creating and managing artifacts from available data and tools. 
+  Your task is to process user commands and questions and decide how best to respond.
+  In some cases, you will need to create or reference data objects called artifacts.
+
+  Follow these guidelines carefully:
+
+  Decision-making:
+
+  - Analyze the structure and type of the content in the user's message.
+  
+  
+  ${operationModel === "planning" ? `
+      - Can you complete the task using the available artifacts?
+      - If you can't complete the task using the available artifacts, query the list of available artifacts using the appropriate tool.
+      - Identify which artifacts are relevant to the user's request.
+        - Break down the user's request into a step-by-step plan that you will use to execute the user's request, the plan items should include artifacts which will be used to perform the actions.
+      ` : ""}
+  ${operationModel === "importing" ? `
+      - Can you complete the task using the available artifacts?
+      - If you can't complete the task using the available artifacts, query the list of available artifacts using the appropriate tool.
+      - Identify which artifacts are relevant to the user's request.
+    - Are the required artifacts already available?
+    - If not, select which artifact(s) will be the most relevant and require them using the require_artifacts tool.
+    - The require'd artifact tools will be available for use after require.
+  ` : ""}
+  ${operationModel === "configured" ? `
+    - Select the most relevant artifact(s) to complete the task.
+    - Call the appropriate tool to use the artifact(s).
+  ` : ""}
+
+  ${availableArtifacts.length > 0 ? `Artifacts already in context: ${availableArtifacts.join("\n")}` : ""}
+`;
+var AIServiecOverloadedError = class extends Schema4.TaggedError()("AIServiecOverloadedError", {}) {
+};
+var gatherObjectVersions = (messages) => {
+  const artifactIds = /* @__PURE__ */ new Map();
+  for (const message of messages) {
+    for (const block of message.content) {
+      if (block.type === "json" && block.disposition === VersionPin.DISPOSITION) {
+        const pin = VersionPin.pipe(Schema4.decodeOption)(JSON.parse(block.json)).pipe(Option.getOrUndefined);
+        if (!pin) {
+          continue;
+        }
+        artifactIds.set(pin.objectId, pin.version);
+      }
+    }
+  }
+  return artifactIds;
+};
+var createArtifactUpdateBlock = (artifactDiff) => {
+  return {
+    type: "text",
+    disposition: "artifact-update",
+    text: `
+      The following artifacts have been updated since the last message:
+      ${Array.from(artifactDiff.entries()).map(([id, { diff }]) => `<changed-artifact id="${id}">${diff ? `
+${diff}` : ""}</changed-artifact>`).join("\n")}
+    `
+  };
+};
+
+// packages/experimental/assistant/src/experimental/conversation/conversation.ts
+import { ObjectId as ObjectId3 } from "@dxos/echo-schema";
+import { invariant as invariant6 } from "@dxos/invariant";
+import { log as log7 } from "@dxos/log";
+var __dxlog_file7 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/experimental/conversation/conversation.ts";
+var runLLM = async (params) => {
+  let conversationResult = null;
+  const history = params.history ?? [];
+  const generate = async () => {
+    log7("llm generate", {
+      tools: params.tools
+    }, {
+      F: __dxlog_file7,
+      L: 44,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+    const beginTs = Date.now();
+    const stream = await params.client.execStream({
+      model: params.model,
+      history,
+      systemPrompt: params.system,
+      tools: params.tools
+    });
+    for await (const event of stream) {
+      params.logger?.(event);
+    }
+    await stream.complete();
+    const messages = [];
+    const message = messages.at(-1);
+    invariant6(message, void 0, {
+      F: __dxlog_file7,
+      L: 61,
+      S: void 0,
+      A: [
+        "message",
+        ""
+      ]
+    });
+    log7("llm result", {
+      time: Date.now() - beginTs,
+      message
+    }, {
+      F: __dxlog_file7,
+      L: 63,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+    invariant6(message, void 0, {
+      F: __dxlog_file7,
+      L: 64,
+      S: void 0,
+      A: [
+        "message",
+        ""
+      ]
+    });
+    params.logger?.({
+      type: "message",
+      message
+    });
+    history.push(...messages.map((message2) => ({
+      ...message2,
+      content: message2.content.filter((block) => block.type !== "image")
+    })));
+    const isToolUse2 = message.content.at(-1)?.type === "tool_use";
+    if (isToolUse2) {
+      const toolCalls = message.content.filter((block) => block.type === "tool_use");
+      invariant6(toolCalls.length === 1, void 0, {
+        F: __dxlog_file7,
+        L: 75,
+        S: void 0,
+        A: [
+          "toolCalls.length === 1",
+          ""
+        ]
+      });
+      const toolCall = toolCalls[0];
+      const tool = params.tools.find((tool2) => tool2.name === toolCall.name);
+      if (!tool) {
+        throw new Error(`Tool not found: ${toolCall.name}`);
+      }
+      invariant6(tool.execute, void 0, {
+        F: __dxlog_file7,
+        L: 82,
+        S: void 0,
+        A: [
+          "tool.execute",
+          ""
+        ]
+      });
+      const toolResult = await tool.execute(toolCall.input);
+      switch (toolResult.kind) {
+        case "error": {
+          log7.warn("tool error", {
+            message: toolResult.message
+          }, {
+            F: __dxlog_file7,
+            L: 86,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+          const resultMessage = {
+            id: ObjectId3.random(),
+            role: "user",
+            content: [
+              {
+                type: "tool_result",
+                toolUseId: toolCall.id,
+                content: toolResult.message,
+                isError: true
+              }
+            ]
+          };
+          params.logger?.({
+            type: "message",
+            message: resultMessage
+          });
+          history.push(resultMessage);
+          return true;
+        }
+        case "success": {
+          log7("tool success", {
+            result: toolResult.result
+          }, {
+            F: __dxlog_file7,
+            L: 106,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+          const resultMessage = {
+            id: ObjectId3.random(),
+            role: "user",
+            content: [
+              {
+                type: "tool_result",
+                toolUseId: toolCall.id,
+                content: JSON.stringify(toolResult.result)
+              }
+            ]
+          };
+          params.logger?.({
+            type: "message",
+            message: resultMessage
+          });
+          history.push(resultMessage);
+          return true;
+        }
+        case "break": {
+          log7("tool break", {
+            result: toolResult.result
+          }, {
+            F: __dxlog_file7,
+            L: 125,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+          conversationResult = toolResult.result;
+          return false;
+        }
+      }
+    }
+    return false;
+  };
+  while (await generate()) {
+  }
+  return {
+    result: conversationResult,
+    history
+  };
+};
+
+// packages/experimental/assistant/src/experimental/cypher/parjs.ts
 import { parjsCombinators, parjs } from "#parjs";
 
-// packages/experimental/assistant/src/cypher/combinators.ts
+// packages/experimental/assistant/src/experimental/cypher/combinators.ts
 var ws = parjs.whitespace();
 var nothing = parjs.string("").pipe(parjsCombinators.map(() => null));
 var optional = (parser) => parser.pipe(parjsCombinators.recover(() => ({
@@ -1813,7 +2274,7 @@ var cypherQuery = ws.pipe(parjsCombinators.then(matchClause, ws, optional(whereC
   returnClause: returnClause2
 })));
 
-// packages/experimental/assistant/src/cypher/parser.ts
+// packages/experimental/assistant/src/experimental/cypher/parser.ts
 var parseCypherQuery = (query) => {
   const parseResult = cypherQuery.parse(query);
   if (parseResult.isOk) {
@@ -1825,14 +2286,14 @@ var parseCypherQuery = (query) => {
   }
 };
 
-// packages/experimental/assistant/src/cypher/query-executor.ts
-import { log as log7 } from "@dxos/log";
+// packages/experimental/assistant/src/experimental/cypher/query-executor.ts
+import { log as log9 } from "@dxos/log";
 import { mapValues } from "@dxos/util";
 
-// packages/experimental/assistant/src/cypher/execution-plan.ts
-import { invariant as invariant5 } from "@dxos/invariant";
-import { log as log6 } from "@dxos/log";
-var __dxlog_file6 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/cypher/execution-plan.ts";
+// packages/experimental/assistant/src/experimental/cypher/execution-plan.ts
+import { invariant as invariant7 } from "@dxos/invariant";
+import { log as log8 } from "@dxos/log";
+var __dxlog_file8 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/experimental/cypher/execution-plan.ts";
 var createExecutionPlan = (query) => {
   return new ExecutionPlanBuilder().build(query);
 };
@@ -1844,10 +2305,10 @@ var ExecutionPlanBuilder = class {
     return `anon_${this.counter++}`;
   }
   build(query) {
-    log6("Creating execution plan for query", {
+    log8("Creating execution plan for query", {
       query
     }, {
-      F: __dxlog_file6,
+      F: __dxlog_file8,
       L: 76,
       S: this,
       C: (f, a) => f(...a)
@@ -1864,8 +2325,8 @@ var ExecutionPlanBuilder = class {
     };
   }
   createStepsForMatchClause(match) {
-    invariant5(match.pattern.segments.length > 0, void 0, {
-      F: __dxlog_file6,
+    invariant7(match.pattern.segments.length > 0, void 0, {
+      F: __dxlog_file8,
       L: 90,
       S: this,
       A: [
@@ -1874,8 +2335,8 @@ var ExecutionPlanBuilder = class {
       ]
     });
     const firstSegment = match.pattern.segments[0];
-    invariant5(firstSegment.astKind === "NodePattern", void 0, {
-      F: __dxlog_file6,
+    invariant7(firstSegment.astKind === "NodePattern", void 0, {
+      F: __dxlog_file8,
       L: 92,
       S: this,
       A: [
@@ -1902,8 +2363,8 @@ var ExecutionPlanBuilder = class {
     }
     for (let i = 1; i < match.pattern.segments.length; i++) {
       const relationshipSegment = match.pattern.segments[i++];
-      invariant5(relationshipSegment.astKind === "RelationshipPattern", void 0, {
-        F: __dxlog_file6,
+      invariant7(relationshipSegment.astKind === "RelationshipPattern", void 0, {
+        F: __dxlog_file8,
         L: 115,
         S: this,
         A: [
@@ -1912,8 +2373,8 @@ var ExecutionPlanBuilder = class {
         ]
       });
       const nodeSegment = match.pattern.segments[i];
-      invariant5(nodeSegment.astKind === "NodePattern", void 0, {
-        F: __dxlog_file6,
+      invariant7(nodeSegment.astKind === "NodePattern", void 0, {
+        F: __dxlog_file8,
         L: 117,
         S: this,
         A: [
@@ -1995,16 +2456,16 @@ var getDirection = (left, right) => {
   throw new Error(`Invalid direction: ()${left}[]${right}()`);
 };
 
-// packages/experimental/assistant/src/cypher/query-executor.ts
-var __dxlog_file7 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/cypher/query-executor.ts";
+// packages/experimental/assistant/src/experimental/cypher/query-executor.ts
+var __dxlog_file9 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/experimental/cypher/query-executor.ts";
 var executeQueryPlan = async (dataSource, plan) => {
   let buffer = [];
   const results = [];
   for (const step of plan.steps) {
-    log7("begin step", {
+    log9("begin step", {
       step
     }, {
-      F: __dxlog_file7,
+      F: __dxlog_file9,
       L: 41,
       S: void 0,
       C: (f, a) => f(...a)
@@ -2090,11 +2551,11 @@ var executeQueryPlan = async (dataSource, plan) => {
         break;
       }
     }
-    log7("finish step", {
+    log9("finish step", {
       buffer: buffer.map((tuple) => mapValues(tuple, (x) => x.id)),
       results
     }, {
-      F: __dxlog_file7,
+      F: __dxlog_file9,
       L: 118,
       S: void 0,
       C: (f, a) => f(...a)
@@ -2121,7 +2582,7 @@ var jsonPathGet = (obj, path) => {
   return result;
 };
 
-// packages/experimental/assistant/src/cypher/schema.ts
+// packages/experimental/assistant/src/experimental/cypher/schema.ts
 import { raise } from "@dxos/debug";
 import { JSON_SCHEMA_ECHO_REF_ID } from "@dxos/echo-schema";
 
@@ -2133,7 +2594,7 @@ var trim = (strings, ...values) => {
   return combined.replace("/^\n/", "").replace(/\n$/, "");
 };
 
-// packages/experimental/assistant/src/cypher/schema.ts
+// packages/experimental/assistant/src/experimental/cypher/schema.ts
 var formatJsonSchemaForLLM = (schemaTypes) => {
   return schemaTypes.flatMap((schema) => [
     formatNodeSchema(schema),
@@ -2187,18 +2648,18 @@ var formatInferredRelationshipLabel = (typename, property2) => {
 };
 var isReference = (schema) => schema.$id === JSON_SCHEMA_ECHO_REF_ID || schema.type === "array" && !Array.isArray(schema.items) && typeof schema.items === "object" && "$id" in schema.items && schema.items.$id === JSON_SCHEMA_ECHO_REF_ID;
 
-// packages/experimental/assistant/src/cypher/echo-data-source.ts
+// packages/experimental/assistant/src/experimental/cypher/echo-data-source.ts
 import { raise as raise2 } from "@dxos/debug";
 import { Filter } from "@dxos/echo-db";
 import { getSchema, getSchemaTypename, StoredSchema, toJsonSchema } from "@dxos/echo-schema";
-import { log as log8 } from "@dxos/log";
-function _ts_decorate(decorators, target, key, desc) {
+import { log as log10 } from "@dxos/log";
+function _ts_decorate2(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-var __dxlog_file8 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/cypher/echo-data-source.ts";
+var __dxlog_file10 = "/home/runner/work/dxos/dxos/packages/experimental/assistant/src/experimental/cypher/echo-data-source.ts";
 var EchoDataSource = class {
   constructor(_db) {
     this._db = _db;
@@ -2271,18 +2732,18 @@ var EchoDataSource = class {
     }));
   }
 };
-_ts_decorate([
-  log8.method(void 0, void 0, {
-    F: __dxlog_file8,
-    L: 16,
+_ts_decorate2([
+  log10.method(void 0, void 0, {
+    F: __dxlog_file10,
+    L: 18,
     S: void 0,
     C: (f, a) => f(...a)
   })
 ], EchoDataSource.prototype, "getNodes", null);
-_ts_decorate([
-  log8.method(void 0, void 0, {
-    F: __dxlog_file8,
-    L: 33,
+_ts_decorate2([
+  log10.method(void 0, void 0, {
+    F: __dxlog_file10,
+    L: 35,
     S: void 0,
     C: (f, a) => f(...a)
   })
@@ -2304,13 +2765,16 @@ export {
   ToolTypes,
   GenerateRequest,
   GenerateResponse,
-  runLLM,
   isToolUse,
   runTools,
+  VersionPin,
+  AISession,
+  AIServiecOverloadedError,
   OllamaClient,
   StreamTransform,
   MixedStreamParser,
   mergeMessageBlock,
+  runLLM,
   parseCypherQuery,
   executeQueryPlan,
   executeQuery,
@@ -2321,4 +2785,4 @@ export {
   isReference,
   EchoDataSource
 };
-//# sourceMappingURL=chunk-7JI4MDGL.mjs.map
+//# sourceMappingURL=chunk-GCJNPQDJ.mjs.map