@jetcrab/pi-desk-tool-reason 0.0.0-stage → 1.0.1-dev.9001

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mikey O'Brien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# Pi Desk — pi-desk-tool-reason
 
-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.
+包名：`@jetcrab/pi-desk-tool-reason`。插件接口以源码导出为准，个人配置不随包分发。
+
+许可与第三方来源见本目录的 LICENSE 及适用的归属说明。

package/UPSTREAM.md

@@ -0,0 +1,7 @@
+# Upstream
+
+本扩展从本地归档的 `tidy-tools` 定制实现中提取工具 `reasoning` 参数的注入与执行前剥离逻辑；该本地归档不随本仓库分发。
+
+归档实现基于 [`@mobrienv/pi-tidy-tools`](https://github.com/mikeyobrien/pi-tidy-tools) **0.4.1**，遵循随本扩展保留的 MIT `LICENSE`。
+
+当前扩展只保留 `reasoning` 工具参数逻辑，不包含上游的 TUI 渲染、命令、配置、Diff 或 Bash 高亮功能。

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function toolReasoning(pi: ExtensionAPI): void;

package/dist/index.js

@@ -0,0 +1,40 @@
+import { createBashToolDefinition, createEditToolDefinition, createFindToolDefinition, createGrepToolDefinition, createLsToolDefinition, createReadToolDefinition, createWriteToolDefinition } from '@earendil-works/pi-coding-agent';
+import { composeSourceTool } from './tool-composition.js';
+const TOOL_FACTORIES = [
+    createReadToolDefinition,
+    createWriteToolDefinition,
+    createEditToolDefinition,
+    createBashToolDefinition,
+    createGrepToolDefinition,
+    createFindToolDefinition,
+    createLsToolDefinition
+];
+function executionCwd(args) {
+    const context = args[4];
+    if (!context || typeof context !== 'object') {
+        throw new Error('tool-reasoning requires a Pi execution context');
+    }
+    const cwd = context.cwd;
+    if (typeof cwd !== 'string' || !cwd) {
+        throw new Error('tool-reasoning requires a Pi execution cwd');
+    }
+    return cwd;
+}
+// MyPi consumes extension tools without emitting session_start. Register now,
+// then rebuild the original tool at execution time so every WorkSession uses ctx.cwd.
+function createSourceTool(factory) {
+    const source = factory(process.cwd());
+    return {
+        ...source,
+        async execute(...args) {
+            const runtimeSource = factory(executionCwd(args));
+            return runtimeSource.execute(...args);
+        }
+    };
+}
+export default function toolReasoning(pi) {
+    for (const factory of TOOL_FACTORIES) {
+        const source = createSourceTool(factory);
+        pi.registerTool(composeSourceTool(source));
+    }
+}

package/dist/tool-composition.d.ts

@@ -0,0 +1,7 @@
+export interface SourceToolDefinition {
+    name: string;
+    parameters: Record<string, unknown>;
+    execute: (...args: unknown[]) => Promise<unknown>;
+    [key: string]: unknown;
+}
+export declare function composeSourceTool(source: SourceToolDefinition): SourceToolDefinition;

package/dist/tool-composition.js

@@ -0,0 +1,40 @@
+const REASONING_DESCRIPTION = 'Short phrase (≤12 words) stating the GOAL behind this call — the why-in-context, not the what. Do NOT restate the file, path, or command; instead give the intent or what you expect to find/confirm.';
+function withReasoning(parameters) {
+    const properties = parameters.properties;
+    const sourceProperties = properties && typeof properties === 'object' ? properties : {};
+    return {
+        ...parameters,
+        properties: {
+            reasoning: {
+                type: 'string',
+                description: REASONING_DESCRIPTION
+            },
+            ...sourceProperties
+        }
+    };
+}
+function withoutReasoning(params) {
+    if (!params || typeof params !== 'object')
+        return {};
+    const { reasoning: _reasoning, ...rest } = params;
+    return rest;
+}
+export function composeSourceTool(source) {
+    const properties = source.parameters.properties;
+    if (properties && typeof properties === 'object' && Object.hasOwn(properties, 'reasoning')) {
+        throw new Error(`${source.name} source schema already defines reasoning`);
+    }
+    const sourceExecute = source.execute;
+    const tool = {
+        ...source,
+        parameters: withReasoning(source.parameters),
+        async execute(...args) {
+            args[1] = withoutReasoning(args[1]);
+            return sourceExecute.call(source, ...args);
+        }
+    };
+    delete tool.renderCall;
+    delete tool.renderResult;
+    delete tool.renderShell;
+    return tool;
+}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@jetcrab/pi-desk-tool-reason",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JetCrab/pi-desk.git",
+    "directory": "plugins/pi-desk-tool-reason"
+  },
+  "version": "1.0.1-dev.9001",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "description": "Pi Desk tool reasoning extension",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "UPSTREAM.md"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsx": "^4.23.12",
+    "typescript": "^5"
+  },
+  "keywords": [
+    "pi-package"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --import tsx --test tests/*.test.mjs"
+  }
 }