@happyvertical/smrt-agents 0.30.0

package/dist/tenant-agent.d.ts

@@ -0,0 +1,106 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { AgentManifestInfo } from './ui.js';
+/**
+ * Status of a tenant-agent binding
+ */
+export type TenantAgentStatus = 'active' | 'disabled';
+/**
+ * Result of resolving agent availability for a tenant
+ */
+export interface ResolvedAgentAvailability {
+    /** Human-readable agent class name (e.g., 'Praeco') */
+    agentClass: string;
+    /** Canonical agent type (qualified name when available) */
+    agentType: string;
+    /** Resolved status */
+    status: TenantAgentStatus;
+    /** How this was resolved */
+    source: 'explicit' | 'inherited';
+    /** Which tenant the binding came from */
+    sourceTenantId: string;
+    /** Merged permissions (manifest defaults overridden by explicit grants/revokes) */
+    permissions: Record<string, boolean>;
+    /** The agent instance ID (row in agents table), if one exists */
+    agentId?: string;
+    /** Agent manifest from the build (if available) */
+    manifest?: AgentManifestInfo;
+    /** Tenant-level config overrides */
+    config?: Record<string, any>;
+}
+/**
+ * TenantAgent SmrtObject — junction between tenants and agents
+ *
+ * Each row represents an explicit binding of an agent class to a tenant.
+ * - Presence means explicit override (active or disabled)
+ * - Absence means "check parent tenant" (inheritance)
+ *
+ * Permission overrides:
+ * - null/missing key → use defaultGranted from manifest
+ * - true → explicitly granted
+ * - false → explicitly revoked
+ */
+export declare class TenantAgent extends SmrtObject {
+    tenantId: string;
+    /** Canonical agent type (qualified name when available) */
+    agentClass: string;
+    /** Status of the agent for this tenant */
+    status: TenantAgentStatus;
+    /** Explicit permission overrides (JSON). null = use manifest defaults */
+    permissions: Record<string, boolean> | null;
+    /**
+     * Tenant-level agent config overrides (JSON).
+     *
+     * Sensitive (S5 #1398): like {@link AgentConfig.configData} and
+     * {@link AgentSchedule.agentConfig} (both marked sensitive in #1540), these
+     * per-tenant override blobs routinely carry API keys/credentials. Exclude
+     * them from generated API/MCP responses and reject them as a `where` filter
+     * key. Server-side helpers (e.g. `serializeResolvedAgent`) still read the
+     * property directly, so the admin dashboard flow is unaffected.
+     */
+    config: Record<string, any> | null;
+}
+/**
+ * Collection for managing tenant-agent bindings
+ */
+export declare class TenantAgentCollection extends SmrtCollection<TenantAgent> {
+    static readonly _itemClass: typeof TenantAgent;
+    /**
+     * Resolve agent availability for a tenant, walking up the hierarchy.
+     *
+     * Algorithm:
+     * 1. Load explicit entries for this tenant
+     * 2. Build result map from explicit entries (source = 'explicit')
+     * 3. Merge permissions: manifest defaults overridden by explicit permissions
+     * 4. Get tenant's ancestors via hierarchyPath (immediate parent → root)
+     * 5. For each ancestor, add inherited agents not already resolved
+     * 6. Return only agents that appear somewhere in the hierarchy
+     *
+     * @param tenantId - The tenant to resolve for
+     * @param getAncestorIds - Function that returns ancestor tenant IDs (parent → root order)
+     * @param manifests - Map of agent class name to AgentManifestInfo
+     */
+    resolveForTenant(tenantId: string, getAncestorIds: (tenantId: string) => Promise<string[]>, manifests?: Map<string, AgentManifestInfo>): Promise<ResolvedAgentAvailability[]>;
+    /**
+     * Enable an agent for a tenant (creates or updates binding)
+     */
+    enableAgent(tenantId: string, agentClass: string): Promise<TenantAgent>;
+    /**
+     * Disable an agent for a tenant
+     */
+    disableAgent(tenantId: string, agentClass: string): Promise<TenantAgent>;
+    /**
+     * Remove explicit override, falling back to inheritance
+     */
+    clearOverride(tenantId: string, agentClass: string): Promise<void>;
+    /**
+     * Set permission overrides for a tenant's agent binding
+     */
+    setPermissions(tenantId: string, agentClass: string, permissions: Record<string, boolean>): Promise<TenantAgent>;
+    /**
+     * Find a tenant-agent binding by tenant and agent class
+     */
+    findByTenantAndClass(tenantId: string, agentClass: string): Promise<TenantAgent | null>;
+    private normalizeStoredAgentClass;
+    private persistCanonicalAgentClass;
+}
+//# sourceMappingURL=tenant-agent.d.ts.map

package/dist/tenant-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-agent.d.ts","sourceRoot":"","sources":["../src/tenant-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAOlC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAUtD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IACjC,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,qBAQa,WAAY,SAAQ,UAAU;IAEzC,QAAQ,EAAE,MAAM,CAAM;IAEtB,2DAA2D;IAE3D,UAAU,EAAE,MAAM,CAAM;IAExB,0CAA0C;IAE1C,MAAM,EAAE,iBAAiB,CAAY;IAErC,yEAAyE;IAEzE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAQ;IAEnD;;;;;;;;;OASG;IAEH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAQ;CAC3C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAe;IAEzC;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,EACvD,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACzC,OAAO,CAAC,yBAAyB,EAAE,CAAC;IA+DvC;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC;IAkBvB;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC;IAkBvB;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxE;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,WAAW,CAAC;IAmBvB;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;YAsBhB,yBAAyB;YAQzB,0BAA0B;CAqBzC"}

package/dist/types.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Agent status type
+ */
+export type AgentStatusType = 'idle' | 'initializing' | 'running' | 'error' | 'shutdown';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,cAAc,GACd,SAAS,GACT,OAAO,GACP,UAAU,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/ui.d.ts

@@ -0,0 +1,298 @@
+import { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
+/**
+ * UI type definitions for SMRT Agents
+ *
+ * These types allow agents to declare admin panel UI slots
+ * that can be implemented as Svelte components in agent packages.
+ *
+ * @example
+ * ```typescript
+ * import { AgentUIRegistry, type AdminPanelBaseProps } from '@happyvertical/smrt-agents/ui';
+ *
+ * // In agent package: register components at import time
+ * AgentUIRegistry.register('MyAgent', 'settings', SettingsPanel);
+ *
+ * // In host app: use registered components
+ * const Component = AgentUIRegistry.get('MyAgent', 'settings');
+ * ```
+ */
+/**
+ * Svelte component type (compatible with svelte's ComponentType)
+ *
+ * Using a generic function type to avoid requiring svelte as a dependency
+ * and to avoid DOM type references that don't exist in Node.js builds.
+ *
+ * In practice, the actual Svelte component will be passed and used
+ * with `<svelte:component this={Component} />` in SvelteKit apps.
+ */
+export type ComponentType<Props = any> = (...args: any[]) => any;
+/**
+ * Base props that all admin panel components receive
+ */
+export interface AdminPanelBaseProps<TConfig = unknown> {
+    /** Current configuration from the agent (merged file + db) */
+    config: TConfig;
+    /** Callback to save configuration changes */
+    onSave: (config: TConfig) => Promise<void>;
+    /** Whether the panel is in read-only mode */
+    readonly?: boolean;
+    /** CSS class for styling integration */
+    class?: string;
+    /**
+     * Read-only file-based configuration defaults (from smrt.config.js)
+     * Use this to display which values come from the config file
+     */
+    fileConfig?: TConfig;
+    /**
+     * Editable database-persisted configuration overrides
+     * Use this to display which values have been customized in the DB
+     */
+    dbConfig?: TConfig;
+}
+/**
+ * Definition of a UI slot that an agent declares
+ *
+ * Agents define slots they support; UI packages implement them.
+ */
+export interface AgentUISlot {
+    /** Unique identifier for this slot (e.g., 'sources', 'reports', 'settings') */
+    id: string;
+    /** Human-readable label for the slot */
+    label: string;
+    /** Description of what this panel configures */
+    description?: string;
+    /** Icon identifier (e.g., 'settings', 'database', 'users') */
+    icon?: string;
+    /** Display order (lower numbers first) */
+    order?: number;
+    /** Whether the slot is currently unavailable in the admin UI */
+    disabled?: boolean;
+}
+/**
+ * Map of slot IDs to their definitions
+ * Used as static property on Agent subclasses
+ */
+export type AgentUISlots = Record<string, AgentUISlot>;
+/**
+ * A route an agent provides for its admin UI
+ *
+ * Agents declare these so that host applications or tooling
+ * (for example, a Vite plugin) can wire them into a SvelteKit app.
+ *
+ * @example
+ * ```typescript
+ * static adminRoutes: AgentAdminRoute[] = [
+ *   { path: 'sources', component: 'SourcesPanel', load: 'loadSources' },
+ *   { path: 'sources/[sourceId]', component: 'SourceDetail', load: 'loadSourceDetail' },
+ * ];
+ * ```
+ */
+export interface AgentAdminRoute {
+    /** Route path relative to agent root (e.g., 'sources/[sourceId]') */
+    path: string;
+    /** Component export name from the agent's admin entry point */
+    component: string;
+    /** Optional: export name for server load function */
+    load?: string;
+}
+/**
+ * Context passed to agent route load functions
+ *
+ * A normalized subset of SvelteKit's ServerLoadEvent,
+ * so agent load functions don't need a direct SvelteKit dependency.
+ */
+export interface AgentRouteLoadContext {
+    params: Record<string, string>;
+    parent: () => Promise<any>;
+    fetch: typeof fetch;
+    url: URL;
+}
+/**
+ * Agent route load function signature
+ *
+ * Returned data is spread into the page's `data` prop.
+ */
+export type AgentRouteLoadFn = (context: AgentRouteLoadContext) => Promise<Record<string, unknown>> | Record<string, unknown>;
+/**
+ * Agent manifest type (re-exported from smrt-core scanner types)
+ * Duplicated here to avoid hard dependency on scanner internals
+ */
+export interface AgentManifestInfo {
+    name: string;
+    slug: string;
+    icon?: string;
+    tier: 'free' | 'standard' | 'premium';
+    description?: string;
+    uiSlots: Record<string, AgentUISlot>;
+    adminRoutes?: AgentAdminRoute[];
+    /** Default signal subscriptions declared by this agent */
+    signalSubscriptions?: string[];
+    permissions: Array<{
+        id: string;
+        label: string;
+        category: string;
+        defaultGranted?: boolean;
+    }>;
+    features: Array<{
+        id: string;
+        label: string;
+        description?: string;
+        type: string;
+    }>;
+    menuItems: Array<{
+        id: string;
+        label: string;
+        icon?: string;
+        order: number;
+        path: string;
+        requiredPermission?: string;
+    }>;
+    components: Array<{
+        exportPath: string;
+        type: string;
+    }>;
+}
+/**
+ * Registry of UI component implementations
+ * Maps agent class name + slot ID to Svelte component
+ */
+export interface AgentUIComponentRegistry {
+    /** Register a component for an agent's slot */
+    register<TProps extends AdminPanelBaseProps>(agentClass: string, slotId: string, component: ComponentType<TProps>): void;
+    /** Get a component for an agent's slot */
+    get<TProps extends AdminPanelBaseProps>(agentClass: string, slotId: string): ComponentType<TProps> | undefined;
+    /** Get all registered slot IDs for an agent */
+    getSlots(agentClass: string): string[];
+    /** Check if a component is registered */
+    has(agentClass: string, slotId: string): boolean;
+    /** Get all registered agent class names */
+    getAgents(): string[];
+    /** Unregister a component (useful for testing) */
+    unregister(agentClass: string, slotId: string): boolean;
+    /** Clear all registrations (useful for testing) */
+    clear(): void;
+    /** Register a component by composite key (e.g., 'praeco:sources') */
+    registerByKey(key: string, component: ComponentType): void;
+    /** Get a component by composite key */
+    getByKey(key: string): ComponentType | undefined;
+    /** Register an agent manifest for runtime access */
+    registerManifest(agentClass: string, manifest: AgentManifestInfo): void;
+    /** Get a registered agent manifest */
+    getManifest(agentClass: string): AgentManifestInfo | undefined;
+    /** Get all registered manifests */
+    getAllManifests(): Map<string, AgentManifestInfo>;
+    /** Register a route component for an agent */
+    registerRouteComponent(agentClass: string, path: string, component: ComponentType): void;
+    /** Get a route component for an agent */
+    getRouteComponent(agentClass: string, path: string): ComponentType | undefined;
+    /** Register a route load function for an agent */
+    registerRouteLoad(agentClass: string, path: string, loadFn: AgentRouteLoadFn): void;
+    /** Get a route load function for an agent */
+    getRouteLoad(agentClass: string, path: string): AgentRouteLoadFn | undefined;
+}
+/**
+ * Create a new UI component registry
+ *
+ * @example
+ * ```typescript
+ * const registry = createUIRegistry();
+ * registry.register('MyAgent', 'settings', SettingsPanel);
+ *
+ * const Component = registry.get('MyAgent', 'settings');
+ * if (Component) {
+ *   // Render component
+ * }
+ * ```
+ */
+export declare function createUIRegistry(): AgentUIComponentRegistry;
+/**
+ * Global UI registry singleton
+ *
+ * Agent UI packages register their components here at import time,
+ * enabling discovery by host applications.
+ *
+ * Uses a `globalThis.__smrtAgentUIRegistry` property to guarantee a
+ * single registry instance per JavaScript runtime, even when bundlers
+ * (Vite, webpack) duplicate this module across optimized dependency
+ * chunks or package versions.
+ *
+ * @example
+ * ```typescript
+ * // In agent package (e.g., @happyvertical/praeco/admin)
+ * import { AgentUIRegistry } from '@happyvertical/smrt-agents/ui';
+ * import SourcesPanel from './SourcesPanel.svelte';
+ *
+ * AgentUIRegistry.register('Praeco', 'sources', SourcesPanel);
+ *
+ * // In host SvelteKit app
+ * import { AgentUIRegistry } from '@happyvertical/smrt-agents/ui';
+ * import '@happyvertical/praeco/admin'; // Registers components
+ *
+ * const Component = AgentUIRegistry.get('Praeco', 'sources');
+ * ```
+ */
+declare global {
+    var __smrtAgentUIRegistry: AgentUIComponentRegistry | undefined;
+}
+export declare const AgentUIRegistry: AgentUIComponentRegistry;
+/**
+ * What an agent's `./admin` entry point must export.
+ *
+ * This is the contract between agent packages and host apps.
+ * Instead of registering individual slot components, agents export
+ * a single root component that handles its own sub-navigation.
+ *
+ * @example
+ * ```typescript
+ * // In agent package: histrio/src/ui/admin/index.ts
+ * export { default } from './AdminRoot.svelte';
+ * export { createAPIClient } from '../types.js';
+ * export const navItems: AgentAdminNavItem[] = [
+ *   { id: 'characters', label: 'Characters', icon: 'users', order: 1 },
+ *   { id: 'performers', label: 'Performers', icon: 'mic', order: 2 },
+ * ];
+ * ```
+ */
+export interface AgentAdminExport {
+    /** Root admin component — renders all panels, handles its own sub-navigation */
+    default?: ComponentType;
+    /** Create a typed API client for this agent */
+    createAPIClient?: (baseUrl: string) => unknown;
+    /** Navigation items for tabs/sidebar within the agent admin */
+    navItems?: AgentAdminNavItem[];
+}
+/**
+ * Props passed to the root admin component
+ */
+export interface AgentAdminRootProps {
+    /** Typed API client created by the agent's own factory */
+    apiClient: unknown;
+    /** Which panel to show (from URL hash, e.g., 'sources') */
+    activePanel?: string;
+    /** Called when user navigates within the agent */
+    onNavigate?: (panelId: string) => void;
+    /** Whether admin is in read-only mode */
+    readonly?: boolean;
+}
+/**
+ * Navigation item within an agent's admin UI
+ */
+export interface AgentAdminNavItem {
+    /** Matches hash fragment and panel ID */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Icon identifier */
+    icon?: string;
+    /** Display order (lower numbers first) */
+    order?: number;
+}
+/**
+ * Agents module UI slots (for ModuleUIRegistry)
+ */
+export declare const AGENTS_UI_SLOTS: Record<string, ModuleUISlot>;
+/**
+ * Agents module metadata
+ */
+export declare const AGENTS_MODULE_META: SmrtModuleMeta;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

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

package/dist/ui.js

@@ -0,0 +1,133 @@
+function createUIRegistry() {
+  const components = /* @__PURE__ */ new Map();
+  const manifests = /* @__PURE__ */ new Map();
+  const routeComponents = /* @__PURE__ */ new Map();
+  const routeLoads = /* @__PURE__ */ new Map();
+  const makeKey = (agentClass, slotId) => `${agentClass}:${slotId}`;
+  const makeRouteKey = (agentClass, path) => `${agentClass}:route:${path}`;
+  return {
+    register(agentClass, slotId, component) {
+      components.set(makeKey(agentClass, slotId), component);
+    },
+    get(agentClass, slotId) {
+      return components.get(makeKey(agentClass, slotId));
+    },
+    getSlots(agentClass) {
+      const prefix = `${agentClass}:`;
+      return Array.from(components.keys()).filter((k) => k.startsWith(prefix)).map((k) => k.slice(prefix.length));
+    },
+    has(agentClass, slotId) {
+      return components.has(makeKey(agentClass, slotId));
+    },
+    getAgents() {
+      const agents = /* @__PURE__ */ new Set();
+      for (const key of components.keys()) {
+        const agentClass = key.split(":")[0];
+        agents.add(agentClass);
+      }
+      return Array.from(agents);
+    },
+    unregister(agentClass, slotId) {
+      return components.delete(makeKey(agentClass, slotId));
+    },
+    clear() {
+      components.clear();
+      manifests.clear();
+      routeComponents.clear();
+      routeLoads.clear();
+    },
+    registerByKey(key, component) {
+      components.set(key, component);
+    },
+    getByKey(key) {
+      return components.get(key);
+    },
+    registerManifest(agentClass, manifest) {
+      manifests.set(agentClass, manifest);
+    },
+    getManifest(agentClass) {
+      return manifests.get(agentClass);
+    },
+    getAllManifests() {
+      return new Map(manifests);
+    },
+    registerRouteComponent(agentClass, path, component) {
+      routeComponents.set(makeRouteKey(agentClass, path), component);
+    },
+    getRouteComponent(agentClass, path) {
+      return routeComponents.get(makeRouteKey(agentClass, path));
+    },
+    registerRouteLoad(agentClass, path, loadFn) {
+      routeLoads.set(makeRouteKey(agentClass, path), loadFn);
+    },
+    getRouteLoad(agentClass, path) {
+      return routeLoads.get(makeRouteKey(agentClass, path));
+    }
+  };
+}
+if (!globalThis.__smrtAgentUIRegistry) {
+  globalThis.__smrtAgentUIRegistry = createUIRegistry();
+}
+const AgentUIRegistry = globalThis.__smrtAgentUIRegistry;
+const AGENTS_UI_SLOTS = {
+  "agent-dashboard": {
+    id: "agent-dashboard",
+    label: "Agent Dashboard",
+    description: "Combined overview panel for agent schedules",
+    icon: "activity",
+    category: "admin",
+    order: 1,
+    propsInterface: "AgentDashboardProps"
+  },
+  "agent-schedule-list": {
+    id: "agent-schedule-list",
+    label: "Agent Schedule List",
+    description: "List of scheduled agents",
+    icon: "calendar",
+    category: "list",
+    order: 2,
+    propsInterface: "AgentScheduleListProps"
+  },
+  "agent-schedule-form": {
+    id: "agent-schedule-form",
+    label: "Agent Schedule Form",
+    description: "Form for creating or editing agent schedules",
+    icon: "edit",
+    category: "form",
+    order: 3,
+    propsInterface: "AgentScheduleFormProps"
+  },
+  "agent-run-history": {
+    id: "agent-run-history",
+    label: "Agent Run History",
+    description: "History of agent runs",
+    icon: "clock",
+    category: "list",
+    order: 4,
+    propsInterface: "AgentRunHistoryProps"
+  },
+  "schedule-status-badge": {
+    id: "schedule-status-badge",
+    label: "Schedule Status Badge",
+    description: "Status indicator for schedule states",
+    icon: "tag",
+    category: "display",
+    order: 5,
+    propsInterface: "ScheduleStatusBadgeProps"
+  }
+};
+const AGENTS_MODULE_META = {
+  name: "@happyvertical/smrt-agents",
+  displayName: "Agents",
+  description: "Agent framework for building autonomous actors",
+  uiSlots: AGENTS_UI_SLOTS,
+  models: ["Agent", "AgentSchedule", "AgentRun"],
+  collections: ["AgentCollection", "AgentScheduleCollection"]
+};
+export {
+  AGENTS_MODULE_META,
+  AGENTS_UI_SLOTS,
+  AgentUIRegistry,
+  createUIRegistry
+};
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sources":["../src/ui.ts"],"sourcesContent":["import type { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';\n\n/**\n * UI type definitions for SMRT Agents\n *\n * These types allow agents to declare admin panel UI slots\n * that can be implemented as Svelte components in agent packages.\n *\n * @example\n * ```typescript\n * import { AgentUIRegistry, type AdminPanelBaseProps } from '@happyvertical/smrt-agents/ui';\n *\n * // In agent package: register components at import time\n * AgentUIRegistry.register('MyAgent', 'settings', SettingsPanel);\n *\n * // In host app: use registered components\n * const Component = AgentUIRegistry.get('MyAgent', 'settings');\n * ```\n */\n\n/**\n * Svelte component type (compatible with svelte's ComponentType)\n *\n * Using a generic function type to avoid requiring svelte as a dependency\n * and to avoid DOM type references that don't exist in Node.js builds.\n *\n * In practice, the actual Svelte component will be passed and used\n * with `<svelte:component this={Component} />` in SvelteKit apps.\n */\nexport type ComponentType<Props = any> = (...args: any[]) => any;\n\n/**\n * Base props that all admin panel components receive\n */\nexport interface AdminPanelBaseProps<TConfig = unknown> {\n  /** Current configuration from the agent (merged file + db) */\n  config: TConfig;\n  /** Callback to save configuration changes */\n  onSave: (config: TConfig) => Promise<void>;\n  /** Whether the panel is in read-only mode */\n  readonly?: boolean;\n  /** CSS class for styling integration */\n  class?: string;\n  /**\n   * Read-only file-based configuration defaults (from smrt.config.js)\n   * Use this to display which values come from the config file\n   */\n  fileConfig?: TConfig;\n  /**\n   * Editable database-persisted configuration overrides\n   * Use this to display which values have been customized in the DB\n   */\n  dbConfig?: TConfig;\n}\n\n/**\n * Definition of a UI slot that an agent declares\n *\n * Agents define slots they support; UI packages implement them.\n */\nexport interface AgentUISlot {\n  /** Unique identifier for this slot (e.g., 'sources', 'reports', 'settings') */\n  id: string;\n  /** Human-readable label for the slot */\n  label: string;\n  /** Description of what this panel configures */\n  description?: string;\n  /** Icon identifier (e.g., 'settings', 'database', 'users') */\n  icon?: string;\n  /** Display order (lower numbers first) */\n  order?: number;\n  /** Whether the slot is currently unavailable in the admin UI */\n  disabled?: boolean;\n}\n\n/**\n * Map of slot IDs to their definitions\n * Used as static property on Agent subclasses\n */\nexport type AgentUISlots = Record<string, AgentUISlot>;\n\n/**\n * A route an agent provides for its admin UI\n *\n * Agents declare these so that host applications or tooling\n * (for example, a Vite plugin) can wire them into a SvelteKit app.\n *\n * @example\n * ```typescript\n * static adminRoutes: AgentAdminRoute[] = [\n *   { path: 'sources', component: 'SourcesPanel', load: 'loadSources' },\n *   { path: 'sources/[sourceId]', component: 'SourceDetail', load: 'loadSourceDetail' },\n * ];\n * ```\n */\nexport interface AgentAdminRoute {\n  /** Route path relative to agent root (e.g., 'sources/[sourceId]') */\n  path: string;\n  /** Component export name from the agent's admin entry point */\n  component: string;\n  /** Optional: export name for server load function */\n  load?: string;\n}\n\n/**\n * Context passed to agent route load functions\n *\n * A normalized subset of SvelteKit's ServerLoadEvent,\n * so agent load functions don't need a direct SvelteKit dependency.\n */\nexport interface AgentRouteLoadContext {\n  params: Record<string, string>;\n  parent: () => Promise<any>;\n  fetch: typeof fetch;\n  url: URL;\n}\n\n/**\n * Agent route load function signature\n *\n * Returned data is spread into the page's `data` prop.\n */\nexport type AgentRouteLoadFn = (\n  context: AgentRouteLoadContext,\n) => Promise<Record<string, unknown>> | Record<string, unknown>;\n\n/**\n * Agent manifest type (re-exported from smrt-core scanner types)\n * Duplicated here to avoid hard dependency on scanner internals\n */\nexport interface AgentManifestInfo {\n  name: string;\n  slug: string;\n  icon?: string;\n  tier: 'free' | 'standard' | 'premium';\n  description?: string;\n  uiSlots: Record<string, AgentUISlot>;\n  adminRoutes?: AgentAdminRoute[];\n  /** Default signal subscriptions declared by this agent */\n  signalSubscriptions?: string[];\n  permissions: Array<{\n    id: string;\n    label: string;\n    category: string;\n    defaultGranted?: boolean;\n  }>;\n  features: Array<{\n    id: string;\n    label: string;\n    description?: string;\n    type: string;\n  }>;\n  menuItems: Array<{\n    id: string;\n    label: string;\n    icon?: string;\n    order: number;\n    path: string;\n    requiredPermission?: string;\n  }>;\n  components: Array<{ exportPath: string; type: string }>;\n}\n\n/**\n * Registry of UI component implementations\n * Maps agent class name + slot ID to Svelte component\n */\nexport interface AgentUIComponentRegistry {\n  /** Register a component for an agent's slot */\n  register<TProps extends AdminPanelBaseProps>(\n    agentClass: string,\n    slotId: string,\n    component: ComponentType<TProps>,\n  ): void;\n\n  /** Get a component for an agent's slot */\n  get<TProps extends AdminPanelBaseProps>(\n    agentClass: string,\n    slotId: string,\n  ): ComponentType<TProps> | undefined;\n\n  /** Get all registered slot IDs for an agent */\n  getSlots(agentClass: string): string[];\n\n  /** Check if a component is registered */\n  has(agentClass: string, slotId: string): boolean;\n\n  /** Get all registered agent class names */\n  getAgents(): string[];\n\n  /** Unregister a component (useful for testing) */\n  unregister(agentClass: string, slotId: string): boolean;\n\n  /** Clear all registrations (useful for testing) */\n  clear(): void;\n\n  /** Register a component by composite key (e.g., 'praeco:sources') */\n  registerByKey(key: string, component: ComponentType): void;\n\n  /** Get a component by composite key */\n  getByKey(key: string): ComponentType | undefined;\n\n  /** Register an agent manifest for runtime access */\n  registerManifest(agentClass: string, manifest: AgentManifestInfo): void;\n\n  /** Get a registered agent manifest */\n  getManifest(agentClass: string): AgentManifestInfo | undefined;\n\n  /** Get all registered manifests */\n  getAllManifests(): Map<string, AgentManifestInfo>;\n\n  /** Register a route component for an agent */\n  registerRouteComponent(\n    agentClass: string,\n    path: string,\n    component: ComponentType,\n  ): void;\n\n  /** Get a route component for an agent */\n  getRouteComponent(\n    agentClass: string,\n    path: string,\n  ): ComponentType | undefined;\n\n  /** Register a route load function for an agent */\n  registerRouteLoad(\n    agentClass: string,\n    path: string,\n    loadFn: AgentRouteLoadFn,\n  ): void;\n\n  /** Get a route load function for an agent */\n  getRouteLoad(agentClass: string, path: string): AgentRouteLoadFn | undefined;\n}\n\n/**\n * Create a new UI component registry\n *\n * @example\n * ```typescript\n * const registry = createUIRegistry();\n * registry.register('MyAgent', 'settings', SettingsPanel);\n *\n * const Component = registry.get('MyAgent', 'settings');\n * if (Component) {\n *   // Render component\n * }\n * ```\n */\nexport function createUIRegistry(): AgentUIComponentRegistry {\n  const components = new Map<string, ComponentType<any>>();\n  const manifests = new Map<string, AgentManifestInfo>();\n  const routeComponents = new Map<string, ComponentType>();\n  const routeLoads = new Map<string, AgentRouteLoadFn>();\n\n  const makeKey = (agentClass: string, slotId: string) =>\n    `${agentClass}:${slotId}`;\n\n  const makeRouteKey = (agentClass: string, path: string) =>\n    `${agentClass}:route:${path}`;\n\n  return {\n    register(agentClass, slotId, component) {\n      components.set(makeKey(agentClass, slotId), component);\n    },\n\n    get(agentClass, slotId) {\n      return components.get(makeKey(agentClass, slotId));\n    },\n\n    getSlots(agentClass) {\n      const prefix = `${agentClass}:`;\n      return Array.from(components.keys())\n        .filter((k) => k.startsWith(prefix))\n        .map((k) => k.slice(prefix.length));\n    },\n\n    has(agentClass, slotId) {\n      return components.has(makeKey(agentClass, slotId));\n    },\n\n    getAgents() {\n      const agents = new Set<string>();\n      for (const key of components.keys()) {\n        const agentClass = key.split(':')[0];\n        agents.add(agentClass);\n      }\n      return Array.from(agents);\n    },\n\n    unregister(agentClass, slotId) {\n      return components.delete(makeKey(agentClass, slotId));\n    },\n\n    clear() {\n      components.clear();\n      manifests.clear();\n      routeComponents.clear();\n      routeLoads.clear();\n    },\n\n    registerByKey(key, component) {\n      components.set(key, component);\n    },\n\n    getByKey(key) {\n      return components.get(key);\n    },\n\n    registerManifest(agentClass, manifest) {\n      manifests.set(agentClass, manifest);\n    },\n\n    getManifest(agentClass) {\n      return manifests.get(agentClass);\n    },\n\n    getAllManifests() {\n      return new Map(manifests);\n    },\n\n    registerRouteComponent(agentClass, path, component) {\n      routeComponents.set(makeRouteKey(agentClass, path), component);\n    },\n\n    getRouteComponent(agentClass, path) {\n      return routeComponents.get(makeRouteKey(agentClass, path));\n    },\n\n    registerRouteLoad(agentClass, path, loadFn) {\n      routeLoads.set(makeRouteKey(agentClass, path), loadFn);\n    },\n\n    getRouteLoad(agentClass, path) {\n      return routeLoads.get(makeRouteKey(agentClass, path));\n    },\n  };\n}\n\n/**\n * Global UI registry singleton\n *\n * Agent UI packages register their components here at import time,\n * enabling discovery by host applications.\n *\n * Uses a `globalThis.__smrtAgentUIRegistry` property to guarantee a\n * single registry instance per JavaScript runtime, even when bundlers\n * (Vite, webpack) duplicate this module across optimized dependency\n * chunks or package versions.\n *\n * @example\n * ```typescript\n * // In agent package (e.g., @happyvertical/praeco/admin)\n * import { AgentUIRegistry } from '@happyvertical/smrt-agents/ui';\n * import SourcesPanel from './SourcesPanel.svelte';\n *\n * AgentUIRegistry.register('Praeco', 'sources', SourcesPanel);\n *\n * // In host SvelteKit app\n * import { AgentUIRegistry } from '@happyvertical/smrt-agents/ui';\n * import '@happyvertical/praeco/admin'; // Registers components\n *\n * const Component = AgentUIRegistry.get('Praeco', 'sources');\n * ```\n */\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __smrtAgentUIRegistry: AgentUIComponentRegistry | undefined;\n}\n\nif (!globalThis.__smrtAgentUIRegistry) {\n  globalThis.__smrtAgentUIRegistry = createUIRegistry();\n}\nexport const AgentUIRegistry: AgentUIComponentRegistry =\n  globalThis.__smrtAgentUIRegistry;\n\n/**\n * What an agent's `./admin` entry point must export.\n *\n * This is the contract between agent packages and host apps.\n * Instead of registering individual slot components, agents export\n * a single root component that handles its own sub-navigation.\n *\n * @example\n * ```typescript\n * // In agent package: histrio/src/ui/admin/index.ts\n * export { default } from './AdminRoot.svelte';\n * export { createAPIClient } from '../types.js';\n * export const navItems: AgentAdminNavItem[] = [\n *   { id: 'characters', label: 'Characters', icon: 'users', order: 1 },\n *   { id: 'performers', label: 'Performers', icon: 'mic', order: 2 },\n * ];\n * ```\n */\nexport interface AgentAdminExport {\n  /** Root admin component — renders all panels, handles its own sub-navigation */\n  default?: ComponentType;\n  /** Create a typed API client for this agent */\n  createAPIClient?: (baseUrl: string) => unknown;\n  /** Navigation items for tabs/sidebar within the agent admin */\n  navItems?: AgentAdminNavItem[];\n}\n\n/**\n * Props passed to the root admin component\n */\nexport interface AgentAdminRootProps {\n  /** Typed API client created by the agent's own factory */\n  apiClient: unknown;\n  /** Which panel to show (from URL hash, e.g., 'sources') */\n  activePanel?: string;\n  /** Called when user navigates within the agent */\n  onNavigate?: (panelId: string) => void;\n  /** Whether admin is in read-only mode */\n  readonly?: boolean;\n}\n\n/**\n * Navigation item within an agent's admin UI\n */\nexport interface AgentAdminNavItem {\n  /** Matches hash fragment and panel ID */\n  id: string;\n  /** Display label */\n  label: string;\n  /** Icon identifier */\n  icon?: string;\n  /** Display order (lower numbers first) */\n  order?: number;\n}\n\n/**\n * Agents module UI slots (for ModuleUIRegistry)\n */\nexport const AGENTS_UI_SLOTS: Record<string, ModuleUISlot> = {\n  'agent-dashboard': {\n    id: 'agent-dashboard',\n    label: 'Agent Dashboard',\n    description: 'Combined overview panel for agent schedules',\n    icon: 'activity',\n    category: 'admin',\n    order: 1,\n    propsInterface: 'AgentDashboardProps',\n  },\n  'agent-schedule-list': {\n    id: 'agent-schedule-list',\n    label: 'Agent Schedule List',\n    description: 'List of scheduled agents',\n    icon: 'calendar',\n    category: 'list',\n    order: 2,\n    propsInterface: 'AgentScheduleListProps',\n  },\n  'agent-schedule-form': {\n    id: 'agent-schedule-form',\n    label: 'Agent Schedule Form',\n    description: 'Form for creating or editing agent schedules',\n    icon: 'edit',\n    category: 'form',\n    order: 3,\n    propsInterface: 'AgentScheduleFormProps',\n  },\n  'agent-run-history': {\n    id: 'agent-run-history',\n    label: 'Agent Run History',\n    description: 'History of agent runs',\n    icon: 'clock',\n    category: 'list',\n    order: 4,\n    propsInterface: 'AgentRunHistoryProps',\n  },\n  'schedule-status-badge': {\n    id: 'schedule-status-badge',\n    label: 'Schedule Status Badge',\n    description: 'Status indicator for schedule states',\n    icon: 'tag',\n    category: 'display',\n    order: 5,\n    propsInterface: 'ScheduleStatusBadgeProps',\n  },\n};\n\n/**\n * Agents module metadata\n */\nexport const AGENTS_MODULE_META: SmrtModuleMeta = {\n  name: '@happyvertical/smrt-agents',\n  displayName: 'Agents',\n  description: 'Agent framework for building autonomous actors',\n  uiSlots: AGENTS_UI_SLOTS,\n  models: ['Agent', 'AgentSchedule', 'AgentRun'],\n  collections: ['AgentCollection', 'AgentScheduleCollection'],\n};\n"],"names":[],"mappings":"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"}