@ryuhq/sdk 0.1.14 → 0.2.2

package/dist/manifest.d.ts

@@ -182,6 +182,23 @@ declare const WidgetContributionSchema: z.ZodObject<{
     default_display_mode: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 type WidgetContribution = z.infer<typeof WidgetContributionSchema>;
+/** Metadata-only chat affordance. The host owns rendering and dispatch; the
+ * manifest carries identifiers and copy only. */
+declare const ChatWidgetTemplateSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    triggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    backing: z.ZodObject<{
+        tool_id: z.ZodOptional<z.ZodString>;
+        view_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    display_mode: z.ZodString;
+    safe_action_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    availability: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type ChatWidgetTemplate = z.infer<typeof ChatWidgetTemplateSchema>;
 /**
  * The `config` blob carried by a Ryu App's `kind:"tool"` runnable. Core's strict
  * `ToolConfig` (`apps/core/src/plugin_manifest/schema.rs`) requires `slug` and
@@ -200,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` / `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<{
@@ -226,8 +313,42 @@ declare const ContributesSchema: z.ZodObject<{
         payload_example: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>>;
     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;
@@ -235,9 +356,24 @@ declare const ContributesSchema: z.ZodObject<{
         mime: z.ZodDefault<z.ZodString>;
         default_display_mode: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>>;
+    chat_widget_templates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        triggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        backing: z.ZodObject<{
+            tool_id: z.ZodOptional<z.ZodString>;
+            view_id: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        display_mode: z.ZodString;
+        safe_action_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        availability: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
     sidebar_sections: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     sidebar_buttons: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     dock_panels: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    live_activities: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     data_categories: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     lsp_servers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     pi_extensions: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -250,6 +386,8 @@ declare const ContributesSchema: z.ZodObject<{
         file: z.ZodOptional<z.ZodString>;
         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>;
 /**
@@ -359,6 +497,33 @@ declare const EnginesReqSchema: z.ZodObject<{
     web: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type EnginesReq = z.infer<typeof EnginesReqSchema>;
+declare const McpServerAuthSchema: z.ZodObject<{
+    client_id: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"oauth">;
+}, z.core.$strict>;
+declare const McpServerDeclSchema: z.ZodObject<{
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    auth: z.ZodOptional<z.ZodObject<{
+        client_id: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"oauth">;
+    }, z.core.$strict>>;
+    command: z.ZodOptional<z.ZodString>;
+    command_env: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        stdio: "stdio";
+        http: "http";
+        "streamable-http": "streamable-http";
+        streamable_http: "streamable_http";
+        sse: "sse";
+    }>>;
+    url: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+type McpServerAuth = z.infer<typeof McpServerAuthSchema>;
+type McpServerDecl = z.infer<typeof McpServerDeclSchema>;
 /**
  * Full schema for a `manifest.json` Plugin manifest. Mirrors `PluginManifest` in
  * `apps/core/src/plugin_manifest/mod.rs`.
@@ -373,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;
@@ -387,6 +553,39 @@ 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<{
+            client_id: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"oauth">;
+        }, z.core.$strict>>;
+        command: z.ZodOptional<z.ZodString>;
+        command_env: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            stdio: "stdio";
+            http: "http";
+            "streamable-http": "streamable-http";
+            streamable_http: "streamable_http";
+            sse: "sse";
+        }>>;
+        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>;
@@ -413,8 +612,42 @@ declare const PluginManifestSchema: z.ZodObject<{
             payload_example: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>>;
         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;
@@ -422,9 +655,24 @@ declare const PluginManifestSchema: z.ZodObject<{
             mime: z.ZodDefault<z.ZodString>;
             default_display_mode: z.ZodDefault<z.ZodString>;
         }, z.core.$strip>>>;
+        chat_widget_templates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            triggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            backing: z.ZodObject<{
+                tool_id: z.ZodOptional<z.ZodString>;
+                view_id: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            display_mode: z.ZodString;
+            safe_action_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            availability: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
         sidebar_sections: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         sidebar_buttons: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         dock_panels: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        live_activities: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         data_categories: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         lsp_servers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         pi_extensions: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -437,6 +685,8 @@ declare const PluginManifestSchema: z.ZodObject<{
             file: z.ZodOptional<z.ZodString>;
             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<{
@@ -459,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>;
@@ -492,12 +743,16 @@ declare const PluginManifestSchema: z.ZodObject<{
         email: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>]>>;
+    repository: z.ZodOptional<z.ZodString>;
+    external: z.ZodOptional<z.ZodBoolean>;
     homepage: z.ZodOptional<z.ZodString>;
     keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     category: z.ZodOptional<z.ZodString>;
     license: z.ZodOptional<z.ZodString>;
     iconUrl: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;
+    banner: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     iconDither: z.ZodOptional<z.ZodObject<{
         from: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         to: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
@@ -524,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
@@ -543,4 +798,4 @@ declare function validateManifestStrict(manifestJson: string): string;
  */
 declare function coreManifestJsonSchema(): unknown;
 
-export { type AppDependency, AppDependencySchema, type CapabilityReq, CapabilityReqSchema, type CompanionSurface, CompanionSurfaceSchema, type Contributes, ContributesSchema, type EnginesReq, EnginesReqSchema, type HookEventContribution, HookEventContributionSchema, 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

@@ -1,10 +1,13 @@
 import {
   AppDependencySchema,
   CapabilityReqSchema,
+  ChatWidgetTemplateSchema,
   CompanionSurfaceSchema,
   ContributesSchema,
   EnginesReqSchema,
   HookEventContributionSchema,
+  McpServerAuthSchema,
+  McpServerDeclSchema,
   OutputStyleContributionSchema,
   PiExtensionContributionSchema,
   PluginManifestSchema,
@@ -12,6 +15,10 @@ import {
   RunnableKindSchema,
   RunnableMetaSchema,
   SetupStepSchema,
+  SlashCommandArgumentSchema,
+  SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema,
   SurfaceSchema,
   ToolAppConfigSchema,
   TurnHookContributionSchema,
@@ -20,14 +27,17 @@ import {
   labelImpersonatesSystemChrome,
   validateManifestStrict,
   validatePluginId
-} from "./chunk-AO2KJRDD.js";
+} from "./chunk-NZKVOSC2.js";
 export {
   AppDependencySchema,
   CapabilityReqSchema,
+  ChatWidgetTemplateSchema,
   CompanionSurfaceSchema,
   ContributesSchema,
   EnginesReqSchema,
   HookEventContributionSchema,
+  McpServerAuthSchema,
+  McpServerDeclSchema,
   OutputStyleContributionSchema,
   PiExtensionContributionSchema,
   PluginManifestSchema,
@@ -35,6 +45,10 @@ export {
   RunnableKindSchema,
   RunnableMetaSchema,
   SetupStepSchema,
+  SlashCommandArgumentSchema,
+  SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema,
   SurfaceSchema,
   ToolAppConfigSchema,
   TurnHookContributionSchema,

package/dist/mcp/client.cjs

@@ -0,0 +1,180 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/mcp/client.ts
+var client_exports = {};
+__export(client_exports, {
+  MCP_PROTOCOL_VERSION: () => MCP_PROTOCOL_VERSION,
+  callTool: () => callTool,
+  listTools: () => listTools
+});
+module.exports = __toCommonJS(client_exports);
+var import_node_child_process = require("child_process");
+var import_node_readline = require("readline");
+var MCP_PROTOCOL_VERSION = "2024-11-05";
+var RPC_TIMEOUT_MS = 6e4;
+var McpConnection = class _McpConnection {
+  proc;
+  nextId = 1;
+  closed = false;
+  waiters = [];
+  constructor(proc) {
+    this.proc = proc;
+  }
+  /** Spawn the server and complete the MCP `initialize` handshake. */
+  static async connect(cmd) {
+    const env = { ...process.env, ...cmd.env ?? {} };
+    const proc = (0, import_node_child_process.spawn)(cmd.command, cmd.args ?? [], {
+      stdio: ["pipe", "pipe", "pipe"],
+      env
+    });
+    if (!(proc.stdin && proc.stdout)) {
+      proc.kill();
+      throw new Error(`MCP server '${cmd.command}' stdin/stdout unavailable`);
+    }
+    if (proc.stderr) {
+      proc.stderr.on("data", (chunk) => {
+        process.stderr.write(`[mcp-server] ${chunk.toString()}`);
+      });
+    }
+    const conn = new _McpConnection(proc);
+    const rl = (0, import_node_readline.createInterface)({
+      input: proc.stdout,
+      crlfDelay: Number.POSITIVE_INFINITY
+    });
+    rl.on("line", (rawLine) => {
+      const trimmed = rawLine.trim();
+      if (!trimmed) {
+        return;
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(trimmed);
+      } catch {
+        return;
+      }
+      if (parsed.id === void 0 || parsed.id === null) {
+        return;
+      }
+      const idx = conn.waiters.findIndex((w) => w.id === parsed.id);
+      if (idx === -1) {
+        return;
+      }
+      const [waiter] = conn.waiters.splice(idx, 1);
+      if (!waiter) {
+        return;
+      }
+      clearTimeout(waiter.timer);
+      if (parsed.error) {
+        waiter.reject(new Error(`MCP error: ${JSON.stringify(parsed.error)}`));
+      } else {
+        waiter.resolve(parsed.result ?? null);
+      }
+    });
+    rl.on("close", () => {
+      for (const waiter of conn.waiters.splice(0)) {
+        clearTimeout(waiter.timer);
+        waiter.reject(new Error("MCP server closed the connection"));
+      }
+    });
+    await conn.request("initialize", {
+      protocolVersion: MCP_PROTOCOL_VERSION,
+      capabilities: {},
+      clientInfo: { name: "ryu-sdk", version: "0.0.1" }
+    });
+    conn.notify("notifications/initialized", {});
+    return conn;
+  }
+  /** Send a JSON-RPC request and return the `result` field. */
+  request(method, params) {
+    const id = this.nextId++;
+    const frame = JSON.stringify({
+      jsonrpc: "2.0",
+      id,
+      method,
+      params
+    });
+    this.write(frame);
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(
+        () => reject(new Error(`MCP request '${method}' timed out`)),
+        RPC_TIMEOUT_MS
+      );
+      this.waiters.push({ id, resolve, reject, timer });
+    });
+  }
+  /** Send a JSON-RPC notification (no response expected). */
+  notify(method, params) {
+    const frame = JSON.stringify({ jsonrpc: "2.0", method, params });
+    this.write(frame);
+  }
+  write(frame) {
+    if (this.closed) {
+      return;
+    }
+    this.proc.stdin?.write(`${frame}
+`);
+  }
+  /** Graceful shutdown: close stdin, then kill. */
+  async shutdown() {
+    this.closed = true;
+    this.proc.stdin?.end();
+    await new Promise((resolve) => {
+      this.proc.once("exit", () => resolve());
+      this.proc.kill();
+      setTimeout(resolve, 500);
+    });
+  }
+};
+async function listTools(cmd) {
+  const conn = await McpConnection.connect(cmd);
+  let result;
+  try {
+    result = await conn.request("tools/list", {});
+  } finally {
+    await conn.shutdown();
+  }
+  const tools = result?.tools ?? [];
+  return tools.map((t) => {
+    const tool = t;
+    const name = tool.name;
+    if (typeof name !== "string") {
+      return null;
+    }
+    return {
+      name,
+      description: typeof tool.description === "string" ? tool.description : void 0,
+      inputSchema: tool.inputSchema
+    };
+  }).filter((t) => t !== null);
+}
+async function callTool(cmd, tool, args) {
+  const conn = await McpConnection.connect(cmd);
+  try {
+    return await conn.request("tools/call", { name: tool, arguments: args });
+  } finally {
+    await conn.shutdown();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MCP_PROTOCOL_VERSION,
+  callTool,
+  listTools
+});

package/dist/mcp/client.d.cts

@@ -0,0 +1,49 @@
+/**
+ * SDK MCP stdio client — a TypeScript mirror of the wire contract in
+ * `apps/core/src/sidecar/mcp/client.rs`.
+ *
+ * This implements the same JSON-RPC 2.0 / newline-delimited transport:
+ *   1. Spawn the MCP server process.
+ *   2. Send `initialize` (protocolVersion "2024-11-05") and receive the result.
+ *   3. Send `notifications/initialized`.
+ *   4. Call `tools/list` or `tools/call` as needed.
+ *   5. Tear down the process.
+ *
+ * POLICY NOTE: this client does NOT implement tool-approval or request-level
+ * policy enforcement.  Approval and policy live in the chat layer and the
+ * Gateway (per issue #86).  Any policy that must run before a tool call must be
+ * wired upstream by the caller, not here.
+ */
+/** MCP protocol version sent during `initialize`. Matches client.rs. */
+declare const MCP_PROTOCOL_VERSION = "2024-11-05";
+/** A tool entry from `tools/list`. */
+interface McpTool {
+    description?: string;
+    /** JSON Schema object for the tool's input arguments. */
+    inputSchema?: unknown;
+    name: string;
+}
+/** Command descriptor for spawning an MCP stdio server. */
+interface McpStdioCommand {
+    args?: string[];
+    command: string;
+    env?: Record<string, string>;
+}
+/**
+ * List the tools an MCP server advertises (`tools/list`).
+ *
+ * Spawns the server, completes the initialize handshake, calls `tools/list`,
+ * and tears down the process — matching the stateless per-request pattern in
+ * `apps/core/src/sidecar/mcp/client.rs`.
+ */
+declare function listTools(cmd: McpStdioCommand): Promise<McpTool[]>;
+/**
+ * Call a tool on an MCP server (`tools/call`) and return the raw result.
+ *
+ * The returned value is the full `tools/call` result object
+ * `{ content: [{type, text}], isError? }`.  Callers that need the plain text
+ * output should extract `.content[0].text`.
+ */
+declare function callTool(cmd: McpStdioCommand, tool: string, args: unknown): Promise<unknown>;
+
+export { MCP_PROTOCOL_VERSION, type McpStdioCommand, type McpTool, callTool, listTools };