@sema-agent/client-core 0.83.6 → 0.84.1

package/dist/toolRoster.js

@@ -1,3 +1,5 @@
+import { displayUntrusted } from './displayUntrusted.js';
+import { HANDS_REASON_NO_EXECUTION_ENV, projectHandsSection } from './handsSeam.js';
 const str = (v) => typeof v === 'string' && v.length > 0 ? v : undefined;
 const strArr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === 'string') : undefined;
 const obj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v) ? v : undefined;
@@ -135,14 +137,51 @@ export function handsMountedFromManifest(manifest) {
     const rows = roster.entries.filter((e) => e.mountedBy === 'hands').length;
     return rows > 0 ? { kind: 'mounted', rows } : { kind: 'not-mounted' };
 }
-export function handsMountedDetail(reading) {
-    switch (reading.kind) {
+export function handsSeamReadingOf(view) {
+    const seam = typeof view === 'object' && view !== null ? projectHandsSection(view) : undefined;
+    if (seam === undefined)
+        return { kind: 'not_reported' };
+    if (seam.mounted)
+        return { kind: 'mounted' };
+    return seam.reason !== undefined ? { kind: 'not_mounted', reason: seam.reason } : { kind: 'not_mounted' };
+}
+const HANDS_NONE_STEM = 'this leg of the run was assembled with NO built-in file-and-shell tools';
+const HANDS_NONE_TAIL = "so on this leg the model had no tool of the engine's own for editing files or running commands (tools mounted by other conditions, such as external servers, and sub-runs delegated to other legs are not covered by this reading)";
+const HANDS_REASON_DISPLAY_MAX = 64;
+const HANDS_NOT_REPORTED_SENTENCE = 'whether this leg has built-in file-and-shell tools is not stated here — the engine did not report its hands seam (older engines and servers, and the static half of a manifest, never do); the tool roster may still answer it';
+export function handsSeamDetail(reading) {
+    const kind = typeof reading === 'object' && reading !== null ? reading.kind : undefined;
+    switch (kind) {
         case 'mounted':
-            return `this run was assembled with file-and-shell tools mounted (${reading.rows} of them)`;
+            return 'this leg of the run was assembled with its built-in file tools mounted — the engine says so; whether a shell is reachable is answered by the tool roster, not by this statement';
+        case 'not_mounted': {
+            const raw = reading.reason;
+            const reason = typeof raw === 'string' && raw.length > 0 ? raw : undefined;
+            const why = reason === undefined
+                ? 'the engine states it mounted no hands on this leg (it gave no reason)'
+                : reason === HANDS_REASON_NO_EXECUTION_ENV
+                    ? 'the engine states it mounted no hands on this leg because no execution environment was supplied'
+                    : `the engine states it mounted no hands on this leg (reason: ${displayUntrusted(reason, { max: HANDS_REASON_DISPLAY_MAX })}, a word this build does not know)`;
+            return `${HANDS_NONE_STEM} — ${why}, ${HANDS_NONE_TAIL}`;
+        }
+        default:
+            return HANDS_NOT_REPORTED_SENTENCE;
+    }
+}
+export function handsMountedDetail(reading) {
+    const r = reading;
+    const kind = typeof r === 'object' && r !== null ? r.kind : undefined;
+    switch (kind) {
+        case 'mounted': {
+            const rows = r.rows;
+            if (typeof rows === 'number' && Number.isInteger(rows) && rows > 0)
+                return `this run was assembled with file-and-shell tools mounted (${rows} of them)`;
+            return HANDS_NOT_REPORTED_SENTENCE;
+        }
         case 'not-mounted':
-            return 'this leg of the run was assembled with NO built-in file-and-shell tools — the engine reports a roster and not one row was mounted by that condition, so on this leg the model had no tool of the engine\'s own for editing files or running commands (tools mounted by other conditions, such as external servers, and sub-runs delegated to other legs are not covered by this reading)';
+            return `${HANDS_NONE_STEM} — the engine reports a roster and not one row was mounted by that condition, ${HANDS_NONE_TAIL}`;
         case 'unknown':
-            switch (reading.why) {
+            switch (r.why) {
                 case 'no-manifest':
                     return 'whether this run has file-and-shell tools is unknown — no assembly manifest was observed for it';
                 case 'no-roster':
@@ -152,7 +191,9 @@ export function handsMountedDetail(reading) {
                 case 'mount-condition-absent':
                     return 'whether this run has file-and-shell tools is unknown — this engine does not report which condition mounted each tool, so an empty count here would be a fact about the reader, not about the run';
             }
+            return HANDS_NOT_REPORTED_SENTENCE;
     }
+    return HANDS_NOT_REPORTED_SENTENCE;
 }
 export function toolRosterNames(roster) {
     return roster?.entries.map((e) => e.name) ?? [];

package/dist/wireErrorTriage.js

@@ -45,10 +45,6 @@ export function isPreStreamDrainingReject(err) {
     const e = err;
     return typeof e?.status === 'number' && e.status === 503 && e.errorCode === DRAINING_ERROR_CODE;
 }
-const RESUME_AT_TEXT_COMPAT = [
-    { status: 404, marker: `(${RESUME_AT_ERROR_CODE_PREFIX}unknown_event)` },
-    { status: 422, marker: `(${RESUME_AT_ERROR_CODE_PREFIX}no_session)` },
-];
 export function effectiveWireErrorCode(err) {
     if (typeof err !== 'object' || err === null)
         return undefined;
@@ -75,14 +71,8 @@ export function corruptStoredRowContent(where) {
     return `The engine could not read a stored record this session needs in order to continue. The unreadable row is ${capForDisplay(where, 200)}; whoever operates this engine has to repair or remove that row before this session can continue.`;
 }
 export function isResumeAtRejection(err) {
-    const e = err;
     const code = effectiveWireErrorCode(err);
-    if (code !== undefined && code.startsWith(RESUME_AT_ERROR_CODE_PREFIX))
-        return true;
-    const marker = RESUME_AT_TEXT_COMPAT.find((c) => c.status === e?.status)?.marker;
-    if (marker === undefined)
-        return false;
-    return [e?.message, e?.errorMessage].some((t) => typeof t === 'string' && t.endsWith(marker));
+    return code !== undefined && code.startsWith(RESUME_AT_ERROR_CODE_PREFIX);
 }
 export function drainingRetryDelayMs(err, attempt, opts) {
     const ra = err?.retryAfterMs;

package/dist/workflowClient.js

@@ -240,7 +240,8 @@ function synthPhaseStatus(runStatus, agents) {
 }
 export function projectWorkflowRun(run) {
     const parks = readWorkflowParks(run);
-    const agents = (run.agents ?? []).map((r, i) => projectAgent(r, i));
+    const agentsKnown = Array.isArray(run.agents);
+    const agents = (agentsKnown ? run.agents : []).map((r, i) => projectAgent(r, i));
     const phases = projectPhases(run, agents);
     const validTokens = (v) => typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : undefined;
     const ownTokens = validTokens(run.stats?.tokens);
@@ -265,7 +266,7 @@ export function projectWorkflowRun(run) {
         ...(parks !== undefined ? { parks } : {}),
         ...(readWorkflowResumeAdmissionIncomplete(run) ? { resumeAdmissionIncomplete: true } : {}),
         script: '',
-        agentCount: agents.length,
+        ...(agentsKnown ? { agentCount: agents.length } : {}),
         ...(totalTokens !== undefined ? { totalTokens } : {}),
         phases,
     };
@@ -814,7 +815,7 @@ export function createLiveWorkflowSource(config) {
             code = null;
             lastError = null;
             if (engineWireDebugEnabled()) {
-                hostLog('debug', `[sema][workflow][perf] get ${Date.now() - t0}ms first=${first} agents=${current.agentCount} phases=${current.phases.length}`);
+                hostLog('debug', `[sema][workflow][perf] get ${Date.now() - t0}ms first=${first} agents=${current.agentCount ?? '?'} phases=${current.phases.length}`);
             }
             first = false;
             notify();

package/dist/workflowMonitor.d.ts

@@ -49,7 +49,7 @@ export interface WorkflowRunState {
     scriptPath?: string;
     status: 'running' | 'done' | 'failed' | 'stopped' | 'paused' | 'parked' | 'unknown';
     cloud?: boolean;
-    agentCount: number;
+    agentCount?: number;
     totalTokens?: number;
     phases: WorkflowPhase[];
     parks?: readonly WorkflowParkRowView[];