@ryuhq/sdk 0.2.0 → 0.2.2

package/dist/manifest.d.ts

@@ -217,10 +217,80 @@ declare const ToolAppConfigSchema: z.ZodObject<{
     invoked: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type ToolAppConfig = z.infer<typeof ToolAppConfigSchema>;
+/** One selectable value for a plugin/app slash-command argument. */
+declare const SlashCommandOptionSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    value: z.ZodString;
+}, z.core.$loose>;
+type SlashCommandOption = z.infer<typeof SlashCommandOptionSchema>;
+/** A registered free-form option shown alongside an argument's choices. */
+declare const SlashCommandCustomOptionSchema: z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>]>;
+type SlashCommandCustomOption = z.infer<typeof SlashCommandCustomOptionSchema>;
+/** One sequential argument in a plugin/app slash command. */
+declare const SlashCommandArgumentSchema: z.ZodObject<{
+    allow_custom: z.ZodOptional<z.ZodBoolean>;
+    custom: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>]>>;
+    description: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+type SlashCommandArgument = z.infer<typeof SlashCommandArgumentSchema>;
+/**
+ * A command registered by a plugin or Ryu App. `args` is the preferred key;
+ * `parameters` is accepted as a readable alias for hand-authored manifests.
+ * Each argument's options are plugin-owned, so the shell never needs a closed
+ * enum for app-specific values.
+ */
+declare const SlashCommandContributionSchema: z.ZodObject<{
+    args: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        allow_custom: z.ZodOptional<z.ZodBoolean>;
+        custom: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>]>>;
+        description: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+    body: z.ZodOptional<z.ZodString>;
+    command: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        allow_custom: z.ZodOptional<z.ZodBoolean>;
+        custom: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>]>>;
+        description: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+type SlashCommandContribution = z.infer<typeof SlashCommandContributionSchema>;
 /**
  * The `contributes` block. Mirrors `Contributes` in
  * `apps/core/src/plugin_manifest/mod.rs`. The declarative UI surfaces
- * (`composer_controls` / `chat_features` / `settings_tabs` / `slash_commands`) are passed verbatim
+ * (`composer_controls` / `chat_features` / `settings_tabs`) are passed verbatim
  * to the desktop renderer, so they are typed loosely here (records).
  */
 declare const ContributesSchema: z.ZodObject<{
@@ -245,7 +315,40 @@ declare const ContributesSchema: z.ZodObject<{
     composer_controls: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     chat_features: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     settings_tabs: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    slash_commands: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    slash_commands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        args: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            allow_custom: z.ZodOptional<z.ZodBoolean>;
+            custom: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>]>>;
+            description: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                label: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
+        body: z.ZodOptional<z.ZodString>;
+        command: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            allow_custom: z.ZodOptional<z.ZodBoolean>;
+            custom: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>]>>;
+            description: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                label: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
     widgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
         tool_id: z.ZodString;
         uri: z.ZodString;
@@ -284,6 +387,7 @@ declare const ContributesSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     message_actions: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    selection_actions: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strip>;
 type Contributes = z.infer<typeof ContributesSchema>;
 /**
@@ -434,6 +538,7 @@ declare const PluginManifestSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     version: z.ZodString;
+    stability: z.ZodOptional<z.ZodUnknown>;
     ui_code_sha256: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     runnables: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -448,6 +553,17 @@ declare const PluginManifestSchema: z.ZodObject<{
         config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>>;
     permission_grants: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    permissions: z.ZodOptional<z.ZodObject<{
+        fs: z.ZodOptional<z.ZodObject<{
+            read: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            write: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        child_process: z.ZodOptional<z.ZodBoolean>;
+        run: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        network: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        tool: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    permission_levels: z.ZodOptional<z.ZodUnknown>;
     mcp_servers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         args: z.ZodDefault<z.ZodArray<z.ZodString>>;
         auth: z.ZodOptional<z.ZodObject<{
@@ -469,6 +585,7 @@ declare const PluginManifestSchema: z.ZodObject<{
         }>>;
         url: z.ZodOptional<z.ZodURL>;
     }, z.core.$strip>>>;
+    sidecars: z.ZodOptional<z.ZodUnknown>;
     companion: z.ZodOptional<z.ZodObject<{
         label: z.ZodString;
         icon: z.ZodOptional<z.ZodString>;
@@ -497,7 +614,40 @@ declare const PluginManifestSchema: z.ZodObject<{
         composer_controls: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         chat_features: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         settings_tabs: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        slash_commands: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        slash_commands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            args: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                allow_custom: z.ZodOptional<z.ZodBoolean>;
+                custom: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    label: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>]>>;
+                description: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    label: z.ZodString;
+                    value: z.ZodString;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>>>;
+            body: z.ZodOptional<z.ZodString>;
+            command: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                allow_custom: z.ZodOptional<z.ZodBoolean>;
+                custom: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    label: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>]>>;
+                description: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    label: z.ZodString;
+                    value: z.ZodString;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
         widgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
             tool_id: z.ZodString;
             uri: z.ZodString;
@@ -536,6 +686,7 @@ declare const PluginManifestSchema: z.ZodObject<{
             source: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         message_actions: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        selection_actions: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>>;
     requires: z.ZodOptional<z.ZodObject<{
         apps: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -558,6 +709,7 @@ declare const PluginManifestSchema: z.ZodObject<{
         web: "web";
         cli: "cli";
     }>>>;
+    surfaces: z.ZodOptional<z.ZodUnknown>;
     engines: z.ZodOptional<z.ZodObject<{
         cli: z.ZodOptional<z.ZodString>;
         desktop: z.ZodOptional<z.ZodString>;
@@ -627,7 +779,7 @@ declare const PluginManifestSchema: z.ZodObject<{
         actionLabel: z.ZodOptional<z.ZodString>;
         actionUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>]>>;
-}, z.core.$strip>;
+}, z.core.$loose>;
 type PluginManifest = z.infer<typeof PluginManifestSchema>;
 /**
  * Validate a plugin id with Core's strict reverse-domain, path-traversal-safe
@@ -646,4 +798,4 @@ declare function validateManifestStrict(manifestJson: string): string;
  */
 declare function coreManifestJsonSchema(): unknown;
 
-export { type AppDependency, AppDependencySchema, type CapabilityReq, CapabilityReqSchema, type ChatWidgetTemplate, ChatWidgetTemplateSchema, type CompanionSurface, CompanionSurfaceSchema, type Contributes, ContributesSchema, type EnginesReq, EnginesReqSchema, type HookEventContribution, HookEventContributionSchema, type McpServerAuth, McpServerAuthSchema, type McpServerDecl, McpServerDeclSchema, type OutputStyleContribution, OutputStyleContributionSchema, type PiExtensionContribution, PiExtensionContributionSchema, type PluginManifest, PluginManifestSchema, type Requires, RequiresSchema, type RunnableKind, RunnableKindSchema, type RunnableMeta, RunnableMetaSchema, type SetupStep, SetupStepSchema, type Surface, SurfaceSchema, type ToolAppConfig, ToolAppConfigSchema, type TurnHookContribution, TurnHookContributionSchema, type WidgetContribution, WidgetContributionSchema, coreManifestJsonSchema, labelImpersonatesSystemChrome, validateManifestStrict, validatePluginId };
+export { type AppDependency, AppDependencySchema, type CapabilityReq, CapabilityReqSchema, type ChatWidgetTemplate, ChatWidgetTemplateSchema, type CompanionSurface, CompanionSurfaceSchema, type Contributes, ContributesSchema, type EnginesReq, EnginesReqSchema, type HookEventContribution, HookEventContributionSchema, type McpServerAuth, McpServerAuthSchema, type McpServerDecl, McpServerDeclSchema, type OutputStyleContribution, OutputStyleContributionSchema, type PiExtensionContribution, PiExtensionContributionSchema, type PluginManifest, PluginManifestSchema, type Requires, RequiresSchema, type RunnableKind, RunnableKindSchema, type RunnableMeta, RunnableMetaSchema, type SetupStep, SetupStepSchema, type SlashCommandArgument, SlashCommandArgumentSchema, type SlashCommandContribution, SlashCommandContributionSchema, type SlashCommandCustomOption, SlashCommandCustomOptionSchema, type SlashCommandOption, SlashCommandOptionSchema, type Surface, SurfaceSchema, type ToolAppConfig, ToolAppConfigSchema, type TurnHookContribution, TurnHookContributionSchema, type WidgetContribution, WidgetContributionSchema, coreManifestJsonSchema, labelImpersonatesSystemChrome, validateManifestStrict, validatePluginId };

package/dist/manifest.js

@@ -15,6 +15,10 @@ import {
   RunnableKindSchema,
   RunnableMetaSchema,
   SetupStepSchema,
+  SlashCommandArgumentSchema,
+  SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema,
   SurfaceSchema,
   ToolAppConfigSchema,
   TurnHookContributionSchema,
@@ -23,7 +27,7 @@ import {
   labelImpersonatesSystemChrome,
   validateManifestStrict,
   validatePluginId
-} from "./chunk-IEUQ3CDG.js";
+} from "./chunk-NZKVOSC2.js";
 export {
   AppDependencySchema,
   CapabilityReqSchema,
@@ -41,6 +45,10 @@ export {
   RunnableKindSchema,
   RunnableMetaSchema,
   SetupStepSchema,
+  SlashCommandArgumentSchema,
+  SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema,
   SurfaceSchema,
   ToolAppConfigSchema,
   TurnHookContributionSchema,

package/dist/mcp/server.d.cts

@@ -24,7 +24,8 @@ import { McpStdioCommand } from './client.cjs';
 /** JSON Schema fragment — enough to describe a tool's input arguments. */
 interface JsonSchema {
     description?: string;
-    properties?: Record<string, JsonSchema>;
+    /** Property schemas may use any JSON Schema dialect or nested shape. */
+    properties?: Record<string, unknown>;
     required?: string[];
     type?: string;
     [key: string]: unknown;

package/dist/mcp/server.d.ts

@@ -24,7 +24,8 @@ import { McpStdioCommand } from './client.js';
 /** JSON Schema fragment — enough to describe a tool's input arguments. */
 interface JsonSchema {
     description?: string;
-    properties?: Record<string, JsonSchema>;
+    /** Property schemas may use any JSON Schema dialect or nested shape. */
+    properties?: Record<string, unknown>;
     required?: string[];
     type?: string;
     [key: string]: unknown;