@chopin-ai/core 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 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/dist/cli.d.ts

@@ -0,0 +1,16 @@
+export interface CliIo {
+    out(text: string): void;
+    err(text: string): void;
+}
+/** A `chopin` subcommand; `name` may span several words, such as `layer check`. */
+export interface Command {
+    name: string;
+    /** Its arguments, as shown in the usage. */
+    args: string;
+    summary: string;
+    /** @returns The process exit code. */
+    run(args: readonly string[], io: CliIo): Promise<number>;
+}
+export declare const coreCommands: readonly Command[];
+/** @returns The process exit code. */
+export declare function runCli(argv: readonly string[], io: CliIo, commands?: readonly Command[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,43 @@
+import { resolve } from "node:path";
+import { loadLayer } from "./layer/layer.js";
+export const coreCommands = [{
+        name: "layer check",
+        args: "<dir>",
+        summary: "validate a mutable layer directory",
+        run: async (args, io) => {
+            if (args.length !== 1)
+                return usageError(io, "layer check <dir>");
+            return layerCheck(resolve(args[0] ?? ""), io);
+        },
+    }];
+/** @returns The process exit code. */
+export async function runCli(argv, io, commands = coreCommands) {
+    const command = commands.find((c) => c.name.split(" ").every((word, i) => argv[i] === word));
+    if (command !== undefined)
+        return command.run(argv.slice(command.name.split(" ").length), io);
+    const asked = argv.length === 0 || ["help", "--help", "-h"].includes(argv[0] ?? "");
+    const usage = ["usage: chopin <command>", "", "commands:", ...commands.flatMap((c) => [`  ${c.name} ${c.args}`.trimEnd(), `      ${c.summary}`])];
+    (asked ? io.out : io.err)(usage.join("\n"));
+    return asked ? 0 : 2;
+}
+function usageError(io, usage) {
+    io.err(`usage: chopin ${usage}`);
+    return 2;
+}
+async function layerCheck(directory, io) {
+    const result = await loadLayer(directory);
+    if (!result.ok) {
+        for (const problem of result.problems)
+            io.err(problem);
+        return 1;
+    }
+    const { instructions, skills, mcpServers, gates } = result.layer;
+    io.out([
+        `instructions: ${instructions === undefined ? "none" : "AGENTS.md"}`,
+        `skills: ${skills.map((s) => s.name).join(", ") || "none"}`,
+        `mcp servers: ${Object.keys(mcpServers).join(", ") || "none"}`,
+        `gate rules: ${gates.length}`,
+    ].join("\n"));
+    return 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { coreCommands, runCli } from "./cli.js";
+export type { CliIo, Command } from "./cli.js";
+export { checkGates, gateRefusal, unmetGates } from "./layer/gates.js";
+export type { GateRule } from "./layer/gates.js";
+export { loadLayer } from "./layer/layer.js";
+export type { Layer, LayerResult } from "./layer/layer.js";
+export { isMcpToolOf, mcpToolName } from "./layer/mcp.js";
+export type { McpServer } from "./layer/mcp.js";
+export { skillBody } from "./layer/skills.js";
+export type { Skill } from "./layer/skills.js";
+export { chopinMeta, META_KEY, withChopinMeta } from "./meta.js";
+export type { ChopinMeta } from "./meta.js";
+export { appendTranscript, parseTranscript, readTranscript } from "./transcript.js";
+export type { TaskRun, TranscriptEntry } from "./transcript.js";

package/dist/index.js

@@ -0,0 +1,8 @@
+export { coreCommands, runCli } from "./cli.js";
+export { checkGates, gateRefusal, unmetGates } from "./layer/gates.js";
+export { loadLayer } from "./layer/layer.js";
+export { isMcpToolOf, mcpToolName } from "./layer/mcp.js";
+export { skillBody } from "./layer/skills.js";
+export { chopinMeta, META_KEY, withChopinMeta } from "./meta.js";
+export { appendTranscript, parseTranscript, readTranscript } from "./transcript.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,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/layer/gates.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A call to `tool` is refused until every tool in `requires` has completed successfully earlier in the same
+ * session. What counts is the tool-call record, never the model's account of what it did.
+ */
+export interface GateRule {
+    tool: string;
+    requires: string[];
+    /** Shown to the model when the call is refused. */
+    reason: string;
+}
+export declare function parseGates(value: unknown, source: string, problems: string[]): GateRule[];
+/** The rules that refuse a call to `tool`, given the tools that have succeeded so far. */
+export declare function unmetGates(rules: readonly GateRule[], tool: string, succeeded: ReadonlySet<string>): GateRule[];
+/** Why a call is refused: any required tool that is not registered, then each unmet rule's reason. */
+export declare function gateRefusal(unmet: readonly GateRule[], registered: ReadonlySet<string>): string;
+/**
+ * Configuration errors against the tools actually registered. A gate on a tool nobody can satisfy would refuse
+ * forever, so it is an error rather than an ordinary refusal.
+ */
+export declare function checkGates(rules: readonly GateRule[], registered: ReadonlySet<string>): string[];

package/dist/layer/gates.js

@@ -0,0 +1,37 @@
+export function parseGates(value, source, problems) {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value)) {
+        problems.push(`${source}: expected a list of gate rules`);
+        return [];
+    }
+    return value.flatMap((rule, index) => {
+        const { tool, requires, reason } = (typeof rule === "object" && rule !== null ? rule : {});
+        const valid = typeof tool === "string" && tool !== "" && typeof reason === "string" && reason !== ""
+            && Array.isArray(requires) && requires.length > 0 && requires.every((r) => typeof r === "string" && r !== "");
+        if (!valid) {
+            problems.push(`${source}[${index}]: a gate rule needs a tool, a non-empty requires list and a reason`);
+            return [];
+        }
+        return [{ tool, requires: requires, reason }];
+    });
+}
+/** The rules that refuse a call to `tool`, given the tools that have succeeded so far. */
+export function unmetGates(rules, tool, succeeded) {
+    return rules.filter((rule) => rule.tool === tool && rule.requires.some((required) => !succeeded.has(required)));
+}
+/** Why a call is refused: any required tool that is not registered, then each unmet rule's reason. */
+export function gateRefusal(unmet, registered) {
+    return [...checkGates(unmet, registered), ...unmet.map((rule) => rule.reason)].join("\n");
+}
+/**
+ * Configuration errors against the tools actually registered. A gate on a tool nobody can satisfy would refuse
+ * forever, so it is an error rather than an ordinary refusal.
+ */
+export function checkGates(rules, registered) {
+    return rules.flatMap((rule) => [
+        ...(registered.has(rule.tool) ? [] : [`gate on ${rule.tool}: no such tool`]),
+        ...rule.requires.filter((r) => !registered.has(r)).map((r) => `gate on ${rule.tool}: requires ${r}, which no tool provides`),
+    ]);
+}
+//# sourceMappingURL=gates.js.map

package/dist/layer/gates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.js","sourceRoot":"","sources":["../../src/layer/gates.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,MAAc,EAAE,QAAkB;IAC3E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,iCAAiC,CAAC,CAAC;QAC1D,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAa,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;QACtH,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE;eAC/F,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAChH,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,KAAK,qEAAqE,CAAC,CAAC;YACvG,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAoB,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,KAA0B,EAAE,IAAY,EAAE,SAA8B;IACjG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAClH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,WAAW,CAAC,KAA0B,EAAE,UAA+B;IACrF,OAAO,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAA0B,EAAE,UAA+B;IACpF,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,gBAAgB,CAAC,CAAC;QAC5E,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,IAAI,CAAC,IAAI,cAAc,CAAC,0BAA0B,CAAC;KAC7H,CAAC,CAAC;AACL,CAAC"}

package/dist/layer/layer.d.ts

@@ -0,0 +1,28 @@
+import { type GateRule } from "./gates.js";
+import { type McpServer } from "./mcp.js";
+import { type Skill } from "./skills.js";
+/**
+ * The portable tier of the mutable layer: everything in it is an open format that both harnesses load the
+ * same way. A layer is a directory:
+ *
+ *   AGENTS.md          instructions
+ *   skills/<name>/     Agent Skills
+ *   mcp.json           MCP servers
+ *   gates.yaml         gate rules
+ *
+ * Every file is optional; an empty directory is an empty layer.
+ */
+export interface Layer {
+    instructions: string | undefined;
+    skills: Skill[];
+    mcpServers: Record<string, McpServer>;
+    gates: GateRule[];
+}
+export type LayerResult = {
+    ok: true;
+    layer: Layer;
+} | {
+    ok: false;
+    problems: string[];
+};
+export declare function loadLayer(directory: string): Promise<LayerResult>;

package/dist/layer/layer.js

@@ -0,0 +1,37 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse } from "yaml";
+import { parseGates } from "./gates.js";
+import { parseMcpServers } from "./mcp.js";
+import { loadSkills } from "./skills.js";
+export async function loadLayer(directory) {
+    const problems = [];
+    const instructions = await optional(join(directory, "AGENTS.md"));
+    const skills = await loadSkills(join(directory, "skills"), problems);
+    const mcpServers = parseMcpServers(await structured(join(directory, "mcp.json"), JSON.parse, problems), "mcp.json", problems);
+    const gates = parseGates(await structured(join(directory, "gates.yaml"), parse, problems), "gates.yaml", problems);
+    return problems.length === 0 ? { ok: true, layer: { instructions, skills, mcpServers, gates } } : { ok: false, problems };
+}
+async function optional(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+async function structured(path, decode, problems) {
+    const text = await optional(path);
+    if (text === undefined)
+        return undefined;
+    try {
+        return decode(text);
+    }
+    catch (error) {
+        problems.push(`${path}: ${error.message}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=layer.js.map

package/dist/layer/layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.js","sourceRoot":"","sources":["../../src/layer/layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,eAAe,EAAkB,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAsBrD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9H,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IACnH,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC5H,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACzE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,MAAiC,EAAE,QAAkB;IAC3F,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/layer/mcp.d.ts

@@ -0,0 +1,19 @@
+/** An MCP server entry, in the `mcpServers` shape most agents already read; both harnesses speak these two transports. */
+export type McpServer = {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+} | {
+    type: "http";
+    url: string;
+    headers?: Record<string, string>;
+};
+export declare function parseMcpServers(value: unknown, source: string, problems: string[]): Record<string, McpServer>;
+/**
+ * The model-facing name of an MCP tool, `mcp__<server>__<tool>`, as both harnesses spell it: provider function names
+ * allow only `[A-Za-z0-9_-]` and 64 characters, and a name that had to change gains a hash of its identity so two
+ * tools never collapse into one. Gate rules name MCP tools this way.
+ */
+export declare function mcpToolName(server: string, tool: string): string;
+/** Whether `tool` names a tool of `server`, a server name the layer accepts. */
+export declare function isMcpToolOf(server: string, tool: string): boolean;

package/dist/layer/mcp.js

@@ -0,0 +1,93 @@
+import { createHash } from "node:crypto";
+import { isVariableName } from "@chopin-ai/workspace";
+export function parseMcpServers(value, source, problems) {
+    if (value === undefined)
+        return {};
+    const servers = value?.mcpServers;
+    if (typeof servers !== "object" || servers === null || Array.isArray(servers)) {
+        problems.push(`${source}: expected an object with mcpServers`);
+        return {};
+    }
+    const parsed = {};
+    for (const [name, server] of Object.entries(servers)) {
+        const problem = serverProblem(name, server);
+        if (problem === undefined)
+            parsed[name] = server;
+        else
+            problems.push(`${source}: server ${name} ${problem}`);
+    }
+    return parsed;
+}
+/**
+ * Server names every harness accepts. Without `__` or a trailing `_`, `mcp__<server>__` also names exactly one
+ * server in any tool name.
+ */
+const SERVER_NAME = /^(?!.*__)[A-Za-z0-9_-]{0,31}[A-Za-z0-9-]$/;
+/** An HTTP field name: a token. */
+const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
+function serverProblem(name, server) {
+    if (!SERVER_NAME.test(name))
+        return 'needs a name of 1 to 32 letters, digits, "_" or "-", without "__" or a trailing "_"';
+    const entry = (typeof server === "object" && server !== null ? server : {});
+    if (entry.type === "sse")
+        return "uses SSE, which not every harness speaks; use type http (Streamable HTTP)";
+    if (typeof entry.command === "string") {
+        if (entry.command === "")
+            return "needs a command";
+        if (entry.args !== undefined && !strings(entry.args))
+            return "needs args as a list of strings";
+        if (entry.env !== undefined && !textRecord(entry.env))
+            return "needs env as an object of string values";
+        const env = (entry.env ?? {});
+        const name = Object.keys(env).find((key) => !isVariableName(key));
+        if (name !== undefined) {
+            return `needs env names of letters, digits and "_", not starting with a digit, other than "_" and those starting with CHOPIN_ENV_, which ${JSON.stringify(name)} is not`;
+        }
+        if ([entry.command, ...(entry.args ?? []), ...Object.values(env)].some(hasNul))
+            return "holds a NUL character, which no program can be given";
+        return undefined;
+    }
+    if (entry.type === "http" && typeof entry.url === "string") {
+        if (!/^https?:$/.test(URL.parse(entry.url)?.protocol ?? ""))
+            return `needs an http or https url, not ${entry.url}`;
+        if (entry.headers !== undefined && !textRecord(entry.headers))
+            return "needs headers as an object of string values";
+        const header = Object.keys((entry.headers ?? {})).find((key) => !HEADER_NAME.test(key));
+        if (header !== undefined)
+            return `needs header names an HTTP request can carry, which ${JSON.stringify(header)} is not`;
+        const value = Object.entries((entry.headers ?? {})).find(([, text]) => /[^\t\x20-\x7e]/.test(text));
+        if (value !== undefined)
+            return `needs header values an HTTP request can carry, which that of ${JSON.stringify(value[0])} is not`;
+        return undefined;
+    }
+    return "needs a command, or type http with a url";
+}
+function strings(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function textRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) && Object.values(value).every((item) => typeof item === "string");
+}
+function hasNul(text) {
+    return text.includes("\0");
+}
+const NAME_LIMIT = 64;
+const INVALID = /[^A-Za-z0-9_-]/g;
+/**
+ * The model-facing name of an MCP tool, `mcp__<server>__<tool>`, as both harnesses spell it: provider function names
+ * allow only `[A-Za-z0-9_-]` and 64 characters, and a name that had to change gains a hash of its identity so two
+ * tools never collapse into one. Gate rules name MCP tools this way.
+ */
+export function mcpToolName(server, tool) {
+    const joined = `mcp__${server}__${tool}`;
+    const normalized = joined.replace(INVALID, "_");
+    if (normalized === joined && normalized.length <= NAME_LIMIT)
+        return normalized;
+    const hash = createHash("sha256").update(`${server}\0${tool}`).digest("hex").slice(0, 12);
+    return `${normalized.slice(0, NAME_LIMIT - 12 - 1)}_${hash}`;
+}
+/** Whether `tool` names a tool of `server`, a server name the layer accepts. */
+export function isMcpToolOf(server, tool) {
+    return tool.startsWith(`mcp__${server}__`);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/layer/mcp.js.map

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

package/dist/layer/skills.d.ts

@@ -0,0 +1,10 @@
+/** A skill in the Agent Skills format. Agents get the index; they read the body themselves when it applies. */
+export interface Skill {
+    name: string;
+    description: string;
+    /** The skill's directory, holding `SKILL.md` and whatever it bundles. */
+    directory: string;
+}
+export declare function loadSkills(root: string, problems: string[]): Promise<Skill[]>;
+/** A skill's instructions as the model reads them, the same on every harness: its SKILL.md without the frontmatter. */
+export declare function skillBody(text: string): string;

package/dist/layer/skills.js

@@ -0,0 +1,60 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse } from "yaml";
+const NAME = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+export async function loadSkills(root, problems) {
+    const entries = await readdir(root, { withFileTypes: true }).catch(missing);
+    const skills = [];
+    for (const entry of entries.filter((e) => e.isDirectory()).sort((a, b) => a.name.localeCompare(b.name))) {
+        const directory = join(root, entry.name);
+        const file = join(directory, "SKILL.md");
+        const text = await readFile(file, "utf8").catch((error) => {
+            problems.push(error.code === "ENOENT" ? `${file}: missing` : `${file}: ${error.message}`);
+            return undefined;
+        });
+        if (text === undefined)
+            continue;
+        const skill = parseSkill(text, entry.name, file, problems);
+        if (skill !== undefined)
+            skills.push({ ...skill, directory });
+    }
+    return skills;
+}
+function parseSkill(text, directoryName, file, problems) {
+    const match = FRONTMATTER.exec(text);
+    if (match === null) {
+        problems.push(`${file}: no YAML frontmatter`);
+        return undefined;
+    }
+    let front;
+    try {
+        front = parse(match[1] ?? "");
+    }
+    catch (error) {
+        problems.push(`${file}: frontmatter is not valid YAML: ${error.message}`);
+        return undefined;
+    }
+    const { name, description } = (typeof front === "object" && front !== null ? front : {});
+    const before = problems.length;
+    if (typeof name !== "string" || name.length > 64 || !NAME.test(name)) {
+        problems.push(`${file}: name must be 1-64 lowercase letters, digits and single hyphens`);
+    }
+    else if (name !== directoryName) {
+        problems.push(`${file}: name "${name}" must match its directory "${directoryName}"`);
+    }
+    if (typeof description !== "string" || description.trim() === "" || description.length > 1024) {
+        problems.push(`${file}: description must be 1-1024 characters`);
+    }
+    return problems.length === before ? { name: name, description: description } : undefined;
+}
+function missing(error) {
+    if (error.code === "ENOENT")
+        return [];
+    throw error;
+}
+const FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;
+/** A skill's instructions as the model reads them, the same on every harness: its SKILL.md without the frontmatter. */
+export function skillBody(text) {
+    return text.replace(FRONTMATTER, "");
+}
+//# sourceMappingURL=skills.js.map

package/dist/layer/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/layer/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAU7B,MAAM,IAAI,GAAG,0BAA0B,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,QAAkB;IAC/D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACxG,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;YAC/E,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1F,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,aAAqB,EAAE,IAAY,EAAE,QAAkB;IACvF,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,uBAAuB,CAAC,CAAC;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,oCAAqC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;IACpH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,kEAAkE,CAAC,CAAC;IAC3F,CAAC;SAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,WAAW,IAAI,+BAA+B,aAAa,GAAG,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QAC9F,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,yCAAyC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAc,EAAE,WAAW,EAAE,WAAqB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/G,CAAC;AAED,SAAS,OAAO,CAAC,KAA4B;IAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,KAAK,CAAC;AACd,CAAC;AAED,MAAM,WAAW,GAAG,wCAAwC,CAAC;AAE7D,uHAAuH;AACvH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/dist/meta.d.ts

@@ -0,0 +1,18 @@
+/** Namespaced key under ACP's `_meta` for the facts evaluation needs and ACP does not carry. */
+export declare const META_KEY = "chopin-ai";
+export interface ChopinMeta {
+    /** The model that produced a turn, so results can be compared per model. */
+    model?: {
+        provider: string;
+        id: string;
+    };
+    /** What the turn cost, in ACP's own cost shape. */
+    cost?: {
+        amount: number;
+        currency: string;
+    };
+    /** Why the turn ended without an answer. */
+    error?: string;
+}
+export declare function withChopinMeta<T extends object>(value: T, meta: ChopinMeta): T;
+export declare function chopinMeta(value: object): ChopinMeta | undefined;

package/dist/meta.js

@@ -0,0 +1,10 @@
+/** Namespaced key under ACP's `_meta` for the facts evaluation needs and ACP does not carry. */
+export const META_KEY = "chopin-ai";
+export function withChopinMeta(value, meta) {
+    const existing = value._meta;
+    return { ...value, _meta: { ...existing, [META_KEY]: meta } };
+}
+export function chopinMeta(value) {
+    return value._meta?.[META_KEY];
+}
+//# sourceMappingURL=meta.js.map

package/dist/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAapC,MAAM,UAAU,cAAc,CAAmB,KAAQ,EAAE,IAAgB;IACzE,MAAM,QAAQ,GAAI,KAA0B,CAAC,KAAK,CAAC;IACnD,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAQ,KAA0B,CAAC,KAAK,EAAE,CAAC,QAAQ,CAA2B,CAAC;AACjF,CAAC"}

package/dist/transcript.d.ts

@@ -0,0 +1,21 @@
+import type { PromptResponse, SessionNotification } from "@agentclientprotocol/sdk";
+/** One line of a transcript: something the agent reported, or how a turn ended. Both are plain ACP. */
+export type TranscriptEntry = {
+    at: string;
+    notification: SessionNotification;
+} | {
+    at: string;
+    sessionId: string;
+    turnEnd: PromptResponse;
+};
+/** Transcripts are JSON Lines, appended as the run goes so a crash loses at most the line being written. */
+export declare function appendTranscript(path: string, entry: TranscriptEntry): Promise<void>;
+export declare function readTranscript(path: string): Promise<TranscriptEntry[]>;
+/** The entries of a transcript's text; a last line without its newline is one a crash cut short. */
+export declare function parseTranscript(text: string): TranscriptEntry[];
+/** What one task run leaves behind: its transcript, and the patch it made to the workspace's git work tree. */
+export interface TaskRun {
+    transcript: TranscriptEntry[];
+    /** The patch as git wrote it, bytes and all; `undefined` when the workspace is not a git work tree. */
+    diff: Uint8Array | undefined;
+}

package/dist/transcript.js

@@ -0,0 +1,13 @@
+import { appendFile, readFile } from "node:fs/promises";
+/** Transcripts are JSON Lines, appended as the run goes so a crash loses at most the line being written. */
+export async function appendTranscript(path, entry) {
+    await appendFile(path, `${JSON.stringify(entry)}\n`);
+}
+export async function readTranscript(path) {
+    return parseTranscript(await readFile(path, "utf8"));
+}
+/** The entries of a transcript's text; a last line without its newline is one a crash cut short. */
+export function parseTranscript(text) {
+    return text.split("\n").slice(0, -1).filter((line) => line !== "").map((line) => JSON.parse(line));
+}
+//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQxD,4GAA4G;AAC5G,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAsB;IACzE,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,OAAO,eAAe,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC,CAAC;AACxH,CAAC"}

package/package.json

@@ -1,6 +1,29 @@
 {
   "name": "@chopin-ai/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Harness-agnostic core: mutable-layer formats, ACP transcripts and the chopin command registry",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CodePrometheus/chopin-ai.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=24.8.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^1.9.0",
+    "@chopin-ai/workspace": "^0.2.0",
+    "yaml": "^2.9.1"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.