@fieldwangai/agentflow 0.1.138 → 0.1.141

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -15,8 +15,8 @@
15
15
  href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0,0"
16
16
  rel="stylesheet"
17
17
  />
18
- <script type="module" crossorigin src="/assets/index-YS4XOpXF.js"></script>
19
- <link rel="stylesheet" crossorigin href="/assets/index-COX1zMwq.css">
18
+ <script type="module" crossorigin src="/assets/index-DQzcZp7S.js"></script>
19
+ <link rel="stylesheet" crossorigin href="/assets/index-B6TWUomI.css">
20
20
  </head>
21
21
  <body>
22
22
  <div id="root"></div>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fieldwangai/agentflow",
3
- "version": "0.1.138",
3
+ "version": "0.1.141",
4
4
  "description": "Orchestration system for long-running complex agent tasks using Cursor, OpenCode, Claude Code, or Codex as execution backends",
5
5
  "type": "module",
6
6
  "main": "bin/agentflow.mjs",
@@ -74,6 +74,9 @@ For local Markdown or other content that must become a browser URL, publish it f
74
74
  - Give every action a stable `key`.
75
75
  - Send a stable lowercase `source` on every report and Markdown publish; it is required. Action, idempotency, Artifact, Projection, Extension, Observation, and GlobalState ownership are isolated by source-aware resource keys.
76
76
  - Give every timeline entry stable `kind` and `id` values.
77
+ - Base a timeline `id` and `key` on the scheduled business object itself. Keep platform, team, and
78
+ other filter facets in `dimensions`; if one version/sprint/milestone spans multiple platforms,
79
+ report one entry with a dimension array instead of creating one identity per platform.
77
80
  - Treat `dimensions` as opaque facets; do not hardcode Android, iOS, version, or prd-flow fields into AgentFlow state.
78
81
  - Treat `globalState` as the source of truth owned by the producer; treat projections as replaceable derived views.
79
82
  - Send the complete current source-owned timeline slice whenever changing it. Omitting `projections` means no projection change.
@@ -477,12 +477,12 @@ Authorization: Bearer <AGENTFLOW_TOKEN>
477
477
  {
478
478
  "timeline": [{
479
479
  "kind": "version",
480
- "id": "android:1133202860001000338",
481
- "key": "my-adapter:version:android:1133202860001000338",
482
- "title": "Likee Android 5.63.0",
480
+ "id": "1133202860001000338",
481
+ "key": "my-adapter:version:1133202860001000338",
482
+ "title": "Likee Android&iOS 5.63.0",
483
483
  "date": "2026-08-31",
484
484
  "source": "my-adapter",
485
- "dimensions": { "platform": "android" },
485
+ "dimensions": { "platform": ["android", "ios"] },
486
486
  "order": 0
487
487
  }]
488
488
  }
@@ -499,6 +499,9 @@ Authorization: Bearer <AGENTFLOW_TOKEN>
499
499
  | `dimensions` | 否 | 不透明筛选维度,例如 platform/team |
500
500
  | `order` | 否 | 日期缺失或相同时的稳定顺序 |
501
501
 
502
+ `id` / `key` 标识版本、Sprint 或里程碑本身,不能把平台等筛选维度拼进身份。同一迭代覆盖
503
+ Android 和 iOS 时仍只上报一项,并在 `dimensions.platform` 中使用数组表达多平台。
504
+
502
505
  每个 source 最多上报 100 条合法 timeline 项;超过限制返回错误,不会截断。
503
506
 
504
507
  ### 7.6 extensions:自定义区域
@@ -552,7 +555,7 @@ Authorization: Bearer <AGENTFLOW_TOKEN>
552
555
 
553
556
  ```text
554
557
  implementation-finished:android:runtime-hook:v1
555
- timeline-membership:tapd-1020124:android-version-1133202860001000338:v1
558
+ timeline-membership:tapd-1020124:version-1133202860001000338:v1
556
559
  ```
557
560
 
558
561
  同一 `workflow + source + operation + idempotencyKey` 的重放返回 `alreadyApplied: true`,包括 `running/error/pending` Action。`report` 与 `artifact.publish` 可以安全复用同一业务 key。Publish 会返回第一次创建的预览,不会先生成一个新文件再去重。业务内容发生变化时提高语义版本或使用内容摘要;不要使用请求时间。