@orkestrel/tool 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,50 @@
+# @orkestrel/tool
+
+Concrete, LLM-callable **tools** for the `@orkestrel` line — built over
+[`@orkestrel/agent`](https://github.com/orkestrel/agent)'s `ToolInterface` /
+`createTool` runtime, with pluggable stores. Part of the `@orkestrel` line.
+
+- **`createWorkflowTool`** — authors and runs an
+  [`@orkestrel/workflow`](https://github.com/orkestrel/workflow) definition in
+  one call (flat steps / lenient draft / full definition, depth + cycle
+  guarded), with an optional pluggable `WorkflowStoreInterface` that persists
+  each executed run's snapshot on settle.
+- **`createWorkspaceTool`** — a 13-operation workspace-editing tool driving
+  `@orkestrel/agent`'s workspace runtime, either against a caller-supplied
+  manager or a fresh one built over a pluggable `WorkspaceStoreInterface`.
+- **`createAgentTool`** — net-new sub-agent delegation: resolves and runs one
+  seeded agent via an `AgentRegistryInterface`, depth + cycle guarded,
+  deliberately storeless (persistence, if any, rides the registry's own
+  configuration).
+- **Adapters** — `createToolFunction` / `createAgentFunction` compose a
+  registered tool or a live agent into a workflow's `functions` registry, plus
+  the authoring umbrella (`WorkflowSteps` / `WorkflowDraft`,
+  `createWorkflowDraftContract`, `workflowToolSummary`, `MAX_WORKFLOW_DEPTH`).
+
+**Status: v0.0.1 pending publish**, once the upstream `@orkestrel/workflow` /
+`@orkestrel/agent` cleanups that drop their authoring surfaces (this package
+becomes the defining home) land.
+
+## Install
+
+```sh
+npm install @orkestrel/tool
+```
+
+## Requirements
+
+- Node.js >= 24
+- Dual ESM + CommonJS builds (`import` and `require` both supported)
+
+## Guide
+
+See [`guides/src/tool.md`](guides/src/tool.md).
+
+## Package
+
+Published as a single typed entry point per the `exports` field in
+`package.json`.
+
+## License
+
+MIT © [Orkestrel](https://github.com/orkestrel) — see [LICENSE](./LICENSE).