@atom-workflow-agent/workflow-planner 0.1.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,39 @@
+# @atom-workflow-agent/workflow-planner
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+Catalog-aware planning that turns goals into globally valid workflow revisions.
+
+## Responsibilities
+
+- Resolves capability coverage before graph generation and reports missing Atoms early.
+- Lets the model select exact Atom keys and map business roles to exact top-level fields; the Runtime supplies and validates authoritative Atom Schemas.
+- Applies semantic planning transactions to immutable workspace revisions.
+- Performs strict automatic binding, normalization, compiler validation, rollback, and checkpoint recovery.
+- Accepts any model adapter through `PlanningModelPort`; Planner core does not depend on ACP.
+
+Capability preflight never asks the model to reproduce JSON Schema. The compact Catalog Index contains field names, descriptions, required flags, and all applicable JSON value types. A covered requirement references those fields; a genuinely absent executable capability uses a separate `missing` resolution. Control-flow terminals and literal bindings are not capabilities.
+
+Control structure and control execution remain distinct: a Decision container is not a capability, but the Atom that computes its branch from runtime data is. Such selector Atoms must pass the same exact-key and exact-field coverage check as every other executed Atom.
+
+## Boundaries
+
+- Does not execute Atoms, mutate frozen revisions, or store Run evidence.
+
+## Main entry points
+
+- `PlanningController`
+- `PlanningModelPort`
+- `buildPlannerCatalog`
+- `PlanningWorkspaceService`
+- `resolveCapabilityCoverage`
+- `LocalPlanStore`
+
+## Development
+
+```bash
+pnpm --filter @atom-workflow-agent/workflow-planner typecheck
+pnpm --filter @atom-workflow-agent/workflow-planner test
+```
+
+See the project [documentation](../../docs/README.md) for shared concepts and complete flows.

package/README.zh-CN.md

@@ -0,0 +1,39 @@
+# @atom-workflow-agent/workflow-planner
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+基于 Catalog 将目标编排为全局有效 Workflow Revision 的规划层。
+
+## 职责
+
+- 在生成图前解析能力覆盖并尽早报告缺失 Atom。
+- 由模型选择精确 Atom key，并把业务角色映射到精确顶层字段；权威 Atom Schema 由 Runtime 提供并校验。
+- 将语义规划事务应用到不可变 Workspace Revision。
+- 执行严格自动绑定、规范化、Compiler 校验、事务回滚与 checkpoint 恢复。
+- 通过 `PlanningModelPort` 接受任意模型适配器；Planner 内不依赖 ACP。
+
+能力预检不会要求模型复写 JSON Schema。精简 Catalog Index 只提供字段名、description、必填标记和所有适用 JSON 值类型。已覆盖需求引用这些字段；真正缺少的可执行能力使用独立的 `missing` resolution。控制流终态和常量绑定不属于能力。
+
+控制结构与控制执行必须区分：Decision 容器不是能力，但根据运行时数据计算分支的 Atom 是能力。选择器 Atom 与其他会执行的 Atom 一样，必须通过精确 key 和精确字段覆盖校验。
+
+## 边界
+
+- 不执行 Atom、不修改冻结 Revision，也不存储 Run 证据。
+
+## 主要入口
+
+- `PlanningController`
+- `PlanningModelPort`
+- `buildPlannerCatalog`
+- `PlanningWorkspaceService`
+- `resolveCapabilityCoverage`
+- `LocalPlanStore`
+
+## 开发
+
+```bash
+pnpm --filter @atom-workflow-agent/workflow-planner typecheck
+pnpm --filter @atom-workflow-agent/workflow-planner test
+```
+
+通用概念与完整流程见项目[中文文档](../../docs/README.zh-CN.md)。

package/dist/capabilities/capability-coverage-resolver.d.ts

@@ -0,0 +1,5 @@
+import { type CapabilityCoverageResult } from "@atom-workflow-agent/contracts";
+import type { AtomRegistry } from "@atom-workflow-agent/atom-catalog";
+/** Deterministic exact-key coverage check performed before any graph transaction. */
+export declare function resolveCapabilityCoverage(raw: unknown, registry: AtomRegistry): CapabilityCoverageResult;
+//# sourceMappingURL=capability-coverage-resolver.d.ts.map

package/dist/capabilities/capability-coverage-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-coverage-resolver.d.ts","sourceRoot":"","sources":["../../src/capabilities/capability-coverage-resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,wBAAwB,EAM9B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,mCAAmC,CAAC;AA2JzF,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,GAAG,wBAAwB,CA6ExG"}

package/dist/capabilities/capability-coverage-resolver.js

@@ -0,0 +1,229 @@
+import { createHash } from "node:crypto";
+import { CapabilityCoverageResultSchema, PlannerCapabilityPlanSchema, } from "@atom-workflow-agent/contracts";
+function objectOf(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function typeLabel(schema) {
+    const value = objectOf(schema)?.type;
+    if (typeof value === "string")
+        return value;
+    if (Array.isArray(value))
+        return value.join("|");
+    return "unknown";
+}
+function schemaFields(entry, direction) {
+    const schema = direction === "input" ? entry.plannerDescriptor.inputSchema : entry.plannerDescriptor.outputSchema;
+    return objectOf(objectOf(schema)?.properties) ?? {};
+}
+function schemaAllowsField(entry, direction, field) {
+    const schema = direction === "input" ? entry.plannerDescriptor.inputSchema : entry.plannerDescriptor.outputSchema;
+    if (field in schemaFields(entry, direction))
+        return true;
+    const additionalProperties = objectOf(schema)?.additionalProperties;
+    return additionalProperties === true || objectOf(additionalProperties) !== undefined;
+}
+function availableFields(entry, direction) {
+    return Object.entries(schemaFields(entry, direction)).map(([name, schema]) => `${name}:${typeLabel(schema)}`).sort();
+}
+function selectedAtomFieldIssues(requirement, entries) {
+    if (requirement.resolution.kind !== "covered")
+        return [];
+    const issues = [];
+    for (const use of requirement.resolution.uses) {
+        const entry = entries.get(use.atom);
+        if (!entry)
+            continue;
+        for (const [direction, ports] of [["input", use.inputs], ["output", use.outputs]]) {
+            const fields = schemaFields(entry, direction);
+            for (const port of ports) {
+                if (!schemaAllowsField(entry, direction, port.field))
+                    issues.push({
+                        atomKey: use.atom,
+                        direction,
+                        field: port.field,
+                        reason: "field-not-found",
+                        availableFields: availableFields(entry, direction),
+                    });
+            }
+        }
+        const declaredInputs = new Set(use.inputs.map(({ field }) => field));
+        const requiredInputs = Array.isArray(entry.plannerDescriptor.inputSchema.required)
+            ? entry.plannerDescriptor.inputSchema.required.filter((field) => typeof field === "string")
+            : [];
+        for (const field of requiredInputs) {
+            if (!declaredInputs.has(field))
+                issues.push({
+                    atomKey: use.atom,
+                    direction: "input",
+                    field,
+                    reason: "required-input-not-declared",
+                    availableFields: availableFields(entry, "input"),
+                });
+        }
+    }
+    return issues;
+}
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value !== null && typeof value === "object")
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => [key, canonicalize(nested)]));
+    return value;
+}
+function hash(value) {
+    return `sha256:${createHash("sha256").update(JSON.stringify(canonicalize(value))).digest("hex")}`;
+}
+function grams(value) {
+    const normalized = value.toLowerCase().replace(/[\s\p{P}\p{S}]+/gu, "");
+    if (normalized.length < 2)
+        return new Set(normalized ? [normalized] : []);
+    return new Set(Array.from({ length: normalized.length - 1 }, (_, index) => normalized.slice(index, index + 2)));
+}
+function similarity(left, right) {
+    const a = grams(left);
+    const b = grams(right);
+    if (!a.size || !b.size)
+        return 0;
+    const overlap = [...a].filter((value) => b.has(value)).length;
+    return overlap / (a.size + b.size - overlap);
+}
+function requirementText(requirement) {
+    const resolution = requirement.resolution;
+    return resolution.kind === "covered"
+        ? [requirement.description, ...resolution.uses.flatMap((use) => [
+                use.atom,
+                ...use.inputs.flatMap(({ field, role }) => [field, role]),
+                ...use.outputs.flatMap(({ field, role }) => [field, role]),
+            ])].join(" ")
+        : [requirement.description, ...resolution.desiredInputs.flatMap(({ name, description }) => [name, description]),
+            ...resolution.desiredOutputs.flatMap(({ name, description }) => [name, description])].join(" ");
+}
+function schemaDescriptions(value) {
+    if (Array.isArray(value))
+        return value.flatMap(schemaDescriptions);
+    const object = objectOf(value);
+    if (!object)
+        return [];
+    return [
+        ...(typeof object.description === "string" ? [object.description] : []),
+        ...Object.values(object).flatMap(schemaDescriptions),
+    ];
+}
+const ALL_VALUE_TYPES = ["null", "boolean", "object", "array", "number", "integer", "string"];
+function desiredPort(name, description) {
+    return { name, description, required: true, acceptedTypes: [...ALL_VALUE_TYPES] };
+}
+function suggestedAtomContract(requirement) {
+    const resolution = requirement.resolution;
+    const inputFields = resolution.kind === "missing"
+        ? resolution.desiredInputs
+        : resolution.uses.flatMap(({ inputs }) => inputs.map(({ field, role }) => desiredPort(field, role)));
+    const outputFields = resolution.kind === "missing"
+        ? resolution.desiredOutputs
+        : resolution.uses.flatMap(({ outputs }) => outputs.map(({ field, role }) => desiredPort(field, role)));
+    return {
+        suggestedId: `missing.${requirement.id}`,
+        description: requirement.description,
+        inputFields,
+        outputFields,
+    };
+}
+function nearMatches(requirement, entries) {
+    const expected = requirementText(requirement);
+    return entries.map((entry) => ({
+        atomKey: entry.plannerDescriptor.key,
+        title: entry.plannerDescriptor.title,
+        purpose: entry.plannerDescriptor.purpose,
+        score: Number(similarity(expected, [
+            entry.plannerDescriptor.title,
+            entry.plannerDescriptor.purpose,
+            ...schemaDescriptions(entry.plannerDescriptor.inputSchema),
+            ...schemaDescriptions(entry.plannerDescriptor.outputSchema),
+        ].join(" ")).toFixed(4)),
+        rejectedBecause: "该项仅是语义近似候选；最终是否可用以 exact key、启用状态和权威 Atom 字段校验为准。",
+    })).sort((left, right) => right.score - left.score || left.atomKey.localeCompare(right.atomKey)).slice(0, 5);
+}
+/** Deterministic exact-key coverage check performed before any graph transaction. */
+export function resolveCapabilityCoverage(raw, registry) {
+    const plan = PlannerCapabilityPlanSchema.parse(raw);
+    const entries = registry.list();
+    const available = new Map(entries.map((entry) => [entry.plannerDescriptor.key, entry]));
+    const gaps = [];
+    for (const requirement of plan.requirements) {
+        if (requirement.resolution.kind === "missing") {
+            if (!requirement.required)
+                continue;
+            gaps.push({
+                requirement,
+                code: "PLANNING_CAPABILITY_UNAVAILABLE",
+                message: `No registered Atom was selected for required capability: ${requirement.description}`,
+                nearMatches: nearMatches(requirement, entries),
+                suggestedAtomContract: suggestedAtomContract(requirement),
+            });
+            continue;
+        }
+        const atomKeys = requirement.resolution.uses.map(({ atom }) => atom);
+        const unknown = atomKeys.filter((key) => !available.has(key));
+        if (unknown.length > 0) {
+            gaps.push({
+                requirement,
+                code: "PLANNING_CAPABILITY_ATOM_UNKNOWN",
+                message: `Capability references unavailable Atom keys: ${unknown.join(", ")}`,
+                nearMatches: nearMatches(requirement, entries),
+                suggestedAtomContract: suggestedAtomContract(requirement),
+            });
+            continue;
+        }
+        const fieldIssues = selectedAtomFieldIssues(requirement, available);
+        if (fieldIssues.length > 0)
+            gaps.push({
+                requirement,
+                code: "PLANNING_CAPABILITY_SCHEMA_MISMATCH",
+                message: `Selected Atom fields are invalid for capability ${requirement.id}: ${fieldIssues.map(({ atomKey, direction, field, reason }) => `${atomKey}.${direction}.${field}:${reason}`).join(", ")}`,
+                nearMatches: nearMatches(requirement, entries),
+                suggestedAtomContract: suggestedAtomContract(requirement),
+                fieldIssues,
+            });
+    }
+    const catalogHash = hash(entries.map(({ plannerDescriptor }) => ({
+        key: plannerDescriptor.key,
+        descriptorHash: plannerDescriptor.hash,
+    })));
+    if (gaps.length > 0)
+        return CapabilityCoverageResultSchema.parse({
+            schemaVersion: "1.1",
+            status: "blocked_missing_atom",
+            catalogHash,
+            plan,
+            searchedAtomCount: entries.length,
+            gaps,
+        });
+    const selectedAtomKeys = [...new Set(plan.requirements.flatMap(({ resolution }) => resolution.kind === "covered" ? resolution.uses.map(({ atom }) => atom) : []))];
+    if (selectedAtomKeys.length === 0) {
+        const requirement = plan.requirements[0];
+        return CapabilityCoverageResultSchema.parse({
+            schemaVersion: "1.1",
+            status: "blocked_missing_atom",
+            catalogHash,
+            plan,
+            searchedAtomCount: entries.length,
+            gaps: [{
+                    requirement: { ...requirement, required: true },
+                    code: "PLANNING_CAPABILITY_UNAVAILABLE",
+                    message: "Capability plan selected no executable Atom",
+                    nearMatches: nearMatches(requirement, entries),
+                    suggestedAtomContract: suggestedAtomContract(requirement),
+                }],
+        });
+    }
+    return CapabilityCoverageResultSchema.parse({
+        schemaVersion: "1.1",
+        status: "covered",
+        catalogHash,
+        plan,
+        selectedAtomKeys,
+    });
+}
+//# sourceMappingURL=capability-coverage-resolver.js.map

package/dist/capabilities/capability-coverage-resolver.js.map

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

package/dist/catalog/planner-catalog.d.ts

@@ -0,0 +1,14 @@
+import { type PlannerAtomCatalog, type PlannerAtomCatalogIndex, type PlannerAtomDescriptor, type PlannerCatalogIndexAtomDescriptor } from "@atom-workflow-agent/contracts";
+export interface PlannerCatalogEntrySource {
+    readonly catalogIndexDescriptor: PlannerCatalogIndexAtomDescriptor;
+    readonly plannerDescriptor: PlannerAtomDescriptor;
+    readonly state: string;
+    readonly enabled: boolean;
+}
+/** Builds the exact, executor-free catalog visible to every planning frontend. */
+export declare function buildPlannerCatalog(entries: readonly PlannerCatalogEntrySource[]): PlannerAtomCatalog;
+/** Compact first-pass catalog. Full Schemas are expanded only after selection. */
+export declare function buildPlannerCatalogIndex(catalog: PlannerAtomCatalog, sources?: readonly PlannerCatalogEntrySource[]): PlannerAtomCatalogIndex;
+/** Expands exact selected keys while preserving Catalog order and hash semantics. */
+export declare function selectPlannerCatalog(catalog: PlannerAtomCatalog, selectedAtomKeys: readonly string[]): PlannerAtomCatalog;
+//# sourceMappingURL=planner-catalog.d.ts.map

package/dist/catalog/planner-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-catalog.d.ts","sourceRoot":"","sources":["../../src/catalog/planner-catalog.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,iCAAiC,EACvC,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,sBAAsB,EAAE,iCAAiC,CAAC;IACnE,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAcD,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,GAAG,kBAAkB,CAMrG;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,SAAS,yBAAyB,EAAE,GAAG,uBAAuB,CAgB7I;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAIzH"}

package/dist/catalog/planner-catalog.js

@@ -0,0 +1,47 @@
+import { createHash } from "node:crypto";
+import { PlannerAtomCatalogIndexSchema, PlannerAtomCatalogSchema, } from "@atom-workflow-agent/contracts";
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, canonicalize(nested)]));
+    }
+    return value;
+}
+function hash(value) {
+    return `sha256:${createHash("sha256").update(JSON.stringify(canonicalize(value))).digest("hex")}`;
+}
+/** Builds the exact, executor-free catalog visible to every planning frontend. */
+export function buildPlannerCatalog(entries) {
+    const atoms = entries
+        .filter((entry) => entry.enabled && entry.state === "enabled")
+        .map((entry) => ({ key: entry.plannerDescriptor.key, descriptor: entry.plannerDescriptor }))
+        .sort((left, right) => left.key.localeCompare(right.key));
+    return PlannerAtomCatalogSchema.parse({ schemaVersion: "1.0", hash: hash(atoms), atoms });
+}
+/** Compact first-pass catalog. Full Schemas are expanded only after selection. */
+export function buildPlannerCatalogIndex(catalog, sources) {
+    const byKey = new Map((sources ?? []).map((entry) => [entry.catalogIndexDescriptor.key, entry.catalogIndexDescriptor]));
+    const atoms = catalog.atoms.map(({ key, descriptor }) => {
+        const existing = byKey.get(key);
+        if (existing)
+            return existing;
+        const projection = {
+            schemaVersion: "1.0",
+            key,
+            title: descriptor.title,
+            purpose: descriptor.purpose,
+            inputFields: [],
+            outputFields: [],
+        };
+        return { ...projection, hash: hash(projection) };
+    });
+    return PlannerAtomCatalogIndexSchema.parse({ schemaVersion: "1.0", hash: hash(atoms), atoms });
+}
+/** Expands exact selected keys while preserving Catalog order and hash semantics. */
+export function selectPlannerCatalog(catalog, selectedAtomKeys) {
+    const selected = new Set(selectedAtomKeys);
+    const atoms = catalog.atoms.filter((entry) => selected.has(entry.key));
+    return PlannerAtomCatalogSchema.parse({ schemaVersion: "1.0", hash: hash(atoms), atoms });
+}
+//# sourceMappingURL=planner-catalog.js.map

package/dist/catalog/planner-catalog.js.map

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

package/dist/draft/planner-draft-normalizer.d.ts

@@ -0,0 +1,20 @@
+import { type JsonValue, type PlannerDraft, type WorkflowSpec, type WorkflowValidationError } from "@atom-workflow-agent/contracts";
+export interface PlannerDraftPathMapping {
+    readonly alias: string;
+    readonly draftPath: string;
+    readonly workflowNodeId: string;
+}
+export type PlannerDraftNormalizationResult = {
+    readonly success: true;
+    readonly workflow: WorkflowSpec;
+    readonly pathMappings: readonly PlannerDraftPathMapping[];
+} | {
+    readonly success: false;
+    readonly errors: readonly WorkflowValidationError[];
+    readonly pathMappings: readonly PlannerDraftPathMapping[];
+};
+export declare function normalizePlannerDraft(draft: PlannerDraft, options: {
+    readonly selectedAtomKeys: ReadonlySet<string>;
+    readonly workflowInputs: Readonly<Record<string, JsonValue>>;
+}): PlannerDraftNormalizationResult;
+//# sourceMappingURL=planner-draft-normalizer.d.ts.map

package/dist/draft/planner-draft-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-draft-normalizer.d.ts","sourceRoot":"","sources":["../../src/draft/planner-draft-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,YAAY,EAGjB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC7B,MAAM,gCAAgC,CAAC;AAexC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,+BAA+B,GACvC;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,uBAAuB,EAAE,CAAA;CAAE,GACtH;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,uBAAuB,EAAE,CAAA;CAAE,CAAC;AAshBhJ,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE;IACP,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC9D,GACA,+BAA+B,CAMjC"}