@ryuhq/sdk 0.0.5 → 0.0.17

package/src/runnable/tool.ts

@@ -153,9 +153,6 @@ export interface ToolRunnable<
 	TInput extends Record<string, unknown> = Record<string, unknown>,
 	TOutput = unknown,
 > extends Runnable<TInput, TOutput> {
-	readonly kind: "tool";
-	/** JSON Schema for this tool's input — compatible with Core's ToolInfo.schema. */
-	readonly schema: ToolSchema;
 	/**
 	 * The `run` body serialized for Core's `inline_deno` tool backend — the exact
 	 * same technique `defineTurnHook` uses for its `code`. This is what makes a
@@ -174,6 +171,9 @@ export interface ToolRunnable<
 	 * the sandbox form is the second parameter aliased to `host`.
 	 */
 	readonly code: string;
+	readonly kind: "tool";
+	/** JSON Schema for this tool's input — compatible with Core's ToolInfo.schema. */
+	readonly schema: ToolSchema;
 }
 
 // ── Factory ───────────────────────────────────────────────────────────────────
@@ -232,7 +232,7 @@ export function defineTool<
 }
 
 /**
- * Convert a {@link ToolRunnable} into a `plugin.json` `kind:"tool"` runnable that
+ * Convert a {@link ToolRunnable} into a `manifest.json` `kind:"tool"` runnable that
  * ships its `run` body as Core's `inline_deno` backend. The emitted config
  * mirrors Core's `ToolConfig` (`apps/core/src/plugin_manifest/schema.rs`):
  * `{ slug, backend:"inline_deno", code, description?, input_schema }`. Core

package/src/runnable/turn-hook.ts

@@ -15,6 +15,7 @@
 
 import type {
 	Contributes,
+	HookEventContribution,
 	PluginManifest,
 	RunnableMeta,
 	Surface,
@@ -90,9 +91,12 @@ export interface DefineTurnHookOptions {
  * is serialized into the sandbox `code` string and invoked with `ctx`/`host` at
  * run time.
  */
+// `code` is optional on `TurnHookContribution` because a hand-authored manifest may
+// carry `code_file` instead. This builder always produces the inline form, so it
+// narrows the return type — callers get a `code` they need not null-check.
 export function defineTurnHook(
 	options: DefineTurnHookOptions
-): TurnHookContribution {
+): TurnHookContribution & { code: string } {
 	const source = options.run.toString();
 	// The sandbox wraps `code` in an async IIFE where `ctx`/`host` are in scope
 	// and a bare `return` reports the directive — so call the serialized function
@@ -112,8 +116,24 @@ export interface DefinePluginOptions {
 	composerControls?: Record<string, unknown>[];
 	/** Capability grants the hooks need (e.g. `["hook:side-model", "storage:kv"]`). */
 	grants?: string[];
+	/**
+	 * App events this plugin EMITS — the provider half of the hook system whose
+	 * consumer half is {@link DefinePluginOptions.turnHooks}. Each `id` must be
+	 * namespaced to this plugin's own `id`; Core validates that at load and again
+	 * on every emit.
+	 */
+	hookEvents?: HookEventContribution[];
 	/** Reverse-domain id (e.g. `"com.example.my-plugin"`). */
 	id: string;
+	/**
+	 * Language servers the plugin declares, keyed by server name — the same shape
+	 * as Claude Code's `lspServers` / `.lsp.json`, passed verbatim. Loose records
+	 * rather than a typed entry on purpose: Claude Code owns this field
+	 * vocabulary, so typing it here would strip a field from a newer Claude
+	 * release on its way through `ryu pack`. Core types it, because Core acts on
+	 * it.
+	 */
+	lspServers?: Record<string, Record<string, unknown>>;
 	/** Display name. */
 	name: string;
 	/**
@@ -144,19 +164,25 @@ export interface DefinePluginOptions {
 }
 
 /**
- * Assemble a `plugin.json` manifest for a turn-hook plugin. The result matches
+ * Assemble a `manifest.json` manifest for a turn-hook plugin. The result matches
  * Core's `PluginManifest` serde shape and can be written to disk or validated via
  * `validateManifestStrict`.
  */
 export function definePlugin(options: DefinePluginOptions): PluginManifest {
 	const contributes: Contributes = {
 		turn_hooks: options.turnHooks ?? [],
+		hook_events: options.hookEvents ?? [],
 		composer_controls: options.composerControls ?? [],
 		settings_tabs: options.settingsTabs ?? [],
 		slash_commands: options.slashCommands ?? [],
-		// A turn-hook plugin contributes no app widgets; the field is required on the
-		// resolved `Contributes` type (zod default applied), so set it explicitly.
+		lsp_servers: options.lspServers ?? {},
+		// A turn-hook plugin contributes no app widgets, sidebar entries or dock
+		// panels; the fields are required on the resolved `Contributes` type (zod
+		// defaults applied), so set them explicitly.
 		widgets: [],
+		sidebar_sections: [],
+		sidebar_buttons: [],
+		dock_panels: [],
 	};
 	// Ship each inline tool as a `kind:"tool"` runnable (Core's `inline_deno`
 	// backend). Shipping tools requires the `tool:execute` grant; add it once.