@ai-matrx/agents 0.9.2 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## 0.10.0 — 2026-09-09
+
+**`@ai-matrx/agents/mandates` — clients stop typing mandate keys by hand.**
+
+A TypeScript client never declares a mandate: aidream's `declare_mandate` is the
+only declaration path in the system. Until now clients still *named* mandates
+with hand-typed string literals and local `mandates.ts` mirror files, so a typo,
+a rename, or a retired key failed at run time as a 404 nobody saw — and the
+release report had no way to resolve a client's references against the key set
+the client actually shipped.
+
+This release publishes that key set. `mandates/keys.generated.ts` is emitted by
+THE ONE GENERATOR (`aidream/scripts/mandates_generate.py`, stage (h)) from the
+in-process declarations — the same `declared_mandates()` the boot sync writes the
+database from — and cross-checked against the live `origin='code'` rows on every
+credentialed pass. The key set of every published version is committed beside it
+under `mandates/snapshots/keys.<version>.json` and ships in the tarball, so a
+scan can resolve a client's references against the key set of the exact version
+it depends on (Mandate Declaration & Usage Reporting, DESIGN § 4.5 step 2).
+
+### Consumer action
+
+Import keys from `@ai-matrx/agents/mandates`; hand-typed key literals and local
+`mandates.ts` mirrors are retired — lane L6.
+
+- `MANDATE_KEYS` — every declared key, keyed by THE IDENTIFIER RULE (`.` → `__`,
+  anything outside `[A-Za-z0-9_]` → `_`, a leading digit gets an `_`): so
+  `seo.keyword_classifier` is `MANDATE_KEYS.seo__keyword_classifier`.
+- `type MandateKey` — the union. Type every carrier parameter with it: a
+  made-up key then fails type-check instead of failing in production.
+  `as MandateKey` casts are the same defect the literals were.
+- `isMandateKey(x)` / `assertMandateKey(x, context?)` for anything that crossed
+  a wire (a URL segment, a stored preference, a row's `mandate_key`).
+- `MANDATE_FAMILIES` — prefix → members, for a family aidream declares from the
+  feature's own roster; `MandateFamilyMember<P>` types one member.
+- `mandateKeyOfApp(appSlug, surfaceSlug?)` / `mandateKeyOfShortcut(slug,
+  surfaceSlug?)` for the DB-authored `app.*` / `shortcut.*` families. They return
+  a branded `DynamicMandateKey`, deliberately **not** assignable to `MandateKey`
+  — no generated union can contain a row a user created five minutes ago. A
+  carrier that genuinely accepts either says `MandateKey | DynamicMandateKey`.
+- `RETIRING_MANDATE_KEYS` / `MANDATE_KEYS_META` — the deprecation list and the
+  aidream revision + generator version the key set came from.
+
+**Two-phase retire.** A key that stops being declared does not disappear: it is
+emitted `@deprecated retiring since <version>`, stays in the `MandateKey` union,
+and leaves only after three already-published versions have shipped it that way.
+A client that lags one release gets a deprecation warning with a remedy, never a
+hard type error it cannot act on until it upgrades.
+
+### Additive only
+
+No export was removed, renamed or re-signed. `./mandates` is a new subpath; every
+existing entry is untouched.
+
 ## 0.9.2 — 2026-09-09
 
 **THE ARCHIVED-ITEMS LAW, APPLIED TO THE PICKER — the first instance of a

package/dist/mandates/index.cjs

@@ -0,0 +1,513 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// mandates/index.ts
+var mandates_exports = {};
+__export(mandates_exports, {
+  ALL_MANDATE_KEYS: () => ALL_MANDATE_KEYS,
+  DYNAMIC_MANDATE_FAMILIES: () => DYNAMIC_MANDATE_FAMILIES,
+  MANDATE_FAMILIES: () => MANDATE_FAMILIES,
+  MANDATE_KEYS: () => MANDATE_KEYS,
+  MANDATE_KEYS_META: () => MANDATE_KEYS_META,
+  RETIRING_MANDATE_KEYS: () => RETIRING_MANDATE_KEYS,
+  assertMandateKey: () => assertMandateKey,
+  isMandateKey: () => isMandateKey,
+  mandateKeyOfApp: () => mandateKeyOfApp,
+  mandateKeyOfShortcut: () => mandateKeyOfShortcut
+});
+module.exports = __toCommonJS(mandates_exports);
+
+// mandates/keys.generated.ts
+var MANDATE_KEYS_META = {
+  aidreamRevision: "068266e5f1573c84c63916423d32ceac77827a34",
+  generatorVersion: "1.0.0",
+  packageVersion: "0.10.0",
+  retireWindow: 3
+};
+var MANDATE_KEYS = {
+  agent_apps__auto_create: "agent_apps.auto_create",
+  agent_apps__auto_create_lightning: "agent_apps.auto_create_lightning",
+  agent_apps__metadata: "agent_apps.metadata",
+  agent_apps__prompt_app_dev: "agent_apps.prompt_app_dev",
+  agent_factory__structure_builder: "agent_factory.structure_builder",
+  ambient__page_guidance: "ambient.page_guidance",
+  chat__cx_default: "chat.cx_default",
+  chat__default_new_chat: "chat.default_new_chat",
+  chat__quick_audio_plan: "chat.quick_audio_plan",
+  chat__quick_fair_news: "chat.quick_fair_news",
+  chat__quick_flashcards: "chat.quick_flashcards",
+  chat__quick_image: "chat.quick_image",
+  chat__quick_org_chart: "chat.quick_org_chart",
+  chat__quick_research: "chat.quick_research",
+  chat__quick_showcase: "chat.quick_showcase",
+  chat__quick_writing_partner: "chat.quick_writing_partner",
+  chat__response_mode_brainstorm: "chat.response_mode_brainstorm",
+  chat__response_mode_data: "chat.response_mode_data",
+  chat__response_mode_research: "chat.response_mode_research",
+  chat__response_mode_video: "chat.response_mode_video",
+  code_editor__code_edit: "code_editor.code_edit",
+  code_editor__dynamic_context_edit: "code_editor.dynamic_context_edit",
+  code_editor__prompt_app_ui_edit: "code_editor.prompt_app_ui_edit",
+  coding_session__managed_translation_reference: "coding_session.managed_translation_reference",
+  commerce_intake__assess_value: "commerce_intake.assess_value",
+  commerce_intake__extract_vision: "commerce_intake.extract_vision",
+  commerce_intake__grading: "commerce_intake.grading",
+  commerce_intake__instant_analysis: "commerce_intake.instant_analysis",
+  commerce_intake__refute_no_value: "commerce_intake.refute_no_value",
+  commerce_intake__research_product: "commerce_intake.research_product",
+  commerce_intake__segment_photos: "commerce_intake.segment_photos",
+  commerce_intake__verify_enrichment: "commerce_intake.verify_enrichment",
+  content_ir__component_artisan: "content_ir.component_artisan",
+  content_ir__kind_architect: "content_ir.kind_architect",
+  content_ir__kind_component_builder: "content_ir.kind_component_builder",
+  content_ir__kind_creator: "content_ir.kind_creator",
+  content_plan__brief_writer: "content_plan.brief_writer",
+  content_plan__entity_attacher: "content_plan.entity_attacher",
+  content_plan__entity_curator: "content_plan.entity_curator",
+  content_plan__family_namer: "content_plan.family_namer",
+  content_plan__keyword_strategist: "content_plan.keyword_strategist",
+  content_plan__p3_family: "content_plan.p3_family",
+  content_plan__p4_write: "content_plan.p4_write",
+  content_plan__p5_review: "content_plan.p5_review",
+  content_plan__p6_build: "content_plan.p6_build",
+  content_plan__plan_reviewer: "content_plan.plan_reviewer",
+  content_plan__route_picker: "content_plan.route_picker",
+  content_plan__shape_planner: "content_plan.shape_planner",
+  conversation__action_auditor: "conversation.action_auditor",
+  conversation__decision_ledger: "conversation.decision_ledger",
+  conversation__drift_auditor: "conversation.drift_auditor",
+  conversation__outcome_summarizer: "conversation.outcome_summarizer",
+  conversation__vision_extractor: "conversation.vision_extractor",
+  conversation__vision_interviewer: "conversation.vision_interviewer",
+  crm__journalist_beat_analyst: "crm.journalist_beat_analyst",
+  crm__media_list_ranker: "crm.media_list_ranker",
+  crm__outreach_draft_reviewer: "crm.outreach_draft_reviewer",
+  crm__outreach_personalization_coach: "crm.outreach_personalization_coach",
+  crm__outreach_personalization_writer: "crm.outreach_personalization_writer",
+  crm__outreach_pitch_writer: "crm.outreach_pitch_writer",
+  crm__outreach_recipient_shortlister: "crm.outreach_recipient_shortlister",
+  crm__outreach_reply_drafter: "crm.outreach_reply_drafter",
+  crm__party_kind_judge: "crm.party_kind_judge",
+  crm__save_contact: "crm.save_contact",
+  data__page_guidance: "data.page_guidance",
+  dictionary__workspace_guide: "dictionary.workspace_guide",
+  education__admin_guidance: "education.admin_guidance",
+  education__analytics_narrate: "education.analytics_narrate",
+  education__audio_study_guidance: "education.audio_study_guidance",
+  education__card_image_generator: "education.card_image_generator",
+  education__card_image_prompt_writer: "education.card_image_prompt_writer",
+  education__card_image_qc_judge: "education.card_image_qc_judge",
+  education__card_image_web_source: "education.card_image_web_source",
+  education__classes_guidance: "education.classes_guidance",
+  education__creator_guidance: "education.creator_guidance",
+  education__data_guidance: "education.data_guidance",
+  education__exam_prep_guidance: "education.exam_prep_guidance",
+  education__family_guidance: "education.family_guidance",
+  education__fastfire_guidance: "education.fastfire_guidance",
+  education__features_guidance: "education.features_guidance",
+  education__flashcards_guidance: "education.flashcards_guidance",
+  education__game_guidance: "education.game_guidance",
+  education__grade_handwritten: "education.grade_handwritten",
+  education__grade_work_guidance: "education.grade_work_guidance",
+  education__kit_title: "education.kit_title",
+  education__learn_guidance: "education.learn_guidance",
+  education__levels_guidance: "education.levels_guidance",
+  education__library_guidance: "education.library_guidance",
+  education__media_guidance: "education.media_guidance",
+  education__memory_generate: "education.memory_generate",
+  education__memory_guidance: "education.memory_guidance",
+  education__memory_hint: "education.memory_hint",
+  education__mind_maps_guidance: "education.mind_maps_guidance",
+  education__mindmap_generate: "education.mindmap_generate",
+  education__notes_generate: "education.notes_generate",
+  education__notes_guidance: "education.notes_guidance",
+  education__offline_guidance: "education.offline_guidance",
+  education__page_guidance: "education.page_guidance",
+  education__plan_generate: "education.plan_generate",
+  education__planner_guidance: "education.planner_guidance",
+  education__practice_oral_guidance: "education.practice_oral_guidance",
+  education__practice_tests_guidance: "education.practice_tests_guidance",
+  education__progress_guidance: "education.progress_guidance",
+  education__quiz_deepen_item: "education.quiz_deepen_item",
+  education__quiz_generate: "education.quiz_generate",
+  education__quiz_generate_from_source: "education.quiz_generate_from_source",
+  education__quizzes_guidance: "education.quizzes_guidance",
+  education__spoken_practice_design: "education.spoken_practice_design",
+  education__spoken_practice_design_language: "education.spoken_practice_design_language",
+  education__spoken_practice_grade: "education.spoken_practice_grade",
+  education__spoken_practice_grade_pronunciation: "education.spoken_practice_grade_pronunciation",
+  education__spoken_practice_review: "education.spoken_practice_review",
+  education__start_guidance: "education.start_guidance",
+  education__study_aids_guidance: "education.study_aids_guidance",
+  education__study_pack_flashcards: "education.study_pack_flashcards",
+  education__study_pack_lessons: "education.study_pack_lessons",
+  education__study_pack_notes: "education.study_pack_notes",
+  education__study_pack_quiz: "education.study_pack_quiz",
+  education__study_pack_v2_flashcards: "education.study_pack_v2_flashcards",
+  education__study_pack_v2_lessons: "education.study_pack_v2_lessons",
+  education__study_pack_v2_notes: "education.study_pack_v2_notes",
+  education__study_pack_v2_quiz: "education.study_pack_v2_quiz",
+  education__subjects_guidance: "education.subjects_guidance",
+  education__summaries_guidance: "education.summaries_guidance",
+  education__summarize: "education.summarize",
+  education__tutor_guidance: "education.tutor_guidance",
+  education__tutor_message: "education.tutor_message",
+  education__voice_tutor: "education.voice_tutor",
+  extend__browser_chat: "extend.browser_chat",
+  extend__pattern_from_data: "extend.pattern_from_data",
+  extend__structured_extractor: "extend.structured_extractor",
+  flashcards__enrich_card: "flashcards.enrich_card",
+  flashcards__expand_card: "flashcards.expand_card",
+  flashcards__generate_cards: "flashcards.generate_cards",
+  flashcards__generate_from_source: "flashcards.generate_from_source",
+  flashcards__grade_spoken: "flashcards.grade_spoken",
+  flashcards__grade_typed_answer: "flashcards.grade_typed_answer",
+  flashcards__help_live: "flashcards.help_live",
+  flashcards__helper_tts: "flashcards.helper_tts",
+  flashcards__make_quiz_items: "flashcards.make_quiz_items",
+  flashcards__micro_coach: "flashcards.micro_coach",
+  flashcards__review_batch: "flashcards.review_batch",
+  flashcards__spoken_front_tts: "flashcards.spoken_front_tts",
+  flashcards__verify_against_source: "flashcards.verify_against_source",
+  foundry__planner: "foundry.planner",
+  growth_loop__quality_analyze: "growth_loop.quality_analyze",
+  growth_loop__quality_brief: "growth_loop.quality_brief",
+  growth_loop__quality_crawl: "growth_loop.quality_crawl",
+  growth_loop__quality_fill: "growth_loop.quality_fill",
+  growth_loop__quality_measure: "growth_loop.quality_measure",
+  growth_loop__quality_plan: "growth_loop.quality_plan",
+  growth_loop__quality_publish: "growth_loop.quality_publish",
+  growth_loop__quality_realize: "growth_loop.quality_realize",
+  growth_loop__quality_research: "growth_loop.quality_research",
+  growth_loop__quality_serve: "growth_loop.quality_serve",
+  growth_loop__quality_suggest: "growth_loop.quality_suggest",
+  growth_loop__quality_writeback: "growth_loop.quality_writeback",
+  growth_loop__supervisor: "growth_loop.supervisor",
+  hindsight__crystallizer: "hindsight.crystallizer",
+  hindsight__replay_judge: "hindsight.replay_judge",
+  hindsight__reviewer: "hindsight.reviewer",
+  human_decisions__fallback_decider: "human_decisions.fallback_decider",
+  iteration__architect: "iteration.architect",
+  iteration__diagnostic: "iteration.diagnostic",
+  iteration__root_cause: "iteration.root_cause",
+  iteration__thinking_display: "iteration.thinking_display",
+  kg__cluster_namer: "kg.cluster_namer",
+  kg__ner_extractor: "kg.ner_extractor",
+  knowledge__document_verifier: "knowledge.document_verifier",
+  knowledge__qa_generator: "knowledge.qa_generator",
+  knowledge__section_summarizer: "knowledge.section_summarizer",
+  local__cloud_chat: "local.cloud_chat",
+  marketing__endowment_analysis: "marketing.endowment_analysis",
+  marketing__endowment_portfolio: "marketing.endowment_portfolio",
+  marketing__image_prompt: "marketing.image_prompt",
+  marketing__page_image: "marketing.page_image",
+  marketing__page_image_all_in_one: "marketing.page_image_all_in_one",
+  marketing__video_metadata: "marketing.video_metadata",
+  masterwork__approach_selector: "masterwork.approach_selector",
+  masterwork__audition_judge: "masterwork.audition_judge",
+  masterwork__bad_draft: "masterwork.bad_draft",
+  masterwork__checkup_auditor: "masterwork.checkup_auditor",
+  masterwork__coherence_partner: "masterwork.coherence_partner",
+  masterwork__conductor: "masterwork.conductor",
+  masterwork__corpus_cleaner: "masterwork.corpus_cleaner",
+  masterwork__corpus_synthesizer: "masterwork.corpus_synthesizer",
+  masterwork__exception_hunter: "masterwork.exception_hunter",
+  masterwork__exemplar_distiller: "masterwork.exemplar_distiller",
+  masterwork__intake_designer: "masterwork.intake_designer",
+  masterwork__monologue_distiller: "masterwork.monologue_distiller",
+  masterwork__relationship_auditor: "masterwork.relationship_auditor",
+  masterwork__rule_improver: "masterwork.rule_improver",
+  masterwork__rulebook_auditor: "masterwork.rulebook_auditor",
+  masterwork__scout: "masterwork.scout",
+  masterwork__source_distiller: "masterwork.source_distiller",
+  masterwork__template__chief_edit: "masterwork.template.chief_edit",
+  masterwork__template__chief_generate: "masterwork.template.chief_generate",
+  masterwork__template__editor: "masterwork.template.editor",
+  masterwork__template__maker: "masterwork.template.maker",
+  masterwork__transcript_distiller: "masterwork.transcript_distiller",
+  masterwork__transcript_shortlister: "masterwork.transcript_shortlister",
+  masterwork__understudy: "masterwork.understudy",
+  media__youtube_analyzer: "media.youtube_analyzer",
+  meet__live_intelligence: "meet.live_intelligence",
+  meet__live_notes: "meet.live_notes",
+  meet__wrap_up: "meet.wrap_up",
+  messaging__action_item_extraction: "messaging.action_item_extraction",
+  messaging__conversation_catch_up: "messaging.conversation_catch_up",
+  messaging__conversation_summary: "messaging.conversation_summary",
+  messaging__reply_drafting: "messaging.reply_drafting",
+  ner__deep_chunk_extractor: "ner.deep_chunk_extractor",
+  ner__document_orienter: "ner.document_orienter",
+  ner__entity_canonicalizer: "ner.entity_canonicalizer",
+  ner__finisher: "ner.finisher",
+  ner__item_proposer: "ner.item_proposer",
+  ner__magic_moment_detector: "ner.magic_moment_detector",
+  ner__scope_proposer: "ner.scope_proposer",
+  ner__scope_slot_filler: "ner.scope_slot_filler",
+  ner__suggestion_reviewer: "ner.suggestion_reviewer",
+  ner__sweep_scope_discoverer: "ner.sweep_scope_discoverer",
+  ner__sweep_scope_reference_finder: "ner.sweep_scope_reference_finder",
+  ner__sweep_value_miner: "ner.sweep_value_miner",
+  notes__organizer: "notes.organizer",
+  notes__page_guidance: "notes.page_guidance",
+  observability__tool_trace_pattern_detection: "observability.tool_trace_pattern_detection",
+  observability__tool_trace_triage: "observability.tool_trace_triage",
+  orchestras__role_describer: "orchestras.role_describer",
+  pdf__content_cleaner: "pdf.content_cleaner",
+  podcast__audience_adapter: "podcast.audience_adapter",
+  podcast__audio_dialogue: "podcast.audio_dialogue",
+  podcast__audio_english: "podcast.audio_english",
+  podcast__audio_persian: "podcast.audio_persian",
+  podcast__chapter_marker: "podcast.chapter_marker",
+  podcast__content_extractor: "podcast.content_extractor",
+  podcast__deep_research: "podcast.deep_research",
+  podcast__image_v1: "podcast.image_v1",
+  podcast__image_v2: "podcast.image_v2",
+  podcast__image_v3: "podcast.image_v3",
+  podcast__image_v4: "podcast.image_v4",
+  podcast__image_v5: "podcast.image_v5",
+  podcast__image_v6_feature: "podcast.image_v6_feature",
+  podcast__image_v6_feature_prompt: "podcast.image_v6_feature_prompt",
+  podcast__live_rewrite: "podcast.live_rewrite",
+  podcast__metadata: "podcast.metadata",
+  podcast__multihost_script: "podcast.multihost_script",
+  podcast__post_prep_expansion: "podcast.post_prep_expansion",
+  podcast__post_prep_fact_checking: "podcast.post_prep_fact_checking",
+  podcast__post_prep_summarization: "podcast.post_prep_summarization",
+  podcast__post_prep_translation: "podcast.post_prep_translation",
+  podcast__race_frontier: "podcast.race_frontier",
+  podcast__relevance_gate: "podcast.relevance_gate",
+  podcast__roundtable_script: "podcast.roundtable_script",
+  podcast__script_educational: "podcast.script_educational",
+  podcast__script_news: "podcast.script_news",
+  podcast__script_persian: "podcast.script_persian",
+  podcast__solo_script: "podcast.solo_script",
+  podcast__title_optimizer: "podcast.title_optimizer",
+  podcast__video_v1: "podcast.video_v1",
+  podcast__video_v2: "podcast.video_v2",
+  podcast_client__blog_writer: "podcast_client.blog_writer",
+  podcast_client__show_notes: "podcast_client.show_notes",
+  podcast_client__topic_ideas: "podcast_client.topic_ideas",
+  podcast_client__web_content_extractor: "podcast_client.web_content_extractor",
+  podcast_client__youtube_research: "podcast_client.youtube_research",
+  projects__creation_guide: "projects.creation_guide",
+  proof_runs__judge: "proof_runs.judge",
+  purpose__writer: "purpose.writer",
+  rag__chunk_contextualizer: "rag.chunk_contextualizer",
+  rag__hyde_generator: "rag.hyde_generator",
+  rag__pdf_page_cleaner: "rag.pdf_page_cleaner",
+  rag__query_expander: "rag.query_expander",
+  research__auto_tagger: "research.auto_tagger",
+  research__condenser_1: "research.condenser_1",
+  research__condenser_2: "research.condenser_2",
+  research__coverage_audit: "research.coverage_audit",
+  research__cross_cutting_tags: "research.cross_cutting_tags",
+  research__document_assembly: "research.document_assembly",
+  research__keyword_synthesis: "research.keyword_synthesis",
+  research__report: "research.report",
+  research__report_updater: "research.report_updater",
+  research__source_authority: "research.source_authority",
+  research__structured_page_summary: "research.structured_page_summary",
+  research__suggest_setup: "research.suggest_setup",
+  research__tag_consolidation: "research.tag_consolidation",
+  research_client__output_blog: "research_client.output_blog",
+  research_client__output_brand_profile: "research_client.output_brand_profile",
+  research_client__output_competitive_landscape: "research_client.output_competitive_landscape",
+  research_client__output_gap_analysis: "research_client.output_gap_analysis",
+  research_client__output_literature_review: "research_client.output_literature_review",
+  research_client__output_reputation_business: "research_client.output_reputation_business",
+  research_client__output_reputation_personal: "research_client.output_reputation_personal",
+  research_client__output_seo: "research_client.output_seo",
+  research_client__output_slides: "research_client.output_slides",
+  scraper__fact_check: "scraper.fact_check",
+  scraper__keyword_analysis: "scraper.keyword_analysis",
+  seo__ai_visibility_decision_analyst: "seo.ai_visibility_decision_analyst",
+  seo__backlink_context_assessor: "seo.backlink_context_assessor",
+  seo__backlink_work_planner: "seo.backlink_work_planner",
+  seo__business_model_verdict: "seo.business_model_verdict",
+  seo__competitor_classifier: "seo.competitor_classifier",
+  seo__competitor_opportunity_autopsy: "seo.competitor_opportunity_autopsy",
+  seo__competitor_page_autopsy: "seo.competitor_page_autopsy",
+  seo__coverage_analyst: "seo.coverage_analyst",
+  seo__digital_pr_reputation_adjudicator: "seo.digital_pr_reputation_adjudicator",
+  seo__evidence_workbench: "seo.evidence_workbench",
+  seo__finding_fixer: "seo.finding_fixer",
+  seo__guidelines_drafter: "seo.guidelines_drafter",
+  seo__ideal_customer_profile: "seo.ideal_customer_profile",
+  seo__keyword_classifier: "seo.keyword_classifier",
+  seo__keyword_expander: "seo.keyword_expander",
+  seo__keyword_researcher: "seo.keyword_researcher",
+  seo__keyword_serp_intent_analyst: "seo.keyword_serp_intent_analyst",
+  seo__landscape_brief: "seo.landscape_brief",
+  seo__money_map: "seo.money_map",
+  seo__offering_extraction: "seo.offering_extraction",
+  seo__offering_valuation: "seo.offering_valuation",
+  seo__page_analyzer: "seo.page_analyzer",
+  seo__page_keyword_mapper: "seo.page_keyword_mapper",
+  seo__press_source_request_responder: "seo.press_source_request_responder",
+  seo__press_story_analyst: "seo.press_story_analyst",
+  seo__site_intake: "seo.site_intake",
+  seo__site_link_authority_router: "seo.site_link_authority_router",
+  seo__site_strategist: "seo.site_strategist",
+  seo__starter_pack_proposer: "seo.starter_pack_proposer",
+  seo__topic_assigner: "seo.topic_assigner",
+  sms__owner_beta: "sms.owner_beta",
+  surfaces_client__binding_mapper: "surfaces_client.binding_mapper",
+  tasks__triage: "tasks.triage",
+  tool_viz__component_generator: "tool_viz.component_generator",
+  tools__summarize_content: "tools.summarize_content",
+  transcript_studio__document_edit: "transcript_studio.document_edit",
+  transcript_studio__scribe_live: "transcript_studio.scribe_live",
+  vision_interview__adversary: "vision_interview.adversary",
+  vision_interview__amplifier: "vision_interview.amplifier",
+  vision_interview__answer_tracker: "vision_interview.answer_tracker",
+  vision_interview__archaeologist: "vision_interview.archaeologist",
+  vision_interview__architect: "vision_interview.architect",
+  vision_interview__cartographer: "vision_interview.cartographer",
+  vision_interview__requirements_author: "vision_interview.requirements_author",
+  vision_interview__scribe: "vision_interview.scribe",
+  vision_interview__sounding_board: "vision_interview.sounding_board",
+  vision_interview__transcript_cleaner: "vision_interview.transcript_cleaner",
+  vision_interview__vision_author: "vision_interview.vision_author",
+  voice__communicator: "voice.communicator",
+  voice__intro: "voice.intro",
+  voice__owner_beta: "voice.owner_beta",
+  war_room__master: "war_room.master",
+  war_room__room: "war_room.room",
+  war_room__thread: "war_room.thread",
+  web__endpoint_family_judge: "web.endpoint_family_judge",
+  workflow__complex_research__keyword_synthesis: "workflow.complex_research.keyword_synthesis",
+  workflow__complex_research__page_summary: "workflow.complex_research.page_summary",
+  workflow__complex_research__report: "workflow.complex_research.report",
+  workflow__conductor: "workflow.conductor",
+  workflow__deep_research__keyword_synthesis: "workflow.deep_research.keyword_synthesis",
+  workflow__extract_namer: "workflow.extract_namer",
+  workflow__plan_design: "workflow.plan_design",
+  workflow__plan_input_kind_authoring: "workflow.plan_input_kind_authoring",
+  workflow__plan_node_type_recommender: "workflow.plan_node_type_recommender",
+  workflow__plan_notes_writer: "workflow.plan_notes_writer",
+  workflow__plan_output_kind_authoring: "workflow.plan_output_kind_authoring",
+  workflow__recovery_advisor: "workflow.recovery_advisor",
+  workflow__run_assist_suggester: "workflow.run_assist_suggester",
+  workflow__steward: "workflow.steward",
+  workflow__steward__agent_run: "workflow.steward.agent_run",
+  workflow__steward__data: "workflow.steward.data",
+  workflow__steward__decision: "workflow.steward.decision",
+  workflow__steward__user_input: "workflow.steward.user_input"
+};
+var ALL_MANDATE_KEYS = Object.values(MANDATE_KEYS);
+var RETIRING_MANDATE_KEYS = {};
+var MANDATE_FAMILIES = {
+  "ambient.page_guidance_overrides": [
+    "data.page_guidance",
+    "education.admin_guidance",
+    "education.audio_study_guidance",
+    "education.classes_guidance",
+    "education.creator_guidance",
+    "education.data_guidance",
+    "education.exam_prep_guidance",
+    "education.family_guidance",
+    "education.fastfire_guidance",
+    "education.features_guidance",
+    "education.flashcards_guidance",
+    "education.game_guidance",
+    "education.grade_work_guidance",
+    "education.learn_guidance",
+    "education.levels_guidance",
+    "education.library_guidance",
+    "education.media_guidance",
+    "education.memory_guidance",
+    "education.mind_maps_guidance",
+    "education.notes_guidance",
+    "education.offline_guidance",
+    "education.page_guidance",
+    "education.planner_guidance",
+    "education.practice_oral_guidance",
+    "education.practice_tests_guidance",
+    "education.progress_guidance",
+    "education.quizzes_guidance",
+    "education.start_guidance",
+    "education.study_aids_guidance",
+    "education.subjects_guidance",
+    "education.summaries_guidance",
+    "education.tutor_guidance",
+    "notes.page_guidance"
+  ],
+  "conversation": [
+    "conversation.action_auditor",
+    "conversation.decision_ledger",
+    "conversation.drift_auditor",
+    "conversation.outcome_summarizer",
+    "conversation.vision_extractor",
+    "conversation.vision_interviewer"
+  ],
+  "vision_interview": [
+    "vision_interview.adversary",
+    "vision_interview.amplifier",
+    "vision_interview.answer_tracker",
+    "vision_interview.archaeologist",
+    "vision_interview.architect",
+    "vision_interview.cartographer",
+    "vision_interview.requirements_author",
+    "vision_interview.scribe",
+    "vision_interview.sounding_board",
+    "vision_interview.transcript_cleaner",
+    "vision_interview.vision_author"
+  ]
+};
+var DYNAMIC_MANDATE_FAMILIES = {
+  "app": { prefix: "app", note: "One mandate per user-built app (`mandate.definition` origin='user')." },
+  "shortcut": { prefix: "shortcut", note: "One mandate per user-authored shortcut (origin='user')." }
+};
+var DYNAMIC_SLUG = /^[a-z0-9]+(?:_[a-z0-9]+)*$/;
+function dynamicKey(prefix, ...slugs) {
+  const parts = slugs.filter((slug) => slug !== void 0);
+  if (parts.length === 0) {
+    throw new Error(
+      `mandate family "${prefix}" needs at least a member slug \u2014 it was given none.`
+    );
+  }
+  for (const slug of parts) {
+    if (!DYNAMIC_SLUG.test(slug)) {
+      throw new Error(
+        `mandate family "${prefix}" cannot name a member from ${JSON.stringify(slug)}: a segment is lowercase words joined by single underscores. Pass the slug the row carries, never a display name.`
+      );
+    }
+  }
+  return [prefix, ...parts].join(".");
+}
+function mandateKeyOfApp(appSlug, surfaceSlug) {
+  return dynamicKey("app", appSlug, surfaceSlug);
+}
+function mandateKeyOfShortcut(shortcutSlug, surfaceSlug) {
+  return dynamicKey("shortcut", shortcutSlug, surfaceSlug);
+}
+
+// mandates/index.ts
+var KEY_SET = new Set(ALL_MANDATE_KEYS);
+function isMandateKey(value) {
+  return typeof value === "string" && KEY_SET.has(value);
+}
+function assertMandateKey(value, context) {
+  if (isMandateKey(value)) return;
+  const where = context ? ` at ${context}` : "";
+  throw new Error(
+    `${JSON.stringify(value)} is not a declared mandate key${where}. @ai-matrx/agents@${MANDATE_KEYS_META.packageVersion} ships ${ALL_MANDATE_KEYS.length} keys (aidream ${MANDATE_KEYS_META.aidreamRevision.slice(0, 12)}). If the key is real, this package is behind \u2014 take \`latest\` and re-check. If it is a user-built app or shortcut, it is DB-authored: build it with mandateKeyOfApp() / mandateKeyOfShortcut(), which return DynamicMandateKey.`
+  );
+}
+//# sourceMappingURL=index.cjs.map