@happyvertical/smrt-agents 0.51.39 → 0.52.0

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-agents",
-  "packageVersion": "0.51.39",
+  "packageVersion": "0.52.0",
   "objects": {
     "@happyvertical/smrt-agents:Agent": {
       "name": "agent",
@@ -246,6 +246,7 @@
       "staticProperties": {
         "uiSlots": {},
         "adminRoutes": [],
+        "createEntries": [],
         "signalSubscriptions": []
       },
       "schema": {

package/dist/migrations/tenant-agent-config-keys.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Data repair for tenant agent config keys left behind by smrt #1092.
+ *
+ * #1092 canonicalized agent identity to the registry's qualified type
+ * (`@scope/package:Class`). A tenant-bound agent with no Agent row owns its
+ * slot configs under `tenantAgentConfigOwnerId(tenant, type)`, so the id the
+ * admin UI reads became `<tenant>:@scope/package:Class` — but rows written
+ * before (or by writers that kept composing the old id) sit under
+ * `<tenant>:Class`, and the settings panels show nothing. Separately,
+ * `tenant_agents.agent_class` may still hold a bare class or a renamed
+ * package's qualified name. `TenantAgentCollection` self-heals a bare class
+ * on read, but never the config rows and never a name the registry cannot map.
+ *
+ * This repair moves both to the canonical type:
+ *
+ * - `tenant_agents.agent_class` → canonical type (never onto an existing
+ *   binding of the same tenant: two spellings of one binding are blocked);
+ * - `agent_configs` rows whose owner id is `<row tenant_id>:<type>` → owner
+ *   `<tenant>:<canonical>`, `agent_class` canonical, and the slug
+ *   `AgentConfig.saveSlot()` gives a new row (`<owner>-<slot>`). Two rows
+ *   landing on one `(tenant, owner, slot)` or one slug are blocked. Other
+ *   owner ids (persona ids, Agent row ids) are left alone.
+ *
+ * Canonical type = `aliases[stored]` when given (for renamed packages the
+ * registry cannot know), else `getAgentTypeName(stored)`, which needs the
+ * agent classes registered in the running process (import the host's
+ * agents first).
+ *
+ * `repairTenantAgentConfigKeys(db)` is a dry run and never writes. With
+ * `apply: true` it re-plans inside one transaction (table locks on
+ * PostgreSQL), refuses when anything is blocked, re-checks before commit,
+ * and returns a ledger of every before/after value. Re-running after apply
+ * finds nothing to do.
+ */
+import type { DatabaseInterface } from '@happyvertical/sql';
+export declare const TENANT_AGENTS_TABLE = "tenant_agents";
+export declare const AGENT_CONFIGS_TABLE = "agent_configs";
+export declare class TenantAgentConfigKeyRepairError extends Error {
+    constructor(message: string);
+}
+export interface TenantAgentConfigKeyRepairOptions {
+    /**
+     * Stored spelling → canonical type, consulted before the registry. Use it
+     * for types the registry cannot map, e.g. a package that was renamed
+     * (`'@happyvertical/praeco:Praeco': '@anytown/praeco:Praeco'`).
+     */
+    aliases?: Readonly<Record<string, string>>;
+    /** Full override of the canonicalization (aliases are then ignored). */
+    resolveAgentType?: (stored: string) => string;
+}
+export interface TenantAgentKeyRow {
+    id: string;
+    tenantId: string;
+    agentClass: string;
+    targetAgentClass: string;
+    reason?: string;
+}
+export interface AgentConfigKeyRow {
+    id: string;
+    tenantId: string | null;
+    slotId: string;
+    agentId: string;
+    agentClass: string;
+    slug: string;
+    targetAgentId: string;
+    targetAgentClass: string;
+    targetSlug: string;
+    /** No tenant binding owns the target owner id (after the binding repair). */
+    unbound: boolean;
+    reason?: string;
+}
+export interface TenantAgentConfigKeyPlan {
+    tenantAgents: {
+        clean: TenantAgentKeyRow[];
+        planned: TenantAgentKeyRow[];
+        blocked: TenantAgentKeyRow[];
+    };
+    configs: {
+        clean: AgentConfigKeyRow[];
+        planned: AgentConfigKeyRow[];
+        blocked: AgentConfigKeyRow[];
+        /** Owner ids that are not `<row tenant>:<type>` (persona/Agent row ids). */
+        skipped: AgentConfigKeyRow[];
+    };
+}
+export interface TenantAgentConfigKeyLedgerEntry {
+    table: typeof TENANT_AGENTS_TABLE | typeof AGENT_CONFIGS_TABLE;
+    id: string;
+    before: Record<string, string>;
+    after: Record<string, string>;
+}
+export interface TenantAgentConfigKeyRepairTotals {
+    tenantAgents: {
+        total: number;
+        clean: number;
+        planned: number;
+        blocked: number;
+    };
+    configs: {
+        total: number;
+        clean: number;
+        planned: number;
+        blocked: number;
+        skipped: number;
+        unbound: number;
+    };
+    /** Rows written (0 on a dry run). */
+    changed: number;
+}
+export interface TenantAgentConfigKeyRepairReport {
+    mode: 'dry-run' | 'apply';
+    /** The plan before any write (dry run) or the re-check after apply. */
+    plan: TenantAgentConfigKeyPlan;
+    totals: TenantAgentConfigKeyRepairTotals;
+    ledger: TenantAgentConfigKeyLedgerEntry[];
+}
+export interface RawTenantAgentRow {
+    id: unknown;
+    tenant_id: unknown;
+    agent_class: unknown;
+}
+export interface RawAgentConfigRow {
+    id: unknown;
+    tenant_id: unknown;
+    agent_id: unknown;
+    agent_class: unknown;
+    slot_id: unknown;
+    slug: unknown;
+}
+type Queryable = Pick<DatabaseInterface, 'query'>;
+/** Pure planner over both tables' rows (no SQL), for tests and previews. */
+export declare function planTenantAgentConfigKeyRepairRows(tenantAgentRows: readonly RawTenantAgentRow[], configRows: readonly RawAgentConfigRow[], options?: TenantAgentConfigKeyRepairOptions): TenantAgentConfigKeyPlan;
+/** Read both tables and plan the repair (never writes). */
+export declare function planTenantAgentConfigKeyRepair(db: Queryable, options?: TenantAgentConfigKeyRepairOptions): Promise<TenantAgentConfigKeyPlan>;
+/**
+ * Plan (default) or apply the tenant agent config key repair. See the module
+ * docs; `apply: true` requires a transaction-capable adapter.
+ */
+export declare function repairTenantAgentConfigKeys(db: DatabaseInterface, options?: TenantAgentConfigKeyRepairOptions & {
+    apply?: boolean;
+}): Promise<TenantAgentConfigKeyRepairReport>;
+export {};
+//# sourceMappingURL=tenant-agent-config-keys.d.ts.map

package/dist/migrations/tenant-agent-config-keys.d.ts.map

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

package/dist/server/jobs-data-surface-action-queue.d.ts

@@ -3,6 +3,15 @@ import { type JobExecutionContext } from '@happyvertical/smrt-jobs';
 import type { DataSurfaceActionResult } from '@happyvertical/smrt-types';
 import type { DatabaseInterface } from '@happyvertical/sql';
 import type { DataSurfaceBackgroundActionEnvelope, DataSurfaceBackgroundQueue } from './data-surface-actions.js';
+export interface DataSurfaceBackgroundActionHandlerOptions {
+    /**
+     * Stable identity of the registering host module. A re-registration of the
+     * same `handlerId` by the same owner (a re-evaluated module after a hot
+     * reload) replaces the previous handler; a different owner, or an anonymous
+     * registration with a different function, is a conflict and throws.
+     */
+    owner?: string;
+}
 export interface DataSurfaceActionJobArgs {
     version: 1;
     envelope: DataSurfaceBackgroundActionEnvelope;
@@ -10,6 +19,8 @@ export interface DataSurfaceActionJobArgs {
 export interface JobsDataSurfaceBackgroundQueueOptions {
     db: DatabaseInterface;
     handlerId: string;
+    /** See {@link DataSurfaceBackgroundActionHandlerOptions.owner}. */
+    owner?: string;
     execute(envelope: DataSurfaceBackgroundActionEnvelope): Promise<DataSurfaceActionResult>;
     queue?: string;
     priority?: number;
@@ -26,7 +37,7 @@ export declare class SmrtDataSurfaceActionTask extends SmrtObject {
  * Register the host handler used by workers after process restart.
  * The returned disposer only removes the same registration.
  */
-export declare function registerDataSurfaceBackgroundActionHandler(handlerId: string, execute: (envelope: DataSurfaceBackgroundActionEnvelope) => Promise<DataSurfaceActionResult>): () => void;
+export declare function registerDataSurfaceBackgroundActionHandler(handlerId: string, execute: (envelope: DataSurfaceBackgroundActionEnvelope) => Promise<DataSurfaceActionResult>, options?: DataSurfaceBackgroundActionHandlerOptions): () => void;
 export declare function createJobsDataSurfaceBackgroundQueue(options: JobsDataSurfaceBackgroundQueueOptions): DataSurfaceBackgroundQueue & {
     unregister(): void;
 };

package/dist/server/jobs-data-surface-action-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs-data-surface-action-queue.d.ts","sourceRoot":"","sources":["../../src/server/jobs-data-surface-action-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAIL,KAAK,mBAAmB,EAGzB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EACV,mCAAmC,EAEnC,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AASnC,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,mCAAmC,CAAC;CAC/C;AAED,MAAM,WAAW,qCAAqC;IACpD,EAAE,EAAE,iBAAiB,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CACL,QAAQ,EAAE,mCAAmC,GAC5C,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAOa,yBAA0B,SAAQ,UAAU;IAEvD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,IAAI,EAAE,wBAAwB,CAG5B;IAGI,GAAG,CACP,IAAI,GAAE,wBAAoC,EAC1C,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,uBAAuB,CAAC;CA6CpC;AAED;;;GAGG;AACH,wBAAgB,0CAA0C,CACxD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CACP,QAAQ,EAAE,mCAAmC,KAC1C,OAAO,CAAC,uBAAuB,CAAC,GACpC,MAAM,IAAI,CAgBZ;AAED,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,qCAAqC,GAC7C,0BAA0B,GAAG;IAAE,UAAU,IAAI,IAAI,CAAA;CAAE,CAuBrD"}
+{"version":3,"file":"jobs-data-surface-action-queue.d.ts","sourceRoot":"","sources":["../../src/server/jobs-data-surface-action-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAIL,KAAK,mBAAmB,EAGzB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EACV,mCAAmC,EAEnC,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AA8BnC,MAAM,WAAW,yCAAyC;IACxD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,mCAAmC,CAAC;CAC/C;AAED,MAAM,WAAW,qCAAqC;IACpD,EAAE,EAAE,iBAAiB,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CACL,QAAQ,EAAE,mCAAmC,GAC5C,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAOa,yBAA0B,SAAQ,UAAU;IAEvD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,IAAI,EAAE,wBAAwB,CAG5B;IAGI,GAAG,CACP,IAAI,GAAE,wBAAoC,EAC1C,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,uBAAuB,CAAC;CA6CpC;AAED;;;GAGG;AACH,wBAAgB,0CAA0C,CACxD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CACP,QAAQ,EAAE,mCAAmC,KAC1C,OAAO,CAAC,uBAAuB,CAAC,EACrC,OAAO,GAAE,yCAA8C,GACtD,MAAM,IAAI,CAqBZ;AAED,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,qCAAqC,GAC7C,0BAA0B,GAAG;IAAE,UAAU,IAAI,IAAI,CAAA;CAAE,CAwBrD"}

package/dist/server/serialization.d.ts

@@ -7,7 +7,7 @@
  * @module @happyvertical/smrt-agents/server
  */
 import type { ResolvedAgentAvailability } from '../tenant-agent.js';
-import type { AgentAdminRoute, AgentUISlots } from '../ui.js';
+import type { AgentAdminRoute, AgentCreateEntry, AgentUISlots } from '../ui.js';
 /**
  * Serialized agent data for passing to client components.
  *
@@ -15,7 +15,10 @@ import type { AgentAdminRoute, AgentUISlots } from '../ui.js';
  * alongside resolution metadata (source, sourceTenantId).
  */
 export interface SerializedAgent {
-    /** Agent instance ID, or a synthetic key if no instance exists */
+    /**
+     * Agent instance ID, or — when the binding has no agent row — the tenant
+     * config owner id `tenantAgentConfigOwnerId(sourceTenantId, agentType)`.
+     */
     id: string;
     /** Human-readable name from manifest */
     name?: string;
@@ -29,6 +32,8 @@ export interface SerializedAgent {
     slots?: AgentUISlots;
     /** Admin route declarations from manifest */
     adminRoutes?: AgentAdminRoute[];
+    /** Create options from manifest (see `resolveAgentCreateEntries`) */
+    createEntries?: AgentCreateEntry[];
     /** How this agent was resolved for the tenant */
     source?: 'explicit' | 'inherited';
     /** Which tenant the binding came from */

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

@@ -1 +1 @@
-{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/server/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,iDAAiD;IACjD,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IAClC,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,yBAAyB,GAClC,eAAe,CAkBjB"}
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/server/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,qEAAqE;IACrE,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACnC,iDAAiD;IACjD,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IAClC,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,yBAAyB,GAClC,eAAe,CAqBjB"}

package/dist/server.js

@@ -1,4 +1,4 @@
-import { n as executeAsPrincipal, r as AgentConfig } from "./chunks/execute-as-principal-uuJq7EFs.js";
+import { n as executeAsPrincipal, r as AgentConfig, u as tenantAgentConfigOwnerId } from "./chunks/execute-as-principal-DtwCUq2t.js";
 import { i as loadManifestsFromPackages, n as extractAgentPackagesFromConfig, r as loadManifestsFromConfig, t as extractAgentManifest } from "./chunks/manifest-utils-CtMyFQDx.js";
 import { ObjectRegistry, SmrtObject, field, smrt } from "@happyvertical/smrt-core";
 import { sanitizeConfig } from "@happyvertical/smrt-config";
@@ -687,7 +687,10 @@ var __decorateClass$1 = (decorators, target, key, kind) => {
 	if (kind && result) __defProp$1(target, key, result);
 	return result;
 };
-var handlers = /* @__PURE__ */ new Map();
+var HANDLERS_KEY = /* @__PURE__ */ Symbol.for("@happyvertical/smrt-agents/data-surface-action-handlers@2");
+var globalRegistry = globalThis;
+var handlers = globalRegistry[HANDLERS_KEY] ?? /* @__PURE__ */ new Map();
+globalRegistry[HANDLERS_KEY] = handlers;
 var SmrtDataSurfaceActionTask = class extends SmrtObject {
 	tenantId = null;
 	args = {
@@ -708,7 +711,7 @@ var SmrtDataSurfaceActionTask = class extends SmrtObject {
 		if (args?.version !== 1 || envelope?.version !== 1 || typeof envelope.handlerId !== "string" || envelope.handlerId.length === 0 || envelope.principal?.tenantId !== jobTenantId) throw new Error("Invalid durable data-surface action envelope");
 		const handler = handlers.get(envelope.handlerId);
 		if (!handler) throw new Error(`No data-surface action handler registered for ${envelope.handlerId}`);
-		const result = await handler(envelope);
+		const result = await handler.execute(envelope);
 		if (!result.ok && result.reason === "idempotency_in_progress") throw new Error("Data-surface action outcome requires reconciliation");
 		return result;
 	}
@@ -725,18 +728,24 @@ SmrtDataSurfaceActionTask = __decorateClass$1([TenantScoped({ mode: "optional" }
 	cli: false,
 	mcp: false
 })], SmrtDataSurfaceActionTask);
-function registerDataSurfaceBackgroundActionHandler(handlerId, execute) {
+function registerDataSurfaceBackgroundActionHandler(handlerId, execute, options = {}) {
 	if (!handlerId || handlerId.length > 256) throw new Error("Data-surface action handlerId must contain 1-256 characters");
 	const existing = handlers.get(handlerId);
-	if (existing && existing !== execute) throw new Error(`Data-surface action handler already registered: ${handlerId}`);
-	handlers.set(handlerId, execute);
+	if (existing && existing.execute !== execute) {
+		if (!(options.owner !== void 0 && existing.owner === options.owner)) throw new Error(`Data-surface action handler already registered: ${handlerId}`);
+	}
+	const entry = {
+		execute,
+		owner: options.owner
+	};
+	handlers.set(handlerId, entry);
 	return () => {
-		if (handlers.get(handlerId) === execute) handlers.delete(handlerId);
+		if (handlers.get(handlerId) === entry) handlers.delete(handlerId);
 	};
 }
 function createJobsDataSurfaceBackgroundQueue(options) {
 	return {
-		unregister: registerDataSurfaceBackgroundActionHandler(options.handlerId, options.execute),
+		unregister: registerDataSurfaceBackgroundActionHandler(options.handlerId, options.execute, { owner: options.owner }),
 		async enqueue(job) {
 			if (job.envelope.handlerId !== options.handlerId) throw new Error("Data-surface action envelope handler mismatch");
 			const persisted = await enqueueDataSurfaceActionJob(options, job.envelope);
@@ -773,13 +782,14 @@ async function enqueueDataSurfaceActionJob(options, envelope) {
 function serializeResolvedAgent(resolved) {
 	const manifest = resolved.manifest;
 	return {
-		id: resolved.agentId || `${resolved.sourceTenantId}:${resolved.agentType}`,
+		id: resolved.agentId || tenantAgentConfigOwnerId(resolved.sourceTenantId, resolved.agentType),
 		name: manifest?.name || resolved.agentClass,
 		agentClass: resolved.agentClass,
 		agentType: resolved.agentType,
 		_meta_type: resolved.agentType,
 		slots: manifest?.uiSlots,
 		adminRoutes: manifest?.adminRoutes,
+		createEntries: manifest?.createEntries,
 		source: resolved.source,
 		sourceTenantId: resolved.sourceTenantId,
 		permissions: resolved.permissions,