@dxos/assistant 0.8.4-main.fd6878d → 0.8.4-staging.60fe92afc8

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

@@ -0,0 +1,178 @@
+import { Atom, Registry as AtomRegistry } from '@effect-atom/atom-react';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Runtime from 'effect/Runtime';
+import * as Schema from 'effect/Schema';
+import { Blueprint } from '@dxos/compute';
+import { Resource } from '@dxos/context';
+import { Feed, Obj, Ref, Type } from '@dxos/echo';
+import { type URI } from '@dxos/keys';
+import { ComplexSet } from '@dxos/util';
+/**
+ * Thread message that binds or unbinds contextual objects to a conversation.
+ */
+export declare const Binding: Type.Obj<{
+    readonly blueprints: {
+        readonly added: readonly import("@dxos/echo/internal").Ref<{
+            readonly name: string;
+            readonly description?: string | undefined;
+            readonly instructions: {
+                readonly source: import("@dxos/echo/internal").Ref<{
+                    readonly name?: string | undefined;
+                    readonly content: string;
+                } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+                readonly inputs?: readonly {
+                    readonly name: string;
+                    readonly kind: "operation" | "value";
+                    readonly default?: any;
+                    readonly operation?: string | undefined;
+                }[] | undefined;
+            };
+            readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+            readonly agentCanEnable?: boolean | undefined;
+            readonly mcpServers?: readonly {
+                readonly name?: string | undefined;
+                readonly url: string;
+                readonly protocol: "http" | "sse";
+                readonly apiKey?: string | undefined;
+            }[] | undefined;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[];
+        readonly removed: readonly import("@dxos/echo/internal").Ref<{
+            readonly name: string;
+            readonly description?: string | undefined;
+            readonly instructions: {
+                readonly source: import("@dxos/echo/internal").Ref<{
+                    readonly name?: string | undefined;
+                    readonly content: string;
+                } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+                readonly inputs?: readonly {
+                    readonly name: string;
+                    readonly kind: "operation" | "value";
+                    readonly default?: any;
+                    readonly operation?: string | undefined;
+                }[] | undefined;
+            };
+            readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+            readonly agentCanEnable?: boolean | undefined;
+            readonly mcpServers?: readonly {
+                readonly name?: string | undefined;
+                readonly url: string;
+                readonly protocol: "http" | "sse";
+                readonly apiKey?: string | undefined;
+            }[] | undefined;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[];
+    };
+    readonly objects: {
+        readonly added: readonly import("@dxos/echo/internal").Ref<Obj.Unknown>[];
+        readonly removed: readonly import("@dxos/echo/internal").Ref<Obj.Unknown>[];
+    };
+}, Schema.Struct.Fields>;
+export type Binding = Type.InstanceType<typeof Binding>;
+export type BindingProps = Partial<{
+    blueprints: Ref.Ref<Blueprint.Blueprint>[];
+    objects: Ref.Ref<Obj.Unknown>[];
+}>;
+export declare class Bindings {
+    readonly blueprints: ComplexSet<Ref.Ref<{
+        readonly name: string;
+        readonly description?: string | undefined;
+        readonly instructions: {
+            readonly source: import("@dxos/echo/internal").Ref<{
+                readonly name?: string | undefined;
+                readonly content: string;
+            } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+            readonly inputs?: readonly {
+                readonly name: string;
+                readonly kind: "operation" | "value";
+                readonly default?: any;
+                readonly operation?: string | undefined;
+            }[] | undefined;
+        };
+        readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+        readonly agentCanEnable?: boolean | undefined;
+        readonly mcpServers?: readonly {
+            readonly name?: string | undefined;
+            readonly url: string;
+            readonly protocol: "http" | "sse";
+            readonly apiKey?: string | undefined;
+        }[] | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>>>;
+    readonly objects: ComplexSet<Ref.Ref<Obj.Unknown>>;
+    toJSON(): {
+        blueprints: URI.URI[];
+        objects: URI.URI[];
+    };
+}
+export type BinderOptions = {
+    feed: Feed.Feed;
+    runtime: Runtime.Runtime<Feed.FeedService>;
+    /** @effect-atom/atom-react Registry for reactive state management. */
+    registry?: AtomRegistry.Registry;
+};
+/**
+ * Manages bindings of blueprints and objects to a conversation.
+ */
+export declare class Binder extends Resource {
+    #private;
+    private readonly _blueprints;
+    private readonly _objects;
+    private readonly _registry;
+    private readonly _feed;
+    private readonly _runtime;
+    constructor(options: BinderOptions);
+    /**
+     * Returns the blueprints atom for subscription.
+     */
+    get blueprints(): Atom.Atom<Blueprint.Blueprint[]>;
+    /**
+     * Returns the objects atom for subscription.
+     */
+    get objects(): Atom.Atom<Obj.Unknown[]>;
+    /**
+     * Gets the current blueprints value.
+     */
+    getBlueprints(): Blueprint.Blueprint[];
+    /**
+     * Gets the current objects value.
+     */
+    getObjects(): Obj.Unknown[];
+    /**
+     * Subscribe to changes in blueprints.
+     */
+    subscribeBlueprints(cb: (blueprints: Blueprint.Blueprint[]) => void): () => void;
+    /**
+     * Subscribe to changes in objects.
+     */
+    subscribeObjects(cb: (objects: Obj.Unknown[]) => void): () => void;
+    protected _open(): Promise<void>;
+    /**
+     * Re-reads bindings from the feed to pick up changes made by other processes.
+     */
+    sync(): Promise<void>;
+    private _updateBindings;
+    protected _close(): Promise<void>;
+    bind({ blueprints, objects }: BindingProps): Promise<void>;
+    unbind({ blueprints, objects }: BindingProps): Promise<void>;
+    /**
+     * Process bindings to filter duplicates and determine next state.
+     */
+    private _processBindings;
+    /**
+     * Reduce results into sets of blueprints and objects.
+     */
+    private _reduce;
+    /**
+     * Merge resolved items into the current set, adding only items not already present (by DXN).
+     */
+    private _mergeInto;
+    private _resolve;
+}
+declare const Service_base: Context.TagClass<Service, "@dxos/assistant/AiContextService", {
+    binder: Binder;
+}>;
+export declare class Service extends Service_base {
+    static bindContext: ({ blueprints, objects }: BindingProps) => Effect.Effect<void, never, Service>;
+    static findObjects: <T extends Type.AnyObj>(type: T) => Effect.Effect<Type.InstanceType<T>[], never, Service>;
+}
+export {};
+//# sourceMappingURL=AiContext.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,79 @@
+import { type Registry as AtomRegistry } from '@effect-atom/atom-react';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Runtime from 'effect/Runtime';
+import { type OpaqueToolkit, type ToolExecutionService, type ToolResolverService } from '@dxos/ai';
+import { McpServer, Operation } from '@dxos/compute';
+import { Resource } from '@dxos/context';
+import { Database, Feed, Registry } from '@dxos/echo';
+import { Message, type ContentBlock } from '@dxos/types';
+import { AiRequest, type GenerationObserver } from '../request';
+import * as AiContext from './AiContext';
+export type RunProps<R = never> = {
+    prompt: string | ContentBlock.Any[];
+    system?: string;
+    observer?: GenerationObserver;
+    toolkit?: OpaqueToolkit.OpaqueToolkit<R>;
+    /**
+     * Space-level MCP servers to connect alongside blueprint-defined ones.
+     */
+    mcpServers?: readonly McpServer.McpServer[];
+};
+export type Options = {
+    feed: Feed.Feed;
+    runtime: Runtime.Runtime<Feed.FeedService>;
+    /** @effect-atom/atom-react Registry for reactive state. */
+    registry?: AtomRegistry.Registry;
+};
+/**
+ * Durable conversation state (initiated by users and agents) backed by a Feed.
+ * Executes tools based on AI responses and supports cancellation of in-progress requests.
+ */
+export declare class Session extends Resource {
+    /**
+     * Blueprints and objects bound to the session.
+     */
+    private readonly _binder;
+    private readonly _feed;
+    private readonly _runtime;
+    private readonly _sessionLoader;
+    constructor(options: Options);
+    protected _open(): Promise<void>;
+    get feed(): {
+        readonly name?: string | undefined;
+        readonly kind?: string | undefined;
+        readonly namespace?: "data" | "trace" | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>;
+    get context(): AiContext.Binder;
+    getHistory(): Promise<Message.Message[]>;
+    getTools(): Effect.Effect<Record<string, import('@effect/ai/Tool').Any>, never, ToolExecutionService | ToolResolverService>;
+    /**
+     * Not provided by default, since users might want to override them.
+     */
+    makeToolExecutionServices(): Layer.Layer<ToolExecutionService | ToolResolverService, never, OpaqueToolkit.OpaqueToolkitProvider | Operation.Service | Registry.Service>;
+    /**
+     * Creates a new cancelable request effect.
+     */
+    createRequest<R = never>(params: RunProps<R>): Effect.Effect<Message.Message[], AiRequest.RunError, AiRequest.RunRequirements | R>;
+}
+declare const Service_base: Context.TagClass<Service, "@dxos/assistant/AiSessionService", Session>;
+/**
+ * Gives access to the ai session.
+ */
+export declare class Service extends Service_base {
+    /**
+     * Create a new session layer from options.
+     */
+    static layer: (options: Options) => Layer.Layer<Service | AiContext.Service>;
+    /**
+     * Create a new session with a new feed.
+     */
+    static layerNewFeed: (options?: Omit<Options, 'feed' | 'runtime'>) => Layer.Layer<Service | AiContext.Service, never, Database.Service | Feed.FeedService>;
+    /**
+     * Run a prompt in the current session.
+     */
+    static run: <R = never>(params: RunProps<R>) => Effect.Effect<Message.Message[], AiRequest.RunError, AiRequest.RunRequirements | Service | R>;
+}
+export {};
+//# sourceMappingURL=AiSession.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,17 @@
+import * as Schema from 'effect/Schema';
+import { Obj, Type } from '@dxos/echo';
+/**
+ * Feed-level record that links this session to a point in another session's history.
+ * When present in a feed, the messages from the referenced feed up to and including
+ * `messageId` are prepended to the conversation history before each turn.
+ */
+export declare const SessionLink: Type.Obj<{
+    readonly feedRef: import("@dxos/echo/internal").Ref<{
+        readonly name?: string | undefined;
+        readonly kind?: string | undefined;
+        readonly namespace?: "data" | "trace" | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    readonly messageId: string;
+}, Schema.Struct.Fields>;
+export type SessionLink = Type.InstanceType<typeof SessionLink>;
+//# sourceMappingURL=SessionLink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLink.d.ts","sourceRoot":"","sources":["../../../../src/session/SessionLink.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAa,GAAG,EAAO,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;wBAKgD,CAAC;AAEzE,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,WAAW,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+import * as Effect from 'effect/Effect';
+import { Feed } from '@dxos/echo';
+import { Message } from '@dxos/types';
+/**
+ * Loads and reifies conversation history by resolving SessionLink feed records.
+ */
+export declare class SessionLoader {
+    /**
+     * Prepends linked history to `messages` when the feed contains a SessionLink.
+     * Queries the feed for any SessionLink record; if found, loads messages from
+     * the referenced feed up to and including `messageId` and prepends them.
+     */
+    reifyHistory(feed: Feed.Feed, messages: Message.Message[]): Effect.Effect<Message.Message[], never, Feed.FeedService>;
+}
+//# sourceMappingURL=SessionLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLoader.d.ts","sourceRoot":"","sources":["../../../../src/session/SessionLoader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,IAAI,EAAe,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;OAIG;IACH,YAAY,CACV,IAAI,EAAE,IAAI,CAAC,IAAI,EACf,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,GAC1B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CA8B3D;CACF"}

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

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

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

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

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

@@ -1,4 +1,6 @@
-export * from './artifact-diff';
-export * from './session';
-export * from './version-pin';
+export * from './toolkit';
+export * as AiContext from './AiContext';
+export * as AiSession from './AiSession';
+export { SessionLoader } from './SessionLoader';
+export * as SessionLink from './SessionLink';
 //# 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,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/session/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAE1B,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,16 @@
+import * as Effect from 'effect/Effect';
+import { type AiToolNotFoundError, OpaqueToolkit, ToolExecutionService, ToolResolverService } from '@dxos/ai';
+import { type Blueprint } from '@dxos/compute';
+export type CreateToolkitProps = {
+    toolkit?: OpaqueToolkit.Any;
+    blueprints?: readonly Blueprint.Blueprint[];
+    /**
+     * Self-contained with handlers toolkits.
+     */
+    opaqueToolkits?: readonly OpaqueToolkit.Any[];
+};
+/**
+ * Build a combined toolkit from the blueprint tools and the provided toolkit.
+ */
+export declare const createToolkit: ({ toolkit: toolkitProp, blueprints, opaqueToolkits, }: CreateToolkitProps) => Effect.Effect<OpaqueToolkit.OpaqueToolkit, AiToolNotFoundError, ToolResolverService | ToolExecutionService>;
+//# 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":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,KAAK,mBAAmB,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC9G,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC;IAC5B,UAAU,CAAC,EAAE,SAAS,SAAS,CAAC,SAAS,EAAE,CAAC;IAC5C;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,aAAa,CAAC,GAAG,EAAE,CAAC;CAC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,0DAIvB,kBAAkB,KAAG,MAAM,CAAC,MAAM,CACnC,aAAa,CAAC,aAAa,EAC3B,mBAAmB,EACnB,mBAAmB,GAAG,oBAAoB,CAeuE,CAAC"}

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

@@ -1,22 +1,27 @@
-import { Template } from '@dxos/blueprints';
-type PromptOptions = {
-    /**
-     * Emit chain-of-thought inside <cot> tag.
-     * Should be `false` for models with built-in reasoning: Claude, deepseek, o1.
-     */
-    cot?: boolean;
-    /**
-     * Whether to include suggestions in the prompt.
-     */
-    suggestions?: boolean;
+import { type ModelCapabilities } from '@dxos/ai';
+/**
+ * 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: PromptOptions) => string;
+export declare const createSystemPrompt: (options?: Partial<SystemPromptOptions>) => string;
 export declare const templates: {
-    system: Template.Template;
+    system: {
+        readonly source: import("@dxos/echo/internal").Ref<{
+            readonly name?: string | undefined;
+            readonly content: string;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>;
+        readonly inputs?: readonly {
+            readonly name: string;
+            readonly kind: "operation" | "value";
+            readonly default?: any;
+            readonly operation?: string | undefined;
+        }[] | undefined;
+    };
 };
-export {};
 //# sourceMappingURL=system.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/templates/system.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAK5C,KAAK,aAAa,GAAG;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,aAAa,WAAqD,CAAC;AAE/G,eAAO,MAAM,SAAS;;CAGrB,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../src/templates/system.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAMlD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aAAa,OAAO,CAAC,mBAAmB,CAAC,WAMrE,CAAC;AAOJ,eAAO,MAAM,SAAS;IACpB,MAAM;;;;;;;;;;;;CAIP,CAAC"}

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

@@ -0,0 +1,18 @@
+import type * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+import { Database, type Err, Obj, Ref, type Type } from '@dxos/echo';
+import { EID, EntityId, SpaceId } from '@dxos/keys';
+/**
+ * @deprecated
+ */
+export declare const createArtifactElement: (id: EntityId) => string;
+type ArtifactURI = Schema.Schema.Type<typeof ArtifactURI>;
+/**
+ * Schema that decodes ECHO reference object from an LLM-friendly input.
+ */
+export declare const RefFromLLM: Schema.transform<Schema.Schema<string, string, never> & {
+    toEchoURI: (reference: ArtifactURI, owningSpaceId?: SpaceId) => EID.EID;
+    resolve: <S extends Type.AnyEntity>(schema: S, ref: ArtifactURI) => Effect.Effect<Type.InstanceType<S>, Err.EntityNotFoundError, Database.Service>;
+}, Ref.RefSchema<Obj.Unknown>>;
+export {};
+//# sourceMappingURL=artifact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../../src/util/artifact.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGpD;;GAEG;AACH,eAAO,MAAM,qBAAqB,OAAQ,QAAQ,WAA4B,CAAC;AAqE/E,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,UAAU;eAjEV,CAAC,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,GAAG,CAAC,GAAG;aAC9D,CAAC,CAAC,SAAS,IAAI,CAAC,SAAS,EAChC,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,WAAW,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC;8BAmEnF,CAAC"}

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

@@ -0,0 +1,17 @@
+import { DocAccessor } from '@dxos/echo-client';
+export type Diff = {
+    match: string;
+    replace: string;
+};
+/**
+ * Convert a list of diffs into a list of operations.
+ */
+export declare const reduceDiffs: (diffs: readonly string[]) => Diff[];
+export declare const computeDiffsWithCursors: <T>(accessor: DocAccessor<T>, diffs: readonly string[]) => {
+    cursor: string;
+    text: string;
+}[];
+export declare const applyDiffs: <T>(accessor: DocAccessor<T>, diffs: readonly string[], { errorOnNotFound }?: {
+    errorOnNotFound?: boolean;
+}) => string;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../src/util/diff.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AAc/D,MAAM,MAAM,IAAI,GAAG;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,UAAW,SAAS,MAAM,EAAE,KAAG,IAAI,EA0B1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,CAAC,YAAY,WAAW,CAAC,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE;;;GAU5F,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,YAChB,WAAW,CAAC,CAAC,CAAC,SACjB,SAAS,MAAM,EAAE,wBACK;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,KACzD,MAoBF,CAAC"}

package/dist/types/src/util/diff.test.d.ts

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

package/dist/types/src/util/diff.test.d.ts.map

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

package/dist/types/src/util/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/util/error-handling.d.ts.map

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

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

@@ -0,0 +1,67 @@
+import { BaseError } from '@dxos/errors';
+declare const AiModelError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "AiModelError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "AiModelError";
+    };
+    isError(error: unknown): error is Error;
+    name: "AiModelError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "AiModelError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "AiModelError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * Generic error from AI model.
+ */
+export declare class AiModelError extends AiModelError_base {
+}
+declare const AiAssistantError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "AiAssistantError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "AiAssistantError";
+    };
+    isError(error: unknown): error is Error;
+    name: "AiAssistantError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "AiAssistantError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "AiAssistantError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * Generic error for AI agent execution.
+ */
+export declare class AiAssistantError extends AiAssistantError_base {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/util/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzC;;GAEG;AACH,qBAAa,YAAa,SAAQ,iBAAkD;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEvF;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,qBAA0D;CAAG"}

package/dist/types/src/util/execution-graph.d.ts

@@ -0,0 +1,85 @@
+import { type Entity } from '@dxos/echo';
+import { LogLevel } from '@dxos/log';
+import { ContentBlock } from '@dxos/types';
+/**
+ * Mercurial-style Commit.
+ */
+export type Commit = {
+    id: string;
+    parents: string[];
+    branch: string;
+    icon?: string;
+    level?: LogLevel;
+    message: string;
+    timestamp?: Date;
+    tags?: string[];
+};
+/**
+ * Models the execution graph based on a stream of events.
+ */
+export declare class ExecutionGraph {
+    private readonly _skipBlocks;
+    private _commits;
+    private _branchNames;
+    private _lastBlockId;
+    private _toolCallCommitIds;
+    private _lastCommitByBranch;
+    private _pendingToolResults;
+    constructor(_skipBlocks?: ContentBlock.Any['_tag'][]);
+    /**
+     * Adds events to the graph.
+     */
+    addEvents(events: Entity.Unknown[]): void;
+    /**
+     * Processes a message event and creates commits for its blocks.
+     */
+    private _processMessage;
+    /**
+     * Processes an AgentStatus event.
+     */
+    private _processAgentStatus;
+    /**
+     * Stable sort: objects with 'created' field are sorted by it, others remain in place.
+     */
+    private sortObjectsByCreated;
+    /**
+     * Returns the current state of the graph.
+     */
+    getGraph(lastRequest?: boolean): {
+        branches: string[];
+        commits: Commit[];
+    };
+    /**
+     * Tracks tool calls and handles pending tool result updates.
+     */
+    private _trackToolCalls;
+    /**
+     * Updates pending tool results to point to an AgentStatus event.
+     */
+    private _updatePendingToolResults;
+    /**
+     * Handles late updates when AgentStatus is processed before tool result.
+     */
+    private _handleLateToolResultUpdate;
+    /**
+     * Gets the branch name for a tool call.
+     */
+    private _getToolCallBranch;
+    /**
+     * Gets the parents for an AgentStatus commit.
+     */
+    private _getAgentStatusParents;
+    /**
+     * Checks if a commit is a tool call commit.
+     */
+    private _isToolCallCommit;
+    /**
+     * Checks if a commit is a tool result commit.
+     */
+    private _isToolResultCommit;
+    /**
+     * Extracts tool call ID from a commit ID.
+     */
+    private _extractToolCallId;
+}
+//# sourceMappingURL=execution-graph.d.ts.map