diff --git a/.changeset/usage-summary.md b/.changeset/usage-summary.md deleted file mode 100644 index 97c57ada..00000000 --- a/.changeset/usage-summary.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -"@openagentpack/sdk": minor ---- - -**BREAKING**:用量查询公开面合并为 `getUsageSummary`,按百炼官方 Usage API(`POST /api/v1/agentstudio/usage/summary`)的 `dimension` 契约一次返回 `total + models + tools`。 - -- 移除 `listModelUsage` / `listToolUsage` 及 `ModelUsagePage`、`ModelUsageRequest`、`ModelUsageItem`、`ToolUsagePage`、`ToolUsageRequest`、`ToolUsageItem`、`UsageScope`、`UsagePage`、`UsageTokenStats` 等类型 -- 新增 `getUsageSummary(ctx, request, options)` 与 `UsageSummaryRequest`、`UsageSummaryResponse`、`UsageSummary`、`UsageMetric`、`UsageTotal`、`UsageModelRow`、`UsageToolRow`、`UsageDimension`、`UsageGranularity` -- 请求变化:`scope{type,...}` → `dimension` 判别联合;毫秒 `time_range` → 带时区偏移的 RFC 3339 字符串;分页与 `model_name`/`source`/`tool_name` 服务端筛选移除(明细随汇总一次返回) -- 响应变化:指标统一为 `{ value, unit }`,未知指标 `value: null`、已知零值 `0`;无统计记录时 `data_updated_at: null` diff --git a/.changeset/usage-trend.md b/.changeset/usage-trend.md deleted file mode 100644 index 54a95210..00000000 --- a/.changeset/usage-trend.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -"@openagentpack/sdk": minor ---- - -用量查询补齐百炼官方 Usage API 的 trend 端点,并收紧 summary 契约: - -- 新增 `getUsageTrend(ctx, request, options)`(`POST /api/v1/agentstudio/usage/trend`)与 `UsageTrendRequest`、`UsageTrend`、`UsageTrendPoint`、`UsageTrendResponse`、`UsageTrendDimension`;支持 workspace/agent 维度、`hour/day/month` 分桶、`page_size`(1..100)与 `page_token` 游标分页,`has_more` / `next_page_token` 原样透传,缺数据的桶不补零 -- 抽出 `UsageBreakdown`(`total/models/tools`),summary 与 trend 共用 -- `UsageSummary.query_range` 改为可选:`session` 维度复用会话自身窗口,响应可能没有该字段 -- 请求校验对齐文档:`time_range` 只接受秒级、带偏移的 RFC 3339(拒绝小数秒与无偏移时间);`agent_id` / `session_id` / `agent_version` 不接受空白串;`granularity` 显式传 `null` 被拒绝;trend 的 `page_size` / `page_token` 非法值在发请求前拒绝 diff --git a/apps/server/CHANGELOG.md b/apps/server/CHANGELOG.md index 7bffce85..8a0fdc59 100644 --- a/apps/server/CHANGELOG.md +++ b/apps/server/CHANGELOG.md @@ -1,5 +1,13 @@ # @openagentpack/server +## 0.0.17 + +### Patch Changes + +- Updated dependencies [4e0ae74] +- Updated dependencies [4e0ae74] + - @openagentpack/sdk@0.11.0 + ## 0.0.16 ### Patch Changes diff --git a/apps/server/package.json b/apps/server/package.json index 8f3a138d..432ef1d6 100644 --- a/apps/server/package.json +++ b/apps/server/package.json @@ -1,6 +1,6 @@ { "name": "@openagentpack/server", - "version": "0.0.16", + "version": "0.0.17", "private": true, "license": "Apache-2.0", "exports": { diff --git a/bun.lock b/bun.lock index f9adc27d..2e4250c2 100644 --- a/bun.lock +++ b/bun.lock @@ -18,7 +18,7 @@ }, "apps/server": { "name": "@openagentpack/server", - "version": "0.0.16", + "version": "0.0.17", "dependencies": { "@hono/zod-openapi": "^1.4.0", "@openagentpack/sdk": "workspace:*", @@ -68,7 +68,7 @@ }, "packages/cli": { "name": "@openagentpack/cli", - "version": "0.10.0", + "version": "0.11.0", "bin": { "agents": "dist/bin/agents.js", }, @@ -95,7 +95,7 @@ }, "packages/playground": { "name": "@openagentpack/playground", - "version": "0.10.0", + "version": "0.11.0", "bin": { "agents-playground": "dist/bin/playground.js", }, @@ -118,7 +118,7 @@ }, "packages/sdk": { "name": "@openagentpack/sdk", - "version": "0.10.0", + "version": "0.11.0", "dependencies": { "jszip": "^3.10.1", "yaml": "^2.9.0", diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md index fb3ef813..6a799f22 100644 --- a/packages/cli/CHANGELOG.md +++ b/packages/cli/CHANGELOG.md @@ -1,5 +1,13 @@ # @openagentpack/cli +## 0.11.0 + +### Patch Changes + +- Updated dependencies [4e0ae74] +- Updated dependencies [4e0ae74] + - @openagentpack/sdk@0.11.0 + ## 0.10.0 ### Patch Changes diff --git a/packages/cli/package.json b/packages/cli/package.json index 41d12b34..1e9cf16b 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "@openagentpack/cli", - "version": "0.10.0", + "version": "0.11.0", "description": "Open Agent Pack — Declaratively manage AI agent infrastructure", "license": "Apache-2.0", "keywords": [ diff --git a/packages/playground/CHANGELOG.md b/packages/playground/CHANGELOG.md index 6daa7e52..6bb74c83 100644 --- a/packages/playground/CHANGELOG.md +++ b/packages/playground/CHANGELOG.md @@ -1,5 +1,13 @@ # @openagentpack/playground +## 0.11.0 + +### Patch Changes + +- Updated dependencies [4e0ae74] +- Updated dependencies [4e0ae74] + - @openagentpack/sdk@0.11.0 + ## 0.10.0 ### Patch Changes diff --git a/packages/playground/package.json b/packages/playground/package.json index 1377d1b3..9794ea83 100644 --- a/packages/playground/package.json +++ b/packages/playground/package.json @@ -1,6 +1,6 @@ { "name": "@openagentpack/playground", - "version": "0.10.0", + "version": "0.11.0", "description": "OpenAgentPack Playground — one-command local web UI for OpenAgentPack", "license": "Apache-2.0", "keywords": [ diff --git a/packages/sdk/CHANGELOG.md b/packages/sdk/CHANGELOG.md index 97cfaede..86a5cfc2 100644 --- a/packages/sdk/CHANGELOG.md +++ b/packages/sdk/CHANGELOG.md @@ -1,5 +1,23 @@ # @openagentpack/sdk +## 0.11.0 + +### Minor Changes + +- 4e0ae74: **BREAKING**:用量查询公开面合并为 `getUsageSummary`,按百炼官方 Usage API(`POST /api/v1/agentstudio/usage/summary`)的 `dimension` 契约一次返回 `total + models + tools`。 + + - 移除 `listModelUsage` / `listToolUsage` 及 `ModelUsagePage`、`ModelUsageRequest`、`ModelUsageItem`、`ToolUsagePage`、`ToolUsageRequest`、`ToolUsageItem`、`UsageScope`、`UsagePage`、`UsageTokenStats` 等类型 + - 新增 `getUsageSummary(ctx, request, options)` 与 `UsageSummaryRequest`、`UsageSummaryResponse`、`UsageSummary`、`UsageMetric`、`UsageTotal`、`UsageModelRow`、`UsageToolRow`、`UsageDimension`、`UsageGranularity` + - 请求变化:`scope{type,...}` → `dimension` 判别联合;毫秒 `time_range` → 带时区偏移的 RFC 3339 字符串;分页与 `model_name`/`source`/`tool_name` 服务端筛选移除(明细随汇总一次返回) + - 响应变化:指标统一为 `{ value, unit }`,未知指标 `value: null`、已知零值 `0`;无统计记录时 `data_updated_at: null` + +- 4e0ae74: 用量查询补齐百炼官方 Usage API 的 trend 端点,并收紧 summary 契约: + + - 新增 `getUsageTrend(ctx, request, options)`(`POST /api/v1/agentstudio/usage/trend`)与 `UsageTrendRequest`、`UsageTrend`、`UsageTrendPoint`、`UsageTrendResponse`、`UsageTrendDimension`;支持 workspace/agent 维度、`hour/day/month` 分桶、`page_size`(1..100)与 `page_token` 游标分页,`has_more` / `next_page_token` 原样透传,缺数据的桶不补零 + - 抽出 `UsageBreakdown`(`total/models/tools`),summary 与 trend 共用 + - `UsageSummary.query_range` 改为可选:`session` 维度复用会话自身窗口,响应可能没有该字段 + - 请求校验对齐文档:`time_range` 只接受秒级、带偏移的 RFC 3339(拒绝小数秒与无偏移时间);`agent_id` / `session_id` / `agent_version` 不接受空白串;`granularity` 显式传 `null` 被拒绝;trend 的 `page_size` / `page_token` 非法值在发请求前拒绝 + ## 0.10.0 ### Minor Changes diff --git a/packages/sdk/package.json b/packages/sdk/package.json index c7015b23..0af3153f 100644 --- a/packages/sdk/package.json +++ b/packages/sdk/package.json @@ -1,6 +1,6 @@ { "name": "@openagentpack/sdk", - "version": "0.10.0", + "version": "0.11.0", "description": "OpenAgentPack SDK (Node-compatible runtime)", "license": "Apache-2.0", "keywords": [