@paean-ai/harness-model-pricing 0.1.1-rc.17

package/lib/types/index.d.ts

@@ -0,0 +1,263 @@
+/** DSH function plugin owning editable market prices and a request-usage projection. */
+import type { Context, Volatile } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { PriceSheet } from './types.ts';
+export type * from './types.ts';
+/** Cordis plugin identity. */
+export declare const name = "paean-model-pricing";
+/** Services own configuration delivery and whole-log projection delivery. */
+export declare const inject: string[];
+/** Live price-sheet configuration; edits revalue usage without rewriting history. */
+export interface Config {
+    /** Editable market rates and alias mappings; updates revalue existing usage. */
+    sheet: Volatile<PriceSheet>;
+}
+/** Validated market rates and protocol-specific mappings, served by the standard Settings API. */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    sheet: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        verifiedOn: z<string, string, "defined">;
+        cards: z<({
+            longContext?: ({
+                above?: number | null;
+                rates?: ({
+                    input?: number | null;
+                    output?: number | null;
+                    cacheRead?: number | null;
+                    cacheWrite?: number | null;
+                } & import("@deepseek-ai/cosmokit").Dict) | null;
+            } & import("@deepseek-ai/cosmokit").Dict) | null | undefined;
+            input?: number | null;
+            output?: number | null;
+            cacheRead?: number | null;
+            cacheWrite?: number | null;
+            id?: string | null;
+            name?: string | null;
+            source?: string | null;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<NoInfer<{
+            longContext: z<({
+                above?: number | null;
+                rates?: ({
+                    input?: number | null;
+                    output?: number | null;
+                    cacheRead?: number | null;
+                    cacheWrite?: number | null;
+                } & import("@deepseek-ai/cosmokit").Dict) | null;
+            } & import("@deepseek-ai/cosmokit").Dict) | undefined, Schemastery.ObjectT<NoInfer<{
+                above: z<number, number, "defined">;
+                rates: z<Schemastery.ObjectS<NoInfer<{
+                    input: z<number, number, "defined">;
+                    output: z<number, number, "defined">;
+                    cacheRead: z<number, number, "defined">;
+                    cacheWrite: z<number, number, "defined">;
+                }>>, Schemastery.ObjectT<NoInfer<{
+                    input: z<number, number, "defined">;
+                    output: z<number, number, "defined">;
+                    cacheRead: z<number, number, "defined">;
+                    cacheWrite: z<number, number, "defined">;
+                }>>, "defined">;
+            }>> | undefined, "plain">;
+            input: z<number, number, "defined">;
+            output: z<number, number, "defined">;
+            cacheRead: z<number, number, "defined">;
+            cacheWrite: z<number, number, "defined">;
+            id: z<string, string, "defined">;
+            name: z<string, string, "defined">;
+            source: z<string, string, "defined">;
+        }>>[], "defined">;
+        routes: z<({
+            provider?: string | null;
+            model?: string | null;
+            card?: string | null;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<NoInfer<{
+            provider: z<string, string, "defined">;
+            model: z<string, string, "defined">;
+            card: z<string, string, "defined">;
+        }>>[], "defined">;
+    }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        verifiedOn: z<string, string, "defined">;
+        cards: z<({
+            longContext?: ({
+                above?: number | null;
+                rates?: ({
+                    input?: number | null;
+                    output?: number | null;
+                    cacheRead?: number | null;
+                    cacheWrite?: number | null;
+                } & import("@deepseek-ai/cosmokit").Dict) | null;
+            } & import("@deepseek-ai/cosmokit").Dict) | null | undefined;
+            input?: number | null;
+            output?: number | null;
+            cacheRead?: number | null;
+            cacheWrite?: number | null;
+            id?: string | null;
+            name?: string | null;
+            source?: string | null;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<NoInfer<{
+            longContext: z<({
+                above?: number | null;
+                rates?: ({
+                    input?: number | null;
+                    output?: number | null;
+                    cacheRead?: number | null;
+                    cacheWrite?: number | null;
+                } & import("@deepseek-ai/cosmokit").Dict) | null;
+            } & import("@deepseek-ai/cosmokit").Dict) | undefined, Schemastery.ObjectT<NoInfer<{
+                above: z<number, number, "defined">;
+                rates: z<Schemastery.ObjectS<NoInfer<{
+                    input: z<number, number, "defined">;
+                    output: z<number, number, "defined">;
+                    cacheRead: z<number, number, "defined">;
+                    cacheWrite: z<number, number, "defined">;
+                }>>, Schemastery.ObjectT<NoInfer<{
+                    input: z<number, number, "defined">;
+                    output: z<number, number, "defined">;
+                    cacheRead: z<number, number, "defined">;
+                    cacheWrite: z<number, number, "defined">;
+                }>>, "defined">;
+            }>> | undefined, "plain">;
+            input: z<number, number, "defined">;
+            output: z<number, number, "defined">;
+            cacheRead: z<number, number, "defined">;
+            cacheWrite: z<number, number, "defined">;
+            id: z<string, string, "defined">;
+            name: z<string, string, "defined">;
+            source: z<string, string, "defined">;
+        }>>[], "defined">;
+        routes: z<({
+            provider?: string | null;
+            model?: string | null;
+            card?: string | null;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<NoInfer<{
+            provider: z<string, string, "defined">;
+            model: z<string, string, "defined">;
+            card: z<string, string, "defined">;
+        }>>[], "defined">;
+    }>>>, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    sheet: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        verifiedOn: z<string, string, "defined">;
+        cards: z<({
+            longContext?: ({
+                above?: number | null;
+                rates?: ({
+                    input?: number | null;
+                    output?: number | null;
+                    cacheRead?: number | null;
+                    cacheWrite?: number | null;
+                } & import("@deepseek-ai/cosmokit").Dict) | null;
+            } & import("@deepseek-ai/cosmokit").Dict) | null | undefined;
+            input?: number | null;
+            output?: number | null;
+            cacheRead?: number | null;
+            cacheWrite?: number | null;
+            id?: string | null;
+            name?: string | null;
+            source?: string | null;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<NoInfer<{
+            longContext: z<({
+                above?: number | null;
+                rates?: ({
+                    input?: number | null;
+                    output?: number | null;
+                    cacheRead?: number | null;
+                    cacheWrite?: number | null;
+                } & import("@deepseek-ai/cosmokit").Dict) | null;
+            } & import("@deepseek-ai/cosmokit").Dict) | undefined, Schemastery.ObjectT<NoInfer<{
+                above: z<number, number, "defined">;
+                rates: z<Schemastery.ObjectS<NoInfer<{
+                    input: z<number, number, "defined">;
+                    output: z<number, number, "defined">;
+                    cacheRead: z<number, number, "defined">;
+                    cacheWrite: z<number, number, "defined">;
+                }>>, Schemastery.ObjectT<NoInfer<{
+                    input: z<number, number, "defined">;
+                    output: z<number, number, "defined">;
+                    cacheRead: z<number, number, "defined">;
+                    cacheWrite: z<number, number, "defined">;
+                }>>, "defined">;
+            }>> | undefined, "plain">;
+            input: z<number, number, "defined">;
+            output: z<number, number, "defined">;
+            cacheRead: z<number, number, "defined">;
+            cacheWrite: z<number, number, "defined">;
+            id: z<string, string, "defined">;
+            name: z<string, string, "defined">;
+            source: z<string, string, "defined">;
+        }>>[], "defined">;
+        routes: z<({
+            provider?: string | null;
+            model?: string | null;
+            card?: string | null;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<NoInfer<{
+            provider: z<string, string, "defined">;
+            model: z<string, string, "defined">;
+            card: z<string, string, "defined">;
+        }>>[], "defined">;
+    }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        verifiedOn: z<string, string, "defined">;
+        cards: z<({
+            longContext?: ({
+                above?: number | null;
+                rates?: ({
+                    input?: number | null;
+                    output?: number | null;
+                    cacheRead?: number | null;
+                    cacheWrite?: number | null;
+                } & import("@deepseek-ai/cosmokit").Dict) | null;
+            } & import("@deepseek-ai/cosmokit").Dict) | null | undefined;
+            input?: number | null;
+            output?: number | null;
+            cacheRead?: number | null;
+            cacheWrite?: number | null;
+            id?: string | null;
+            name?: string | null;
+            source?: string | null;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<NoInfer<{
+            longContext: z<({
+                above?: number | null;
+                rates?: ({
+                    input?: number | null;
+                    output?: number | null;
+                    cacheRead?: number | null;
+                    cacheWrite?: number | null;
+                } & import("@deepseek-ai/cosmokit").Dict) | null;
+            } & import("@deepseek-ai/cosmokit").Dict) | undefined, Schemastery.ObjectT<NoInfer<{
+                above: z<number, number, "defined">;
+                rates: z<Schemastery.ObjectS<NoInfer<{
+                    input: z<number, number, "defined">;
+                    output: z<number, number, "defined">;
+                    cacheRead: z<number, number, "defined">;
+                    cacheWrite: z<number, number, "defined">;
+                }>>, Schemastery.ObjectT<NoInfer<{
+                    input: z<number, number, "defined">;
+                    output: z<number, number, "defined">;
+                    cacheRead: z<number, number, "defined">;
+                    cacheWrite: z<number, number, "defined">;
+                }>>, "defined">;
+            }>> | undefined, "plain">;
+            input: z<number, number, "defined">;
+            output: z<number, number, "defined">;
+            cacheRead: z<number, number, "defined">;
+            cacheWrite: z<number, number, "defined">;
+            id: z<string, string, "defined">;
+            name: z<string, string, "defined">;
+            source: z<string, string, "defined">;
+        }>>[], "defined">;
+        routes: z<({
+            provider?: string | null;
+            model?: string | null;
+            card?: string | null;
+        } & import("@deepseek-ai/cosmokit").Dict)[], Schemastery.ObjectT<NoInfer<{
+            provider: z<string, string, "defined">;
+            model: z<string, string, "defined">;
+            card: z<string, string, "defined">;
+        }>>[], "defined">;
+    }>>>, "volatile-defined">;
+}>>, "plain">;
+/**
+ * Register the measured-usage fold and editable settings, both owned by this fiber.
+ * @param ctx - injected projection and Settings services.
+ * @param _config - live price sheet exposed to the browser through Settings.
+ */
+export declare function apply(ctx: Context, _config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/projection.d.ts

@@ -0,0 +1,158 @@
+/** Whole-log usage attribution; prices remain read-side configuration, never durable billing facts. */
+import { z } from 'zod';
+import type { PricedRequest } from './types.ts';
+declare const stateSchema: z.ZodObject<{
+    view: z.ZodObject<{
+        requests: z.ZodArray<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+            purpose: z.ZodEnum<{
+                assistant: "assistant";
+                compaction: "compaction";
+            }>;
+            usage: z.ZodNullable<z.ZodObject<{
+                inputTokens: z.ZodNumber;
+                outputTokens: z.ZodNumber;
+                cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+                cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    route: z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+type State = z.infer<typeof stateSchema>;
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionStateMap {
+        paeanPricingUsage: State;
+    }
+}
+/**
+ * Accept normalized SDK buckets, with omitted zero cache buckets and no reasoning surcharge.
+ * @param value - measured usage from the durable SDK stream.
+ * @returns disjoint buckets, or null for absent, invalid, or inconsistent evidence.
+ */
+export declare function measuredUsage(value: unknown): PricedRequest['usage'];
+/** Compact, whole-log request facts survive paging, compaction and price-sheet updates. */
+export declare const pricingUsageProjection: {
+    key: "paeanPricingUsage";
+    stateVersion: number;
+    stateSchema: z.ZodObject<{
+        view: z.ZodObject<{
+            requests: z.ZodArray<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                purpose: z.ZodEnum<{
+                    assistant: "assistant";
+                    compaction: "compaction";
+                }>;
+                usage: z.ZodNullable<z.ZodObject<{
+                    inputTokens: z.ZodNumber;
+                    outputTokens: z.ZodNumber;
+                    cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+                    cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        route: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strict>;
+    init: () => {
+        view: {
+            requests: never[];
+        };
+        route: null;
+    };
+    apply: (state: NoInfer<{
+        view: {
+            requests: {
+                provider: string;
+                model: string;
+                purpose: "assistant" | "compaction";
+                usage: {
+                    inputTokens: number;
+                    outputTokens: number;
+                    cacheReadTokens: number;
+                    cacheWriteTokens: number;
+                } | null;
+            }[];
+        };
+        route: {
+            provider: string;
+            model: string;
+        } | null;
+    }>, event: import("@deepseek-ai/dsh-session").SessionEvent) => {
+        view: {
+            requests: {
+                provider: string;
+                model: string;
+                purpose: "assistant" | "compaction";
+                usage: {
+                    inputTokens: number;
+                    outputTokens: number;
+                    cacheReadTokens: number;
+                    cacheWriteTokens: number;
+                } | null;
+            }[];
+        };
+        route: {
+            provider: string;
+            model: string;
+        } | null;
+    };
+    wire: {
+        viewSchema: z.ZodObject<{
+            requests: z.ZodArray<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                purpose: z.ZodEnum<{
+                    assistant: "assistant";
+                    compaction: "compaction";
+                }>;
+                usage: z.ZodNullable<z.ZodObject<{
+                    inputTokens: z.ZodNumber;
+                    outputTokens: z.ZodNumber;
+                    cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+                    cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        view: (state: NoInfer<{
+            view: {
+                requests: {
+                    provider: string;
+                    model: string;
+                    purpose: "assistant" | "compaction";
+                    usage: {
+                        inputTokens: number;
+                        outputTokens: number;
+                        cacheReadTokens: number;
+                        cacheWriteTokens: number;
+                    } | null;
+                }[];
+            };
+            route: {
+                provider: string;
+                model: string;
+            } | null;
+        }>) => {
+            requests: {
+                provider: string;
+                model: string;
+                purpose: "assistant" | "compaction";
+                usage: {
+                    inputTokens: number;
+                    outputTokens: number;
+                    cacheReadTokens: number;
+                    cacheWriteTokens: number;
+                } | null;
+            }[];
+        };
+    };
+};
+export {};
+//# sourceMappingURL=projection.d.ts.map

package/lib/types/types.d.ts

@@ -0,0 +1,69 @@
+/** Public, browser-safe contracts for market-price estimates. */
+/** USD per million tokens; all four token buckets are disjoint. */
+export interface Rates {
+    /** Uncached input price in USD per million tokens. */
+    input: number;
+    /** Output price in USD per million tokens, including reasoning tokens. */
+    output: number;
+    /** Cache-read price in USD per million tokens. */
+    cacheRead: number;
+    /** Cache-write price in USD per million tokens. */
+    cacheWrite: number;
+}
+/** One public tariff and its source; long-context rates apply to the entire request. */
+export interface PriceCard extends Rates {
+    /** Unique tariff identity referenced by route mappings. */
+    id: string;
+    /** Upstream model name displayed in the price list. */
+    name: string;
+    /** HTTPS URL of the public pricing source. */
+    source: string;
+    /** Optional higher rates for requests exceeding the prompt-token threshold. */
+    longContext?: {
+        /** Exclusive threshold counting uncached input, cache reads and cache writes. */
+        above: number;
+        /** Rates applied to every token bucket of a request above the threshold. */
+        rates: Rates;
+    };
+}
+/** An explicit protocol/provider alias mapped to its estimated upstream tariff. */
+export interface PriceRoute {
+    /** Recorded provider identity, distinguishing the two protocol providers. */
+    provider: string;
+    /** Recorded model alias selected in Harness. */
+    model: string;
+    /** Identity of the price card used for this alias. */
+    card: string;
+}
+/** Editable price-sheet data, independent of account permissions and model routing. */
+export interface PriceSheet {
+    /** Date when these public rates were verified, in YYYY-MM-DD form. */
+    verifiedOn: string;
+    /** Public model tariffs available to route mappings. */
+    cards: PriceCard[];
+    /** Explicit provider and model mappings, shared by all accounts for estimation. */
+    routes: PriceRoute[];
+}
+/** Provider-reported usage of one settled request; null denotes unavailable usage. */
+export interface PricedRequest {
+    provider: string;
+    model: string;
+    purpose: 'assistant' | 'compaction';
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+    } | null;
+}
+/** Whole-log request facts; no monetary value is persisted in session history. */
+export interface PricingUsage {
+    requests: PricedRequest[];
+}
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionMap {
+        /** Request-attributed measured usage for the independent price presentation. */
+        paeanPricingUsage: PricingUsage;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Model price estimates",
+    "description": "Public market prices and measured session cost estimates."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "模型价格估算",
+    "description": "按公开市场价格及模型报告的用量估算本会话成本。"
+  }
+}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@paean-ai/harness-model-pricing",
+  "description": "Editable market-price estimates for protocol-specific Praxis models and measured session usage",
+  "version": "0.1.1-rc.17",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a8e-ai/paean-harness.git",
+    "directory": "packages/paean/paean-model-pricing"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.4"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.2",
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-client-ui-chat": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-theme": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm-retry": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-compaction": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
+    "@deepseek-ai/cordis-plugin-include": "~1.0.9",
+    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-config-editor": "0.2.0-rc.2"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "locale/*.json"
+  ],
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@deepseek-ai/schemastery": "~3.18.4"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}