@atom-workflow-agent/atom-catalog 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,30 @@
+# @atom-workflow-agent/atom-catalog
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+The trusted catalog of enabled exact Atom definitions and reloadable module sources.
+
+## Responsibilities
+
+- Loads explicitly configured packages and project-local modules.
+- Validates packages, exact id@version keys, schemas, projections, and duplicate conflicts.
+- Tracks registered, enabled, draining, and disposed definitions with Attempt leases.
+
+## Boundaries
+
+- Does not execute lifecycle hooks, plan graphs, or choose branches.
+
+## Main entry points
+
+- `AtomRegistry`
+- `loadAtomPackages`
+- `loadAtomDiscoveryConfig`
+
+## Development
+
+```bash
+pnpm --filter @atom-workflow-agent/atom-catalog typecheck
+pnpm --filter @atom-workflow-agent/atom-catalog test
+```
+
+See the project [documentation](../../docs/README.md) for shared concepts and complete flows.

package/README.zh-CN.md

@@ -0,0 +1,30 @@
+# @atom-workflow-agent/atom-catalog
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+已启用精确 Atom Definition 与可重载模块来源的可信目录。
+
+## 职责
+
+- 加载显式配置的 Package 与项目内模块。
+- 校验 Package、精确 id@version、Schema、投影和重复冲突。
+- 通过 Attempt lease 管理 registered、enabled、draining、disposed 状态。
+
+## 边界
+
+- 不执行生命周期 Hook、不规划图，也不选择分支。
+
+## 主要入口
+
+- `AtomRegistry`
+- `loadAtomPackages`
+- `loadAtomDiscoveryConfig`
+
+## 开发
+
+```bash
+pnpm --filter @atom-workflow-agent/atom-catalog typecheck
+pnpm --filter @atom-workflow-agent/atom-catalog test
+```
+
+通用概念与完整流程见项目[中文文档](../../docs/README.zh-CN.md)。

package/dist/config/atom-discovery-config.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const AtomSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"package">;
+    specifier: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"module">;
+    path: z.ZodString;
+}, z.core.$strict>], "kind">;
+export type AtomSource = z.infer<typeof AtomSourceSchema>;
+export declare const AtomDiscoveryConfigSchema: z.ZodObject<{
+    sources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"package">;
+        specifier: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"module">;
+        path: z.ZodString;
+    }, z.core.$strict>], "kind">>>;
+}, z.core.$strict>;
+export type AtomDiscoveryConfig = z.infer<typeof AtomDiscoveryConfigSchema>;
+//# sourceMappingURL=atom-discovery-config.d.ts.map

package/dist/config/atom-discovery-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom-discovery-config.d.ts","sourceRoot":"","sources":["../../src/config/atom-discovery-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,gBAAgB;;;;;;4BAS3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,yBAAyB;;;;;;;;kBASpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/config/atom-discovery-config.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+const PackageSpecifierSchema = z.string().regex(/^(?:@[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*|[a-z0-9][a-z0-9._-]*)$/i, "Package Atom source must be a package root without a subpath");
+export const AtomSourceSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("package"),
+        specifier: PackageSpecifierSchema,
+    }).strict(),
+    z.object({
+        kind: z.literal("module"),
+        path: z.string().trim().min(1),
+    }).strict(),
+]);
+export const AtomDiscoveryConfigSchema = z.object({
+    sources: z.array(AtomSourceSchema).default([]),
+}).strict().superRefine((config, context) => {
+    const identities = config.sources.map((source) => source.kind === "package"
+        ? `package:${source.specifier}`
+        : `module:${source.path}`);
+    if (new Set(identities).size !== identities.length) {
+        context.addIssue({ code: "custom", path: ["sources"], message: "Atom sources must be unique" });
+    }
+});
+//# sourceMappingURL=atom-discovery-config.js.map

package/dist/config/atom-discovery-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom-discovery-config.js","sourceRoot":"","sources":["../../src/config/atom-discovery-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAC7C,yEAAyE,EACzE,8DAA8D,CAC/D,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3D,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC1B,SAAS,EAAE,sBAAsB;KAClC,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC/B,CAAC,CAAC,MAAM,EAAE;CACZ,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/C,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;QACzE,CAAC,CAAC,WAAW,MAAM,CAAC,SAAS,EAAE;QAC/B,CAAC,CAAC,UAAU,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7B,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QACnD,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,CAAC;IAClG,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./config/atom-discovery-config.js";
+export * from "./loader/atom-package-loader.js";
+export * from "./registry/atom-registry.js";
+//# 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":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./config/atom-discovery-config.js";
+export * from "./loader/atom-package-loader.js";
+export * from "./registry/atom-registry.js";
+//# 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,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC"}

package/dist/loader/atom-package-loader.d.ts

@@ -0,0 +1,23 @@
+import { AtomRegistry } from "../registry/atom-registry.js";
+import { type AtomDiscoveryConfig } from "../config/atom-discovery-config.js";
+interface ImportedAtomModule {
+    readonly atomPackage?: unknown;
+    readonly default?: unknown;
+}
+export interface LoadedAtomPackage {
+    readonly sourceId: string;
+    readonly packageId: string;
+    readonly packageVersion: string;
+    readonly atomKeys: readonly string[];
+}
+export interface AtomPackageLoaderOptions {
+    readonly cwd: string;
+    readonly registry: AtomRegistry;
+    readonly config?: AtomDiscoveryConfig;
+    readonly importModule?: (url: string) => Promise<ImportedAtomModule>;
+    readonly resolvePackage?: (specifier: string, cwd: string) => string;
+}
+/** Loads configured Atom packages in two phases, then registers only exact declared Atoms. */
+export declare function loadAtomPackages(options: AtomPackageLoaderOptions): Promise<readonly LoadedAtomPackage[]>;
+export {};
+//# sourceMappingURL=atom-package-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atom-package-loader.d.ts","sourceRoot":"","sources":["../../src/loader/atom-package-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAA6B,KAAK,mBAAmB,EAAmB,MAAM,oCAAoC,CAAC;AAE1H,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AASD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACtE;AA4ED,8FAA8F;AAC9F,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAqC/G"}

package/dist/loader/atom-package-loader.js

@@ -0,0 +1,120 @@
+import { createRequire } from "node:module";
+import { realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { AtomPackageManifestSchema, AtomWorkflowError, atomKey } from "@atom-workflow-agent/contracts";
+import { AtomRegistry } from "../registry/atom-registry.js";
+import { AtomDiscoveryConfigSchema } from "../config/atom-discovery-config.js";
+function sourceError(code, message, cause) {
+    return new AtomWorkflowError(code, message, false, cause === undefined ? undefined : { cause });
+}
+function assertWithinProject(projectRoot, target) {
+    const nested = relative(projectRoot, target);
+    if (nested === "" || (!nested.startsWith("..") && !isAbsolute(nested)))
+        return;
+    throw sourceError("ATOM_MODULE_OUTSIDE_PROJECT", `Local Atom module must stay inside the project: ${target}`);
+}
+function normalizePackage(raw, sourceId) {
+    if (raw === null || typeof raw !== "object") {
+        throw sourceError("ATOM_PACKAGE_EXPORT_INVALID", `Atom source must export atomPackage or default: ${sourceId}`);
+    }
+    const candidate = raw;
+    const parsed = AtomPackageManifestSchema.safeParse(candidate.manifest);
+    if (!parsed.success) {
+        throw sourceError("ATOM_PACKAGE_MANIFEST_INVALID", `Atom package manifest is invalid: ${sourceId}`, parsed.error);
+    }
+    if (!Array.isArray(candidate.atoms)) {
+        throw sourceError("ATOM_PACKAGE_ATOMS_MISSING", `Atom package must provide an atoms array: ${sourceId}`);
+    }
+    return { manifest: parsed.data, atoms: candidate.atoms };
+}
+function verifyAtoms(atoms, sourceId) {
+    if (!Array.isArray(atoms) || atoms.length === 0) {
+        throw sourceError("ATOM_PACKAGE_EMPTY", `Atom package returned no Atoms: ${sourceId}`);
+    }
+    const actual = atoms.map((atom) => {
+        if (atom === null || typeof atom !== "object" || !("manifest" in atom)) {
+            throw sourceError("ATOM_PACKAGE_FACTORY_INVALID", `Atom package returned a non-Atom value: ${sourceId}`);
+        }
+        const manifest = atom.manifest;
+        if (!manifest || typeof manifest.id !== "string" || typeof manifest.version !== "string") {
+            throw sourceError("ATOM_PACKAGE_FACTORY_INVALID", `Atom package returned an Atom without an exact id/version: ${sourceId}`);
+        }
+        return `${manifest.id}@${manifest.version}`;
+    }).sort();
+    if (new Set(actual).size !== actual.length) {
+        throw sourceError("ATOM_PACKAGE_DUPLICATE", `Atom package returned duplicate Atom keys: ${sourceId}`);
+    }
+}
+async function defaultModuleImport(url) {
+    return import(url);
+}
+function defaultPackageResolver(specifier, cwd) {
+    const requireFromProject = createRequire(join(cwd, "package.json"));
+    return requireFromProject.resolve(specifier);
+}
+async function sourceUrl(source, cwd, resolvePackage) {
+    if (source.kind === "package") {
+        let entry;
+        try {
+            entry = resolvePackage(source.specifier, cwd);
+        }
+        catch (cause) {
+            throw sourceError("ATOM_PACKAGE_NOT_FOUND", `Cannot resolve Atom package: ${source.specifier}`, cause);
+        }
+        return { sourceId: `package:${source.specifier}`, url: pathToFileURL(entry).href };
+    }
+    const projectRoot = await realpath(cwd);
+    const requested = resolve(projectRoot, source.path);
+    assertWithinProject(projectRoot, requested);
+    let canonical;
+    try {
+        canonical = await realpath(requested);
+    }
+    catch (cause) {
+        throw sourceError("ATOM_MODULE_NOT_FOUND", `Cannot resolve local Atom module: ${source.path}`, cause);
+    }
+    assertWithinProject(projectRoot, canonical);
+    return { sourceId: `module:${relative(projectRoot, canonical)}`, url: pathToFileURL(canonical).href };
+}
+/** Loads configured Atom packages in two phases, then registers only exact declared Atoms. */
+export async function loadAtomPackages(options) {
+    const config = AtomDiscoveryConfigSchema.parse(options.config ?? {});
+    const importer = options.importModule ?? defaultModuleImport;
+    const resolver = options.resolvePackage ?? defaultPackageResolver;
+    const prepared = [];
+    for (const source of config.sources) {
+        const resolved = await sourceUrl(source, options.cwd, resolver);
+        let module;
+        try {
+            module = await importer(resolved.url);
+        }
+        catch (cause) {
+            throw sourceError("ATOM_MODULE_IMPORT_FAILED", `Failed to import Atom source: ${resolved.sourceId}`, cause);
+        }
+        const packageDefinition = normalizePackage(module.atomPackage ?? module.default, resolved.sourceId);
+        const atoms = packageDefinition.atoms;
+        verifyAtoms(atoms, resolved.sourceId);
+        prepared.push({ sourceId: resolved.sourceId, moduleUrl: resolved.url, packageDefinition, atoms });
+    }
+    const packageIds = prepared.map((item) => `${item.packageDefinition.manifest.id}@${item.packageDefinition.manifest.version}`);
+    if (new Set(packageIds).size !== packageIds.length) {
+        throw sourceError("ATOM_PACKAGE_ID_DUPLICATE", "Multiple Atom sources resolved to the same package id/version");
+    }
+    const allAtomKeys = prepared.flatMap((item) => item.atoms.map((atom) => atomKey(atom.manifest)));
+    if (new Set(allAtomKeys).size !== allAtomKeys.length) {
+        throw sourceError("ATOM_SOURCE_DUPLICATE", "Multiple Atom packages export the same exact Atom key");
+    }
+    for (const item of prepared) {
+        for (const atom of item.atoms) {
+            await options.registry.register(atom, { kind: "module", sourceId: item.sourceId, moduleUrl: item.moduleUrl });
+        }
+    }
+    return prepared.map((item) => ({
+        sourceId: item.sourceId,
+        packageId: item.packageDefinition.manifest.id,
+        packageVersion: item.packageDefinition.manifest.version,
+        atomKeys: item.atoms.map((atom) => atomKey(atom.manifest)).sort(),
+    }));
+}
+//# sourceMappingURL=atom-package-loader.js.map

package/dist/loader/atom-package-loader.js.map

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

package/dist/registry/atom-registry.d.ts

@@ -0,0 +1,56 @@
+import { type AtomCapability, type AtomInstanceState, type AtomManifest, type PlannerAtomDescriptor, type PlannerCatalogIndexAtomDescriptor } from "@atom-workflow-agent/contracts";
+import type { AtomDefinition } from "@atom-workflow-agent/atom-sdk";
+type AnyAtomDefinition = AtomDefinition<any, any>;
+/** Exact reloadable module used by process-backed Atom Attempt execution. */
+export interface AtomExecutionSource {
+    readonly kind: "module";
+    readonly sourceId: string;
+    readonly moduleUrl: string;
+}
+export interface AtomRegistryQuery {
+    id?: string;
+    includeDisabled?: boolean;
+}
+export interface AtomRegistryEntry {
+    readonly manifest: AtomManifest;
+    readonly capability: AtomCapability;
+    readonly catalogIndexDescriptor: PlannerCatalogIndexAtomDescriptor;
+    readonly plannerDescriptor: PlannerAtomDescriptor;
+    readonly state: AtomInstanceState;
+    readonly enabled: boolean;
+    readonly activeAttempts: number;
+    readonly executionSource?: AtomExecutionSource;
+    readonly disabledReason?: string;
+}
+export interface AtomLease<TInput = any, TOutput = any> {
+    readonly definition: AtomDefinition<TInput, TOutput>;
+    readonly executionSource?: AtomExecutionSource;
+    release(): void;
+}
+export interface AtomRegistryOptions {
+    onStateChange?: (event: {
+        key: string;
+        previous?: AtomInstanceState;
+        state: AtomInstanceState;
+    }) => void;
+}
+/** Runtime-owned, fail-closed catalog of exact Atom versions. */
+export declare class AtomRegistry {
+    private readonly options;
+    private readonly atoms;
+    constructor(options?: AtomRegistryOptions);
+    register<TInput, TOutput>(definition: AtomDefinition<TInput, TOutput>, executionSource?: AtomExecutionSource): Promise<void>;
+    has(id: string, version: string): boolean;
+    isEnabled(id: string, version: string): boolean;
+    get(id: string, version: string): AnyAtomDefinition;
+    acquire<TInput = any, TOutput = any>(id: string, version: string): AtomLease<TInput, TOutput>;
+    disable(id: string, version: string, reason?: string): Promise<void>;
+    disposeAll(reason?: string): Promise<void>;
+    list(query?: AtomRegistryQuery): AtomRegistryEntry[];
+    private requireEnabled;
+    private requireEntry;
+    private startDraining;
+    private emit;
+}
+export {};
+//# sourceMappingURL=atom-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atom-registry.d.ts","sourceRoot":"","sources":["../../src/registry/atom-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,iCAAiC,EACvC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,KAAK,iBAAiB,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAYlD,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAAG,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE;AAE7E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,iCAAiC,CAAC;IACnE,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACpD,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAA;KAAE,KAAK,IAAI,CAAC;CAC1G;AAuDD,iEAAiE;AACjE,qBAAa,YAAY;IAEX,OAAO,CAAC,QAAQ,CAAC,OAAO;IADpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;gBAC1B,OAAO,GAAE,mBAAwB;IAExD,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBlI,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IACzC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAC/C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAEnD,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAmB7F,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,UAAU,CAAC,MAAM,SAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D,IAAI,CAAC,KAAK,GAAE,iBAAsB,GAAG,iBAAiB,EAAE;IAkBxD,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,IAAI;CAGb"}

package/dist/registry/atom-registry.js

@@ -0,0 +1,179 @@
+import { AtomCapabilitySchema, AtomManifestSchema, AtomWorkflowError, PlannerAtomDescriptorSchema, PlannerCatalogIndexAtomDescriptorSchema, atomKey, } from "@atom-workflow-agent/contracts";
+function freezeDeep(value) {
+    if (value === null || typeof value !== "object" || Object.isFrozen(value))
+        return value;
+    for (const nested of Object.values(value))
+        freezeDeep(nested);
+    return Object.freeze(value);
+}
+function invalidAtom(message, cause) {
+    return new AtomWorkflowError("INVALID_ATOM", message, false, cause === undefined ? undefined : { cause });
+}
+function validateDefinition(rawDefinition) {
+    if (rawDefinition === null || typeof rawDefinition !== "object") {
+        throw invalidAtom("Atom Definition must be an object");
+    }
+    const candidate = rawDefinition;
+    const manifestResult = AtomManifestSchema.safeParse(candidate.manifest);
+    if (!manifestResult.success)
+        throw invalidAtom("Atom Definition has an invalid manifest", manifestResult.error);
+    const key = atomKey(manifestResult.data);
+    const capabilityResult = AtomCapabilitySchema.safeParse(candidate.capability);
+    if (!capabilityResult.success)
+        throw invalidAtom(`Atom Definition has an invalid capability: ${key}`, capabilityResult.error);
+    const indexResult = PlannerCatalogIndexAtomDescriptorSchema.safeParse(candidate.catalogIndexDescriptor);
+    if (!indexResult.success)
+        throw invalidAtom(`Atom Definition has an invalid catalog index descriptor: ${key}`, indexResult.error);
+    const plannerResult = PlannerAtomDescriptorSchema.safeParse(candidate.plannerDescriptor);
+    if (!plannerResult.success)
+        throw invalidAtom(`Atom Definition has an invalid Planner descriptor: ${key}`, plannerResult.error);
+    for (const [name, descriptorKey] of [
+        ["capability", capabilityResult.data.key],
+        ["catalog index descriptor", indexResult.data.key],
+        ["Planner descriptor", plannerResult.data.key],
+    ]) {
+        if (descriptorKey !== key)
+            throw invalidAtom(`Atom ${name} key '${descriptorKey}' does not match manifest key '${key}'`);
+    }
+    if (typeof candidate.execute !== "function")
+        throw invalidAtom(`Atom Definition must provide execute(): ${key}`);
+    for (const hook of ["initialize", "resume", "dispose"]) {
+        if (candidate[hook] !== undefined && typeof candidate[hook] !== "function") {
+            throw invalidAtom(`Atom Definition ${hook} must be a function: ${key}`);
+        }
+    }
+    return Object.freeze({
+        manifest: freezeDeep(manifestResult.data),
+        capability: freezeDeep(capabilityResult.data),
+        catalogIndexDescriptor: freezeDeep(indexResult.data),
+        plannerDescriptor: freezeDeep(plannerResult.data),
+        inheritsPackageVersion: candidate.inheritsPackageVersion === true,
+        ...(typeof candidate.initialize === "function" ? { initialize: candidate.initialize.bind(rawDefinition) } : {}),
+        execute: candidate.execute.bind(rawDefinition),
+        ...(typeof candidate.resume === "function" ? { resume: candidate.resume.bind(rawDefinition) } : {}),
+        ...(typeof candidate.dispose === "function" ? { dispose: candidate.dispose.bind(rawDefinition) } : {}),
+    });
+}
+/** Runtime-owned, fail-closed catalog of exact Atom versions. */
+export class AtomRegistry {
+    options;
+    atoms = new Map();
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async register(definition, executionSource) {
+        const rawManifest = definition.manifest;
+        const provisionalKey = rawManifest && typeof rawManifest.id === "string" && typeof rawManifest.version === "string"
+            ? `${rawManifest.id}@${rawManifest.version}` : "unknown@unknown";
+        this.emit(provisionalKey, "discovered");
+        this.emit(provisionalKey, "loading", "discovered");
+        const validated = validateDefinition(definition);
+        const key = atomKey(validated.manifest);
+        this.emit(key, "validated", "loading");
+        if (this.atoms.has(key))
+            throw new AtomWorkflowError("DUPLICATE_ATOM", `Atom already registered: ${key}`);
+        const entry = {
+            definition: validated,
+            ...(executionSource ? { executionSource: Object.freeze({ ...executionSource }) } : {}),
+            state: "registered",
+            activeAttempts: 0,
+        };
+        this.atoms.set(key, entry);
+        this.emit(key, "registered", "validated");
+        entry.state = "enabled";
+        this.emit(key, "enabled", "registered");
+    }
+    has(id, version) { return this.atoms.has(atomKey({ id, version })); }
+    isEnabled(id, version) { return this.atoms.get(atomKey({ id, version }))?.state === "enabled"; }
+    get(id, version) { return this.requireEnabled(id, version).definition; }
+    acquire(id, version) {
+        const entry = this.requireEnabled(id, version);
+        entry.activeAttempts += 1;
+        let released = false;
+        return {
+            definition: entry.definition,
+            ...(entry.executionSource ? { executionSource: entry.executionSource } : {}),
+            release: () => {
+                if (released)
+                    return;
+                released = true;
+                entry.activeAttempts -= 1;
+                if (entry.activeAttempts === 0 && entry.state === "draining") {
+                    entry.resolveDrained?.();
+                    delete entry.resolveDrained;
+                }
+            },
+        };
+    }
+    disable(id, version, reason) {
+        const entry = this.requireEntry(id, version);
+        const normalizedReason = reason?.trim();
+        if (normalizedReason)
+            entry.disabledReason = normalizedReason;
+        return this.startDraining(atomKey({ id, version }), entry);
+    }
+    async disposeAll(reason = "runtime shutdown") {
+        const results = await Promise.allSettled([...this.atoms.entries()].map(([key, entry]) => {
+            if (!entry.disabledReason)
+                entry.disabledReason = reason;
+            return this.startDraining(key, entry);
+        }));
+        const failures = results.filter((result) => result.status === "rejected");
+        if (failures.length > 0)
+            throw new AggregateError(failures.map((failure) => failure.reason), "One or more Atom instances failed to dispose");
+    }
+    list(query = {}) {
+        return [...this.atoms.values()]
+            .filter((entry) => query.includeDisabled === true || entry.state === "enabled")
+            .filter((entry) => query.id === undefined || entry.definition.manifest.id === query.id)
+            .sort((left, right) => atomKey(left.definition.manifest).localeCompare(atomKey(right.definition.manifest)))
+            .map((entry) => ({
+            manifest: entry.definition.manifest,
+            capability: entry.definition.capability,
+            catalogIndexDescriptor: entry.definition.catalogIndexDescriptor,
+            plannerDescriptor: entry.definition.plannerDescriptor,
+            state: entry.state,
+            enabled: entry.state === "enabled",
+            activeAttempts: entry.activeAttempts,
+            ...(entry.executionSource ? { executionSource: entry.executionSource } : {}),
+            ...(entry.disabledReason ? { disabledReason: entry.disabledReason } : {}),
+        }));
+    }
+    requireEnabled(id, version) {
+        const key = atomKey({ id, version });
+        const entry = this.requireEntry(id, version);
+        if (entry.state !== "enabled") {
+            const suffix = entry.disabledReason ? ` (${entry.disabledReason})` : "";
+            throw new AtomWorkflowError("ATOM_UNAVAILABLE", `Atom is ${entry.state}: ${key}${suffix}`);
+        }
+        return entry;
+    }
+    requireEntry(id, version) {
+        const key = atomKey({ id, version });
+        const entry = this.atoms.get(key);
+        if (!entry)
+            throw new AtomWorkflowError("ATOM_NOT_FOUND", `Atom not found: ${key}`);
+        return entry;
+    }
+    startDraining(key, entry) {
+        if (entry.shutdownPromise)
+            return entry.shutdownPromise;
+        if (entry.state === "disposed")
+            return Promise.resolve();
+        const previous = entry.state;
+        entry.state = "draining";
+        this.emit(key, "draining", previous);
+        entry.shutdownPromise = (async () => {
+            if (entry.activeAttempts > 0)
+                await new Promise((resolve) => { entry.resolveDrained = resolve; });
+            const current = entry.state;
+            entry.state = "disposed";
+            this.emit(key, "disposed", current);
+        })();
+        return entry.shutdownPromise;
+    }
+    emit(key, state, previous) {
+        this.options.onStateChange?.({ key, state, ...(previous ? { previous } : {}) });
+    }
+}
+//# sourceMappingURL=atom-registry.js.map

package/dist/registry/atom-registry.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@atom-workflow-agent/atom-catalog",
+  "version": "0.1.0",
+  "description": "Discovery, validation, loading, and leasing of exact atom definitions.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joekbits/atom-workflow-agent.git",
+    "directory": "packages/atom-catalog"
+  },
+  "homepage": "https://github.com/joekbits/atom-workflow-agent/tree/main/packages/atom-catalog#readme",
+  "bugs": {
+    "url": "https://github.com/joekbits/atom-workflow-agent/issues"
+  },
+  "keywords": [
+    "atom",
+    "workflow",
+    "catalog",
+    "registry"
+  ],
+  "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": {
+    "zod": "^4.0.0",
+    "@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"
+  }
+}