@sema-agent/client-core 0.79.0 → 0.80.0

package/dist/wireRefusalCopy.d.ts

@@ -14,3 +14,12 @@ export interface UsageWindowExhaustedDetail {
 }
 export declare function usageWindowExhaustedFromError(err: unknown): UsageWindowExhaustedDetail | null;
 export declare function usageWindowExhaustedContent(detail: UsageWindowExhaustedDetail): string;
+export type DenyAttributionRefusalKind = 'not_in_proof' | 'decision_conflict' | 'attribution_rejected';
+export interface DenyAttributionRefusalDetail {
+    kind: DenyAttributionRefusalKind;
+    code: string;
+    status: number;
+    field?: string;
+}
+export declare function denyAttributionRefusalFromError(err: unknown, sentSettledBy: boolean): DenyAttributionRefusalDetail | null;
+export declare function denyAttributionRefusalContent(detail: Pick<DenyAttributionRefusalDetail, 'kind' | 'field'>): string;

package/dist/wireRefusalCopy.js

@@ -80,3 +80,71 @@ export function usageWindowExhaustedContent(detail) {
         ? `${head} · Send it again in about ${humanWait(detail.retryAfterSec)}`
         : `${head} · The engine did not say how long the window needs — send it again a little later`;
 }
+const SETTLED_BY_NOT_IN_PROOF = 'settled_by_not_in_proof';
+const REQUEST_FIELD_CONFLICT = 'request.field_conflict';
+const RESUME_OUTCOME_INVALID = 'resume_outcome_invalid';
+const APPROVAL_NON_BINDING_FIELDS = new Set(['hostDecision', 'approver']);
+function readRefusalField(o) {
+    let extra;
+    try {
+        extra = o.extra;
+    }
+    catch {
+        extra = undefined;
+    }
+    if (typeof extra === 'object' && extra !== null && !Array.isArray(extra)) {
+        const fromExtra = readStringField(extra, 'field');
+        if (fromExtra !== undefined)
+            return fromExtra;
+    }
+    return readStringField(o, 'field');
+}
+export function denyAttributionRefusalFromError(err, sentSettledBy) {
+    try {
+        if (err === null || typeof err !== 'object')
+            return null;
+        const o = err;
+        const rawStatus = o.status ?? o.statusCode;
+        const status = typeof rawStatus === 'number' && Number.isFinite(rawStatus) ? rawStatus : undefined;
+        if (status === undefined)
+            return null;
+        const code = readStringField(o, 'errorCode');
+        if (code === undefined)
+            return null;
+        if (status === 400 && code === SETTLED_BY_NOT_IN_PROOF)
+            return { kind: 'not_in_proof', code, status };
+        if (status === 400 && code === REQUEST_FIELD_CONFLICT && sentSettledBy) {
+            return { kind: 'decision_conflict', code, status };
+        }
+        if (status === 409 && code === RESUME_OUTCOME_INVALID) {
+            const field = readRefusalField(o);
+            if (field !== undefined && APPROVAL_NON_BINDING_FIELDS.has(field)) {
+                return { kind: 'attribution_rejected', code, status, field };
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function denyAttributionRefusalContent(detail) {
+    switch (detail.kind) {
+        case 'not_in_proof':
+            return ('The engine refused this refusal before judging it: this deployment signs the decisions it accepts, and the note saying ' +
+                'who settled this one is not part of what gets signed · Nothing was decided and the approval is still waiting — ' +
+                'send the same decision again without that note');
+        case 'decision_conflict':
+            return ('The engine refused this decision before judging it: the body says a policy settled it and also asks to allow the call, ' +
+                'and only a person can allow one · Nothing was decided and the approval is still waiting — ' +
+                'send it again with the decision and the note in agreement');
+        case 'attribution_rejected': {
+            const named = typeof detail.field === 'string' && APPROVAL_NON_BINDING_FIELDS.has(detail.field)
+                ? ` It named ${detail.field} as the part it would not take.`
+                : '';
+            return ('The engine would not accept the settlement details this decision carried, so it refused the decision before judging it.' +
+                `${named} · Nothing was decided and the approval is still waiting at the same coordinates — ` +
+                'check what that part carried (the only piece this client sets is the note saying who settled the refusal) and decide once more');
+        }
+    }
+}