@jingyi0605/codingns4dsh 0.2.1-beta.9 → 0.2.1-rc.3

package/data/build/dist/host/cli-adapters/magpie-usage.d.ts

@@ -0,0 +1,148 @@
+import type { CodingNsCliAdapterId, CodingNsCliModelCatalog, CodingNsCliServiceTier, CodingNsCliSessionConfig } from '../../shared/contracts/cli-adapter.js';
+import type { MagpieQuota, MagpieUsageSnapshot } from '../../shared/contracts/subscription.js';
+import type { MagpieDashboardPeriod, MagpieDashboardStreamChunk, MagpieDashboardStreamPart, MagpieDashboardQuota, MagpieQuotaHistory, MagpieUsageDashboard, MagpieUsageGroup, MagpieUsageMetrics, MagpieUsageRequestPage, MagpieUsageSeriesPoint, MagpieUsageSession } from '../../shared/contracts/magpie-management.js';
+import type { MagpieWebService } from './magpie-web.js';
+/** A safe, non-sensitive title associated with a DSH session identity. */
+export interface MagpieSessionNameBinding {
+    readonly dshSessionId: string;
+    readonly providerSessionId?: string;
+    readonly adapterId: CodingNsCliAdapterId;
+    readonly name: string;
+}
+/** Magpie's agent IDs are verified from the matching catalog output. */
+export type MagpieAgent = string;
+interface MagpieModelCatalog {
+    readonly models: ReadonlySet<string>;
+    /** Display labels from the exact Magpie CLI rows, keyed by model ID. */
+    readonly displayNames: ReadonlyMap<string, string>;
+    /** Unique normalized CLI labels; duplicate labels are intentionally omitted. */
+    readonly names: ReadonlyMap<string, string>;
+    /** Origin only; requests are restricted to the local loopback gateway. */
+    readonly gatewayOrigin: string | null;
+}
+export interface MagpieModelMetadata {
+    readonly id: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly contextWindow?: number;
+    readonly maxInputTokens?: number;
+    readonly maxOutputTokens?: number;
+    readonly inputModalities?: readonly string[];
+    readonly outputModalities?: readonly string[];
+    readonly reasoningSupported?: boolean;
+    readonly efforts?: readonly string[];
+    readonly serviceTiers?: readonly CodingNsCliServiceTier[];
+    readonly capabilities?: readonly string[];
+    readonly ownedBy?: string;
+}
+export interface MagpieUsageServiceOptions {
+    /** Test seam for the bounded `magpie models <agent>` command. */
+    readonly readModels?: (agent: MagpieAgent, signal?: AbortSignal) => Promise<string | null>;
+    readonly readVersion?: (signal?: AbortSignal) => Promise<string | null>;
+    readonly fetch?: typeof fetch;
+    readonly now?: () => number;
+    readonly timeoutMs?: number;
+    /** Shared authenticated Web process for the full management dashboard. */
+    readonly webApi?: Pick<MagpieWebService, 'requestJson'> & Partial<Pick<MagpieWebService, 'requestAssetDataUrl'>>;
+    /** Shared catalog CLI work is cancelled when its owning Host feature stops, not by one RPC caller. */
+    readonly lifetimeSignal?: AbortSignal;
+    /** Records per-part dashboard timings without exposing them to the Client. */
+    readonly onDashboardTiming?: (timing: MagpieDashboardTiming) => void;
+}
+export interface MagpieDashboardTiming {
+    readonly part: MagpieDashboardStreamPart | 'quota-logos';
+    readonly elapsedMs: number;
+}
+export interface MagpieUsageRequestOptions {
+    readonly period: MagpieDashboardPeriod;
+    readonly offset: number;
+    readonly limit: number;
+    readonly sessionId?: string;
+    readonly sessionAgent?: string;
+}
+/** Reads usage from the authenticated local Magpie Web API and exact-matches session identity. */
+export declare class MagpieUsageService {
+    private readonly readModels;
+    private readonly readVersion;
+    private readonly request;
+    private readonly now;
+    private readonly timeoutMs;
+    private readonly lifetimeSignal;
+    private readonly webApi;
+    private readonly onDashboardTiming;
+    /** Agent CLI verification remains isolated; model metadata below is Gateway-wide and shared. */
+    private readonly catalogs;
+    private readonly catalogLoads;
+    /** `/v1/models` is Gateway-wide, so adapters with the same model set share one normalized response. */
+    private readonly modelMetadata;
+    private readonly modelMetadataLoads;
+    private versionCheck;
+    private versionLoad;
+    private readonly dashboardCache;
+    private readonly dashboardRefreshes;
+    private readonly quotaLogoCache;
+    constructor(options?: MagpieUsageServiceOptions);
+    read(session: Pick<CodingNsCliSessionConfig, 'adapterId' | 'modelId' | 'providerSessionId'>, signal?: AbortSignal, includeRoute?: boolean, dshSessionId?: string): Promise<MagpieUsageSnapshot | null>;
+    /**
+     * Mark Magpie models and enrich their public metadata. The marker is
+     * transient catalog data used by model-list UIs, not session provenance.
+     */
+    enrichModelCatalog(adapterId: CodingNsCliAdapterId, catalog: CodingNsCliModelCatalog | Promise<CodingNsCliModelCatalog>, signal?: AbortSignal): Promise<CodingNsCliModelCatalog>;
+    /** Return an exact, CLI-confirmed Magpie model record for trusted Host use. */
+    readModelMetadata(adapterId: CodingNsCliAdapterId, modelId: string, signal?: AbortSignal): Promise<MagpieModelMetadata | null>;
+    /** Read bounded, graph-ready usage and quota data through authenticated Magpie Web. */
+    readDashboard(period: MagpieDashboardPeriod, signal?: AbortSignal): Promise<MagpieUsageDashboard>;
+    /** Stream cumulative dashboard snapshots as each independent Web API part is ready. */
+    readDashboardStream(period: MagpieDashboardPeriod, signal?: AbortSignal, force?: boolean): AsyncIterable<MagpieDashboardStreamChunk>;
+    private refreshDashboard;
+    private readDashboardNetwork;
+    private timedDashboardRead;
+    /** Read one bounded Web API ledger page and exact-match session identities on Host. */
+    readRequestPage(options: MagpieUsageRequestOptions, signal?: AbortSignal): Promise<MagpieUsageRequestPage | null>;
+    private readFromWeb;
+    private attachQuotaLogos;
+    private readMagpieLogoDataUrl;
+    private loadCatalog;
+    private loadModelMetadata;
+    private supportedCli;
+    private hasFreshUnsupportedVersion;
+    private readGatewayJson;
+    private readWebJson;
+}
+/** Strict parser for the human-readable Magpie catalog; unknown formats fail closed. */
+export declare function parseMagpieModelOutput(output: string, agent: MagpieAgent): MagpieModelCatalog | null;
+/** Parse a bounded OpenAI-compatible `/v1/models` response into a safe allowlist. */
+export declare function parseMagpieModelMetadata(value: unknown): ReadonlyMap<string, MagpieModelMetadata> | null;
+/** Fail closed until the human-readable catalog format is known to match. */
+export declare function parseMagpieCliVersion(output: string | null): boolean;
+/**
+ * Magpie IDs normally match adapter IDs. Keep naming differences explicit;
+ * it is used for exact Agent identity matching in Magpie usage records.
+ */
+export declare function magpieAgentForAdapter(adapterId: CodingNsCliAdapterId): MagpieAgent | null;
+/** Return the exact Magpie Agent identities accepted for one adapter. */
+export declare function magpieUsageAgentAliases(adapterId: CodingNsCliAdapterId): readonly string[];
+/**
+ * Enrich dashboard session rows only after an exact `(Agent, session ID)` match.
+ * Provider session IDs and DSH IDs are both candidates because Command Code and
+ * native DSH use different identities across Magpie versions.
+ */
+export declare function attachMagpieSessionNames(dashboard: MagpieUsageDashboard, bindings: readonly MagpieSessionNameBinding[]): MagpieUsageDashboard;
+/** Parse the bounded `/v1/magpie/quotas` envelope without exposing raw provider records. */
+export declare function parseMagpieQuotas(value: unknown): readonly MagpieQuota[] | null;
+/** Normalize the live aggregate and per-dimension usage response. */
+export declare function parseMagpieDashboardUsage(value: unknown): {
+    readonly aggregate: MagpieUsageMetrics;
+    readonly series: readonly MagpieUsageSeriesPoint[];
+    readonly agents: readonly MagpieUsageGroup[];
+    readonly providers: readonly MagpieUsageGroup[];
+    readonly models: readonly MagpieUsageGroup[];
+    readonly accounts: readonly MagpieUsageGroup[];
+    readonly sessions: readonly MagpieUsageSession[];
+    readonly sessionCount: number | null;
+} | null;
+/** Normalize quota cards while preserving nullable values and bounded history. */
+export declare function parseMagpieQuotaCards(value: unknown): readonly MagpieDashboardQuota[] | null;
+export declare function parseMagpieQuotaHistory(value: unknown): readonly MagpieQuotaHistory[] | null;
+export {};
+//# sourceMappingURL=magpie-usage.d.ts.map

package/data/build/dist/host/cli-adapters/magpie-usage.d.ts.map

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