@happyvertical/smrt-agents 0.30.0

package/dist/playground.d.ts

@@ -0,0 +1,2 @@
+export { default } from './svelte/playground.js';
+//# sourceMappingURL=playground.d.ts.map

package/dist/playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../src/playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/playground.js

@@ -0,0 +1,156 @@
+import { AGENTS_MODULE_META } from "./ui.js";
+const noop = () => {
+};
+const sampleSchedules = [
+  {
+    id: "schedule-digest",
+    agentType: "DailyDigestAgent",
+    agentId: "digest-western",
+    agentConfig: { region: "western-canada" },
+    cron: "0 7 * * *",
+    timezone: "America/Edmonton",
+    enabled: true,
+    status: "active",
+    lastRun: "2026-03-21T13:00:00.000Z",
+    nextRun: "2026-03-22T13:00:00.000Z",
+    lastStatus: "success",
+    lastError: null,
+    runCount: 184,
+    successCount: 179,
+    failureCount: 5,
+    maxConcurrent: 1,
+    runningCount: 0,
+    timeout: 18e5,
+    method: "run",
+    methodArgs: {},
+    createdAt: "2026-01-04T17:00:00.000Z",
+    updatedAt: "2026-03-21T13:02:00.000Z"
+  },
+  {
+    id: "schedule-governance",
+    agentType: "GovernanceWatchAgent",
+    agentId: null,
+    agentConfig: { profileKey: "publication" },
+    cron: "*/30 * * * *",
+    timezone: "UTC",
+    enabled: true,
+    status: "error",
+    lastRun: "2026-03-21T16:00:00.000Z",
+    nextRun: "2026-03-21T16:30:00.000Z",
+    lastStatus: "failed",
+    lastError: "Readiness sync failed for one assignment.",
+    runCount: 928,
+    successCount: 901,
+    failureCount: 27,
+    maxConcurrent: 2,
+    runningCount: 1,
+    timeout: 9e5,
+    method: "reconcile",
+    methodArgs: { backfill: false },
+    createdAt: "2026-02-09T10:10:00.000Z",
+    updatedAt: "2026-03-21T16:01:11.000Z"
+  }
+];
+const sampleHistory = [
+  {
+    id: "run-1",
+    scheduleId: "schedule-governance",
+    agentType: "GovernanceWatchAgent",
+    status: "failed",
+    startedAt: "2026-03-21T16:00:00.000Z",
+    completedAt: "2026-03-21T16:01:11.000Z",
+    duration: 71e3,
+    error: "One assignment was missing readiness metadata."
+  },
+  {
+    id: "run-2",
+    scheduleId: "schedule-digest",
+    agentType: "DailyDigestAgent",
+    status: "success",
+    startedAt: "2026-03-21T13:00:00.000Z",
+    completedAt: "2026-03-21T13:00:18.000Z",
+    duration: 18e3,
+    error: null
+  }
+];
+const loadAgentDashboard = () => import("./svelte/components/AgentDashboard.svelte");
+const loadAgentRunHistory = () => import("./svelte/components/AgentRunHistory.svelte");
+const loadAgentScheduleForm = () => import("./svelte/components/AgentScheduleForm.svelte");
+const playground = {
+  packageName: "@happyvertical/smrt-agents",
+  displayName: AGENTS_MODULE_META.displayName,
+  description: AGENTS_MODULE_META.description,
+  moduleMeta: AGENTS_MODULE_META,
+  entries: [
+    {
+      id: "agent-dashboard",
+      title: "Agent Dashboard",
+      description: "Overview of active schedules, run health, and recent execution history.",
+      loadComponent: loadAgentDashboard,
+      order: 1,
+      props: {
+        schedules: sampleSchedules,
+        recentHistory: sampleHistory,
+        onScheduleClick: noop,
+        onEnable: noop,
+        onDisable: noop,
+        onDelete: noop,
+        onRunNow: noop,
+        onCreateSchedule: noop,
+        onHistoryEntryClick: noop
+      },
+      modes: {
+        mock: {
+          label: "Mock"
+        }
+      }
+    },
+    {
+      id: "agent-schedule-form",
+      title: "Agent Schedule Form",
+      description: "Configuration form for a scheduled agent run, with presets and execution controls.",
+      loadComponent: loadAgentScheduleForm,
+      order: 2,
+      props: {
+        initialData: {
+          agentType: "GovernanceWatchAgent",
+          cron: "*/30 * * * *",
+          timezone: "UTC",
+          enabled: true,
+          maxConcurrent: 2,
+          timeout: 9e5,
+          method: "reconcile"
+        },
+        agentTypes: ["DailyDigestAgent", "GovernanceWatchAgent", "ExportAgent"],
+        onSubmit: noop,
+        onCancel: noop,
+        editMode: true
+      },
+      modes: {
+        mock: {
+          label: "Mock"
+        }
+      }
+    },
+    {
+      id: "agent-run-history",
+      title: "Agent Run History",
+      description: "Execution history table for recent schedule runs and failures.",
+      loadComponent: loadAgentRunHistory,
+      order: 3,
+      props: {
+        history: sampleHistory,
+        onEntryClick: noop
+      },
+      modes: {
+        mock: {
+          label: "Mock"
+        }
+      }
+    }
+  ]
+};
+export {
+  playground as default
+};
+//# sourceMappingURL=playground.js.map

package/dist/playground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.js","sources":["../src/svelte/playground.ts"],"sourcesContent":["import { AGENTS_MODULE_META } from '../ui.js';\n\nconst noop = () => {};\n\nconst sampleSchedules = [\n  {\n    id: 'schedule-digest',\n    agentType: 'DailyDigestAgent',\n    agentId: 'digest-western',\n    agentConfig: { region: 'western-canada' },\n    cron: '0 7 * * *',\n    timezone: 'America/Edmonton',\n    enabled: true,\n    status: 'active',\n    lastRun: '2026-03-21T13:00:00.000Z',\n    nextRun: '2026-03-22T13:00:00.000Z',\n    lastStatus: 'success',\n    lastError: null,\n    runCount: 184,\n    successCount: 179,\n    failureCount: 5,\n    maxConcurrent: 1,\n    runningCount: 0,\n    timeout: 1800000,\n    method: 'run',\n    methodArgs: {},\n    createdAt: '2026-01-04T17:00:00.000Z',\n    updatedAt: '2026-03-21T13:02:00.000Z',\n  },\n  {\n    id: 'schedule-governance',\n    agentType: 'GovernanceWatchAgent',\n    agentId: null,\n    agentConfig: { profileKey: 'publication' },\n    cron: '*/30 * * * *',\n    timezone: 'UTC',\n    enabled: true,\n    status: 'error',\n    lastRun: '2026-03-21T16:00:00.000Z',\n    nextRun: '2026-03-21T16:30:00.000Z',\n    lastStatus: 'failed',\n    lastError: 'Readiness sync failed for one assignment.',\n    runCount: 928,\n    successCount: 901,\n    failureCount: 27,\n    maxConcurrent: 2,\n    runningCount: 1,\n    timeout: 900000,\n    method: 'reconcile',\n    methodArgs: { backfill: false },\n    createdAt: '2026-02-09T10:10:00.000Z',\n    updatedAt: '2026-03-21T16:01:11.000Z',\n  },\n];\n\nconst sampleHistory = [\n  {\n    id: 'run-1',\n    scheduleId: 'schedule-governance',\n    agentType: 'GovernanceWatchAgent',\n    status: 'failed',\n    startedAt: '2026-03-21T16:00:00.000Z',\n    completedAt: '2026-03-21T16:01:11.000Z',\n    duration: 71000,\n    error: 'One assignment was missing readiness metadata.',\n  },\n  {\n    id: 'run-2',\n    scheduleId: 'schedule-digest',\n    agentType: 'DailyDigestAgent',\n    status: 'success',\n    startedAt: '2026-03-21T13:00:00.000Z',\n    completedAt: '2026-03-21T13:00:18.000Z',\n    duration: 18000,\n    error: null,\n  },\n];\n\nconst loadAgentDashboard = () => import('./components/AgentDashboard.svelte');\nconst loadAgentRunHistory = () => import('./components/AgentRunHistory.svelte');\nconst loadAgentScheduleForm = () =>\n  import('./components/AgentScheduleForm.svelte');\n\nexport default {\n  packageName: '@happyvertical/smrt-agents',\n  displayName: AGENTS_MODULE_META.displayName,\n  description: AGENTS_MODULE_META.description,\n  moduleMeta: AGENTS_MODULE_META,\n  entries: [\n    {\n      id: 'agent-dashboard',\n      title: 'Agent Dashboard',\n      description:\n        'Overview of active schedules, run health, and recent execution history.',\n      loadComponent: loadAgentDashboard,\n      order: 1,\n      props: {\n        schedules: sampleSchedules,\n        recentHistory: sampleHistory,\n        onScheduleClick: noop,\n        onEnable: noop,\n        onDisable: noop,\n        onDelete: noop,\n        onRunNow: noop,\n        onCreateSchedule: noop,\n        onHistoryEntryClick: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'agent-schedule-form',\n      title: 'Agent Schedule Form',\n      description:\n        'Configuration form for a scheduled agent run, with presets and execution controls.',\n      loadComponent: loadAgentScheduleForm,\n      order: 2,\n      props: {\n        initialData: {\n          agentType: 'GovernanceWatchAgent',\n          cron: '*/30 * * * *',\n          timezone: 'UTC',\n          enabled: true,\n          maxConcurrent: 2,\n          timeout: 900000,\n          method: 'reconcile',\n        },\n        agentTypes: ['DailyDigestAgent', 'GovernanceWatchAgent', 'ExportAgent'],\n        onSubmit: noop,\n        onCancel: noop,\n        editMode: true,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'agent-run-history',\n      title: 'Agent Run History',\n      description:\n        'Execution history table for recent schedule runs and failures.',\n      loadComponent: loadAgentRunHistory,\n      order: 3,\n      props: {\n        history: sampleHistory,\n        onEntryClick: noop,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n  ],\n};\n"],"names":[],"mappings":"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"}

package/dist/schedule.d.ts

@@ -0,0 +1,168 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * Status of a scheduled agent
+ */
+export type ScheduleStatus = 'active' | 'paused' | 'disabled' | 'error';
+/**
+ * AgentSchedule model for cron-based agent scheduling
+ *
+ * This extends SmrtObject to store schedule metadata in the SMRT database.
+ * Schedules are processed by the TaskRunner which creates jobs at scheduled times.
+ *
+ * @example
+ * ```typescript
+ * const schedule = new AgentSchedule({
+ *   agentType: 'Praeco',
+ *   agentId: 'praeco-main',
+ *   cron: '0 2 * * *', // Run at 2 AM daily
+ *   enabled: true,
+ * });
+ * await schedule.initialize();
+ * await schedule.save();
+ * ```
+ */
+export declare class AgentSchedule extends SmrtObject {
+    /**
+     * Tenant ID for multi-tenant isolation
+     * Nullable to support both tenant-scoped and global schedules
+     */
+    tenantId: string | null;
+    /** Canonical agent type to run (qualified name when available) */
+    agentType: string;
+    /** Optional agent instance ID (for running specific instances) */
+    agentId: string | null;
+    /**
+     * Agent configuration to pass when running.
+     *
+     * Sensitive (#1540): may carry API keys/credentials, so it is excluded from
+     * generated API/MCP responses and rejected as a `where` filter key.
+     */
+    agentConfig: Record<string, unknown>;
+    /** Cron expression (e.g., '0 2 * * *' for 2 AM daily) */
+    cron: string;
+    /** Timezone for cron interpretation (default: UTC) */
+    timezone: string;
+    /** Whether the schedule is enabled */
+    enabled: boolean;
+    /** Current schedule status */
+    status: ScheduleStatus;
+    /** Last time the agent was run */
+    lastRun: Date | null;
+    /** Next scheduled run time */
+    nextRun: Date | null;
+    /** Status of the last run */
+    lastStatus: 'success' | 'failed' | null;
+    /** Error message from last failed run */
+    lastError: string | null;
+    /** Total number of runs */
+    runCount: number;
+    /** Total number of successful runs */
+    successCount: number;
+    /** Total number of failed runs */
+    failureCount: number;
+    /** Maximum concurrent runs (prevent overlapping) */
+    maxConcurrent: number;
+    /** Current number of running instances */
+    runningCount: number;
+    /** Timeout for agent execution in milliseconds (default: 1 hour) */
+    timeout: number;
+    /** Method to call on the agent (default: 'run') */
+    method: string;
+    /** Arguments to pass to the method */
+    methodArgs: Record<string, unknown>;
+    /**
+     * Enable the schedule
+     */
+    enable(): Promise<void>;
+    /**
+     * Disable the schedule
+     */
+    disable(): Promise<void>;
+    /**
+     * Pause the schedule temporarily
+     */
+    pause(): Promise<void>;
+    /**
+     * Resume a paused schedule
+     */
+    resume(): Promise<void>;
+    /**
+     * Record a successful run
+     */
+    recordSuccess(): Promise<void>;
+    /**
+     * Record a failed run
+     */
+    recordFailure(error: string): Promise<void>;
+    /**
+     * Check if the schedule is due to run
+     */
+    isDue(): boolean;
+    /**
+     * Calculate the next run time based on cron expression
+     */
+    calculateNextRun(): void;
+    /**
+     * Get a human-readable description of the schedule
+     */
+    getDescription(): string;
+    /**
+     * Lifecycle hook - calculate next run on save
+     */
+    beforeSave(): Promise<void>;
+}
+/**
+ * Collection for managing AgentSchedule objects
+ */
+export declare class AgentScheduleCollection extends SmrtCollection<AgentSchedule> {
+    static readonly _itemClass: typeof AgentSchedule;
+    /**
+     * Find all schedules for a specific tenant
+     * @param tenantId - Tenant ID to filter by
+     * @returns Array of AgentSchedule objects for the tenant
+     */
+    findByTenant(tenantId: string): Promise<AgentSchedule[]>;
+    /**
+     * Find all global schedules (not associated with any tenant)
+     * @returns Array of global AgentSchedule objects
+     */
+    findGlobal(): Promise<AgentSchedule[]>;
+    /**
+     * Find schedules for a tenant including global schedules
+     * @param tenantId - Tenant ID to include
+     * @returns Array of AgentSchedule objects for the tenant and global schedules
+     */
+    findWithGlobals(tenantId: string): Promise<AgentSchedule[]>;
+    /**
+     * List schedules by status
+     */
+    listByStatus(status: ScheduleStatus | ScheduleStatus[], options?: {
+        limit?: number;
+    }): Promise<AgentSchedule[]>;
+    /**
+     * List schedules that are due to run
+     */
+    listDue(options?: {
+        limit?: number;
+    }): Promise<AgentSchedule[]>;
+    /**
+     * List schedules for a specific agent type
+     */
+    listByAgentType(agentType: string, options?: {
+        limit?: number;
+        includeDisabled?: boolean;
+    }): Promise<AgentSchedule[]>;
+    /**
+     * Get schedule statistics
+     */
+    stats(): Promise<{
+        total: number;
+        active: number;
+        paused: number;
+        disabled: number;
+        error: number;
+        dueNow: number;
+    }>;
+}
+export default AgentSchedule;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/schedule.d.ts.map

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

package/dist/server/action-types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Agent Action Handler Types
+ *
+ * Types for agent-specific action handlers that packages export via
+ * their `/actions` subpath. The dashboard dynamically imports these
+ * handlers and dispatches requests to them.
+ *
+ * @example
+ * ```typescript
+ * // In an agent package (e.g., @happyvertical/histrio/actions)
+ * import type { AgentActionMap, AgentActionContext } from '@happyvertical/smrt-agents/server';
+ *
+ * const referenceImage: AgentActionHandler = async (ctx) => {
+ *   const formData = await ctx.request.formData();
+ *   // ... process the upload
+ *   return Response.json({ data: result });
+ * };
+ *
+ * export const actions: AgentActionMap = {
+ *   'performers/reference-image': referenceImage,
+ * };
+ * ```
+ *
+ * @module @happyvertical/smrt-agents/server
+ */
+/**
+ * Context passed to an agent action handler.
+ *
+ * Handlers receive the raw Request and return a standard Response,
+ * so they can handle any content type (JSON, multipart, streaming)
+ * without the dashboard needing to know.
+ */
+export interface AgentActionContext {
+    /** Raw HTTP request (may be multipart, JSON, etc.) */
+    request: Request;
+    /** Resource path segment (e.g., 'performers') */
+    resourcePath: string;
+    /** Resource ID from URL */
+    id: string;
+    /** Action name from URL (e.g., 'reference-image') */
+    action: string;
+    /** Database configuration */
+    db: {
+        type: string;
+        url: string;
+    };
+    /** Current tenant ID */
+    tenantId: string;
+    /** Authenticated user ID */
+    userId?: string;
+    /** Agent instance UUID (from URL path) */
+    agentId: string;
+    /** Lazy-loaded service config from agent_configs table (slotId='services'). Cached per request. */
+    getServiceConfig: () => Promise<Record<string, unknown>>;
+    /** Retrieve a per-tenant encrypted secret by name */
+    getSecret: (name: string) => Promise<string | null>;
+}
+/** A single action handler function */
+export type AgentActionHandler = (ctx: AgentActionContext) => Promise<Response>;
+/**
+ * Map of action keys to handlers.
+ * Keys use the format '{resourcePath}/{action}' (e.g., 'performers/reference-image').
+ */
+export type AgentActionMap = Record<string, AgentActionHandler>;
+//# sourceMappingURL=action-types.d.ts.map

package/dist/server/action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-types.d.ts","sourceRoot":"","sources":["../../src/server/action-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,qDAAqD;IACrD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACrD;AAED,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC"}

package/dist/server/action-types.js

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

package/dist/server/action-types.js.map

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

package/dist/server/api-routes.d.ts

@@ -0,0 +1,57 @@
+import { PackageManifest } from './manifest-utils.js';
+/**
+ * Info about a single API route (one SmrtObject with api.include)
+ */
+export interface AgentAPIRouteInfo {
+    /** SmrtObject class name (e.g., 'Performer') */
+    className: string;
+    /** Allowed CRUD actions (e.g., ['list', 'get', 'create', 'update', 'delete']) */
+    allowedActions: string[];
+    /** Package that owns this resource */
+    packageName?: string;
+}
+/**
+ * Result of resolving a URL path against the route map
+ */
+export interface ResolvedAPIRoute {
+    /** The matched route info */
+    route: AgentAPIRouteInfo;
+    /** Resource ID if path includes one (e.g., 'performers/abc-123') */
+    id?: string;
+    /** Custom action name if path includes one (e.g., 'performers/abc-123/generate-image') */
+    action?: string;
+}
+/**
+ * Build a route map from loaded package manifests.
+ *
+ * Iterates all objects in each manifest, and for any object with a
+ * `decoratorConfig.api.include` array, registers a route. The route
+ * path is derived from `decoratorConfig.api.path` if set, otherwise
+ * from the table name with underscores converted to hyphens.
+ *
+ * @param manifests - Array of parsed package manifest JSON objects
+ * @returns Map of resource path -> route info
+ *
+ * @example
+ * ```typescript
+ * const manifests = [histrioManifest, praecoManifest];
+ * const routes = buildRouteMap(manifests);
+ * // routes.get('performers') => { className: 'Performer', allowedActions: ['list', 'get', 'create', 'update', 'delete'] }
+ * // routes.get('video-contents') => { className: 'VideoShot', allowedActions: ['list', 'get', 'create', 'update'] }
+ * ```
+ */
+export declare function buildRouteMap(manifests: PackageManifest[]): Map<string, AgentAPIRouteInfo>;
+/**
+ * Resolve a URL resource path against a route map.
+ *
+ * Handles three URL patterns:
+ * - `performers` → list/create (no id)
+ * - `performers/abc-123` → get/update/delete (with id)
+ * - `performers/abc-123/generate-image` → custom action
+ *
+ * @param urlPath - The resource portion of the URL (after `/api/agents/{agentId}/`)
+ * @param routes - Route map from {@link buildRouteMap}
+ * @returns Resolved route with optional id/action, or null if no match
+ */
+export declare function resolveAPIRoute(urlPath: string, routes: Map<string, AgentAPIRouteInfo>): ResolvedAPIRoute | null;
+//# sourceMappingURL=api-routes.d.ts.map

package/dist/server/api-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-routes.d.ts","sourceRoot":"","sources":["../../src/server/api-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,KAAK,EAAE,iBAAiB,CAAC;IACzB,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,eAAe,EAAE,GAC3B,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAgChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACrC,gBAAgB,GAAG,IAAI,CA6BzB"}

package/dist/server/config-loader.d.ts

@@ -0,0 +1,17 @@
+import { SmrtClassOptions } from '@happyvertical/smrt-core';
+/**
+ * Load slot configs for multiple agents from the agent_configs table.
+ *
+ * Returns a nested map: agentId -> slotId -> configData.
+ * Agent-specific tables (e.g., praeco_sources, praeco_reports)
+ * are NOT loaded here — those stay in the host application.
+ *
+ * @param agents - Array of agent identifiers (id + agentClass)
+ * @param dbOptions - Database options for SmrtCollection.create()
+ * @returns Map of agentId -> slotId -> config data
+ */
+export declare function loadSlotConfigs(agents: Array<{
+    id: string;
+    agentClass: string;
+}>, dbOptions: SmrtClassOptions): Promise<Record<string, Record<string, unknown>>>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/server/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/server/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,EACjD,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CA6BlD"}

package/dist/server/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Server-side utilities for SMRT agents
+ *
+ * This module provides functions for server-side agent operations:
+ * - Manifest loading and registration (replacing manual per-package imports)
+ * - Agent serialization for client transport
+ * - Config loading from the database
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   loadManifestsFromConfig,
+ *   serializeResolvedAgent,
+ *   loadSlotConfigs,
+ * } from '@happyvertical/smrt-agents/server';
+ *
+ * // One-call manifest setup (replaces manual per-package registration)
+ * loadManifestsFromConfig();
+ *
+ * // Serialize resolved agents for the UI
+ * const serialized = resolved.map(serializeResolvedAgent);
+ *
+ * // Load slot configs from database
+ * const configs = await loadSlotConfigs(agents, { db: dbConfig });
+ * ```
+ *
+ * @module @happyvertical/smrt-agents/server
+ */
+export type { AgentActionContext, AgentActionHandler, AgentActionMap, } from './action-types.js';
+export { type AgentAPIRouteInfo, buildRouteMap, type ResolvedAPIRoute, resolveAPIRoute, } from './api-routes.js';
+export { loadSlotConfigs } from './config-loader.js';
+export { extractAgentManifest, extractAgentPackagesFromConfig, loadManifestsFromConfig, loadManifestsFromPackages, type PackageManifest, } from './manifest-utils.js';
+export { type SerializedAgent, serializeResolvedAgent, } from './serialization.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,iBAAiB,EACtB,aAAa,EACb,KAAK,gBAAgB,EACrB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,eAAe,EACpB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/server/manifest-utils.d.ts

@@ -0,0 +1,63 @@
+import { AgentManifestInfo } from '../ui.js';
+/**
+ * Shape of a package manifest's `objects` entry
+ */
+interface ManifestObject {
+    className: string;
+    agent?: AgentManifestInfo;
+    [key: string]: unknown;
+}
+/**
+ * Shape of a package manifest JSON file
+ */
+export interface PackageManifest {
+    objects: Record<string, ManifestObject>;
+    [key: string]: unknown;
+}
+/**
+ * Extract the AgentManifestInfo from a package manifest by class name.
+ *
+ * Iterates `manifest.objects` looking for the entry whose `className` matches
+ * and has an `agent` metadata block.
+ *
+ * @param manifest - Parsed manifest JSON from a package
+ * @param agentClass - Agent class name to search for (e.g., 'Praeco')
+ * @returns The agent manifest info, or null if not found
+ */
+export declare function extractAgentManifest(manifest: PackageManifest, agentClass: string): AgentManifestInfo | null;
+/**
+ * Load and register agent manifests from a list of package names.
+ *
+ * For each package, resolves its `<package>/manifest` export via `createRequire`,
+ * reads the manifest JSON, extracts the agent class and metadata, and registers
+ * with `AgentUIRegistry`.
+ *
+ * @param packages - Array of package names (e.g., ['@happyvertical/praeco'])
+ * @param projectRoot - Absolute path to the project root (for require resolution)
+ * @returns Map of agentClass -> AgentManifestInfo for successfully loaded agents
+ */
+export declare function loadManifestsFromPackages(packages: string[], projectRoot: string): Map<string, AgentManifestInfo>;
+/**
+ * Extract agent package names from a smrt.config.js file.
+ *
+ * Reads the file, finds the `agents: [...]` array, strips comments,
+ * and extracts quoted package names. Same logic as the Vite plugin.
+ *
+ * @param configPath - Absolute path to smrt.config.js
+ * @returns Array of package name strings
+ */
+export declare function extractAgentPackagesFromConfig(configPath: string): string[];
+/**
+ * Load and register agent manifests by reading smrt.config.js.
+ *
+ * One-call setup: reads the config file to discover agent packages,
+ * then loads and registers manifests for each. Idempotent — safe to
+ * call from multiple server load functions.
+ *
+ * @param configPath - Path to smrt.config.js (default: `<projectRoot>/smrt.config.js`)
+ * @param projectRoot - Project root for require resolution (default: `process.cwd()`)
+ * @returns Map of agentClass -> AgentManifestInfo
+ */
+export declare function loadManifestsFromConfig(configPath?: string, projectRoot?: string): Map<string, AgentManifestInfo>;
+export {};
+//# sourceMappingURL=manifest-utils.d.ts.map

package/dist/server/manifest-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-utils.d.ts","sourceRoot":"","sources":["../../src/server/manifest-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,UAAU,CAAC;AAEnE;;GAEG;AACH,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,MAAM,GACjB,iBAAiB,GAAG,IAAI,CAO1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAClB,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CA2BhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAoBhC"}