actoviq-agent-sdk 0.4.21 → 0.4.22

package/dist/src/keyway/keywayPorts.d.ts

@@ -0,0 +1,189 @@
+import type { UsageCounters, UsageEventV2 } from '../usage/contracts.js';
+export type KeywayJson = null | boolean | number | string | KeywayJson[] | {
+    [key: string]: KeywayJson;
+};
+export interface KeywayManagedTargetPort {
+    kind: 'managed-api';
+    id: string;
+    providerId: string;
+    protocol: 'openai' | 'anthropic';
+    baseUrl: string;
+    enabled: boolean;
+}
+export interface KeywayNativeTargetPort {
+    kind: 'native-cli';
+    id: string;
+    runtime: string;
+    profileName?: string;
+    configId?: string;
+    enabled: boolean;
+}
+export type KeywayExecutionTargetPort = KeywayManagedTargetPort | KeywayNativeTargetPort;
+export interface KeywayManagedCredentialPort {
+    id: string;
+    providerId: string;
+    secretRef: string;
+    label: string;
+    priority: number;
+    weight: number;
+    enabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KeywayCredentialHealthPort {
+    credentialId: string;
+    state: 'unknown' | 'healthy' | 'degraded' | 'circuit-open' | 'disabled';
+    consecutiveFailures: number;
+    lastSuccessAt?: string;
+    lastFailureAt?: string;
+    circuitOpenUntil?: string;
+}
+export interface KeywayRouteCandidatePort {
+    id: string;
+    targetId: string;
+    upstreamModel: string;
+    priority: number;
+    weight: number;
+    enabled: boolean;
+}
+export interface KeywayGatewayRoutePort {
+    id: string;
+    alias: string;
+    mode: 'direct' | 'priority-failover';
+    candidates: readonly KeywayRouteCandidatePort[];
+    enabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KeywayProviderRequestPort {
+    requestId: string;
+    correlationId: string;
+    operation: 'generate' | 'stream';
+    target: KeywayExecutionTargetPort;
+    upstreamModel: string;
+    credential?: {
+        id: string;
+        secret: string;
+    };
+    payload: KeywayJson;
+    metadata?: Readonly<Record<string, KeywayJson>>;
+    signal?: AbortSignal;
+}
+export type KeywayStreamEventPort = {
+    type: 'data';
+    value: KeywayJson;
+} | {
+    type: 'usage';
+    usage: UsageCounters;
+} | {
+    type: 'provider-event';
+    value: KeywayJson;
+};
+export interface KeywayProviderResultPort {
+    output: KeywayJson;
+    usage: UsageCounters;
+    statusCode?: number;
+    providerRequestId?: string;
+}
+export interface KeywayProviderHandlePort extends AsyncIterable<KeywayStreamEventPort> {
+    result: Promise<KeywayProviderResultPort>;
+    cancel(reason?: unknown): void;
+}
+export interface KeywayProviderExecutorPort {
+    execute(request: KeywayProviderRequestPort): KeywayProviderHandlePort;
+}
+export interface KeywayExecutionRequestPort {
+    requestId: string;
+    correlationId: string;
+    routeAlias: string;
+    requestedModel: string;
+    operation: 'generate' | 'stream';
+    payload: KeywayJson;
+    estimatedUsage?: Partial<UsageCounters>;
+    metadata?: Readonly<Record<string, KeywayJson>>;
+    signal?: AbortSignal;
+}
+export interface KeywayExecutionResultPort extends KeywayProviderResultPort {
+    requestId: string;
+    correlationId: string;
+    routeId: string;
+}
+export interface KeywayExecutionHandlePort extends AsyncIterable<KeywayStreamEventPort> {
+    result: Promise<KeywayExecutionResultPort>;
+    cancel(reason?: unknown): void;
+}
+export interface KeywayCorePort {
+    execute(request: KeywayExecutionRequestPort): KeywayExecutionHandlePort;
+}
+export interface KeywaySecretStorePort {
+    put(secretRef: string, value: string): Promise<void>;
+    resolve(secretRef: string): Promise<string | undefined>;
+    has(secretRef: string): Promise<boolean>;
+    remove(secretRef: string): Promise<void>;
+}
+export interface KeywayStorePort {
+    close(): void;
+    saveTarget(target: KeywayExecutionTargetPort): void;
+    listTargets(): Promise<readonly KeywayExecutionTargetPort[]>;
+    deleteTarget(targetId: string): boolean;
+    saveCredential(credential: KeywayManagedCredentialPort): void;
+    listManagedCredentials(providerId?: string): Promise<readonly KeywayManagedCredentialPort[]>;
+    deleteCredential(credentialId: string): boolean;
+    getCredentialHealth(credentialId: string): Promise<KeywayCredentialHealthPort | undefined>;
+    saveRoute(route: KeywayGatewayRoutePort): void;
+    listRoutes(): Promise<readonly KeywayGatewayRoutePort[]>;
+    deleteRoute(routeId: string): boolean;
+    saveBudgetPolicy(policy: import('../usage/contracts.js').BudgetPolicy): void;
+    listManagedBudgetPolicies(): Promise<readonly import('../usage/contracts.js').BudgetPolicy[]>;
+    deleteBudgetPolicy(policyId: string): boolean;
+}
+export interface KeywayLoopbackGatewayInstancePort {
+    status(): {
+        running: boolean;
+        host: string;
+        port: number;
+        url: string;
+        authentication: 'client-key' | 'none';
+    };
+    close(): Promise<void>;
+}
+export interface KeywayGatewayModulePort {
+    KEYWAY_GATEWAY_VERSION: 1;
+    LoopbackGateway: {
+        start(options: {
+            core: KeywayCorePort;
+            store: KeywayStorePort;
+            clientKeys: readonly string[];
+            host: string;
+            port: number;
+        }): Promise<KeywayLoopbackGatewayInstancePort>;
+    };
+}
+export interface KeywaySdkModulesPort {
+    core: {
+        KEYWAY_CONTRACT_VERSION: 1;
+        assertKeywayExportV1(value: unknown): void;
+        createKeywayCore(options: {
+            store: unknown;
+            secretStore: KeywaySecretStorePort;
+            executor: KeywayProviderExecutorPort;
+            usageSink: {
+                append(event: UsageEventV2): Promise<void>;
+            };
+        }): KeywayCorePort;
+    };
+    node: {
+        SqliteKeywayStore: new (options: {
+            filePath: string;
+        }) => KeywayStorePort;
+        EnvironmentSecretStore: new (environment?: NodeJS.ProcessEnv, prefix?: string) => KeywaySecretStorePort;
+        EncryptedFileSecretStore: new (options: {
+            filePath: string;
+            masterKey: Uint8Array;
+        }) => KeywaySecretStorePort;
+        CompositeSecretStore: new (managed: KeywaySecretStorePort, environment?: KeywaySecretStorePort) => KeywaySecretStorePort;
+        decodeMasterKey(value: string): Uint8Array;
+        importKeywayV1(store: KeywayStorePort, value: unknown): Promise<Record<string, number>>;
+    };
+}
+//# sourceMappingURL=keywayPorts.d.ts.map

package/dist/src/keyway/keywayPorts.d.ts.map

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

package/dist/src/keyway/keywayPorts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=keywayPorts.js.map

package/dist/src/keyway/keywayPorts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywayPorts.js","sourceRoot":"","sources":["../../../src/keyway/keywayPorts.ts"],"names":[],"mappings":""}

package/dist/src/keyway/keywayProviderExecutor.d.ts

@@ -0,0 +1,30 @@
+import { type ExternalCliAuthProbeOptions, type ExternalCliAuthStatus, type NativeCliClientPort } from '../nativeCli/keywayNativeCliAdapter.js';
+import type { HadamardBridgeRunResult, ModelApi } from '../types.js';
+import type { Message, MessageStreamEvent } from '../provider/types.js';
+import type { UsageCounters } from '../usage/contracts.js';
+import type { KeywayJson, KeywayManagedTargetPort, KeywayNativeTargetPort, KeywayProviderExecutorPort, KeywayProviderHandlePort, KeywayProviderRequestPort } from './keywayPorts.js';
+export type ManagedModelApiFactory = (target: KeywayManagedTargetPort, model: string, secret: string) => Promise<ModelApi>;
+export type { NativeCliClientPort, NativeCliRunStreamPort, } from '../nativeCli/keywayNativeCliAdapter.js';
+export type NativeCliClientFactory = (target: KeywayNativeTargetPort, model: string) => Promise<NativeCliClientPort>;
+export interface HadamardKeywayProviderExecutorOptions {
+    homeDir?: string;
+    workDir?: string;
+    managedModelApiFactory?: ManagedModelApiFactory;
+    nativeCliClientFactory?: NativeCliClientFactory;
+}
+/** Status-only native auth probe; never reads or returns OAuth/session secrets. */
+export declare function probeKeywayNativeTargetAuth(target: KeywayNativeTargetPort, options?: ExternalCliAuthProbeOptions): Promise<ExternalCliAuthStatus>;
+/** Executes Keyway targets through Hadamard's existing provider and native CLI runtimes. */
+export declare class HadamardKeywayProviderExecutor implements KeywayProviderExecutorPort {
+    private readonly managedFactory;
+    private readonly nativeFactory;
+    constructor(options?: HadamardKeywayProviderExecutorOptions);
+    execute(request: KeywayProviderRequestPort): KeywayProviderHandlePort;
+    private executeManaged;
+    private executeNative;
+}
+export declare function providerUsage(value: unknown): UsageCounters;
+export declare function bridgeUsage(result: HadamardBridgeRunResult): UsageCounters;
+export declare function keywayOutputToMessage(output: KeywayJson, model: string): Message;
+export declare function keywayDataToMessageStreamEvent(value: KeywayJson): MessageStreamEvent | undefined;
+//# sourceMappingURL=keywayProviderExecutor.d.ts.map

package/dist/src/keyway/keywayProviderExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywayProviderExecutor.d.ts","sourceRoot":"","sources":["../../../src/keyway/keywayProviderExecutor.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,KAAK,EACV,uBAAuB,EACvB,QAAQ,EAET,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,UAAU,EACV,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EAG1B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,sBAAsB,GAAG,CACnC,MAAM,EAAE,uBAAuB,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,YAAY,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAEhD,MAAM,MAAM,sBAAsB,GAAG,CACnC,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,MAAM,WAAW,qCAAqC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;CACjD;AAED,mFAAmF;AACnF,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED,4FAA4F;AAC5F,qBAAa,8BAA+B,YAAW,0BAA0B;IAC/E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;gBAE3C,OAAO,GAAE,qCAA0C;IAM/D,OAAO,CAAC,OAAO,EAAE,yBAAyB,GAAG,wBAAwB;YAMvD,cAAc;YAyBd,aAAa;CA2C5B;AAoCD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAgB3D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,uBAAuB,GAAG,aAAa,CAqB1E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAchF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,GAAG,SAAS,CAIhG"}

package/dist/src/keyway/keywayProviderExecutor.js

@@ -0,0 +1,257 @@
+import { randomUUID } from 'node:crypto';
+import { resolveRuntimeConfig } from '../config/resolveRuntimeConfig.js';
+import { createHadamardNativeCliClient, nativeCliModelOverride, probeHadamardNativeCliAuth, } from '../nativeCli/keywayNativeCliAdapter.js';
+import { createOpenaiModelApi } from '../provider/openai-model-api.js';
+import { createHadamardModelApi } from '../runtime/hadamardModelApi.js';
+/** Status-only native auth probe; never reads or returns OAuth/session secrets. */
+export function probeKeywayNativeTargetAuth(target, options = {}) {
+    return probeHadamardNativeCliAuth(target, options);
+}
+/** Executes Keyway targets through Hadamard's existing provider and native CLI runtimes. */
+export class HadamardKeywayProviderExecutor {
+    managedFactory;
+    nativeFactory;
+    constructor(options = {}) {
+        this.managedFactory = options.managedModelApiFactory ?? defaultManagedModelApiFactory;
+        this.nativeFactory = options.nativeCliClientFactory ?? ((target, model) => createHadamardNativeCliClient(target, model, options));
+    }
+    execute(request) {
+        return new ProviderHandle(request.signal, (emit, signal) => request.target.kind === 'managed-api'
+            ? this.executeManaged(request, request.target, emit, signal)
+            : this.executeNative(request, request.target, emit, signal));
+    }
+    async executeManaged(request, target, emit, signal) {
+        const secret = request.credential?.secret;
+        if (!secret)
+            throw Object.assign(new Error(`Managed target ${target.id} requires a credential.`), { retryable: true });
+        const modelApi = await this.managedFactory(target, request.upstreamModel, secret);
+        const modelRequest = managedModelRequest(request.payload, request.upstreamModel, signal);
+        if (request.operation === 'generate') {
+            const message = await modelApi.createMessage(modelRequest);
+            return messageResult(message);
+        }
+        const stream = modelApi.streamMessage(modelRequest);
+        const settled = stream.finalMessage().then(value => ({ ok: true, value }), error => ({ ok: false, error }));
+        for await (const event of stream)
+            emit({ type: 'data', value: toJson(event) });
+        const final = await settled;
+        if (!final.ok)
+            throw final.error;
+        return messageResult(final.value);
+    }
+    async executeNative(request, target, emit, signal) {
+        const payload = record(request.payload);
+        const prompt = stringValue(payload?.prompt, 'native CLI payload.prompt');
+        const client = await this.nativeFactory(target, request.upstreamModel);
+        try {
+            const resume = optionalString(payload?.resume) ?? optionalString(payload?.sessionId);
+            const model = nativeCliModelOverride(request.upstreamModel);
+            const stream = client.stream(prompt, {
+                signal,
+                ...(model ? { model } : {}),
+                ...(optionalString(payload?.workDir) ? { workDir: optionalString(payload?.workDir) } : {}),
+                ...(resume ? { sessionId: resume, resume } : {}),
+            });
+            const settled = stream.result.then(value => ({ ok: true, value }), error => ({ ok: false, error }));
+            for await (const event of stream)
+                emit({ type: 'data', value: toJson(event) });
+            const final = await settled;
+            if (!final.ok)
+                throw final.error;
+            if (final.value.isError) {
+                throw Object.assign(new Error(final.value.text || 'Native CLI execution failed.'), { retryable: false });
+            }
+            return {
+                output: toJson({
+                    text: final.value.text,
+                    sessionId: final.value.sessionId,
+                    stopReason: final.value.stopReason,
+                    durationMs: final.value.durationMs,
+                }),
+                usage: bridgeUsage(final.value),
+                statusCode: 200,
+                providerRequestId: final.value.sessionId || undefined,
+            };
+        }
+        finally {
+            await client.close();
+        }
+    }
+}
+async function defaultManagedModelApiFactory(target, model, secret) {
+    const config = await resolveRuntimeConfig({
+        provider: target.protocol,
+        model,
+        apiKey: secret,
+        baseURL: target.baseUrl,
+        maxRetries: 0,
+    });
+    return target.protocol === 'openai'
+        ? createOpenaiModelApi(config)
+        : createHadamardModelApi(config);
+}
+function managedModelRequest(payload, model, signal) {
+    const outer = record(payload);
+    const value = record(outer?.modelRequest) ?? outer;
+    if (!value || !Array.isArray(value.messages) || typeof value.max_tokens !== 'number') {
+        throw Object.assign(new TypeError('Managed payload must be a ModelRequest or { modelRequest }.'), { retryable: false });
+    }
+    return { ...value, model, signal };
+}
+function messageResult(message) {
+    return {
+        output: toJson(message),
+        usage: providerUsage(message.usage),
+        providerRequestId: message.id,
+    };
+}
+export function providerUsage(value) {
+    const usage = record(value);
+    const inputTokens = nonNegative(usage?.input_tokens);
+    const outputTokens = nonNegative(usage?.output_tokens);
+    return {
+        requests: 1,
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens,
+        cacheReadTokens: nonNegative(usage?.cache_read_input_tokens),
+        cacheWriteTokens: nonNegative(usage?.cache_creation_input_tokens),
+        reasoningTokens: nestedNumber(usage, ['output_tokens_details', 'reasoning_tokens']),
+        audioInputTokens: nestedNumber(usage, ['input_tokens_details', 'audio_tokens']),
+        audioOutputTokens: nestedNumber(usage, ['output_tokens_details', 'audio_tokens']),
+        accuracy: usage ? 'actual' : 'unknown',
+    };
+}
+export function bridgeUsage(result) {
+    const resultEvent = record(result.resultEvent);
+    const rawUsage = record(resultEvent?.usage);
+    const inputTokens = nonNegative(rawUsage?.input_tokens ?? resultEvent?.input_tokens);
+    const outputTokens = nonNegative(rawUsage?.output_tokens ?? resultEvent?.output_tokens);
+    const hasTokens = inputTokens > 0 || outputTokens > 0;
+    return {
+        requests: 1,
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens,
+        cacheReadTokens: nonNegative(rawUsage?.cache_read_input_tokens),
+        cacheWriteTokens: nonNegative(rawUsage?.cache_creation_input_tokens),
+        reasoningTokens: nestedNumber(rawUsage, ['output_tokens_details', 'reasoning_tokens']),
+        audioInputTokens: 0,
+        audioOutputTokens: 0,
+        ...(typeof result.totalCostUsd === 'number' && Number.isFinite(result.totalCostUsd)
+            ? { costUsd: Math.max(0, result.totalCostUsd) }
+            : {}),
+        accuracy: hasTokens ? 'actual' : result.totalCostUsd !== undefined ? 'estimated' : 'unknown',
+    };
+}
+export function keywayOutputToMessage(output, model) {
+    const value = record(output);
+    if (value?.type === 'message' && value.role === 'assistant' && Array.isArray(value.content)) {
+        return value;
+    }
+    const text = optionalString(value?.text) ?? (typeof output === 'string' ? output : JSON.stringify(output));
+    return {
+        id: `keyway-${randomUUID()}`,
+        type: 'message',
+        role: 'assistant',
+        model,
+        content: [{ type: 'text', text }],
+        stop_reason: 'end_turn',
+    };
+}
+export function keywayDataToMessageStreamEvent(value) {
+    const event = record(value);
+    const unwrapped = event?.type === 'stream_event' ? record(event.event) : event;
+    return typeof unwrapped?.type === 'string' ? unwrapped : undefined;
+}
+function toJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringValue(value, name) {
+    if (typeof value !== 'string' || !value.trim())
+        throw Object.assign(new TypeError(`${name} is required.`), { retryable: false });
+    return value;
+}
+function optionalString(value) {
+    return typeof value === 'string' && value ? value : undefined;
+}
+function nonNegative(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.max(0, value) : 0;
+}
+function nestedNumber(value, path) {
+    let current = value;
+    for (const key of path)
+        current = record(current)?.[key];
+    return nonNegative(current);
+}
+class ProviderHandle {
+    result;
+    queue = new AsyncQueue();
+    controller = new AbortController();
+    constructor(signal, operation) {
+        if (signal?.aborted)
+            this.controller.abort(signal.reason);
+        else
+            signal?.addEventListener('abort', () => this.cancel(signal.reason), { once: true });
+        this.result = Promise.resolve().then(() => operation(event => this.queue.push(event), this.controller.signal))
+            .then(result => {
+            this.queue.finish();
+            return result;
+        }, error => {
+            this.queue.fail(error);
+            throw error;
+        });
+        void this.result.catch(() => undefined);
+    }
+    cancel(reason) {
+        if (!this.controller.signal.aborted)
+            this.controller.abort(reason);
+    }
+    [Symbol.asyncIterator]() {
+        return this.queue[Symbol.asyncIterator]();
+    }
+}
+class AsyncQueue {
+    values = [];
+    waiters = [];
+    ended = false;
+    error;
+    push(value) {
+        const waiter = this.waiters.shift();
+        if (waiter)
+            waiter.resolve({ value, done: false });
+        else
+            this.values.push(value);
+    }
+    finish() {
+        this.ended = true;
+        for (const waiter of this.waiters.splice(0))
+            waiter.resolve({ value: undefined, done: true });
+    }
+    fail(error) {
+        this.error = error;
+        this.ended = true;
+        for (const waiter of this.waiters.splice(0))
+            waiter.reject(error);
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                const value = this.values.shift();
+                if (value !== undefined)
+                    return Promise.resolve({ value, done: false });
+                if (this.error !== undefined)
+                    return Promise.reject(this.error);
+                if (this.ended)
+                    return Promise.resolve({ value: undefined, done: true });
+                return new Promise((resolve, reject) => this.waiters.push({ resolve, reject }));
+            },
+        };
+    }
+}
+//# sourceMappingURL=keywayProviderExecutor.js.map

package/dist/src/keyway/keywayProviderExecutor.js.map

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

package/dist/src/keyway/routingComposition.d.ts

@@ -0,0 +1,18 @@
+export type HadamardRoutingTarget = {
+    kind: 'gateway-route';
+    routeAlias: string;
+} | {
+    kind: 'agent-router';
+    profileName: string;
+} | {
+    kind: 'model-team';
+    teamName: string;
+};
+export interface RoutingSelectionInput {
+    gatewayRouteAlias?: string;
+    agentRouterProfile?: string;
+    modelTeam?: string;
+}
+/** Prevents two orchestration layers from simultaneously owning top-level dispatch. */
+export declare function resolveRoutingTargetSelection(input: RoutingSelectionInput): HadamardRoutingTarget | undefined;
+//# sourceMappingURL=routingComposition.d.ts.map

package/dist/src/keyway/routingComposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routingComposition.d.ts","sourceRoot":"","sources":["../../../src/keyway/routingComposition.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uFAAuF;AACvF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB,GAAG,SAAS,CAkB7G"}

package/dist/src/keyway/routingComposition.js

@@ -0,0 +1,19 @@
+/** Prevents two orchestration layers from simultaneously owning top-level dispatch. */
+export function resolveRoutingTargetSelection(input) {
+    const selections = [];
+    if (input.gatewayRouteAlias?.trim()) {
+        selections.push({ kind: 'gateway-route', routeAlias: input.gatewayRouteAlias.trim() });
+    }
+    if (input.agentRouterProfile?.trim()) {
+        selections.push({ kind: 'agent-router', profileName: input.agentRouterProfile.trim() });
+    }
+    if (input.modelTeam?.trim()) {
+        selections.push({ kind: 'model-team', teamName: input.modelTeam.trim() });
+    }
+    if (selections.length > 1) {
+        throw new TypeError('Choose one top-level routing owner: Gateway Route, Agent Router, or Model Team. '
+            + 'A Model Team member or Agent Router leaf may still reference a Gateway Route explicitly.');
+    }
+    return selections[0];
+}
+//# sourceMappingURL=routingComposition.js.map

package/dist/src/keyway/routingComposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routingComposition.js","sourceRoot":"","sources":["../../../src/keyway/routingComposition.ts"],"names":[],"mappings":"AAWA,uFAAuF;AACvF,MAAM,UAAU,6BAA6B,CAAC,KAA4B;IACxE,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,IAAI,KAAK,CAAC,iBAAiB,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,KAAK,CAAC,kBAAkB,EAAE,IAAI,EAAE,EAAE,CAAC;QACrC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CACjB,kFAAkF;cAChF,0FAA0F,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/src/keyway/usageRoutingAdminService.d.ts

@@ -0,0 +1,86 @@
+import type { UsageFilter, UsagePage, UsageSummary, BudgetPolicy } from '../usage/contracts.js';
+import type { KeywayMigrationService } from './keywayMigrationService.js';
+import type { KeywayExecutionTargetPort, KeywayGatewayRoutePort, KeywayManagedCredentialPort, KeywayProviderExecutorPort, KeywaySecretStorePort, KeywayStorePort } from './keywayPorts.js';
+export interface UsageTrendPoint {
+    date: string;
+    requests: number;
+    tokens: number;
+    costUsd: number;
+}
+export interface UsageRoutingOverview {
+    summary: UsageSummary;
+    trend: readonly UsageTrendPoint[];
+    byProvider: readonly {
+        key: string;
+        requests: number;
+        tokens: number;
+        costUsd: number;
+    }[];
+    unknownUsageEntries: number;
+}
+export interface UsageRoutingCatalog {
+    targets: readonly KeywayExecutionTargetPort[];
+    routes: readonly KeywayGatewayRoutePort[];
+    budgets: readonly BudgetPolicy[];
+    credentials: ReadonlyArray<Omit<KeywayManagedCredentialPort, 'secretRef'> & {
+        secretConfigured: boolean;
+        health: Awaited<ReturnType<KeywayStorePort['getCredentialHealth']>>;
+    }>;
+}
+export interface UsageRoutingAdminServiceOptions {
+    homeDir: string;
+    store: KeywayStorePort;
+    secretStore: KeywaySecretStorePort;
+    executor?: KeywayProviderExecutorPort;
+    gateway?: {
+        status(): object;
+        start(port?: number): Promise<object>;
+        stop(): Promise<object>;
+    };
+    migration?: KeywayMigrationService;
+    now?: () => Date;
+    idFactory?: () => string;
+}
+/** Host-owned admin facade. No method returns secret values or prompt content. */
+export declare class UsageRoutingAdminService {
+    private readonly usage;
+    private readonly options;
+    private constructor();
+    static open(options: UsageRoutingAdminServiceOptions): Promise<UsageRoutingAdminService>;
+    overview(filter?: UsageFilter): UsageRoutingOverview;
+    ledger(page?: UsagePage): {
+        summary: UsageSummary;
+        events: import("../usage/contracts.js").UsageEventV2[];
+    };
+    catalog(): Promise<UsageRoutingCatalog>;
+    saveCredential(input: Record<string, unknown>): Promise<{
+        id: string;
+    }>;
+    deleteCredential(id: string): Promise<boolean>;
+    saveTarget(input: Record<string, unknown>): {
+        id: string;
+    };
+    deleteTarget(id: string): boolean;
+    saveRoute(input: Record<string, unknown>): Promise<{
+        id: string;
+    }>;
+    deleteRoute(id: string): boolean;
+    saveBudget(input: Record<string, unknown>): {
+        id: string;
+    };
+    deleteBudget(id: string): boolean;
+    testCredential(id: string): Promise<Record<string, unknown>>;
+    testTarget(id: string): Promise<Record<string, unknown>>;
+    gatewayStatus(): Record<string, unknown>;
+    startGateway(port?: number): Promise<Record<string, unknown>>;
+    stopGateway(): Promise<Record<string, unknown>>;
+    previewBridgeMigration(): import("./keywayMigrationService.js").BridgeMigrationPreview;
+    importBridgeMigration(): Promise<Record<string, unknown>>;
+    previewPortableMigration(filePath: string): Promise<import("./keywayMigrationService.js").PortableMigrationPreview>;
+    importPortableMigration(filePath: string): Promise<Record<string, unknown>>;
+    close(): void;
+    private now;
+    private id;
+}
+export declare function usageFilterFromSearch(search: URLSearchParams): UsagePage;
+//# sourceMappingURL=usageRoutingAdminService.d.ts.map