a5f213e73e
Per the T1 design rubber-duck, batch by FILE so each tranche drops convergence-lint allowlist entries. Migrate 12 files' core imports to the leaf modules directly (behaviour-identical — leaves are the objects core re-exports by reference): - io (output/error/ERROR_REASON): agent-command-router, capability-state, capability-writer, frontmatter, gsd2-import, learnings, loop-resolver, task-command-router - roadmap-command-router -> config-loader; workstream-inventory -> core-utils - milestone, verify -> their full leaf sets (both were multi-leaf, not single-leaf as first scoped; migrated completely) All 12 files now import zero core symbols and are removed from the allowlist (30 -> 18). core.cts re-exports untouched (still serve the remaining 18 files); teardown is T-final. Stale core.cjs docstrings in the migrated files corrected to reference io.cjs. No behaviour change. Closes #1281 Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
104 lines
3.3 KiB
TypeScript
104 lines
3.3 KiB
TypeScript
/**
|
|
* Agent command router — classify-failure subcommand handler.
|
|
*
|
|
* ADR-457 build-at-publish: the hand-written bin/lib/agent-command-router.cjs
|
|
* collapsed to a TypeScript source of truth. Behaviour is preserved byte-for-behaviour
|
|
* from the prior hand-written .cjs; only types are added.
|
|
*/
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-require-imports
|
|
import io = require('./io.cjs');
|
|
const { output, error, ERROR_REASON } = io;
|
|
|
|
// ─── Types ────────────────────────────────────────────────────────────────────
|
|
|
|
type QuotaExceededResult = {
|
|
class: 'quota-exceeded';
|
|
sentinel: string;
|
|
retryAfterSeconds?: number;
|
|
};
|
|
|
|
type ClassifyHandoffBugResult = {
|
|
class: 'classify-handoff-bug';
|
|
sentinel: string;
|
|
};
|
|
|
|
type UnknownFailureResult = {
|
|
class: 'unknown-failure';
|
|
};
|
|
|
|
type AgentFailureResult = QuotaExceededResult | ClassifyHandoffBugResult | UnknownFailureResult;
|
|
|
|
interface RouteAgentCommandOptions {
|
|
args: string[];
|
|
raw: boolean;
|
|
}
|
|
|
|
// ─── Constants ────────────────────────────────────────────────────────────────
|
|
|
|
const QUOTA_SENTINELS: string[] = [
|
|
'429',
|
|
'usage_limit_reached',
|
|
'usage limit',
|
|
'rate limit',
|
|
'rate-limited',
|
|
'rate_limit',
|
|
'resource_exhausted',
|
|
'quota',
|
|
'too many requests',
|
|
'exceeded your',
|
|
];
|
|
|
|
const CLASSIFY_HANDOFF_SENTINEL = 'classifyhandoffifneeded is not defined';
|
|
|
|
// ─── Implementation ───────────────────────────────────────────────────────────
|
|
|
|
function parseRetryAfter(body: unknown): number | undefined {
|
|
// eslint-disable-next-line @typescript-eslint/no-base-to-string
|
|
const match = String(body ?? '').match(/\bretry[-_ ]after[:\s]+(\d+)\b/i);
|
|
if (!match) return undefined;
|
|
const seconds = Number.parseInt(match[1], 10);
|
|
return Number.isFinite(seconds) ? seconds : undefined;
|
|
}
|
|
|
|
function classifyAgentFailure(body: unknown): AgentFailureResult {
|
|
// eslint-disable-next-line @typescript-eslint/no-base-to-string
|
|
const normalized = String(body ?? '').toLowerCase();
|
|
if (normalized.trim() === '') {
|
|
return { class: 'unknown-failure' };
|
|
}
|
|
|
|
for (const sentinel of QUOTA_SENTINELS) {
|
|
if (normalized.includes(sentinel)) {
|
|
const retryAfterSeconds = parseRetryAfter(body);
|
|
return retryAfterSeconds === undefined
|
|
? { class: 'quota-exceeded', sentinel }
|
|
: { class: 'quota-exceeded', sentinel, retryAfterSeconds };
|
|
}
|
|
}
|
|
|
|
if (normalized.includes(CLASSIFY_HANDOFF_SENTINEL)) {
|
|
return {
|
|
class: 'classify-handoff-bug',
|
|
sentinel: CLASSIFY_HANDOFF_SENTINEL,
|
|
};
|
|
}
|
|
|
|
return { class: 'unknown-failure' };
|
|
}
|
|
|
|
function routeAgentCommand({ args, raw }: RouteAgentCommandOptions): void {
|
|
const subcommand = args[1];
|
|
if (subcommand !== 'classify-failure') {
|
|
error('Unknown agent subcommand. Available: classify-failure', ERROR_REASON.SDK_UNKNOWN_COMMAND);
|
|
}
|
|
|
|
const bodyArgs = args.slice(2).filter((arg) => arg !== '--');
|
|
output(classifyAgentFailure(bodyArgs.join(' ')), raw, undefined);
|
|
}
|
|
|
|
export = {
|
|
classifyAgentFailure,
|
|
routeAgentCommand,
|
|
};
|