@ycodium-ai/plugin-api 0.2.2169 → 0.2.2488

package/dist/source-metrics.d.ts

@@ -1,158 +0,0 @@
-/**
- * `@ycodium-ai/plugin-api/source-metrics` —— 来源动态额度的**窄事实类型**。
- *
- * 本文件只含 `type` / `interface`，没有运行时值。字段是宿主 `SourceMetric` /
- * `SourceMetricsSnapshot` / `SourceMetricsCapability` 的结构子集：宿主模型必须
- * 可赋值到这里，反向不保证。不含格式化规则、缓存、轮询或查询策略。插件不得
- * import contracts / runtime；UI 组件用 `import type`。宿主按本文件构造
- * `ConversationComposerProps.sourceMetrics`。
- *
- * @module @ycodium-ai/plugin-api/source-metrics
- */
-export type SourceMetricsRefreshOutcome = "fresh" | "partial" | "joined-inflight" | "rate-limited" | "offline" | "unsupported" | "error";
-export type SourceMetricKind = "balance" | "credits" | "quota-window" | "spend-cap" | "rate-limit";
-export type SourceMetricsCapabilityStatus = "supported" | "unsupported" | "unknown";
-export type QuotaPoolScopeKind = "account" | "org" | "project" | "key" | "endpoint" | "model-group" | "model" | "unknown";
-export type SourceMetricProvenance = "reported" | "derived" | "estimated";
-export type SourceMetricStatus = "available" | "pending" | "unmeterable" | "expired" | "error";
-export type SourceMetricFreshness = "fresh" | "stale" | "unknown";
-/** 凭据身份：稳定 id + 单调 revision，不能用邮箱或路径代替。 */
-export interface SourceMetricsCredentialIdentity {
-    readonly id: string;
-    readonly revision: number;
-}
-export interface QuotaPoolScope {
-    readonly kind: QuotaPoolScopeKind;
-    readonly identity: string | null;
-    readonly quotaPoolId: string | null;
-    readonly credentialIdentity: SourceMetricsCredentialIdentity;
-}
-export type SourceMetricUnit = {
-    readonly kind: "money";
-    readonly currency: string;
-    readonly precision: number;
-} | {
-    readonly kind: "credits" | "requests" | "tokens";
-    readonly nativeUnit: string;
-} | {
-    readonly kind: "percent";
-    readonly direction: "used" | "remaining";
-};
-export interface SourceMetricsCapability {
-    readonly status: SourceMetricsCapabilityStatus;
-    readonly readerId: string | null;
-    readonly metrics: ReadonlyArray<{
-        readonly kind: SourceMetricKind;
-        readonly scopes: ReadonlyArray<QuotaPoolScopeKind>;
-    }>;
-    readonly nativeEvents: boolean;
-    readonly ttlMs: number;
-    readonly cooldownMs: number;
-}
-export interface SourceMetricWindow {
-    readonly durationMs: number | null;
-    readonly nativePeriod: string | null;
-}
-export interface SourceMetric {
-    readonly metricId: string;
-    readonly kind: SourceMetricKind;
-    readonly scope: QuotaPoolScope;
-    readonly endpointIds: ReadonlyArray<string>;
-    readonly modelIds: ReadonlyArray<string>;
-    readonly nativeLabel: string | null;
-    readonly used: number | null;
-    readonly remaining: number | null;
-    readonly limit: number | null;
-    readonly unit: SourceMetricUnit;
-    readonly unlimited: boolean | null;
-    readonly window: SourceMetricWindow | null;
-    readonly resetsAt: string | null;
-    readonly provenance: SourceMetricProvenance;
-    readonly status: SourceMetricStatus;
-    readonly freshness: SourceMetricFreshness;
-    readonly providerObservedAt: string | null;
-    readonly fetchedAt: string | null;
-    readonly lastAttemptAt: string | null;
-    readonly expiresAt: string | null;
-    readonly retryAt: string | null;
-    readonly errorReason: string | null;
-}
-export interface SourceMetricsSnapshot {
-    readonly environmentId: string;
-    readonly sourceId: string;
-    readonly sourceConfigRevision: number;
-    readonly credentialIdentity: SourceMetricsCredentialIdentity;
-    readonly endpointIds: ReadonlyArray<string>;
-    readonly modelIds: ReadonlyArray<string>;
-    readonly quotaPoolIds: ReadonlyArray<string>;
-    readonly snapshotRevision: number;
-    readonly refreshing: boolean;
-    readonly metrics: ReadonlyArray<SourceMetric>;
-}
-/** 手动刷新完成结果。进行中的合并由宿主返回 `joined-inflight`，插件不假装成功。 */
-export interface SourceMetricsRefreshResult {
-    readonly outcome: SourceMetricsRefreshOutcome;
-    readonly retryAt: string | null;
-}
-/**
- * 宿主 `ExecutionSelection` 的结构子集：迟到刷新按这份选择归属，不能只看 sourceId。
- */
-export interface SourceMetricsSelectionRef {
-    readonly environmentId: string;
-    readonly runtimeId: string;
-    readonly sourceId: string;
-    readonly profileId: string;
-    readonly endpointId?: string | undefined;
-    readonly expectedRevisions: {
-        readonly runtime: number;
-        readonly source: number;
-        readonly profile: number;
-        readonly endpoint?: number | undefined;
-    };
-}
-/**
- * composer 额度区的宿主注入面。数据全部来自这份 props：插件不另建缓存、
- * 不轮询、不调 Usage 插件、不读默认机器账户。`onRefresh` 必须是宿主接上的
- * 真实查询；缺席整份 props，不要塞空回调。
- *
- * 顶层 `credentialIdentity` 在尚未取得凭据或不支持读取时为 null，界面不得
- * 发明身份 id。真 snapshot / metric 仍携带真实 identity。
- * `queryKey` 由宿主按完整选定范围与当前 source/endpoint revisions 生成，
- * 插件只当不透明刷新代次键，不展示、不解析。
- */
-export interface ConversationComposerSourceMetrics {
-    readonly environmentId: string;
-    /**
-     * 观察范围。按**来源**读时是来源 id 与其配置 revision；按**实例**读（手自己的账号，
-     * 不需要来源存在）时是合成的 `instance:<instanceId>` 与 revision 0——插件只当不透明
-     * 的代次键，不解析、不展示。
-     */
-    readonly sourceId: string;
-    readonly sourceConfigRevision: number;
-    /** 按来源读时带着这次选择；按实例读时缺席（不属于任何来源）。 */
-    readonly selection?: SourceMetricsSelectionRef | undefined;
-    readonly queryKey: string;
-    readonly credentialIdentity: SourceMetricsCredentialIdentity | null;
-    readonly sourceLabel: string;
-    readonly capability: SourceMetricsCapability;
-    readonly snapshot: SourceMetricsSnapshot | null;
-    readonly loading: boolean;
-    readonly error: string | null;
-    readonly isNextMessage: boolean;
-    readonly onRefresh: () => Promise<SourceMetricsRefreshResult>;
-}
-/**
- * 按**实例**读到的自管登录额度（`ctx.providers.readInstanceMetrics`）。
- *
- * 与 composer 那份是同一份宿主快照：同一条探针、同一个缓存，插件不自己出网、不自己
- * 读凭据。`supported` 为 false 表示宿主认不得这只手的自管登录（或它被停用、已删除），
- * 此时不该为它出额度行；`reasonCode` 是宿主给的原因码，原样用于区分「没登录」与
- * 「读不到」。`metrics` 的 `nativeLabel` 是**标识**不是文案，界面自己查 catalog。
- */
-export interface PluginInstanceMetrics {
-    readonly instanceId: string;
-    readonly supported: boolean;
-    readonly reasonCode: string | null;
-    readonly metrics: ReadonlyArray<SourceMetric>;
-}
-//# sourceMappingURL=source-metrics.d.ts.map

package/dist/source-metrics.d.ts.map

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

package/dist/source-metrics.js

@@ -1,13 +0,0 @@
-/**
- * `@ycodium-ai/plugin-api/source-metrics` —— 来源动态额度的**窄事实类型**。
- *
- * 本文件只含 `type` / `interface`，没有运行时值。字段是宿主 `SourceMetric` /
- * `SourceMetricsSnapshot` / `SourceMetricsCapability` 的结构子集：宿主模型必须
- * 可赋值到这里，反向不保证。不含格式化规则、缓存、轮询或查询策略。插件不得
- * import contracts / runtime；UI 组件用 `import type`。宿主按本文件构造
- * `ConversationComposerProps.sourceMetrics`。
- *
- * @module @ycodium-ai/plugin-api/source-metrics
- */
-export {};
-//# sourceMappingURL=source-metrics.js.map

package/dist/source-metrics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"source-metrics.js","sourceRoot":"","sources":["../src/source-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}