@dxos/assistant 0.8.3 → 0.8.4-main.2e9d522

package/dist/types/src/research/graph.d.ts

@@ -1,7 +1,8 @@
+import { AiTool, AiToolkit } from '@effect/ai';
 import { Schema } from 'effect';
-import type { Obj } from '@dxos/echo';
 import { type EchoDatabase, type Queue } from '@dxos/echo-db';
 import { type BaseObject } from '@dxos/echo-schema';
+import { DatabaseService } from '@dxos/functions';
 export declare const Subgraph: Schema.Struct<{
     /** Objects and relations. */
     objects: Schema.Array$<typeof Schema.Any>;
@@ -20,10 +21,24 @@ export type RelatedSchema = {
  * @returns
  */
 export declare const findRelatedSchema: (db: EchoDatabase, anchor: Schema.Schema.AnyNoContext) => Promise<RelatedSchema[]>;
+declare const LocalSearchToolkit_base: AiToolkit.AiToolkit<AiTool.AiTool<"search_local_search", Schema.Struct<{
+    query: Schema.SchemaClass<string, string, never>;
+}>, typeof Schema.Unknown, typeof Schema.Never, DatabaseService>>;
 /**
  * Perform vector search in the local database.
  */
-export declare const createLocalSearchTool: (db: EchoDatabase, queue?: Queue) => import("@dxos/ai").ExecutableTool;
+export declare class LocalSearchToolkit extends LocalSearchToolkit_base {
+}
+export declare const LocalSearchHandler: import("effect/Layer").Layer<AiTool.Handler<"search_local_search">, never, never>;
+/**
+ * Forms typed objects that can be written to the graph database.
+ */
+export declare const makeGraphWriterToolkit: ({ schema }: {
+    schema: Schema.Schema.AnyNoContext[];
+}) => AiToolkit.AiToolkit<AiTool.AiTool<"graph_writer", Schema.Struct<Readonly<{
+    [k: string]: Schema.optional<Schema.Array$<Schema.Schema.AnyNoContext>>;
+}>>, typeof Schema.Unknown, typeof Schema.Never, DatabaseService>>;
+export declare const makeGraphWriterHandler: (toolkit: ReturnType<typeof makeGraphWriterToolkit>) => import("effect/Layer").Layer<AiTool.Handler<"graph_writer">, never, never>;
 /**
  * Create a schema for structured data extraction.
  */
@@ -32,10 +47,5 @@ export declare const createExtractionSchema: (types: Schema.Schema.AnyNoContext[
 }>;
 export declare const getSanitizedSchemaName: (schema: Schema.Schema.AnyNoContext) => string;
 export declare const sanitizeObjects: (types: Schema.Schema.AnyNoContext[], data: Record<string, readonly unknown[]>, db: EchoDatabase, queue?: Queue) => Promise<BaseObject[]>;
-export declare const createGraphWriterTool: ({ db, queue, schema, onDone, }: {
-    db: EchoDatabase;
-    queue?: Queue;
-    schema: Schema.Schema.AnyNoContext[];
-    onDone?: (data: Obj.Any[]) => Promise<any>;
-}) => import("@dxos/ai").ExecutableTool;
+export {};
 //# sourceMappingURL=graph.d.ts.map

package/dist/types/src/research/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../src/research/graph.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAA+B,MAAM,QAAQ,CAAC;AAG7D,OAAO,KAAK,EAAE,GAAG,EAAY,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAUL,KAAK,UAAU,EAKhB,MAAM,mBAAmB,CAAC;AAO3B,eAAO,MAAM,QAAQ;IACnB,6BAA6B;;EAE7B,CAAC;AACH,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC;CAAG;AAExE,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IACnC,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,IAAI,YAAY,EAChB,QAAQ,MAAM,CAAC,MAAM,CAAC,YAAY,KACjC,OAAO,CAAC,aAAa,EAAE,CAsBzB,CAAC;AAmBF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,IAAI,YAAY,EAAE,QAAQ,KAAK,sCAyBpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE;;EAWzE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,CAAC,MAAM,CAAC,YAAY,WAIxE,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EACnC,MAAM,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,EACxC,IAAI,YAAY,EAChB,QAAQ,KAAK,KACZ,OAAO,CAAC,UAAU,EAAE,CAyHtB,CAAC;AA2CF,eAAO,MAAM,qBAAqB,GAAI,gCAKnC;IACD,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC5C,sCAUA,CAAC"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../src/research/graph.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAqC,MAAM,EAAa,MAAM,QAAQ,CAAC;AAI9E,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAcL,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAuB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvE,eAAO,MAAM,QAAQ;IACnB,6BAA6B;;EAE7B,CAAC;AACH,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC;CAAG;AAExE,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IACnC,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,IAAI,YAAY,EAChB,QAAQ,MAAM,CAAC,MAAM,CAAC,YAAY,KACjC,OAAO,CAAC,aAAa,EAAE,CAsBzB,CAAC;;;;AAmBF;;GAEG;AAEH,qBAAa,kBAAmB,SAAQ,uBAWvC;CAAG;AAEJ,eAAO,MAAM,kBAAkB,mFAkB7B,CAAC;AAUH;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,YAAY;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAA;CAAE;;kEAW1F,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,SAAS,UAAU,CAAC,OAAO,sBAAsB,CAAC,+EAexF,CAAC;AACF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE;;EAWzE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,CAAC,MAAM,CAAC,YAAY,WAIxE,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EACnC,MAAM,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,EACxC,IAAI,YAAY,EAChB,QAAQ,KAAK,KACZ,OAAO,CAAC,UAAU,EAAE,CAyHtB,CAAC"}

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

@@ -5,6 +5,6 @@ export declare const researchFn: import("@dxos/functions").FunctionDefinition<{
     readonly query: string;
     readonly mockSearch?: boolean | undefined;
 }, {
-    result: any;
+    readonly result: unknown;
 }>;
 //# sourceMappingURL=research.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../../src/research/research.ts"],"names":[],"mappings":"AAkBA;;GAEG;AAEH,eAAO,MAAM,UAAU;;;;YAsDC,GAAG;EAYzB,CAAC"}
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../../src/research/research.ts"],"names":[],"mappings":"AAqBA;;GAEG;AAEH,eAAO,MAAM,UAAU;;;;;EA6DrB,CAAC"}

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

@@ -1,68 +1,33 @@
-import { Schema } from 'effect';
-import { type AgentStatus, type AiServiceClient, type GenerateRequest, Message, type ExecutableTool } from '@dxos/ai';
-import { type ArtifactDefinition } from '@dxos/artifact';
+import { AiLanguageModel, AiToolkit, type AiError, type AiResponse, type AiTool } from '@effect/ai';
+import { Context, Effect, type Schema } from 'effect';
+import { ToolExecutionService, ToolResolverService, type AgentStatus, type AiInputPreprocessingError, type AiToolNotFoundError } from '@dxos/ai';
 import { Event } from '@dxos/async';
+import { type Blueprint } from '@dxos/blueprints';
 import { ObjectVersion } from '@dxos/echo-db';
 import { type ObjectId } from '@dxos/echo-schema';
+import { DataType } from '@dxos/schema';
+import { AiAssistantError } from '../errors';
+export type AiSessionOptions = {};
+export type SessionRunOptions<Tools extends AiTool.Any> = {
+    prompt: string;
+    history: DataType.Message[];
+    systemPrompt?: string;
+    toolkit?: AiToolkit.AiToolkit<Tools>;
+    blueprints?: Blueprint.Blueprint[];
+};
 /**
  * Contains message history, tools, current context.
  * Current context means the state of the app, time of day, and other contextual information.
  * It makes requests to the model, its a state machine.
  * It keeps track of the current goal.
  * It manages the context window.
- * Tracks the success criteria of reaching the goal, exposing metrics (stretch)
+ * Tracks the success criteria of reaching the goal, exposing metrics (stretch).
  * Could be run locally in the app or remotely.
  * Could be personal or shared.
  */
-/**
- * Resolves artifact ids to their versions.
- * Used to give the model a sense of the changes to the artifacts made by users during the conversation.
- * The artifacts versions are pinned in the history, and whenever the artifact changes in-between assistant's steps,
- * a diff is inserted into the conversation.
- */
-export type ArtifactDiffResolver = (artifacts: {
-    id: ObjectId;
-    lastVersion: ObjectVersion;
-}[]) => Promise<Map<ObjectId, {
-    version: ObjectVersion;
-    diff?: string;
-}>>;
-export type SessionRunOptions = {
-    client: AiServiceClient;
-    artifacts: ArtifactDefinition[];
-    /**
-     * Non-artifact specific tools.
-     */
-    tools: ExecutableTool[];
-    history: Message[];
-    prompt: string;
-    generationOptions?: Pick<GenerateRequest, 'model'>;
-    extensions?: ToolContextExtensions;
-    systemPrompt?: string;
-    /**
-     * Pre-require artifacts.
-     */
-    requiredArtifactIds?: string[];
-    /**
-     * @see ArtifactDiffResolver
-     */
-    artifactDiffResolver?: ArtifactDiffResolver;
-};
-type OperationModel = 'planning' | 'importing' | 'configured';
-export type AiSessionOptions = {
-    /**
-     * Determines the agent's handling of the artifacts definitions:
-     *
-     * - `planning`: The model will create a plan with required artifacts for each step.
-     * - `importing`: The model can query registry and only pull in the artifacts that are required to complete the task.
-     * - `configured`: The available artifacts are pre-selected and the model cannot select additional artifacts.
-     */
-    operationModel: OperationModel;
-};
-export declare class AISession {
+export declare class AiSession {
     private readonly _options;
-    /** SSE stream parser. */
-    private readonly _parser;
+    private readonly _semaphore;
     /** Pending messages (incl. the current user request). */
     private _pending;
     /** Current streaming response. */
@@ -72,190 +37,224 @@ export declare class AISession {
     /**
      * New message.
      */
-    readonly message: Event<import("@dxos/echo/Type").OfKind<import("@dxos/echo-schema").EntityKind.Object> & {
-        id: string;
-        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;
-            currentStatus?: {
-                readonly id: string;
-                message: string;
-            } | undefined;
-        } | {
-            pending?: boolean | undefined;
-            type: "tool_result";
-            toolUseId: string;
-            content: string;
-            isError?: boolean | undefined;
-        })[];
-        role: "user" | "assistant";
-    }>;
+    readonly message: Event<import("@dxos/schema").Message>;
     /**
      * Complete block added to Message.
      */
     readonly block: Event<{
+        version: unknown;
+        _tag: "anchor";
         pending?: boolean | undefined;
-        type: "text";
-        text: string;
-        disposition?: string | undefined;
+        objectId: string;
     } | {
+        name?: string | undefined;
+        _tag: "file";
         pending?: boolean | undefined;
-        type: "json";
-        disposition?: string | undefined;
-        json: string;
+        url: string;
+        mediaType?: string | undefined;
     } | {
-        pending?: boolean | undefined;
         id?: string | undefined;
-        type: "image";
         source?: {
             type: "base64";
             mediaType: string;
             data: string;
+        } | {
+            type: "http";
+            url: string;
         } | undefined;
+        _tag: "image";
+        pending?: boolean | undefined;
+    } | {
+        _tag: "json";
+        pending?: boolean | undefined;
+        data: string;
+        disposition?: string | undefined;
+    } | {
+        text: string;
+        _tag: "proposal";
+        pending?: boolean | undefined;
+    } | {
+        _tag: "reasoning";
+        pending?: boolean | undefined;
+        reasoningText?: string | undefined;
+        redactedText?: string | undefined;
+        signature?: string | undefined;
+    } | {
+        reference: import("@dxos/echo-schema").Ref<import("@dxos/echo/Type").Expando>;
+        _tag: "reference";
+        pending?: boolean | undefined;
+    } | {
+        _tag: "select";
+        pending?: boolean | undefined;
+        options: readonly string[];
+    } | {
+        _tag: "status";
+        pending?: boolean | undefined;
+        statusText: string;
     } | {
+        text: string;
+        _tag: "suggest";
+        pending?: boolean | undefined;
+    } | {
+        text: string;
+        _tag: "text";
         pending?: boolean | undefined;
-        id: string;
-        type: "tool_use";
+        disposition?: string | undefined;
+        mimeType?: string | undefined;
+    } | {
         name: string;
         input: unknown;
-        currentStatus?: {
-            readonly id: string;
-            message: string;
-        } | undefined;
+        _tag: "toolCall";
+        pending?: boolean | undefined;
+        toolCallId: string;
     } | {
+        _tag: "toolList";
+        pending?: boolean | undefined;
+    } | {
+        name: string;
+        _tag: "toolResult";
         pending?: boolean | undefined;
-        type: "tool_result";
-        toolUseId: string;
-        content: string;
-        isError?: boolean | undefined;
+        toolCallId: string;
+        result: unknown;
+    } | {
+        text: string;
+        _tag: "transcript";
+        pending?: boolean | undefined;
+        started: string;
     }>;
     /**
      * Update partial block (while streaming).
      */
     readonly update: Event<{
+        version: unknown;
+        _tag: "anchor";
         pending?: boolean | undefined;
-        type: "text";
-        text: string;
-        disposition?: string | undefined;
+        objectId: string;
     } | {
+        name?: string | undefined;
+        _tag: "file";
         pending?: boolean | undefined;
-        type: "json";
-        disposition?: string | undefined;
-        json: string;
+        url: string;
+        mediaType?: string | undefined;
     } | {
-        pending?: boolean | undefined;
         id?: string | undefined;
-        type: "image";
         source?: {
             type: "base64";
             mediaType: string;
             data: string;
+        } | {
+            type: "http";
+            url: string;
         } | undefined;
+        _tag: "image";
+        pending?: boolean | undefined;
+    } | {
+        _tag: "json";
+        pending?: boolean | undefined;
+        data: string;
+        disposition?: string | undefined;
+    } | {
+        text: string;
+        _tag: "proposal";
+        pending?: boolean | undefined;
+    } | {
+        _tag: "reasoning";
+        pending?: boolean | undefined;
+        reasoningText?: string | undefined;
+        redactedText?: string | undefined;
+        signature?: string | undefined;
+    } | {
+        reference: import("@dxos/echo-schema").Ref<import("@dxos/echo/Type").Expando>;
+        _tag: "reference";
+        pending?: boolean | undefined;
+    } | {
+        _tag: "select";
+        pending?: boolean | undefined;
+        options: readonly string[];
     } | {
+        _tag: "status";
         pending?: boolean | undefined;
-        id: string;
-        type: "tool_use";
+        statusText: string;
+    } | {
+        text: string;
+        _tag: "suggest";
+        pending?: boolean | undefined;
+    } | {
+        text: string;
+        _tag: "text";
+        pending?: boolean | undefined;
+        disposition?: string | undefined;
+        mimeType?: string | undefined;
+    } | {
         name: string;
         input: unknown;
-        currentStatus?: {
-            readonly id: string;
-            message: string;
-        } | undefined;
+        _tag: "toolCall";
+        pending?: boolean | undefined;
+        toolCallId: string;
+    } | {
+        _tag: "toolList";
+        pending?: boolean | undefined;
+    } | {
+        name: string;
+        _tag: "toolResult";
+        pending?: boolean | undefined;
+        toolCallId: string;
+        result: unknown;
     } | {
+        text: string;
+        _tag: "transcript";
         pending?: boolean | undefined;
-        type: "tool_result";
-        toolUseId: string;
-        content: string;
-        isError?: boolean | undefined;
+        started: string;
     }>;
-    readonly streamEvent: Event<import("@dxos/ai").GenerationStreamEvent>;
+    /**
+     * Unparsed events from the underlying generation stream.
+     */
+    readonly streamEvent: Event<AiResponse.TextPart | AiResponse.ReasoningPart | AiResponse.RedactedReasoningPart | AiResponse.ToolCallPart | AiResponse.MetadataPart | AiResponse.FinishPart>;
     /**
      * User prompt or tool result.
      */
-    readonly userMessage: Event<import("@dxos/echo/Type").OfKind<import("@dxos/echo-schema").EntityKind.Object> & {
-        id: string;
-        role: "user" | "assistant";
-        content: ({
-            pending?: boolean | undefined;
-            type: "text";
-            disposition?: string | undefined;
-            text: string;
-        } | {
-            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;
-            name: string;
-            type: "tool_use";
-            input: unknown;
-            currentStatus?: {
-                readonly id: string;
-                message: string;
-            } | undefined;
-        } | {
-            pending?: boolean | undefined;
-            type: "tool_result";
-            content: string;
-            toolUseId: string;
-            isError?: boolean | undefined;
-        })[];
-    }>;
+    readonly userMessage: Event<import("@dxos/schema").Message>;
     /**
      * Agent self-reporting its status.
+     * Triggered by the model.
      */
     readonly statusReport: Event<AgentStatus>;
-    readonly toolStatusReport: Event<{
-        message: Message;
-        status: AgentStatus;
-    }>;
-    constructor(_options: AiSessionOptions);
-    run(options: SessionRunOptions): Promise<Message[]>;
-    runStructured<S extends Schema.Schema.AnyNoContext>(schema: S, options: SessionRunOptions): Promise<Schema.Schema.Type<S>>;
+    /**
+     * Emits when the session is done.
+     */
+    readonly done: Event<void>;
+    constructor(_options?: AiSessionOptions);
+    /**
+     * Runs the AI model loop interacting with tools and artifacts.
+     * @param options - The session options.
+     * @returns The messages generated by the session, including the user's prompt.
+     */
+    run: <Tools extends AiTool.Any>(options: SessionRunOptions<Tools>) => Effect.Effect<DataType.Message[], AiAssistantError | AiInputPreprocessingError | AiToolNotFoundError | AiError.AiError, AiLanguageModel.AiLanguageModel | ToolResolverService | ToolExecutionService | AiTool.ToHandler<Tools>>;
+    runStructured<S extends Schema.Schema.AnyNoContext>(schema: S, options: SessionRunOptions<AiTool.Any>): Promise<Schema.Schema.Type<S>>;
     private _formatUserPrompt;
-    private _createQueryArtifactsTool;
-    private _createRequireTool;
-    private _createPlanningTool;
-    private _onToolStatusReport;
     abort(): void;
 }
-declare const AIServiecOverloadedError_base: Schema.TaggedErrorClass<AIServiecOverloadedError, "AIServiecOverloadedError", {
-    readonly _tag: Schema.tag<"AIServiecOverloadedError">;
-}>;
-export declare class AIServiecOverloadedError extends AIServiecOverloadedError_base {
+declare const ArtifactDiffResolver_base: Context.TagClass<ArtifactDiffResolver, "ArtifactDiffResolver", ArtifactDiffResolver.Service>;
+/**
+ * Resolves artifact ids to their versions.
+ * Used to give the model a sense of the changes to the artifacts made by users during the conversation.
+ * The artifacts versions are pinned in the history, and whenever the artifact changes in-between assistant's steps,
+ * a diff is inserted into the conversation.
+ *
+ * Can be optionally provided to the session run call.
+ */
+export declare class ArtifactDiffResolver extends ArtifactDiffResolver_base {
+}
+export declare namespace ArtifactDiffResolver {
+    type Service = {
+        resolve: (artifacts: {
+            id: ObjectId;
+            lastVersion: ObjectVersion;
+        }[]) => Promise<Map<ObjectId, {
+            version: ObjectVersion;
+            diff?: string;
+        }>>;
+    };
 }
 export {};
 //# sourceMappingURL=session.d.ts.map

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

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

package/dist/types/src/session/version-pin.d.ts

@@ -1,7 +1,7 @@
 import { Schema } from 'effect';
-import { type MessageContentBlock } from '@dxos/ai';
 import { type ObjectVersion } from '@dxos/echo-db';
 import { type BaseEchoObject } from '@dxos/echo-schema';
+import { type ContentBlock } from '@dxos/schema';
 declare const VersionPinSchema: Schema.Struct<{
     objectId: import("@dxos/keys").ObjectIdClass;
     version: Schema.Schema<ObjectVersion, ObjectVersion, never>;
@@ -15,7 +15,7 @@ export interface VersionPin extends Schema.Schema.Type<typeof VersionPinSchema>
 export declare const VersionPin: typeof VersionPinSchema & {
     DISPOSITION: 'version-pin';
     fromObject: (object: BaseEchoObject) => VersionPin;
-    createBlock: (pin: VersionPin) => MessageContentBlock;
+    createBlock: (pin: VersionPin) => ContentBlock.Any;
 };
 export {};
 //# sourceMappingURL=version-pin.d.ts.map

package/dist/types/src/session/version-pin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-pin.d.ts","sourceRoot":"","sources":["../../../../src/session/version-pin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKlE,QAAA,MAAM,gBAAgB;;;EAKpB,CAAC;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC;CAAG;AAElF,eAAO,MAAM,UAAU,EAAE,OAAO,gBAAgB,GAAG;IACjD,WAAW,EAAE,aAAa,CAAC;IAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,UAAU,CAAC;IACnD,WAAW,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,mBAAmB,CAAC;CAiBvD,CAAC"}
+{"version":3,"file":"version-pin.d.ts","sourceRoot":"","sources":["../../../../src/session/version-pin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,QAAA,MAAM,gBAAgB;;;EAKpB,CAAC;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC;CAAG;AAElF,eAAO,MAAM,UAAU,EAAE,OAAO,gBAAgB,GAAG;IACjD,WAAW,EAAE,aAAa,CAAC;IAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,UAAU,CAAC;IACnD,WAAW,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,YAAY,CAAC,GAAG,CAAC;CAiBpD,CAAC"}

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

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

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

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

package/dist/types/src/templates/prompt.d.ts

@@ -0,0 +1,30 @@
+import { type AssociatedArtifact } from '@dxos/blueprints';
+/**
+ * Type for assistant prompt variables.
+ */
+export type AssistantPromptOptions = {
+    /**
+     * Instructions for each artifact.
+     */
+    artifacts?: string[];
+    /**
+     * Associated artifact to include in the prompt.
+     * @deprecated
+     */
+    artifact?: AssociatedArtifact;
+    /**
+     * Whether to include suggestions in the prompt.
+     */
+    suggestions?: boolean;
+    /**
+     * Additional instructions to include in the prompt.
+     */
+    instructions?: string;
+    /**
+     * Emit chain-of-thought inside <cot> tag.
+     * Should be `false` for models with built-in reasoning: Claude, deepseek, o1.
+     */
+    cot?: boolean;
+};
+export declare const createSystemPrompt: (options: AssistantPromptOptions) => string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/types/src/templates/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/templates/prompt.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,kBAAkB,EAAY,MAAM,kBAAkB,CAAC;AAIrE;;GAEG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IAEH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAE9B;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,SAAS,sBAAsB,WAEjE,CAAC"}

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

@@ -1,3 +1,13 @@
+import { Schema } from 'effect';
 import { type ObjectId } from '@dxos/echo-schema';
+import { DXN, type SpaceId } from '@dxos/keys';
 export declare const createArtifactElement: (id: ObjectId) => string;
+/**
+ * A model-friendly way to reference an object.
+ * Supports vairous formats that will be normalized to a DXN.
+ */
+export declare const ArtifactId: Schema.Schema<string> & {
+    toDXN: (reference: ArtifactId, owningSpaceId?: SpaceId) => DXN;
+};
+export type ArtifactId = Schema.Schema.Type<typeof ArtifactId>;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,eAAO,MAAM,qBAAqB,GAAI,IAAI,QAAQ,WAA4B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAmB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEhE,eAAO,MAAM,qBAAqB,GAAI,IAAI,QAAQ,WAA4B,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG;IAC/C,KAAK,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,GAAG,CAAC;CA4BhE,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC"}