@atom-workflow-agent/select-atom 1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,63 @@
+# `@atom-workflow-agent/select-atom`
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+Built-in selectors for one job: choosing a statically declared branch of a Workflow `DecisionNode`.
+
+## Which Atom to use
+
+| Atom | Use when | May suspend |
+| --- | --- | --- |
+| `select.rule@1.0.0` | structured facts can be evaluated by ordered rules, optionally falling back to a user choice | for `manual`, or ambiguous/no-match `auto_then_user` |
+| `select.host-model@1.0.0` | the current Codex/Trae conversation must use project or conversational context to decide | always, as a HostTask |
+
+Both return an auditable `branch`, `source`, `reason`, `matchedRuleIds`, and `factsHash`. They never return a target node ID. The compiler verifies that every possible branch is declared by the surrounding Decision node.
+
+## Rule selector
+
+Modes:
+
+- `automatic`: first matching rule, then `fallbackBranch`; otherwise fail;
+- `manual`: always ask the user;
+- `auto_then_user`: select automatically only when exactly one rule matches; otherwise ask the user.
+
+Rules are evaluated in order. A rule uses `all` or `any` across conditions. Supported operators are `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `not_in`, `contains`, and `exists`; `path` accepts JSON Pointer or dot notation.
+
+Example Decision Atom input:
+
+```json
+{
+  "mode": "automatic",
+  "facts": { "metrics": { "lcpMs": 3200 } },
+  "rules": [
+    {
+      "id": "slow-lcp",
+      "branch": "optimize",
+      "match": "all",
+      "conditions": [
+        { "path": "/metrics/lcpMs", "operator": "gt", "value": 2500 }
+      ],
+      "reason": "LCP exceeds the 2.5 s target"
+    }
+  ],
+  "fallbackBranch": "finish"
+}
+```
+
+The surrounding Decision node must declare exactly the `optimize` and `finish` branch IDs used here.
+
+## Host selector
+
+Provide a bounded `question`, structured `facts`, and optional `guidance`. Runtime creates a HostTask for the current conversation and validates the returned branch against the frozen Decision node. Use it for contextual judgment—not for modifying code, running tests, deploying, or performing the selected branch's work.
+
+## Author API
+
+- `defineSelectorAtom` creates a rule/user selector with a custom ID and Signal expiry.
+- `defineHostSelectorAtom` creates a Host-model selector with a custom ID and HostTask expiry.
+
+```bash
+pnpm --filter @atom-workflow-agent/select-atom typecheck
+pnpm --filter @atom-workflow-agent/select-atom test
+```
+
+See [Workflow control structures](../../docs/workflow-authoring.md#control-structures).

package/README.zh-CN.md

@@ -0,0 +1,63 @@
+# `@atom-workflow-agent/select-atom`
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+内置选择器只负责一件事：为 Workflow `DecisionNode` 选择一个静态声明的分支。
+
+## 如何选择 Atom
+
+| Atom | 适用场景 | 是否可能暂停 |
+| --- | --- | --- |
+| `select.rule@1.0.0` | 可以通过有序规则判断结构化事实，并可在必要时让用户选择 | `manual`，或 `auto_then_user` 无匹配/多匹配时 |
+| `select.host-model@1.0.0` | 当前 Codex/Trae 对话需要结合项目或会话上下文判断 | 始终以 HostTask 暂停 |
+
+两者都会返回可审计的 `branch`、`source`、`reason`、`matchedRuleIds` 和 `factsHash`，不会返回目标节点 ID。Compiler 会验证所有可能分支都已由外层 Decision 节点声明。
+
+## 规则选择器
+
+模式：
+
+- `automatic`：选择第一条命中规则，其次使用 `fallbackBranch`，否则失败；
+- `manual`：始终询问用户；
+- `auto_then_user`：仅在恰好一条规则命中时自动选择，否则询问用户。
+
+规则按顺序求值，一条规则可以用 `all` 或 `any` 组合条件。支持 `eq`、`ne`、`gt`、`gte`、`lt`、`lte`、`in`、`not_in`、`contains`、`exists`；`path` 支持 JSON Pointer 或点路径。
+
+Decision Atom 输入示例：
+
+```json
+{
+  "mode": "automatic",
+  "facts": { "metrics": { "lcpMs": 3200 } },
+  "rules": [
+    {
+      "id": "slow-lcp",
+      "branch": "optimize",
+      "match": "all",
+      "conditions": [
+        { "path": "/metrics/lcpMs", "operator": "gt", "value": 2500 }
+      ],
+      "reason": "LCP 超过 2.5 秒目标"
+    }
+  ],
+  "fallbackBranch": "finish"
+}
+```
+
+外层 Decision 节点必须准确声明这里使用的 `optimize` 和 `finish` 分支 ID。
+
+## Host 选择器
+
+传入边界清晰的 `question`、结构化 `facts` 和可选 `guidance`。Runtime 会为当前对话创建 HostTask，并根据冻结 Decision 节点校验返回分支。它适合上下文判断，不负责修改代码、运行测试、部署或执行所选分支的业务动作。
+
+## 作者 API
+
+- `defineSelectorAtom`：使用自定义 ID 和 Signal 过期时间创建规则/用户选择器；
+- `defineHostSelectorAtom`：使用自定义 ID 和 HostTask 过期时间创建 Host 模型选择器。
+
+```bash
+pnpm --filter @atom-workflow-agent/select-atom typecheck
+pnpm --filter @atom-workflow-agent/select-atom test
+```
+
+参见 [Workflow 控制结构](../../docs/workflow-authoring.zh-CN.md#控制结构)。

package/dist/host-selector-atom.d.ts

@@ -0,0 +1,4 @@
+import { type AtomDefinition } from "@atom-workflow-agent/atom-sdk";
+import type { HostSelectorAtomDefinition, HostSelectorInput, SelectorDecision } from "./types.js";
+export declare function defineHostSelectorAtom(definition: HostSelectorAtomDefinition): AtomDefinition<HostSelectorInput, SelectorDecision>;
+//# sourceMappingURL=host-selector-atom.d.ts.map

package/dist/host-selector-atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-selector-atom.d.ts","sourceRoot":"","sources":["../src/host-selector-atom.ts"],"names":[],"mappings":"AACA,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpG,OAAO,KAAK,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIlG,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,0BAA0B,GAAG,cAAc,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAuClI"}

package/dist/host-selector-atom.js

@@ -0,0 +1,50 @@
+import { AtomExecutionError, defineAtom } from "@atom-workflow-agent/atom-sdk";
+import { hashSelectorFacts } from "./rule-evaluator.js";
+import { HOST_SELECTOR_INPUT_SCHEMA, selectorOutputSchema } from "./schemas.js";
+export function defineHostSelectorAtom(definition) {
+    const expiresInMs = definition.hostExpiresInMs ?? 86_400_000;
+    if (!Number.isInteger(expiresInMs) || expiresInMs <= 0 || expiresInMs > 31_536_000_000)
+        throw new TypeError("Host Selector Atom hostExpiresInMs must be a positive integer no greater than 31536000000");
+    return defineAtom({
+        id: definition.id,
+        ...(definition.version ? { version: definition.version } : {}),
+        title: definition.title ?? "DecisionNode current Host Model branch selector",
+        description: definition.description ?? "DecisionNode-only Atom that pauses for the current native Codex or Trae conversation to choose one statically declared branch using project and conversation context.",
+        input: HOST_SELECTOR_INPUT_SCHEMA,
+        output: selectorOutputSchema(["host"]),
+        reliability: { idempotent: true, timeoutMs: 5_000 },
+        execute(input, context) {
+            const branches = context.decision?.branches;
+            if (!branches?.length)
+                throw new AtomExecutionError("HOST_SELECT_DECISION_CONTEXT_REQUIRED", "select.host-model must run as a DecisionNode");
+            const factsHash = hashSelectorFacts(input.facts);
+            return context.waitForHost({
+                instruction: [
+                    `需要判断：${input.question}`,
+                    `只允许选择以下 branch 之一：${branches.join("、")}。`,
+                    input.guidance ? `补充判断要求：${input.guidance}` : "",
+                    "必要时可继续与用户交流或使用当前项目工具。完成后返回结构化结果：branch、source='host'、reason、matchedRuleIds=[]、factsHash。",
+                ].filter(Boolean).join("\n"),
+                context: { question: input.question, facts: input.facts, allowedBranches: [...branches], factsHash, ...(input.guidance ? { guidance: input.guidance } : {}) },
+                checkpoint: { factsHash },
+                expiresInMs,
+                metadata: { selector: definition.id, allowedBranches: [...branches] },
+            });
+        },
+        resume(input, resumed, context) {
+            if (resumed.type !== "host")
+                throw new AtomExecutionError("HOST_SELECT_RESUME_REQUIRED", "Host selector requires a HostTask result");
+            const checkpoint = resumed.checkpoint;
+            if (hashSelectorFacts(input.facts) !== checkpoint.factsHash)
+                throw new AtomExecutionError("HOST_SELECT_FACTS_CHANGED", "Host selector facts changed while awaiting the Host Model");
+            const decision = resumed.value;
+            const branches = context.decision?.branches;
+            if (!branches?.includes(decision.branch))
+                throw new AtomExecutionError("HOST_SELECT_BRANCH_UNDECLARED", `Host selected an undeclared branch: ${decision.branch}`);
+            if (decision.source !== "host" || decision.matchedRuleIds.length !== 0 || decision.factsHash !== checkpoint.factsHash)
+                throw new AtomExecutionError("HOST_SELECT_OUTPUT_INVALID", "Host selector returned an invalid auditable decision");
+            return decision;
+        },
+    });
+}
+//# sourceMappingURL=host-selector-atom.js.map

package/dist/host-selector-atom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-selector-atom.js","sourceRoot":"","sources":["../src/host-selector-atom.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAuB,MAAM,+BAA+B,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKhF,MAAM,UAAU,sBAAsB,CAAC,UAAsC;IAC3E,MAAM,WAAW,GAAG,UAAU,CAAC,eAAe,IAAI,UAAU,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,cAAc;QAAE,MAAM,IAAI,SAAS,CAAC,2FAA2F,CAAC,CAAC;IACzM,OAAO,UAAU,CAAsC;QACrD,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,iDAAiD;QAC5E,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,uKAAuK;QAC9M,KAAK,EAAE,0BAA0B;QACjC,MAAM,EAAE,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;QACtC,WAAW,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;QACnD,OAAO,CAAC,KAAK,EAAE,OAAO;YACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC;YAC5C,IAAI,CAAC,QAAQ,EAAE,MAAM;gBAAE,MAAM,IAAI,kBAAkB,CAAC,uCAAuC,EAAE,8CAA8C,CAAC,CAAC;YAC7I,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjD,OAAO,OAAO,CAAC,WAAW,CAAC;gBACzB,WAAW,EAAE;oBACX,QAAQ,KAAK,CAAC,QAAQ,EAAE;oBACxB,qBAAqB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;oBAC1C,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;oBAChD,0FAA0F;iBAC3F,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC5B,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;gBAC7J,UAAU,EAAE,EAAE,SAAS,EAAmC;gBAC1D,WAAW;gBACX,QAAQ,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,eAAe,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE;aACtE,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO;YAC5B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;gBAAE,MAAM,IAAI,kBAAkB,CAAC,6BAA6B,EAAE,0CAA0C,CAAC,CAAC;YACrI,MAAM,UAAU,GAAG,OAAO,CAAC,UAAoC,CAAC;YAChE,IAAI,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC,SAAS;gBAAE,MAAM,IAAI,kBAAkB,CAAC,2BAA2B,EAAE,2DAA2D,CAAC,CAAC;YACpL,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAiC,CAAC;YAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC;YAC5C,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,kBAAkB,CAAC,+BAA+B,EAAE,uCAAuC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAClK,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,SAAS,KAAK,UAAU,CAAC,SAAS;gBAAE,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,EAAE,sDAAsD,CAAC,CAAC;YAC1O,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { defineHostSelectorAtom } from "./host-selector-atom.js";
+export { defineSelectorAtom } from "./selector-atom.js";
+export type { HostSelectorAtomDefinition, HostSelectorInput, SelectCondition, SelectionSource, SelectorAtomDefinition, SelectorDecision, SelectorInput, SelectMode, SelectOperator, SelectRule, } from "./types.js";
+export declare const atomPackage: import("@atom-workflow-agent/atom-sdk").AtomPackage;
+export default atomPackage;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,0BAA0B,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAC/E,sBAAsB,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,GAChG,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,WAAW,qDAOtB,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+import { defineAtomPackage } from "@atom-workflow-agent/atom-sdk";
+import { defineHostSelectorAtom } from "./host-selector-atom.js";
+import { defineSelectorAtom } from "./selector-atom.js";
+export { defineHostSelectorAtom } from "./host-selector-atom.js";
+export { defineSelectorAtom } from "./selector-atom.js";
+export const atomPackage = defineAtomPackage({
+    id: "atomworkflow.select-atoms",
+    version: "1.0.0",
+    name: "Generic Workflow Select Atoms",
+    description: "DecisionNode selectors for deterministic/user and current Host Model decisions.",
+    metadata: { generic: true, usesSignal: true, usesHostHandoff: true, dynamicTargetNodeForbidden: true },
+    atoms: [defineSelectorAtom({ id: "select.rule" }), defineHostSelectorAtom({ id: "select.host-model" })],
+});
+export default atomPackage;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMxD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;IAC3C,EAAE,EAAE,2BAA2B;IAC/B,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,iFAAiF;IAC9F,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE;IACtG,KAAK,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,sBAAsB,CAAC,EAAE,EAAE,EAAE,mBAAmB,EAAE,CAAC,CAAC;CACxG,CAAC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/rule-evaluator.d.ts

@@ -0,0 +1,6 @@
+import type { JsonValue } from "@atom-workflow-agent/contracts";
+import type { SelectCondition, SelectRule } from "./types.js";
+export declare function hashSelectorFacts(facts: JsonValue): string;
+export declare function evaluateCondition(facts: JsonValue, condition: SelectCondition): boolean;
+export declare function matchingRules<TBranch extends string>(facts: JsonValue, rules: readonly SelectRule<TBranch>[], branches: ReadonlySet<string>): readonly SelectRule<TBranch>[];
+//# sourceMappingURL=rule-evaluator.d.ts.map

package/dist/rule-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-evaluator.d.ts","sourceRoot":"","sources":["../src/rule-evaluator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAuB9D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAG1D;AA2GD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAGvF;AAED,wBAAgB,aAAa,CAAC,OAAO,SAAS,MAAM,EAClD,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,EACrC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,CAqBhC"}

package/dist/rule-evaluator.js

@@ -0,0 +1,131 @@
+import { createHash } from "node:crypto";
+import { AtomExecutionError } from "@atom-workflow-agent/atom-sdk";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (isRecord(value)) {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => [key, canonicalize(nested)]));
+    }
+    return value;
+}
+export function hashSelectorFacts(facts) {
+    const serialized = JSON.stringify(canonicalize(facts));
+    return `sha256:${createHash("sha256").update(serialized).digest("hex")}`;
+}
+function pointerSegments(path) {
+    if (path === "" || path === "$")
+        return [];
+    if (path.startsWith("/")) {
+        return path.slice(1).split("/").map((segment) => segment.replaceAll("~1", "/").replaceAll("~0", "~"));
+    }
+    const normalized = path.startsWith("$.") ? path.slice(2) : path;
+    return normalized === "" ? [] : normalized.split(".");
+}
+function resolveFact(facts, path) {
+    let current = facts;
+    for (const segment of pointerSegments(path)) {
+        if (Array.isArray(current)) {
+            if (!/^\d+$/.test(segment))
+                return { exists: false };
+            const index = Number(segment);
+            if (index >= current.length)
+                return { exists: false };
+            current = current[index];
+            continue;
+        }
+        if (!isRecord(current) || !Object.prototype.hasOwnProperty.call(current, segment)) {
+            return { exists: false };
+        }
+        current = current[segment];
+    }
+    return { exists: true, value: current };
+}
+function equalJson(left, right) {
+    return JSON.stringify(canonicalize(left)) === JSON.stringify(canonicalize(right));
+}
+function requiredValue(condition) {
+    if (condition.value === undefined) {
+        throw new AtomExecutionError("SELECT_CONDITION_VALUE_REQUIRED", `Selector operator '${condition.operator}' requires a value`, { details: { path: condition.path, operator: condition.operator } });
+    }
+    return condition.value;
+}
+function compareOrdered(actual, expected, operator) {
+    if (typeof actual !== "number" || typeof expected !== "number") {
+        throw new AtomExecutionError("SELECT_CONDITION_TYPE_INVALID", `Selector operator '${operator}' requires numeric facts and values`, { details: { operator, actual, expected } });
+    }
+    if (operator === "gt")
+        return actual > expected;
+    if (operator === "gte")
+        return actual >= expected;
+    if (operator === "lt")
+        return actual < expected;
+    return actual <= expected;
+}
+function evaluateRaw(condition, resolved) {
+    if (condition.operator === "exists") {
+        if (condition.value !== undefined) {
+            throw new AtomExecutionError("SELECT_CONDITION_VALUE_FORBIDDEN", "Selector operator 'exists' does not accept a value; use negate for a missing check", { details: { path: condition.path } });
+        }
+        return resolved.exists;
+    }
+    if (!resolved.exists)
+        return false;
+    const actual = resolved.value;
+    const expected = requiredValue(condition);
+    switch (condition.operator) {
+        case "eq": return equalJson(actual, expected);
+        case "ne": return !equalJson(actual, expected);
+        case "gt":
+        case "gte":
+        case "lt":
+        case "lte": return compareOrdered(actual, expected, condition.operator);
+        case "in":
+        case "not_in": {
+            if (!Array.isArray(expected)) {
+                throw new AtomExecutionError("SELECT_CONDITION_TYPE_INVALID", `Selector operator '${condition.operator}' requires an array value`, { details: { path: condition.path, operator: condition.operator } });
+            }
+            const included = expected.some((candidate) => equalJson(actual, candidate));
+            return condition.operator === "in" ? included : !included;
+        }
+        case "contains": {
+            if (Array.isArray(actual))
+                return actual.some((candidate) => equalJson(candidate, expected));
+            if (typeof actual === "string" && typeof expected === "string")
+                return actual.includes(expected);
+            throw new AtomExecutionError("SELECT_CONDITION_TYPE_INVALID", "Selector operator 'contains' requires an array, or string facts and value", { details: { path: condition.path } });
+        }
+        default: {
+            const exhaustive = condition.operator;
+            throw new AtomExecutionError("SELECT_OPERATOR_UNSUPPORTED", `Unsupported selector operator: ${String(exhaustive)}`);
+        }
+    }
+}
+export function evaluateCondition(facts, condition) {
+    const matched = evaluateRaw(condition, resolveFact(facts, condition.path));
+    return condition.negate === true ? !matched : matched;
+}
+export function matchingRules(facts, rules, branches) {
+    const ids = new Set();
+    for (const rule of rules) {
+        if (ids.has(rule.id)) {
+            throw new AtomExecutionError("SELECT_RULE_ID_DUPLICATE", `Selector rule id is duplicated: ${rule.id}`);
+        }
+        ids.add(rule.id);
+        if (!branches.has(rule.branch)) {
+            throw new AtomExecutionError("SELECT_BRANCH_UNDECLARED", `Selector rule '${rule.id}' uses an undeclared branch: ${rule.branch}`);
+        }
+        if (rule.conditions.length === 0) {
+            throw new AtomExecutionError("SELECT_RULE_EMPTY", `Selector rule '${rule.id}' must contain at least one condition`);
+        }
+    }
+    return rules.filter((rule) => {
+        const matches = rule.conditions.map((condition) => evaluateCondition(facts, condition));
+        return rule.match === "all" ? matches.every(Boolean) : matches.some(Boolean);
+    });
+}
+//# sourceMappingURL=rule-evaluator.js.map

package/dist/rule-evaluator.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,7 @@
+import type { JsonSchema } from "@atom-workflow-agent/contracts";
+export declare function selectorInputSchema(): JsonSchema;
+export declare const HOST_SELECTOR_INPUT_SCHEMA: JsonSchema;
+export declare function selectorOutputSchema(sources: readonly ("automatic" | "user" | "host")[]): JsonSchema;
+export declare function selectorCheckpointSchema(): JsonSchema;
+export declare function hostSelectorCheckpointSchema(): JsonSchema;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjE,wBAAgB,mBAAmB,IAAI,UAAU,CAkDhD;AAED,eAAO,MAAM,0BAA0B,EAAE,UAUxC,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,GAClD,UAAU,CAcZ;AAED,wBAAgB,wBAAwB,IAAI,UAAU,CAWrD;AAED,wBAAgB,4BAA4B,IAAI,UAAU,CAUzD"}

package/dist/schemas.js

@@ -0,0 +1,101 @@
+export function selectorInputSchema() {
+    return {
+        type: "object",
+        description: "Input for select.rule. This Atom only chooses one branch declared by its DecisionNode; it does not execute the selected branch.",
+        properties: {
+            mode: {
+                enum: ["automatic", "manual", "auto_then_user"],
+                description: "automatic selects the first matching rule or fallback; manual always asks the user; auto_then_user asks the user unless exactly one rule matches.",
+            },
+            facts: { type: ["null", "boolean", "object", "array", "number", "string"], description: "用于规则判断的业务事实对象或 JSON 值，例如页面指标、预算结果或校验结论。" },
+            rules: {
+                type: "array",
+                description: "Ordered safe rules. Each rule may only select a branch statically declared by the DecisionNode.",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string", minLength: 1, description: "规则的稳定审计标识，用于 matchedRuleIds 记录命中来源。" },
+                        branch: { type: "string", minLength: 1, description: "规则命中后选择的 DecisionNode 已声明分支 ID。" },
+                        match: { enum: ["all", "any"], description: "all 要求全部条件成立；any 只要求至少一个条件成立。" },
+                        conditions: {
+                            type: "array",
+                            minItems: 1,
+                            description: "针对 facts 的条件列表，按照 match 指定的 all 或 any 方式组合。",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    path: { type: "string", description: "读取 facts 的 JSON Pointer；空字符串表示整个 facts。" },
+                                    operator: {
+                                        enum: ["eq", "ne", "gt", "gte", "lt", "lte", "in", "not_in", "contains", "exists"],
+                                        description: "将 path 对应事实值与 value 比较时使用的有限运算符。",
+                                    },
+                                    value: { type: ["null", "boolean", "object", "array", "number", "string"], description: "比较目标值；exists 运算符可省略该字段。" },
+                                    negate: { type: "boolean", description: "为 true 时反转当前条件的判断结果。" },
+                                },
+                                required: ["path", "operator"],
+                                additionalProperties: false,
+                            },
+                        },
+                        reason: { type: "string", minLength: 1, description: "规则命中时写入选择结果的可读原因。" },
+                    },
+                    required: ["id", "branch", "match", "conditions"],
+                    additionalProperties: false,
+                },
+            },
+            prompt: { type: "string", minLength: 1, description: "Optional user-facing question used when a Signal is required." },
+            fallbackBranch: { type: "string", minLength: 1, description: "Declared branch selected by automatic mode when no rule matches." },
+        },
+        required: ["mode", "facts", "rules"],
+        additionalProperties: false,
+    };
+}
+export const HOST_SELECTOR_INPUT_SCHEMA = {
+    type: "object",
+    description: "Input for select.host-model. The current native Codex or Trae chooses one declared DecisionNode branch; this Atom does not perform the branch action.",
+    properties: {
+        question: { type: "string", minLength: 1, description: "The concrete branch decision the current Host Model must make." },
+        facts: { type: ["null", "boolean", "object", "array", "number", "string"], description: "交给当前 Codex 或 Trae 判断分支时参考的结构化业务事实。" },
+        guidance: { type: "string", minLength: 1, description: "Optional evaluation criteria; it cannot expand the statically declared branches." },
+    },
+    required: ["question", "facts"],
+    additionalProperties: false,
+};
+export function selectorOutputSchema(sources) {
+    return {
+        type: "object",
+        description: "Auditable branch decision consumed by DecisionNode.select. branch is data, not a target node id.",
+        properties: {
+            branch: { type: "string", minLength: 1, description: "One branch id declared by the active DecisionNode." },
+            source: { enum: [...sources], description: "Whether deterministic rules, the user, or the current Host Model made the decision." },
+            reason: { type: "string", minLength: 1, description: "Human-readable audit reason for the choice." },
+            matchedRuleIds: { type: "array", description: "自动模式下实际命中的规则 ID；用户或 Host 决策时通常为空数组。", items: { type: "string", description: "一条已命中规则的稳定 ID。" } },
+            factsHash: { type: "string", pattern: "^sha256:[a-f0-9]{64}$", description: "参与本次决策的 facts 内容哈希，用于恢复和审计一致性。" },
+        },
+        required: ["branch", "source", "reason", "matchedRuleIds", "factsHash"],
+        additionalProperties: false,
+    };
+}
+export function selectorCheckpointSchema() {
+    return {
+        type: "object",
+        properties: {
+            stage: { enum: ["ready", "waiting_user"], description: "选择器当前处于可计算状态还是正在等待用户 Signal。" },
+            factsHash: { type: "string", pattern: "^sha256:[a-f0-9]{64}$", description: "暂停前 facts 的内容哈希，用于恢复时校验输入未漂移。" },
+            matchedRuleIds: { type: "array", description: "暂停或恢复前已经命中的规则 ID。", items: { type: "string", description: "一条已命中规则的稳定 ID。" } },
+        },
+        required: ["stage", "factsHash", "matchedRuleIds"],
+        additionalProperties: false,
+    };
+}
+export function hostSelectorCheckpointSchema() {
+    return {
+        type: "object",
+        properties: {
+            stage: { enum: ["ready", "waiting_host"], description: "Host 选择器当前处于可计算状态还是正在等待 HostTask。" },
+            factsHash: { type: "string", pattern: "^sha256:[a-f0-9]{64}$", description: "暂停前 facts 的内容哈希，用于恢复时校验输入未漂移。" },
+        },
+        required: ["stage", "factsHash"],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/selector-atom.d.ts

@@ -0,0 +1,4 @@
+import { type AtomDefinition } from "@atom-workflow-agent/atom-sdk";
+import type { SelectorAtomDefinition, SelectorDecision, SelectorInput } from "./types.js";
+export declare function defineSelectorAtom(definition: SelectorAtomDefinition): AtomDefinition<SelectorInput, SelectorDecision>;
+//# sourceMappingURL=selector-atom.d.ts.map

package/dist/selector-atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-atom.d.ts","sourceRoot":"","sources":["../src/selector-atom.ts"],"names":[],"mappings":"AACA,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpG,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQ1F,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,GAAG,cAAc,CAAC,aAAa,EAAE,gBAAgB,CAAC,CA6CtH"}

package/dist/selector-atom.js

@@ -0,0 +1,58 @@
+import { AtomExecutionError, defineAtom } from "@atom-workflow-agent/atom-sdk";
+import { hashSelectorFacts, matchingRules } from "./rule-evaluator.js";
+import { selectorInputSchema, selectorOutputSchema } from "./schemas.js";
+export function defineSelectorAtom(definition) {
+    const expiresInMs = definition.signalExpiresInMs ?? 86_400_000;
+    if (!Number.isInteger(expiresInMs) || expiresInMs <= 0 || expiresInMs > 31_536_000_000)
+        throw new TypeError("Selector Atom signalExpiresInMs must be a positive integer no greater than 31536000000");
+    return defineAtom({
+        id: definition.id,
+        ...(definition.version ? { version: definition.version } : {}),
+        title: definition.title ?? "DecisionNode rule or user branch selector",
+        description: definition.description ?? "DecisionNode-only Atom that deterministically evaluates structured facts or pauses for an explicit user choice, then returns one statically declared branch id.",
+        input: selectorInputSchema(),
+        output: selectorOutputSchema(["automatic", "user"]),
+        reliability: { idempotent: true, timeoutMs: 5_000 },
+        execute(input, context) {
+            const branches = context.decision?.branches;
+            if (!branches?.length)
+                throw new AtomExecutionError("SELECT_DECISION_CONTEXT_REQUIRED", "select.rule must run as a DecisionNode");
+            const branchSet = new Set(branches);
+            const matched = matchingRules(input.facts, input.rules, branchSet);
+            const matchedRuleIds = matched.map((rule) => rule.id);
+            const factsHash = hashSelectorFacts(input.facts);
+            const automatic = (branch, reason) => ({ branch, source: "automatic", reason, matchedRuleIds, factsHash });
+            if (input.mode === "automatic" || (input.mode === "auto_then_user" && matched.length === 1)) {
+                if (matched[0])
+                    return automatic(matched[0].branch, matched[0].reason ?? `Rule '${matched[0].id}' matched`);
+                if (input.fallbackBranch) {
+                    if (!branchSet.has(input.fallbackBranch))
+                        throw new AtomExecutionError("SELECT_BRANCH_UNDECLARED", `Selector fallback uses an undeclared branch: ${input.fallbackBranch}`);
+                    return automatic(input.fallbackBranch, "No rule matched; selected the configured fallback branch");
+                }
+                if (input.mode === "automatic")
+                    throw new AtomExecutionError("SELECT_NO_MATCH", "No selector rule matched and no fallbackBranch was provided", { details: { factsHash } });
+            }
+            const prompt = input.prompt ?? (input.mode === "manual" ? `请选择 Workflow 分支：${branches.join("、")}` : `自动规则${matched.length === 0 ? "没有匹配" : "存在多个匹配"}，请选择 Workflow 分支：${branches.join("、")}`);
+            return context.waitForSignal({
+                key: "selector_decision", prompt, expiresInMs,
+                checkpoint: { factsHash, matchedRuleIds },
+                response: { type: "object", properties: { branch: { enum: [...branches] }, reason: { type: "string", minLength: 1 } }, required: ["branch", "reason"], additionalProperties: false },
+                metadata: { selector: definition.id, allowedBranches: [...branches], matchedRuleIds, requiresExplicitUserResponse: true },
+            });
+        },
+        resume(input, resumed, context) {
+            if (resumed.type !== "signal")
+                throw new AtomExecutionError("SELECT_SIGNAL_RESUME_REQUIRED", "Selector requires an explicit user Signal response");
+            const checkpoint = resumed.checkpoint;
+            if (hashSelectorFacts(input.facts) !== checkpoint.factsHash)
+                throw new AtomExecutionError("SELECT_FACTS_CHANGED", "Selector facts changed while awaiting the user response");
+            const response = resumed.value;
+            const branches = context.decision?.branches;
+            if (!branches?.includes(response.branch))
+                throw new AtomExecutionError("SELECT_BRANCH_UNDECLARED", `User selected an undeclared branch: ${response.branch}`);
+            return { branch: response.branch, source: "user", reason: response.reason, matchedRuleIds: checkpoint.matchedRuleIds, factsHash: checkpoint.factsHash };
+        },
+    });
+}
+//# sourceMappingURL=selector-atom.js.map

package/dist/selector-atom.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+import type { JsonValue } from "@atom-workflow-agent/contracts";
+export type SelectMode = "automatic" | "manual" | "auto_then_user";
+export type SelectOperator = "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "in" | "not_in" | "contains" | "exists";
+export interface SelectCondition extends Record<string, JsonValue> {
+    /** JSON Pointer (`/metrics/lcpMs`) or dot path (`metrics.lcpMs`). */
+    readonly path: string;
+    readonly operator: SelectOperator;
+    readonly value?: JsonValue;
+    readonly negate?: boolean;
+}
+export interface SelectRule<TBranch extends string = string> extends Record<string, JsonValue> {
+    readonly id: string;
+    readonly branch: TBranch;
+    readonly match: "all" | "any";
+    readonly conditions: SelectCondition[];
+    readonly reason?: string;
+}
+export interface SelectorInput<TBranch extends string = string> extends Record<string, JsonValue> {
+    readonly mode: SelectMode;
+    readonly facts: JsonValue;
+    readonly rules: SelectRule<TBranch>[];
+    readonly prompt?: string;
+    readonly fallbackBranch?: TBranch;
+}
+export interface HostSelectorInput extends Record<string, JsonValue> {
+    readonly question: string;
+    readonly facts: JsonValue;
+    readonly guidance?: string;
+}
+export type SelectionSource = "automatic" | "user" | "host";
+export interface SelectorDecision<TBranch extends string = string> extends Record<string, JsonValue> {
+    readonly branch: TBranch;
+    readonly source: SelectionSource;
+    readonly reason: string;
+    readonly matchedRuleIds: string[];
+    readonly factsHash: string;
+}
+export interface SelectorAtomDefinition {
+    readonly id: string;
+    readonly version?: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly signalExpiresInMs?: number;
+}
+export interface HostSelectorAtomDefinition {
+    readonly id: string;
+    readonly version?: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly hostExpiresInMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@atom-workflow-agent/select-atom",
+  "version": "1.0.0",
+  "description": "Built-in deterministic and human-in-the-loop selection atoms.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joekbits/atom-workflow-agent.git",
+    "directory": "atoms/select-atom"
+  },
+  "homepage": "https://github.com/joekbits/atom-workflow-agent/tree/main/atoms/select-atom#readme",
+  "bugs": {
+    "url": "https://github.com/joekbits/atom-workflow-agent/issues"
+  },
+  "keywords": [
+    "atom",
+    "workflow",
+    "decision",
+    "selector"
+  ],
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@atom-workflow-agent/contracts": "0.1.0",
+    "@atom-workflow-agent/atom-sdk": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}