@sema-agent/core/dist/core/governance-codes.js

Stateless, task-oriented AI agent core

export const GOVERNANCE_CODES = {
    "usage.window_exhausted": "terminal",
    "memory.admission_required": "transient",
    "memory.admission_denied": "terminal",
    "config.compliance_required": "transient",
    "config.compliance_denied": "terminal",
    "config.locked_key": "terminal",
    "memory.capture_optout_denied": "terminal",
};
export const NON_GOVERNANCE_MEMORY_CODES = new Set([
    "memory.secret_detected",
    "memory.promotable_ungated",
    "memory.announce_failed",
    "memory.partition_adopt_failed",
    "memory.partition_split",
    "memory.layout_migrated",
    "memory.layer_locked_legacy",
    "memory.layout_unowned_root_content",
    "memory.tail",
    "memory.pollution_mark_failed",
    "memory.session_incarnation_mismatch",
    "memory.session_incarnation_unreadable",
    "memory.session_polluted",
    "memory.harvest_quarantined",
    "memory.delegation_static_mark_waived",
    "memory.content_class_declared",
    "memory.consolidation_driver_superseded",
    "memory.challenge_sweep_failed",
    "memory.lineage_settle_failed",
    "memory.challenge_ledger_corrupt",
    "memory.consolidation_recommended",
    "memory.consolidation_committed",
    "memory.consolidation_incomplete",
    "memory.consolidation_conflict",
    "memory.consolidation_refused",
    "memory.consolidation_withheld",
    "memory.restore_withheld",
    "memory.project_scope_absent",
    "memory.projection_failed",
    "memory.observation_settlement_unavailable",
    "memory.consolidation_disabled",
    "memory.consolidation_gated",
    "memory.consolidation_busy",
    "memory.consolidation_stale_snapshot",
    "memory.consolidation_gate_corrupt",
    "memory.consolidation_governance_unreadable",
    "memory.consolidation_lease_unavailable",
    "memory.consolidation_backend_failed",
    "memory.consolidation_gate_failed",
    "memory.active_set_collapse",
    "memory.challenge_ledger_oversize",
    "memory.control_plane_rebuilt",
    "memory.control_plane_not_corrupt",
    "memory.erasure_evidence_unavailable",
    "memory.erasure_selector_mismatch",
    "memory.erasure_census_incomplete",
    "memory.erasure_index_residue",
    "memory.export_incomplete",
    "memory.import_rejected",
    "memory.hold_opened",
    "memory.hold_released",
    "memory.hold_disposed",
    "memory.settlement_resolve_unattributed",
    "memory.settlement_resolve_invalid",
    "memory.settlement_resolve_unknown",
    "memory.session_account_resolve_unattributed",
    "memory.session_account_resolve_unknown",
    "memory.hold_resolve_unattributed",
    "memory.hold_resolve_invalid",
    "memory.hold_resolve_unknown",
    "memory.hold_resolve_invalid_state",
    "memory.settlement_record_failed",
    "memory.session_account_failed",
    "memory.origin_clear_unattributed",
    "memory.origin_clear_invalid",
    "memory.origin_clear_unknown",
    "memory.origin_clear_not_marked",
    "memory.origin_clear_challenged",
    "memory.origin_clear_pending",
    "memory.origin_clear_conflict",
    "memory.origin_clear_failed",
    "memory.capture_opted_out",
    "memory.capture_optout_unpersisted",
    "memory.capture_optout_unavailable",
    "memory.capture_optout_sweep_failed",
    "memory.target_outside_store",
]);
export function governanceRetryClass(code) {
    if (Object.prototype.hasOwnProperty.call(GOVERNANCE_CODES, code)) {
        return GOVERNANCE_CODES[code];
    }
    if (code.startsWith("usage."))
        return "terminal";
    return undefined;
}
export const TOOL_DECLARATION_CODES = Object.freeze([
    "config.tool_mount_denied",
    "config.tool_roster_bound",
    "config.tool_name_too_long",
    "config.tool_contract_too_long",
    "config.tool_schema_bound",
    "config.tool_face_invalid",
    "config.tool_name_invalid",
    "config.egress_requires_write_effect",
    "config.reserved_tool_name",
]);
export const RULE_SYNC_DROP_CODES = {
    invalid_rule_text: "inbound-refused-or-local-quarantined",
    metadata_mismatch: "inbound-refused-or-local-quarantined",
    own_actor_forged: "inbound-refused",
    dot_identity_conflict: "inbound-refused",
    below_gc_frontier: "local-quarantined",
    server_rejected: "local-quarantined",
    session_scope_not_durable: "inbound-refused",
};
export const ENGINE_NOTICE_CODES = Object.freeze([
    "config.autocompact_window_clamped",
    "config.env_timeout_discarded",
    "config.materialize_env_discarded",
    "config.models_swapped",
    "config.context_settings_swapped",
    "config.read_face_swapped",
    "config.read_face_deployment_clamped",
    "config.write_face_swapped",
    "config.write_face_deployment_clamped",
    "config.tool_model_gate_removed",
    "config.tool_model_gate_unknown_class",
    "config.tool_model_gate_env_invalid",
    "config.artifact_host_invalid",
    "config.task_root_not_canonical",
    "config.write_protection_target_view_absent",
    "config.write_protection_unresolved",
    "config.execution_env_capability_invalid",
    "config.tool_card_undeclared",
    "config.tool_face_undeclared",
    "config.tool_face_invalid",
    "config.forward_sink_failed",
    "config.durable_gate_unavailable",
    "config.peer_admission_out_of_range",
    "config.peer_lane_unmounted",
    "config.secret_env_scrubbed",
    "config.permission_mode_unavailable",
    "permission.ask_released_by_mode",
    "permission.read_deny_unapplied",
    "permission.rule_store_unavailable",
    "permission.allowed_tool_not_granted",
    "peer.inbound_disposition",
    "peer.held_settled",
    "peer.idle_subscription",
    "classifier.denial_limit",
    "classifier.fallback",
    "classifier.role_defaulted",
    "classifier.contract_broken",
    "classifier.unavailable",
    "checkpoint.execution_outcome_unrecorded",
    "delegation.transcript_integrity",
    "delegation.ask_unresolvable",
    "mcp.injection_dropped",
    "mcp.revocation_probe_failed",
    "mcp.server_redialed",
    "workflow.governance_key_stripped",
    "workflow.agent_option_ignored",
    "memory.session_polluted",
    "memory.harvest_quarantined",
    "memory.delegation_static_mark_waived",
    "memory.content_class_declared",
    "memory.hold_opened",
    "memory.hold_released",
    "memory.hold_disposed",
    "memory.consolidation_recommended",
    "memory.consolidation_committed",
    "memory.consolidation_conflict",
    "memory.consolidation_incomplete",
    "memory.consolidation_refused",
    "memory.consolidation_withheld",
    "memory.restore_withheld",
    "memory.project_scope_absent",
    "route.fallback_to_primary",
    "route.classifier_unroutable",
    "route.base_url_changed_key_unchanged",
    "route.response_model_mismatch",
    "route.tool_call_id_folded",
    "context.tool_turn_repaired",
    "task.user_steer_undrained",
    "task.user_followup_undrained",
    "steering.parked_input_blocked",
    "task.turn_interrupted",
    "task.halt_unconsumed",
    "task.late_approval",
    "task.interrupt_unconsumed",
    "task.tool_turn_incomplete",
    "approval.read_root_granted",
    "approval.read_root_grant_rejected",
    "memory.capture_opted_out",
    "memory.capture_optout_unpersisted",
    "skills.listing_truncated",
    "agents.listing_truncated",
    "tool_result.offload_put_failed",
    "instructions.source_changed",
    "session.records_skipped",
    "memory.layer_locked_legacy",
    "server.model_unreachable",
]);
const NOTICE_AUDIENCE_TABLE = {
    "memory.session_polluted": "user",
    "memory.harvest_quarantined": "user",
    "memory.delegation_static_mark_waived": "user",
    "memory.hold_opened": "user",
    "memory.hold_released": "user",
    "memory.hold_disposed": "user",
    "task.user_steer_undrained": "user",
    "task.user_followup_undrained": "user",
    "classifier.denial_limit": "user",
    "classifier.unavailable": "user",
    "classifier.fallback": "operator",
    "classifier.role_defaulted": "operator",
    "classifier.contract_broken": "operator",
    "task.turn_interrupted": "user",
    "steering.parked_input_blocked": "user",
    "task.halt_unconsumed": "user",
    "task.late_approval": "user",
    "task.interrupt_unconsumed": "user",
    "task.tool_turn_incomplete": "user",
    "approval.read_root_granted": "user",
    "approval.read_root_grant_rejected": "user",
    "config.durable_gate_unavailable": "user",
    "config.permission_mode_unavailable": "user",
    "permission.ask_released_by_mode": "user",
    "permission.read_deny_unapplied": "user",
    "permission.rule_store_unavailable": "user",
    "permission.allowed_tool_not_granted": "user",
    "memory.capture_opted_out": "user",
    "memory.capture_optout_unpersisted": "user",
    "memory.consolidation_withheld": "operator",
    "delegation.ask_unresolvable": "user",
    "config.autocompact_window_clamped": "operator",
    "config.env_timeout_discarded": "operator",
    "config.materialize_env_discarded": "operator",
    "config.models_swapped": "operator",
    "config.context_settings_swapped": "operator",
    "config.read_face_swapped": "operator",
    "config.read_face_deployment_clamped": "operator",
    "config.write_face_swapped": "operator",
    "config.write_face_deployment_clamped": "operator",
    "config.tool_model_gate_removed": "operator",
    "config.tool_model_gate_unknown_class": "operator",
    "config.tool_model_gate_env_invalid": "operator",
    "config.artifact_host_invalid": "operator",
    "config.task_root_not_canonical": "operator",
    "config.write_protection_target_view_absent": "operator",
    "config.write_protection_unresolved": "operator",
    "config.execution_env_capability_invalid": "operator",
    "config.tool_card_undeclared": "operator",
    "config.tool_face_undeclared": "operator",
    "config.tool_face_invalid": "operator",
    "config.peer_lane_unmounted": "operator",
    "config.peer_admission_out_of_range": "operator",
    "config.secret_env_scrubbed": "operator",
    "peer.inbound_disposition": "user",
    "peer.held_settled": "user",
    "peer.idle_subscription": "user",
    "delegation.transcript_integrity": "operator",
    "checkpoint.execution_outcome_unrecorded": "operator",
    "mcp.injection_dropped": "user",
    "mcp.revocation_probe_failed": "operator",
    "mcp.server_redialed": "operator",
    "workflow.governance_key_stripped": "operator",
    "workflow.agent_option_ignored": "operator",
    "memory.content_class_declared": "operator",
    "memory.consolidation_recommended": "operator",
    "memory.consolidation_committed": "operator",
    "memory.consolidation_conflict": "operator",
    "memory.consolidation_incomplete": "operator",
    "memory.consolidation_refused": "operator",
    "memory.restore_withheld": "operator",
    "memory.project_scope_absent": "operator",
    "route.fallback_to_primary": "operator",
    "route.classifier_unroutable": "operator",
    "route.base_url_changed_key_unchanged": "operator",
    "route.response_model_mismatch": "operator",
    "route.tool_call_id_folded": "operator",
    "context.tool_turn_repaired": "operator",
    "skills.listing_truncated": "operator",
    "agents.listing_truncated": "operator",
    "tool_result.offload_put_failed": "operator",
    "config.forward_sink_failed": "operator",
    "instructions.source_changed": "user",
    "session.records_skipped": "user",
    "server.model_unreachable": "user",
    "memory.layer_locked_legacy": "operator",
};
export const NOTICE_AUDIENCE = NOTICE_AUDIENCE_TABLE;
export function noticeAudienceOf(code) {
    return NOTICE_AUDIENCE[code] ?? "operator";
}
const NOTICE_MINTER_TABLE = {
    "config.autocompact_window_clamped": "engine",
    "config.env_timeout_discarded": "engine",
    "config.materialize_env_discarded": "engine",
    "config.models_swapped": "engine",
    "config.context_settings_swapped": "engine",
    "config.read_face_swapped": "engine",
    "config.read_face_deployment_clamped": "engine",
    "config.write_face_swapped": "engine",
    "config.write_face_deployment_clamped": "engine",
    "config.tool_model_gate_removed": "engine",
    "config.tool_model_gate_unknown_class": "engine",
    "config.tool_model_gate_env_invalid": "engine",
    "config.artifact_host_invalid": "engine",
    "config.task_root_not_canonical": "engine",
    "config.write_protection_target_view_absent": "engine",
    "config.write_protection_unresolved": "engine",
    "config.execution_env_capability_invalid": "engine",
    "config.tool_card_undeclared": "engine",
    "config.tool_face_undeclared": "engine",
    "config.tool_face_invalid": "engine",
    "config.forward_sink_failed": "engine",
    "config.durable_gate_unavailable": "engine",
    "config.peer_admission_out_of_range": "engine",
    "config.peer_lane_unmounted": "engine",
    "config.secret_env_scrubbed": "engine",
    "config.permission_mode_unavailable": "engine",
    "permission.ask_released_by_mode": "engine",
    "permission.read_deny_unapplied": "engine",
    "permission.rule_store_unavailable": "engine",
    "permission.allowed_tool_not_granted": "engine",
    "peer.inbound_disposition": "engine",
    "peer.held_settled": "engine",
    "peer.idle_subscription": "engine",
    "classifier.denial_limit": "engine",
    "classifier.fallback": "engine",
    "classifier.role_defaulted": "engine",
    "classifier.contract_broken": "engine",
    "classifier.unavailable": "engine",
    "checkpoint.execution_outcome_unrecorded": "engine",
    "delegation.transcript_integrity": "engine",
    "delegation.ask_unresolvable": "engine",
    "mcp.injection_dropped": "engine",
    "mcp.revocation_probe_failed": "engine",
    "mcp.server_redialed": "engine",
    "workflow.governance_key_stripped": "engine",
    "workflow.agent_option_ignored": "engine",
    "memory.session_polluted": "engine",
    "memory.harvest_quarantined": "engine",
    "memory.delegation_static_mark_waived": "engine",
    "memory.content_class_declared": "engine",
    "memory.hold_opened": "engine",
    "memory.hold_released": "engine",
    "memory.hold_disposed": "engine",
    "memory.consolidation_recommended": "engine",
    "memory.consolidation_committed": "engine",
    "memory.consolidation_conflict": "engine",
    "memory.consolidation_incomplete": "engine",
    "memory.consolidation_refused": "engine",
    "memory.consolidation_withheld": "engine",
    "memory.restore_withheld": "engine",
    "memory.project_scope_absent": "engine",
    "route.fallback_to_primary": "engine",
    "route.classifier_unroutable": "engine",
    "route.base_url_changed_key_unchanged": "engine",
    "route.response_model_mismatch": "engine",
    "route.tool_call_id_folded": "engine",
    "context.tool_turn_repaired": "engine",
    "task.user_steer_undrained": "engine",
    "task.user_followup_undrained": "engine",
    "steering.parked_input_blocked": "engine",
    "task.turn_interrupted": "engine",
    "task.halt_unconsumed": "engine",
    "task.late_approval": "engine",
    "task.interrupt_unconsumed": "engine",
    "task.tool_turn_incomplete": "engine",
    "approval.read_root_granted": "engine",
    "approval.read_root_grant_rejected": "engine",
    "memory.capture_opted_out": "engine",
    "memory.capture_optout_unpersisted": "engine",
    "skills.listing_truncated": "engine",
    "agents.listing_truncated": "engine",
    "tool_result.offload_put_failed": "engine",
    "instructions.source_changed": "server",
    "session.records_skipped": "server",
    "memory.layer_locked_legacy": "server",
    "server.model_unreachable": "server",
};
export const NOTICE_MINTER = Object.freeze(NOTICE_MINTER_TABLE);