@burdenoff/microfe-botmanor 2026.1106.1 → 2026.1109.1

package/dist/botlit/types/index.d.ts

@@ -0,0 +1,1008 @@
+/**
+ * BotManor Type Definitions
+ * @module botlit/types
+ *
+ * Based on: ~/products/prompts/epics/fe/botlit-new-specs.md
+ * Updated: 2026-01-21
+ */
+export interface NavItem {
+    id: string;
+    label: string;
+    path: string;
+    icon?: React.ReactNode;
+    order?: number;
+    group?: string;
+    badge?: number;
+    /** When true, path is external (different microfe or full URL) - use window.location instead of navigate */
+    external?: boolean;
+}
+export interface FooterItem {
+    id: string;
+    label: string;
+    type: 'status' | 'action' | 'info';
+    order?: number;
+    section?: 'left' | 'center' | 'right';
+    onClick?: () => void;
+}
+export interface User {
+    id: string;
+    email: string;
+    /** Full name (display name) */
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    avatar?: string;
+}
+export interface BotmanorRootProps {
+    basePath: string;
+    navigate: (path: string) => void;
+    currentUser?: User;
+    tenantId?: string;
+    workspaceId?: string;
+    /**
+     * Workspace-specific API gateway URL (e.g. http://localhost:4003).
+     * Used for /workspaces/graphql calls.
+     */
+    apiGatewayUrl?: string;
+    authToken?: string;
+    workspaceToken?: string;
+    productId?: string;
+    productName?: string;
+    registerNavItems?: (items: NavItem | NavItem[]) => () => void;
+    registerFooterItems?: (items: FooterItem | FooterItem[]) => () => void;
+    onBotSelect?: (bot: BotSummary) => void;
+    onAgentSelect?: (agent: AgentSummary) => void;
+}
+export type Visibility = 'PRIVATE' | 'WORKSPACE' | 'PUBLIC';
+export type EntityStatus = 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'ARCHIVED';
+export type Environment = 'DEV' | 'STAGING' | 'PROD';
+export type RoutingStrategy = 'SINGLE_AGENT' | 'INTENT_ROUTER' | 'A2A_DISPATCH' | 'ROUTER_AGENT';
+export type PromptMode = 'INLINE' | 'TEMPLATE_REF';
+export type KBType = 'MILVUS' | 'QDRANT' | 'PINECONE' | 'WEAVIATE' | 'PGVECTOR' | 'ELASTIC_VECTOR' | 'CUSTOM';
+export type RetrievalMode = 'VECTOR' | 'HYBRID' | 'BM25_ONLY';
+export type RerankerMode = 'OFF' | 'ON';
+export type MCPTransport = 'HTTP_JSON' | 'JSON_RPC' | 'SSE' | 'CUSTOM';
+export type MCPAuthMethod = 'API_KEY' | 'OAUTH' | 'CUSTOM_HEADER' | 'NONE';
+export type ToolRiskLevel = 'LOW' | 'MEDIUM' | 'HIGH';
+export type MCPServerStatus = 'HEALTHY' | 'DEGRADED' | 'UNAVAILABLE' | 'CONNECTING';
+export type TrustLevel = 'UNVERIFIED' | 'VERIFIED_PUBLISHER' | 'INTERNAL';
+export type ChannelType = 'WEB_WIDGET' | 'SLACK' | 'TEAMS' | 'DISCORD' | 'WHATSAPP' | 'WEBHOOK' | 'CUSTOM';
+export type LLMProviderType = 'OPENAI' | 'ANTHROPIC' | 'GOOGLE' | 'AZURE_OPENAI' | 'OPENAI_COMPAT' | 'CUSTOM';
+export type PolicyType = 'CONTENT' | 'TOOL' | 'DATA' | 'RESPONSE' | 'BUDGET' | 'RATE_LIMIT' | 'RETENTION';
+export type PackageKind = 'APP' | 'AGENT' | 'MCP_PACK' | 'PROMPT_TEMPLATE' | 'PROMPT' | 'SKILL' | 'RETRIEVAL_PROFILE' | 'POLICY_BUNDLE' | 'CHANNEL_TEMPLATE' | 'A2A_AGENT' | 'KB_TEMPLATE' | 'KNOWLEDGE_BASE' | 'INTEGRATION' | 'TEMPLATE' | 'TOOL' | 'WORKFLOW';
+export type InstallMode = 'LINKED' | 'FORKED';
+export type ExecutionStatus = 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'TIMEOUT' | 'CANCELLED';
+export type ReplayMode = 'REPLAY_SAME_BUNDLE' | 'REPLAY_WITH_LATEST_STORE' | 'REPLAY_FROZEN_RETRIEVAL' | 'REPLAY_LIVE_RETRIEVAL';
+export type ViewMode = 'grid' | 'list' | 'kanban';
+export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface BaseEntity {
+    id: string;
+    workspaceId: string;
+    name: string;
+    description?: string;
+    tags: string[];
+    bucketId?: string;
+    visibility: Visibility;
+    status: EntityStatus;
+    labels?: string[];
+    revision: number;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}
+export interface Bot extends BaseEntity {
+    slug: string;
+    icon?: string;
+    routing: BotRouting;
+    assignedAgents: AssignedAgent[];
+    channelBindings: ChannelRouteRef[];
+    policyBindings?: PolicyBindingSet;
+    embedConfigId?: string;
+    releaseTracks: ReleaseTrack[];
+}
+export interface BotSummary {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    icon?: string;
+    status: EntityStatus;
+    visibility: Visibility;
+    agentCount: number;
+    channelCount: number;
+    executionCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface BotRouting {
+    strategy: RoutingStrategy;
+    defaultAgentId?: string;
+    rules: RoutingRule[];
+}
+export interface RoutingRule {
+    id: string;
+    match: RoutingMatch;
+    action: RoutingAction;
+    constraints?: RoutingConstraints;
+}
+export interface RoutingMatch {
+    intent?: string;
+    keywords?: string[];
+    regex?: string;
+    channelType?: ChannelType;
+    channelLocationId?: string;
+}
+export interface RoutingAction {
+    agentId?: string;
+    a2aTargetId?: string;
+    fallbackChain?: string[];
+}
+export interface RoutingConstraints {
+    maxHops?: number;
+    budgetPolicyId?: string;
+}
+export interface AssignedAgent {
+    agentId: string;
+    role?: string;
+    weight?: number;
+    isDefault?: boolean;
+}
+export interface ChannelRouteRef {
+    routeId: string;
+    connectorId: string;
+    locationId: string;
+}
+export interface ReleaseTrack {
+    environment: Environment;
+    version: string;
+    resolvedBundleHash?: string;
+    promotedAt?: string;
+    promotedBy?: string;
+}
+export interface Agent extends BaseEntity {
+    slug: string;
+    avatar?: string;
+    prompt: AgentPrompt;
+    llm: AgentLLM;
+    tools: AgentTools;
+    knowledge: AgentKnowledge;
+    memoryPolicyId?: string;
+    a2a?: AgentA2AConfig;
+    capabilities: AgentCapabilities;
+    policyBindings?: PolicyBindingSet;
+}
+export interface AgentSummary {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    avatar?: string;
+    status: EntityStatus;
+    visibility: Visibility;
+    executionCount: number;
+    successRate?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentPrompt {
+    mode: PromptMode;
+    templateId?: string;
+    inlinePrompt?: string;
+    systemDirectives?: string[];
+}
+export interface AgentLLM {
+    modelPolicyId: string;
+    structuredOutputSchemaId?: string;
+}
+export interface AgentTools {
+    toolPolicyId?: string;
+    mcpConnections: string[];
+}
+export interface AgentKnowledge {
+    kbBindings: KBBinding[];
+}
+export interface KBBinding {
+    kbId: string;
+    retrievalProfileId: string;
+    priority: number;
+    routingRule?: string;
+    constraints?: KBConstraints;
+}
+export interface KBConstraints {
+    labelAllowlist?: string[];
+    labelDenylist?: string[];
+}
+export interface AgentA2AConfig {
+    enabled: boolean;
+    a2aProfileId?: string;
+}
+export interface AgentCapabilities {
+    supportsTools: boolean;
+    supportsVision: boolean;
+    supportsStreaming: boolean;
+    supportsStructuredOutput: boolean;
+    multilingual: boolean;
+}
+export interface KnowledgeBase extends BaseEntity {
+    type: KBType;
+    connection: KBConnection;
+    target: KBTarget;
+    defaults: KBDefaults;
+    fluidgrids: KBFluidgridsInfo;
+}
+export interface KnowledgeBaseSummary {
+    id: string;
+    name: string;
+    description?: string;
+    type: KBType;
+    status: EntityStatus;
+    documentCount: number;
+    lastIngestedAt?: string;
+    createdAt: string;
+}
+export interface KBConnection {
+    connectionRefId: string;
+    endpoint?: string;
+    region?: string;
+}
+export interface KBTarget {
+    namespace?: string;
+    indexName?: string;
+    collectionName?: string;
+}
+export interface KBDefaults {
+    defaultRetrievalProfileId?: string;
+    labels: string[];
+    accessPolicyId?: string;
+}
+export interface KBFluidgridsInfo {
+    ingestionFlowRefs: string[];
+    lastIngestedAt?: string;
+    lastIngestionStatus?: 'SUCCESS' | 'FAILED' | 'RUNNING';
+    lastErrorSummary?: string;
+}
+export interface RetrievalProfile extends BaseEntity {
+    strategy: RetrievalStrategy;
+    grounding: GroundingPolicy;
+    thresholds: RetrievalThresholds;
+    evaluation?: RetrievalEvaluation;
+}
+export interface RetrievalProfileSummary {
+    id: string;
+    name: string;
+    description?: string;
+    status: EntityStatus;
+    strategyMode: RetrievalMode;
+    topK: number;
+    citationsRequired: boolean;
+    createdAt: string;
+}
+export interface RetrievalStrategy {
+    mode: RetrievalMode;
+    topK: number;
+    hybridWeights?: {
+        bm25: number;
+        vector: number;
+    };
+    reranker: RerankerMode;
+    rerankerModelPolicyId?: string;
+    queryRewrite: RerankerMode;
+    multiHop: RerankerMode;
+    depth?: number;
+}
+export interface GroundingPolicy {
+    citationsRequired: boolean;
+    minSources: number;
+    snippetMaxChars: number;
+    showSources: boolean;
+    citationFormatTemplate: string;
+}
+export interface RetrievalThresholds {
+    minRelevanceScore?: number;
+    noAnswerIfBelowThreshold: boolean;
+}
+export interface RetrievalEvaluation {
+    testQueries: TestQuery[];
+}
+export interface TestQuery {
+    query: string;
+    expectedDocIds: string[];
+    expectedChunkIds?: string[];
+}
+export interface MCPServer extends BaseEntity {
+    transport: MCPTransport;
+    baseUrl: string;
+    auth: MCPAuth;
+    tools: MCPTool[];
+    resources?: MCPResource[];
+    health?: MCPHealth;
+}
+export interface MCPServerSummary {
+    id: string;
+    name: string;
+    description?: string;
+    transport: MCPTransport;
+    status: EntityStatus;
+    healthStatus?: MCPServerStatus;
+    toolCount: number;
+    createdAt: string;
+}
+export interface MCPAuth {
+    method: MCPAuthMethod;
+    secretRefId?: string;
+}
+export interface MCPTool {
+    toolId: string;
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    outputSchema?: JSONSchema;
+    riskLevel: ToolRiskLevel;
+    tags: string[];
+}
+export interface MCPResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface MCPHealth {
+    lastTestTime?: string;
+    status: MCPServerStatus;
+    latencyMs?: number;
+    error?: string;
+}
+export interface JSONSchema {
+    type: string;
+    properties?: Record<string, JSONSchemaProperty>;
+    required?: string[];
+    description?: string;
+}
+export interface JSONSchemaProperty {
+    type: string;
+    description?: string;
+    enum?: string[];
+    default?: unknown;
+    items?: JSONSchemaProperty;
+}
+export interface A2AAgent extends BaseEntity {
+    agentCard: AgentCard;
+    wellKnownUrl?: string;
+    trustLevel: TrustLevel;
+    entitlements: A2AEntitlement[];
+}
+export interface A2AAgentSummary {
+    id: string;
+    name: string;
+    description?: string;
+    status: EntityStatus;
+    trustLevel: TrustLevel;
+    skillCount: number;
+    wellKnownUrl?: string;
+    createdAt: string;
+}
+export interface AgentCard {
+    name: string;
+    description: string;
+    url: string;
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    version: string;
+    documentationUrl?: string;
+    capabilities: A2ACapabilities;
+    authentication: A2AAuthentication;
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills: A2ASkill[];
+}
+export interface A2ACapabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    stateTransitionHistory?: boolean;
+}
+export interface A2AAuthentication {
+    schemes: string[];
+    credentials?: string;
+}
+export interface A2ASkill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+export interface A2AEntitlement {
+    id: string;
+    sourceType: 'app' | 'agent';
+    sourceId: string;
+    allowedSkills: string[];
+    disallowedSkills: string[];
+    maxHops?: number;
+    budgetPolicyId?: string;
+}
+export interface ChannelConnector extends BaseEntity {
+    type: ChannelType;
+    credentialsRefId?: string;
+    defaultPolicyBindings?: PolicyBindingSet;
+    webWidgetConfig?: WebWidgetConfig;
+}
+export interface ChannelConnectorSummary {
+    id: string;
+    name: string;
+    description?: string;
+    type: ChannelType;
+    status: EntityStatus;
+    routeCount: number;
+    createdAt: string;
+}
+export interface ChannelRoute {
+    id: string;
+    workspaceId: string;
+    connectorId: string;
+    locationId: string;
+    locationName?: string;
+    botId: string;
+    botName?: string;
+    policyBindings?: PolicyBindingSet;
+    formatPolicyId?: string;
+    routingOverrides?: RoutingRule[];
+    revision: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WebWidgetConfig {
+    allowedOrigins: string[];
+    theme: WidgetTheme;
+    starterPrompts: string[];
+    handoffRules: HandoffRule[];
+}
+export interface WidgetTheme {
+    logoAssetRef?: string;
+    primaryColor: string;
+    backgroundColor?: string;
+    fontFamily: string;
+}
+export interface HandoffRule {
+    intent: string;
+    action: 'escalate' | 'transfer' | 'notify';
+    target?: string;
+}
+export interface PolicyBindingSet {
+    contentPolicyId?: string;
+    toolPolicyId?: string;
+    dataPolicyId?: string;
+    responsePolicyId?: string;
+    budgetPolicyId?: string;
+    rateLimitPolicyId?: string;
+    retentionPolicyId?: string;
+}
+export interface Policy extends BaseEntity {
+    type: PolicyType;
+    config: PolicyConfig;
+}
+export interface PolicySummary {
+    id: string;
+    name: string;
+    description?: string;
+    type: PolicyType;
+    status: EntityStatus;
+    createdAt: string;
+}
+/**
+ * Policy config shapes. Every key below is enforced at runtime by the BotManor
+ * service (BOFF-9683); keys the runtime ignores are intentionally not modelled.
+ * DATA policies have no runtime evaluator, so stored rows of that type carry
+ * free-form legacy config.
+ */
+export type PolicyConfig = ContentPolicyConfig | ToolPolicyConfig | ResponsePolicyConfig | BudgetPolicyConfig | RateLimitPolicyConfig | RetentionPolicyConfig | LegacyPolicyConfig;
+export interface ContentPolicyConfig {
+    /** Block SSN, credit-card and email shaped text. */
+    piiDetection?: boolean;
+    /** Case-insensitive substrings that block a message. */
+    blockedKeywords?: string[];
+    /** Case-insensitive regular expressions that block a message. */
+    blockedPatterns?: string[];
+    /** Alias of `blockedPatterns` written by earlier editor versions. */
+    customPatterns?: string[];
+}
+export interface ToolPolicyConfig {
+    /** MCP tool names allowed to run; an entry ending in `*` allows a prefix. Empty = no restriction. */
+    allowedTools?: string[];
+    /** MCP tool names that may never run; a deny always wins. */
+    deniedTools?: string[];
+    /** Highest MCP tool risk level allowed to run. */
+    maxToolRiskLevel?: 'LOW' | 'MEDIUM' | 'HIGH';
+    /** Lowest registry trust level an external A2A agent needs. */
+    a2aMinTrustLevel?: 'UNVERIFIED' | 'VERIFIED_PUBLISHER' | 'INTERNAL';
+    limits?: {
+        /** Tool calls (MCP and delegation) allowed in one agent turn. */
+        maxCallsPerExecution?: number;
+        /** Request timeout for each MCP tool call. */
+        timeoutSeconds?: number;
+    };
+}
+export interface ResponsePolicyConfig {
+    /** Model-usage allowlist; an entry ending in `*` allows a model-id prefix. */
+    allowedModels?: string[];
+    /** Provider types (e.g. OPENAI, AWS_BEDROCK) allowed to generate responses. */
+    allowedProviders?: string[];
+}
+export interface BudgetPolicyConfig {
+    /** Tokens one agent may use per UTC day. */
+    maxTokensPerDay?: number;
+    /** Cap on the max output tokens of every model call. */
+    maxTokensPerExecution?: number;
+}
+export interface RateLimitPolicyConfig {
+    /** Every window is counted per agent. */
+    limits?: {
+        requestsPerMinute?: number;
+        requestsPerHour?: number;
+        tokensPerMinute?: number;
+    };
+}
+/**
+ * Retention periods enforced hourly by the BotManor retention job (BOFF-9661).
+ * The shortest period of each class across ACTIVE policies applies.
+ */
+export interface RetentionPolicyConfig {
+    /** Days after a run ends that execution and agent-message payloads are kept (0..3650). */
+    executionDataRetentionDays?: number;
+    /** Days an assistant conversation is kept before it is erased (1..3650). */
+    conversationRetentionDays?: number;
+}
+/** Config stored on a DATA policy (no runtime evaluator). */
+export type LegacyPolicyConfig = Record<string, unknown>;
+export interface Skill extends BaseEntity {
+    promptTemplateId?: string;
+    toolPolicyId?: string;
+    toolPackDeps: string[];
+    retrievalProfileId?: string;
+    recommendedPolicies: string[];
+    capabilityFlags: SkillCapabilities;
+}
+export interface SkillSummary {
+    id: string;
+    name: string;
+    description?: string;
+    status: EntityStatus;
+    hasPrompt: boolean;
+    hasTools: boolean;
+    hasKnowledge: boolean;
+    createdAt: string;
+}
+export interface SkillCapabilities {
+    requiresTools: boolean;
+    requiresKnowledge: boolean;
+    requiresA2A: boolean;
+}
+export interface PromptTemplate extends BaseEntity {
+    slug: string;
+    version: string;
+    templateText: string;
+    variables: PromptVariable[];
+    exampleInputs: Record<string, unknown>[];
+}
+export interface PromptTemplateSummary {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    status: EntityStatus;
+    version: string;
+    variableCount: number;
+    createdAt: string;
+}
+export interface PromptVariable {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string;
+    required: boolean;
+    defaultValue?: unknown;
+}
+export interface StorePackage {
+    id: string;
+    slug: string;
+    kind: PackageKind;
+    version: string;
+    manifest: PackageManifest;
+    readme?: string;
+    rating?: number;
+    downloadCount?: number;
+    publishedAt: string;
+    publishedBy: string;
+}
+export interface StorePackageSummary {
+    id: string;
+    slug: string;
+    name: string;
+    description?: string;
+    kind: PackageKind;
+    version: string;
+    rating?: number;
+    downloadCount?: number;
+    publishedAt: string;
+}
+export interface PackageManifest {
+    schemaVersion: string;
+    package: PackageInfo;
+    compatibility: CompatibilityInfo;
+    dependencies: PackageDependency[];
+    artifacts: ArtifactInfo;
+    security: SecurityInfo;
+    integrity: IntegrityInfo;
+}
+export interface PackageInfo {
+    kind: PackageKind;
+    name: string;
+    slug: string;
+    version: string;
+    description: string;
+    tags: string[];
+    license: string;
+    author: {
+        name: string;
+        url?: string;
+    };
+    homepage?: string;
+    repository?: string;
+    icon?: string;
+}
+export interface CompatibilityInfo {
+    botlit: string;
+    a2a?: string;
+    mcp?: string;
+    fluidgrids?: string;
+}
+export interface PackageDependency {
+    slug: string;
+    version: string;
+}
+export interface ArtifactInfo {
+    entry: string;
+    files: string[];
+    docs?: string;
+}
+export interface SecurityInfo {
+    risk: 'low' | 'medium' | 'high';
+    requiresSecrets: boolean;
+    network: {
+        egress: 'none' | 'restricted' | 'any';
+    };
+}
+export interface IntegrityInfo {
+    checksum: string;
+    signature?: string;
+}
+export interface InstalledPackage {
+    id: string;
+    workspaceId: string;
+    packageId: string;
+    slug: string;
+    kind: PackageKind;
+    installedVersion: string;
+    mode: InstallMode;
+    bindings: Record<string, string>;
+    pinnedByEnv: Partial<Record<Environment, string>>;
+    installedAt: string;
+    installedBy: string;
+    package?: StorePackageSummary;
+}
+export interface Bucket extends BaseEntity {
+    parentBucketId?: string;
+    permissions: BucketPermissions;
+    defaults: BucketDefaults;
+    path: string;
+    childCount?: number;
+    itemCount?: number;
+}
+export interface BucketSummary {
+    id: string;
+    name: string;
+    description?: string;
+    path: string;
+    visibility: Visibility;
+    childCount: number;
+    itemCount: number;
+    createdAt: string;
+}
+export interface BucketPermissions {
+    owners: string[];
+    editors: string[];
+    viewers: string[];
+}
+export interface BucketDefaults {
+    defaultPolicyBindings?: PolicyBindingSet;
+    defaultModelPolicyId?: string;
+    defaultRateLimitPolicyId?: string;
+    defaultBudgetPolicyId?: string;
+}
+export interface Execution {
+    id: string;
+    workspaceId: string;
+    botId?: string;
+    botName?: string;
+    agentId?: string;
+    agentName?: string;
+    channelRouteId?: string;
+    connectorType?: ChannelType;
+    traceId: string;
+    startedAt: string;
+    endedAt?: string;
+    status: ExecutionStatus;
+    resolvedBundleHash: string;
+    manifestLocks: Record<string, string>;
+    metrics: ExecutionMetrics;
+    events: ExecutionEvent[];
+    policyDecisions: PolicyDecision[];
+}
+export interface ExecutionSummary {
+    id: string;
+    botName?: string;
+    agentName?: string;
+    status: ExecutionStatus;
+    durationMs?: number;
+    totalTokens?: number;
+    estimatedCost?: number;
+    startedAt: string;
+    endedAt?: string;
+}
+export interface ExecutionMetrics {
+    latencyMs: number;
+    totalTokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    estimatedCost: number;
+    toolCallCount: number;
+    retrievalCount: number;
+}
+export interface ExecutionEvent {
+    id: string;
+    timestamp: string;
+    type: ExecutionEventType;
+    data: Record<string, unknown>;
+}
+export type ExecutionEventType = 'model_selected' | 'tool_call' | 'tool_result' | 'retrieval_query' | 'retrieval_hit' | 'a2a_call' | 'a2a_response' | 'policy_check' | 'error';
+export interface PolicyDecision {
+    policyType: PolicyType;
+    policyId: string;
+    policyName?: string;
+    action: 'allowed' | 'denied' | 'modified';
+    reason?: string;
+    timestamp: string;
+}
+export interface LLMProvider {
+    id: string;
+    workspaceId: string;
+    name: string;
+    type: LLMProviderType;
+    baseUrl?: string;
+    region?: string;
+    credentialsRefId: string;
+    models: LLMModel[];
+    status: 'active' | 'inactive' | 'error';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LLMModel {
+    id: string;
+    providerId: string;
+    name: string;
+    modelId: string;
+    capabilities: LLMModelCapabilities;
+    contextWindow: number;
+    maxOutputTokens: number;
+    inputCostPer1M: number;
+    outputCostPer1M: number;
+}
+export interface LLMModelCapabilities {
+    text: boolean;
+    vision: boolean;
+    functionCalling: boolean;
+    jsonMode: boolean;
+    streaming: boolean;
+}
+export interface ModelPolicy extends BaseEntity {
+    primaryModelId: string;
+    fallbackChain: string[];
+    routingRules: ModelRoutingRule[];
+    budgetRules: ModelBudgetRules;
+    defaults: ModelDefaults;
+}
+export interface ModelRoutingRule {
+    condition: 'tools_needed' | 'context_exceeds' | 'structured_output' | 'vision_needed';
+    threshold?: number;
+    modelId: string;
+}
+export interface ModelBudgetRules {
+    maxTokensPerExecution: number;
+    maxCostPerExecution: number;
+}
+export interface ModelDefaults {
+    temperature: number;
+    topP: number;
+    maxTokens?: number;
+}
+export interface Conversation {
+    id: string;
+    workspaceId: string;
+    botId: string;
+    agentId: string;
+    userId?: string;
+    title: string;
+    messages: Message[];
+    metadata: ConversationMetadata;
+    status: 'active' | 'archived' | 'deleted';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Message {
+    id: string;
+    conversationId: string;
+    role: MessageRole;
+    content: string;
+    toolCalls?: ToolCall[];
+    toolResults?: ToolResult[];
+    metadata: MessageMetadata;
+    createdAt: string;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolResult {
+    toolCallId: string;
+    result: unknown;
+    error?: string;
+}
+export interface ConversationMetadata {
+    source?: 'web' | 'api' | 'widget' | 'slack' | 'discord';
+    userAgent?: string;
+    sessionId?: string;
+    tags?: string[];
+}
+export interface MessageMetadata {
+    tokens?: {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+    latencyMs?: number;
+    model?: string;
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    executionId?: string;
+}
+export interface BaseFilter {
+    search?: string;
+    status?: EntityStatus[];
+    visibility?: Visibility[];
+    bucketId?: string;
+    tags?: string[];
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface BotFilter extends BaseFilter {
+    routingStrategy?: RoutingStrategy[];
+}
+export interface AgentFilter extends BaseFilter {
+    hasKnowledge?: boolean;
+    hasTools?: boolean;
+    hasA2A?: boolean;
+}
+export interface KnowledgeBaseFilter extends BaseFilter {
+    type?: KBType[];
+}
+export interface RetrievalProfileFilter extends BaseFilter {
+    mode?: RetrievalMode[];
+}
+export interface MCPServerFilter extends BaseFilter {
+    transport?: MCPTransport[];
+    healthStatus?: MCPServerStatus[];
+}
+export interface A2AAgentFilter extends BaseFilter {
+    trustLevel?: TrustLevel[];
+}
+export interface ChannelFilter extends BaseFilter {
+    type?: ChannelType[];
+}
+export interface PolicyFilter extends BaseFilter {
+    type?: PolicyType[];
+}
+export interface ExecutionFilter {
+    botId?: string;
+    agentId?: string;
+    status?: ExecutionStatus[];
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+    minDuration?: number;
+    maxDuration?: number;
+}
+export interface StoreFilter {
+    kind?: PackageKind[];
+    search?: string;
+    minRating?: number;
+    sortBy?: 'downloads' | 'rating' | 'recent';
+}
+export interface Pagination {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+}
+export interface PaginatedResult<T> {
+    items: T[];
+    pagination: Pagination;
+}
+export interface ResolvedBundle {
+    hash: string;
+    workspaceId: string;
+    botId: string;
+    environment: Environment;
+    bot: Bot;
+    agents: Agent[];
+    effectivePolicies: PolicyBindingSet;
+    channelRoutes: ChannelRoute[];
+    kbInstances: KnowledgeBase[];
+    retrievalProfiles: RetrievalProfile[];
+    mcpConnections: MCPServer[];
+    a2aTargets: A2AAgent[];
+    storeLockfile: Record<string, string>;
+    resolvedAt: string;
+    provenance: BundleProvenance[];
+}
+export interface BundleProvenance {
+    entityType: string;
+    entityId: string;
+    version: string;
+    source: 'local' | 'store';
+    packageSlug?: string;
+}
+export interface DashboardStats {
+    bots: {
+        total: number;
+        active: number;
+        draft: number;
+    };
+    agents: {
+        total: number;
+        active: number;
+        draft: number;
+    };
+    knowledgeBases: {
+        total: number;
+        active: number;
+    };
+    executions: {
+        today: number;
+        thisWeek: number;
+        thisMonth: number;
+    };
+    successRate: number;
+    totalTokens: number;
+    estimatedCost: number;
+}
+export interface UsageMetrics {
+    period: 'day' | 'week' | 'month';
+    startDate: string;
+    endDate: string;
+    executions: number;
+    tokens: number;
+    cost: number;
+    successRate: number;
+    breakdown: DailyMetrics[];
+}
+export interface DailyMetrics {
+    date: string;
+    executions: number;
+    tokens: number;
+    cost: number;
+    successRate: number;
+}