@happyvertical/smrt-personas 0.38.19 → 0.38.21

package/dist/index.js

@@ -1,15 +1,51 @@
-import { ObjectRegistry, SmrtCollection, SmrtObject, crossPackageRef, field, getClassName, smrt } from "@happyvertical/smrt-core";
+import { LearningMemory, ObjectRegistry, SmrtCollection, SmrtObject, crossPackageRef, field, foreignKey, getClassName, smrt } from "@happyvertical/smrt-core";
+import { registerPermissionDefinitions } from "@happyvertical/smrt-users";
 import { TenantScoped, tenantId } from "@happyvertical/smrt-tenancy";
+import { PromptOverrideCollection, PromptRegistry, definePrompt, resolvePrompt } from "@happyvertical/smrt-prompts";
+import { instanceScopedSubscriber } from "@happyvertical/smrt-agents";
 //#region src/__smrt-register__.ts
-ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":1783562557011,\"packageName\":\"@happyvertical/smrt-personas\",\"packageVersion\":\"0.38.19\",\"objects\":{\"@happyvertical/smrt-personas:AgentPersona\":{\"name\":\"agentpersona\",\"className\":\"AgentPersona\",\"qualifiedName\":\"@happyvertical/smrt-personas:AgentPersona\",\"collection\":\"agentpersonas\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/personas/src/agent-persona.ts\",\"packageName\":\"@happyvertical/smrt-personas\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"agentClass\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"name\":{\"type\":\"text\",\"required\":false,\"default\":\"\"},\"contextType\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"contextId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"instructions\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"allowedTools\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"runAsUserId\":{\"type\":\"crossPackageRef\",\"required\":true,\"related\":\"@happyvertical/smrt-users:User\"},\"actsAsProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\",\"_meta\":{\"nullable\":true}},\"memoryScope\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"priority\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"enabled\":{\"type\":\"boolean\",\"required\":false,\"_meta\":{}}},\"methods\":{\"getAllowedTools\":{\"name\":\"getAllowedTools\",\"async\":false,\"parameters\":[],\"returnType\":\"string[]\",\"isStatic\":false,\"isPublic\":true},\"setAllowedTools\":{\"name\":\"setAllowedTools\",\"async\":false,\"parameters\":[{\"name\":\"tools\",\"type\":\"string[]\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"agent_personas\",\"api\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"]},\"cli\":{\"include\":[\"list\",\"get\"]},\"mcp\":{\"include\":[\"list\",\"get\"]},\"conflictColumns\":[\"tenant_id\",\"agent_class\",\"name\"],\"tenantScoped\":{\"mode\":\"required\"}},\"extends\":\"SmrtObject\",\"exportName\":\"AgentPersona\",\"collectionExportName\":\"AgentPersonaCollection\",\"validationRules\":[{\"field\":\"tenantId\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"runAsUserId\",\"rule\":\"required\",\"fieldType\":\"crossPackageRef\"}],\"schema\":{\"tableName\":\"agent_personas\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"agent_personas\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"agent_class\\\" TEXT,\\n  \\\"name\\\" TEXT DEFAULT '',\\n  \\\"context_type\\\" TEXT,\\n  \\\"context_id\\\" TEXT,\\n  \\\"instructions\\\" TEXT,\\n  \\\"allowed_tools\\\" TEXT,\\n  \\\"run_as_user_id\\\" UUID NOT NULL,\\n  \\\"acts_as_profile_id\\\" UUID,\\n  \\\"memory_scope\\\" TEXT,\\n  \\\"priority\\\" INTEGER DEFAULT 0,\\n  \\\"enabled\\\" BOOLEAN\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"agent_class\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"name\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false,\"default\":\"\"},\"context_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"context_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"instructions\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"allowed_tools\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"run_as_user_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":true,\"unique\":false},\"acts_as_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"memory_scope\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"priority\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"enabled\":{\"type\":\"BOOLEAN\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"agent_personas_id_idx\",\"columns\":[\"id\"]},{\"name\":\"agent_personas_tenant_id_agent_class_idx\",\"columns\":[\"tenant_id\",\"agent_class\",\"name\"],\"unique\":true}],\"version\":\"71e955ef\"}},\"@happyvertical/smrt-personas:AgentPersonaCollection\":{\"name\":\"agentpersonacollection\",\"className\":\"AgentPersonaCollection\",\"qualifiedName\":\"@happyvertical/smrt-personas:AgentPersonaCollection\",\"collection\":\"agentpersonas\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/personas/src/agent-persona.ts\",\"packageName\":\"@happyvertical/smrt-personas\",\"fields\":{},\"methods\":{\"byTenantAndClass\":{\"name\":\"byTenantAndClass\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false},{\"name\":\"agentClass\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<AgentPersona[]>\",\"isStatic\":false,\"isPublic\":true},\"findActive\":{\"name\":\"findActive\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false},{\"name\":\"agentClass\",\"type\":\"string\",\"optional\":false},{\"name\":\"context\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<AgentPersona[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"agent_personas\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"AgentPersona\",\"exportName\":\"AgentPersonaCollection\",\"collectionExportName\":\"AgentPersonaCollectionCollection\",\"schema\":{\"tableName\":\"agent_personas\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"agent_personas\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"agent_personas_id_idx\",\"columns\":[\"id\"]},{\"name\":\"agent_personas_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"48e54c2f\"}}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-agents\",\"@happyvertical/smrt-core\",\"@happyvertical/smrt-tenancy\"]}"));
+ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":1783580645734,\"packageName\":\"@happyvertical/smrt-personas\",\"packageVersion\":\"0.38.21\",\"objects\":{\"@happyvertical/smrt-personas:AgentPersona\":{\"name\":\"agentpersona\",\"className\":\"AgentPersona\",\"qualifiedName\":\"@happyvertical/smrt-personas:AgentPersona\",\"collection\":\"agentpersonas\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/personas/src/agent-persona.ts\",\"packageName\":\"@happyvertical/smrt-personas\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"agentClass\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"name\":{\"type\":\"text\",\"required\":false,\"default\":\"\"},\"contextType\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"contextId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"instructions\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"allowedTools\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"runAsUserId\":{\"type\":\"crossPackageRef\",\"required\":true,\"related\":\"@happyvertical/smrt-users:User\"},\"actsAsProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\",\"_meta\":{\"nullable\":true}},\"memoryScope\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"priority\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"enabled\":{\"type\":\"boolean\",\"required\":false,\"_meta\":{}}},\"methods\":{\"getAllowedTools\":{\"name\":\"getAllowedTools\",\"async\":false,\"parameters\":[],\"returnType\":\"string[]\",\"isStatic\":false,\"isPublic\":true},\"setAllowedTools\":{\"name\":\"setAllowedTools\",\"async\":false,\"parameters\":[{\"name\":\"tools\",\"type\":\"string[]\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"agent_personas\",\"api\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"]},\"cli\":{\"include\":[\"list\",\"get\"]},\"mcp\":{\"include\":[\"list\",\"get\"]},\"conflictColumns\":[\"tenant_id\",\"agent_class\",\"name\"],\"tenantScoped\":{\"mode\":\"required\"}},\"extends\":\"SmrtObject\",\"exportName\":\"AgentPersona\",\"collectionExportName\":\"AgentPersonaCollection\",\"validationRules\":[{\"field\":\"tenantId\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"runAsUserId\",\"rule\":\"required\",\"fieldType\":\"crossPackageRef\"}],\"schema\":{\"tableName\":\"agent_personas\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"agent_personas\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"agent_class\\\" TEXT,\\n  \\\"name\\\" TEXT DEFAULT '',\\n  \\\"context_type\\\" TEXT,\\n  \\\"context_id\\\" TEXT,\\n  \\\"instructions\\\" TEXT,\\n  \\\"allowed_tools\\\" TEXT,\\n  \\\"run_as_user_id\\\" UUID NOT NULL,\\n  \\\"acts_as_profile_id\\\" UUID,\\n  \\\"memory_scope\\\" TEXT,\\n  \\\"priority\\\" INTEGER DEFAULT 0,\\n  \\\"enabled\\\" BOOLEAN\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"agent_class\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"name\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false,\"default\":\"\"},\"context_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"context_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"instructions\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"allowed_tools\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"run_as_user_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":true,\"unique\":false},\"acts_as_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"memory_scope\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"priority\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false,\"default\":0},\"enabled\":{\"type\":\"BOOLEAN\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"agent_personas_id_idx\",\"columns\":[\"id\"]},{\"name\":\"agent_personas_tenant_id_agent_class_idx\",\"columns\":[\"tenant_id\",\"agent_class\",\"name\"],\"unique\":true}],\"version\":\"71e955ef\"}},\"@happyvertical/smrt-personas:AgentPersonaCollection\":{\"name\":\"agentpersonacollection\",\"className\":\"AgentPersonaCollection\",\"qualifiedName\":\"@happyvertical/smrt-personas:AgentPersonaCollection\",\"collection\":\"agentpersonas\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/personas/src/agent-persona.ts\",\"packageName\":\"@happyvertical/smrt-personas\",\"fields\":{},\"methods\":{\"byTenantAndClass\":{\"name\":\"byTenantAndClass\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false},{\"name\":\"agentClass\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<AgentPersona[]>\",\"isStatic\":false,\"isPublic\":true},\"findActive\":{\"name\":\"findActive\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false},{\"name\":\"agentClass\",\"type\":\"string\",\"optional\":false},{\"name\":\"context\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<AgentPersona[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"agent_personas\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"AgentPersona\",\"exportName\":\"AgentPersonaCollection\",\"collectionExportName\":\"AgentPersonaCollectionCollection\",\"schema\":{\"tableName\":\"agent_personas\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"agent_personas\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"agent_personas_id_idx\",\"columns\":[\"id\"]},{\"name\":\"agent_personas_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"48e54c2f\"}},\"@happyvertical/smrt-personas:DirectiveProposal\":{\"name\":\"directiveproposal\",\"className\":\"DirectiveProposal\",\"qualifiedName\":\"@happyvertical/smrt-personas:DirectiveProposal\",\"collection\":\"directiveproposals\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/personas/src/directive-proposal.ts\",\"packageName\":\"@happyvertical/smrt-personas\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":true,\"autoPopulate\":true,\"nullable\":false,\"mode\":\"required\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"personaId\":{\"type\":\"foreignKey\",\"required\":true,\"related\":\"AgentPersona\",\"_meta\":{\"required\":true}},\"agentClass\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"promptKey\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"proposedInstructions\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"currentInstructions\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"rationale\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"evidence\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"status\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"fingerprint\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"confidence\":{\"type\":\"decimal\",\"required\":false,\"default\":0},\"proposedBy\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"reviewedBy\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"reviewedAt\":{\"type\":\"datetime\",\"required\":false,\"_meta\":{\"nullable\":true}},\"reviewNote\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"activatedOverrideId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}}},\"methods\":{\"getEvidence\":{\"name\":\"getEvidence\",\"async\":false,\"parameters\":[],\"returnType\":\"DirectiveEvidence\",\"isStatic\":false,\"isPublic\":true},\"setEvidence\":{\"name\":\"setEvidence\",\"async\":false,\"parameters\":[{\"name\":\"value\",\"type\":\"DirectiveEvidence\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"isPending\":{\"name\":\"isPending\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"directive_proposals\",\"api\":{\"include\":[\"list\",\"get\"]},\"cli\":{\"include\":[\"list\",\"get\"]},\"mcp\":{\"include\":[\"list\",\"get\"]},\"tenantScoped\":{\"mode\":\"required\"}},\"extends\":\"SmrtObject\",\"exportName\":\"DirectiveProposal\",\"collectionExportName\":\"DirectiveProposalCollection\",\"validationRules\":[{\"field\":\"tenantId\",\"rule\":\"required\",\"fieldType\":\"text\"},{\"field\":\"personaId\",\"rule\":\"required\",\"fieldType\":\"foreignKey\"}],\"schema\":{\"tableName\":\"directive_proposals\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"directive_proposals\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID NOT NULL,\\n  \\\"persona_id\\\" UUID NOT NULL,\\n  \\\"agent_class\\\" TEXT,\\n  \\\"prompt_key\\\" TEXT,\\n  \\\"proposed_instructions\\\" TEXT,\\n  \\\"current_instructions\\\" TEXT,\\n  \\\"rationale\\\" TEXT,\\n  \\\"evidence\\\" TEXT,\\n  \\\"status\\\" TEXT,\\n  \\\"fingerprint\\\" TEXT,\\n  \\\"confidence\\\" REAL DEFAULT 0,\\n  \\\"proposed_by\\\" TEXT,\\n  \\\"reviewed_by\\\" TEXT,\\n  \\\"reviewed_at\\\" TIMESTAMP,\\n  \\\"review_note\\\" TEXT,\\n  \\\"activated_override_id\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":true,\"unique\":false},\"persona_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":true,\"unique\":false},\"agent_class\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"prompt_key\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"proposed_instructions\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"current_instructions\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"rationale\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"evidence\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"fingerprint\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"confidence\":{\"type\":\"REAL\",\"notNull\":false,\"unique\":false,\"default\":0},\"proposed_by\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reviewed_by\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reviewed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"review_note\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"activated_override_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"directive_proposals_id_idx\",\"columns\":[\"id\"]},{\"name\":\"directive_proposals_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"4bd9414b\"}},\"@happyvertical/smrt-personas:DirectiveProposalCollection\":{\"name\":\"directiveproposalcollection\",\"className\":\"DirectiveProposalCollection\",\"qualifiedName\":\"@happyvertical/smrt-personas:DirectiveProposalCollection\",\"collection\":\"directiveproposals\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/personas/src/directive-proposal.ts\",\"packageName\":\"@happyvertical/smrt-personas\",\"fields\":{},\"methods\":{\"pending\":{\"name\":\"pending\",\"async\":true,\"parameters\":[{\"name\":\"options\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<DirectiveProposal[]>\",\"isStatic\":false,\"isPublic\":true},\"findByFingerprint\":{\"name\":\"findByFingerprint\",\"async\":true,\"parameters\":[{\"name\":\"personaId\",\"type\":\"string\",\"optional\":false},{\"name\":\"fingerprint\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<DirectiveProposal[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"directive_proposals\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"DirectiveProposal\",\"exportName\":\"DirectiveProposalCollection\",\"collectionExportName\":\"DirectiveProposalCollectionCollection\",\"schema\":{\"tableName\":\"directive_proposals\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"directive_proposals\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"directive_proposals_id_idx\",\"columns\":[\"id\"]},{\"name\":\"directive_proposals_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"f9669b44\"}},\"@happyvertical/smrt-personas:Feedback\":{\"name\":\"feedback\",\"className\":\"Feedback\",\"qualifiedName\":\"@happyvertical/smrt-personas:Feedback\",\"collection\":\"feedbacks\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/personas/src/feedback.ts\",\"packageName\":\"@happyvertical/smrt-personas\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"sqlType\":\"UUID\",\"nullable\":true,\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":false,\"autoPopulate\":true,\"nullable\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"personaId\":{\"type\":\"foreignKey\",\"required\":true,\"related\":\"AgentPersona\",\"_meta\":{\"required\":true}},\"agentClass\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"memoryScope\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"scope\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"key\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"signalType\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"source\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"correlationId\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"required\":true}},\"correlationType\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"rating\":{\"type\":\"decimal\",\"required\":false,\"_meta\":{\"nullable\":true}},\"metric\":{\"type\":\"decimal\",\"required\":false,\"_meta\":{\"nullable\":true}},\"success\":{\"type\":\"boolean\",\"required\":false,\"_meta\":{\"nullable\":true}},\"correction\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"comment\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"actorId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"nullable\":true}},\"metadata\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"reinforcedAt\":{\"type\":\"datetime\",\"required\":false,\"_meta\":{\"nullable\":true}}},\"methods\":{\"isHuman\":{\"name\":\"isHuman\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"getMetadata\":{\"name\":\"getMetadata\",\"async\":false,\"parameters\":[],\"returnType\":\"Record<string>\",\"isStatic\":false,\"isPublic\":true},\"setMetadata\":{\"name\":\"setMetadata\",\"async\":false,\"parameters\":[{\"name\":\"value\",\"type\":\"Record<string>\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"updateMetadata\":{\"name\":\"updateMetadata\",\"async\":false,\"parameters\":[{\"name\":\"patch\",\"type\":\"Record<string>\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"getCorrectionValue\":{\"name\":\"getCorrectionValue\",\"async\":false,\"parameters\":[],\"returnType\":\"string | undefined\",\"isStatic\":false,\"isPublic\":true},\"toLearningOutcome\":{\"name\":\"toLearningOutcome\",\"async\":false,\"parameters\":[{\"name\":\"options\",\"type\":\"FeedbackOutcomeOptions\",\"optional\":true}],\"returnType\":\"LearningOutcome | null\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"agent_feedback\",\"api\":{\"include\":[\"list\",\"get\",\"create\"]},\"cli\":{\"include\":[\"list\",\"get\"]},\"mcp\":{\"include\":[\"list\",\"get\"]},\"tenantScoped\":{\"mode\":\"optional\"}},\"extends\":\"SmrtObject\",\"exportName\":\"Feedback\",\"collectionExportName\":\"FeedbackCollection\",\"validationRules\":[{\"field\":\"personaId\",\"rule\":\"required\",\"fieldType\":\"foreignKey\"},{\"field\":\"correlationId\",\"rule\":\"required\",\"fieldType\":\"text\"}],\"schema\":{\"tableName\":\"agent_feedback\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"agent_feedback\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"persona_id\\\" UUID NOT NULL,\\n  \\\"agent_class\\\" TEXT,\\n  \\\"memory_scope\\\" TEXT,\\n  \\\"scope\\\" TEXT,\\n  \\\"key\\\" TEXT,\\n  \\\"signal_type\\\" TEXT,\\n  \\\"source\\\" TEXT,\\n  \\\"correlation_id\\\" TEXT NOT NULL,\\n  \\\"correlation_type\\\" TEXT,\\n  \\\"rating\\\" REAL,\\n  \\\"metric\\\" REAL,\\n  \\\"success\\\" BOOLEAN,\\n  \\\"correction\\\" TEXT,\\n  \\\"comment\\\" TEXT,\\n  \\\"actor_id\\\" TEXT,\\n  \\\"metadata\\\" TEXT,\\n  \\\"reinforced_at\\\" TIMESTAMP\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"persona_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":true,\"unique\":false},\"agent_class\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"memory_scope\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"scope\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"key\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"signal_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"source\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"correlation_id\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false},\"correlation_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"rating\":{\"type\":\"REAL\",\"notNull\":false,\"unique\":false},\"metric\":{\"type\":\"REAL\",\"notNull\":false,\"unique\":false},\"success\":{\"type\":\"BOOLEAN\",\"notNull\":false,\"unique\":false},\"correction\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"comment\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"actor_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"metadata\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reinforced_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"agent_feedback_id_idx\",\"columns\":[\"id\"]},{\"name\":\"agent_feedback_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"65f8e99e\"}},\"@happyvertical/smrt-personas:FeedbackCollection\":{\"name\":\"feedbackcollection\",\"className\":\"FeedbackCollection\",\"qualifiedName\":\"@happyvertical/smrt-personas:FeedbackCollection\",\"collection\":\"feedbacks\",\"filePath\":\"/home/runner/_work/smrt/smrt/packages/personas/src/feedback.ts\",\"packageName\":\"@happyvertical/smrt-personas\",\"fields\":{},\"methods\":{\"forPersona\":{\"name\":\"forPersona\",\"async\":true,\"parameters\":[{\"name\":\"personaId\",\"type\":\"string\",\"optional\":false},{\"name\":\"options\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<Feedback[]>\",\"isStatic\":false,\"isPublic\":true},\"forScope\":{\"name\":\"forScope\",\"async\":true,\"parameters\":[{\"name\":\"memoryScope\",\"type\":\"string\",\"optional\":false},{\"name\":\"options\",\"type\":\"object\",\"optional\":true}],\"returnType\":\"Promise<Feedback[]>\",\"isStatic\":false,\"isPublic\":true},\"byCorrelation\":{\"name\":\"byCorrelation\",\"async\":true,\"parameters\":[{\"name\":\"correlationId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Feedback[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"agent_feedback\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"Feedback\",\"exportName\":\"FeedbackCollection\",\"collectionExportName\":\"FeedbackCollectionCollection\",\"schema\":{\"tableName\":\"agent_feedback\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"agent_feedback\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"}},\"indexes\":[{\"name\":\"agent_feedback_id_idx\",\"columns\":[\"id\"]},{\"name\":\"agent_feedback_slug_context_idx\",\"columns\":[\"slug\",\"context\"],\"unique\":true}],\"version\":\"c8bb487d\"}}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-agents\",\"@happyvertical/smrt-core\",\"@happyvertical/smrt-prompts\",\"@happyvertical/smrt-tenancy\",\"@happyvertical/smrt-users\"]}"));
+//#endregion
+//#region src/directive-principal.ts
+var ACTIVATE_DIRECTIVE_PERMISSION = "personas.activate-directive";
+var DIRECTIVE_ACTIVATION_PERMISSION_DEF = {
+	slug: ACTIVATE_DIRECTIVE_PERMISSION,
+	category: "personas",
+	name: "Activate Persona Directive",
+	description: "Approve, edit, or reject a proposed edit to a persona's instructions and activate the persona-scoped prompt override"
+};
+function principalFromPermissions(permissions, options = {}) {
+	const granted = new Set(permissions);
+	return {
+		id: options.id,
+		tenantId: options.tenantId,
+		can: (slug) => granted.has(slug)
+	};
+}
+async function resolveDirectivePrincipal(options) {
+	const { permissions } = await options.resolver.resolvePermissions(options.userId, options.tenantId);
+	return principalFromPermissions(permissions, {
+		id: options.userId,
+		tenantId: options.tenantId
+	});
+}
+var personaPermissionsRegistered = false;
+function registerPersonaPermissions() {
+	return registerPermissionDefinitions([DIRECTIVE_ACTIVATION_PERMISSION_DEF]);
+}
+function ensurePersonaPermissionsRegistered() {
+	if (personaPermissionsRegistered) return;
+	personaPermissionsRegistered = true;
+	registerPersonaPermissions();
+}
 //#endregion
 //#region src/agent-persona.ts
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __decorateClass = (decorators, target, key, kind) => {
-	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+var __defProp$2 = Object.defineProperty;
+var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
+var __decorateClass$2 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$2(target, key) : target;
 	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-	if (kind && result) __defProp(target, key, result);
+	if (kind && result) __defProp$2(target, key, result);
 	return result;
 };
 function canonicalAgentClass(name) {
@@ -68,23 +104,23 @@ var AgentPersona = class extends SmrtObject {
 		this.allowedTools = JSON.stringify(tools ?? []);
 	}
 };
-__decorateClass([tenantId()], AgentPersona.prototype, "tenantId", 2);
-__decorateClass([field({ type: "text" })], AgentPersona.prototype, "agentClass", 2);
-__decorateClass([field({
+__decorateClass$2([tenantId()], AgentPersona.prototype, "tenantId", 2);
+__decorateClass$2([field({ type: "text" })], AgentPersona.prototype, "agentClass", 2);
+__decorateClass$2([field({
 	type: "text",
 	nullable: true
 })], AgentPersona.prototype, "contextType", 2);
-__decorateClass([field({
+__decorateClass$2([field({
 	type: "text",
 	nullable: true
 })], AgentPersona.prototype, "contextId", 2);
-__decorateClass([field({ type: "text" })], AgentPersona.prototype, "instructions", 2);
-__decorateClass([field({ type: "text" })], AgentPersona.prototype, "allowedTools", 2);
-__decorateClass([crossPackageRef("@happyvertical/smrt-users:User", { required: true })], AgentPersona.prototype, "runAsUserId", 2);
-__decorateClass([crossPackageRef("@happyvertical/smrt-profiles:Profile", { nullable: true })], AgentPersona.prototype, "actsAsProfileId", 2);
-__decorateClass([field({ type: "text" })], AgentPersona.prototype, "memoryScope", 2);
-__decorateClass([field({ type: "boolean" })], AgentPersona.prototype, "enabled", 2);
-AgentPersona = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+__decorateClass$2([field({ type: "text" })], AgentPersona.prototype, "instructions", 2);
+__decorateClass$2([field({ type: "text" })], AgentPersona.prototype, "allowedTools", 2);
+__decorateClass$2([crossPackageRef("@happyvertical/smrt-users:User", { required: true })], AgentPersona.prototype, "runAsUserId", 2);
+__decorateClass$2([crossPackageRef("@happyvertical/smrt-profiles:Profile", { nullable: true })], AgentPersona.prototype, "actsAsProfileId", 2);
+__decorateClass$2([field({ type: "text" })], AgentPersona.prototype, "memoryScope", 2);
+__decorateClass$2([field({ type: "boolean" })], AgentPersona.prototype, "enabled", 2);
+AgentPersona = __decorateClass$2([TenantScoped({ mode: "required" }), smrt({
 	tableName: "agent_personas",
 	api: { include: [
 		"list",
@@ -167,6 +203,654 @@ function sortByPriorityThenName(personas) {
 	});
 }
 //#endregion
+//#region src/directive-proposal.ts
+var __defProp$1 = Object.defineProperty;
+var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$1(target, key, result);
+	return result;
+};
+function computeDirectiveFingerprint(personaId, promptKey, proposedInstructions) {
+	const input = `${personaId} ${promptKey} ${proposedInstructions}`;
+	let hash = 2166136261;
+	for (let i = 0; i < input.length; i++) {
+		hash ^= input.charCodeAt(i);
+		hash = Math.imul(hash, 16777619) >>> 0;
+	}
+	return hash.toString(16).padStart(8, "0");
+}
+function parseEvidence(raw) {
+	if (typeof raw !== "string" || raw.length === 0) return raw && typeof raw === "object" ? raw : {};
+	try {
+		const parsed = JSON.parse(raw);
+		return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+var DirectiveProposal = class extends SmrtObject {
+	tenantId = "";
+	personaId = "";
+	agentClass = "";
+	promptKey = "";
+	proposedInstructions = "";
+	currentInstructions = "";
+	rationale = "";
+	evidence = "{}";
+	status = "pending";
+	fingerprint = "";
+	/** Aggregate confidence in the proposal, in `[0, 1]`. */
+	confidence = 0;
+	proposedBy = "";
+	reviewedBy = null;
+	reviewedAt = null;
+	reviewNote = null;
+	activatedOverrideId = null;
+	/** Parse {@link evidence}, tolerating malformed JSON. */
+	getEvidence() {
+		return parseEvidence(this.evidence);
+	}
+	/** Replace {@link evidence}. */
+	setEvidence(value) {
+		this.evidence = JSON.stringify(value ?? {});
+	}
+	/** Whether the proposal is still awaiting review. */
+	isPending() {
+		return this.status === "pending";
+	}
+};
+__decorateClass$1([tenantId()], DirectiveProposal.prototype, "tenantId", 2);
+__decorateClass$1([foreignKey("AgentPersona", { required: true })], DirectiveProposal.prototype, "personaId", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "agentClass", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "promptKey", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "proposedInstructions", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "currentInstructions", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "rationale", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "evidence", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "status", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "fingerprint", 2);
+__decorateClass$1([field({ type: "text" })], DirectiveProposal.prototype, "proposedBy", 2);
+__decorateClass$1([field({
+	type: "text",
+	nullable: true
+})], DirectiveProposal.prototype, "reviewedBy", 2);
+__decorateClass$1([field({
+	type: "datetime",
+	nullable: true
+})], DirectiveProposal.prototype, "reviewedAt", 2);
+__decorateClass$1([field({
+	type: "text",
+	nullable: true
+})], DirectiveProposal.prototype, "reviewNote", 2);
+__decorateClass$1([field({
+	type: "text",
+	nullable: true
+})], DirectiveProposal.prototype, "activatedOverrideId", 2);
+DirectiveProposal = __decorateClass$1([TenantScoped({ mode: "required" }), smrt({
+	tableName: "directive_proposals",
+	api: { include: ["list", "get"] },
+	cli: { include: ["list", "get"] },
+	mcp: { include: ["list", "get"] }
+})], DirectiveProposal);
+var DirectiveProposalCollection = class extends SmrtCollection {
+	static _itemClass = DirectiveProposal;
+	/**
+	* The review queue: pending proposals, oldest first. Optionally scoped to a
+	* persona.
+	*/
+	async pending(options = {}) {
+		const where = { status: "pending" };
+		if (options.personaId) where.personaId = options.personaId;
+		return this.list({
+			where,
+			orderBy: "created_at ASC",
+			limit: options.limit
+		});
+	}
+	/**
+	* Existing proposals for a persona carrying a given fingerprint, in any
+	* status — used to avoid re-surfacing an already-seen (e.g. rejected) rewrite.
+	*/
+	async findByFingerprint(personaId, fingerprint) {
+		return this.list({ where: {
+			personaId,
+			fingerprint
+		} });
+	}
+};
+//#endregion
+//#region src/feedback.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var HUMAN_SIGNAL_TYPES = [
+	"accept",
+	"reject",
+	"correction",
+	"rating"
+];
+function feedbackSourceFor(signal) {
+	return HUMAN_SIGNAL_TYPES.includes(signal) ? "human" : "autonomous";
+}
+function parseJsonObject(raw) {
+	if (typeof raw !== "string" || raw.length === 0) return raw && typeof raw === "object" ? raw : {};
+	try {
+		const parsed = JSON.parse(raw);
+		return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+var Feedback = class extends SmrtObject {
+	tenantId = null;
+	personaId = "";
+	agentClass = "";
+	memoryScope = "";
+	scope = "";
+	key = "";
+	signalType = "outcome";
+	source = "autonomous";
+	correlationId = "";
+	correlationType = null;
+	rating = null;
+	metric = null;
+	success = null;
+	correction = null;
+	comment = null;
+	actorId = null;
+	metadata = "{}";
+	reinforcedAt = null;
+	/** Whether this is a human-authored signal. */
+	isHuman() {
+		return this.source === "human";
+	}
+	/** Parse {@link metadata}, tolerating malformed JSON. */
+	getMetadata() {
+		return parseJsonObject(this.metadata);
+	}
+	/** Replace {@link metadata}. */
+	setMetadata(value) {
+		this.metadata = JSON.stringify(value ?? {});
+	}
+	/** Shallow-merge into {@link metadata}. */
+	updateMetadata(patch) {
+		this.setMetadata({
+			...this.getMetadata(),
+			...patch
+		});
+	}
+	/**
+	* The strategy value a `correction` signal should persist into memory, so a
+	* regenerated (corrected) strategy supersedes the one that was judged wrong.
+	* `undefined` for non-correction signals (reinforce confidence only).
+	*/
+	getCorrectionValue() {
+		return this.signalType === "correction" && this.correction != null ? this.correction : void 0;
+	}
+	/**
+	* Map this signal onto a {@link LearningOutcome} for reinforcement, or `null`
+	* when the signal carries no reinforcement value:
+	*
+	* - `accept` → success; `reject` / `correction` → failure.
+	* - `outcome` → the recorded boolean `success`.
+	* - `metric` → the recorded `metric` (positive → success).
+	* - `rating` → `{ metric: rating - ratingNeutral }`.
+	*/
+	toLearningOutcome(options = {}) {
+		switch (this.signalType) {
+			case "accept": return { success: true };
+			case "reject":
+			case "correction": return {
+				success: false,
+				error: this.comment ?? void 0
+			};
+			case "outcome": return this.success == null ? null : { success: this.success };
+			case "metric": return this.metric == null ? null : { metric: this.metric };
+			case "rating":
+				if (this.rating == null) return null;
+				return { metric: this.rating - (options.ratingNeutral ?? 0) };
+			default: return null;
+		}
+	}
+};
+__decorateClass([tenantId({ nullable: true })], Feedback.prototype, "tenantId", 2);
+__decorateClass([foreignKey("AgentPersona", { required: true })], Feedback.prototype, "personaId", 2);
+__decorateClass([field({ type: "text" })], Feedback.prototype, "agentClass", 2);
+__decorateClass([field({ type: "text" })], Feedback.prototype, "memoryScope", 2);
+__decorateClass([field({ type: "text" })], Feedback.prototype, "scope", 2);
+__decorateClass([field({ type: "text" })], Feedback.prototype, "key", 2);
+__decorateClass([field({ type: "text" })], Feedback.prototype, "signalType", 2);
+__decorateClass([field({ type: "text" })], Feedback.prototype, "source", 2);
+__decorateClass([field({
+	type: "text",
+	required: true
+})], Feedback.prototype, "correlationId", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], Feedback.prototype, "correlationType", 2);
+__decorateClass([field({
+	type: "decimal",
+	nullable: true
+})], Feedback.prototype, "rating", 2);
+__decorateClass([field({
+	type: "decimal",
+	nullable: true
+})], Feedback.prototype, "metric", 2);
+__decorateClass([field({
+	type: "boolean",
+	nullable: true
+})], Feedback.prototype, "success", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], Feedback.prototype, "correction", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], Feedback.prototype, "comment", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], Feedback.prototype, "actorId", 2);
+__decorateClass([field({ type: "text" })], Feedback.prototype, "metadata", 2);
+__decorateClass([field({
+	type: "datetime",
+	nullable: true
+})], Feedback.prototype, "reinforcedAt", 2);
+Feedback = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "agent_feedback",
+	api: { include: [
+		"list",
+		"get",
+		"create"
+	] },
+	cli: { include: ["list", "get"] },
+	mcp: { include: ["list", "get"] }
+})], Feedback);
+var FeedbackCollection = class extends SmrtCollection {
+	static _itemClass = Feedback;
+	/** All signals for a persona, newest first. */
+	async forPersona(personaId, options = {}) {
+		return this.list({
+			where: { personaId },
+			orderBy: "created_at DESC",
+			limit: options.limit
+		});
+	}
+	/** All signals filed under a memory scope, newest first. */
+	async forScope(memoryScope, options = {}) {
+		return this.list({
+			where: { memoryScope },
+			orderBy: "created_at DESC",
+			limit: options.limit
+		});
+	}
+	/** Every signal correlated to a given AI call / dispatch / job id. */
+	async byCorrelation(correlationId) {
+		return this.list({
+			where: { correlationId },
+			orderBy: "created_at DESC"
+		});
+	}
+};
+//#endregion
+//#region src/persona-prompt.ts
+function personaInstructionsPromptKey(persona) {
+	const id = persona.id;
+	if (!id) throw new Error("personaInstructionsPromptKey requires a persisted persona (missing id)");
+	return `persona.${id}.instructions`;
+}
+var DEFAULT_PERSONA_EDITABLE = {
+	template: true,
+	profile: false,
+	model: false,
+	params: false
+};
+function ensurePersonaInstructionsPrompt(persona, options = {}) {
+	const key = personaInstructionsPromptKey(persona);
+	const existing = PromptRegistry.get(key);
+	if (existing && options.editable === void 0) return existing;
+	return definePrompt({
+		key,
+		template: "",
+		editable: {
+			...DEFAULT_PERSONA_EDITABLE,
+			...options.editable ?? {}
+		}
+	});
+}
+async function upsertPromptTemplateOverride(options) {
+	const { db, key, tenantId, template } = options;
+	const overrides = await PromptOverrideCollection.create({ db });
+	const existing = tenantId != null ? await overrides.getTenantOverride(key, tenantId) : await overrides.getAppOverride(key);
+	if (existing) {
+		existing.template = template;
+		await existing.save();
+		return existing;
+	}
+	return overrides.create({
+		key,
+		tenantId,
+		template
+	});
+}
+async function applyPersonaInstructions(options) {
+	const { persona, db } = options;
+	ensurePersonaInstructionsPrompt(persona, { editable: options.editable });
+	return upsertPromptTemplateOverride({
+		db,
+		key: personaInstructionsPromptKey(persona),
+		tenantId: persona.tenantId ?? null,
+		template: options.instructions ?? persona.instructions ?? ""
+	});
+}
+async function resolvePersonaInstructions(options) {
+	const { persona, db } = options;
+	ensurePersonaInstructionsPrompt(persona);
+	return (await resolvePrompt(personaInstructionsPromptKey(persona), {
+		db,
+		tenantId: persona.tenantId ?? null,
+		variables: options.variables
+	})).text;
+}
+//#endregion
+//#region src/directive-approval.ts
+var DirectiveActivationDeniedError = class extends Error {
+	constructor(message = `Principal lacks the '${ACTIVATE_DIRECTIVE_PERMISSION}' permission required to review persona directives`) {
+		super(message);
+		this.name = "DirectiveActivationDeniedError";
+	}
+};
+var DirectiveNotPendingError = class extends Error {
+	constructor(status) {
+		super(`Directive proposal is not pending (status: ${status})`);
+		this.name = "DirectiveNotPendingError";
+	}
+};
+var DirectiveApprovalService = class {
+	db;
+	proposals;
+	feedback;
+	personas;
+	constructor(options) {
+		this.db = options.db;
+		this.proposals = options.proposals;
+		this.feedback = options.feedback;
+		this.personas = options.personas;
+	}
+	/**
+	* Assert a principal is authorised to review directives. The single gate:
+	* everything privileged in this service calls it first.
+	*
+	* @throws {DirectiveActivationDeniedError} when the principal lacks the slug.
+	*/
+	assertCanActivate(principal) {
+		if (!principal.can("personas.activate-directive")) throw new DirectiveActivationDeniedError();
+	}
+	/**
+	* Assert a principal may review a specific proposal: its resolved tenant, when
+	* bound, must match the proposal's tenant. Permissions are resolved per
+	* tenant, so holding the slug in one tenant must not authorise activating
+	* another tenant's directive.
+	*
+	* @throws {DirectiveActivationDeniedError} on a cross-tenant attempt.
+	*/
+	assertTenantMatch(principal, proposal) {
+		if (principal.tenantId !== void 0 && principal.tenantId !== proposal.tenantId) throw new DirectiveActivationDeniedError(`Principal (tenant '${principal.tenantId}') cannot review a directive for tenant '${proposal.tenantId}'`);
+	}
+	/**
+	* Approve a pending proposal: activate the persona-scoped override and record
+	* an `accept` signal. Pass `editedInstructions` to activate a revised text
+	* (the proposal keeps the model's original as its audit record; the override
+	* holds what was activated).
+	*
+	* @throws {DirectiveActivationDeniedError} when the principal lacks the slug.
+	* @throws {DirectiveNotPendingError} when the proposal is already reviewed.
+	*/
+	async approve(ref, principal, options = {}) {
+		this.assertCanActivate(principal);
+		const proposal = await this.loadPending(ref);
+		this.assertTenantMatch(principal, proposal);
+		const template = options.editedInstructions ?? proposal.proposedInstructions;
+		const override = await upsertPromptTemplateOverride({
+			db: this.db,
+			key: proposal.promptKey,
+			tenantId: proposal.tenantId,
+			template
+		});
+		await this.syncPersonaInstructions(proposal.personaId, template);
+		proposal.status = "approved";
+		proposal.reviewedBy = principal.id ?? null;
+		proposal.reviewedAt = /* @__PURE__ */ new Date();
+		proposal.reviewNote = options.note ?? null;
+		proposal.activatedOverrideId = override.id ?? null;
+		await proposal.save();
+		return {
+			proposal,
+			override,
+			signal: await this.recordSignal(proposal, "accept", principal, {
+				note: options.note,
+				edited: options.editedInstructions !== void 0
+			})
+		};
+	}
+	/**
+	* Reject a pending proposal: record a `reject` signal and close it so it is
+	* never re-surfaced.
+	*
+	* @throws {DirectiveActivationDeniedError} when the principal lacks the slug.
+	* @throws {DirectiveNotPendingError} when the proposal is already reviewed.
+	*/
+	async reject(ref, principal, options = {}) {
+		this.assertCanActivate(principal);
+		const proposal = await this.loadPending(ref);
+		this.assertTenantMatch(principal, proposal);
+		proposal.status = "rejected";
+		proposal.reviewedBy = principal.id ?? null;
+		proposal.reviewedAt = /* @__PURE__ */ new Date();
+		proposal.reviewNote = options.note ?? null;
+		await proposal.save();
+		return {
+			proposal,
+			signal: await this.recordSignal(proposal, "reject", principal, { note: options.note })
+		};
+	}
+	async loadPending(ref) {
+		const proposal = ref instanceof DirectiveProposal ? ref : await this.getProposal(ref);
+		if (!proposal) throw new Error(`Directive proposal not found: ${String(ref)}`);
+		if (proposal.status !== "pending") throw new DirectiveNotPendingError(proposal.status);
+		return proposal;
+	}
+	async getProposal(id) {
+		return (await this.proposalsCollection()).get({ id });
+	}
+	async recordSignal(proposal, signalType, principal, options = {}) {
+		return (await this.feedbackCollection()).create({
+			tenantId: proposal.tenantId,
+			personaId: proposal.personaId,
+			agentClass: proposal.agentClass,
+			memoryScope: "",
+			scope: "persona/directive",
+			key: proposal.id ?? "",
+			signalType,
+			source: "human",
+			correlationId: proposal.id ?? "",
+			correlationType: "directive_proposal",
+			actorId: principal.id ?? null,
+			comment: options.note ?? null,
+			metadata: JSON.stringify({ edited: options.edited ?? false })
+		});
+	}
+	async syncPersonaInstructions(personaId, instructions) {
+		const persona = await (await this.personasCollection()).get({ id: personaId });
+		if (!persona) return;
+		persona.instructions = instructions;
+		await persona.save();
+	}
+	async personasCollection() {
+		if (!this.personas) this.personas = await AgentPersonaCollection.create({ db: this.db });
+		return this.personas;
+	}
+	async proposalsCollection() {
+		if (!this.proposals) this.proposals = await DirectiveProposalCollection.create({ db: this.db });
+		return this.proposals;
+	}
+	async feedbackCollection() {
+		if (!this.feedback) this.feedback = await FeedbackCollection.create({ db: this.db });
+		return this.feedback;
+	}
+};
+//#endregion
+//#region src/persona-memory.ts
+function personaMemoryScope(persona) {
+	const explicit = persona.memoryScope?.trim();
+	if (explicit) return explicit;
+	if (persona.id) return `persona:${persona.id}`;
+	throw new Error("personaMemoryScope requires a persona with a memoryScope or an id");
+}
+function personaLearningMemory(options) {
+	const ownerClass = options.ownerClass ?? (options.persona.agentClass?.trim() || "AgentPersona");
+	return new LearningMemory({
+		db: options.db,
+		ownerClass,
+		ownerId: personaMemoryScope(options.persona),
+		tenantId: options.tenantId ?? options.persona.tenantId ?? null,
+		semanticSearch: options.semanticSearch,
+		config: options.config
+	});
+}
+async function reinforceFromFeedback(memory, feedback, options = {}) {
+	const outcome = feedback.toLearningOutcome(options);
+	if (!outcome) return null;
+	const value = feedback.getCorrectionValue();
+	return memory.capture({
+		scope: feedback.scope,
+		key: feedback.key,
+		...value !== void 0 ? { value } : {}
+	}, outcome);
+}
+//#endregion
+//#region src/persona-instance.ts
+var DEFAULT_PERSONA_NAME = "default";
+function personaInstanceKey(persona) {
+	if (persona.name === "default") return null;
+	if (!persona.id) throw new Error("personaInstanceKey: a non-default persona must be saved (have an id) before it can act as a durable instance");
+	return persona.id;
+}
+function isDefaultPersona(persona) {
+	return persona.name === DEFAULT_PERSONA_NAME;
+}
+function agentOptionsForPersona(persona) {
+	return {
+		instanceKey: personaInstanceKey(persona),
+		tenantId: persona.tenantId
+	};
+}
+async function schedulePersonaInstance(schedules, persona, options) {
+	const instanceKey = personaInstanceKey(persona);
+	const agentConfig = { ...options.agentConfig ?? {} };
+	if (instanceKey) agentConfig.instanceKey = instanceKey;
+	const schedule = await schedules.create({
+		tenantId: persona.tenantId,
+		agentType: persona.agentClass,
+		agentId: null,
+		cron: options.cron,
+		timezone: options.timezone ?? "UTC",
+		method: options.method ?? "run",
+		agentConfig,
+		methodArgs: options.methodArgs ?? {},
+		enabled: options.enabled ?? true
+	});
+	await schedule.save();
+	return schedule;
+}
+async function buildPersonaInstanceAdmin(personas, options) {
+	const canonical = canonicalAgentClass(options.agentClass);
+	const slots = options.manifest?.uiSlots ?? {};
+	const adminRoutes = options.manifest?.adminRoutes ?? [];
+	const instances = (await personas.byTenantAndClass(options.tenantId, canonical)).map((persona) => {
+		const instanceKey = personaInstanceKey(persona);
+		return {
+			personaId: persona.id,
+			name: persona.name,
+			instanceKey,
+			isDefault: isDefaultPersona(persona),
+			enabled: persona.enabled,
+			priority: persona.priority,
+			contextType: persona.contextType,
+			contextId: persona.contextId,
+			runAsUserId: persona.runAsUserId,
+			actsAsProfileId: persona.actsAsProfileId,
+			dispatchSubscriber: instanceScopedSubscriber(canonical, instanceKey),
+			slots,
+			adminRoutes
+		};
+	});
+	return {
+		agentClass: canonical,
+		tenantId: options.tenantId,
+		instances,
+		canAddInstance: true
+	};
+}
+async function addPersonaInstance(personas, options) {
+	const persona = await personas.create({
+		tenantId: options.tenantId,
+		agentClass: canonicalAgentClass(options.agentClass),
+		name: options.name,
+		instructions: options.instructions ?? "",
+		contextType: options.contextType ?? null,
+		contextId: options.contextId ?? null,
+		priority: options.priority ?? 0,
+		enabled: options.enabled ?? true,
+		runAsUserId: options.runAsUserId,
+		actsAsProfileId: options.actsAsProfileId ?? null,
+		memoryScope: options.memoryScope ?? ""
+	});
+	if (options.allowedTools) persona.setAllowedTools(options.allowedTools);
+	await persona.save();
+	return persona;
+}
+async function removePersonaInstance(personas, personaId) {
+	const persona = await personas.get({ id: personaId });
+	if (!persona) return false;
+	await persona.delete();
+	return true;
+}
+async function upgradeSingletonToDefaultPersona(personas, options) {
+	const canonical = canonicalAgentClass(options.agentClass);
+	const existingDefault = (await personas.byTenantAndClass(options.tenantId, canonical)).find(isDefaultPersona);
+	if (existingDefault) return {
+		persona: existingDefault,
+		created: false,
+		instanceKey: null
+	};
+	return {
+		persona: await addPersonaInstance(personas, {
+			tenantId: options.tenantId,
+			agentClass: canonical,
+			name: DEFAULT_PERSONA_NAME,
+			runAsUserId: options.runAsUserId,
+			instructions: options.instructions,
+			allowedTools: options.allowedTools,
+			memoryScope: options.memoryScope,
+			actsAsProfileId: options.actsAsProfileId,
+			priority: 0,
+			enabled: true
+		}),
+		created: true,
+		instanceKey: null
+	};
+}
+//#endregion
 //#region src/persona-resolver.ts
 function availabilityFromResolvedAgent(resolved, options = {}) {
 	if (!resolved) return null;
@@ -285,6 +969,132 @@ function resolveMemoryScope(explicit, ctx) {
 	return `${ctx.canonical}:${ctx.tenantId}${contextSuffix}`;
 }
 //#endregion
-export { AgentPersona, AgentPersonaCollection, PersonaResolver, availabilityFromResolvedAgent, canonicalAgentClass, personaAppliesToContext, personaContextRank };
+//#region src/reflection-runner.ts
+function normalizePersona(input) {
+	if (!input.id) throw new Error("ReflectionRunner.run requires a persisted persona (missing id)");
+	if (!input.tenantId) throw new Error("ReflectionRunner.run requires a tenant-scoped persona (missing tenantId)");
+	return {
+		id: input.id,
+		tenantId: input.tenantId,
+		agentClass: input.agentClass,
+		name: input.name,
+		instructions: input.instructions,
+		memoryScope: input.memoryScope
+	};
+}
+function meanConfidence(episodes) {
+	if (episodes.length === 0) return .5;
+	return episodes.reduce((acc, e) => acc + e.confidence, 0) / episodes.length;
+}
+var ReflectionRunner = class {
+	db;
+	reflect;
+	now;
+	_principal;
+	proposalsCol;
+	feedbackCol;
+	constructor(options) {
+		this.db = options.db;
+		this._principal = options.principal;
+		this.reflect = options.reflect;
+		this.now = options.now ?? (() => /* @__PURE__ */ new Date());
+		this.proposalsCol = options.proposals;
+		this.feedbackCol = options.feedback;
+	}
+	/**
+	* The autonomous principal this runner acts as. Exposed so callers can prove
+	* it cannot activate a proposal (it lacks `personas.activate-directive`).
+	*/
+	get principal() {
+		return this._principal;
+	}
+	/**
+	* Run one reflection pass for a persona.
+	*/
+	async run(options) {
+		const { memory } = options;
+		const persona = normalizePersona(options.persona);
+		const feedbackCol = await this.feedbackCollection();
+		const feedbackLimit = options.feedbackLimit ?? 50;
+		let feedback = await feedbackCol.forPersona(persona.id, { limit: feedbackLimit });
+		if (options.lookbackMs != null) {
+			const cutoff = this.now().getTime() - options.lookbackMs;
+			feedback = feedback.filter((f) => {
+				return (f.created_at ? new Date(f.created_at).getTime() : 0) >= cutoff;
+			});
+		}
+		let reinforced = 0;
+		for (const signal of feedback) {
+			if (signal.reinforcedAt) continue;
+			if (signal.correlationType !== "directive_proposal") {
+				if (await reinforceFromFeedback(memory, signal, { ratingNeutral: options.ratingNeutral })) reinforced += 1;
+			}
+			signal.reinforcedAt = this.now();
+			await signal.save();
+		}
+		const episodes = options.episodeScope ? await memory.recall(options.episodeScope, {
+			minConfidence: 0,
+			includeAncestors: true
+		}) : [];
+		ensurePersonaInstructionsPrompt(persona);
+		const currentInstructions = await resolvePersonaInstructions({
+			persona,
+			db: this.db
+		});
+		const draft = await this.reflect({
+			persona,
+			currentInstructions,
+			episodes,
+			feedback
+		});
+		if (!draft || draft.instructions.trim() === currentInstructions.trim()) return {
+			proposals: [],
+			reinforced,
+			skipped: draft ? 1 : 0
+		};
+		const promptKey = options.promptKey ?? personaInstructionsPromptKey(persona);
+		const fingerprint = computeDirectiveFingerprint(persona.id, promptKey, draft.instructions);
+		const proposals = await this.proposalsCollection();
+		if ((await proposals.findByFingerprint(persona.id, fingerprint)).length > 0) return {
+			proposals: [],
+			reinforced,
+			skipped: 1
+		};
+		return {
+			proposals: [await proposals.create({
+				tenantId: persona.tenantId,
+				personaId: persona.id,
+				agentClass: persona.agentClass ?? "",
+				promptKey,
+				proposedInstructions: draft.instructions,
+				currentInstructions,
+				rationale: draft.rationale,
+				status: "pending",
+				fingerprint,
+				confidence: draft.confidence ?? meanConfidence(episodes),
+				proposedBy: this._principal.id ?? "reflection",
+				evidence: JSON.stringify({
+					episodeIds: episodes.map((e) => e.id),
+					feedbackIds: feedback.map((f) => f.id).filter((id) => Boolean(id))
+				})
+			})],
+			reinforced,
+			skipped: 0
+		};
+	}
+	async proposalsCollection() {
+		if (!this.proposalsCol) this.proposalsCol = await DirectiveProposalCollection.create({ db: this.db });
+		return this.proposalsCol;
+	}
+	async feedbackCollection() {
+		if (!this.feedbackCol) this.feedbackCol = await FeedbackCollection.create({ db: this.db });
+		return this.feedbackCol;
+	}
+};
+//#endregion
+//#region src/index.ts
+ensurePersonaPermissionsRegistered();
+//#endregion
+export { ACTIVATE_DIRECTIVE_PERMISSION, AgentPersona, AgentPersonaCollection, DEFAULT_PERSONA_NAME, DIRECTIVE_ACTIVATION_PERMISSION_DEF, DirectiveActivationDeniedError, DirectiveApprovalService, DirectiveNotPendingError, DirectiveProposal, DirectiveProposalCollection, Feedback, FeedbackCollection, HUMAN_SIGNAL_TYPES, PersonaResolver, ReflectionRunner, addPersonaInstance, agentOptionsForPersona, applyPersonaInstructions, availabilityFromResolvedAgent, buildPersonaInstanceAdmin, canonicalAgentClass, computeDirectiveFingerprint, ensurePersonaInstructionsPrompt, ensurePersonaPermissionsRegistered, feedbackSourceFor, isDefaultPersona, personaAppliesToContext, personaContextRank, personaInstanceKey, personaInstructionsPromptKey, personaLearningMemory, personaMemoryScope, principalFromPermissions, registerPersonaPermissions, reinforceFromFeedback, removePersonaInstance, resolveDirectivePrincipal, resolvePersonaInstructions, schedulePersonaInstance, upgradeSingletonToDefaultPersona, upsertPromptTemplateOverride };
 
 //# sourceMappingURL=index.js.map