@rizom/brain 0.2.0-alpha.150 → 0.2.0-alpha.152

package/dist/plugins.d.ts

@@ -1,192 +1,195 @@
-import { z, ZodType } from 'zod/v4';
-
+import { ZodType, z } from "zod/v4";
+//#region ../../shell/entity-service/src/visibility.d.ts
 declare const canonicalContentVisibilitySchema: z.ZodEnum<{
-    public: "public";
-    shared: "shared";
-    restricted: "restricted";
+  public: "public";
+  shared: "shared";
+  restricted: "restricted";
 }>;
 type ContentVisibility = z.infer<typeof canonicalContentVisibilitySchema>;
 type RawContentVisibility = ContentVisibility | "private";
-
+//#endregion
+//#region ../../shared/contracts/src/agent-response.d.ts
 interface PendingConfirmation {
-    id: string;
-    toolCallId?: string | undefined;
-    toolName: string;
-    summary: string;
-    completionSummary?: string | undefined;
-    preview?: string | undefined;
-    args: unknown;
+  id: string;
+  toolCallId?: string | undefined;
+  toolName: string;
+  summary: string;
+  completionSummary?: string | undefined;
+  preview?: string | undefined;
+  args: unknown;
 }
 declare const PendingConfirmationSchema: z.ZodType<PendingConfirmation, PendingConfirmation>;
 type ToolApprovalCardState = "approval-requested" | "approval-responded" | "output-available" | "output-denied" | "output-error";
 interface ToolApprovalCard {
-    kind: "tool-approval";
-    id: string;
-    toolCallId?: string | undefined;
-    toolName: string;
-    input?: Record<string, unknown> | undefined;
-    summary: string;
-    completionSummary?: string | undefined;
-    preview?: string | undefined;
-    state: ToolApprovalCardState;
-    output?: unknown;
-    error?: string | undefined;
+  kind: "tool-approval";
+  id: string;
+  toolCallId?: string | undefined;
+  toolName: string;
+  input?: Record<string, unknown> | undefined;
+  summary: string;
+  completionSummary?: string | undefined;
+  preview?: string | undefined;
+  state: ToolApprovalCardState;
+  output?: unknown;
+  error?: string | undefined;
 }
 interface AttachmentCardSource {
-    entityType?: string | undefined;
-    entityId?: string | undefined;
-    attachmentType?: string | undefined;
+  entityType?: string | undefined;
+  entityId?: string | undefined;
+  attachmentType?: string | undefined;
 }
 interface AttachmentCardData {
-    mediaType: string;
-    url: string;
-    downloadUrl?: string | undefined;
-    previewUrl?: string | undefined;
-    filename?: string | undefined;
-    sizeBytes?: number | undefined;
-    source?: AttachmentCardSource | undefined;
+  mediaType: string;
+  url: string;
+  downloadUrl?: string | undefined;
+  previewUrl?: string | undefined;
+  filename?: string | undefined;
+  sizeBytes?: number | undefined;
+  source?: AttachmentCardSource | undefined;
 }
 interface AttachmentCard {
-    kind: "attachment";
-    id: string;
-    jobId?: string | undefined;
-    title: string;
-    description?: string | undefined;
-    attachment: AttachmentCardData;
+  kind: "attachment";
+  id: string;
+  jobId?: string | undefined;
+  title: string;
+  description?: string | undefined;
+  attachment: AttachmentCardData;
 }
 interface SourceCitation {
-    id: string;
-    title?: string | undefined;
-    source: string;
-    url?: string | undefined;
-    entityType?: string | undefined;
-    entityId?: string | undefined;
-    excerpt?: string | undefined;
-    provenance?: Record<string, unknown> | undefined;
+  id: string;
+  title?: string | undefined;
+  source: string;
+  url?: string | undefined;
+  entityType?: string | undefined;
+  entityId?: string | undefined;
+  excerpt?: string | undefined;
+  provenance?: Record<string, unknown> | undefined;
 }
 interface SourcesCard {
-    kind: "sources";
-    id: string;
-    title?: string | undefined;
-    sources: SourceCitation[];
+  kind: "sources";
+  id: string;
+  title?: string | undefined;
+  sources: SourceCitation[];
 }
 interface PromptChatAction {
-    type: "prompt";
-    id: string;
-    label: string;
-    prompt: string;
-    description?: string | undefined;
+  type: "prompt";
+  id: string;
+  label: string;
+  prompt: string;
+  description?: string | undefined;
 }
 interface EventChatAction {
-    type: "event";
-    id: string;
-    label: string;
-    event: string;
-    fromState?: string | undefined;
-    description?: string | undefined;
+  type: "event";
+  id: string;
+  label: string;
+  event: string;
+  fromState?: string | undefined;
+  description?: string | undefined;
 }
 type ChatAction = PromptChatAction | EventChatAction;
 interface ActionsCard {
-    kind: "actions";
-    id: string;
-    title?: string | undefined;
-    defaultOpen?: boolean | undefined;
-    actions: ChatAction[];
+  kind: "actions";
+  id: string;
+  title?: string | undefined;
+  defaultOpen?: boolean | undefined;
+  actions: ChatAction[];
 }
 type StructuredChatCard = ToolApprovalCard | AttachmentCard | SourcesCard | ActionsCard;
 interface ToolResultErrorData {
-    message: string;
-    code?: string | undefined;
+  message: string;
+  code?: string | undefined;
 }
 interface ToolResultData {
-    toolName: string;
-    args?: Record<string, unknown> | undefined;
-    jobId?: string | undefined;
-    data?: unknown;
-    error?: ToolResultErrorData | undefined;
+  toolName: string;
+  args?: Record<string, unknown> | undefined;
+  jobId?: string | undefined;
+  data?: unknown;
+  error?: ToolResultErrorData | undefined;
 }
 declare const ToolResultDataSchema: z.ZodType<ToolResultData, ToolResultData>;
 interface AgentResponseUsage {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
+  promptTokens: number;
+  completionTokens: number;
+  totalTokens: number;
 }
 interface AgentResponse {
-    text: string;
-    toolResults?: ToolResultData[] | undefined;
-    cards?: StructuredChatCard[] | undefined;
-    pendingConfirmations?: PendingConfirmation[] | undefined;
-    usage: AgentResponseUsage;
+  text: string;
+  toolResults?: ToolResultData[] | undefined;
+  cards?: StructuredChatCard[] | undefined;
+  pendingConfirmations?: PendingConfirmation[] | undefined;
+  usage: AgentResponseUsage;
 }
 declare const AgentResponseSchema: z.ZodType<AgentResponse, AgentResponse>;
-
+//#endregion
+//#region ../../shared/contracts/src/message-role.d.ts
 /** Canonical role of a stored conversation message. */
 type MessageRole = "user" | "assistant";
 declare const messageRoleSchema: z.ZodType<MessageRole, MessageRole>;
-
+//#endregion
+//#region ../../shared/contracts/src/response-types.d.ts
 /**
  * Query response schemas used throughout the system
  */
 interface DefaultQuerySource {
-    id: string;
-    type: string;
-    excerpt?: string | undefined;
-    relevance?: number | undefined;
+  id: string;
+  type: string;
+  excerpt?: string | undefined;
+  relevance?: number | undefined;
 }
 interface DefaultQueryResponse {
-    message: string;
-    summary?: string | undefined;
-    topics?: string[] | undefined;
-    sources?: DefaultQuerySource[] | undefined;
-    metadata?: Record<string, unknown> | undefined;
-}
-
+  message: string;
+  summary?: string | undefined;
+  topics?: string[] | undefined;
+  sources?: DefaultQuerySource[] | undefined;
+  metadata?: Record<string, unknown> | undefined;
+}
+//#endregion
+//#region ../../shell/entity-service/src/types.d.ts
 /**
  * Options for entity mutation operations (create, update, upsert)
  */
 interface EntityMutationEventContext {
-    conversationId?: string;
-    channelId?: string;
-    runId?: string;
-    toolCallId?: string;
+  conversationId?: string;
+  channelId?: string;
+  runId?: string;
+  toolCallId?: string;
 }
 interface EntityJobOptions {
-    priority?: number;
-    maxRetries?: number;
-    eventContext?: EntityMutationEventContext;
+  priority?: number;
+  maxRetries?: number;
+  eventContext?: EntityMutationEventContext;
 }
-
 /**
  * Options for entity creation (extends EntityJobOptions with deduplication)
  */
 interface CreateEntityOptions extends EntityJobOptions {
-    deduplicateId?: boolean;
+  deduplicateId?: boolean;
 }
 /**
  * Result of an entity mutation that triggers an embedding job.
  * When skipped is true, content was unchanged — no DB write, no event, no embedding job.
  */
 interface EntityMutationResult {
-    entityId: string;
-    jobId: string;
-    skipped: boolean;
+  entityId: string;
+  jobId: string;
+  skipped: boolean;
 }
 /**
  * Input for adapter-validated direct creation from finalized markdown.
  */
 interface CreateEntityFromMarkdownInput {
-    entityType: string;
-    id: string;
-    markdown: string;
+  entityType: string;
+  id: string;
+  markdown: string;
 }
 /**
  * Data for storing an embedding for an entity
  */
 interface StoreEmbeddingData {
-    entityId: string;
-    entityType: string;
-    embedding: Float32Array;
-    contentHash: string;
+  entityId: string;
+  entityType: string;
+  embedding: Float32Array;
+  contentHash: string;
 }
 type EntitySchema$1<T> = z.ZodType<T, unknown>;
 /**
@@ -194,132 +197,132 @@ type EntitySchema$1<T> = z.ZodType<T, unknown>;
  * TMetadata defaults to Record<string, unknown> for backward compatibility
  */
 interface BaseEntity<TMetadata = Record<string, unknown>> {
-    id: string;
-    entityType: string;
-    content: string;
-    created: string;
-    updated: string;
-    visibility: ContentVisibility;
-    metadata: TMetadata;
-    /** SHA256 hash of content for change detection */
-    contentHash: string;
+  id: string;
+  entityType: string;
+  content: string;
+  created: string;
+  updated: string;
+  visibility: ContentVisibility;
+  metadata: TMetadata;
+  /** SHA256 hash of content for change detection */
+  contentHash: string;
 }
 /**
  * Entity input type for creation - allows partial entities with optional system fields
  * contentHash is excluded because it's computed automatically by the entity service
  */
 type EntityInput<T extends BaseEntity> = Omit<T, "id" | "created" | "updated" | "contentHash" | "visibility"> & {
-    id?: string;
-    created?: string;
-    updated?: string;
-    visibility?: RawContentVisibility;
+  id?: string;
+  created?: string;
+  updated?: string;
+  visibility?: RawContentVisibility;
 };
 /**
  * Search result type
  */
 interface SearchResult<T extends BaseEntity = BaseEntity> {
-    entity: T;
-    score: number;
-    excerpt: string;
+  entity: T;
+  score: number;
+  excerpt: string;
 }
 /**
  * Normalized system_create input shape used by plugin create interceptors.
  */
 interface CreateCoverImageInput {
-    generate?: boolean | undefined;
-    prompt?: string | undefined;
+  generate?: boolean | undefined;
+  prompt?: string | undefined;
 }
 interface CreateFromAttachmentInput {
-    kind: "entity-attachment";
-    sourceEntityType: string;
-    sourceEntityId: string;
-    attachmentType: string;
+  kind: "entity-attachment";
+  sourceEntityType: string;
+  sourceEntityId: string;
+  attachmentType: string;
 }
 interface CreateFromUploadInput {
-    kind: "upload";
-    id: string;
+  kind: "upload";
+  id: string;
 }
 interface CreateFromConversationMessageInput {
-    kind: "conversation-message";
-    messageId?: string | undefined;
+  kind: "conversation-message";
+  messageId?: string | undefined;
 }
 type CreateFromInput = CreateFromAttachmentInput | CreateFromUploadInput | CreateFromConversationMessageInput;
 type CreateTransform = "extract-markdown" | "preserve";
 interface CreateInput {
-    entityType: string;
-    prompt?: string;
-    title?: string;
-    content?: string;
-    url?: string;
-    from?: CreateFromInput;
-    transform?: CreateTransform;
-    replace?: boolean;
-    sourceEntityType?: string;
-    sourceEntityId?: string;
-    sourceEntityIds?: string[];
-    targetEntityType?: string;
-    targetEntityId?: string;
-    coverImage?: boolean | CreateCoverImageInput;
+  entityType: string;
+  prompt?: string;
+  title?: string;
+  content?: string;
+  url?: string;
+  from?: CreateFromInput;
+  transform?: CreateTransform;
+  replace?: boolean;
+  sourceEntityType?: string;
+  sourceEntityId?: string;
+  sourceEntityIds?: string[];
+  targetEntityType?: string;
+  targetEntityId?: string;
+  coverImage?: boolean | CreateCoverImageInput;
 }
 /**
  * Minimal caller context forwarded to plugin create interceptors.
  */
 interface CreateExecutionContext {
-    interfaceType: string;
-    userId: string;
-    channelId?: string;
-    channelName?: string;
+  interfaceType: string;
+  userId: string;
+  channelId?: string;
+  channelName?: string;
 }
 /**
  * Result returned to system_create when a plugin fully handles creation.
  */
 declare const createResultAttachmentSchema: z.ZodObject<{
-    mediaType: z.ZodString;
-    url: z.ZodString;
-    downloadUrl: z.ZodOptional<z.ZodString>;
-    previewUrl: z.ZodOptional<z.ZodString>;
-    filename: z.ZodOptional<z.ZodString>;
-    sizeBytes: z.ZodOptional<z.ZodNumber>;
-    source: z.ZodOptional<z.ZodObject<{
-        entityType: z.ZodOptional<z.ZodString>;
-        entityId: z.ZodOptional<z.ZodString>;
-        attachmentType: z.ZodOptional<z.ZodString>;
-    }>>;
+  mediaType: z.ZodString;
+  url: z.ZodString;
+  downloadUrl: z.ZodOptional<z.ZodString>;
+  previewUrl: z.ZodOptional<z.ZodString>;
+  filename: z.ZodOptional<z.ZodString>;
+  sizeBytes: z.ZodOptional<z.ZodNumber>;
+  source: z.ZodOptional<z.ZodObject<{
+    entityType: z.ZodOptional<z.ZodString>;
+    entityId: z.ZodOptional<z.ZodString>;
+    attachmentType: z.ZodOptional<z.ZodString>;
+  }>>;
 }>;
 type CreateResultAttachment = z.infer<typeof createResultAttachmentSchema>;
 type CreateResult = {
-    success: true;
-    data: {
-        entityId?: string;
-        jobId?: string;
-        status: string;
-        attachment?: CreateResultAttachment;
-    };
+  success: true;
+  data: {
+    entityId?: string;
+    jobId?: string;
+    status: string;
+    attachment?: CreateResultAttachment;
+  };
 } | {
-    success: false;
-    error: string;
+  success: false;
+  error: string;
 };
 /**
  * Plugin create interceptors can either fully handle creation,
  * or continue with a rewritten normalized input.
  */
 type CreateInterceptionResult = {
-    kind: "handled";
-    result: CreateResult;
+  kind: "handled";
+  result: CreateResult;
 } | {
-    kind: "continue";
-    input: CreateInput;
+  kind: "continue";
+  input: CreateInput;
 };
 type CreateInterceptor = (input: CreateInput, executionContext: CreateExecutionContext) => Promise<CreateInterceptionResult>;
 interface UploadSaveInput {
-    upload: CreateFromUploadInput;
-    title?: string;
+  upload: CreateFromUploadInput;
+  title?: string;
 }
 type UploadSaveHandler = (input: UploadSaveInput, executionContext: CreateExecutionContext) => Promise<CreateResult>;
 interface UploadSaveHandlerRegistration {
-    entityType: string;
-    mediaTypes: string[];
-    handler: UploadSaveHandler;
+  entityType: string;
+  mediaTypes: string[];
+  handler: UploadSaveHandler;
 }
 /**
  * Interface for entity adapter - handles conversion between entities and markdown
@@ -329,177 +332,177 @@ interface UploadSaveHandlerRegistration {
  * @template TMetadata - The metadata type (defaults to Record<string, unknown>)
  */
 interface EntityAdapter<TEntity extends BaseEntity<TMetadata>, TMetadata = Record<string, unknown>> {
-    entityType: string;
-    /**
-     * One declarative sentence describing what this entity type is. This is the
-     * data the model reads to select `entityType`, replacing hardcoded example
-     * phrasings in system instructions. Required: every type must define itself.
-     */
-    purpose: string;
-    schema: EntitySchema$1<TEntity>;
-    toMarkdown(entity: TEntity): string;
-    fromMarkdown(markdown: string): Partial<TEntity>;
-    extractMetadata(entity: TEntity): TMetadata;
-    parseFrontMatter<TFrontmatter>(markdown: string, schema: {
-        parse(data: unknown): TFrontmatter;
-    }): TFrontmatter;
-    generateFrontMatter(entity: TEntity): string;
-    /** Optional: Zod schema for frontmatter fields. Used by CMS config generation. */
-    frontmatterSchema?: z.ZodObject<z.ZodRawShape>;
-    /** Optional: Declares this entity type is a singleton (one file, e.g., identity/identity.md). Used by CMS to generate files collection. */
-    isSingleton?: boolean;
-    /** Optional: Whether this entity has a free-form markdown body below frontmatter. Defaults to true. When false, CMS omits the body widget. */
-    hasBody?: boolean;
-    /** Returns a markdown body template with section headings for this entity type. Empty string for free-form entities. */
-    getBodyTemplate(): string;
-    /** Optional: Declares that this entity type supports cover images via coverImageId in frontmatter */
-    supportsCoverImage?: boolean;
-    /** Optional: Extract coverImageId from entity content/frontmatter */
-    getCoverImageId?(entity: TEntity): string | undefined;
-    /**
-     * Optional: build the markdown content and metadata for a queued-generation stub.
-     * When undefined, this entity type does not support prompt-based queued creation
-     * via system_create; the tool will reject the call rather than silently degrade.
-     * The returned metadata must satisfy this entity's metadata schema (with
-     * status set to "generating"); central code only stamps id/timestamps/visibility.
-     */
-    buildStub?(input: {
-        id: string;
-        title: string;
-    }): {
-        content: string;
-        metadata: TMetadata;
-    };
+  entityType: string;
+  /**
+   * One declarative sentence describing what this entity type is. This is the
+   * data the model reads to select `entityType`, replacing hardcoded example
+   * phrasings in system instructions. Required: every type must define itself.
+   */
+  purpose: string;
+  schema: EntitySchema$1<TEntity>;
+  toMarkdown(entity: TEntity): string;
+  fromMarkdown(markdown: string): Partial<TEntity>;
+  extractMetadata(entity: TEntity): TMetadata;
+  parseFrontMatter<TFrontmatter>(markdown: string, schema: {
+    parse(data: unknown): TFrontmatter;
+  }): TFrontmatter;
+  generateFrontMatter(entity: TEntity): string;
+  /** Optional: Zod schema for frontmatter fields. Used by CMS config generation. */
+  frontmatterSchema?: z.ZodObject<z.ZodRawShape>;
+  /** Optional: Declares this entity type is a singleton (one file, e.g., identity/identity.md). Used by CMS to generate files collection. */
+  isSingleton?: boolean;
+  /** Optional: Whether this entity has a free-form markdown body below frontmatter. Defaults to true. When false, CMS omits the body widget. */
+  hasBody?: boolean;
+  /** Returns a markdown body template with section headings for this entity type. Empty string for free-form entities. */
+  getBodyTemplate(): string;
+  /** Optional: Declares that this entity type supports cover images via coverImageId in frontmatter */
+  supportsCoverImage?: boolean;
+  /** Optional: Extract coverImageId from entity content/frontmatter */
+  getCoverImageId?(entity: TEntity): string | undefined;
+  /**
+   * Optional: build the markdown content and metadata for a queued-generation stub.
+   * When undefined, this entity type does not support prompt-based queued creation
+   * via system_create; the tool will reject the call rather than silently degrade.
+   * The returned metadata must satisfy this entity's metadata schema (with
+   * status set to "generating"); central code only stamps id/timestamps/visibility.
+   */
+  buildStub?(input: {
+    id: string;
+    title: string;
+  }): {
+    content: string;
+    metadata: TMetadata;
+  };
 }
 /**
  * Sort field specification for multi-field sorting
  */
 interface SortField {
-    /** Field to sort by - "created", "updated", or a metadata field name */
-    field: string;
-    /** Sort direction */
-    direction: "asc" | "desc";
-    /** Sort NULL values before non-NULL values (default: false / SQLite default) */
-    nullsFirst?: boolean;
+  /** Field to sort by - "created", "updated", or a metadata field name */
+  field: string;
+  /** Sort direction */
+  direction: "asc" | "desc";
+  /** Sort NULL values before non-NULL values (default: false / SQLite default) */
+  nullsFirst?: boolean;
 }
 /**
  * List entities options
  * Generic over metadata type for type-safe filtering
  */
 interface ListOptions<TMetadata = Record<string, unknown>> {
-    limit?: number;
-    offset?: number;
-    /** Multi-field sorting - supports system fields (created, updated) and metadata fields */
-    sortFields?: SortField[];
-    filter?: {
-        metadata?: Partial<TMetadata>;
-        visibilityScope?: ContentVisibility;
-    };
-    /** Filter to only entities with metadata.status = "published" */
-    publishedOnly?: boolean;
+  limit?: number;
+  offset?: number;
+  /** Multi-field sorting - supports system fields (created, updated) and metadata fields */
+  sortFields?: SortField[];
+  filter?: {
+    metadata?: Partial<TMetadata>;
+    visibilityScope?: ContentVisibility;
+  };
+  /** Filter to only entities with metadata.status = "published" */
+  publishedOnly?: boolean;
 }
 /**
  * Search options
  */
 interface SearchOptions {
-    limit?: number;
-    offset?: number;
-    types?: string[];
-    excludeTypes?: string[];
-    sortBy?: "relevance" | "created" | "updated";
-    sortDirection?: "asc" | "desc";
-    /** Score multipliers per entity type - applied after initial search */
-    weight?: Record<string, number>;
-    visibilityScope?: ContentVisibility;
-    /** Include queued/failed generation stubs in search results (default: false) */
-    includeUngenerated?: boolean;
-    /** Minimum relevance score to return. Omit for no score cutoff. */
-    minScore?: number;
+  limit?: number;
+  offset?: number;
+  types?: string[];
+  excludeTypes?: string[];
+  sortBy?: "relevance" | "created" | "updated";
+  sortDirection?: "asc" | "desc";
+  /** Score multipliers per entity type - applied after initial search */
+  weight?: Record<string, number>;
+  visibilityScope?: ContentVisibility;
+  /** Include queued/failed generation stubs in search results (default: false) */
+  includeUngenerated?: boolean;
+  /** Minimum relevance score to return. Omit for no score cutoff. */
+  minScore?: number;
 }
 /**
  * Configuration for entity type registration
  */
 interface EntityTypeConfig {
-    /** Score multiplier for search results (default: 1.0) */
-    weight?: number;
-    /** Whether to generate embeddings for this entity type (default: true).
-     *  Set to false for entity types with non-textual content (e.g., images). */
-    embeddable?: boolean;
-    /** Whether this entity type may be used as source material for derived projections (default: true).
-     *  Set to false for projection outputs that would create feedback loops. */
-    projectionSource?: boolean;
-    /** Publish semantics for status-bearing entity types. Statuses listed here
-     *  represent publication commitment/execution states and require the
-     *  `publish` entity action when entered or modified. */
-    publish?: {
-        publishStatuses: string[];
-    };
+  /** Score multiplier for search results (default: 1.0) */
+  weight?: number;
+  /** Whether to generate embeddings for this entity type (default: true).
+   *  Set to false for entity types with non-textual content (e.g., images). */
+  embeddable?: boolean;
+  /** Whether this entity type may be used as source material for derived projections (default: true).
+   *  Set to false for projection outputs that would create feedback loops. */
+  projectionSource?: boolean;
+  /** Publish semantics for status-bearing entity types. Statuses listed here
+   *  represent publication commitment/execution states and require the
+   *  `publish` entity action when entered or modified. */
+  publish?: {
+    publishStatuses: string[];
+  };
 }
 /**
  * Core entity service interface for read-only operations
  * Used by core plugins that need entity access but shouldn't modify entities
  */
 interface GetEntityRequest {
-    entityType: string;
-    id: string;
-    /**
-     * Optional visibility scope. Undefined fails closed to "public" — callers
-     * with elevated access must opt up explicitly.
-     */
-    visibilityScope?: ContentVisibility;
+  entityType: string;
+  id: string;
+  /**
+   * Optional visibility scope. Undefined fails closed to "public" — callers
+   * with elevated access must opt up explicitly.
+   */
+  visibilityScope?: ContentVisibility;
 }
 type GetEntityRawRequest = GetEntityRequest;
 interface ListEntitiesRequest {
-    entityType: string;
-    options?: ListOptions | undefined;
+  entityType: string;
+  options?: ListOptions | undefined;
 }
 interface CountEntitiesRequest {
-    entityType: string;
-    options?: Pick<ListOptions, "publishedOnly" | "filter"> | undefined;
+  entityType: string;
+  options?: Pick<ListOptions, "publishedOnly" | "filter"> | undefined;
 }
 interface CreateEntityRequest<T extends BaseEntity> {
-    entity: EntityInput<T>;
-    options?: CreateEntityOptions | undefined;
+  entity: EntityInput<T>;
+  options?: CreateEntityOptions | undefined;
 }
 interface CreateEntityFromMarkdownRequest {
-    input: CreateEntityFromMarkdownInput;
-    options?: CreateEntityOptions | undefined;
+  input: CreateEntityFromMarkdownInput;
+  options?: CreateEntityOptions | undefined;
 }
 interface UpdateEntityRequest<T extends BaseEntity> {
-    entity: T;
-    options?: EntityJobOptions | undefined;
+  entity: T;
+  options?: EntityJobOptions | undefined;
 }
 interface DeleteEntityRequest {
-    entityType: string;
-    id: string;
+  entityType: string;
+  id: string;
 }
 interface UpsertEntityRequest<T extends BaseEntity> {
-    entity: T;
-    options?: EntityJobOptions | undefined;
+  entity: T;
+  options?: EntityJobOptions | undefined;
 }
 interface EntitySearchRequest {
-    query: string;
-    options?: SearchOptions | undefined;
+  query: string;
+  options?: SearchOptions | undefined;
 }
 interface SearchWithDistancesRequest {
-    query: string;
+  query: string;
 }
 /**
  * Context passed to all DataSource operations
  * Contains internal state that should not be mixed with user query parameters
  */
 interface BaseDataSourceContext {
-    /**
-     * Whether to filter to only published/complete content
-     * Set by site-builder: true for production, false for preview
-     */
-    publishedOnly?: boolean;
-    /**
-     * Scoped entity service that auto-applies publishedOnly filter
-     * Datasources should use this instead of their injected entityService
-     * to ensure consistent filtering behavior across environments
-     */
-    entityService: EntityService;
+  /**
+   * Whether to filter to only published/complete content
+   * Set by site-builder: true for production, false for preview
+   */
+  publishedOnly?: boolean;
+  /**
+   * Scoped entity service that auto-applies publishedOnly filter
+   * Datasources should use this instead of their injected entityService
+   * to ensure consistent filtering behavior across environments
+   */
+  entityService: EntityService;
 }
 /**
  * DataSource Interface
@@ -509,227 +512,229 @@ interface BaseDataSourceContext {
  * via their dataSourceId property.
  */
 interface DataSource {
-    /**
-     * Unique identifier for this data source
-     */
-    id: string;
-    /**
-     * Human-readable name for this data source
-     */
-    name: string;
-    /**
-     * Optional description of what this data source provides
-     */
-    description?: string;
-    /**
-     * Optional: Fetch existing data
-     * Used by data sources that aggregate or retrieve data (e.g., dashboard stats, API data)
-     * DataSources validate output using the provided schema
-     * @param query - Query parameters for fetching data
-     * @param outputSchema - Schema for validating output data
-     * @param context - Context with environment
-     */
-    fetch?: <T>(query: unknown, outputSchema: z.ZodSchema<T>, context: BaseDataSourceContext) => Promise<T>;
-    /**
-     * Optional: Generate new content
-     * Used by data sources that create content (e.g., AI-generated content, reports)
-     */
-    generate?: <T>(request: unknown, schema: z.ZodSchema<T>) => Promise<T>;
-    /**
-     * Optional: Transform content between formats
-     * Used by data sources that convert content (e.g., markdown to HTML, data formatting)
-     */
-    transform?: <T>(content: unknown, format: string, schema: z.ZodSchema<T>) => Promise<T>;
+  /**
+   * Unique identifier for this data source
+   */
+  id: string;
+  /**
+   * Human-readable name for this data source
+   */
+  name: string;
+  /**
+   * Optional description of what this data source provides
+   */
+  description?: string;
+  /**
+   * Optional: Fetch existing data
+   * Used by data sources that aggregate or retrieve data (e.g., dashboard stats, API data)
+   * DataSources validate output using the provided schema
+   * @param query - Query parameters for fetching data
+   * @param outputSchema - Schema for validating output data
+   * @param context - Context with environment
+   */
+  fetch?: <T>(query: unknown, outputSchema: z.ZodSchema<T>, context: BaseDataSourceContext) => Promise<T>;
+  /**
+   * Optional: Generate new content
+   * Used by data sources that create content (e.g., AI-generated content, reports)
+   */
+  generate?: <T>(request: unknown, schema: z.ZodSchema<T>) => Promise<T>;
+  /**
+   * Optional: Transform content between formats
+   * Used by data sources that convert content (e.g., markdown to HTML, data formatting)
+   */
+  transform?: <T>(content: unknown, format: string, schema: z.ZodSchema<T>) => Promise<T>;
 }
 interface ICoreEntityService {
-    getEntity<T extends BaseEntity>(request: GetEntityRequest): Promise<T | null>;
-    /**
-     * Get entity without content resolution (raw)
-     * Used internally to avoid recursion when resolving image references
-     */
-    getEntityRaw<T extends BaseEntity>(request: GetEntityRawRequest): Promise<T | null>;
-    listEntities<T extends BaseEntity>(request: ListEntitiesRequest): Promise<T[]>;
-    search<T extends BaseEntity = BaseEntity>(request: EntitySearchRequest): Promise<SearchResult<T>[]>;
-    getEntityTypes(): string[];
-    hasEntityType(type: string): boolean;
-    countEntities(request: CountEntitiesRequest): Promise<number>;
-    /**
-     * Group counts by entity type. Fails closed: undefined visibilityScope
-     * filters to public-only counts so aggregate insights cannot reveal
-     * non-public entity existence.
-     */
-    getEntityCounts(visibilityScope?: ContentVisibility): Promise<Array<{
-        entityType: string;
-        count: number;
-    }>>;
-    /** Get configuration for a specific entity type */
-    getEntityTypeConfig(type: string): EntityTypeConfig;
-    /** Get weight map for all registered entity types with non-default weights */
-    getWeightMap(): Record<string, number>;
+  getEntity<T extends BaseEntity>(request: GetEntityRequest): Promise<T | null>;
+  /**
+   * Get entity without content resolution (raw)
+   * Used internally to avoid recursion when resolving image references
+   */
+  getEntityRaw<T extends BaseEntity>(request: GetEntityRawRequest): Promise<T | null>;
+  listEntities<T extends BaseEntity>(request: ListEntitiesRequest): Promise<T[]>;
+  search<T extends BaseEntity = BaseEntity>(request: EntitySearchRequest): Promise<SearchResult<T>[]>;
+  getEntityTypes(): string[];
+  hasEntityType(type: string): boolean;
+  countEntities(request: CountEntitiesRequest): Promise<number>;
+  /**
+   * Group counts by entity type. Fails closed: undefined visibilityScope
+   * filters to public-only counts so aggregate insights cannot reveal
+   * non-public entity existence.
+   */
+  getEntityCounts(visibilityScope?: ContentVisibility): Promise<Array<{
+    entityType: string;
+    count: number;
+  }>>;
+  /** Get configuration for a specific entity type */
+  getEntityTypeConfig(type: string): EntityTypeConfig;
+  /** Get weight map for all registered entity types with non-default weights */
+  getWeightMap(): Record<string, number>;
 }
 /**
  * Entity service interface for managing brain entities
  */
 interface IEntitiesNamespace {
-    /** Register a new entity type with schema and adapter */
-    register<TEntity extends BaseEntity>(entityType: string, schema: EntitySchema$1<TEntity>, adapter: EntityAdapter<TEntity>, config?: EntityTypeConfig): void;
-    /**
-     * Get the adapter for an entity type.
-     *
-     * Returns the structural `EntityAdapter<BaseEntity>` view — namespace
-     * consumers don't narrow by entity type. For typed access tied to a
-     * specific `TEntity`, use the underlying `EntityRegistry.getAdapter<T>`
-     * directly (see `entity-serializer.ts`).
-     */
-    getAdapter(entityType: string): EntityAdapter<BaseEntity> | undefined;
-    /** Extend an adapter's frontmatterSchema with additional fields */
-    extendFrontmatterSchema(type: string, extension: z.ZodObject<z.ZodRawShape>): void;
-    /** Get effective frontmatter schema (base + extensions) for an entity type */
-    getEffectiveFrontmatterSchema(type: string): z.ZodObject<z.ZodRawShape> | undefined;
-    /** Update an existing entity */
-    update<TEntity extends BaseEntity>(entity: TEntity): Promise<{
-        entityId: string;
-        jobId: string;
-    }>;
-    /** Register a data source for dynamic content */
-    registerDataSource(dataSource: DataSource): void;
-    /** Register a create interceptor for this plugin's entity type */
-    registerCreateInterceptor(entityType: string, interceptor: CreateInterceptor): void;
-    /** Register a raw-upload durable save handler for this plugin's entity type */
-    registerUploadSaveHandler(registration: UploadSaveHandlerRegistration): void;
-    /** Look up the registered upload-save handler claiming a media type */
-    getUploadSaveHandler(mediaType: string): UploadSaveHandlerRegistration | undefined;
+  /** Register a new entity type with schema and adapter */
+  register<TEntity extends BaseEntity>(entityType: string, schema: EntitySchema$1<TEntity>, adapter: EntityAdapter<TEntity>, config?: EntityTypeConfig): void;
+  /**
+   * Get the adapter for an entity type.
+   *
+   * Returns the structural `EntityAdapter<BaseEntity>` view — namespace
+   * consumers don't narrow by entity type. For typed access tied to a
+   * specific `TEntity`, use the underlying `EntityRegistry.getAdapter<T>`
+   * directly (see `entity-serializer.ts`).
+   */
+  getAdapter(entityType: string): EntityAdapter<BaseEntity> | undefined;
+  /** Extend an adapter's frontmatterSchema with additional fields */
+  extendFrontmatterSchema(type: string, extension: z.ZodObject<z.ZodRawShape>): void;
+  /** Get effective frontmatter schema (base + extensions) for an entity type */
+  getEffectiveFrontmatterSchema(type: string): z.ZodObject<z.ZodRawShape> | undefined;
+  /** Update an existing entity */
+  update<TEntity extends BaseEntity>(entity: TEntity): Promise<{
+    entityId: string;
+    jobId: string;
+  }>;
+  /** Register a data source for dynamic content */
+  registerDataSource(dataSource: DataSource): void;
+  /** Register a create interceptor for this plugin's entity type */
+  registerCreateInterceptor(entityType: string, interceptor: CreateInterceptor): void;
+  /** Register a raw-upload durable save handler for this plugin's entity type */
+  registerUploadSaveHandler(registration: UploadSaveHandlerRegistration): void;
+  /** Look up the registered upload-save handler claiming a media type */
+  getUploadSaveHandler(mediaType: string): UploadSaveHandlerRegistration | undefined;
 }
 interface EmbeddingBackfillResult {
-    queued: number;
-    skipped: number;
+  queued: number;
+  skipped: number;
 }
 interface EmbeddingIndexStats {
-    missingEmbeddings: number;
-    staleEmbeddings: number;
-    failedEmbeddings: number;
-    /** Entities whose type generates embeddings (non-embeddable types excluded). */
-    embeddableEntities: number;
-    /** Embeddable entities whose embedding is present and current. */
-    embeddedEntities: number;
+  missingEmbeddings: number;
+  staleEmbeddings: number;
+  failedEmbeddings: number;
+  /** Entities whose type generates embeddings (non-embeddable types excluded). */
+  embeddableEntities: number;
+  /** Embeddable entities whose embedding is present and current. */
+  embeddedEntities: number;
 }
 interface IndexReadinessOptions {
-    timeoutMs: number;
-    intervalMs?: number;
+  timeoutMs: number;
+  intervalMs?: number;
 }
 interface IndexReadinessStatus extends EmbeddingIndexStats {
-    ready: boolean;
-    degraded: boolean;
-    activeEmbeddingJobs: number;
+  ready: boolean;
+  degraded: boolean;
+  activeEmbeddingJobs: number;
 }
 interface EntityService extends ICoreEntityService {
-    createEntity<T extends BaseEntity>(request: CreateEntityRequest<T>): Promise<EntityMutationResult>;
-    createEntityFromMarkdown(request: CreateEntityFromMarkdownRequest): Promise<EntityMutationResult>;
-    updateEntity<T extends BaseEntity>(request: UpdateEntityRequest<T>): Promise<EntityMutationResult>;
-    deleteEntity(request: DeleteEntityRequest): Promise<boolean>;
-    upsertEntity<T extends BaseEntity>(request: UpsertEntityRequest<T>): Promise<EntityMutationResult & {
-        created: boolean;
-    }>;
-    storeEmbedding(data: StoreEmbeddingData): Promise<void>;
-    backfillMissingEmbeddings(): Promise<EmbeddingBackfillResult>;
-    isIndexReady(): boolean;
-    awaitIndexReady(options: IndexReadinessOptions): Promise<IndexReadinessStatus>;
-    serializeEntity(entity: BaseEntity): string;
-    deserializeEntity(markdown: string, entityType: string): Partial<BaseEntity>;
-    countEmbeddings(): Promise<number>;
-    searchWithDistances(request: SearchWithDistancesRequest): Promise<Array<{
-        entityId: string;
-        entityType: string;
-        distance: number;
-    }>>;
-    initialize(): Promise<void>;
-    getAsyncJobStatus(jobId: string): Promise<{
-        status: "pending" | "processing" | "completed" | "failed";
-        error?: string;
-    } | null>;
-}
-
+  createEntity<T extends BaseEntity>(request: CreateEntityRequest<T>): Promise<EntityMutationResult>;
+  createEntityFromMarkdown(request: CreateEntityFromMarkdownRequest): Promise<EntityMutationResult>;
+  updateEntity<T extends BaseEntity>(request: UpdateEntityRequest<T>): Promise<EntityMutationResult>;
+  deleteEntity(request: DeleteEntityRequest): Promise<boolean>;
+  upsertEntity<T extends BaseEntity>(request: UpsertEntityRequest<T>): Promise<EntityMutationResult & {
+    created: boolean;
+  }>;
+  storeEmbedding(data: StoreEmbeddingData): Promise<void>;
+  backfillMissingEmbeddings(): Promise<EmbeddingBackfillResult>;
+  isIndexReady(): boolean;
+  awaitIndexReady(options: IndexReadinessOptions): Promise<IndexReadinessStatus>;
+  serializeEntity(entity: BaseEntity): string;
+  deserializeEntity(markdown: string, entityType: string): Partial<BaseEntity>;
+  countEmbeddings(): Promise<number>;
+  searchWithDistances(request: SearchWithDistancesRequest): Promise<Array<{
+    entityId: string;
+    entityType: string;
+    distance: number;
+  }>>;
+  initialize(): Promise<void>;
+  getAsyncJobStatus(jobId: string): Promise<{
+    status: "pending" | "processing" | "completed" | "failed";
+    error?: string;
+  } | null>;
+}
+//#endregion
+//#region ../../shell/templates/src/permission-service.d.ts
 /**
  * User permission level schema
  */
 type UserPermissionLevel = "anchor" | "trusted" | "public";
 type EntityAction = "create" | "update" | "delete" | "extract" | "publish";
-
+//#endregion
+//#region ../../shell/templates/src/render-types.d.ts
 /**
  * Renderer output formats supported by view templates.
  */
 type OutputFormat = "web" | "image" | "pdf";
-
+//#endregion
+//#region ../../shell/plugins/src/contracts/agent.d.ts
 declare const ChatAttachmentSourceSchema: z.ZodObject<{
-    kind: z.ZodString;
-    id: z.ZodString;
+  kind: z.ZodString;
+  id: z.ZodString;
 }>;
 declare const TextChatAttachmentSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"text">;
-    filename: z.ZodString;
-    mediaType: z.ZodString;
-    content: z.ZodString;
-    sizeBytes: z.ZodOptional<z.ZodNumber>;
-    source: z.ZodOptional<typeof ChatAttachmentSourceSchema>;
+  kind: z.ZodLiteral<"text">;
+  filename: z.ZodString;
+  mediaType: z.ZodString;
+  content: z.ZodString;
+  sizeBytes: z.ZodOptional<z.ZodNumber>;
+  source: z.ZodOptional<typeof ChatAttachmentSourceSchema>;
 }>;
 declare const fileAttachmentDataSchema: z.ZodType<Uint8Array, unknown>;
 declare const FileChatAttachmentSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"file">;
-    filename: z.ZodString;
-    mediaType: z.ZodString;
-    data: typeof fileAttachmentDataSchema;
-    sizeBytes: z.ZodOptional<z.ZodNumber>;
-    source: z.ZodOptional<typeof ChatAttachmentSourceSchema>;
+  kind: z.ZodLiteral<"file">;
+  filename: z.ZodString;
+  mediaType: z.ZodString;
+  data: typeof fileAttachmentDataSchema;
+  sizeBytes: z.ZodOptional<z.ZodNumber>;
+  source: z.ZodOptional<typeof ChatAttachmentSourceSchema>;
 }>;
-declare const ChatAttachmentSchema: z.ZodDiscriminatedUnion<[
-    typeof TextChatAttachmentSchema,
-    typeof FileChatAttachmentSchema
-], "kind">;
+declare const ChatAttachmentSchema: z.ZodDiscriminatedUnion<[typeof TextChatAttachmentSchema, typeof FileChatAttachmentSchema], "kind">;
 type ChatAttachment = z.output<typeof ChatAttachmentSchema>;
 interface ChatContext {
-    userPermissionLevel?: "anchor" | "trusted" | "public" | undefined;
-    interfaceType?: string | undefined;
+  userPermissionLevel?: "anchor" | "trusted" | "public" | undefined;
+  interfaceType?: string | undefined;
+  channelId?: string | undefined;
+  channelName?: string | undefined;
+  actor?: {
+    actorId: string;
+    canonicalId?: string | undefined;
+    interfaceType: string;
+    role: "user" | "assistant";
+    displayName?: string | undefined;
+    username?: string | undefined;
+    isBot?: boolean | undefined;
+  } | undefined;
+  source?: {
+    messageId?: string | undefined;
     channelId?: string | undefined;
     channelName?: string | undefined;
-    actor?: {
-        actorId: string;
-        canonicalId?: string | undefined;
-        interfaceType: string;
-        role: "user" | "assistant";
-        displayName?: string | undefined;
-        username?: string | undefined;
-        isBot?: boolean | undefined;
-    } | undefined;
-    source?: {
-        messageId?: string | undefined;
-        channelId?: string | undefined;
-        channelName?: string | undefined;
-        threadId?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
-    } | undefined;
-    attachments?: ChatAttachment[] | undefined;
+    threadId?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+  } | undefined;
+  attachments?: ChatAttachment[] | undefined;
 }
 declare const ChatContextSchema: z.ZodType<ChatContext, unknown>;
 interface AgentNamespace {
-    chat(message: string, conversationId: string, context?: ChatContext): Promise<AgentResponse>;
-    confirmPendingAction(conversationId: string, confirmed: boolean, approvalId: string, context: ChatContext): Promise<AgentResponse>;
-    invalidate(): void;
+  chat(message: string, conversationId: string, context?: ChatContext): Promise<AgentResponse>;
+  confirmPendingAction(conversationId: string, confirmed: boolean, approvalId: string, context: ChatContext): Promise<AgentResponse>;
+  invalidate(): void;
 }
-
+//#endregion
+//#region ../../shell/plugins/src/types/web-routes.d.ts
 declare const WebRouteMethods: readonly ["GET", "POST", "PUT", "DELETE", "OPTIONS"];
 type WebRouteMethod = (typeof WebRouteMethods)[number];
 type WebRouteHandler = (request: Request) => Response | Promise<Response>;
 interface WebRouteDefinition {
-    /** Absolute mounted path (e.g. "/cms" or "/cms-config") */
-    path: string;
-    /** HTTP method */
-    method?: WebRouteMethod;
-    /** Allow unauthenticated access */
-    public?: boolean;
-    /** Request handler */
-    handler: WebRouteHandler;
-}
-
+  /** Absolute mounted path (e.g. "/cms" or "/cms-config") */
+  path: string;
+  /** HTTP method */
+  method?: WebRouteMethod;
+  /** Allow unauthenticated access */
+  public?: boolean;
+  /** Request handler */
+  handler: WebRouteHandler;
+}
+//#endregion
+//#region ../../shell/plugins/src/interfaces.d.ts
 /**
  * Endpoint info — plugins advertise their user-facing URLs via
  * `context.endpoints.register({...})`. Shell collects and exposes
@@ -737,88 +742,90 @@ interface WebRouteDefinition {
  * can render them without knowing about individual plugins.
  */
 declare const userPermissionLevelSchema: z.ZodEnum<{
-    anchor: "anchor";
-    trusted: "trusted";
-    public: "public";
+  anchor: "anchor";
+  trusted: "trusted";
+  public: "public";
 }>;
 declare const endpointInfoSchema: z.ZodObject<{
-    label: z.ZodString;
-    url: z.ZodString;
-    pluginId: z.ZodString;
-    priority: z.ZodDefault<z.ZodNumber>;
-    visibility: z.ZodDefault<typeof userPermissionLevelSchema>;
+  label: z.ZodString;
+  url: z.ZodString;
+  pluginId: z.ZodString;
+  priority: z.ZodDefault<z.ZodNumber>;
+  visibility: z.ZodDefault<typeof userPermissionLevelSchema>;
 }>;
 declare const interactionKindSchema: z.ZodEnum<{
-    human: "human";
-    agent: "agent";
-    admin: "admin";
-    protocol: "protocol";
+  human: "human";
+  agent: "agent";
+  admin: "admin";
+  protocol: "protocol";
 }>;
 declare const interactionStatusSchema: z.ZodEnum<{
-    available: "available";
-    "coming-soon": "coming-soon";
-    disabled: "disabled";
+  available: "available";
+  "coming-soon": "coming-soon";
+  disabled: "disabled";
 }>;
 declare const interactionInfoSchema: z.ZodObject<{
-    id: z.ZodString;
-    label: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    href: z.ZodString;
-    kind: typeof interactionKindSchema;
-    pluginId: z.ZodString;
-    priority: z.ZodDefault<z.ZodNumber>;
-    visibility: z.ZodDefault<typeof userPermissionLevelSchema>;
-    status: z.ZodDefault<typeof interactionStatusSchema>;
+  id: z.ZodString;
+  label: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  href: z.ZodString;
+  kind: typeof interactionKindSchema;
+  pluginId: z.ZodString;
+  priority: z.ZodDefault<z.ZodNumber>;
+  visibility: z.ZodDefault<typeof userPermissionLevelSchema>;
+  status: z.ZodDefault<typeof interactionStatusSchema>;
 }>;
 declare const entityCountSchema: z.ZodObject<{
-    entityType: z.ZodString;
-    count: z.ZodNumber;
+  entityType: z.ZodString;
+  count: z.ZodNumber;
 }>;
 /**
  * Content generation configuration - unified config object
  */
 interface ContentGenerationConfig {
-    prompt: string;
-    templateName: string;
-    conversationHistory?: string;
-    data?: Record<string, unknown>;
-    interfacePermissionGrant?: UserPermissionLevel;
-}
-
+  prompt: string;
+  templateName: string;
+  conversationHistory?: string;
+  data?: Record<string, unknown>;
+  interfacePermissionGrant?: UserPermissionLevel;
+}
+//#endregion
+//#region ../../shell/plugins/src/contracts/app-info.d.ts
 declare const DaemonHealthSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        healthy: "healthy";
-        warning: "warning";
-        error: "error";
-        unknown: "unknown";
-    }>;
-    message: z.ZodOptional<z.ZodString>;
-    lastCheck: z.ZodOptional<z.ZodString>;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  status: z.ZodEnum<{
+    healthy: "healthy";
+    warning: "warning";
+    error: "error";
+    unknown: "unknown";
+  }>;
+  message: z.ZodOptional<z.ZodString>;
+  lastCheck: z.ZodOptional<z.ZodString>;
+  details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }>;
 declare const DaemonStatusSchema: z.ZodObject<{
-    name: z.ZodString;
-    pluginId: z.ZodString;
-    status: z.ZodString;
-    health: z.ZodOptional<typeof DaemonHealthSchema>;
+  name: z.ZodString;
+  pluginId: z.ZodString;
+  status: z.ZodString;
+  health: z.ZodOptional<typeof DaemonHealthSchema>;
 }>;
 declare const AppInfoSchema: z.ZodObject<{
+  model: z.ZodString;
+  version: z.ZodString;
+  uptime: z.ZodNumber;
+  entities: z.ZodNumber;
+  entityCounts: z.ZodArray<typeof entityCountSchema>;
+  embeddings: z.ZodNumber;
+  ai: z.ZodObject<{
     model: z.ZodString;
-    version: z.ZodString;
-    uptime: z.ZodNumber;
-    entities: z.ZodNumber;
-    entityCounts: z.ZodArray<typeof entityCountSchema>;
-    embeddings: z.ZodNumber;
-    ai: z.ZodObject<{
-        model: z.ZodString;
-        embeddingModel: z.ZodString;
-    }>;
-    daemons: z.ZodArray<typeof DaemonStatusSchema>;
-    endpoints: z.ZodArray<typeof endpointInfoSchema>;
-    interactions: z.ZodArray<typeof interactionInfoSchema>;
+    embeddingModel: z.ZodString;
+  }>;
+  daemons: z.ZodArray<typeof DaemonStatusSchema>;
+  endpoints: z.ZodArray<typeof endpointInfoSchema>;
+  interactions: z.ZodArray<typeof interactionInfoSchema>;
 }>;
 type AppInfo = z.output<typeof AppInfoSchema>;
-
+//#endregion
+//#region ../../shell/plugins/src/contracts/metadata.d.ts
 /**
  * Best-effort extension metadata carried across public DTO boundaries.
  *
@@ -828,567 +835,573 @@ type AppInfo = z.output<typeof AppInfoSchema>;
  */
 declare const ExtensionMetadataSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 type ExtensionMetadata = z.output<typeof ExtensionMetadataSchema>;
-
+//#endregion
+//#region ../../shell/plugins/src/contracts/conversations.d.ts
 declare const ConversationSchema: z.ZodObject<{
-    id: z.ZodString;
-    sessionId: z.ZodString;
-    interfaceType: z.ZodString;
-    channelId: z.ZodString;
-    channelName: z.ZodOptional<z.ZodString>;
-    startedAt: z.ZodString;
-    lastActiveAt: z.ZodString;
-    createdAt: z.ZodString;
-    updatedAt: z.ZodString;
-    metadata: typeof ExtensionMetadataSchema;
+  id: z.ZodString;
+  sessionId: z.ZodString;
+  interfaceType: z.ZodString;
+  channelId: z.ZodString;
+  channelName: z.ZodOptional<z.ZodString>;
+  startedAt: z.ZodString;
+  lastActiveAt: z.ZodString;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+  metadata: typeof ExtensionMetadataSchema;
 }>;
 type Conversation = z.output<typeof ConversationSchema>;
 declare const MessageSchema: z.ZodObject<{
-    id: z.ZodString;
-    conversationId: z.ZodString;
-    role: typeof messageRoleSchema;
-    content: z.ZodString;
-    timestamp: z.ZodString;
-    metadata: typeof ExtensionMetadataSchema;
+  id: z.ZodString;
+  conversationId: z.ZodString;
+  role: typeof messageRoleSchema;
+  content: z.ZodString;
+  timestamp: z.ZodString;
+  metadata: typeof ExtensionMetadataSchema;
 }>;
 type Message = z.output<typeof MessageSchema>;
-
+//#endregion
+//#region ../../shell/plugins/src/contracts/identity.d.ts
 declare const BrainCharacterSchema: z.ZodObject<{
-    name: z.ZodString;
-    role: z.ZodString;
-    purpose: z.ZodString;
-    values: z.ZodArray<z.ZodString>;
+  name: z.ZodString;
+  role: z.ZodString;
+  purpose: z.ZodString;
+  values: z.ZodArray<z.ZodString>;
 }>;
 type BrainCharacter = z.output<typeof BrainCharacterSchema>;
 declare const AnchorProfileSchema: z.ZodObject<{
-    name: z.ZodString;
-    kind: z.ZodEnum<{
-        professional: "professional";
-        team: "team";
-        collective: "collective";
+  name: z.ZodString;
+  kind: z.ZodEnum<{
+    professional: "professional";
+    team: "team";
+    collective: "collective";
+  }>;
+  organization: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  avatar: z.ZodOptional<z.ZodString>;
+  website: z.ZodOptional<z.ZodString>;
+  email: z.ZodOptional<z.ZodString>;
+  socialLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    platform: z.ZodEnum<{
+      github: "github";
+      instagram: "instagram";
+      linkedin: "linkedin";
+      email: "email";
+      website: "website";
     }>;
-    organization: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    avatar: z.ZodOptional<z.ZodString>;
-    website: z.ZodOptional<z.ZodString>;
-    email: z.ZodOptional<z.ZodString>;
-    socialLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        platform: z.ZodEnum<{
-            github: "github";
-            instagram: "instagram";
-            linkedin: "linkedin";
-            email: "email";
-            website: "website";
-        }>;
-        url: z.ZodString;
-        label: z.ZodOptional<z.ZodString>;
-    }>>>;
+    url: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+  }>>>;
 }>;
 type AnchorProfile = z.output<typeof AnchorProfileSchema>;
-
-declare const MessageResponseSchema: z.ZodUnion<[
-    z.ZodObject<{
-        success: z.ZodBoolean;
-        data: z.ZodOptional<z.ZodUnknown>;
-        error: z.ZodOptional<z.ZodString>;
-    }>,
-    z.ZodObject<{
-        noop: z.ZodLiteral<true>;
-    }>
-]>;
+//#endregion
+//#region ../../shell/plugins/src/contracts/messaging.d.ts
+declare const MessageResponseSchema: z.ZodUnion<[z.ZodObject<{
+  success: z.ZodBoolean;
+  data: z.ZodOptional<z.ZodUnknown>;
+  error: z.ZodOptional<z.ZodString>;
+}>, z.ZodObject<{
+  noop: z.ZodLiteral<true>;
+}>]>;
 type MessageResponse<T = unknown> = ({
-    success: boolean;
-    error?: string | undefined;
+  success: boolean;
+  error?: string | undefined;
 } & {
-    data?: T | undefined;
+  data?: T | undefined;
 }) | {
-    noop: true;
+  noop: true;
 };
 declare const BaseMessageSchema: z.ZodObject<{
-    id: z.ZodString;
-    timestamp: z.ZodString;
-    type: z.ZodString;
-    source: z.ZodString;
-    target: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<typeof ExtensionMetadataSchema>;
+  id: z.ZodString;
+  timestamp: z.ZodString;
+  type: z.ZodString;
+  source: z.ZodString;
+  target: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<typeof ExtensionMetadataSchema>;
 }>;
 type BaseMessage = z.output<typeof BaseMessageSchema>;
 type MessageWithPayload<T = unknown> = BaseMessage & {
-    payload: T;
+  payload: T;
 };
 interface MessageSendOptions {
-    target?: string;
-    metadata?: z.output<typeof ExtensionMetadataSchema>;
-    broadcast?: boolean;
+  target?: string;
+  metadata?: z.output<typeof ExtensionMetadataSchema>;
+  broadcast?: boolean;
 }
 interface MessageSendRequest<T = unknown> extends MessageSendOptions {
-    type: string;
-    payload: T;
+  type: string;
+  payload: T;
 }
 type MessageSender<T = unknown, R = unknown> = (request: MessageSendRequest<T>) => Promise<MessageResponse<R>>;
 interface MessageContext {
-    userId?: string;
-    channelId?: string;
-    messageId?: string;
-    timestamp?: string;
-    interfaceType?: string;
-    userPermissionLevel?: UserPermissionLevel;
-    threadId?: string;
-}
-
+  userId?: string;
+  channelId?: string;
+  messageId?: string;
+  timestamp?: string;
+  interfaceType?: string;
+  userPermissionLevel?: UserPermissionLevel;
+  threadId?: string;
+}
+//#endregion
+//#region ../../shell/plugins/src/entity/context.d.ts
 type AIGenerationSchema<T> = ZodType<T>;
 type AspectRatio = "1:1" | "16:9" | "9:16" | "4:3" | "3:4";
 interface ImageGenerationOptions {
-    aspectRatio?: AspectRatio;
+  aspectRatio?: AspectRatio;
 }
 interface ImageGenerationResult {
-    base64: string;
-    dataUrl: string;
+  base64: string;
+  dataUrl: string;
 }
 /**
  * AI namespace for entity plugins — includes generation capabilities
  */
 interface IEntityAINamespace {
-    /** Query the AI with optional context */
-    query: (prompt: string, context?: Record<string, unknown>) => Promise<DefaultQueryResponse>;
-    /** Generate content using AI with template */
-    generate: <T = unknown>(config: ContentGenerationConfig) => Promise<T>;
-    /** Generate a structured object using AI with a schema parser */
-    generateObject: <T>(prompt: string, schema: AIGenerationSchema<T>) => Promise<{
-        object: T;
-    }>;
-    /** Generate an image using AI (requires AI_API_KEY) */
-    generateImage: (prompt: string, options?: ImageGenerationOptions) => Promise<ImageGenerationResult>;
-    /** Check if image generation is available */
-    canGenerateImages: () => boolean;
-}
-
+  /** Query the AI with optional context */
+  query: (prompt: string, context?: Record<string, unknown>) => Promise<DefaultQueryResponse>;
+  /** Generate content using AI with template */
+  generate: <T = unknown>(config: ContentGenerationConfig) => Promise<T>;
+  /** Generate a structured object using AI with a schema parser */
+  generateObject: <T>(prompt: string, schema: AIGenerationSchema<T>) => Promise<{
+    object: T;
+  }>;
+  /** Generate an image using AI (requires AI_API_KEY) */
+  generateImage: (prompt: string, options?: ImageGenerationOptions) => Promise<ImageGenerationResult>;
+  /** Check if image generation is available */
+  canGenerateImages: () => boolean;
+}
+//#endregion
+//#region ../../shell/plugins/src/public/types.d.ts
 type PluginConfig = Record<string, unknown>;
 type PluginConfigInput<T extends {
-    _input: unknown;
+  _input: unknown;
 }> = T["_input"];
 interface SafeParserSchema<T> {
-    safeParse(input: unknown): {
-        success: true;
-        data: T;
-    } | {
-        success: false;
-        error: {
-            message: string;
-        };
+  safeParse(input: unknown): {
+    success: true;
+    data: T;
+  } | {
+    success: false;
+    error: {
+      message: string;
     };
+  };
 }
 interface JudgeInput<T> {
-    instruction: string;
-    material: string;
-    schema: z.ZodType<T, unknown>;
+  instruction: string;
+  material: string;
+  schema: z.ZodType<T, unknown>;
 }
 interface Plugin {
-    readonly id: string;
-    readonly version: string;
-    readonly type: "core" | "entity" | "service" | "interface";
-    readonly packageName: string;
-    readonly description?: string;
-    readonly dependencies?: string[];
-    ready?(): Promise<void>;
-    shutdown?(): Promise<void>;
-    requiresDaemonStartup?(): boolean;
+  readonly id: string;
+  readonly version: string;
+  readonly type: "core" | "entity" | "service" | "interface";
+  readonly packageName: string;
+  readonly description?: string;
+  readonly dependencies?: string[];
+  ready?(): Promise<void>;
+  shutdown?(): Promise<void>;
+  requiresDaemonStartup?(): boolean;
 }
 type PluginFactory = (config: PluginConfig) => Plugin | Plugin[];
 interface Logger {
-    debug(message: string, data?: unknown): void;
-    info(message: string, data?: unknown): void;
-    warn(message: string, data?: unknown): void;
-    error(message: string, data?: unknown): void;
-    child(context: string): Logger;
+  debug(message: string, data?: unknown): void;
+  info(message: string, data?: unknown): void;
+  warn(message: string, data?: unknown): void;
+  error(message: string, data?: unknown): void;
+  child(context: string): Logger;
 }
 interface ToolContext {
-    progressToken?: string | number;
-    sendProgress?: (notification: {
-        progress?: number;
-        total?: number;
-        message?: string;
-    }) => Promise<void>;
-    interfaceType?: string;
-    userId?: string;
-    conversationId?: string;
-    channelId?: string;
-    channelName?: string;
-    runId?: string;
-    toolCallId?: string;
-    userPermissionLevel?: UserPermissionLevel;
+  progressToken?: string | number;
+  sendProgress?: (notification: {
+    progress?: number;
+    total?: number;
+    message?: string;
+  }) => Promise<void>;
+  interfaceType?: string;
+  userId?: string;
+  conversationId?: string;
+  channelId?: string;
+  channelName?: string;
+  runId?: string;
+  toolCallId?: string;
+  userPermissionLevel?: UserPermissionLevel;
 }
 interface ToolResponse<T = unknown> {
-    success: boolean;
-    data?: T;
-    error?: string;
+  success: boolean;
+  data?: T;
+  error?: string;
 }
 type ToolVisibility = UserPermissionLevel;
 interface ToolConfirmation {
-    required: boolean;
-    message?: string;
+  required: boolean;
+  message?: string;
 }
 type ToolSideEffects = "none" | "writes" | "external";
 interface Tool<TArgs = unknown, TResult = unknown> {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-    handler: (args: TArgs, context: ToolContext) => Promise<TResult> | TResult;
-    visibility?: ToolVisibility;
-    confirmation?: ToolConfirmation;
-    sideEffects?: ToolSideEffects;
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+  handler: (args: TArgs, context: ToolContext) => Promise<TResult> | TResult;
+  visibility?: ToolVisibility;
+  confirmation?: ToolConfirmation;
+  sideEffects?: ToolSideEffects;
 }
 interface Resource<TResult = unknown> {
-    uri: string;
-    name: string;
-    description?: string;
-    mimeType?: string;
-    handler: () => Promise<TResult> | TResult;
+  uri: string;
+  name: string;
+  description?: string;
+  mimeType?: string;
+  handler: () => Promise<TResult> | TResult;
 }
 interface ResourceTemplate<K extends string = string> {
-    uriTemplate: K;
-    name: string;
-    description?: string;
-    mimeType?: string;
+  uriTemplate: K;
+  name: string;
+  description?: string;
+  mimeType?: string;
 }
 interface Prompt {
+  name: string;
+  description?: string;
+  arguments?: Array<{
     name: string;
     description?: string;
-    arguments?: Array<{
-        name: string;
-        description?: string;
-        required?: boolean;
-    }>;
+    required?: boolean;
+  }>;
 }
 declare function createTool<TArgs = unknown, TResult = unknown>(tool: Tool<TArgs, TResult>): Tool<TArgs, TResult>;
 declare function createResource<TResult = unknown>(resource: Resource<TResult>): Resource<TResult>;
 declare function toolSuccess<T = unknown>(data?: T): ToolResponse<T>;
 declare function toolError(error: string): ToolResponse<never>;
 interface BaseJobTrackingInfo {
-    rootJobId: string;
+  rootJobId: string;
 }
 interface MessageJobTrackingInfo extends BaseJobTrackingInfo {
-    messageId?: string;
-    channelId?: string;
+  messageId?: string;
+  channelId?: string;
 }
 type JobProgressStatus = "pending" | "processing" | "completed" | "failed";
 interface JobProgressContext {
-    rootJobId: string;
-    operationType: "file_operations" | "content_operations" | "data_processing" | "batch_processing";
-    pluginId?: string | undefined;
-    progressToken?: string | number | undefined;
-    operationTarget?: string | undefined;
-    interfaceType?: string | undefined;
-    conversationId?: string | undefined;
-    channelId?: string | undefined;
+  rootJobId: string;
+  operationType: "file_operations" | "content_operations" | "data_processing" | "batch_processing";
+  pluginId?: string | undefined;
+  progressToken?: string | number | undefined;
+  operationTarget?: string | undefined;
+  interfaceType?: string | undefined;
+  conversationId?: string | undefined;
+  channelId?: string | undefined;
 }
 interface JobProgressEvent {
-    id: string;
-    type: "job" | "batch";
-    status: JobProgressStatus;
-    message?: string | undefined;
-    progress?: {
-        current: number;
-        total: number;
-        percentage: number;
-    } | undefined;
-    aggregationKey?: string | undefined;
-    batchDetails?: {
-        totalOperations: number;
-        completedOperations: number;
-        failedOperations: number;
-        currentOperation?: string | undefined;
-        errors?: string[] | undefined;
-    } | undefined;
-    jobDetails?: {
-        jobType: string;
-        priority: number;
-        retryCount: number;
-    } | undefined;
-    metadata: JobProgressContext;
+  id: string;
+  type: "job" | "batch";
+  status: JobProgressStatus;
+  message?: string | undefined;
+  progress?: {
+    current: number;
+    total: number;
+    percentage: number;
+  } | undefined;
+  aggregationKey?: string | undefined;
+  batchDetails?: {
+    totalOperations: number;
+    completedOperations: number;
+    failedOperations: number;
+    currentOperation?: string | undefined;
+    errors?: string[] | undefined;
+  } | undefined;
+  jobDetails?: {
+    jobType: string;
+    priority: number;
+    retryCount: number;
+  } | undefined;
+  metadata: JobProgressContext;
 }
 declare const urlCaptureConfigSchema: z.ZodObject<{
-    captureUrls: z.ZodDefault<z.ZodBoolean>;
-    blockedUrlDomains: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  captureUrls: z.ZodDefault<z.ZodBoolean>;
+  blockedUrlDomains: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }>;
 interface Channel<TPayload, TResponse = unknown> {
-    readonly name: string;
-    readonly schema: SafeParserSchema<TPayload>;
-    readonly _response?: TResponse;
+  readonly name: string;
+  readonly schema: SafeParserSchema<TPayload>;
+  readonly _response?: TResponse;
 }
 declare function defineChannel<TPayload, TResponse = unknown>(name: string, schema: SafeParserSchema<TPayload>): Channel<TPayload, TResponse>;
 type PublicEntityServiceMethods = "getEntity" | "listEntities" | "search" | "getEntityTypes" | "hasEntityType" | "countEntities" | "getEntityCounts" | "getEntityTypeConfig";
 type IEntityService = Pick<ICoreEntityService, PublicEntityServiceMethods>;
-
 interface IIdentityNamespace {
-    get: () => BrainCharacter;
-    getProfile: () => AnchorProfile;
-    getAppInfo: () => Promise<AppInfo>;
+  get: () => BrainCharacter;
+  getProfile: () => AnchorProfile;
+  getAppInfo: () => Promise<AppInfo>;
 }
 interface IConversationsNamespace {
-    get(conversationId: string): Promise<Conversation | null>;
-    search(query: string): Promise<Conversation[]>;
-    list(options?: {
-        limit?: number;
-        updatedAfter?: string;
-        interfaceType?: string;
-        sessionId?: string;
-        channelId?: string;
-    }): Promise<Conversation[]>;
-    getMessages(conversationId: string, options?: {
-        limit?: number;
-        range?: {
-            start: number;
-            end: number;
-        };
-    }): Promise<Message[]>;
+  get(conversationId: string): Promise<Conversation | null>;
+  search(query: string): Promise<Conversation[]>;
+  list(options?: {
+    limit?: number;
+    updatedAfter?: string;
+    interfaceType?: string;
+    sessionId?: string;
+    channelId?: string;
+  }): Promise<Conversation[]>;
+  getMessages(conversationId: string, options?: {
+    limit?: number;
+    range?: {
+      start: number;
+      end: number;
+    };
+  }): Promise<Message[]>;
 }
 interface IMessagingNamespace {
-    send: MessageSender;
-    subscribe<T = unknown, R = unknown>(channel: string | Channel<T, R>, handler: (message: MessageWithPayload<T>) => Promise<MessageResponse<R>>): () => void;
+  send: MessageSender;
+  subscribe<T = unknown, R = unknown>(channel: string | Channel<T, R>, handler: (message: MessageWithPayload<T>) => Promise<MessageResponse<R>>): () => void;
 }
 type EvalHandler<TInput = unknown, TOutput = unknown> = (input: TInput) => Promise<TOutput>;
 type InsightHandler = (entityService: IEntityService, visibilityScope: ContentVisibility) => Promise<Record<string, unknown>>;
 interface IEvalNamespace {
-    registerHandler(handlerId: string, handler: EvalHandler): void;
+  registerHandler(handlerId: string, handler: EvalHandler): void;
 }
 interface IInsightsNamespace {
-    register(type: string, handler: InsightHandler): void;
+  register(type: string, handler: InsightHandler): void;
 }
 interface IPermissionsNamespace {
-    assertEntityActionAllowed(entityType: string, action: EntityAction, context: {
-        userPermissionLevel?: UserPermissionLevel | undefined;
-    }): void;
+  assertEntityActionAllowed(entityType: string, action: EntityAction, context: {
+    userPermissionLevel?: UserPermissionLevel | undefined;
+  }): void;
 }
 interface RuntimeUploadRecord {
+  id: string;
+  ref: {
+    kind: string;
     id: string;
-    ref: {
-        kind: string;
-        id: string;
-    };
-    filename: string;
-    mediaType: string;
-    sizeBytes: number;
-    createdAt: string;
-    metadata?: Record<string, unknown> | undefined;
+  };
+  filename: string;
+  mediaType: string;
+  sizeBytes: number;
+  createdAt: string;
+  metadata?: Record<string, unknown> | undefined;
 }
 interface RuntimeUploadResponseBody extends RuntimeUploadRecord {
-    url: string;
-    downloadUrl: string;
+  url: string;
+  downloadUrl: string;
 }
 interface ResolvedRuntimeUpload {
-    record: RuntimeUploadRecord;
-    content: Buffer;
+  record: RuntimeUploadRecord;
+  content: Buffer;
 }
 interface SaveRuntimeUploadInput {
-    filename: string;
-    mediaType: string;
-    content: Buffer;
-    metadata?: Record<string, unknown> | undefined;
+  filename: string;
+  mediaType: string;
+  content: Buffer;
+  metadata?: Record<string, unknown> | undefined;
 }
 interface RuntimeUploadScopeOptions {
-    namespace: string;
-    refKind: string;
-    routePath: string;
-    retentionMs?: number | undefined;
-    maxCount?: number | undefined;
+  namespace: string;
+  refKind: string;
+  routePath: string;
+  retentionMs?: number | undefined;
+  maxCount?: number | undefined;
 }
 interface RuntimeUploadStore {
-    save(input: SaveRuntimeUploadInput): Promise<RuntimeUploadRecord>;
-    read(uploadId: string): Promise<ResolvedRuntimeUpload>;
-    readRecord(uploadId: string): Promise<RuntimeUploadRecord>;
-    toResponseBody(record: RuntimeUploadRecord): RuntimeUploadResponseBody;
-    prune(): Promise<void>;
-    getUploadDir(uploadId: string): string;
+  save(input: SaveRuntimeUploadInput): Promise<RuntimeUploadRecord>;
+  read(uploadId: string): Promise<ResolvedRuntimeUpload>;
+  readRecord(uploadId: string): Promise<RuntimeUploadRecord>;
+  toResponseBody(record: RuntimeUploadRecord): RuntimeUploadResponseBody;
+  prune(): Promise<void>;
+  getUploadDir(uploadId: string): string;
 }
 interface IRuntimeUploadsNamespace {
-    scoped(options: RuntimeUploadScopeOptions): RuntimeUploadStore;
+  scoped(options: RuntimeUploadScopeOptions): RuntimeUploadStore;
 }
 interface BasePluginContext {
-    readonly pluginId: string;
-    readonly logger: Logger;
-    readonly dataDir: string;
-    readonly domain: string | undefined;
-    readonly siteUrl: string | undefined;
-    readonly localSiteUrl: string | undefined;
-    readonly previewUrl: string | undefined;
-    readonly preferLocalUrls: boolean;
-    readonly appInfo: () => Promise<AppInfo>;
-    readonly judge: <T>(input: JudgeInput<T>) => Promise<{
-        verdict: T;
-        usage: {
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
-        };
-    }>;
-    readonly entityService: IEntityService;
-    readonly identity: IIdentityNamespace;
-    readonly messaging: IMessagingNamespace;
-    readonly conversations: IConversationsNamespace;
-    readonly eval: IEvalNamespace;
-    readonly insights: IInsightsNamespace;
-    readonly permissions: IPermissionsNamespace;
-    readonly uploads: IRuntimeUploadsNamespace;
+  readonly pluginId: string;
+  readonly logger: Logger;
+  readonly dataDir: string;
+  readonly domain: string | undefined;
+  readonly siteUrl: string | undefined;
+  readonly localSiteUrl: string | undefined;
+  readonly previewUrl: string | undefined;
+  readonly preferLocalUrls: boolean;
+  readonly appInfo: () => Promise<AppInfo>;
+  readonly judge: <T>(input: JudgeInput<T>) => Promise<{
+    verdict: T;
+    usage: {
+      promptTokens: number;
+      completionTokens: number;
+      totalTokens: number;
+    };
+  }>;
+  readonly entityService: IEntityService;
+  readonly identity: IIdentityNamespace;
+  readonly messaging: IMessagingNamespace;
+  readonly conversations: IConversationsNamespace;
+  readonly eval: IEvalNamespace;
+  readonly insights: IInsightsNamespace;
+  readonly permissions: IPermissionsNamespace;
+  readonly uploads: IRuntimeUploadsNamespace;
 }
 interface IPromptsNamespace {
-    resolve(target: string, fallback: string): Promise<string>;
+  resolve(target: string, fallback: string): Promise<string>;
 }
 interface IServiceTemplatesNamespace {
-    register(templates: unknown): void;
+  register(templates: unknown): void;
 }
 interface IViewsNamespace {
-    get(name: string): unknown | undefined;
-    list(): unknown[];
-    hasRenderer(templateName: string, format?: OutputFormat): boolean;
-    getRenderer(templateName: string, format?: OutputFormat): unknown | undefined;
-    validate(templateName: string, content: unknown): boolean;
+  get(name: string): unknown | undefined;
+  list(): unknown[];
+  hasRenderer(templateName: string, format?: OutputFormat): boolean;
+  getRenderer(templateName: string, format?: OutputFormat): unknown | undefined;
+  validate(templateName: string, content: unknown): boolean;
 }
 interface FrontmatterSchemaParser {
-    parse(data: unknown): unknown;
+  parse(data: unknown): unknown;
 }
 interface EntityPluginEntitiesNamespace extends Omit<IEntitiesNamespace, "getEffectiveFrontmatterSchema"> {
-    getEffectiveFrontmatterSchema(type: string): FrontmatterSchemaParser | undefined;
+  getEffectiveFrontmatterSchema(type: string): FrontmatterSchemaParser | undefined;
 }
 interface ServicePluginContext extends BasePluginContext {
-    readonly entities: IEntitiesNamespace;
-    readonly templates: IServiceTemplatesNamespace;
-    readonly views: IViewsNamespace;
-    readonly prompts: IPromptsNamespace;
-    readonly ai: IEntityAINamespace;
-    registerInstructions(instructions: string): void;
+  readonly entities: IEntitiesNamespace;
+  readonly templates: IServiceTemplatesNamespace;
+  readonly views: IViewsNamespace;
+  readonly prompts: IPromptsNamespace;
+  readonly ai: IEntityAINamespace;
+  registerInstructions(instructions: string): void;
 }
 interface EntityPluginContext extends BasePluginContext {
-    readonly entities: EntityPluginEntitiesNamespace;
-    readonly prompts: IPromptsNamespace;
+  readonly entities: EntityPluginEntitiesNamespace;
+  readonly prompts: IPromptsNamespace;
 }
 interface InterfacePluginContext extends BasePluginContext {
-    readonly agent: AgentNamespace;
+  readonly agent: AgentNamespace;
 }
-
+//#endregion
+//#region ../../shell/plugins/src/config.d.ts
 /**
  * Type helpers for plugin configuration
  */
 type PluginConfigSchema<TConfig> = ZodType<TConfig, unknown>;
-
+//#endregion
+//#region ../../shell/plugins/src/public/entity-plugin.d.ts
 type EntitySchema<TEntity extends BaseEntity> = EntityAdapter<TEntity>["schema"];
 declare abstract class EntityPlugin<TEntity extends BaseEntity, TConfig, TConfigInput> implements Plugin {
-    readonly type: "entity";
-    readonly id: string;
-    readonly version: string;
-    readonly packageName: string;
-    readonly description?: string;
-    abstract readonly entityType: string;
-    abstract readonly schema: EntitySchema<TEntity>;
-    abstract readonly adapter: EntityAdapter<TEntity>;
-    private readonly delegate;
-    protected constructor(id: string, packageJson: {
-        name: string;
-        version: string;
-        description?: string;
-    }, config: TConfigInput, configSchema: PluginConfigSchema<TConfig>);
-    protected onRegister(_context: EntityPluginContext): Promise<void>;
-    protected onReady(_context: EntityPluginContext): Promise<void>;
-    protected onShutdown(): Promise<void>;
-    protected getInstructions(): Promise<string | undefined>;
-    protected getEntityTypeConfig(): EntityTypeConfig | undefined;
-    protected getDataSources(): DataSource[];
-    protected interceptCreate(input: CreateInput, _executionContext: CreateExecutionContext, _context: EntityPluginContext): Promise<CreateInterceptionResult>;
-    ready(): Promise<void>;
-    shutdown(): Promise<void>;
-}
-
+  readonly type = "entity";
+  readonly id: string;
+  readonly version: string;
+  readonly packageName: string;
+  readonly description?: string;
+  abstract readonly entityType: string;
+  abstract readonly schema: EntitySchema<TEntity>;
+  abstract readonly adapter: EntityAdapter<TEntity>;
+  private readonly delegate;
+  protected constructor(id: string, packageJson: {
+    name: string;
+    version: string;
+    description?: string;
+  }, config: TConfigInput, configSchema: PluginConfigSchema<TConfig>);
+  protected onRegister(_context: EntityPluginContext): Promise<void>;
+  protected onReady(_context: EntityPluginContext): Promise<void>;
+  protected onShutdown(): Promise<void>;
+  protected getInstructions(): Promise<string | undefined>;
+  protected getEntityTypeConfig(): EntityTypeConfig | undefined;
+  protected getDataSources(): DataSource[];
+  protected interceptCreate(input: CreateInput, _executionContext: CreateExecutionContext, _context: EntityPluginContext): Promise<CreateInterceptionResult>;
+  ready(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+//#endregion
+//#region ../../shell/plugins/src/public/interface-plugin.d.ts
 declare abstract class InterfacePlugin<TConfig, TConfigInput, TTrackingInfo extends BaseJobTrackingInfo = BaseJobTrackingInfo> implements Plugin {
-    readonly type: "interface";
-    readonly id: string;
-    readonly version: string;
-    readonly packageName: string;
-    readonly description?: string;
-    private readonly delegate;
-    protected constructor(id: string, packageJson: {
-        name: string;
-        version: string;
-        description?: string;
-    }, config: TConfigInput, configSchema: PluginConfigSchema<TConfig>);
-    protected onRegister(_context: InterfacePluginContext): Promise<void>;
-    protected onReady(_context: InterfacePluginContext): Promise<void>;
-    protected onShutdown(): Promise<void>;
-    protected getTools(): Promise<Tool[]>;
-    protected getResources(): Promise<Resource[]>;
-    protected getInstructions(): Promise<string | undefined>;
-    getWebRoutes(): WebRouteDefinition[];
-    requiresDaemonStartup(): boolean;
-    ready(): Promise<void>;
-    shutdown(): Promise<void>;
-}
-
+  readonly type = "interface";
+  readonly id: string;
+  readonly version: string;
+  readonly packageName: string;
+  readonly description?: string;
+  private readonly delegate;
+  protected constructor(id: string, packageJson: {
+    name: string;
+    version: string;
+    description?: string;
+  }, config: TConfigInput, configSchema: PluginConfigSchema<TConfig>);
+  protected onRegister(_context: InterfacePluginContext): Promise<void>;
+  protected onReady(_context: InterfacePluginContext): Promise<void>;
+  protected onShutdown(): Promise<void>;
+  protected getTools(): Promise<Tool[]>;
+  protected getResources(): Promise<Resource[]>;
+  protected getInstructions(): Promise<string | undefined>;
+  getWebRoutes(): WebRouteDefinition[];
+  requiresDaemonStartup(): boolean;
+  ready(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+//#endregion
+//#region ../../shell/plugins/src/message-interface/message-interface-plugin.d.ts
 type MessageInterfaceOutput = string | {
-    card: unknown;
-    fallbackText?: string;
+  card: unknown;
+  fallbackText?: string;
 };
 interface SendMessageToChannelRequest {
-    /** The channel/room to send to (null for single-channel interfaces like CLI) */
-    channelId: string | null;
-    /** The message or structured output to send */
-    message: MessageInterfaceOutput;
+  /** The channel/room to send to (null for single-channel interfaces like CLI) */
+  channelId: string | null;
+  /** The message or structured output to send */
+  message: MessageInterfaceOutput;
 }
 type SendMessageWithIdRequest = SendMessageToChannelRequest;
 interface EditMessageRequest {
-    channelId: string | null;
-    messageId: string;
-    newMessage: MessageInterfaceOutput;
+  channelId: string | null;
+  messageId: string;
+  newMessage: MessageInterfaceOutput;
 }
-
+//#endregion
+//#region ../../shell/plugins/src/public/message-interface-plugin.d.ts
 declare abstract class MessageInterfacePlugin<TConfig, TConfigInput, TTrackingInfo extends MessageJobTrackingInfo = MessageJobTrackingInfo> extends InterfacePlugin<TConfig, TConfigInput, TTrackingInfo> {
-    private readonly messageDelegate;
-    protected constructor(id: string, packageJson: {
-        name: string;
-        version: string;
-        description?: string;
-    }, config: TConfigInput, configSchema: PluginConfigSchema<TConfig>);
-    protected abstract sendMessageToChannel(request: SendMessageToChannelRequest): void;
-    protected onRegister(_context: InterfacePluginContext): Promise<void>;
-    protected onReady(_context: InterfacePluginContext): Promise<void>;
-    protected onShutdown(): Promise<void>;
-    protected getTools(): Promise<Tool[]>;
-    protected getResources(): Promise<Resource[]>;
-    protected getInstructions(): Promise<string | undefined>;
-    protected sendMessageWithId(_request: SendMessageWithIdRequest): Promise<string | undefined>;
-    protected editMessage(_request: EditMessageRequest): Promise<boolean>;
-    protected supportsMessageEditing(): boolean;
-    protected onProgressUpdate(_event: JobProgressEvent): Promise<void>;
-    protected trackAgentResponseForJob(jobId: string, messageId: string, channelId: string): void;
-    registerProgressCallback(callback: (events: JobProgressEvent[]) => void): void;
-    unregisterProgressCallback(): void;
-    getProgressEvents(): JobProgressEvent[];
-    getActiveProgressEvents(): JobProgressEvent[];
-    startProcessingInput(channelId?: string | null): void;
-    endProcessingInput(): void;
-    protected getCurrentChannelId(): string | null;
-    ready(): Promise<void>;
-    shutdown(): Promise<void>;
-}
-
+  private readonly messageDelegate;
+  protected constructor(id: string, packageJson: {
+    name: string;
+    version: string;
+    description?: string;
+  }, config: TConfigInput, configSchema: PluginConfigSchema<TConfig>);
+  protected abstract sendMessageToChannel(request: SendMessageToChannelRequest): void;
+  protected override onRegister(_context: InterfacePluginContext): Promise<void>;
+  protected override onReady(_context: InterfacePluginContext): Promise<void>;
+  protected override onShutdown(): Promise<void>;
+  protected override getTools(): Promise<Tool[]>;
+  protected override getResources(): Promise<Resource[]>;
+  protected override getInstructions(): Promise<string | undefined>;
+  protected sendMessageWithId(_request: SendMessageWithIdRequest): Promise<string | undefined>;
+  protected editMessage(_request: EditMessageRequest): Promise<boolean>;
+  protected supportsMessageEditing(): boolean;
+  protected onProgressUpdate(_event: JobProgressEvent): Promise<void>;
+  protected trackAgentResponseForJob(jobId: string, messageId: string, channelId: string): void;
+  registerProgressCallback(callback: (events: JobProgressEvent[]) => void): void;
+  unregisterProgressCallback(): void;
+  getProgressEvents(): JobProgressEvent[];
+  getActiveProgressEvents(): JobProgressEvent[];
+  startProcessingInput(channelId?: string | null): void;
+  endProcessingInput(): void;
+  protected getCurrentChannelId(): string | null;
+  override ready(): Promise<void>;
+  override shutdown(): Promise<void>;
+}
+//#endregion
+//#region ../../shell/plugins/src/public/service-plugin.d.ts
 declare abstract class ServicePlugin<TConfig, TConfigInput> implements Plugin {
-    readonly type: "service";
-    readonly id: string;
-    readonly version: string;
-    readonly packageName: string;
-    readonly description?: string;
-    private readonly delegate;
-    protected constructor(id: string, packageJson: {
-        name: string;
-        version: string;
-        description?: string;
-    }, config: TConfigInput, configSchema: PluginConfigSchema<TConfig>);
-    protected onRegister(_context: ServicePluginContext): Promise<void>;
-    protected onReady(_context: ServicePluginContext): Promise<void>;
-    protected onShutdown(): Promise<void>;
-    protected getTools(): Promise<Tool[]>;
-    protected getResources(): Promise<Resource[]>;
-    protected getInstructions(): Promise<string | undefined>;
-    ready(): Promise<void>;
-    shutdown(): Promise<void>;
-}
-
-export { AgentResponseSchema, AnchorProfileSchema, AppInfoSchema, BaseMessageSchema, BrainCharacterSchema, ChatContextSchema, ConversationSchema, EntityPlugin, ExtensionMetadataSchema, InterfacePlugin, MessageInterfacePlugin, MessageResponseSchema, MessageSchema, PendingConfirmationSchema, ServicePlugin, ToolResultDataSchema, createResource, createTool, defineChannel, toolError, toolSuccess, urlCaptureConfigSchema };
-export type { AgentNamespace, AgentResponse, AnchorProfile, AppInfo, BaseJobTrackingInfo, BaseMessage, BasePluginContext, BrainCharacter, Channel, ChatContext, Conversation, EntityPluginContext, ExtensionMetadata, IConversationsNamespace, IEntitiesNamespace, IEntityService, IEvalNamespace, IIdentityNamespace, IInsightsNamespace, IMessagingNamespace, IPromptsNamespace, IRuntimeUploadsNamespace, IServiceTemplatesNamespace, IViewsNamespace, InterfacePluginContext, JobProgressContext, JobProgressEvent, JobProgressStatus, Message, MessageContext, MessageJobTrackingInfo, MessageResponse, MessageRole, MessageSendOptions, MessageSender, MessageWithPayload, PendingConfirmation, Plugin, PluginConfig, PluginConfigInput, PluginFactory, Prompt, ResolvedRuntimeUpload, Resource, ResourceTemplate, RuntimeUploadRecord, RuntimeUploadResponseBody, RuntimeUploadScopeOptions, RuntimeUploadStore, SaveRuntimeUploadInput, ServicePluginContext, Tool, ToolConfirmation, ToolContext, ToolResponse, ToolResultData, ToolVisibility };
+  readonly type = "service";
+  readonly id: string;
+  readonly version: string;
+  readonly packageName: string;
+  readonly description?: string;
+  private readonly delegate;
+  protected constructor(id: string, packageJson: {
+    name: string;
+    version: string;
+    description?: string;
+  }, config: TConfigInput, configSchema: PluginConfigSchema<TConfig>);
+  protected onRegister(_context: ServicePluginContext): Promise<void>;
+  protected onReady(_context: ServicePluginContext): Promise<void>;
+  protected onShutdown(): Promise<void>;
+  protected getTools(): Promise<Tool[]>;
+  protected getResources(): Promise<Resource[]>;
+  protected getInstructions(): Promise<string | undefined>;
+  ready(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+//#endregion
+export { type AgentNamespace, type AgentResponse, AgentResponseSchema, type AnchorProfile, AnchorProfileSchema, type AppInfo, AppInfoSchema, type BaseJobTrackingInfo, type BaseMessage, BaseMessageSchema, type BasePluginContext, type BrainCharacter, BrainCharacterSchema, type Channel, type ChatContext, ChatContextSchema, type Conversation, ConversationSchema, EntityPlugin, type EntityPluginContext, type ExtensionMetadata, ExtensionMetadataSchema, type IConversationsNamespace, type IEntitiesNamespace, type IEntityService, type IEvalNamespace, type IIdentityNamespace, type IInsightsNamespace, type IMessagingNamespace, type IPromptsNamespace, type IRuntimeUploadsNamespace, type IServiceTemplatesNamespace, type IViewsNamespace, InterfacePlugin, type InterfacePluginContext, type JobProgressContext, type JobProgressEvent, type JobProgressStatus, type Message, type MessageContext, MessageInterfacePlugin, type MessageJobTrackingInfo, type MessageResponse, MessageResponseSchema, type MessageRole, MessageSchema, type MessageSendOptions, type MessageSender, type MessageWithPayload, type PendingConfirmation, PendingConfirmationSchema, type Plugin, type PluginConfig, type PluginConfigInput, type PluginFactory, type Prompt, type ResolvedRuntimeUpload, type Resource, type ResourceTemplate, type RuntimeUploadRecord, type RuntimeUploadResponseBody, type RuntimeUploadScopeOptions, type RuntimeUploadStore, type SaveRuntimeUploadInput, ServicePlugin, type ServicePluginContext, type Tool, type ToolConfirmation, type ToolContext, type ToolResponse, type ToolResultData, ToolResultDataSchema, type ToolVisibility, createResource, createTool, defineChannel, toolError, toolSuccess, urlCaptureConfigSchema };