actoviq-agent-sdk 0.4.21 → 0.4.22

package/dist/src/ui/extensionsCommandView.js

@@ -0,0 +1,82 @@
+/**
+ * Shared /extensions view model for the TUI and GUI slash commands: list the
+ * built-in extension catalog with live state, show one extension's detail, or
+ * toggle an extension via `client.builtInExtensions.setEnabled` (which also
+ * persists to ~/.hadamard/settings.json).
+ *
+ * @module src/ui/extensionsCommandView
+ */
+import { getBuiltInExtensionDefinition, } from '../extensions/builtInExtensions.js';
+function formatConfigSummary(config) {
+    const parts = [];
+    for (const [key, value] of Object.entries(config)) {
+        if (Array.isArray(value))
+            parts.push(`${key}: ${value.length}`);
+        else if (typeof value === 'boolean')
+            parts.push(`${key}: ${value ? 'on' : 'off'}`);
+        else if (typeof value === 'number')
+            parts.push(`${key}: ${value}`);
+    }
+    return parts.join(' · ');
+}
+function parseToggle(value) {
+    const normalized = value.toLowerCase();
+    if (normalized === 'on' || normalized === 'enable')
+        return true;
+    if (normalized === 'off' || normalized === 'disable')
+        return false;
+    return undefined;
+}
+function describeState(enabled, defaultEnabled, kind) {
+    return `${enabled ? 'on' : 'off'} · default ${defaultEnabled ? 'on' : 'off'} · ${kind}`;
+}
+export async function runExtensionsCommandView(extensions, args) {
+    const [id = '', toggle = '', ...rest] = args.trim().split(/\s+/u).filter(Boolean);
+    const validIds = extensions.list().map(state => state.id).join(', ');
+    if (id && !getBuiltInExtensionDefinition(id)) {
+        throw new Error(`unknown extension: ${id} — valid ids: ${validIds}`);
+    }
+    if (!id) {
+        const states = extensions.list();
+        return {
+            message: `Built-in extensions (${states.length}) — toggle with /extensions <id> on|off`,
+            items: states.map(state => {
+                const definition = getBuiltInExtensionDefinition(state.id);
+                const configSummary = formatConfigSummary(extensions.getConfig(state.id));
+                return {
+                    label: `${definition.title} (${state.id})`,
+                    description: [
+                        describeState(state.enabled, definition.defaultEnabled, definition.kind),
+                        definition.description,
+                        ...(configSummary ? [`config: ${configSummary}`] : []),
+                    ].join(' — '),
+                };
+            }),
+        };
+    }
+    const definition = getBuiltInExtensionDefinition(id);
+    if (!toggle) {
+        const state = extensions.list().find(item => item.id === id);
+        const configSummary = formatConfigSummary(extensions.getConfig(id));
+        return {
+            message: [
+                `${definition.title} (${id}) — ${describeState(state.enabled, definition.defaultEnabled, definition.kind)}`,
+                definition.description,
+                ...(configSummary
+                    ? [`config: ${configSummary}`]
+                    : [definition.configurableKeys.length > 0 ? 'config: defaults (no overrides)' : 'no configurable keys']),
+                `toggle: /extensions ${id} ${state.enabled ? 'off' : 'on'}`,
+            ].join('\n'),
+        };
+    }
+    const enabled = rest.length === 0 ? parseToggle(toggle) : undefined;
+    if (enabled === undefined) {
+        throw new Error(`usage: /extensions <id> on|off — valid ids: ${validIds}`);
+    }
+    await extensions.setEnabled(id, enabled);
+    const timing = definition.kind === 'policy'
+        ? 'policy extension; applies to subsequent agent runs'
+        : 'applies immediately';
+    return { message: `${definition.title} (${id}) ${enabled ? 'enabled' : 'disabled'} — ${timing}` };
+}
+//# sourceMappingURL=extensionsCommandView.js.map

package/dist/src/ui/extensionsCommandView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionsCommandView.js","sourceRoot":"","sources":["../../../src/ui/extensionsCommandView.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,6BAA6B,GAE9B,MAAM,oCAAoC,CAAC;AAO5C,SAAS,mBAAmB,CAAC,MAA+B;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;aAC3D,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;aAC9E,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACnE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB,EAAE,cAAuB,EAAE,IAAY;IAC5E,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAAgC,EAChC,IAAY;IAEZ,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,IAAI,EAAE,IAAI,CAAC,6BAA6B,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,sBAAsB,EAAE,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,wBAAwB,MAAM,CAAC,MAAM,yCAAyC;YACvF,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;gBACxB,MAAM,UAAU,GAAG,6BAA6B,CAAC,KAAK,CAAC,EAAE,CAAE,CAAC;gBAC5D,MAAM,aAAa,GAAG,mBAAmB,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1E,OAAO;oBACL,KAAK,EAAE,GAAG,UAAU,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,GAAG;oBAC1C,WAAW,EAAE;wBACX,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC,IAAI,CAAC;wBACxE,UAAU,CAAC,WAAW;wBACtB,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,WAAW,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;qBACvD,CAAC,IAAI,CAAC,KAAK,CAAC;iBACd,CAAC;YACJ,CAAC,CAAC;SACH,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,6BAA6B,CAAC,EAAE,CAAE,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAE,CAAC;QAC9D,MAAM,aAAa,GAAG,mBAAmB,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,OAAO;YACL,OAAO,EAAE;gBACP,GAAG,UAAU,CAAC,KAAK,KAAK,EAAE,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;gBAC3G,UAAU,CAAC,WAAW;gBACtB,GAAG,CAAC,aAAa;oBACf,CAAC,CAAC,CAAC,WAAW,aAAa,EAAE,CAAC;oBAC9B,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;gBAC1G,uBAAuB,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;aAC5D,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,KAAK,QAAQ;QACzC,CAAC,CAAC,oDAAoD;QACtD,CAAC,CAAC,qBAAqB,CAAC;IAC1B,OAAO,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,KAAK,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,MAAM,MAAM,EAAE,EAAE,CAAC;AACpG,CAAC"}

package/dist/src/ui/lspCommandView.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared /lsp view model for the TUI and GUI slash commands: list every
+ * configured or auto-detected language server with availability and live
+ * running state from `client.codeIntelligence.serverStatus()`.
+ *
+ * @module src/ui/lspCommandView
+ */
+import type { CodeIntelligenceService } from '../codeIntel/codeIntelligenceService.js';
+export interface LspCommandViewResult {
+    message: string;
+    items?: Array<{
+        label: string;
+        description?: string;
+    }>;
+}
+export declare function runLspCommandView(service: Pick<CodeIntelligenceService, 'serverStatus'> | undefined): Promise<LspCommandViewResult>;
+//# sourceMappingURL=lspCommandView.d.ts.map

package/dist/src/ui/lspCommandView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lspCommandView.d.ts","sourceRoot":"","sources":["../../../src/ui/lspCommandView.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAGvF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAQD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,cAAc,CAAC,GAAG,SAAS,GACjE,OAAO,CAAC,oBAAoB,CAAC,CAe/B"}

package/dist/src/ui/lspCommandView.js

@@ -0,0 +1,25 @@
+import { LANGUAGE_SERVER_PRESETS } from '../codeIntel/languageServerPresets.js';
+const NO_SERVERS_MESSAGE = [
+    'No language servers configured or detected.',
+    'Configure languageServers in ~/.hadamard/settings.json, or install a server binary and let auto-detection find it.',
+    `Auto-detection probes PATH for: ${LANGUAGE_SERVER_PRESETS.map(preset => preset.command).join(', ')}.`,
+].join('\n');
+export async function runLspCommandView(service) {
+    if (!service)
+        return { message: NO_SERVERS_MESSAGE };
+    const statuses = await service.serverStatus();
+    if (statuses.length === 0)
+        return { message: NO_SERVERS_MESSAGE };
+    return {
+        message: `Language servers (${statuses.length})`,
+        items: statuses.map(status => ({
+            label: status.id,
+            description: [
+                status.languages.join(', '),
+                status.available ? 'available' : `unavailable${status.reason ? ` (${status.reason})` : ''}`,
+                status.running ? 'running' : 'not started',
+            ].join(' · '),
+        })),
+    };
+}
+//# sourceMappingURL=lspCommandView.js.map

package/dist/src/ui/lspCommandView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lspCommandView.js","sourceRoot":"","sources":["../../../src/ui/lspCommandView.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAOhF,MAAM,kBAAkB,GAAG;IACzB,6CAA6C;IAC7C,oHAAoH;IACpH,mCAAmC,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;CACvG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAkE;IAElE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAClE,OAAO;QACL,OAAO,EAAE,qBAAqB,QAAQ,CAAC,MAAM,GAAG;QAChD,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7B,KAAK,EAAE,MAAM,CAAC,EAAE;YAChB,WAAW,EAAE;gBACX,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3B,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3F,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa;aAC3C,CAAC,IAAI,CAAC,KAAK,CAAC;SACd,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/src/ui/usageRoutingCommand.d.ts

@@ -0,0 +1,13 @@
+import type { UsageRoutingAdminService } from '../keyway/usageRoutingAdminService.js';
+export type UsageRoutingCommandAdminPort = Pick<UsageRoutingAdminService, 'overview' | 'catalog' | 'saveBudget' | 'deleteBudget' | 'saveCredential' | 'testCredential' | 'saveRoute' | 'testTarget' | 'gatewayStatus' | 'startGateway' | 'stopGateway' | 'previewBridgeMigration' | 'importBridgeMigration' | 'previewPortableMigration' | 'importPortableMigration'>;
+export interface UsageRoutingCommandPort {
+    admin(): Promise<UsageRoutingCommandAdminPort>;
+    promptSecret?(label: string): Promise<string | undefined>;
+    activateRoute?(reference: string): Promise<{
+        routeAlias: string;
+        model: string;
+    }>;
+}
+/** Shared GUI/TUI command behavior; presentation layers only render returned lines. */
+export declare function runUsageRoutingCommand(name: string, args: string, port: UsageRoutingCommandPort): Promise<string[] | undefined>;
+//# sourceMappingURL=usageRoutingCommand.d.ts.map

package/dist/src/ui/usageRoutingCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageRoutingCommand.d.ts","sourceRoot":"","sources":["../../../src/ui/usageRoutingCommand.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEtF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC,wBAAwB,EACpE,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GACtD,gBAAgB,GAAG,gBAAgB,GACnC,WAAW,GAAG,YAAY,GAC1B,eAAe,GAAG,cAAc,GAAG,aAAa,GAChD,wBAAwB,GAAG,uBAAuB,GAClD,0BAA0B,GAAG,yBAAyB,CAAC,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,KAAK,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC/C,YAAY,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1D,aAAa,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnF;AAED,uFAAuF;AACvF,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAS/B"}

package/dist/src/ui/usageRoutingCommand.js

@@ -0,0 +1,224 @@
+/** Shared GUI/TUI command behavior; presentation layers only render returned lines. */
+export async function runUsageRoutingCommand(name, args, port) {
+    if (!['usage', 'limits', 'keys', 'routes', 'gateway'].includes(name))
+        return undefined;
+    const admin = await port.admin();
+    const words = tokenize(args);
+    if (name === 'usage')
+        return usageLines(admin, words);
+    if (name === 'limits')
+        return limitsLines(admin, words);
+    if (name === 'keys')
+        return keysLines(admin, words, port);
+    if (name === 'routes')
+        return routesLines(admin, words, port);
+    return gatewayLines(admin, words);
+}
+async function usageLines(admin, words) {
+    const filter = {};
+    const range = words[0] && !words[0].startsWith('--') ? words.shift() : 'today';
+    if (range === 'today')
+        filter.from = new Date(new Date().setHours(0, 0, 0, 0)).toISOString();
+    else if (range === '7d' || range === '30d')
+        filter.from = new Date(Date.now() - Number(range.slice(0, -1)) * 86400000).toISOString();
+    else if (range !== 'all')
+        throw new TypeError('Usage range must be today, 7d, 30d, or all.');
+    for (let index = 0; index < words.length; index += 1) {
+        if (words[index] === '--provider' && words[index + 1])
+            filter.providerId = words[++index];
+        else if (words[index] === '--model' && words[index + 1])
+            filter.model = words[++index];
+    }
+    const overview = admin.overview(filter);
+    return [
+        `Usage (${range})`,
+        `  requests  ${overview.summary.requests.toLocaleString()}`,
+        `  tokens    ${overview.summary.totalTokens.toLocaleString()} (${overview.summary.inputTokens.toLocaleString()} in / ${overview.summary.outputTokens.toLocaleString()} out)`,
+        `  cache     ${overview.summary.cacheReadTokens.toLocaleString()} read / ${overview.summary.cacheWriteTokens.toLocaleString()} write`,
+        `  cost      $${(overview.summary.costUsd ?? 0).toFixed(4)}`,
+        `  quality   ${overview.unknownUsageEntries} unknown entries`,
+    ];
+}
+async function limitsLines(admin, words) {
+    const action = words.shift() || 'list';
+    if (action === 'list') {
+        const budgets = (await admin.catalog()).budgets;
+        return budgets.length
+            ? ['Usage limits', ...budgets.map(policy => `  ${policy.id}  ${scopeLabel(policy.scope)} · ${policy.period} · ${policy.metric} ${policy.limit} · ${policy.action}${policy.enabled ? '' : ' · disabled'}`)]
+            : ['Usage limits', '  (none)'];
+    }
+    if (action === 'remove') {
+        const id = required(words.shift(), 'limit id');
+        return [`Limit ${id}: ${admin.deleteBudget(id) ? 'removed' : 'not found'}`];
+    }
+    if (action !== 'set')
+        throw new TypeError('Usage: /limits list|set|remove');
+    const id = required(words.shift(), 'limit id');
+    const scopeWord = required(words.shift(), 'scope (global or kind:id)');
+    const [scopeKind, scopeId] = scopeWord.split(':', 2);
+    const period = required(words.shift(), 'period');
+    const metric = required(words.shift(), 'metric');
+    const limit = Number(required(words.shift(), 'limit'));
+    const budgetAction = required(words.shift(), 'action');
+    admin.saveBudget({
+        id,
+        scopeKind,
+        ...(scopeId ? { scopeId } : {}),
+        period,
+        metric,
+        limit,
+        action: budgetAction,
+        ...(budgetAction === 'fallbackRoute' ? { fallbackRouteId: required(words.shift(), 'fallback route id') } : {}),
+        enabled: true,
+    });
+    return [`Limit ${id}: saved`];
+}
+async function keysLines(admin, words, port) {
+    const action = words.shift() || 'list';
+    const catalog = await admin.catalog();
+    if (action === 'list') {
+        return catalog.credentials.length
+            ? ['Managed API credentials', ...catalog.credentials.map(credential => `  ${credential.id}  ${credential.providerId} · ${credential.health?.state ?? (credential.secretConfigured ? 'configured' : 'missing')} · priority ${credential.priority}`)]
+            : ['Managed API credentials', '  (none; native CLI OAuth remains managed by each CLI)'];
+    }
+    if (action === 'migrate-preview') {
+        const preview = admin.previewBridgeMigration();
+        return [
+            'Bridge config migration preview',
+            `  ready    ${preview.ready}`,
+            `  blocked  ${preview.blocked}`,
+            ...preview.items.map(item => `  ${item.configName}  ${item.kind} · ${item.ready ? 'ready' : item.issues.join('; ')}`),
+            '  Native CLI OAuth/session secrets are not read.',
+        ];
+    }
+    if (action === 'migrate-apply') {
+        const result = await admin.importBridgeMigration();
+        return ['Bridge config migration', ...Object.entries(result).map(([key, value]) => `  ${key}  ${String(value)}`)];
+    }
+    if (action === 'import-preview' || action === 'import-apply') {
+        const filePath = required(words.shift(), 'Keyway export file');
+        const result = action === 'import-preview'
+            ? await admin.previewPortableMigration(filePath)
+            : await admin.importPortableMigration(filePath);
+        return [
+            action === 'import-preview' ? 'Keyway import preview' : 'Keyway import',
+            ...Object.entries(result).map(([key, value]) => `  ${key}  ${typeof value === 'object' ? JSON.stringify(value) : String(value)}`),
+        ];
+    }
+    const id = required(words.shift(), 'credential id');
+    const existing = catalog.credentials.find(item => item.id === id);
+    if (action === 'test') {
+        const result = await admin.testCredential(id);
+        return [`Credential ${id}: ${String(result.state)}${result.tested === false ? ' (configuration only)' : ''}`];
+    }
+    if (action === 'disable') {
+        if (!existing)
+            throw new TypeError('Credential not found.');
+        await admin.saveCredential({ ...existing, id, providerId: existing.providerId, enabled: false });
+        return [`Credential ${id}: disabled`];
+    }
+    if (action !== 'add' && action !== 'rotate')
+        throw new TypeError('Usage: /keys list|add|disable|rotate|test|migrate-preview|migrate-apply|import-preview|import-apply');
+    if (!port.promptSecret)
+        throw new TypeError('Use Configuration → Usage & Routing → API Keys to save a write-only secret.');
+    const providerId = action === 'rotate'
+        ? required(existing?.providerId, 'existing credential')
+        : required(words.shift(), 'provider id');
+    const secret = await port.promptSecret(`Secret for ${id}`);
+    if (!secret)
+        return [`Credential ${id}: unchanged`];
+    await admin.saveCredential({
+        ...(existing ?? {}),
+        id,
+        providerId,
+        label: words.join(' ') || existing?.label || id,
+        secret,
+        enabled: true,
+    });
+    return [`Credential ${id}: ${action === 'rotate' ? 'rotated' : 'saved'} (write-only)`];
+}
+async function routesLines(admin, words, port) {
+    const action = words.shift() || 'list';
+    const catalog = await admin.catalog();
+    if (action === 'list') {
+        return catalog.routes.length
+            ? ['Gateway Routes', ...catalog.routes.map(route => `  ${route.alias}  ${route.mode} · ${route.candidates.length} candidate(s)${route.enabled ? '' : ' · disabled'}`)]
+            : ['Gateway Routes', '  (none)'];
+    }
+    const reference = required(words.shift(), 'route id or alias');
+    const route = catalog.routes.find(item => item.id === reference || item.alias === reference);
+    if (!route)
+        throw new TypeError('Route not found.');
+    if (action === 'show')
+        return [
+            `${route.alias} (${route.id})`,
+            `  mode  ${route.mode}`,
+            ...route.candidates.map(item => `  ${item.targetId} → ${item.upstreamModel} · priority ${item.priority}${item.enabled ? '' : ' · disabled'}`),
+        ];
+    if (action === 'enable') {
+        await admin.saveRoute({ ...route, enabled: true });
+        return [`Route ${route.alias}: enabled`];
+    }
+    if (action === 'test') {
+        const candidate = route.candidates.find(item => item.enabled) ?? route.candidates[0];
+        if (!candidate)
+            throw new TypeError('Route has no candidate.');
+        const target = catalog.targets.find(item => item.id === candidate.targetId);
+        if (!target)
+            throw new TypeError('Route target not found.');
+        if (target.kind === 'native-cli') {
+            const result = await admin.testTarget(target.id);
+            return [`Route ${route.alias}: ${String(result.state ?? 'unknown')} (${target.runtime} native login)`];
+        }
+        const credential = catalog.credentials.find(item => item.providerId === target.providerId && item.enabled);
+        if (!credential)
+            return [`Route ${route.alias}: no enabled credential for ${target.providerId}`];
+        const result = await admin.testCredential(credential.id);
+        return [`Route ${route.alias}: ${String(result.state)} via ${target.providerId}`];
+    }
+    if (action === 'use') {
+        if (!port.activateRoute)
+            throw new TypeError('Gateway Route activation is unavailable in this host.');
+        const selected = await port.activateRoute(route.alias);
+        return [`Route ${selected.routeAlias}: active in Hadamard (${selected.model})`];
+    }
+    throw new TypeError('Usage: /routes list|show|test|enable|use');
+}
+async function gatewayLines(admin, words) {
+    const action = words.shift() || 'status';
+    if (action === 'status')
+        return gatewayStatusLines(admin.gatewayStatus());
+    if (action === 'start')
+        return gatewayStatusLines(await admin.startGateway());
+    if (action === 'stop')
+        return gatewayStatusLines(await admin.stopGateway());
+    throw new TypeError('Usage: /gateway status|start|stop');
+}
+function gatewayStatusLines(status) {
+    if (status.running !== true)
+        return ['Embedded Keyway gateway', '  loopback  stopped'];
+    return [
+        'Embedded Keyway gateway',
+        `  loopback  running at ${String(status.url ?? 'unknown')}`,
+        `  auth      ${String(status.authentication ?? 'client-key')}`,
+        ...(typeof status.clientKey === 'string'
+            ? [`  client key (shown once)  ${status.clientKey}`]
+            : []),
+    ];
+}
+function tokenize(value) {
+    return value.match(/"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\S+/gu)?.map(token => {
+        if ((token.startsWith('"') && token.endsWith('"')) || (token.startsWith("'") && token.endsWith("'")))
+            return token.slice(1, -1);
+        return token;
+    }) ?? [];
+}
+function required(value, name) {
+    if (!value)
+        throw new TypeError(`${name} is required.`);
+    return value;
+}
+function scopeLabel(scope) {
+    return scope.kind === 'global' ? 'global' : `${scope.kind}:${scope.id ?? ''}`;
+}
+//# sourceMappingURL=usageRoutingCommand.js.map

package/dist/src/ui/usageRoutingCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageRoutingCommand.js","sourceRoot":"","sources":["../../../src/ui/usageRoutingCommand.ts"],"names":[],"mappings":"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"}

package/dist/src/usage/budgetService.d.ts

@@ -0,0 +1,28 @@
+import type { BudgetContext, BudgetDecision, BudgetReservation, BudgetReservationOutcome, UsageCounters } from './contracts.js';
+export interface BudgetTransactionPort {
+    reserveBudget(requestId: string, estimate: Partial<UsageCounters>, context?: BudgetContext): Promise<BudgetReservationOutcome>;
+    reconcileBudget(reservations: readonly BudgetReservation[], usage: UsageCounters): Promise<void>;
+}
+export interface BudgetStorePort {
+    transaction<T>(operation: (transaction: BudgetTransactionPort) => Promise<T>): Promise<T>;
+}
+export interface BudgetNotification {
+    title: string;
+    body: string;
+    severity: 'warning' | 'critical';
+    decision: BudgetDecision;
+}
+export interface BudgetPreflightResult extends BudgetReservationOutcome {
+    action: 'allow' | 'deny' | 'fallback';
+    fallbackRouteId?: string;
+}
+/** Coordinates Keyway-compatible atomic budget reservation and UI notifications. */
+export declare class UsageBudgetService {
+    private readonly store;
+    private readonly notify?;
+    constructor(store: BudgetStorePort, notify?: ((notification: BudgetNotification) => void) | undefined);
+    reserve(requestId: string, estimate: Partial<UsageCounters>, context?: BudgetContext): Promise<BudgetPreflightResult>;
+    reconcile(reservations: readonly BudgetReservation[], usage: UsageCounters): Promise<void>;
+}
+export declare function formatBudgetNotification(decision: BudgetDecision): BudgetNotification;
+//# sourceMappingURL=budgetService.d.ts.map

package/dist/src/usage/budgetService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgetService.d.ts","sourceRoot":"","sources":["../../../src/usage/budgetService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,qBAAqB;IACpC,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,EAChC,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,eAAe,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClG;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,qBAAqB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;IACjC,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACrE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,oFAAoF;AACpF,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBADP,KAAK,EAAE,eAAe,EACtB,MAAM,CAAC,GAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,IAAI,aAAA;IAGhE,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,EAChC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,qBAAqB,CAAC;IAmB3B,SAAS,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjG;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,GAAG,kBAAkB,CAerF"}

package/dist/src/usage/budgetService.js

@@ -0,0 +1,50 @@
+/** Coordinates Keyway-compatible atomic budget reservation and UI notifications. */
+export class UsageBudgetService {
+    store;
+    notify;
+    constructor(store, notify) {
+        this.store = store;
+        this.notify = notify;
+    }
+    async reserve(requestId, estimate, context = {}) {
+        const outcome = await this.store.transaction(transaction => transaction.reserveBudget(requestId, estimate, context));
+        const fallback = outcome.decisions.find(decision => decision.decision === 'fallback');
+        const denied = outcome.decisions.find(decision => decision.decision === 'denied');
+        for (const decision of outcome.decisions) {
+            if (decision.decision !== 'allowed')
+                this.notify?.(formatBudgetNotification(decision));
+        }
+        if (fallback) {
+            return {
+                ...outcome,
+                action: 'fallback',
+                ...(fallback.fallbackRouteId ? { fallbackRouteId: fallback.fallbackRouteId } : {}),
+            };
+        }
+        if (denied)
+            return { ...outcome, action: 'deny' };
+        return { ...outcome, action: 'allow' };
+    }
+    async reconcile(reservations, usage) {
+        if (reservations.length === 0)
+            return;
+        await this.store.transaction(transaction => transaction.reconcileBudget(reservations, usage));
+    }
+}
+export function formatBudgetNotification(decision) {
+    const percent = decision.limit > 0
+        ? Math.min(999, Math.round(((decision.used + decision.reserved + decision.requested) / decision.limit) * 100))
+        : 100;
+    const label = decision.decision === 'warned'
+        ? 'Budget warning'
+        : decision.decision === 'fallback'
+            ? 'Budget route fallback'
+            : 'Budget limit reached';
+    return {
+        title: label,
+        body: `${decision.policyId}: ${percent}% of limit (${decision.used + decision.reserved} used/reserved, ${decision.requested} requested).`,
+        severity: decision.decision === 'warned' ? 'warning' : 'critical',
+        decision,
+    };
+}
+//# sourceMappingURL=budgetService.js.map

package/dist/src/usage/budgetService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgetService.js","sourceRoot":"","sources":["../../../src/usage/budgetService.ts"],"names":[],"mappings":"AAiCA,oFAAoF;AACpF,MAAM,OAAO,kBAAkB;IAEV;IACA;IAFnB,YACmB,KAAsB,EACtB,MAAmD;QADnD,UAAK,GAAL,KAAK,CAAiB;QACtB,WAAM,GAAN,MAAM,CAA6C;IACnE,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,QAAgC,EAChC,UAAyB,EAAE;QAE3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CACzD,WAAW,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAClF,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,EAAE,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,UAAU;gBAClB,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnF,CAAC;QACJ,CAAC;QACD,IAAI,MAAM;YAAE,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAClD,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,YAA0C,EAAE,KAAoB;QAC9E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACtC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,eAAe,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;IAChG,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAwB;IAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC;QAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QAC9G,CAAC,CAAC,GAAG,CAAC;IACR,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,KAAK,QAAQ;QAC1C,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,QAAQ,CAAC,QAAQ,KAAK,UAAU;YAChC,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,sBAAsB,CAAC;IAC7B,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,GAAG,QAAQ,CAAC,QAAQ,KAAK,OAAO,eAAe,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,QAAQ,mBAAmB,QAAQ,CAAC,SAAS,cAAc;QACzI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;QACjE,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/src/usage/contracts.d.ts

@@ -0,0 +1,149 @@
+export type UsageSource = 'hadamard' | 'bridge' | 'keyway' | 'native-cli' | 'import';
+export type UsageStatus = 'succeeded' | 'failed' | 'cancelled' | 'denied';
+export type UsageAccuracy = 'actual' | 'estimated' | 'unknown';
+export interface UsageCounters {
+    requests: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens: number;
+    audioInputTokens: number;
+    audioOutputTokens: number;
+    costUsd?: number;
+    accuracy: UsageAccuracy;
+}
+export interface UsageRouteAttempt {
+    attempt: number;
+    targetId: string;
+    providerId?: string;
+    credentialId?: string;
+    upstreamModel: string;
+    startedAt: string;
+    completedAt: string;
+    status: UsageStatus;
+    statusCode?: number;
+    retryable?: boolean;
+    latencyMs: number;
+    errorCode?: string;
+}
+interface UsageEventRequest {
+    version: 2;
+    eventId: string;
+    requestId: string;
+    correlationId: string;
+    timestamp: string;
+    source: UsageSource;
+    status: UsageStatus;
+    requestedModel: string;
+    resolvedModel?: string;
+    operation: 'generate' | 'stream';
+}
+interface UsageEventAttribution {
+    providerId?: string;
+    credentialId?: string;
+    routeId?: string;
+    routeAlias?: string;
+    targetId?: string;
+    configurationId?: string;
+    projectId?: string;
+    agentId?: string;
+    sessionId?: string;
+    runId?: string;
+}
+interface UsageEventResult {
+    usage: UsageCounters;
+    attempts: readonly UsageRouteAttempt[];
+    durationMs: number;
+    timeToFirstTokenMs?: number;
+    streaming: boolean;
+    budgetDecision?: 'allowed' | 'warned' | 'denied' | 'fallback';
+}
+/** Stable, prompt-free event contract shared by the ledger and Keyway adapters. */
+export type UsageEventV2 = UsageEventRequest & UsageEventAttribution & UsageEventResult;
+export interface UsageFilter {
+    from?: string;
+    to?: string;
+    source?: UsageSource;
+    status?: UsageStatus;
+    model?: string;
+    providerId?: string;
+    credentialId?: string;
+    routeId?: string;
+    configurationId?: string;
+    projectId?: string;
+    agentId?: string;
+    sessionId?: string;
+    runId?: string;
+}
+export interface UsagePage extends UsageFilter {
+    limit?: number;
+    offset?: number;
+}
+export interface UsageSummary extends UsageCounters {
+    entries: number;
+}
+export interface UsageImportResult {
+    imported: number;
+    skipped: number;
+    malformed: number;
+}
+export type BudgetScope = {
+    kind: 'global';
+} | {
+    kind: 'provider';
+    id: string;
+} | {
+    kind: 'credential';
+    id: string;
+} | {
+    kind: 'route';
+    id: string;
+} | {
+    kind: 'model';
+    id: string;
+};
+export type BudgetMetric = 'requests' | 'totalTokens' | 'costUsd';
+export type BudgetPeriod = 'daily' | 'monthly' | 'lifetime';
+export type BudgetAction = 'warn' | 'deny' | 'fallbackRoute';
+export interface BudgetPolicy {
+    id: string;
+    scope: BudgetScope;
+    period: BudgetPeriod;
+    metric: BudgetMetric;
+    limit: number;
+    action: BudgetAction;
+    fallbackRouteId?: string;
+    enabled: boolean;
+}
+export interface BudgetReservation {
+    id: string;
+    requestId: string;
+    policyId: string;
+    metric: BudgetMetric;
+    periodKey: string;
+    reserved: number;
+    createdAt: string;
+}
+export interface BudgetContext {
+    providerId?: string;
+    credentialId?: string;
+    routeId?: string;
+    model?: string;
+}
+export interface BudgetDecision {
+    policyId: string;
+    decision: 'allowed' | 'warned' | 'denied' | 'fallback';
+    used: number;
+    reserved: number;
+    requested: number;
+    limit: number;
+    fallbackRouteId?: string;
+}
+export interface BudgetReservationOutcome {
+    reservations: readonly BudgetReservation[];
+    decisions: readonly BudgetDecision[];
+}
+export {};
+//# sourceMappingURL=contracts.d.ts.map