@dxos/assistant 0.8.4-main.b97322e → 0.8.4-main.bc2380dfbc

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

@@ -0,0 +1,17 @@
+import { type ModelCapabilities } from '@dxos/ai';
+import { Template } from '@dxos/compute';
+/**
+ * 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: {
+    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,eAAe,CAAC;AAKzC;;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,27 @@
+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 { DXN, type ObjectId, 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.
+ *
+ * @deprecated Use `Ref.Ref(XXX)` instead.
+ */
+export declare const ArtifactId: Schema.Schema<string> & {
+    toDXN: (reference: ArtifactId, owningSpaceId?: SpaceId) => DXN;
+    resolve: <S extends Type.AnyEntity>(schema: S, ref: ArtifactId) => Effect.Effect<Schema.Schema.Type<S>, Err.ObjectNotFoundError, Database.Service>;
+};
+export type ArtifactId = Schema.Schema.Type<typeof ArtifactId>;
+/**
+ * Schema that decodes ECHO reference object from an LLM-friendly input.
+ */
+export declare const RefFromLLM: Schema.transform<Schema.Schema<string, string, never> & {
+    toDXN: (reference: ArtifactId, owningSpaceId?: SpaceId) => DXN;
+    resolve: <S extends Type.AnyEntity>(schema: S, ref: ArtifactId) => Effect.Effect<Schema.Schema.Type<S>, Err.ObjectNotFoundError, Database.Service>;
+}, Ref.RefSchema<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>>;
+//# 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,EAAmB,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG/E;;GAEG;AACH,eAAO,MAAM,qBAAqB,OAAQ,QAAQ,WAA4B,CAAC;AAE/E;;;;;GAKG;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,SAAS,EAChC,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,UAAU,KACZ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CA6CtF,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,UAAU;WAxDd,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,GAAG;aACrD,CAAC,CAAC,SAAS,IAAI,CAAC,SAAS,EAChC,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,UAAU,KACZ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC;oHA0DpF,CAAC"}

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

@@ -0,0 +1,17 @@
+import { DocAccessor } from '@dxos/echo-db';
+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,eAAe,CAAC;AAc3D,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

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-graph.d.ts","sourceRoot":"","sources":["../../../../src/util/execution-graph.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAW,MAAM,aAAa,CAAC;AAKpD;;GAEG;AAEH,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAqBF;;GAEG;AACH,qBAAa,cAAc;IAWb,OAAO,CAAC,QAAQ,CAAC,WAAW;IATxC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,YAAY,CAAqB;IAGzC,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,mBAAmB,CAA6B;IAExD,YAA6B,WAAW,GAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAgB,EAAI;IAEtF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QASjC;IAED;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;OAEG;IACH,QAAQ,CAAC,WAAW,UAAQ,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAQvE;IAED;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyBjC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAsBnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK3B"}

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

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

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

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

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

@@ -0,0 +1,7 @@
+export * from './artifact';
+export * from './diff';
+export * from './error-handling';
+export * from './errors';
+export * from './execution-graph';
+export * from './tracing';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/util/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,233 @@
+import { Trace } from '@dxos/compute';
+import { Obj } from '@dxos/echo';
+/**
+ * Partial content block emitted.
+ */
+export declare const PartialBlock: Trace.EventType<{
+    readonly messageId: string;
+    readonly role: "assistant" | "tool" | "user";
+    readonly block: {
+        readonly _tag: "anchor";
+        readonly pending?: boolean | undefined;
+        readonly objectId: string;
+        readonly version: unknown;
+    } | {
+        readonly _tag: "file";
+        readonly pending?: boolean | undefined;
+        readonly url: string;
+        readonly name?: string | undefined;
+        readonly mediaType?: string | undefined;
+    } | {
+        readonly _tag: "image";
+        readonly pending?: boolean | undefined;
+        readonly id?: string | undefined;
+        readonly source?: {
+            readonly type: "base64";
+            readonly mediaType: string;
+            readonly data: string;
+        } | {
+            readonly type: "http";
+            readonly url: string;
+        } | undefined;
+    } | {
+        readonly _tag: "json";
+        readonly pending?: boolean | undefined;
+        readonly disposition?: "cot" | "synthetic" | "user" | "version-pin" | undefined;
+        readonly data: string;
+    } | {
+        readonly _tag: "proposal";
+        readonly pending?: boolean | undefined;
+        readonly text: string;
+    } | {
+        readonly _tag: "reasoning";
+        readonly pending?: boolean | undefined;
+        readonly reasoningText?: string | undefined;
+        readonly redactedText?: string | undefined;
+        readonly signature?: string | undefined;
+    } | {
+        readonly _tag: "reference";
+        readonly pending?: boolean | undefined;
+        readonly reference: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    } | {
+        readonly _tag: "select";
+        readonly pending?: boolean | undefined;
+        readonly options: string[];
+    } | {
+        readonly _tag: "stats";
+        readonly pending?: boolean | undefined;
+        readonly mimeType?: string | undefined;
+        readonly message?: string | undefined;
+        readonly model?: string | undefined;
+        readonly usage?: {
+            readonly inputTokens?: number | undefined;
+            readonly outputTokens?: number | undefined;
+            readonly totalTokens?: number | undefined;
+        } | undefined;
+        readonly toolCalls?: number | undefined;
+        readonly errors?: number | undefined;
+        readonly duration?: number | undefined;
+    } | {
+        readonly _tag: "status";
+        readonly pending?: boolean | undefined;
+        readonly statusText: string;
+    } | {
+        readonly _tag: "suggestion";
+        readonly pending?: boolean | undefined;
+        readonly text: string;
+    } | {
+        readonly _tag: "summary";
+        readonly pending?: boolean | undefined;
+        readonly content: string;
+    } | {
+        readonly _tag: "text";
+        readonly pending?: boolean | undefined;
+        readonly mimeType?: string | undefined;
+        readonly text: string;
+        readonly disposition?: "cot" | "synthetic" | "user" | "version-pin" | undefined;
+    } | {
+        readonly _tag: "toolCall";
+        readonly pending?: boolean | undefined;
+        readonly toolCallId: string;
+        readonly name: string;
+        readonly input: string;
+        readonly providerExecuted: boolean;
+    } | {
+        readonly _tag: "toolResult";
+        readonly pending?: boolean | undefined;
+        readonly toolCallId: string;
+        readonly name: string;
+        readonly result?: string | undefined;
+        readonly error?: string | undefined;
+        readonly providerExecuted: boolean;
+    } | {
+        readonly _tag: "toolkit";
+        readonly pending?: boolean | undefined;
+    } | {
+        readonly _tag: "transcript";
+        readonly pending?: boolean | undefined;
+        readonly started: string;
+        readonly text: string;
+    };
+}>;
+/**
+ * Complete content block emitted.
+ */
+export declare const CompleteBlock: Trace.EventType<{
+    readonly messageId: string;
+    readonly role: "assistant" | "tool" | "user";
+    readonly block: {
+        readonly _tag: "anchor";
+        readonly pending?: boolean | undefined;
+        readonly objectId: string;
+        readonly version: unknown;
+    } | {
+        readonly _tag: "file";
+        readonly pending?: boolean | undefined;
+        readonly url: string;
+        readonly name?: string | undefined;
+        readonly mediaType?: string | undefined;
+    } | {
+        readonly _tag: "image";
+        readonly pending?: boolean | undefined;
+        readonly id?: string | undefined;
+        readonly source?: {
+            readonly type: "base64";
+            readonly mediaType: string;
+            readonly data: string;
+        } | {
+            readonly type: "http";
+            readonly url: string;
+        } | undefined;
+    } | {
+        readonly _tag: "json";
+        readonly pending?: boolean | undefined;
+        readonly disposition?: "cot" | "synthetic" | "user" | "version-pin" | undefined;
+        readonly data: string;
+    } | {
+        readonly _tag: "proposal";
+        readonly pending?: boolean | undefined;
+        readonly text: string;
+    } | {
+        readonly _tag: "reasoning";
+        readonly pending?: boolean | undefined;
+        readonly reasoningText?: string | undefined;
+        readonly redactedText?: string | undefined;
+        readonly signature?: string | undefined;
+    } | {
+        readonly _tag: "reference";
+        readonly pending?: boolean | undefined;
+        readonly reference: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    } | {
+        readonly _tag: "select";
+        readonly pending?: boolean | undefined;
+        readonly options: string[];
+    } | {
+        readonly _tag: "stats";
+        readonly pending?: boolean | undefined;
+        readonly mimeType?: string | undefined;
+        readonly message?: string | undefined;
+        readonly model?: string | undefined;
+        readonly usage?: {
+            readonly inputTokens?: number | undefined;
+            readonly outputTokens?: number | undefined;
+            readonly totalTokens?: number | undefined;
+        } | undefined;
+        readonly toolCalls?: number | undefined;
+        readonly errors?: number | undefined;
+        readonly duration?: number | undefined;
+    } | {
+        readonly _tag: "status";
+        readonly pending?: boolean | undefined;
+        readonly statusText: string;
+    } | {
+        readonly _tag: "suggestion";
+        readonly pending?: boolean | undefined;
+        readonly text: string;
+    } | {
+        readonly _tag: "summary";
+        readonly pending?: boolean | undefined;
+        readonly content: string;
+    } | {
+        readonly _tag: "text";
+        readonly pending?: boolean | undefined;
+        readonly mimeType?: string | undefined;
+        readonly text: string;
+        readonly disposition?: "cot" | "synthetic" | "user" | "version-pin" | undefined;
+    } | {
+        readonly _tag: "toolCall";
+        readonly pending?: boolean | undefined;
+        readonly toolCallId: string;
+        readonly name: string;
+        readonly input: string;
+        readonly providerExecuted: boolean;
+    } | {
+        readonly _tag: "toolResult";
+        readonly pending?: boolean | undefined;
+        readonly toolCallId: string;
+        readonly name: string;
+        readonly result?: string | undefined;
+        readonly error?: string | undefined;
+        readonly providerExecuted: boolean;
+    } | {
+        readonly _tag: "toolkit";
+        readonly pending?: boolean | undefined;
+    } | {
+        readonly _tag: "transcript";
+        readonly pending?: boolean | undefined;
+        readonly started: string;
+        readonly text: string;
+    };
+}>;
+export declare const AgentRequestBegin: Trace.EventType<{}>;
+export declare const AgentRequestEnd: Trace.EventType<{}>;
+/**
+ * Emitted when an MCP server connection fails for a request turn.
+ * Ephemeral so that misconfigured/unreachable servers don't pollute the durable feed,
+ * but can still be surfaced to the user via the live ephemeral event stream.
+ */
+export declare const McpServerError: Trace.EventType<{
+    readonly url: string;
+    readonly protocol: "http" | "sse";
+    readonly message: string;
+}>;
+//# sourceMappingURL=tracing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../../src/util/tracing.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAGjC;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOxB,CAAC;AAEH,eAAO,MAAM,iBAAiB,qBAG5B,CAAC;AAEH,eAAO,MAAM,eAAe,qBAG1B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;EAOzB,CAAC"}