@jianxx/dsh-cc-tool-sleep 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.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/core/tool-sleep/README.md
+README.md: d6b0a6fa637faefc995b6a344255ccdfe1bc1ef3
+README.zh.md: 20f51605bc0b9c67b5a3df820d142d54c63b60e0

package/README.md

@@ -0,0 +1,56 @@
+# @jianxx/dsh-cc-tool-sleep
+
+English | [中文](README.zh.md)
+
+Model-facing `Sleep` tool that waits for a specified duration with cooperative cancellation, aligned to Claude Code's `SleepTool` semantics. It registers into `ctx.tools` via the `@jianxx/dsh-cc-tools` `ToolRuntime`.
+
+## Tools
+
+### `Sleep`
+
+Waits for `{ duration }` seconds.
+
+| Arg | Type | Notes |
+|---|---|---|
+| `duration` | number | Seconds to wait. Must be a finite, non-negative number. `0` is a no-op. |
+
+The wait is cooperative with cancellation: it arms a timer and an `abort` listener on `exec.signal`, and settles on whichever fires first. When a new turn cancels the call mid-sleep, the tool stops waiting immediately and reports the canonical `ABORTED` outcome — matching CC's `interruptBehavior: 'cancel'`.
+
+The tool is `isConcurrencySafe = () => true`, so it may overlap sibling tool calls (CC: "You can call this concurrently with other tools — it won't interfere with them"). Prefer it over spawning a sleeping subprocess, because it does not hold a subprocess or a shell.
+
+## Configuration
+
+`Config` is schemastery-typed (mirroring the git-worktree tools' convention):
+
+```ts
+export const Config = z.object({
+  minDurationSeconds: z.number(),  // optional lower bound (clamped up)
+  maxDurationSeconds: z.number(),  // optional upper bound (clamped down)
+})
+```
+
+Each `apply(ctx, config)` call registers the `Sleep` tool into `ctx.tools`. Requires a loaded `ctx.tools`; the plugin stays pending until `inject: ['tools']` is satisfied.
+
+## Install / registration
+
+```ts
+import * as ToolSleep from '@jianxx/dsh-cc-tool-sleep'
+
+await ctx.plugin(ToolRuntime)   // @jianxx/dsh-cc-tools
+await ctx.plugin(ToolSleep)     // registers the Sleep tool
+```
+
+## Choice of semantics
+
+- **Duration in seconds** matches the model-facing parameter contract.
+- **Interrupt-cancel** via `exec.signal` reproduces CC's behavior where a user prompt during sleep interrupts and cancels the current turn.
+- **Concurrency-safe** so `Sleep` never forms an ordering barrier against sibling calls.
+
+## Build order
+
+`tool-sleep` depends only on the workspace `@jianxx/dsh-cc-tools` package and harness base packages (`@deepseek-ai/cordis`, `@deepseek-ai/dsh-llm`, `@deepseek-ai/dsh-invariants`, `@deepseek-ai/schemastery`). It has no dependency on git-worktree or any other workspace package, so it builds as soon as `core/tools` does; `tsc -b` resolves the reference order automatically.
+
+## Known limitations
+
+- The `minDurationSeconds` / `maxDurationSeconds` clamps are a loose analog of CC's `minSleepDurationMs` / `maxSleepDurationMs` process settings; they are per-`apply` config here rather than global runtime settings.
+- No `tick`/progress steaming is emitted (CC emits `sleep_progress` ticks in its REPL); the wait is silent on the protocol level.

package/README.zh.md

@@ -0,0 +1,56 @@
+# @jianxx/dsh-cc-tool-sleep
+
+[English](README.md) | 中文
+
+模型侧 `Sleep` 工具：等待指定时长，并支持协作式取消，语义对齐 Claude Code 的 `SleepTool`。通过 `@jianxx/dsh-cc-tools` 的 `ToolRuntime` 注册进 `ctx.tools`。
+
+## 工具
+
+### `Sleep`
+
+等待 `{ duration }` 秒。
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `duration` | number | 等待的秒数。必须为有限、非负数。`0` 为 no-op。 |
+
+等待是协作式可取消的：同时挂起一个定时器与针对 `exec.signal` 的 `abort` 监听器，谁先触发就先 settle。若新一轮会话在睡眠中途取消该调用，工具会立即停止等待并返回规范的 `ABORTED` 结果——与 CC 的 `interruptBehavior: 'cancel'` 一致。
+
+该工具为 `isConcurrencySafe = () => true`，因此可以与其他工具调用重叠（CC："You can call this concurrently with other tools — it won't interfere with them"）。优先于 spawn 一个睡眠子进程，因为它不占用子进程或 shell。
+
+## 配置
+
+`Config` 采用 schemastery 类型（沿用 git-worktree 工具的惯例）：
+
+```ts
+export const Config = z.object({
+  minDurationSeconds: z.number(),  // 可选下限（向上钳制）
+  maxDurationSeconds: z.number(),  // 可选上限（向下钳制）
+})
+```
+
+每次 `apply(ctx, config)` 都会把 `Sleep` 工具注册进 `ctx.tools`。需要已加载的 `ctx.tools`；在 `inject: ['tools']` 满足之前，插件保持等待状态。
+
+## 安装 / 注册
+
+```ts
+import * as ToolSleep from '@jianxx/dsh-cc-tool-sleep'
+
+await ctx.plugin(ToolRuntime)   // @jianxx/dsh-cc-tools
+await ctx.plugin(ToolSleep)     // 注册 Sleep 工具
+```
+
+## 语义取舍
+
+- **以秒为单位**的时长契合模型侧参数契约。
+- **中断即取消**：通过 `exec.signal` 复现 CC 在睡眠途中收到新用户提示时中断并取消当前回合的行为。
+- **并发安全**：`Sleep` 不会对并行的兄弟调用形成顺序屏障。
+
+## 构建顺序
+
+`tool-sleep` 仅依赖工作区 `@jianxx/dsh-cc-tools` 包与 harness 基础包（`@deepseek-ai/cordis`、`@deepseek-ai/dsh-llm`、`@deepseek-ai/dsh-invariants`、`@deepseek-ai/schemastery`）。它不依赖 git-worktree 或任何其它工作区包，因此只要 `core/tools` 构建完成即可构建；`tsc -b` 会自动解析引用顺序。
+
+## 已知限制
+
+- `minDurationSeconds` / `maxDurationSeconds` 钳制是 CC 的 `minSleepDurationMs` / `maxSleepDurationMs` 进程设置的松散对应物；此处为每次 `apply` 的配置，而非全局运行时设置。
+- 不发出 `tick`/进度流（CC 在 REPL 中会发出 `sleep_progress` tick）；等待在协议层是静默的。

package/lib/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Model-facing `Sleep` tool that waits a specified duration with cooperative
+ * cancellation. Aligns with Claude Code's SleepTool semantics: the input is a
+ * `{ duration }` in seconds, the wait is interruptible (a new turn cancels it
+ * like CC's `interruptBehavior: 'cancel'`), and the tool is concurrency-safe
+ * so it may overlap sibling calls.
+ * @module @jianxx/dsh-cc-tool-sleep
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export declare const name = "tool-sleep";
+export declare const inject: string[];
+/** Runtime configuration for the Sleep tool. */
+export interface Config {
+    /**
+     * Optional lower bound (seconds) that a `Sleep` call must wait for, used to
+     * throttle busy-waiting; positive values clamp short durations up. Mirrors
+     * CC's `minSleepDurationMs` in spirit.
+     */
+    minDurationSeconds?: number;
+    /**
+     * Optional upper bound (seconds) that a `Sleep` call may wait for; a request
+     * above it is clamped down. Mirrors CC's `maxSleepDurationMs` in spirit.
+     */
+    maxDurationSeconds?: number;
+}
+/** Runtime configuration schema. */
+export declare const Config: z<Config>;
+/** Arguments accepted by the Sleep tool. */
+export interface SleepToolArgs {
+    /** How long to wait, in seconds. */
+    duration: number;
+}
+export declare function apply(ctx: Context, config?: Config): void;
+export { presentSleepCall, presentSleepResult } from './render.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAMxC,eAAO,MAAM,IAAI,eAAe,CAAA;AAChC,eAAO,MAAM,MAAM,UAAY,CAAA;AAE/B,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,oCAAoC;AACpC,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAG3B,CAAA;AAEF,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;CACjB;AA6CD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAsD7D;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}

package/lib/index.js

@@ -0,0 +1,110 @@
+/**
+ * Model-facing `Sleep` tool that waits a specified duration with cooperative
+ * cancellation. Aligns with Claude Code's SleepTool semantics: the input is a
+ * `{ duration }` in seconds, the wait is interruptible (a new turn cancels it
+ * like CC's `interruptBehavior: 'cancel'`), and the tool is concurrency-safe
+ * so it may overlap sibling calls.
+ * @module @jianxx/dsh-cc-tool-sleep
+ */
+import z from '@deepseek-ai/schemastery';
+import { HarnessError } from '@deepseek-ai/dsh-llm';
+import { defineTool, TOOL_ABORTED } from '@jianxx/dsh-cc-tools';
+import { presentSleepCall, presentSleepResult } from "./render.js";
+export const name = 'tool-sleep';
+export const inject = ['tools'];
+/** Runtime configuration schema. */
+export const Config = z.object({
+    minDurationSeconds: z.number(),
+    maxDurationSeconds: z.number(),
+});
+/** Structured, model-visible failure (maps to an isError tool result). */
+class SleepError extends Error {
+}
+/**
+ * A `HarnessError` that surfaces as the canonical tool-aborted outcome
+ * (`name: AbortError`, `code: TOOL_ABORTED`) — the same shape the harness
+ * produces when cancellation supersedes a body and the shape CC uses when a
+ * user interrupts the sleep turn (`interruptBehavior: 'cancel'`).
+ * @param signal - the aborted tool-call signal whose `reason` is preserved.
+ * @returns the abort error to throw.
+ */
+function abortError(signal) {
+    const error = new HarnessError('tool call aborted', TOOL_ABORTED, { cause: signal.reason });
+    error.name = 'AbortError';
+    return error;
+}
+/**
+ * Wait for a wall-clock duration, resolving early (with an abort error) the
+ * moment `signal` fires. Cooperative: the waiter never spins; it arms a timer
+ * for `ms` and an `abort` listener, then settles on whichever fires first.
+ * @param ms - the wait duration in milliseconds.
+ * @param signal - the tool-call cancellation signal.
+ * @returns a promise resolving after `ms`, or rejecting with the abort error on cancellation.
+ */
+function waitFor(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(abortError(signal));
+            return;
+        }
+        const fail = () => {
+            clearTimeout(timer);
+            reject(abortError(signal));
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', fail);
+            resolve();
+        }, ms);
+        signal.addEventListener('abort', fail, { once: true });
+    });
+}
+export function apply(ctx, config = {}) {
+    const minMs = config.minDurationSeconds !== undefined ? config.minDurationSeconds * 1000 : 0;
+    const maxMs = config.maxDurationSeconds !== undefined ? config.maxDurationSeconds * 1000 : Number.POSITIVE_INFINITY;
+    ctx.tools.register(defineTool({
+        name: 'Sleep',
+        description: 'Wait for a specified duration. Use this when the user tells you to sleep or rest, when you have '
+            + 'nothing to do, or when you are waiting for something. The user can interrupt the sleep at any time. '
+            + 'This tool is concurrency-safe: you can call it concurrently with other tools — it will not interfere '
+            + 'with them. Prefer this over running a sleep command, because it does not hold a subprocess. '
+            + 'Sleep for a short enough duration that you wake up and are ready when the thing you are waiting for '
+            + 'is likely to be ready; each wake-up costs an API call.',
+        parameters: {
+            duration: {
+                type: 'number',
+                description: 'How long to wait, in seconds. Must be a finite, non-negative number.',
+                required: true,
+            },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    duration: { type: 'number', required: true },
+                    message: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.message }],
+        },
+        isConcurrencySafe: () => true,
+        presentCall: presentSleepCall,
+        presentResult: presentSleepResult,
+        async execute(args, exec) {
+            let seconds = args.duration;
+            if (!Number.isFinite(seconds) || seconds < 0) {
+                throw new SleepError(`Sleep duration must be a finite, non-negative number of seconds (got ${JSON.stringify(args.duration)})`);
+            }
+            const ms = seconds * 1000;
+            const clampedMs = Math.min(Math.max(ms, minMs), maxMs);
+            seconds = clampedMs / 1000;
+            await waitFor(clampedMs, exec.signal);
+            return {
+                duration: seconds,
+                message: `Slept for ${seconds} second${seconds === 1 ? '' : 's'}.`,
+            };
+        },
+    }));
+}
+export { presentSleepCall, presentSleepResult } from "./render.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@jianxx/dsh-cc-tool-sleep`.
+ * @module @jianxx/dsh-cc-tool-sleep/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "tool-sleep-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,yBAAyB,CAAA;AAC1C,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AASpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/invariant.js

@@ -0,0 +1,23 @@
+/**
+ * Package-owned invariant companion for `@jianxx/dsh-cc-tool-sleep`.
+ * @module @jianxx/dsh-cc-tool-sleep/invariant
+ */
+const PACKAGE_NAME = '@jianxx/dsh-cc-tool-sleep';
+/** Cordis companion plugin name. */
+export const name = 'tool-sleep-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: Sleep waits on a wall-clock timer and a cancellation
+ * signal, neither of which publishes a durable projection a companion could
+ * cross-check.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,YAAY,GAAG,2BAA2B,CAAA;AAEhD,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,sBAAsB,CAAA;AAC1C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;;GAIG;AACH,MAAM,OAAO,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB"}

package/lib/render.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Pure presentation (presentCall / presentResult) for the Sleep tool: a
+ * generic pending card naming the requested duration, and a generic result
+ * card that fences errors so a failure reads distinct from a success summary.
+ * @module @jianxx/dsh-cc-tool-sleep/render
+ */
+import type { GenericCallView, ToolResult, ToolResultView } from '@jianxx/dsh-cc-tools';
+/** Arguments accepted by the Sleep tool. */
+export interface SleepToolArgs {
+    /** How long to wait, in seconds. */
+    duration: number;
+}
+/**
+ * Present a Sleep pending call as a generic execute card naming the duration.
+ * @param args - validated tool arguments.
+ * @returns a generic card view.
+ */
+export declare function presentSleepCall(args: SleepToolArgs): GenericCallView;
+/**
+ * Present a Sleep result as a generic card. Success shows the plain message;
+ * errors are fenced so a failure is visually distinct from a success summary.
+ * @param _args - validated tool arguments (unused by the presenter).
+ * @param result - the finalized tool result.
+ * @returns a generic card view, or `undefined` for an unexpected shape.
+ */
+export declare function presentSleepResult(_args: unknown, result: ToolResult): ToolResultView | undefined;
+//# sourceMappingURL=render.d.ts.map

package/lib/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEvF,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAcrE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAMjG"}

package/lib/render.js

@@ -0,0 +1,42 @@
+/**
+ * Pure presentation (presentCall / presentResult) for the Sleep tool: a
+ * generic pending card naming the requested duration, and a generic result
+ * card that fences errors so a failure reads distinct from a success summary.
+ * @module @jianxx/dsh-cc-tool-sleep/render
+ */
+/**
+ * Present a Sleep pending call as a generic execute card naming the duration.
+ * @param args - validated tool arguments.
+ * @returns a generic card view.
+ */
+export function presentSleepCall(args) {
+    const seconds = args.duration;
+    return {
+        card: 'generic',
+        title: 'Sleeping',
+        kind: 'execute',
+        rawInput: `${seconds} ${seconds === 1 ? 'second' : 'seconds'}`,
+        content: [
+            {
+                type: 'text',
+                text: `Wait for ${seconds} ${seconds === 1 ? 'second' : 'seconds'}.`,
+            },
+        ],
+    };
+}
+/**
+ * Present a Sleep result as a generic card. Success shows the plain message;
+ * errors are fenced so a failure is visually distinct from a success summary.
+ * @param _args - validated tool arguments (unused by the presenter).
+ * @param result - the finalized tool result.
+ * @returns a generic card view, or `undefined` for an unexpected shape.
+ */
+export function presentSleepResult(_args, result) {
+    const block = result.content.length === 1 ? result.content[0] : undefined;
+    if (block === undefined || block.type !== 'text')
+        return undefined;
+    return result.isError
+        ? { card: 'generic', content: [{ type: 'text', text: `\`\`\`\n${block.text.replace(/\n+$/, '')}\n\`\`\`` }] }
+        : { card: 'generic', content: [{ type: 'text', text: block.text }] };
+}
+//# sourceMappingURL=render.js.map

package/lib/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAmB;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAA;IAC7B,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,GAAG,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE;QAC9D,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,YAAY,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,GAAG;aACrE;SACF;KACF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,MAAkB;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACzE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,CAAA;IAClE,OAAO,MAAM,CAAC,OAAO;QACnB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE;QAC7G,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAA;AACxE,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@jianxx/dsh-cc-tool-sleep",
+  "description": "Sleep model tool over a cooperative AbortSignal wait: align with Claude Code's SleepTool duration, interrupt-cancel, and concurrency semantics",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jianxx/dsh-cc-plugins.git",
+    "directory": "packages/core/tool-sleep"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-invariants": ">=0.1.1-rc.2",
+    "@deepseek-ai/cordis": ">=0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@jianxx/dsh-cc-tools": "^0.1.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-llm": "link:../../../../deepseek-harness/packages/llm/llm",
+    "@deepseek-ai/dsh-invariants": "link:../../../../deepseek-harness/packages/runtime-diagnostics/invariants",
+    "@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/schemastery": "link:../../../../deepseek-harness/vendor/schemastery",
+    "@deepseek-ai/dsh-system-prompt": "link:../../../../deepseek-harness/packages/core/system-prompt",
+    "@jianxx/dsh-cc-tools": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}