@dxos/assistant 0.8.4-main.f9ba587 → 0.8.4-main.fffef41

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

@@ -0,0 +1,84 @@
+import type * as Tool from '@effect/ai/Tool';
+import * as Toolkit from '@effect/ai/Toolkit';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Pipeable from 'effect/Pipeable';
+import type * as Schema from 'effect/Schema';
+import type * as SchemaAST from 'effect/SchemaAST';
+/**
+ * Unique identifier for generic toolkit instances.
+ */
+export declare const TypeId = "~@dxos/assistant/GenericToolkit";
+/**
+ * Type-level representation of the generic toolkit identifier.
+ */
+export type TypeId = typeof TypeId;
+/**
+ * Type-safe way to define toolkits where we don't know specific types of tools,
+ * and we want to bundle definition and handlers together.
+ *
+ * Usefull for plugin-based systems, where tools are dynamically added.
+ *
+ * @param TR requirements type to the tool invocation.
+ * @param E failure type to the handlers layer.
+ * @param R requirements type to the handlers layer.
+ */
+export interface GenericToolkit<TR = never, E = never, R = never> extends Pipeable.Pipeable {
+    readonly [TypeId]: TypeId;
+    /**
+     * Toolkit definition.
+     */
+    readonly toolkit: Toolkit.Toolkit<GenericTools<TR>>;
+    /**
+     * Handlers layer.
+     */
+    readonly layer: Layer.Layer<unknown, E, R>;
+    /**
+     * Handlers effect.
+     */
+    readonly handlers: Effect.Effect<Toolkit.WithHandler<GenericTools<TR>>, E, R>;
+}
+/**
+ * Generic constraint.
+ *
+ * NOTE: Only use in place of `T extends PortableToolkit.Any`. Not suitable for standalone use.
+ */
+export interface Any {
+    readonly [TypeId]: TypeId;
+    readonly toolkit: Toolkit.Toolkit<any>;
+    readonly layer: Layer.Layer<unknown, any, any>;
+}
+export type InvocationRequirements<T extends Any> = T extends GenericToolkit<infer TR, infer _E, infer _R> ? TR : never;
+export type Failure<T extends Any> = T extends GenericToolkit<infer _TR, infer E, infer _R> ? E : never;
+export type Requirements<T extends Any> = T extends GenericToolkit<infer _TR, infer _E, infer R> ? R : never;
+/**
+ * Creates a portable toolkit from toolkit definition and handlers layer.
+ */
+export declare const make: <Tools extends Record<string, Tool.Any>, E, R>(toolkit: Toolkit.Toolkit<Tools>, layer: Layer.Layer<Tool.HandlersFor<Tools>, E, R>) => GenericToolkit<E, R>;
+/**
+ * Merges multiple portable toolkits into a single portable toolkit.
+ */
+export declare const merge: <const Toolkits extends ReadonlyArray<Any>>(
+/**
+ * The toolkits to merge together.
+ */
+...toolkits: Toolkits) => GenericToolkit<InvocationRequirements<Toolkits[number]>, Failure<Toolkits[number]>, Requirements<Toolkits[number]>>;
+/**
+ * Generic tools type where we cannot statically enumerate individual tools.
+ */
+export type GenericTools<R = never> = Record<string, Tool.Tool<string, {
+    readonly parameters: AnyStructSchemaNoContext;
+    readonly success: Schema.Schema.AnyNoContext;
+    readonly failure: typeof Schema.Never;
+}, R>>;
+export interface AnyStructSchemaNoContext extends Pipeable.Pipeable {
+    readonly [Schema.TypeId]: any;
+    readonly make: any;
+    readonly Type: any;
+    readonly Encoded: any;
+    readonly Context: never;
+    readonly ast: SchemaAST.AST;
+    readonly fields: Schema.Struct.Fields;
+    readonly annotations: any;
+}
+//# sourceMappingURL=GenericToolkit.d.ts.map

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

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

package/dist/types/src/session/artifact-diff.d.ts

@@ -0,0 +1,27 @@
+import * as Context from 'effect/Context';
+import { type ObjectId } from '@dxos/echo/internal';
+import { type ObjectVersion } from '@dxos/echo-db';
+declare const ArtifactDiffResolver_base: Context.TagClass<ArtifactDiffResolver, "@dxos/assistant/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=artifact-diff.d.ts.map

package/dist/types/src/session/artifact-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-diff.d.ts","sourceRoot":"","sources":["../../../../src/session/artifact-diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;;AAEnD;;;;;;;GAOG;AAEH,qBAAa,oBAAqB,SAAQ,yBAGvC;CAAG;AAEN,yBAAiB,oBAAoB,CAAC;IACpC,KAAY,OAAO,GAAG;QACpB,OAAO,EAAE,CACP,SAAS,EAAE;YACT,EAAE,EAAE,QAAQ,CAAC;YACb,WAAW,EAAE,aAAa,CAAC;SAC5B,EAAE,KACA,OAAO,CACV,GAAG,CACD,QAAQ,EACR;YACE,OAAO,EAAE,aAAa,CAAC;YACvB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CACF,CACF,CAAC;KACH,CAAC;CACH"}

package/dist/types/src/session/error-handling.d.ts

@@ -0,0 +1,4 @@
+import * as AiError from '@effect/ai/AiError';
+import * as Effect from 'effect/Effect';
+export declare const mapAiError: (err: AiError.AiError) => Effect.Effect<AiError.AiError>;
+//# sourceMappingURL=error-handling.d.ts.map

package/dist/types/src/session/error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../../../src/session/error-handling.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAcxC,eAAO,MAAM,UAAU,GAAI,KAAK,OAAO,CAAC,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAoB1B,CAAC"}

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

@@ -0,0 +1,12 @@
+import * as Effect from 'effect/Effect';
+import { Message } from '@dxos/types';
+import { type AiSessionRunError, type AiSessionRunParams } from './session';
+/**
+ * Formats the system prompt.
+ */
+export declare const formatSystemPrompt: ({ system, blueprints, objects, }: Pick<AiSessionRunParams<any>, "system" | "blueprints" | "objects">) => Effect.Effect<string, never, never>;
+/**
+ * Formats the user prompt.
+ */
+export declare const formatUserPrompt: ({ prompt, history, }: Pick<AiSessionRunParams<any>, "prompt" | "history">) => Effect.Effect<Message.Message, AiSessionRunError>;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/session/format.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AASxC,OAAO,EAAqB,OAAO,EAAE,MAAM,aAAa,CAAC;AAMzD,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE5E;;GAEG;AAEH,eAAO,MAAM,kBAAkB,GAAI,kCAIhC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC,wCAsCjE,CAAC;AAEL;;GAEG;AAGH,eAAO,MAAM,gBAAgB,GAAI,sBAG9B,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAoCrG,CAAC"}

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

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

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

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

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

@@ -1,3 +1,7 @@
+export * from './artifact-diff';
+export * from './observer';
 export * from './session';
+export * from './toolkit';
 export * from './version-pin';
+export * as GenericToolkit from './GenericToolkit';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/session/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/session/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAE9B,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,22 @@
+import * as Effect from 'effect/Effect';
+import { type AiParser, type ConsolePrinter } from '@dxos/ai';
+import { type Message } from '@dxos/types';
+/**
+ * Live observer of the generation process.
+ */
+export interface GenerationObserver extends AiParser.ParseResponseCallbacks {
+    /**
+     * Complete messages fired during the session, both from the model and from the user.
+     * This message will contain all message blocks emitted through the `onBlock` callback.
+     */
+    onMessage: (message: Message.Message) => Effect.Effect<void>;
+}
+export declare const GenerationObserver: Readonly<{
+    make: ({ onBegin, onPart, onBlock, onEnd, onMessage, }?: Partial<GenerationObserver>) => GenerationObserver;
+    noop: () => GenerationObserver;
+    /**
+     * Debug printer to be used in unit-tests and browser devtools.
+     */
+    fromPrinter: (printer: ConsolePrinter) => GenerationObserver;
+}>;
+//# sourceMappingURL=observer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../../src/session/observer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ,CAAC,sBAAsB;IACzE;;;OAGG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,eAAO,MAAM,kBAAkB;6DAO1B,OAAO,CAAC,kBAAkB,CAAC,KAAQ,kBAAkB;;IAUxD;;OAEG;2BACoB,cAAc;EAiBrC,CAAC"}

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

@@ -1,283 +1,51 @@
-import { Schema } from 'effect';
-import { type AgentStatus, type AiServiceClient, type GenerateRequest, Message, type ExecutableTool, type ToolId, type ToolResolver } from '@dxos/ai';
-import { type ArtifactDefinition } from '@dxos/artifact';
-import { Event } from '@dxos/async';
-import { ObjectVersion } from '@dxos/echo-db';
-import { type ObjectId } from '@dxos/echo-schema';
+import type * as AiError from '@effect/ai/AiError';
+import * as LanguageModel from '@effect/ai/LanguageModel';
+import type * as Tool from '@effect/ai/Tool';
+import type * as Toolkit from '@effect/ai/Toolkit';
+import * as Effect from 'effect/Effect';
+import type * as Schema from 'effect/Schema';
+import { type AiToolNotFoundError, type PromptPreprocessingError, type ToolExecutionService, type ToolResolverService } from '@dxos/ai';
+import { type Blueprint } from '@dxos/blueprints';
+import { Obj } from '@dxos/echo';
+import { TracingService } from '@dxos/functions';
+import { Message } from '@dxos/types';
+import { type AiAssistantError } from '../errors';
+import { GenerationObserver } from './observer';
+export type AiSessionRunError = AiError.AiError | PromptPreprocessingError | AiToolNotFoundError | AiAssistantError;
+export type AiSessionRunRequirements = LanguageModel.LanguageModel | ToolExecutionService | ToolResolverService | TracingService;
+export type AiSessionRunParams<Tools extends Record<string, Tool.Any>> = {
+    prompt: string;
+    system?: string;
+    history?: Message.Message[];
+    objects?: Obj.Any[];
+    blueprints?: Blueprint.Blueprint[];
+    toolkit?: Toolkit.WithHandler<Tools>;
+    observer?: GenerationObserver;
+};
+export type AiSessionOptions = {};
 /**
  * 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 = {
-    artifacts: ArtifactDefinition[];
-    /**
-     * Non-artifact specific tools.
-     */
-    tools: ToolId[];
-    history: Message[];
-    prompt: string;
-    generationOptions?: Pick<GenerateRequest, 'model'>;
-    extensions?: ToolContextExtensions;
-    systemPrompt?: string;
-    /**
-     * Pre-require artifacts.
-     */
-    requiredArtifactIds?: string[];
-    client: AiServiceClient;
-    toolResolver: ToolResolver;
-    /**
-     * Executable tools that do not go through the tool resolver.
-     */
-    executableTools?: ExecutableTool[];
-    /**
-     * @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;
-    /** Pending messages (incl. the current user request). */
-    private _pending;
-    /** Current streaming response. */
-    private _stream;
-    /** Prior history from queue. */
+    /** Prevents concurrent execution of session. */
+    private readonly _semaphore;
+    /** Message history from queue. */
     private _history;
+    /** Pending messages for this session (incl. the current prompt). */
+    private _pending;
+    constructor(_options?: AiSessionOptions);
+    run: <Tools extends Record<string, Tool.Any>>({ prompt, system: systemTemplate, history, objects, blueprints, toolkit, observer, }: AiSessionRunParams<Tools>) => Effect.Effect<Message.Message[], AiSessionRunError, AiSessionRunRequirements>;
     /**
-     * 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";
-    }>;
-    /**
-     * Complete block added to Message.
-     */
-    readonly block: Event<{
-        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;
-    }>;
-    /**
-     * Update partial block (while streaming).
-     */
-    readonly update: Event<{
-        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;
-    }>;
-    /**
-     * Unparsed events from the underlying generation stream.
-     */
-    readonly streamEvent: Event<import("@dxos/ai").GenerationStreamEvent>;
-    /**
-     * 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;
-        })[];
-    }>;
-    /**
-     * Agent self-reporting its status.
-     * Triggered by the model.
-     */
-    readonly statusReport: Event<AgentStatus>;
-    /**
-     * Emits when the session is done.
-     */
-    readonly done: Event<void>;
-    /**
-     * Emits when the tool reports its status.
-     * Triggered by the tool execution function.
-     */
-    readonly toolStatusReport: Event<{
-        message: Message;
-        status: AgentStatus;
-    }>;
-    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.
+     * @deprecated
      */
-    run(options: SessionRunOptions): Promise<Message[]>;
-    runStructured<S extends Schema.Schema.AnyNoContext>(schema: S, options: SessionRunOptions): 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 {
+    runStructured<S extends Schema.Schema.AnyNoContext>(_schema: S, _options: AiSessionRunParams<any>): Promise<Schema.Schema.Type<S>>;
 }
-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":"AAIA,OAAO,KAAK,KAAK,OAAO,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAG7C,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAGzB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,wBAAwB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAEpH,MAAM,MAAM,wBAAwB,GAChC,aAAa,CAAC,aAAa,GAC3B,oBAAoB,GACpB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;IACvE,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAElC;;;;;;;;;GASG;AACH,qBAAa,SAAS;IAWR,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAVrC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IAEtE,kCAAkC;IAElC,OAAO,CAAC,QAAQ,CAAyB;IAEzC,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAyB;gBAEZ,QAAQ,GAAE,gBAAqB;IAE5D,GAAG,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,sFAQ5C,kBAAkB,CAAC,KAAK,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,wBAAwB,CAAC,CA+FhC;IAE5E;;OAEG;IAEG,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,EACtD,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CASlC"}

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

@@ -0,0 +1,15 @@
+import type * as Tool from '@effect/ai/Tool';
+import * as Toolkit from '@effect/ai/Toolkit';
+import * as Effect from 'effect/Effect';
+import { type AiToolNotFoundError, ToolExecutionService, type ToolId, ToolResolverService } from '@dxos/ai';
+import { type Blueprint } from '@dxos/blueprints';
+export type ToolkitParams<Tools extends Record<string, Tool.Any>> = {
+    toolkit?: Toolkit.Toolkit<Tools>;
+    toolIds?: ToolId[];
+    blueprints?: Blueprint.Blueprint[];
+};
+/**
+ * Build a combined toolkit from the blueprint tools and the provided toolkit.
+ */
+export declare const createToolkit: <Tools extends Record<string, Tool.Any> = {}>({ toolkit: toolkitParam, toolIds, blueprints, }: ToolkitParams<Tools>) => Effect.Effect<Toolkit.WithHandler<any>, AiToolNotFoundError, ToolResolverService | ToolExecutionService | Tool.HandlersFor<Tools>>;
+//# sourceMappingURL=toolkit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.d.ts","sourceRoot":"","sources":["../../../../src/session/toolkit.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,mBAAmB,EAAE,oBAAoB,EAAE,KAAK,MAAM,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,iDAIxE,aAAa,CAAC,KAAK,CAAC,KAAG,MAAM,CAAC,MAAM,CACrC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,EACxB,mBAAmB,EACnB,mBAAmB,GAAG,oBAAoB,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAkBlE,CAAC"}

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

@@ -1,7 +1,7 @@
-import { Schema } from 'effect';
-import { type MessageContentBlock } from '@dxos/ai';
+import * as Schema from 'effect/Schema';
+import { type AnyEchoObject } from '@dxos/echo/internal';
 import { type ObjectVersion } from '@dxos/echo-db';
-import { type BaseEchoObject } from '@dxos/echo-schema';
+import { type ContentBlock } from '@dxos/types';
 declare const VersionPinSchema: Schema.Struct<{
     objectId: import("@dxos/keys").ObjectIdClass;
     version: Schema.Schema<ObjectVersion, ObjectVersion, never>;
@@ -14,8 +14,8 @@ 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;
+    fromObject: (object: AnyEchoObject) => VersionPin;
+    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,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,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,aAAa,KAAK,UAAU,CAAC;IAClD,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 './system';
+//# 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/system.d.ts

@@ -0,0 +1,18 @@
+import { type ModelCapabilities } from '@dxos/ai';
+import { Template } from '@dxos/blueprints';
+/**
+ * System template variables.
+ */
+export type SystemPromptOptions = ModelCapabilities & {
+    DATETIME: string;
+};
+/**
+ * Base system prompt.
+ * NOTE: This contains protocol instructions that can not be dynamically edited.
+ */
+export declare const createSystemPrompt: (options?: Partial<SystemPromptOptions>) => string;
+export declare const templates: {
+    /** Editable system prompt.*/
+    system: Template.Template;
+};
+//# sourceMappingURL=system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/templates/system.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAK5C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAS,OAAO,CAAC,mBAAmB,CAAM,WAM1E,CAAC;AAEJ,eAAO,MAAM,SAAS;IACpB,6BAA6B;;CAQ9B,CAAC"}

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

@@ -0,0 +1,20 @@
+import type * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+import { type ObjectNotFoundError, type Type } from '@dxos/echo';
+import { type ObjectId } from '@dxos/echo/internal';
+import { DatabaseService } from '@dxos/echo-db';
+import { DXN, type SpaceId } from '@dxos/keys';
+/**
+ * @deprecated
+ */
+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;
+    resolve: <S extends Type.Obj.Any | Type.Relation.Any>(schema: S, ref: ArtifactId) => Effect.Effect<Schema.Schema.Type<S>, ObjectNotFoundError, DatabaseService>;
+};
+export type ArtifactId = Schema.Schema.Type<typeof ArtifactId>;
+//# sourceMappingURL=artifact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../../src/types/artifact.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,GAAG,EAAmB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,IAAI,QAAQ,WAA4B,CAAC;AAE/E;;;GAGG;AAEH,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;IAC/D,OAAO,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAClD,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,UAAU,KACZ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;CAwCjF,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC"}