@sema-agent/client-core 0.95.0 → 0.97.0

package/dist/agentsWireCaps.d.ts

@@ -68,7 +68,7 @@ export type ProjectAgentsResult = {
     warnings: string[];
     toolListFlaws?: readonly AgentToolListFlaw[];
 };
-export type AgentToolListFlawKind = 'retired' | 'unprefixed_namespace' | 'case_twin';
+export type AgentToolListFlawKind = 'retired' | 'unprefixed_namespace' | 'unmintable_segment' | 'unjudged' | 'case_twin';
 export interface AgentToolListFlaw {
     readonly agent: string;
     readonly list: 'tools' | 'disallowedTools';

package/dist/agentsWireCaps.js

@@ -1,9 +1,10 @@
 import { hostEnv } from './hostEnv.js';
+import { ownDataField } from './ownKey.js';
 import { makeEngineWireClient } from './engineWireSdk.js';
 import { frozenSet } from './frozenSet.js';
 import { settleWithinDeadline } from './abortableSleep.js';
-import { isEngineRefusedToolName } from './engineRefusedToolName.js';
-import { CORE_PROTOCOL_PREFIXES, CORE_RETIRED_TOOL_CURRENT_NAMES } from './generated/toolNameTables.js';
+import { ruleToolNameVerdictOf } from './protocolSegment.js';
+import { CORE_PROTOCOL_PREFIXES } from './generated/toolNameTables.js';
 import { rosterMountedNames } from './rosterMountedNames.js';
 import { capForDisplay } from './fleetTaskDesc.js';
 export const MAX_TASK_AGENTS = 32;
@@ -42,7 +43,6 @@ const SOURCE_RANK = {
 function sourceRank(source) {
     return SOURCE_RANK[source] ?? 5;
 }
-const RETIRED_TABLE_CURRENT_NAMES = frozenSet([...CORE_RETIRED_TOOL_CURRENT_NAMES.values()].filter((v) => typeof v === 'string'));
 function unescapedIndexOf(s, ch, last) {
     for (let k = 0; k < s.length; k++) {
         const i = last ? s.length - 1 - k : k;
@@ -75,12 +75,15 @@ function toolNameFlawOf(entry, names, list) {
     if (name === undefined || name.length === 0 || name === '*' || names.has(name))
         return undefined;
     const named = name !== entry ? { toolName: name } : {};
-    if (isEngineRefusedToolName(name)) {
-        const current = CORE_RETIRED_TOOL_CURRENT_NAMES.get(name);
-        if (current === undefined)
-            return { kind: 'unprefixed_namespace', ...named };
-        return typeof current === 'string' ? { kind: 'retired', currentName: current, ...named } : { kind: 'retired', ...named };
-    }
+    const verdict = ruleToolNameVerdictOf(name);
+    if (verdict.kind === 'unknown')
+        return { kind: 'unjudged', ...named };
+    if (verdict.kind === 'unmintable_segment')
+        return { kind: 'unmintable_segment', ...named };
+    if (verdict.kind === 'unprefixed_namespace')
+        return { kind: 'unprefixed_namespace', ...named };
+    if (verdict.kind === 'retired')
+        return verdict.currentName !== undefined ? { kind: 'retired', currentName: verdict.currentName, ...named } : { kind: 'retired', ...named };
     if (CORE_PROTOCOL_PREFIXES.some((prefix) => name.startsWith(prefix)))
         return undefined;
     const folded = name.toLowerCase();
@@ -93,7 +96,7 @@ export function agentToolListFlaws(agents, roster) {
     if (!Array.isArray(agents) || agents.length === 0)
         return [];
     const mounted = rosterMountedNames(roster);
-    const names = typeof mounted === 'object' ? mounted : RETIRED_TABLE_CURRENT_NAMES;
+    const names = typeof mounted === 'object' ? mounted : new Set();
     const out = [];
     for (const a of agents) {
         if (a === null || typeof a !== 'object' || typeof a.name !== 'string')
@@ -116,6 +119,10 @@ function toolListFlawPhrase(f) {
         return `${entry} is a retired tool name${f.currentName !== undefined ? ` (now ${JSON.stringify(f.currentName)})` : ' (no longer available under any name)'}`;
     if (f.kind === 'unprefixed_namespace')
         return `${entry} contains "__" but does not start with a tool protocol prefix`;
+    if (f.kind === 'unmintable_segment')
+        return `${entry} spells its server or agent peer part in a way the engine never uses when naming tools, so no tool answers to it`;
+    if (f.kind === 'unjudged')
+        return `${entry} could not be checked here, because the engine's tool-name check is not available in this client`;
     return `${entry} differs from the tool ${JSON.stringify(f.currentName ?? '')} only in letter case`;
 }
 export function projectAgentsForWire(defs, deps) {
@@ -289,7 +296,7 @@ export async function engineSupportsTaskAgents(baseUrl, opts) {
         if (typeof injected?.capabilities !== 'function')
             return undefined;
         const got = await settleWithinDeadline(opts.timeoutMs ?? 3000, (signal) => injected.capabilities({ signal }));
-        return got.kind === 'value' ? got.value?.taskAgents === true : undefined;
+        return got.kind === 'value' ? taskAgentsOf(got.value) : undefined;
     }
     const client = makeEngineWireClient({
         baseUrl,
@@ -302,7 +309,17 @@ export async function engineSupportsTaskAgents(baseUrl, opts) {
         return undefined;
     try {
         const caps = await client.capabilities();
-        return caps?.taskAgents === true;
+        return taskAgentsOf(caps);
+    }
+    catch {
+        return undefined;
+    }
+}
+function taskAgentsOf(caps) {
+    if (caps === null || typeof caps !== 'object')
+        return false;
+    try {
+        return ownDataField(caps, 'taskAgents') === true;
     }
     catch {
         return undefined;

package/dist/approvalDecidedByCapability.d.ts

@@ -1,5 +1,7 @@
 export type ApprovalDecidedByReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {

package/dist/approvalDecidedByCapability.js

@@ -17,7 +17,6 @@ export function projectApprovalDecidedByCapability(caps) {
 const reader = createEngineCapReader({
     name: 'approvalDecidedBy',
     project: projectApprovalDecidedByCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function noteEngineCapsForApprovalDecidedBy(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);

package/dist/approvalsStreamLiveCapability.d.ts

@@ -1,5 +1,7 @@
 export type ApprovalsStreamLiveReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {

package/dist/approvalsStreamLiveCapability.js

@@ -1,5 +1,5 @@
 import { engineWireTarget } from './engineWireTarget.js';
-import { createEngineCapReader } from './engineCapReader.js';
+import { createEngineCapReader, unreadableReadingDetail } from './engineCapReader.js';
 import { ownDataField } from './ownKey.js';
 export function projectApprovalsStreamLiveCapability(caps) {
     try {
@@ -21,7 +21,6 @@ export function projectApprovalsStreamLiveCapability(caps) {
 const reader = createEngineCapReader({
     name: 'approvalsStreamLive',
     project: projectApprovalsStreamLiveCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function noteEngineCapsForApprovalsStreamLive(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
@@ -34,6 +33,8 @@ export function livePendingNeedsReconcile(reading) {
 }
 export function approvalsStreamLiveDoctorDetail(reading) {
     switch (reading.kind) {
+        case 'unreadable':
+            return unreadableReadingDetail('live approval push');
         case 'unobserved':
             return 'live approval push not observed — the engine reports it on /v1/capabilities; this process has no usable capabilities reading cached for it (none received, the last one was unreadable, or the last one was discarded when the engine connection was reset; this process cannot tell which), so suspended asks are pulled by the reconcile cadence';
         case 'not_reported':

package/dist/attachmentSeatCapability.d.ts

@@ -1,5 +1,7 @@
 export type AttachmentSeatReading = {
     readonly kind: 'unobserved';
+} | {
+    readonly kind: 'unreadable';
 } | {
     readonly kind: 'not_reported';
 };

package/dist/attachmentSeatCapability.js

@@ -11,7 +11,6 @@ function projectAttachmentSeat(caps) {
 const reader = createEngineCapReader({
     name: 'attachmentSeat',
     project: projectAttachmentSeat,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
 export function noteEngineCapsForAttachmentSeat(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);

package/dist/callerCwdCapability.d.ts

@@ -1,5 +1,7 @@
 export type CallerCwdReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {
@@ -7,9 +9,5 @@ export type CallerCwdReading = {
     value: boolean;
 };
 export declare function projectCallerCwdCapability(caps: unknown): CallerCwdReading | undefined;
-export declare function noteEngineCapsForCallerCwd(baseUrl: string, caps: unknown, opts?: {
-    generation?: number;
-}): void;
 export declare function observedCallerCwd(baseUrl?: string | undefined): CallerCwdReading;
 export declare function callerCwdAdmitted(reading: CallerCwdReading | undefined): boolean;
-export declare function __resetCallerCwdReadingsForTests(): void;

package/dist/callerCwdCapability.js

@@ -17,11 +17,7 @@ export function projectCallerCwdCapability(caps) {
 const reader = createEngineCapReader({
     name: 'callerCwd',
     project: projectCallerCwdCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
-export function noteEngineCapsForCallerCwd(baseUrl, caps, opts) {
-    reader.note(baseUrl, caps, opts);
-}
 export function observedCallerCwd(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
@@ -37,6 +33,3 @@ export function callerCwdAdmitted(reading) {
         return false;
     }
 }
-export function __resetCallerCwdReadingsForTests() {
-    reader.__resetForTests();
-}

package/dist/centerWiringCapability.d.ts

@@ -19,6 +19,8 @@ export interface CenterWiringView {
 }
 export type CenterWiringReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'none';
 } | {
@@ -26,11 +28,7 @@ export type CenterWiringReading = {
     view: CenterWiringView;
 };
 export declare function projectCenterWiringCapability(caps: unknown): CenterWiringReading | undefined;
-export declare function noteEngineCapsForCenterWiring(baseUrl: string, caps: unknown, opts?: {
-    generation?: number;
-}): void;
 export declare function observedCenterWiring(baseUrl?: string | undefined): CenterWiringReading;
 export type CallerQuotaLease = 'enforced' | 'not-enforced' | 'exhausted' | 'unobserved' | 'no-lease' | 'unknown';
 export declare function callerQuotaLease(reading: CenterWiringReading): CallerQuotaLease;
 export declare function centerWiringDoctorDetail(reading: CenterWiringReading): string;
-export declare function __resetCenterWiringReadingsForTests(): void;

package/dist/centerWiringCapability.js

@@ -1,6 +1,6 @@
 import { capForDisplay } from './fleetTaskDesc.js';
 import { engineWireTarget } from './engineWireTarget.js';
-import { createEngineCapReader } from './engineCapReader.js';
+import { createEngineCapReader, unreadableReadingDetail } from './engineCapReader.js';
 import { ownDataField } from './ownKey.js';
 const nonEmpty = (v) => typeof v === 'string' && v !== '';
 const isPlainObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
@@ -86,11 +86,7 @@ function projectCenterWiringOf(caps) {
 const reader = createEngineCapReader({
     name: 'centerWiring',
     project: projectCenterWiringCapability,
-    makeUnobserved: () => ({ kind: 'unobserved' }),
 });
-export function noteEngineCapsForCenterWiring(baseUrl, caps, opts) {
-    reader.note(baseUrl, caps, opts);
-}
 export function observedCenterWiring(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
@@ -99,7 +95,7 @@ function guarded(reading) {
         return undefined;
     try {
         const kind = reading.kind;
-        if (kind === 'unobserved' || kind === 'none')
+        if (kind === 'unobserved' || kind === 'unreadable' || kind === 'none')
             return { kind };
         if (kind !== 'present')
             return undefined;
@@ -161,6 +157,8 @@ function failModeClause(v) {
 export function centerWiringDoctorDetail(reading) {
     const unobserved = 'center wiring not observed — the engine reports it on /v1/capabilities; this process has no usable capabilities reading cached for it, so whether this engine is connected to a configuration center is unknown';
     const r = guarded(reading);
+    if (r?.kind === 'unreadable')
+        return unreadableReadingDetail('center wiring');
     if (r?.kind === 'none') {
         return 'no configuration center on this deployment — the engine runs on its own local configuration; no quota lease or usage reporting goes through a center';
     }
@@ -194,6 +192,3 @@ export function centerWiringDoctorDetail(reading) {
         return unobserved;
     }
 }
-export function __resetCenterWiringReadingsForTests() {
-    reader.__resetForTests();
-}

package/dist/classifierVerdictWire.js

@@ -1,21 +1,7 @@
 import { unwrapSystemReminder } from './systemReminderTag.js';
+import { toolEndOutputText } from './toolResultContent.js';
 export const CLASSIFIER_DENY_SIGNATURE = 'auto-mode classifier blocked this call';
 const NOTICE_REASON_MAX = 80;
-function textFromWireOutput(output) {
-    if (typeof output === 'string')
-        return output;
-    const blocks = Array.isArray(output)
-        ? output
-        : output !== null && typeof output === 'object' && Array.isArray(output.content)
-            ? (output.content)
-            : undefined;
-    if (!blocks)
-        return undefined;
-    const texts = blocks
-        .map(b => (b !== null && typeof b === 'object' && typeof b.text === 'string' ? b.text : undefined))
-        .filter((t) => t !== undefined);
-    return texts.length > 0 ? texts.join('\n') : undefined;
-}
 const CLASSIFIER_DENY_FORMS = [
     'auto-mode classifier blocked the approved edit at an inherited ancestor layer',
     'auto-mode classifier blocked this call at an inherited ancestor layer',
@@ -24,7 +10,9 @@ const CLASSIFIER_DENY_FORMS = [
 export function classifierDenyFromToolEnd(ev) {
     if (!ev || ev.type !== 'tool_end' || ev.isError !== true)
         return undefined;
-    const raw = textFromWireOutput(ev.output);
+    if (Array.isArray(ev.output) && ev.output.length !== 1)
+        return undefined;
+    const raw = toolEndOutputText(ev.output);
     if (raw === undefined)
         return undefined;
     const message = unwrapSystemReminder(raw).trim();

package/dist/clientSlice.js

@@ -14,4 +14,4 @@ export const CLIENT_VERBS = [
     { verb: 'probeHealth', required: false, duty: '健康探测' },
 ];
 export const PROBE_HEALTH_DIVERGENCE = 'probeHealth: SDK 要求 status==="ok",壳侧 limitsWire:225 / detachWire:82 手拼只要 res.ok。' +
-    'B4 保旧行为(res.ok),差异候裁 —— 换成 SDK 语义会让"自报 degraded 但可用"的引擎少发 detach 头。';
+    'B4 保旧行为(res.ok),差异待定 —— 换成 SDK 语义会让"自报 degraded 但可用"的引擎少发 detach 头。';

package/dist/cloudConfigWireCaps.d.ts

@@ -4,7 +4,7 @@ import type { EnvLike } from './hostEnv.js';
 export type { McpServerSpec };
 type Rec = Record<string, unknown>;
 export type { EnvLike };
-export type CloudMcpDropReason = 'disabled' | 'missing-field' | 'unknown-transport' | 'capped';
+export type CloudMcpDropReason = 'disabled' | 'missing-field' | 'unknown-transport' | 'capped' | 'principal-and-assertion-header';
 export interface CloudMcpDroppedServer {
     name?: string;
     reason: CloudMcpDropReason;
@@ -17,10 +17,10 @@ export interface CloudMcpProjection {
 export declare function cloudMcpToSpecs(servers: unknown, env: EnvLike): CloudMcpProjection;
 export declare function cloudSkillsToSpecs(manifestSkills: unknown, resolveBody: (contentHash: string) => string | null): SkillSpec[];
 export interface CloudModelRefIssue {
-    readonly key: 'models' | 'default' | 'roles' | 'atModelAllowlist' | 'tierGroups' | 'activeTierGroup';
+    readonly key: 'models' | 'roles' | 'atMention' | 'tierGroups' | 'activeTierGroup';
     readonly at?: string;
     readonly target?: string;
-    readonly reason: 'dangling' | 'rejected' | 'unreadable' | 'unsupported' | 'duplicate';
+    readonly reason: 'dangling' | 'rejected' | 'unreadable' | 'unsupported' | 'duplicate' | 'shadowed' | 'unvouched';
     readonly outcome: 'dropped' | 'kept';
 }
 export interface CloudModelsDocOptions {
@@ -123,4 +123,4 @@ export interface CloudEffectiveNotice {
     readonly level: 'warn' | 'info';
     readonly text: string;
 }
-export declare function cloudEffectiveNotices(p: Pick<CloudProjection, 'effectiveWarnings' | 'budget' | 'runtimeCaps' | 'modelRefIssues'>): CloudEffectiveNotice[];
+export declare function cloudEffectiveNotices(p: Pick<CloudProjection, 'effectiveWarnings' | 'budget' | 'runtimeCaps' | 'modelRefIssues' | 'droppedMcpServers'>): CloudEffectiveNotice[];