@orkestrel/toolbox 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orkestrel
+
+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

@@ -0,0 +1,53 @@
+# @orkestrel/toolbox
+
+Concrete, LLM-callable tools for the `@orkestrel` line. Toolbox supplies workflow
+authoring, workspace editing, sub-agent delegation, terminal prompts, database and
+relation operations, and schema inference over the
+[`@orkestrel/tool`](https://github.com/orkestrel/tool) runtime.
+
+The runtime envelope and registry (`ToolInterface`, `ToolCall`, `ToolResult`,
+`createTool`, and `createToolManager`) live in `@orkestrel/tool`. This package supplies
+the concrete handlers that plug into that runtime.
+
+## Install
+
+```sh
+npm install @orkestrel/toolbox
+```
+
+## Example
+
+```ts
+import { createToolManager } from '@orkestrel/tool'
+import { createWorkspaceTool } from '@orkestrel/toolbox'
+
+const tools = createToolManager()
+tools.add(createWorkspaceTool())
+
+const result = await tools.execute({
+	id: 'write-1',
+	name: 'workspace',
+	arguments: {
+		operation: 'write',
+		path: 'notes.txt',
+		content: 'hello',
+	},
+})
+```
+
+Core tools are published from `@orkestrel/toolbox`; terminal route integration is
+published from `@orkestrel/toolbox/server`.
+
+## Requirements
+
+- Node.js >= 22
+- Dual ESM and CommonJS builds
+
+## Guide
+
+See [`guides/src/toolbox.md`](guides/src/toolbox.md). The vendored
+[`guides/src/tool.md`](guides/src/tool.md) documents the runtime dependency.
+
+## License
+
+MIT © [Orkestrel](https://github.com/orkestrel) — see [LICENSE](./LICENSE).