@ryuhq/sdk 0.2.0 → 0.2.3

package/dist/index.cjs

@@ -49,6 +49,10 @@ __export(src_exports, {
   RunnableKindSchema: () => RunnableKindSchema,
   RunnableMetaSchema: () => RunnableMetaSchema,
   SkillBuilder: () => SkillBuilder,
+  SlashCommandArgumentSchema: () => SlashCommandArgumentSchema,
+  SlashCommandContributionSchema: () => SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema: () => SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema: () => SlashCommandOptionSchema,
   SurfaceSchema: () => SurfaceSchema,
   ToolAppConfigSchema: () => ToolAppConfigSchema,
   ToolBuilder: () => ToolBuilder,
@@ -62,6 +66,7 @@ __export(src_exports, {
   coreManifestJsonSchema: () => coreManifestJsonSchema,
   createAgent: () => createAgent,
   createPrimitives: () => createPrimitives,
+  defineAction: () => defineAction,
   defineAgent: () => defineAgent,
   defineApp: () => defineApp,
   defineModel: () => defineModel,
@@ -87,7 +92,7 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
-// ../../node_modules/.bun/tsup@8.5.1+276f2dd5f44b8d39/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.bun/tsup@8.5.1+68ce2442ac00f52e/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
@@ -335,6 +340,31 @@ var PRIMITIVE_BINDINGS = {
     method: "background.stop",
     grant: "background:control"
   },
+  "storage.get": {
+    transport: "bridge",
+    method: "storage.get",
+    grant: "storage:kv"
+  },
+  "storage.set": {
+    transport: "bridge",
+    method: "storage.set",
+    grant: "storage:kv"
+  },
+  "storage.delete": {
+    transport: "bridge",
+    method: "storage.delete",
+    grant: "storage:kv"
+  },
+  "storage.keys": {
+    transport: "bridge",
+    method: "storage.keys",
+    grant: "storage:kv"
+  },
+  "storage.compareAndSet": {
+    transport: "bridge",
+    method: "storage.compareAndSet",
+    grant: "storage:kv"
+  },
   // Host-direct media data-path (the host holds the node token; returns data: URLs).
   "image.generate": {
     transport: "direct",
@@ -377,6 +407,13 @@ function createPrimitives(transport) {
         process_id: input.processId
       })
     },
+    storage: {
+      get: (input) => transport.bridge("storage.get", input),
+      set: (input) => transport.bridge("storage.set", input).then(() => void 0),
+      delete: (input) => transport.bridge("storage.delete", input).then(() => void 0),
+      keys: (input) => transport.bridge("storage.keys", input ?? {}).then((value) => Array.isArray(value) ? value : []),
+      compareAndSet: (input) => transport.bridge("storage.compareAndSet", input)
+    },
     rag: {
       retrieve: (input) => brokerCall(transport, "rag", "retrieve", input),
       embed: (input) => brokerCall(transport, "rag", "embed", input),
@@ -1019,10 +1056,18 @@ var ChatWidgetTemplateSchema = import_zod.z.object({
 }).superRefine((value, ctx) => {
   const count = Number(Boolean(value.backing.tool_id)) + Number(Boolean(value.backing.view_id));
   if (count !== 1 && value.availability === "available") {
-    ctx.addIssue({ code: "custom", path: ["backing"], message: "available templates need exactly one backing tool_id or view_id" });
+    ctx.addIssue({
+      code: "custom",
+      path: ["backing"],
+      message: "available templates need exactly one backing tool_id or view_id"
+    });
   }
   if (count > 1) {
-    ctx.addIssue({ code: "custom", path: ["backing"], message: "backing must declare at most one of tool_id or view_id" });
+    ctx.addIssue({
+      code: "custom",
+      path: ["backing"],
+      message: "backing must declare at most one of tool_id or view_id"
+    });
   }
 });
 var ToolAppConfigSchema = import_zod.z.object({
@@ -1045,6 +1090,33 @@ var ToolAppConfigSchema = import_zod.z.object({
   /** Optional status label shown when the render tool finishes. */
   invoked: import_zod.z.string().optional()
 });
+var SlashCommandOptionSchema = import_zod.z.object({
+  description: import_zod.z.string().optional(),
+  label: import_zod.z.string().min(1),
+  value: import_zod.z.string().min(1)
+}).passthrough();
+var SlashCommandCustomOptionSchema = import_zod.z.union([
+  import_zod.z.literal(true),
+  import_zod.z.object({
+    description: import_zod.z.string().optional(),
+    label: import_zod.z.string().min(1).optional()
+  }).passthrough()
+]);
+var SlashCommandArgumentSchema = import_zod.z.object({
+  allow_custom: import_zod.z.boolean().optional(),
+  custom: SlashCommandCustomOptionSchema.optional(),
+  description: import_zod.z.string().optional(),
+  name: import_zod.z.string().min(1),
+  options: import_zod.z.array(SlashCommandOptionSchema).optional()
+}).passthrough();
+var SlashCommandContributionSchema = import_zod.z.object({
+  args: import_zod.z.array(SlashCommandArgumentSchema).optional(),
+  body: import_zod.z.string().optional(),
+  command: import_zod.z.string().min(1),
+  description: import_zod.z.string().optional(),
+  id: import_zod.z.string().optional(),
+  parameters: import_zod.z.array(SlashCommandArgumentSchema).optional()
+}).passthrough();
 var ContributesSchema = import_zod.z.object({
   turn_hooks: import_zod.z.array(TurnHookContributionSchema).default([]),
   /** App events this plugin EMITS — the provider half of the hook system, whose
@@ -1059,7 +1131,7 @@ var ContributesSchema = import_zod.z.object({
    * feature declaration before signing. */
   chat_features: import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.unknown())).default([]),
   settings_tabs: import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.unknown())).default([]),
-  slash_commands: import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.unknown())).default([]),
+  slash_commands: import_zod.z.array(SlashCommandContributionSchema).default([]),
   /** App widgets (Ryu Apps). Each binds a render tool id to its
    *  `ui://widget/<slug>.html` template. Mirrors the Rust-side
    *  `Contributes.widgets` field, without which the CLI's zod parse would strip
@@ -1126,7 +1198,10 @@ var ContributesSchema = import_zod.z.object({
   output_styles: import_zod.z.array(OutputStyleContributionSchema).default([]),
   /** Per-message actions contributed by an enabled plugin. Kept as loose records
    *  so renderer-specific `kind`/`args` payloads survive `ryu pack` unchanged. */
-  message_actions: import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.unknown())).default([])
+  message_actions: import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.unknown())).default([]),
+  /** Buttons contributed to the floating text-selection toolbar. Kept as loose
+   *  records so host-owned dispatch args survive `ryu pack` unchanged. */
+  selection_actions: import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.unknown())).default([])
 });
 var SetupStepSchema = import_zod.z.object({
   /** Card heading (e.g. the companion app name). */
@@ -1276,6 +1351,9 @@ var PluginManifestSchema = import_zod.z.object({
     /^\d+\.\d+\.\d+(?:-[\w.]+)?(?:\+[\w.]+)?$/,
     "version must be a valid semver string (e.g. 1.0.0)"
   ),
+  /** Core-owned release maturity metadata. The Rust contract validates the
+   *  richer shape; the SDK authoring parser must preserve it for pack/publish. */
+  stability: import_zod.z.unknown().optional(),
   /**
    * Lower-case hex `sha256(utf8_bytes(ui_code))` binding the plugin's bundled
    * sandboxed-UI code to this manifest. `ryu pack` / `ryu publish` compute it and
@@ -1293,8 +1371,26 @@ var PluginManifestSchema = import_zod.z.object({
    * Declarations only — grant enforcement is the Gateway's responsibility.
    */
   permission_grants: import_zod.z.array(import_zod.z.string()).default([]),
+  /** Deny-by-default sandbox permissions. Core remains authoritative; this
+   *  schema mirrors the fields so `ryu pack` cannot strip them. */
+  permissions: import_zod.z.object({
+    fs: import_zod.z.object({
+      read: import_zod.z.array(import_zod.z.string()).default([]),
+      write: import_zod.z.array(import_zod.z.string()).default([])
+    }).optional(),
+    child_process: import_zod.z.boolean().optional(),
+    run: import_zod.z.array(import_zod.z.string()).default([]),
+    network: import_zod.z.union([import_zod.z.boolean(), import_zod.z.array(import_zod.z.string())]).optional(),
+    tool: import_zod.z.array(import_zod.z.string()).default([])
+  }).optional(),
+  /** Core-owned permission presentation levels. Preserved verbatim here and
+   *  validated by Core's authoritative manifest contract. */
+  permission_levels: import_zod.z.unknown().optional(),
   /** Remote or stdio MCP servers registered by this plugin. */
   mcp_servers: import_zod.z.record(import_zod.z.string(), McpServerDeclSchema).optional(),
+  /** Core-owned sidecar declarations. Their full process/HTTP schema stays in
+   *  the Rust contract; this authoring layer must never strip them. */
+  sidecars: import_zod.z.unknown().optional(),
   /**
    * Optional Companion surface (an in-desktop overlay or sidebar panel).
    * Absent when the plugin has no Companion surface.
@@ -1330,6 +1426,9 @@ var PluginManifestSchema = import_zod.z.object({
    * an unsupported-target plugin stays installable and inspectable.
    */
   targets: import_zod.z.array(SurfaceSchema).default([]),
+  /** Rich per-surface declarations (`support`, UI, contributed commands, …).
+   *  Core owns and validates the nested vocabulary. */
+  surfaces: import_zod.z.unknown().optional(),
   /**
    * Host version floors — the semver requirement each surface must satisfy for
    * this plugin to install. Mirrors Core's `EnginesReq`
@@ -1444,7 +1543,7 @@ var PluginManifestSchema = import_zod.z.object({
    * array of steps guiding the user through post-install configuration.
    */
   setup: import_zod.z.union([SetupStepSchema, import_zod.z.array(SetupStepSchema)]).optional()
-}).superRefine((manifest, context) => {
+}).passthrough().superRefine((manifest, context) => {
   const hasOAuthServer = Object.values(manifest.mcp_servers ?? {}).some(
     (server) => server.auth?.type === "oauth"
   );
@@ -1471,6 +1570,85 @@ function coreManifestJsonSchema() {
   return JSON.parse(loadNative().pluginManifestJsonSchema());
 }
 
+// src/runnable/tool.ts
+function validateInput(input, schema, toolId) {
+  if (typeof input !== "object" || input === null || Array.isArray(input)) {
+    throw new Error(
+      `[ryu-sdk] Tool "${toolId}" input must be an object, got ${JSON.stringify(input)}`
+    );
+  }
+  const record = input;
+  for (const requiredKey of schema.required ?? []) {
+    if (!(requiredKey in record)) {
+      throw new Error(
+        `[ryu-sdk] Tool "${toolId}" input missing required field "${requiredKey}"`
+      );
+    }
+  }
+  for (const [key, prop] of Object.entries(schema.properties)) {
+    if (!(key in record)) {
+      continue;
+    }
+    const value = record[key];
+    if (!checkType(value, prop.type)) {
+      throw new Error(
+        `[ryu-sdk] Tool "${toolId}" input field "${key}" expected type "${prop.type}", got ${JSON.stringify(value)}`
+      );
+    }
+  }
+}
+function checkType(value, type) {
+  switch (type) {
+    case "string":
+      return typeof value === "string";
+    case "number":
+    case "integer":
+      return typeof value === "number";
+    case "boolean":
+      return typeof value === "boolean";
+    case "array":
+      return Array.isArray(value);
+    case "object":
+      return typeof value === "object" && value !== null && !Array.isArray(value);
+    default:
+      return false;
+  }
+}
+function defineTool(options) {
+  const { description, id, name, schema, run } = options;
+  const code = `return await (${run.toString()})(input, host);`;
+  return {
+    id,
+    name,
+    kind: "tool",
+    schema,
+    ...description === void 0 ? {} : { description },
+    code,
+    run(input, ctx) {
+      validateInput(input, schema, id);
+      return run(input, ctx);
+    }
+  };
+}
+function inlineToolRunnable(tool2, options) {
+  return {
+    id: tool2.id,
+    name: tool2.name,
+    kind: "tool",
+    config: {
+      slug: tool2.id,
+      backend: "inline_deno",
+      code: tool2.code,
+      input_schema: tool2.schema,
+      ...options?.description === void 0 ? tool2.description === void 0 ? {} : { description: tool2.description } : { description: options.description },
+      ...options?.outputSchema ? { output_schema: options.outputSchema } : {},
+      ...options?.annotations ? { annotations: options.annotations } : {},
+      ...options?.action === void 0 ? {} : { action: options.action },
+      ...options?.needsApproval === void 0 ? {} : { needs_approval: options.needsApproval }
+    }
+  };
+}
+
 // src/runnable/app.ts
 var DEFAULT_APP_WIDGET_MIME = "text/html+skybridge";
 var DEFAULT_APP_DISPLAY_MODE = "inline";
@@ -1482,6 +1660,13 @@ function withWidgetRenderGrant(grants, widgets) {
   }
   return out;
 }
+function withToolExecuteGrant(grants, tools) {
+  const out = [...grants];
+  if (tools.some((tool2) => tool2.runnable !== void 0) && !out.includes("tool:execute")) {
+    out.push("tool:execute");
+  }
+  return out;
+}
 function appToolId(server, name) {
   return `${server}.${name}`;
 }
@@ -1496,7 +1681,9 @@ function defineApp(options) {
   for (const spec of options.tools) {
     const isRender = spec.accessible !== true;
     const id = appToolId(server, spec.name);
+    const executable = spec.runnable ? inlineToolRunnable(spec.runnable) : void 0;
     const config = {
+      ...executable?.config ?? {},
       slug: id,
       description: spec.description,
       widget: isRender,
@@ -1530,7 +1717,7 @@ function defineApp(options) {
     hook_events: [],
     composer_controls: [],
     settings_tabs: [],
-    slash_commands: [],
+    slash_commands: options.slashCommands ?? [],
     sidebar_sections: [],
     sidebar_buttons: [],
     dock_panels: [],
@@ -1548,6 +1735,7 @@ function defineApp(options) {
     pi_extensions: [],
     output_styles: [],
     message_actions: [],
+    selection_actions: [],
     widgets
   };
   const raw = {
@@ -1561,15 +1749,15 @@ function defineApp(options) {
     // Core gates widget promotion on declared-AND-enabled-AND-granted, and a
     // missing grant fails as `DeniedNoGrant` — which is an `info!` log and
     // nothing else. The widget silently renders as plain text, with no error
-    // in the UI and nothing pointing at the manifest. Every app scaffolded
-    // through `defineApp` hit that, because the only fix was a grant string
-    // the templates never mention and the builder never added; the one
-    // working example on disk hand-writes it.
+    // in the UI and nothing pointing at the manifest.
     //
     // Added only when there is a widget to render, and unioned rather than
     // overwritten so an author's own `grants` list survives and re-declaring
     // it is not an error.
-    permission_grants: withWidgetRenderGrant(options.grants ?? [], widgets),
+    permission_grants: withToolExecuteGrant(
+      withWidgetRenderGrant(options.grants ?? [], widgets),
+      options.tools
+    ),
     activation_events: options.activationEvents ?? ["*"],
     contributes,
     // `targets: []` means EVERY surface, so an app that declares none is
@@ -1810,6 +1998,7 @@ var AppBuilder = class {
   _dependencies = [];
   _requiredCapabilities = [];
   _requiredGrants = [];
+  _slashCommands = [];
   _targets = [];
   /** Set the reverse-domain app id (e.g. `"com.example.checklist"`). */
   id(value) {
@@ -1866,6 +2055,11 @@ var AppBuilder = class {
     this._tools.push(spec);
     return this;
   }
+  /** Add a slash command and its optional sequential argument choices. */
+  slashCommand(command) {
+    this._slashCommands.push(command);
+    return this;
+  }
   /**
    * Declare a **plugin-to-plugin dependency** (auto-enabled, in dependency order,
    * before this app). `minVersion` is a MINIMUM (`"1.2.0"` = `">=1.2.0"`).
@@ -1913,6 +2107,7 @@ var AppBuilder = class {
       uiEntry: this._uiEntry,
       tools: this._tools,
       grants: this._grants,
+      slashCommands: this._slashCommands,
       ...this._server ? { server: this._server } : {},
       ...this._displayMode ? { displayMode: this._displayMode } : {},
       ...this._mime ? { mime: this._mime } : {},
@@ -2284,6 +2479,89 @@ function toDisposable(teardown) {
   };
 }
 
+// src/runnable/action.ts
+function deriveAnnotations(effect, annotations) {
+  const resolved = {
+    ...annotations,
+    readOnlyHint: annotations?.readOnlyHint ?? effect === "read",
+    destructiveHint: annotations?.destructiveHint ?? effect === "mutate"
+  };
+  if (effect === "read" && resolved.destructiveHint) {
+    throw new Error(
+      "[ryu-sdk] read actions cannot set annotations.destructiveHint=true"
+    );
+  }
+  if (effect === "mutate" && resolved.readOnlyHint) {
+    throw new Error(
+      "[ryu-sdk] mutate actions cannot set annotations.readOnlyHint=true"
+    );
+  }
+  return resolved;
+}
+function actionManifestEntry(action) {
+  const options = {
+    action: true,
+    annotations: action.annotations,
+    description: action.description,
+    needsApproval: action.needsApproval,
+    ...action.outputSchema ? { outputSchema: action.outputSchema } : {}
+  };
+  return inlineToolRunnable(action, options);
+}
+function actionToManifest(action, options) {
+  const grants = [.../* @__PURE__ */ new Set([...options.grants ?? [], "tool:execute"])];
+  const raw = {
+    id: options.id,
+    name: options.name ?? action.name,
+    version: options.version,
+    runnables: [actionManifestEntry(action)],
+    permission_grants: grants,
+    activation_events: [...options.activationEvents ?? ["*"]],
+    targets: [...options.targets ?? []]
+  };
+  const result = PluginManifestSchema.safeParse(raw);
+  if (!result.success) {
+    const first = result.error.issues[0];
+    const field = first?.path.join(".") ?? "unknown";
+    const message = first?.message ?? "validation failed";
+    throw new Error(
+      `[ryu-sdk] action manifest validation failed at '${field}': ${message}`
+    );
+  }
+  return result.data;
+}
+function defineAction(options) {
+  const annotations = deriveAnnotations(options.effect, options.annotations);
+  const tool2 = defineTool({
+    description: options.description,
+    id: options.id,
+    name: options.name,
+    run: options.run,
+    schema: options.schema
+  });
+  const action = {
+    ...tool2,
+    action: true,
+    annotations,
+    description: options.description,
+    effect: options.effect,
+    needsApproval: options.needsApproval ?? false,
+    ...options.outputSchema ? { outputSchema: options.outputSchema } : {},
+    toManifest(manifestOptions) {
+      return actionToManifest(action, manifestOptions);
+    },
+    toMcpTool(context) {
+      return {
+        name: action.id,
+        description: action.description,
+        inputSchema: action.schema,
+        run: (input) => action.run(input, context)
+      };
+    }
+  };
+  return action;
+}
+
 // src/runnable/agent.ts
 var CAPABILITY_SLOTS = ["rag", "memory", "tts", "stt"];
 function lowerChatSlot(chat) {
@@ -2428,80 +2706,6 @@ function defineSkill(options) {
   };
 }
 
-// src/runnable/tool.ts
-function validateInput(input, schema, toolId) {
-  if (typeof input !== "object" || input === null || Array.isArray(input)) {
-    throw new Error(
-      `[ryu-sdk] Tool "${toolId}" input must be an object, got ${JSON.stringify(input)}`
-    );
-  }
-  const record = input;
-  for (const requiredKey of schema.required ?? []) {
-    if (!(requiredKey in record)) {
-      throw new Error(
-        `[ryu-sdk] Tool "${toolId}" input missing required field "${requiredKey}"`
-      );
-    }
-  }
-  for (const [key, prop] of Object.entries(schema.properties)) {
-    if (!(key in record)) {
-      continue;
-    }
-    const value = record[key];
-    if (!checkType(value, prop.type)) {
-      throw new Error(
-        `[ryu-sdk] Tool "${toolId}" input field "${key}" expected type "${prop.type}", got ${JSON.stringify(value)}`
-      );
-    }
-  }
-}
-function checkType(value, type) {
-  switch (type) {
-    case "string":
-      return typeof value === "string";
-    case "number":
-    case "integer":
-      return typeof value === "number";
-    case "boolean":
-      return typeof value === "boolean";
-    case "array":
-      return Array.isArray(value);
-    case "object":
-      return typeof value === "object" && value !== null && !Array.isArray(value);
-    default:
-      return false;
-  }
-}
-function defineTool(options) {
-  const { id, name, schema, run } = options;
-  const code = `return await (${run.toString()})(input, host);`;
-  return {
-    id,
-    name,
-    kind: "tool",
-    schema,
-    code,
-    run(input, ctx) {
-      validateInput(input, schema, id);
-      return run(input, ctx);
-    }
-  };
-}
-function inlineToolRunnable(tool2, options) {
-  return {
-    id: tool2.id,
-    name: tool2.name,
-    kind: "tool",
-    config: {
-      slug: tool2.id,
-      backend: "inline_deno",
-      code: tool2.code,
-      input_schema: tool2.schema,
-      ...options?.description ? { description: options.description } : {}
-    }
-  };
-}
-
 // src/runnable/turn-hook.ts
 function defineTurnHook(options) {
   const source = options.run.toString();
@@ -2533,7 +2737,8 @@ function definePlugin(options) {
     data_categories: [],
     pi_extensions: [],
     output_styles: [],
-    message_actions: []
+    message_actions: [],
+    selection_actions: []
   };
   const tools = options.tools ?? [];
   const runnables = tools.map((t) => inlineToolRunnable(t));
@@ -2594,6 +2799,10 @@ function defineWorkflow(options) {
   RunnableKindSchema,
   RunnableMetaSchema,
   SkillBuilder,
+  SlashCommandArgumentSchema,
+  SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema,
   SurfaceSchema,
   ToolAppConfigSchema,
   ToolBuilder,
@@ -2607,6 +2816,7 @@ function defineWorkflow(options) {
   coreManifestJsonSchema,
   createAgent,
   createPrimitives,
+  defineAction,
   defineAgent,
   defineApp,
   defineModel,

package/dist/index.d.cts

@@ -1,17 +1,18 @@
 export { Agent, AgentConfig, AgentEvent, AgentTool, Endpoint, GenerateResult, QueryInput, QueryOptions, RemoteToolRef, createAgent, query, ryuTool } from './agent.cjs';
 export { AgentBuilder, AppBuilder, PluginBuilder, SkillBuilder, ToolBuilder, WorkflowBuilder, agent, app, skill, tool, workflow } from './builder.cjs';
-import { HookEventContribution, Surface, TurnHookContribution, PluginManifest } from './manifest.cjs';
-export { AppDependency, AppDependencySchema, CapabilityReq, CapabilityReqSchema, CompanionSurface, CompanionSurfaceSchema, Contributes, McpServerAuth, McpServerAuthSchema, McpServerDecl, McpServerDeclSchema, PluginManifestSchema, Requires, RequiresSchema, RunnableKind, RunnableKindSchema, RunnableMeta, RunnableMetaSchema, SurfaceSchema, ToolAppConfig, ToolAppConfigSchema, WidgetContribution, WidgetContributionSchema, coreManifestJsonSchema, validateManifestStrict, validatePluginId } from './manifest.cjs';
+import { HookEventContribution, SlashCommandContribution, Surface, TurnHookContribution, PluginManifest } from './manifest.cjs';
+export { AppDependency, AppDependencySchema, CapabilityReq, CapabilityReqSchema, CompanionSurface, CompanionSurfaceSchema, Contributes, McpServerAuth, McpServerAuthSchema, McpServerDecl, McpServerDeclSchema, PluginManifestSchema, Requires, RequiresSchema, RunnableKind, RunnableKindSchema, RunnableMeta, RunnableMetaSchema, SlashCommandArgument, SlashCommandArgumentSchema, SlashCommandContributionSchema, SlashCommandCustomOption, SlashCommandCustomOptionSchema, SlashCommandOption, SlashCommandOptionSchema, SurfaceSchema, ToolAppConfig, ToolAppConfigSchema, WidgetContribution, WidgetContributionSchema, coreManifestJsonSchema, validateManifestStrict, validatePluginId } from './manifest.cjs';
 export { MCP_PROTOCOL_VERSION, McpStdioCommand, McpTool, callTool, listTools } from './mcp/client.cjs';
 export { JsonSchema, McpServer, PassthroughRegistration, SdkRunnable, unwrapContent } from './mcp/server.cjs';
 export { C as ChatDelta, a as ChatMessage, b as ChatResult, M as ModelClient, c as ModelClientOptions, d as defineModel } from './client-D5U6ssPc.cjs';
 export { DEFAULT_GATEWAY_URL, assertAllowedEgressUrl, resolveGatewayToken, resolveGatewayUrl } from './model.cjs';
 export { CommandContribution, Disposable, PanelContribution, PanelRegion, PluginContext, RouteContribution, RyuHostServices, RyuPlugin, RyuPluginModule, SettingsSectionContribution, StoreSectionContribution, ThemeContribution, toDisposable } from './plugin.cjs';
+export { ActionAnnotations, ActionEffect, ActionManifestOptions, ActionOptions, ActionRunnable, defineAction } from './action.cjs';
 export { AgentCard, AgentManifestOptions, AgentOptions, AgentRunnable, AgentSlots, CapabilitySlot, ChatSlot, SkillOptions, WorkflowOptions, WorkflowStep, defineAgent, defineSkill, defineWorkflow } from './runnable.cjs';
-import { D as DefineAppRequires } from './app-DNaGmLVf.cjs';
-export { A as AppToolSpec, a as DefineAppOptions, b as appToolId, d as defineApp } from './app-DNaGmLVf.cjs';
-import { T as ToolRunnable } from './tool-u-VR0fLF.cjs';
-export { B as BackgroundClient, a as BackgroundProcess, D as DurableClient, E as EnginesClient, G as GatewayClient, H as HttpPrimitiveTransportOptions, I as ImageClient, J as JsonSchemaProperty, M as MemoryClient, b as MemoryItem, P as PRIMITIVE_BINDINGS, c as PrimitiveBinding, d as PrimitiveTransport, R as RagChunk, e as RagClient, f as RagRerankResult, g as RealtimeClient, h as RealtimeSubscription, i as Runnable, j as RunnableContext, k as RyuPrimitives, S as SttClient, l as ToolOptions, m as ToolSchema, n as TtsClient, o as createPrimitives, p as defineTool, q as httpPrimitiveTransport, r as inlineToolRunnable } from './tool-u-VR0fLF.cjs';
+import { D as DefineAppRequires } from './app-B0Z9Ew_R.cjs';
+export { A as AppToolSpec, a as DefineAppOptions, b as appToolId, d as defineApp } from './app-B0Z9Ew_R.cjs';
+import { T as ToolRunnable } from './tool-CgzW92O_.cjs';
+export { B as BackgroundClient, a as BackgroundProcess, D as DurableClient, E as EnginesClient, G as GatewayClient, H as HttpPrimitiveTransportOptions, I as ImageClient, b as InlineToolManifestOptions, J as JsonSchemaProperty, M as MemoryClient, c as MemoryItem, P as PRIMITIVE_BINDINGS, d as PrimitiveBinding, e as PrimitiveTransport, R as RagChunk, f as RagClient, g as RagRerankResult, h as RealtimeClient, i as RealtimeSubscription, j as Runnable, k as RunnableContext, l as RyuPrimitives, S as StorageClient, m as SttClient, n as ToolOptions, o as ToolSchema, p as TtsClient, q as createPrimitives, r as defineTool, s as httpPrimitiveTransport, t as inlineToolRunnable } from './tool-CgzW92O_.cjs';
 import 'zod';
 
 /**
@@ -133,8 +134,8 @@ interface DefinePluginOptions {
     requires?: DefineAppRequires;
     /** Declarative settings tabs (model pickers, fields), passed verbatim. */
     settingsTabs?: Record<string, unknown>[];
-    /** Declarative slash commands, passed verbatim. */
-    slashCommands?: Record<string, unknown>[];
+    /** Declarative slash commands, including sequential argument choices. */
+    slashCommands?: SlashCommandContribution[];
     /**
      * Host surfaces this plugin runs on. **Omitted/empty = every surface** (the
      * backward-compatible default); it never means "hidden".
@@ -158,4 +159,4 @@ interface DefinePluginOptions {
  */
 declare function definePlugin(options: DefinePluginOptions): PluginManifest;
 
-export { DefineAppRequires, type DefinePluginOptions, type DefineTurnHookOptions, type HookContext, type HookDirective, type HookRun, type HostApi, PluginManifest, type SideModelArgs, Surface, ToolRunnable, TurnHookContribution, definePlugin, defineTurnHook };
+export { DefineAppRequires, type DefinePluginOptions, type DefineTurnHookOptions, type HookContext, type HookDirective, type HookRun, type HostApi, PluginManifest, type SideModelArgs, SlashCommandContribution, Surface, ToolRunnable, TurnHookContribution, definePlugin, defineTurnHook };

package/dist/index.d.ts

@@ -1,17 +1,18 @@
 export { Agent, AgentConfig, AgentEvent, AgentTool, Endpoint, GenerateResult, QueryInput, QueryOptions, RemoteToolRef, createAgent, query, ryuTool } from './agent.js';
 export { AgentBuilder, AppBuilder, PluginBuilder, SkillBuilder, ToolBuilder, WorkflowBuilder, agent, app, skill, tool, workflow } from './builder.js';
-import { HookEventContribution, Surface, TurnHookContribution, PluginManifest } from './manifest.js';
-export { AppDependency, AppDependencySchema, CapabilityReq, CapabilityReqSchema, CompanionSurface, CompanionSurfaceSchema, Contributes, McpServerAuth, McpServerAuthSchema, McpServerDecl, McpServerDeclSchema, PluginManifestSchema, Requires, RequiresSchema, RunnableKind, RunnableKindSchema, RunnableMeta, RunnableMetaSchema, SurfaceSchema, ToolAppConfig, ToolAppConfigSchema, WidgetContribution, WidgetContributionSchema, coreManifestJsonSchema, validateManifestStrict, validatePluginId } from './manifest.js';
+import { HookEventContribution, SlashCommandContribution, Surface, TurnHookContribution, PluginManifest } from './manifest.js';
+export { AppDependency, AppDependencySchema, CapabilityReq, CapabilityReqSchema, CompanionSurface, CompanionSurfaceSchema, Contributes, McpServerAuth, McpServerAuthSchema, McpServerDecl, McpServerDeclSchema, PluginManifestSchema, Requires, RequiresSchema, RunnableKind, RunnableKindSchema, RunnableMeta, RunnableMetaSchema, SlashCommandArgument, SlashCommandArgumentSchema, SlashCommandContributionSchema, SlashCommandCustomOption, SlashCommandCustomOptionSchema, SlashCommandOption, SlashCommandOptionSchema, SurfaceSchema, ToolAppConfig, ToolAppConfigSchema, WidgetContribution, WidgetContributionSchema, coreManifestJsonSchema, validateManifestStrict, validatePluginId } from './manifest.js';
 export { MCP_PROTOCOL_VERSION, McpStdioCommand, McpTool, callTool, listTools } from './mcp/client.js';
 export { JsonSchema, McpServer, PassthroughRegistration, SdkRunnable, unwrapContent } from './mcp/server.js';
 export { C as ChatDelta, a as ChatMessage, b as ChatResult, M as ModelClient, c as ModelClientOptions, d as defineModel } from './client-D5U6ssPc.js';
 export { DEFAULT_GATEWAY_URL, assertAllowedEgressUrl, resolveGatewayToken, resolveGatewayUrl } from './model.js';
 export { CommandContribution, Disposable, PanelContribution, PanelRegion, PluginContext, RouteContribution, RyuHostServices, RyuPlugin, RyuPluginModule, SettingsSectionContribution, StoreSectionContribution, ThemeContribution, toDisposable } from './plugin.js';
+export { ActionAnnotations, ActionEffect, ActionManifestOptions, ActionOptions, ActionRunnable, defineAction } from './action.js';
 export { AgentCard, AgentManifestOptions, AgentOptions, AgentRunnable, AgentSlots, CapabilitySlot, ChatSlot, SkillOptions, WorkflowOptions, WorkflowStep, defineAgent, defineSkill, defineWorkflow } from './runnable.js';
-import { D as DefineAppRequires } from './app-Bkw7LlCK.js';
-export { A as AppToolSpec, a as DefineAppOptions, b as appToolId, d as defineApp } from './app-Bkw7LlCK.js';
-import { T as ToolRunnable } from './tool-DSx2bFx8.js';
-export { B as BackgroundClient, a as BackgroundProcess, D as DurableClient, E as EnginesClient, G as GatewayClient, H as HttpPrimitiveTransportOptions, I as ImageClient, J as JsonSchemaProperty, M as MemoryClient, b as MemoryItem, P as PRIMITIVE_BINDINGS, c as PrimitiveBinding, d as PrimitiveTransport, R as RagChunk, e as RagClient, f as RagRerankResult, g as RealtimeClient, h as RealtimeSubscription, i as Runnable, j as RunnableContext, k as RyuPrimitives, S as SttClient, l as ToolOptions, m as ToolSchema, n as TtsClient, o as createPrimitives, p as defineTool, q as httpPrimitiveTransport, r as inlineToolRunnable } from './tool-DSx2bFx8.js';
+import { D as DefineAppRequires } from './app-C-BDJwfG.js';
+export { A as AppToolSpec, a as DefineAppOptions, b as appToolId, d as defineApp } from './app-C-BDJwfG.js';
+import { T as ToolRunnable } from './tool-AjkdFvhE.js';
+export { B as BackgroundClient, a as BackgroundProcess, D as DurableClient, E as EnginesClient, G as GatewayClient, H as HttpPrimitiveTransportOptions, I as ImageClient, b as InlineToolManifestOptions, J as JsonSchemaProperty, M as MemoryClient, c as MemoryItem, P as PRIMITIVE_BINDINGS, d as PrimitiveBinding, e as PrimitiveTransport, R as RagChunk, f as RagClient, g as RagRerankResult, h as RealtimeClient, i as RealtimeSubscription, j as Runnable, k as RunnableContext, l as RyuPrimitives, S as StorageClient, m as SttClient, n as ToolOptions, o as ToolSchema, p as TtsClient, q as createPrimitives, r as defineTool, s as httpPrimitiveTransport, t as inlineToolRunnable } from './tool-AjkdFvhE.js';
 import 'zod';
 
 /**
@@ -133,8 +134,8 @@ interface DefinePluginOptions {
     requires?: DefineAppRequires;
     /** Declarative settings tabs (model pickers, fields), passed verbatim. */
     settingsTabs?: Record<string, unknown>[];
-    /** Declarative slash commands, passed verbatim. */
-    slashCommands?: Record<string, unknown>[];
+    /** Declarative slash commands, including sequential argument choices. */
+    slashCommands?: SlashCommandContribution[];
     /**
      * Host surfaces this plugin runs on. **Omitted/empty = every surface** (the
      * backward-compatible default); it never means "hidden".
@@ -158,4 +159,4 @@ interface DefinePluginOptions {
  */
 declare function definePlugin(options: DefinePluginOptions): PluginManifest;
 
-export { DefineAppRequires, type DefinePluginOptions, type DefineTurnHookOptions, type HookContext, type HookDirective, type HookRun, type HostApi, PluginManifest, type SideModelArgs, Surface, ToolRunnable, TurnHookContribution, definePlugin, defineTurnHook };
+export { DefineAppRequires, type DefinePluginOptions, type DefineTurnHookOptions, type HookContext, type HookDirective, type HookRun, type HostApi, PluginManifest, type SideModelArgs, SlashCommandContribution, Surface, ToolRunnable, TurnHookContribution, definePlugin, defineTurnHook };