@chopin-ai/harness-dsh 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/acp.d.ts

@@ -0,0 +1,5 @@
+import type { SessionUpdate, StopReason } from "@agentclientprotocol/sdk";
+import type { SessionEvent, TurnEndReason } from "@deepseek-ai/dsh-session";
+/** What one session event says, in ACP. Events the model never sees say nothing. */
+export declare function eventUpdates(event: SessionEvent): SessionUpdate[];
+export declare function stopReason(reason: TurnEndReason): StopReason;

package/dist/acp.js

@@ -0,0 +1,65 @@
+/** What one session event says, in ACP. Events the model never sees say nothing. */
+export function eventUpdates(event) {
+    switch (event.type) {
+        case "user/message":
+            // Context the harness injects as user-role messages is not what the user said.
+            if (event.data.source.kind !== "user")
+                return [];
+            return texts(event.data.content).map((text) => ({ sessionUpdate: "user_message_chunk", content: { type: "text", text } }));
+        case "assistant/message":
+            return event.data.message.content.flatMap((block) => {
+                if (block.type === "text")
+                    return [{ sessionUpdate: "agent_message_chunk", content: { type: "text", text: block.text ?? "" } }];
+                if (block.type === "reasoning")
+                    return [{ sessionUpdate: "agent_thought_chunk", content: { type: "text", text: block.text ?? "" } }];
+                if (block.type !== "tool-call")
+                    return [];
+                return [{
+                        sessionUpdate: "tool_call", toolCallId: block.id ?? "", title: block.name ?? "", kind: toolKind(block.name ?? ""),
+                        status: "pending", rawInput: parsed(block.arguments),
+                    }];
+            });
+        case "tool/result":
+            return [{
+                    sessionUpdate: "tool_call_update", toolCallId: event.data.message.toolCallId,
+                    status: event.data.message.isError === true ? "failed" : "completed",
+                    content: texts(event.data.message.content).map((text) => ({ type: "content", content: { type: "text", text } })),
+                }];
+        default:
+            return [];
+    }
+}
+export function stopReason(reason) {
+    if (reason.kind === "aborted")
+        return "cancelled";
+    if (reason.kind === "max-tokens")
+        return "max_tokens";
+    if (reason.kind === "blocked")
+        return "refusal";
+    return "end_turn";
+}
+function texts(content) {
+    return content.flatMap((block) => (block.type === "text" && block.text !== undefined ? [block.text] : []));
+}
+/** ACP's kind of each built-in tool, a hint clients use to present the call. */
+const KINDS = {
+    read: "read", read_image: "read", skill: "read",
+    glob: "search", grep: "search",
+    write: "edit", edit: "edit", str_replace_editor: "edit",
+    bash: "execute",
+};
+function toolKind(name) {
+    return Object.hasOwn(KINDS, name) ? KINDS[name] : "other";
+}
+/** Tool arguments travel as the model's JSON text; text that does not parse is kept as it is. */
+function parsed(text) {
+    if (text === undefined)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=acp.js.map

package/dist/acp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.js","sourceRoot":"","sources":["../src/acp.ts"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,cAAc;YACjB,+EAA+E;YAC/E,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,oBAAoB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7H,KAAK,mBAAmB;YACtB,OAAQ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAA4B,CAAC,OAAO,CAAC,CAAC,KAAK,EAAmB,EAAE;gBACzF,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,CAAC,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBAChI,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;oBAAE,OAAO,CAAC,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBACrI,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;oBAAE,OAAO,EAAE,CAAC;gBAC1C,OAAO,CAAC;wBACN,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;wBACjH,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;qBACrD,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,KAAK,aAAa;YAChB,OAAO,CAAC;oBACN,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU;oBAC5E,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;oBACpE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;iBACjH,CAAC,CAAC;QACL;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAClD,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IACtD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,KAAK,CAAC,OAA2B;IACxC,OAAQ,OAA4B,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnI,CAAC;AAED,gFAAgF;AAChF,MAAM,KAAK,GAAuC;IAChD,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAC/C,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ;IAC9B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM;IACvD,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,IAAI,CAAc,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1E,CAAC;AAED,iGAAiG;AACjG,SAAS,MAAM,CAAC,IAAwB;IACtC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+/** The plugin harness adapter. The harness's loader reads the plugin from this entry: `name`, `inject`, `Config`, `apply`. */
+export { apply, Config, inject, name } from "./plugin.js";
+export { eventUpdates } from "./acp.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+/** The plugin harness adapter. The harness's loader reads the plugin from this entry: `name`, `inject`, `Config`, `apply`. */
+export { apply, Config, inject, name } from "./plugin.js";
+export { eventUpdates } from "./acp.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,8HAA8H;AAC9H,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from "@deepseek-ai/cordis";
+import Schema from "@deepseek-ai/schemastery";
+declare module "@deepseek-ai/dsh-session-projection/types" {
+    interface SessionProjectionStateMap {
+        "chopin.succeeded": {
+            calls: Record<string, string>;
+            tools: string[];
+        };
+    }
+}
+export declare const name = "@chopin-ai/harness-dsh";
+export declare const inject: string[];
+export interface Config {
+    /** The mutable layer directory. */
+    layer: string;
+    /** Where each session's ACP transcript is written, one `<session>.jsonl` per session. */
+    transcripts?: string;
+}
+export declare const Config: Schema<Config>;
+/** Loads the portable layer into the harness: instructions, skills, MCP servers and gates, and records transcripts in ACP. */
+export declare function apply(ctx: Context, config: Config): Promise<void>;

package/dist/plugin.js

@@ -0,0 +1,180 @@
+import { appendFile, mkdir, readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { gateRefusal, loadLayer, skillBody, unmetGates, withChopinMeta } from "@chopin-ai/core";
+import * as McpClient from "@deepseek-ai/dsh-mcp-client";
+import Schema from "@deepseek-ai/schemastery";
+import { z } from "zod";
+import { eventUpdates, stopReason } from "./acp.js";
+export const name = "@chopin-ai/harness-dsh";
+export const inject = ["tools", "systemPrompt", "skills", "sessionProjections"];
+export const Config = Schema.object({
+    layer: Schema.string().required().description("The mutable layer directory"),
+    transcripts: Schema.string().description("Directory receiving one ACP transcript per session"),
+});
+/** Loads the portable layer into the harness: instructions, skills, MCP servers and gates, and records transcripts in ACP. */
+export async function apply(ctx, config) {
+    const result = await loadLayer(resolve(config.layer));
+    if (!result.ok)
+        throw new Error(`invalid layer ${config.layer}:\n${result.problems.join("\n")}`);
+    const { instructions, skills, mcpServers, gates } = result.layer;
+    if (instructions !== undefined) {
+        ctx.systemPrompt.section({ name: "chopin:guidance", order: 9000, text: instructions, interpolate: false });
+    }
+    if (skills.length > 0)
+        ctx.skills.registerProvider(() => skillProvider(skills));
+    for (const [serverName, server] of Object.entries(mcpServers))
+        ctx.plugin(McpClient, mcpConfig(serverName, server));
+    if (gates.length > 0)
+        enforceGates(ctx, gates);
+    if (config.transcripts !== undefined)
+        recordTranscripts(ctx, resolve(config.transcripts));
+}
+function skillProvider(skills) {
+    const candidates = skills.map((skill) => ({
+        name: skill.name,
+        description: skill.description,
+        path: join(skill.directory, "SKILL.md"),
+        invocation: { modelInvocable: true, userInvocable: true },
+        source: "custom",
+        provider: "chopin-layer",
+        resourceBase: { kind: "directory", path: skill.directory },
+        rank: 0,
+        locator: skill.directory,
+    }));
+    return {
+        name: "chopin-layer",
+        list: async () => candidates,
+        get: async (candidate) => {
+            const text = await readFile(join(candidate.locator, "SKILL.md"), "utf8");
+            return { ...candidate, content: skillBody(text) };
+        },
+    };
+}
+function mcpConfig(serverName, server) {
+    if ("command" in server)
+        return { transport: "stdio", serverName, command: server.command, args: server.args ?? [], env: server.env ?? {} };
+    return { transport: "streamable-http", serverName, url: server.url, headers: server.headers ?? {} };
+}
+/**
+ * Gates read which tools have succeeded from the session log, through a projection that resume and fork replay,
+ * and refuse through the monotonic guard, which no later listener can relax.
+ */
+function enforceGates(ctx, gates) {
+    ctx.sessionProjections.register({
+        key: "chopin.succeeded",
+        stateVersion: 1,
+        stateSchema: z.object({ calls: z.record(z.string(), z.string()), tools: z.array(z.string()) }),
+        init: () => ({ calls: {}, tools: [] }),
+        apply: (state, event) => {
+            if (event.type === "tool/call")
+                return { ...state, calls: { ...state.calls, [event.data.callId]: event.data.name } };
+            if (event.type !== "tool/result")
+                return state;
+            const { [event.data.message.toolCallId]: tool, ...calls } = state.calls;
+            const succeeded = tool !== undefined && event.data.message.isError !== true && !state.tools.includes(tool);
+            return { calls, tools: succeeded ? [...state.tools, tool] : state.tools };
+        },
+    });
+    ctx.tools.guard((execution) => {
+        const session = execution.agent?.session;
+        if (session === undefined)
+            return undefined;
+        const succeeded = new Set(ctx.sessionProjections.stateOf(session, "chopin.succeeded")?.tools ?? []);
+        const unmet = unmetGates(gates, execution.name, succeeded);
+        if (unmet.length === 0)
+            return undefined;
+        const registered = new Set(unmet.flatMap((rule) => [rule.tool, ...rule.requires]).filter((tool) => ctx.tools.get(tool) !== undefined));
+        return gateRefusal(unmet, registered);
+    });
+}
+/** Writes each session as ACP, appended in order as its events commit. */
+function recordTranscripts(ctx, directory) {
+    const writes = new Map();
+    // The folder is made once, and made again should it fail or go away.
+    let made;
+    const folder = () => (made ??= mkdir(directory, { recursive: true }).then(() => { }, (error) => {
+        made = undefined;
+        throw error;
+    }));
+    const append = async (file, text) => {
+        await folder();
+        try {
+            await appendFile(file, text);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            made = undefined;
+            await folder();
+            await appendFile(file, text);
+        }
+    };
+    const turns = new Map();
+    ctx.on("session/event", (session, event) => {
+        const sessionId = String(session.id);
+        const at = new Date(event.time).toISOString();
+        const entries = eventUpdates(event).map((update) => ({ at, notification: { sessionId, update } }));
+        if (event.type === "assistant/message") {
+            const turn = turns.get(sessionId) ?? { messages: [], usage: emptyUsage() };
+            turn.messages.push(event.data.message.source);
+            add(turn.usage, event.data.usage);
+            turns.set(sessionId, turn);
+        }
+        if (event.type === "turn/end") {
+            const turn = turns.get(sessionId);
+            turns.delete(sessionId);
+            const last = turn?.messages.at(-1);
+            entries.push({
+                at, sessionId,
+                turnEnd: withChopinMeta({ stopReason: stopReason(event.data.reason), usage: turn?.usage ?? emptyUsage() }, {
+                    ...(last && { model: { provider: last.provider, id: last.model } }),
+                    ...(turnError(event.data.reason) !== undefined && { error: turnError(event.data.reason) }),
+                }),
+            });
+        }
+        if (entries.length === 0)
+            return;
+        const text = entries.map((entry) => `${JSON.stringify(entry)}\n`).join("");
+        const file = join(directory, `${sessionId}.jsonl`);
+        const previous = writes.get(sessionId) ?? Promise.resolve();
+        const next = previous.then(() => append(file, text)).catch((error) => {
+            ctx.logger.warn("transcript %s: %s", sessionId, String(error));
+        }).finally(() => {
+            if (writes.get(sessionId) === next)
+                writes.delete(sessionId);
+        });
+        writes.set(sessionId, next);
+    });
+    // The session's durability checkpoint waits for its transcript too, so a run that exits right after loses nothing.
+    ctx.on("session/flush", async (session) => {
+        await writes.get(String(session.id));
+    });
+}
+/** Why a turn ended without finishing its work, if it did. */
+function turnError(reason) {
+    if (reason.kind === "error")
+        return reason.error.message;
+    if (reason.kind === "interrupted")
+        return "interrupted: the harness stopped before the turn ended";
+    if (reason.kind === "blocked")
+        return "blocked: the harness rejected the input before any step ran";
+    return undefined;
+}
+function emptyUsage() {
+    return { totalTokens: 0, inputTokens: 0, outputTokens: 0, thoughtTokens: 0, cachedReadTokens: 0, cachedWriteTokens: 0 };
+}
+/** Adds one call in ACP's terms, as the durable adapter counts: input includes what the cache read and wrote. */
+function add(total, usage) {
+    if (usage === undefined)
+        return;
+    const cacheRead = usage.cacheReadTokens ?? 0;
+    const cacheWrite = usage.cacheWriteTokens ?? 0;
+    const input = usage.inputTokens + cacheRead + cacheWrite;
+    total.inputTokens += input;
+    total.outputTokens += usage.outputTokens;
+    total.totalTokens += usage.totalTokens ?? input + usage.outputTokens;
+    total.thoughtTokens += usage.reasoningTokens ?? 0;
+    total.cachedReadTokens += cacheRead;
+    total.cachedWriteTokens += cacheWrite;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,13 @@
+import { type TaskRun } from "@chopin-ai/core";
+import { type Workspace } from "@chopin-ai/workspace";
+export interface DshTaskOptions {
+    /** A profile, inside the workspace, that mounts this plugin. */
+    profile: string;
+    /** The `transcripts` directory that profile's plugin writes to, inside the workspace. */
+    transcripts: string;
+}
+/**
+ * Runs one prompt headless with the harness inside the workspace, where it keeps its agent, and returns the run
+ * as the plugin recorded it in ACP, with what it changed in the workspace.
+ */
+export declare function runTask(workspace: Workspace, prompt: string, options: DshTaskOptions): Promise<TaskRun>;

package/dist/run.js

@@ -0,0 +1,45 @@
+import { chopinMeta, parseTranscript, withChopinMeta } from "@chopin-ai/core";
+import { diff, run, snapshot } from "@chopin-ai/workspace";
+/**
+ * Runs one prompt headless with the harness inside the workspace, where it keeps its agent, and returns the run
+ * as the plugin recorded it in ACP, with what it changed in the workspace.
+ */
+export async function runTask(workspace, prompt, options) {
+    await workspace.start();
+    const base = await snapshot(workspace);
+    const result = await run(workspace, ["dsh", "--profile", options.profile, "--json"], { input: prompt });
+    const session = result.stdout.split("\n").map(event)
+        .find((e) => e?.type === "session" && typeof e.sessionId === "string");
+    if (session === undefined)
+        throw new Error(`dsh did not start a session (exit ${result.exitCode}): ${result.stderr.trim()}`);
+    const recorded = await run(workspace, ["cat", `${options.transcripts}/${session.sessionId}.jsonl`]);
+    // A finished run without a transcript means the profile does not record; an unfinished one may have stopped first.
+    if (recorded.exitCode !== 0 && result.exitCode === 0) {
+        throw new Error(`no transcript for ${session.sessionId}: ${recorded.stderr.trim()}`);
+    }
+    const transcript = recorded.exitCode === 0 ? parseTranscript(recorded.stdout) : [];
+    if (result.exitCode !== 0)
+        failed(transcript, session.sessionId, `dsh exited with ${result.exitCode}: ${result.stderr.trim()}`);
+    return { transcript, diff: base === undefined ? undefined : await diff(workspace, base) };
+}
+/** Marks a run the harness did not finish: on its last turn end, or on one added when it recorded none. */
+function failed(transcript, sessionId, error) {
+    const last = transcript.at(-1);
+    if (last !== undefined && "turnEnd" in last) {
+        const meta = chopinMeta(last.turnEnd);
+        if (meta?.error === undefined)
+            last.turnEnd = withChopinMeta(last.turnEnd, { ...meta, error });
+        return;
+    }
+    transcript.push({ at: new Date().toISOString(), sessionId, turnEnd: withChopinMeta({ stopReason: "end_turn" }, { error }) });
+}
+/** One line of the harness's JSON output; anything else it printed is not an event. */
+function event(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@chopin-ai/harness-dsh",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Plugin harness adapter: mutable-layer loading and headless task runs",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CodePrometheus/chopin-ai.git",
+    "directory": "packages/harness-dsh"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=24.8.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./run": {
+      "types": "./dist/run.d.ts",
+      "default": "./dist/run.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^1.9.0",
+    "@chopin-ai/core": "^0.2.0",
+    "@chopin-ai/workspace": "^0.2.0",
+    "zod": "4.4.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-mcp-client": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-skill": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
+    "@deepseek-ai/schemastery": "~3.18.5"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-mcp-client": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-skill": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
+    "@deepseek-ai/schemastery": "~3.18.5"
+  },
+  "scripts": {
+    "image": "node scripts/build-image.mjs"
+  }
 }

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.