Reorganize repo structure and standards references
This commit is contained in:
1 parent
3cb93a81be
commit
be2054274d
5885 files changed
+2588
-195
No files matched your search
@@ -0,0 +1,30 @@
|
||||
# @toolctrl/plugin-sdk
|
||||
|
||||
Phase 06 Task #21 foundation — TypeScript SDK plugin authors import against.
|
||||
|
||||
## Scope (foundation)
|
||||
|
||||
- Type definitions: `HostApi`, `PluginContext`, `HookHandler`
|
||||
- Example plugin scaffold under `examples/hello-world/` (TypeScript source + manifest)
|
||||
|
||||
## How plugin authors use this
|
||||
|
||||
1. `pnpm add -D @toolctrl/plugin-sdk`
|
||||
2. Implement a hook handler:
|
||||
|
||||
```ts
|
||||
import type { HookHandler } from "@toolctrl/plugin-sdk";
|
||||
|
||||
export const handler: HookHandler<{ name: string }, { greeting: string }> = (input, ctx) => {
|
||||
ctx.log.info({ name: input.name }, "hello");
|
||||
return { greeting: `Hello, ${input.name}!` };
|
||||
};
|
||||
```
|
||||
|
||||
3. Build to WASM with `wasm-pack`, AssemblyScript, or similar (operator-side CLI tooling is **deferred**, see `docs/improvement-plan/06-plugin-system/wasm-sandbox.md`).
|
||||
4. Sign the resulting `.wasm` and ship to operator alongside the `plugin.toml` manifest.
|
||||
|
||||
## Deferred
|
||||
|
||||
- AssemblyScript/Rust toolchain bindings → Phase 06 Task #23 docs follow-up
|
||||
- Plugin build/sign/publish CLI → backlog
|
||||
Reference in new issue
Block a user