@asaidimu/utils-workspace 6.1.0 → 6.2.0

package/index.d.ts

@@ -883,44 +883,45 @@ interface Preference {
     /** UTC timestamp of when this preference was established or last updated. */
     timestamp: Timestamp;
 }
-/** Discriminated union of types that can be injected into the AI context. */
-type ContextContent = {
-    /** Denotes raw, unstructured text. */
+/** Supported payload for text-based context. */
+type TextContextContent = {
     kind: "text";
-    /** The text payload to inject. */
     value: string;
-} | {
-    /** Denotes structured JSON data. */
+};
+/** Supported payload for structured JSON context. */
+type JsonContextContent = {
     kind: "json";
-    /** The JSON payload. */
     value: unknown;
-} | {
-    /** Denotes a reference to a registered blob in the workspace store. */
+};
+/** Supported payload for blob-based context. */
+type BlobContextContent = {
     kind: "blob";
-    /** The hash linking to the full blob record. */
     sha256: SHA256;
-    /** The mime-type of the blob. */
     mediaType: BlobMediaType;
-    /** File size in bytes. */
     sizeBytes: number;
-    /** Human-readable filename. */
     filename?: string;
-} | {
-    /** Denotes data living at an external HTTP URI. */
+};
+/** Supported payload for remote URI context. */
+type RemoteContextContent = {
     kind: "remote";
-    /** The fully qualified URI to the external resource. */
     uri: URI;
-    /** Optional hint for the expected mime-type at the remote destination. */
     mediaType?: BlobMediaType;
 };
+/** Union of built-in context types. */
+type DefaultContextContent = TextContextContent | JsonContextContent | BlobContextContent | RemoteContextContent;
+/**
+ * Discriminated union of types that can be injected into the AI context.
+ * Extensions provide their own T which MUST include a unique 'kind' discriminator.
+ */
+type ContextContent<T = any> = DefaultContextContent | T;
 /** A contextual item (file, snippet, or data) attached to a session or prompt. */
-interface Context {
+interface Context<T = any> {
     /** Unique lookup key for this context entry. */
     key: string;
     /** Topics linking this context to relevant sessions or roles. */
     topics: string[];
     /** The actual payload of the context block. */
-    content: ContextContent;
+    content: ContextContent<T>;
     /** UTC timestamp of when the context was added. */
     timestamp: Timestamp;
     /** Extensible key-value store for application-specific contextual metadata. */
@@ -988,6 +989,8 @@ interface PreferenceSummary {
 interface ContextSummary {
     /** The unique key for the context item. */
     key: string;
+    /** The kind of context (e.g. 'text', 'blob', 'task'). Used for routing. */
+    kind: string;
     /** Associated semantic topics. */
     topics: string[];
     /** UTC timestamp of addition. */
@@ -1475,189 +1478,26 @@ interface SessionSnapshot {
 }
 
 /**
- * Output of PromptBuilder.build(). Input to LLMAdapter.resolve().
- *
- * Contains fully ranked and conflict-resolved preferences, context, and a
- * catalogue of blob references — but is NOT truncated and does NOT contain
- * resolved binary blob data. The adapter is responsible for:
- *   - Deciding what fits within the model's context window.
- *   - Resolving only the BlobRefs that survive truncation.
- *   - Uploading inline blobs to the provider where required.
- */
-interface Prompt {
-    /** Model identifier (e.g., "claude-sonnet-4-6", "gemini-2.0-flash"). */
-    model?: string;
-    /** Correlates this prompt to its session for logging and evaluation. */
-    session: UUID;
-    /** System-level instructions, context, and preferences. */
-    system: {
-        /** The active role's persona string. */
-        persona: string;
-        /** Global or session-level instructions. */
-        instructions?: string;
-        /** Conflict-resolved, relevance-ordered preferences. */
-        preferences: Preference[];
-        /** Ranked context entries (text and json kinds only). Blob context is
-         *  represented as referential blocks in the transcript instead. */
-        context: Context[];
-    };
-    /** Active conversation chain, oldest to newest. May include synthetic turns.
-     *  Image and document blocks carry a BlobRef only; the adapter resolves them. */
-    transcript: Turn[];
-    /**
-     * Lightweight catalogue of every blob referenced anywhere in this prompt
-     * (system.context or transcript), keyed by SHA256.
-     *
-     * Values are BlobRefs — metadata only, no binary data. The adapter uses
-     * this catalogue to resolve or upload blobs for whichever turns and context
-     * entries survive its truncation pass.
-     */
-    blobs: Map<SHA256, BlobRef>;
-    /** The role object — for inspection and adapter use. */
-    role: Role;
-    /** Model constraints to be merged by the adapter (turn > session > role). */
-    constraints: ModelConstraintMap;
-    /**
-     * Non-fatal warnings generated during the build phase.
-     * Adapters and callers should surface or log these.
-     * Examples: summarizer failures, unresolvable blob refs.
-     */
-    warnings: string[];
-}
-/**
- * Reflects the current state of the LLM adapter (limits, headroom, and readiness).
- */
-interface AdapterStatus {
-    /** Provider name (e.g., "google", "anthropic", "openai"). */
-    provider: string;
-    /** Model identifier (e.g., "claude-sonnet-4-6", "gemini-2.0-flash"). */
-    model: string;
-    /** Whether the adapter is currently able to accept requests. */
-    ready: boolean;
-    /** Token window limits and current usage. */
-    window: {
-        /** Total context window size in tokens. */
-        size: number;
-        /** Maximum output tokens for this model. */
-        out: number;
-        /** Tokens remaining — estimated or as reported by the provider. */
-        free?: number;
-    };
-    /** Capability flags for this model. */
-    feature: {
-        /** Whether the model can process image inputs. */
-        vision: boolean;
-        /** Whether the model supports tool/function calling. */
-        tools: boolean;
-        /** Whether the model supports structured JSON output mode. */
-        json: boolean;
-        /** Whether the provider supports prompt caching. */
-        cache: boolean;
-        /** Whether the adapter supports streaming. */
-        streaming: boolean;
-        /** Whether the model supports extended thinking/reasoning tokens. */
-        thinking: boolean;
-    };
-    /** Pricing tiers for this model. */
-    pricing: Array<{
-        unit: 'token' | 'call' | "image";
-        /** Exponent: price is per 10^scale units. */
-        scale: number;
-        /** Price per unit in USD. */
-        cost: {
-            input: number;
-            output: number;
-            cache?: {
-                read: number;
-                write: number;
-            };
-        };
-    }>;
-    /** Current rate limit state. */
-    rate: {
-        /** Current saturation as a fraction of the most constrained limit (0.0 to 1.0). */
-        load: number;
-        /** Milliseconds until the next request is permitted. */
-        timeout?: number;
-        /** The hard limits enforced by the provider. */
-        capacity: Array<{
-            unit: 'token' | 'call' | string;
-            /** Maximum units allowed per period. */
-            max: number;
-            /** Period length in seconds. */
-            period: number;
-        }>;
-    };
-    /** Adapter-level notes, e.g. model deprecation warnings. */
-    notes?: string[];
-}
-/**
- * The result of `PreparedPrompt.execute()`. Contains the turn and derived effects.
- */
-interface ExecuteResult {
-    /** The newly generated assistant turn. */
-    turn: Turn;
-    /** Side-effect commands to dispatch against the workspace. */
-    effects: BaseCommand[];
-}
-/**
- * A single labelled section of the system prompt.
- * Mirrors PreparedPrompt.system exactly — the assembler's output is stored
- * there directly, giving callers full inspection without re-parsing the string.
+ * Registry for managing context kind definitions and their behaviors.
  */
-interface PromptSection {
+declare class ContextRegistry {
+    private readonly store;
+    constructor();
+    private registerDefaults;
     /**
-     * Origin label for this section.
-     * Core sections use fixed labels: 'operating-system' | 'persona' |
-     * 'preferences' | 'context' | 'instructions'.
-     * Extensions carry whatever label the injector provides.
+     * Registers a new context definition.
+     * @param definition The context definition to register.
      */
-    label: string;
-    /** Text content exactly as it will be sent to the model. */
-    content: string;
-    /** Optional structured metadata for richer UI display or tooling. */
-    metadata?: Record<string, any>;
-}
-/**
- * The complete, final prompt exactly as the model will receive it.
- * Generic, provider-agnostic, fully inspectable, and executable.
- */
-interface PreparedPrompt {
-    /** Model identifier (e.g., "claude-sonnet-4-6", "gemini-2.0-flash"). */
-    model: string;
-    /** The complete system instruction broken into labelled sections for inspection. */
-    instructions: Array<PromptSection>;
-    /** Final transcript turns that will be sent after adapter-level truncation. */
-    transcript: Turn[];
-    /** Final context entries included after adapter-level truncation. */
-    context: Context[];
-    /** Final preferences included after adapter-level truncation. */
-    preferences: Preference[];
-    /** The resolved model constraints for this request. */
-    constraints: ModelConstraint;
-    /** Token accounting (estimated or exact). */
-    tokens: {
-        /** Breakdown by section. Keys are adapter-defined. */
-        breakdown: Record<string, number>;
-        /** Total input tokens — estimated or exact. */
-        total: number;
-        /** Whether total is an estimate or exact (provider-supplied). */
-        source: 'estimated' | 'exact';
-        /** Maximum output tokens configured for this request. */
-        output?: number;
-        /** Tokens remaining in the context window after this prompt. */
-        remaining?: number;
-    };
+    register(definition: ContextDefinition): void;
     /**
-     * Sends this prompt to the model.
-     * @returns The parsed assistant Turn plus any execution side-effects.
+     * Retrieves a context definition by kind.
+     * @param kind The context kind to retrieve.
      */
-    execute(): Promise<Result<ExecuteResult, WorkspaceError>>;
+    get(kind: string): ContextDefinition | undefined;
     /**
-     * Streaming variant of execute(). Yields partial turns as tokens arrive.
-     * Present only if the adapter and model support streaming.
+     * Lists all registered context definitions.
      */
-    executeStream?(): AsyncIterable<Partial<Turn> | ExecuteResult>;
+    list(): ContextDefinition[];
 }
 
 /**
@@ -1886,12 +1726,204 @@ interface WorkspaceServices {
      * Self-describing catalogue of all known content block types.
      */
     blockRegistry: ContentBlockRegistry;
+    /**
+     * Registry for managing custom context kinds.
+     */
+    contextRegistry: ContextRegistry;
     /**
      * Model registry
      */
     models: ModelRegistry;
 }
 
+/**
+ * Output of PromptBuilder.build(). Input to LLMAdapter.resolve().
+ *
+ * Contains fully ranked and conflict-resolved preferences, context, and a
+ * catalogue of blob references — but is NOT truncated and does NOT contain
+ * resolved binary blob data. The adapter is responsible for:
+ *   - Deciding what fits within the model's context window.
+ *   - Resolving only the BlobRefs that survive truncation.
+ *   - Uploading inline blobs to the provider where required.
+ */
+interface Prompt {
+    /** Model identifier (e.g., "claude-sonnet-4-6", "gemini-2.0-flash"). */
+    model?: string;
+    /** Correlates this prompt to its session for logging and evaluation. */
+    session: UUID;
+    /** System-level instructions, context, and preferences. */
+    system: {
+        /** The active role's persona string. */
+        persona: string;
+        /** Global or session-level instructions. */
+        instructions?: string;
+        /** Conflict-resolved, relevance-ordered preferences. */
+        preferences: Preference[];
+        /** Ranked context entries (text and json kinds only). Blob context is
+         *  represented as referential blocks in the transcript instead. */
+        context: Context[];
+        /** Additional sections injected by the adapter or application layer. */
+        extensions?: AssemblerExtension[];
+    };
+    /** Active conversation chain, oldest to newest. May include synthetic turns.
+     *  Image and document blocks carry a BlobRef only; the adapter resolves them. */
+    transcript: Turn[];
+    /**
+     * Lightweight catalogue of every blob referenced anywhere in this prompt
+     * (system.context or transcript), keyed by SHA256.
+     *
+     * Values are BlobRefs — metadata only, no binary data. The adapter uses
+     * this catalogue to resolve or upload blobs for whichever turns and context
+     * entries survive its truncation pass.
+     */
+    blobs: Map<SHA256, BlobRef>;
+    /** The role object — for inspection and adapter use. */
+    role: Role;
+    /** Model constraints to be merged by the adapter (turn > session > role). */
+    constraints: ModelConstraintMap;
+    /**
+     * Non-fatal warnings generated during the build phase.
+     * Adapters and callers should surface or log these.
+     * Examples: summarizer failures, unresolvable blob refs.
+     */
+    warnings: string[];
+}
+/**
+ * Reflects the current state of the LLM adapter (limits, headroom, and readiness).
+ */
+interface AdapterStatus {
+    /** Provider name (e.g., "google", "anthropic", "openai"). */
+    provider: string;
+    /** Model identifier (e.g., "claude-sonnet-4-6", "gemini-2.0-flash"). */
+    model: string;
+    /** Whether the adapter is currently able to accept requests. */
+    ready: boolean;
+    /** Token window limits and current usage. */
+    window: {
+        /** Total context window size in tokens. */
+        size: number;
+        /** Maximum output tokens for this model. */
+        out: number;
+        /** Tokens remaining — estimated or as reported by the provider. */
+        free?: number;
+    };
+    /** Capability flags for this model. */
+    feature: {
+        /** Whether the model can process image inputs. */
+        vision: boolean;
+        /** Whether the model supports tool/function calling. */
+        tools: boolean;
+        /** Whether the model supports structured JSON output mode. */
+        json: boolean;
+        /** Whether the provider supports prompt caching. */
+        cache: boolean;
+        /** Whether the adapter supports streaming. */
+        streaming: boolean;
+        /** Whether the model supports extended thinking/reasoning tokens. */
+        thinking: boolean;
+    };
+    /** Pricing tiers for this model. */
+    pricing: Array<{
+        unit: "token" | "call" | "image";
+        /** Exponent: price is per 10^scale units. */
+        scale: number;
+        /** Price per unit in USD. */
+        cost: {
+            input: number;
+            output: number;
+            cache?: {
+                read: number;
+                write: number;
+            };
+        };
+    }>;
+    /** Current rate limit state. */
+    rate: {
+        /** Current saturation as a fraction of the most constrained limit (0.0 to 1.0). */
+        load: number;
+        /** Milliseconds until the next request is permitted. */
+        timeout?: number;
+        /** The hard limits enforced by the provider. */
+        capacity: Array<{
+            unit: "token" | "call" | string;
+            /** Maximum units allowed per period. */
+            max: number;
+            /** Period length in seconds. */
+            period: number;
+        }>;
+    };
+    /** Adapter-level notes, e.g. model deprecation warnings. */
+    notes?: string[];
+}
+/**
+ * The result of `PreparedPrompt.execute()`. Contains the turn and derived effects.
+ */
+interface ExecuteResult {
+    /** The newly generated assistant turn. */
+    turn: Turn;
+    /** Side-effect commands to dispatch against the workspace. */
+    effects: BaseCommand[];
+}
+/**
+ * A single labelled section of the system prompt.
+ * Mirrors PreparedPrompt.system exactly — the assembler's output is stored
+ * there directly, giving callers full inspection without re-parsing the string.
+ */
+interface PromptSection {
+    /**
+     * Origin label for this section.
+     * Core sections use fixed labels: 'operating-system' | 'persona' |
+     * 'preferences' | 'context' | 'instructions'.
+     * Extensions carry whatever label the injector provides.
+     */
+    label: string;
+    /** Text content exactly as it will be sent to the model. */
+    content: string;
+    /** Optional structured metadata for richer UI display or tooling. */
+    metadata?: Record<string, any>;
+}
+/**
+ * The complete, final prompt exactly as the model will receive it.
+ * Generic, provider-agnostic, fully inspectable, and executable.
+ */
+interface PreparedPrompt {
+    /** Model identifier (e.g., "claude-sonnet-4-6", "gemini-2.0-flash"). */
+    model: string;
+    /** The complete system instruction broken into labelled sections for inspection. */
+    instructions: Array<PromptSection>;
+    /** Final transcript turns that will be sent after adapter-level truncation. */
+    transcript: Turn[];
+    /** Final context entries included after adapter-level truncation. */
+    context: Context[];
+    /** Final preferences included after adapter-level truncation. */
+    preferences: Preference[];
+    /** The resolved model constraints for this request. */
+    constraints: ModelConstraint;
+    /** Token accounting (estimated or exact). */
+    tokens: {
+        /** Breakdown by section. Keys are adapter-defined. */
+        breakdown: Record<string, number>;
+        /** Total input tokens — estimated or exact. */
+        total: number;
+        /** Whether total is an estimate or exact (provider-supplied). */
+        source: "estimated" | "exact";
+        /** Maximum output tokens configured for this request. */
+        output?: number;
+        /** Tokens remaining in the context window after this prompt. */
+        remaining?: number;
+    };
+    /**
+     * Sends this prompt to the model.
+     * @returns The parsed assistant Turn plus any execution side-effects.
+     */
+    execute(): Promise<Result<ExecuteResult, WorkspaceError>>;
+    /**
+     * Streaming variant of execute(). Yields partial turns as tokens arrive.
+     * Present only if the adapter and model support streaming.
+     */
+    executeStream?(): AsyncIterable<Partial<Turn> | ExecuteResult>;
+}
+
 /**
  * A simple LRU (Least Recently Used) cache implementation.
  * Used for caching frequently accessed entities in memory.
@@ -2048,17 +2080,23 @@ declare const COLLECTIONS: {
     readonly BLOB: "blob";
     readonly TOPIC: "topic";
 };
-type Collections = typeof COLLECTIONS[keyof typeof COLLECTIONS];
+type Collections = (typeof COLLECTIONS)[keyof typeof COLLECTIONS];
 
 declare class ContextStore implements Store<Context, ContextSummary, string> {
     private readonly collection;
     private readonly cache;
-    constructor(collection: Collection<Context>, cache: LRUCache<string, Context>);
-    get(key: string): Promise<Context | null>;
+    private readonly registry?;
+    private readonly delegates;
+    constructor(collection: Collection<Context>, cache: LRUCache<string, Context>, registry?: ContextRegistry | undefined);
+    /**
+     * Registers a specialized store for a specific context kind.
+     */
+    registerDelegate(kind: string, store: Store<Context, ContextSummary, string>): void;
+    get(key: string, kind?: string): Promise<Context | null>;
     add(context: Context): Promise<void>;
     list(): Promise<Context[]>;
-    update(key: string, updates: Partial<Context>): Promise<Context | null>;
-    delete(key: string): Promise<boolean>;
+    update(key: string, updates: Partial<Context>, kind?: string): Promise<Context | null>;
+    delete(key: string, kind?: string): Promise<boolean>;
     /**
      * Retrieves all context items referenced by the given topics using the in-memory index.
      */
@@ -2183,6 +2221,38 @@ declare class WorkspaceStore implements Store<WorkspaceMetadata, WorkspaceMetada
  * A function that rebuilds a portion of the workspace index from persistent storage.
  */
 type Indexer = (ctx: WorkspaceContext) => Promise<DeepPartial<Workspace>>;
+/**
+ * Definition of a specific kind of context and how the system interacts with it.
+ */
+interface ContextDefinition<T = any> {
+    /** Unique discriminator for this context kind (e.g., 'text', 'blob', 'task'). */
+    kind: string;
+    /**
+     * Where this context prefers to live in the prompt.
+     * 'system' -> Rendered into the system instructions.
+     * 'transcript' -> Rendered as a synthetic turn prefixing the transcript.
+     */
+    target: "system" | "transcript";
+    /**
+     * Transforms the context item into one or more content blocks.
+     * If these blocks contain BlobRefs, the PromptBuilder will automatically
+     * catalogue them for the adapter.
+     */
+    render(context: Context<T>): ContentBlock | ContentBlock[];
+    /**
+     * Returns a plain text representation for the RAG/retriever system.
+     */
+    toString(context: Context<T>): string;
+    /**
+     * Produces a condensed summary for the workspace index projection.
+     */
+    summarize(context: Context<T>): ContextSummary;
+    /**
+     * Optional factory for a custom store for this context kind.
+     * If omitted, the default 'context' collection is used.
+     */
+    store?: (ctx: WorkspaceContext) => Store<Context<T>, ContextSummary, string>;
+}
 /**
  * A bundle of domain-specific logic that can be plugged into the workspace.
  * Allows app builders to group related schemas, reducers, stores, and blocks.
@@ -2200,6 +2270,8 @@ interface WorkspaceExtension {
     stores?: (ctx: Omit<WorkspaceContext, "workspace">) => Record<string, Store<any>> | Promise<Record<string, Store<any>>>;
     /** Content block definitions for the LLM adapter. */
     blocks?: ContentBlockDefinition[];
+    /** Custom context kind definitions. */
+    contexts?: ContextDefinition[];
 }
 /**
  * The full set of stores passed to every reducer and middleware call.
@@ -2627,9 +2699,9 @@ declare function computeSHA256(data: Uint8Array): Promise<SHA256>;
  */
 declare function bufferToBase64(buffer: Uint8Array): string;
 /**
-* Short, deterministic hash of a string (4 chars in base36).
-* Suitable for AI-friendly reference tokens.
-*/
+ * Short, deterministic hash of a string (4 chars in base36).
+ * Suitable for AI-friendly reference tokens.
+ */
 declare function shortHash(s: string, length?: number): string;
 declare function getExtension<K extends string, V>(index: Index, key: K): Record<string, V>;
 
@@ -2666,4 +2738,4 @@ declare function createWorkspace(params: CreateWorkspaceParams): Promise<{
     services: WorkspaceServices;
 }>;
 
-export { type AddContext, type AddPreference, type AddRole, type AddSessionTopics, type AddTopic, type AddTurn, type AuthRequest, type BackendError, type BaseCommand, type BaseContentBlock, type BlobCommand, type BlobError, type BlobMediaType, type BlobRecord, type BlobRef, type BlobResolver, type BranchInfo, type BranchTurn, COLLECTIONS, type Collections, type Command, type ContentBlock, type Context, type ContextContent, type ContextRetriever, type ContextSummary, type CreateSession, type CreateWorkspace, type CreateWorkspaceParams, type DeepPartial, type DeleteContext, type DeletePreference, type DeleteRole, type DeleteSession, type DeleteTopic, type DeleteTurn, type DocumentBlock, type DocumentMediaType, type DuplicateKeyError, EMPTY_SYSTEM_ROLE, type EditTurn, type ForkSession, type ImageBlock, type ImageMediaType, type Index, type IndexExtensions, type Indexer, type InvalidCommandError, type LLMAdapter, type LLMAdapterStatic, LRUCache, type MergeTopics, type ModelConstraint, type ModelConstraintMap, type ModelName, type ModelProfile, type ModelRegistry, type NotFoundError, type OverrideSessionPreferences, type PermissionDeniedError, type PermissionGuard, type Preference, type PreferenceSummary, type Project, type PromptBuilder, type PromptBuilderOptions, type PurgeBlob, type RecordBlobRemoteId, type RegisterBlob, type ReleaseBlob, type ResolvedBlob, type ResolvedSession, type Result, type RetainBlob, type Role, type RoleSummary, type RoleTransitionBlock, type SHA256, Session, SessionManager, type SessionMetadata, type SessionSnapshot, type Settings, type Store, type Summarizer, type SummaryBlock, type SwitchSessionRole, type SyncWorkspace, type SystemActor, type TextBlock, type ThinkingBlock, type Timestamp, type ToolCall, type ToolCallCommand, type ToolRegistry, type ToolResultBlock, type ToolSummary, type ToolUseBlock, type Topic, type TopicIndex, type Turn, TurnBuilder, type TurnKey, type TurnNode, type TurnProcessor, type TurnRef, TurnTree, type URI, type UUID, type UpdateContext, type UpdatePreference, type UpdateRole, type UpdateSession, type UpdateTopic, type UpdateTurn, type Workspace, type WorkspaceBundle, type WorkspaceContext, type WorkspaceDatabase, type WorkspaceError, type WorkspaceEvents, type WorkspaceExtension, WorkspaceManager, type WorkspaceMiddleware, type WorkspaceReducer, bufferToBase64, computeSHA256, createWorkspace, createWorkspaceDatabase, del, error, getExtension, merge, ok, omitNullUndefined, shortHash, success };
+export { type AddContext, type AddPreference, type AddRole, type AddSessionTopics, type AddTopic, type AddTurn, type AuthRequest, type BackendError, type BaseCommand, type BaseContentBlock, type BlobCommand, type BlobContextContent, type BlobError, type BlobMediaType, type BlobRecord, type BlobRef, type BlobResolver, type BranchInfo, type BranchTurn, COLLECTIONS, type Collections, type Command, type ContentBlock, type Context, type ContextContent, type ContextDefinition, type ContextRetriever, type ContextSummary, type CreateSession, type CreateWorkspace, type CreateWorkspaceParams, type DeepPartial, type DefaultContextContent, type DeleteContext, type DeletePreference, type DeleteRole, type DeleteSession, type DeleteTopic, type DeleteTurn, type DocumentBlock, type DocumentMediaType, type DuplicateKeyError, EMPTY_SYSTEM_ROLE, type EditTurn, type ForkSession, type ImageBlock, type ImageMediaType, type Index, type IndexExtensions, type Indexer, type InvalidCommandError, type JsonContextContent, type LLMAdapter, type LLMAdapterStatic, LRUCache, type MergeTopics, type ModelConstraint, type ModelConstraintMap, type ModelName, type ModelProfile, type ModelRegistry, type NotFoundError, type OverrideSessionPreferences, type PermissionDeniedError, type PermissionGuard, type Preference, type PreferenceSummary, type Project, type PromptBuilder, type PromptBuilderOptions, type PurgeBlob, type RecordBlobRemoteId, type RegisterBlob, type ReleaseBlob, type RemoteContextContent, type ResolvedBlob, type ResolvedSession, type Result, type RetainBlob, type Role, type RoleSummary, type RoleTransitionBlock, type SHA256, Session, SessionManager, type SessionMetadata, type SessionSnapshot, type Settings, type Store, type Summarizer, type SummaryBlock, type SwitchSessionRole, type SyncWorkspace, type SystemActor, type TextBlock, type TextContextContent, type ThinkingBlock, type Timestamp, type ToolCall, type ToolCallCommand, type ToolRegistry, type ToolResultBlock, type ToolSummary, type ToolUseBlock, type Topic, type TopicIndex, type Turn, TurnBuilder, type TurnKey, type TurnNode, type TurnProcessor, type TurnRef, TurnTree, type URI, type UUID, type UpdateContext, type UpdatePreference, type UpdateRole, type UpdateSession, type UpdateTopic, type UpdateTurn, type Workspace, type WorkspaceBundle, type WorkspaceContext, type WorkspaceDatabase, type WorkspaceError, type WorkspaceEvents, type WorkspaceExtension, WorkspaceManager, type WorkspaceMiddleware, type WorkspaceReducer, bufferToBase64, computeSHA256, createWorkspace, createWorkspaceDatabase, del, error, getExtension, merge, ok, omitNullUndefined, shortHash, success };