@sema-agent/client-core 0.88.0 → 0.89.0

package/dist/engineNoticeCodes.js

@@ -1,25 +1,19 @@
 import { AUTO_MODE_UNAVAILABLE_CAUSES } from './autoModeUnavailable.js';
-import { CORE_ENGINE_NOTICE_CODES, CORE_MCP_INJECTION_DROP_REASONS, CORE_NOTICE_AUDIENCE } from './generated/engineNoticeTables.js';
+import { CORE_ENGINE_NOTICE_CODES, CORE_MCP_INJECTION_DROP_REASONS, CORE_NOTICE_AUDIENCE, } from './generated/engineNoticeTables.js';
 import { CORE_ASK_UNRESOLVABLE_CAUSES, CORE_DURABLE_MANDATE_SOURCES, CORE_PERMISSION_MODE_FOLD_REASONS, } from './generated/engineFactTables.js';
 export const ENGINE_NOTICE_CODES = CORE_ENGINE_NOTICE_CODES;
 const CATALOG = new Set(ENGINE_NOTICE_CODES);
-export const SERVER_NOTICE_AUDIENCE = Object.freeze({
-    'instructions.source_changed': 'user',
-    'memory.layer_locked_legacy': 'operator',
-    'session.records_skipped': 'user',
-    'server.model_unreachable': 'user',
-});
 function audienceRow(table, code) {
     return Object.hasOwn(table, code) ? table[code] : undefined;
 }
 export function engineNoticeInCatalog(code) {
-    return typeof code === 'string' && (CATALOG.has(code) || Object.hasOwn(SERVER_NOTICE_AUDIENCE, code));
+    return typeof code === 'string' && CATALOG.has(code);
 }
 export const ENGINE_NOTICE_AUDIENCE = CORE_NOTICE_AUDIENCE;
 export function noticeAudienceOf(code) {
     if (typeof code !== 'string')
         return 'operator';
-    return audienceRow(ENGINE_NOTICE_AUDIENCE, code) ?? audienceRow(SERVER_NOTICE_AUDIENCE, code) ?? 'operator';
+    return audienceRow(ENGINE_NOTICE_AUDIENCE, code) ?? 'operator';
 }
 export const MCP_INJECTION_DROP_REASONS = CORE_MCP_INJECTION_DROP_REASONS;
 const DROP_REASONS = new Set(MCP_INJECTION_DROP_REASONS);
@@ -27,9 +21,9 @@ export function readMcpInjectionDrop(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'mcp.injection_dropped')
+    if (ownSeat(n, 'code') !== 'mcp.injection_dropped')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -59,9 +53,9 @@ export function readAskUnresolvable(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'delegation.ask_unresolvable')
+    if (ownSeat(n, 'code') !== 'delegation.ask_unresolvable')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -93,9 +87,9 @@ export function readDurableGateUnavailable(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'config.durable_gate_unavailable')
+    if (ownSeat(n, 'code') !== 'config.durable_gate_unavailable')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -138,9 +132,9 @@ export function readSkillsListingTruncated(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'skills.listing_truncated')
+    if (ownSeat(n, 'code') !== 'skills.listing_truncated')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -170,9 +164,9 @@ export function readMcpServerRedialed(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'mcp.server_redialed')
+    if (ownSeat(n, 'code') !== 'mcp.server_redialed')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -205,9 +199,10 @@ function readRootGrantNoticeOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'approval.read_root_granted' && n.code !== 'approval.read_root_grant_rejected')
+    const code = ownSeat(n, 'code');
+    if (code !== 'approval.read_root_granted' && code !== 'approval.read_root_grant_rejected')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -216,7 +211,7 @@ function readRootGrantNoticeOf(notice) {
     if (toolCallId === undefined)
         return undefined;
     const sessionId = str(o.sessionId);
-    if (n.code === 'approval.read_root_granted') {
+    if (code === 'approval.read_root_granted') {
         const dir = str(o.dir);
         const root = str(o.root);
         if (dir === undefined || root === undefined)
@@ -248,9 +243,9 @@ export function readInstructionsSourceChanged(notice) {
         return undefined;
     try {
         const n = notice;
-        if (n.code !== 'instructions.source_changed')
+        if (ownSeat(n, 'code') !== 'instructions.source_changed')
             return undefined;
-        const d = n.detail;
+        const d = ownSeat(n, 'detail');
         if (typeof d !== 'object' || d === null || Array.isArray(d))
             return undefined;
         const o = d;
@@ -274,9 +269,9 @@ export function readSessionRecordsSkipped(notice) {
         return undefined;
     try {
         const n = notice;
-        if (n.code !== 'session.records_skipped')
+        if (ownSeat(n, 'code') !== 'session.records_skipped')
             return undefined;
-        const d = n.detail;
+        const d = ownSeat(n, 'detail');
         if (typeof d !== 'object' || d === null || Array.isArray(d))
             return undefined;
         const o = d;
@@ -320,9 +315,9 @@ function readRuleStoreUnavailableOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'permission.rule_store_unavailable')
+    if (ownSeat(n, 'code') !== 'permission.rule_store_unavailable')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -344,9 +339,9 @@ function readClassifierUnavailableOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'classifier.unavailable')
+    if (ownSeat(n, 'code') !== 'classifier.unavailable')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -380,9 +375,9 @@ function readPermissionModeUnavailableOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'config.permission_mode_unavailable')
+    if (ownSeat(n, 'code') !== 'config.permission_mode_unavailable')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -405,9 +400,9 @@ function readAskReleasedByModeOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'permission.ask_released_by_mode')
+    if (ownSeat(n, 'code') !== 'permission.ask_released_by_mode')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -440,9 +435,9 @@ function readReadDenyUnappliedOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'permission.read_deny_unapplied')
+    if (ownSeat(n, 'code') !== 'permission.read_deny_unapplied')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -466,9 +461,9 @@ function readLegacyModeSeedMigratedOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'resume.legacy_mode_seed_migrated')
+    if (ownSeat(n, 'code') !== 'resume.legacy_mode_seed_migrated')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -502,9 +497,9 @@ function readToolTurnRepairedOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'context.tool_turn_repaired')
+    if (ownSeat(n, 'code') !== 'context.tool_turn_repaired')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -537,9 +532,9 @@ function readModelUnreachableOf(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
     const n = notice;
-    if (n.code !== 'server.model_unreachable')
+    if (ownSeat(n, 'code') !== 'server.model_unreachable')
         return undefined;
-    const d = n.detail;
+    const d = ownSeat(n, 'detail');
     if (typeof d !== 'object' || d === null || Array.isArray(d))
         return undefined;
     const o = d;
@@ -552,6 +547,109 @@ function readModelUnreachableOf(notice) {
     const proxyInUse = nonEmpty(optionalOwnSeat(o, 'proxyInUse'));
     return { code, targetHost, ...(proxyInUse !== undefined ? { proxyInUse } : {}), remedy, sessionId };
 }
+const positiveInt = (v) => (typeof v === 'number' && Number.isInteger(v) && v > 0 ? v : undefined);
+export function readToolTurnIncomplete(notice) {
+    return guardedRead(notice, readToolTurnIncompleteOf);
+}
+function optionalNameList(o, key) {
+    try {
+        const ids = nameList(ownSeat(o, key));
+        return ids !== undefined && ids.length > 0 ? ids : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readToolTurnIncompleteOf(notice) {
+    if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
+        return undefined;
+    const n = notice;
+    if (ownSeat(n, 'code') !== 'task.tool_turn_incomplete')
+        return undefined;
+    const d = ownSeat(n, 'detail');
+    if (typeof d !== 'object' || d === null || Array.isArray(d))
+        return undefined;
+    const o = d;
+    const cause = nonEmpty(ownSeat(o, 'cause'));
+    const count = positiveInt(ownSeat(o, 'count'));
+    const toolCallIds = optionalNameList(o, 'toolCallIds');
+    const sessionId = nonEmpty(ownSeat(o, 'sessionId'));
+    const runId = nonEmpty(ownSeat(o, 'runId'));
+    if (cause === undefined || count === undefined || sessionId === undefined || runId === undefined)
+        return undefined;
+    return { cause, count, ...(toolCallIds !== undefined ? { toolCallIds } : {}), sessionId, runId };
+}
+export function readUserInputUndrained(notice) {
+    return guardedRead(notice, readUserInputUndrainedOf);
+}
+function readUserInputUndrainedOf(notice) {
+    if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
+        return undefined;
+    const n = notice;
+    const code = ownSeat(n, 'code');
+    const kind = code === 'task.user_steer_undrained' ? 'steer' : code === 'task.user_followup_undrained' ? 'followUp' : undefined;
+    if (kind === undefined)
+        return undefined;
+    const d = ownSeat(n, 'detail');
+    if (typeof d !== 'object' || d === null || Array.isArray(d))
+        return undefined;
+    const o = d;
+    const count = positiveInt(ownSeat(o, kind));
+    if (count === undefined)
+        return undefined;
+    const cause = nonEmpty(optionalOwnSeat(o, 'cause'));
+    const taskId = nonEmpty(optionalOwnSeat(o, 'taskId'));
+    const sessionId = nonEmpty(optionalOwnSeat(o, 'sessionId'));
+    const runId = nonEmpty(optionalOwnSeat(o, 'runId'));
+    return {
+        kind,
+        count,
+        ...(cause !== undefined ? { cause } : {}),
+        ...(taskId !== undefined ? { taskId } : {}),
+        ...(sessionId !== undefined ? { sessionId } : {}),
+        ...(runId !== undefined ? { runId } : {}),
+    };
+}
+const messagesPhrase = (n, noun) => `${n} ${noun}${n === 1 ? '' : 's'}`;
+const verbBe = (n) => (n === 1 ? 'was' : 'were');
+const itThem = (n) => (n === 1 ? 'it' : 'them');
+const STEER_UNDRAINED_SENTENCE = Object.freeze({
+    leg_end: (n) => `${messagesPhrase(n, 'message')} you sent while the run was in progress ${verbBe(n)} not used before the run ended and will not be delivered. ` +
+        `Send ${itThem(n)} again if you still need ${itThem(n)}.`,
+    crashed: (n) => `${messagesPhrase(n, 'message')} you sent to an earlier run ${verbBe(n)} accepted, but the server stopped before that run finished, ` +
+        `so whether the run used ${itThem(n)} is not known. Check that run's transcript and results before sending ${itThem(n)} again.`,
+});
+const _steerSentencePin = true;
+void _steerSentencePin;
+const followUpUndrainedSentence = (n) => `${messagesPhrase(n, 'follow-up message')} you queued ${verbBe(n)} not used before the run ended and will not be delivered. ` +
+    `Send ${itThem(n)} again if you still need ${itThem(n)}.`;
+const unrecognizedUndrainedSentence = (n, kind) => `${kind === 'followUp' ? `${messagesPhrase(n, 'follow-up message')} you queued` : `${messagesPhrase(n, 'message')} you sent during a run`} may not have been used, ` +
+    `and the reason was not reported in a form this version recognizes. Check the run's transcript before sending ${itThem(n)} again.`;
+export function userInputUndrainedNotice(facts) {
+    let kind;
+    let count;
+    let cause;
+    try {
+        if (facts === null || typeof facts !== 'object' || Array.isArray(facts))
+            return undefined;
+        kind = Object.hasOwn(facts, 'kind') ? facts.kind : undefined;
+        count = Object.hasOwn(facts, 'count') ? facts.count : undefined;
+        cause = Object.hasOwn(facts, 'cause') ? facts.cause : undefined;
+    }
+    catch {
+        return undefined;
+    }
+    const n = positiveInt(count);
+    if (n === undefined || (kind !== 'steer' && kind !== 'followUp'))
+        return undefined;
+    if (kind === 'followUp') {
+        return cause === undefined || cause === 'leg_end' ? followUpUndrainedSentence(n) : unrecognizedUndrainedSentence(n, kind);
+    }
+    if (typeof cause === 'string' && Object.hasOwn(STEER_UNDRAINED_SENTENCE, cause)) {
+        return STEER_UNDRAINED_SENTENCE[cause](n);
+    }
+    return unrecognizedUndrainedSentence(n, kind);
+}
 export const ENGINE_NOTICE_FACT_READERS = Object.freeze({
     'mcp.injection_dropped': readMcpInjectionDrop,
     'delegation.ask_unresolvable': readAskUnresolvable,
@@ -570,6 +668,9 @@ export const ENGINE_NOTICE_FACT_READERS = Object.freeze({
     'resume.legacy_mode_seed_migrated': readLegacyModeSeedMigrated,
     'context.tool_turn_repaired': readToolTurnRepaired,
     'server.model_unreachable': readModelUnreachable,
+    'task.tool_turn_incomplete': readToolTurnIncomplete,
+    'task.user_steer_undrained': readUserInputUndrained,
+    'task.user_followup_undrained': readUserInputUndrained,
 });
 const _factReaderTablePin = true;
 void _factReaderTablePin;
@@ -579,10 +680,10 @@ export function readEngineNoticeFacts(notice) {
     let code;
     let detail;
     try {
-        code = notice.code;
+        code = ownSeat(notice, 'code');
         if (typeof code !== 'string' || !Object.hasOwn(ENGINE_NOTICE_FACT_READERS, code))
             return undefined;
-        detail = notice.detail;
+        detail = ownSeat(notice, 'detail');
     }
     catch {
         return undefined;

package/dist/generated/engineNoticeTables.d.ts

@@ -1,3 +1,6 @@
 export declare const CORE_ENGINE_NOTICE_CODES: readonly string[];
 export declare const CORE_NOTICE_AUDIENCE: Readonly<Record<string, 'user' | 'operator'>>;
 export declare const CORE_MCP_INJECTION_DROP_REASONS: readonly string[];
+export declare const CORE_NOTICE_MINTER: Readonly<Record<string, 'engine' | 'server'>>;
+export declare const CORE_USER_STEER_UNDRAINED_CAUSES: readonly ["leg_end", "crashed"];
+export declare const CORE_TOOL_TURN_INCOMPLETE_CAUSES: readonly ["truncated", "unnamed", "bad_frame", "missing_result_synthesized"];

package/dist/generated/engineNoticeTables.js

@@ -73,6 +73,7 @@ export const CORE_ENGINE_NOTICE_CODES = Object.freeze([
     "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",
@@ -80,6 +81,10 @@ export const CORE_ENGINE_NOTICE_CODES = Object.freeze([
     "skills.listing_truncated",
     "agents.listing_truncated",
     "tool_result.offload_put_failed",
+    "instructions.source_changed",
+    "session.records_skipped",
+    "memory.layer_locked_legacy",
+    "server.model_unreachable",
 ]);
 export const CORE_NOTICE_AUDIENCE = Object.freeze({
     "config.autocompact_window_clamped": "operator",
@@ -156,6 +161,7 @@ export const CORE_NOTICE_AUDIENCE = Object.freeze({
     "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",
     "memory.capture_opted_out": "user",
@@ -163,6 +169,10 @@ export const CORE_NOTICE_AUDIENCE = Object.freeze({
     "skills.listing_truncated": "operator",
     "agents.listing_truncated": "operator",
     "tool_result.offload_put_failed": "operator",
+    "instructions.source_changed": "user",
+    "session.records_skipped": "user",
+    "memory.layer_locked_legacy": "operator",
+    "server.model_unreachable": "user",
 });
 export const CORE_MCP_INJECTION_DROP_REASONS = Object.freeze([
     "malformed_entry",
@@ -170,3 +180,101 @@ export const CORE_MCP_INJECTION_DROP_REASONS = Object.freeze([
     "gate_closed",
     "over_cap",
 ]);
+export const CORE_NOTICE_MINTER = Object.freeze({
+    "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",
+    "resume.legacy_mode_seed_migrated": "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 CORE_USER_STEER_UNDRAINED_CAUSES = Object.freeze([
+    "leg_end",
+    "crashed",
+]);
+export const CORE_TOOL_TURN_INCOMPLETE_CAUSES = Object.freeze([
+    "truncated",
+    "unnamed",
+    "bad_frame",
+    "missing_result_synthesized",
+]);

package/dist/hitl/toolApprovalWire.d.ts

@@ -144,6 +144,8 @@ export interface ApprovalCardRequest {
     mandate?: ApprovalMandateWord;
     denialLimitFallback?: DenialLimitFallback;
     origin?: string;
+    askClass?: string;
+    classes?: readonly string[];
     ruleStoreUnreadable?: RuleStoreUnreadableKind;
 }
 export type ApprovalCardPort = (req: ApprovalCardRequest) => Promise<ApprovalCardDecision>;
@@ -183,6 +185,8 @@ export interface ToolApprovalFrame {
     mandated?: true;
     mandate?: string;
     origin?: string;
+    askClass?: string;
+    classes?: readonly string[];
     inputHasBidi?: true;
     parked?: true;
     expiresInMs?: number;
@@ -200,7 +204,7 @@ export interface ToolApprovalDelegation {
     depth: number;
     agentName?: string;
 }
-export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "ruleSuggestions", "ruleOffers", "ruleOffersAbsence", "denialLimitFallback", "ruleStoreUnreadable", "readRootCandidate", "mandated", "mandate", "origin", "inputHasBidi", "parked", "persistedRuleShadowed", "probeCause", "ruleEvidence", "requiresRealApproval", "expiresInMs", "expiresAtMs", "serverNowMs", "delegation", "outcome"];
+export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "ruleSuggestions", "ruleOffers", "ruleOffersAbsence", "denialLimitFallback", "ruleStoreUnreadable", "readRootCandidate", "mandated", "mandate", "origin", "askClass", "classes", "inputHasBidi", "parked", "persistedRuleShadowed", "probeCause", "ruleEvidence", "requiresRealApproval", "expiresInMs", "expiresAtMs", "serverNowMs", "delegation", "outcome"];
 export interface ApprovalMandatedFacts {
     readonly mandated?: true;
     readonly ruleOffersAbsence?: string;
@@ -210,7 +214,7 @@ export declare function approvalIsMandated(v: ApprovalMandatedFacts | undefined
 export declare function readApprovalMandate(v: {
     readonly mandate?: string;
 } | undefined | null): ApprovalMandateWord | undefined;
-export declare function toolPermissionRequestAskBits(card: object | null | undefined): Pick<ToolPermissionRequest, 'mandated' | 'mandate' | 'origin' | 'ruleOffersAbsence'>;
+export declare function toolPermissionRequestAskBits(card: object | null | undefined): Pick<ToolPermissionRequest, 'mandated' | 'mandate' | 'origin' | 'ruleOffersAbsence' | 'askClass' | 'classes'>;
 export declare function isFromSubagent(frame: ToolApprovalFrame): boolean;
 export type ToolApprovalRespondDecision = 'allow' | 'allow_session' | 'deny';
 export interface RespondToolApprovalOpts {

package/dist/hitl/toolApprovalWire.js

@@ -210,6 +210,7 @@ export async function surfaceFsApprovalAndDecide(deps, taskId, argsByCall, signa
         ...(hasOwnStrictTrue(pending, 'mandated') ? { mandated: true } : {}),
         ...((w) => (w !== undefined ? { mandate: w } : {}))(readApprovalMandate(pending)),
         ...((o) => (o !== undefined ? { origin: o } : {}))(readOwnNonEmptyString(pending, 'origin')),
+        ...(readAskClassPair(pending) ?? {}),
         ...(pending.gateKind === 'irreversible_ask' ? { irreversibleParkGate: true } : {}),
         ...(pending.hasBidiControls === true ? { hasBidiControls: true } : {}),
         ...(ruleOffersReadOnly !== undefined ? { ruleOffersReadOnly } : {}),
@@ -386,6 +387,8 @@ export const TOOL_APPROVAL_FRAME_KEYS_MIRROR = [
     'mandated',
     'mandate',
     'origin',
+    'askClass',
+    'classes',
     'inputHasBidi',
     'parked',
     'persistedRuleShadowed',
@@ -425,13 +428,39 @@ export function toolPermissionRequestAskBits(card) {
     const mandate = readApprovalMandate(card);
     const origin = readOwnNonEmptyString(card, 'origin');
     const ruleOffersAbsence = readOwnNonEmptyString(card, 'ruleOffersAbsence');
+    const askClassPair = readAskClassPair(card);
     return {
         ...(mandated ? { mandated: true } : {}),
         ...(mandate !== undefined ? { mandate } : {}),
         ...(origin !== undefined ? { origin } : {}),
         ...(ruleOffersAbsence !== undefined ? { ruleOffersAbsence } : {}),
+        ...(askClassPair ?? {}),
     };
 }
+function readAskClassPair(v) {
+    if (typeof v !== 'object' || v === null)
+        return undefined;
+    const askClass = readOwnNonEmptyString(v, 'askClass');
+    if (askClass === undefined || !Object.hasOwn(v, 'classes'))
+        return undefined;
+    const raw = v.classes;
+    if (!Array.isArray(raw) || raw.length === 0)
+        return undefined;
+    const classes = [];
+    const seen = new Set();
+    for (let i = 0; i < raw.length; i++) {
+        if (!Object.hasOwn(raw, i))
+            return undefined;
+        const c = raw[i];
+        if (typeof c !== 'string' || c === '' || seen.has(c))
+            return undefined;
+        seen.add(c);
+        classes.push(c);
+    }
+    if (classes[0] !== askClass)
+        return undefined;
+    return { askClass, classes: Object.freeze(classes) };
+}
 function hasOwnStrictTrue(v, key) {
     return Object.hasOwn(v, key) && v[key] === true;
 }
@@ -870,6 +899,7 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
         ...(denialLimitFallback !== undefined ? { denialLimitFallback } : {}),
         ...((k) => (k !== undefined ? { ruleStoreUnreadable: k } : {}))(readRuleStoreUnreadable(frame.ruleStoreUnreadable)),
         ...((o) => (o !== undefined ? { origin: o } : {}))(readOwnNonEmptyString(frame, 'origin')),
+        ...(readAskClassPair(frame) ?? {}),
     });
     if (argsNotRealInput && card.kind === 'allow' && card.updatedInput !== undefined) {
         hostLog('error', `liveToolApprovalWire: ${approvalId} card returned an edited approval on a card whose arguments are not the tool's real input (${lane?.argsUnavailable === true ? 'args-unavailable ask' : 'arguments omitted or absent on the frame'}) — nothing sent (the ask stays pending)`);