@ryuhq/sdk 0.2.0 → 0.2.3

package/dist/index.js

@@ -4,10 +4,8 @@ import {
 import {
   defineAgent,
   defineSkill,
-  defineTool,
-  defineWorkflow,
-  inlineToolRunnable
-} from "./chunk-T5676WL2.js";
+  defineWorkflow
+} from "./chunk-BC3A7HMO.js";
 import {
   AgentBuilder,
   AppBuilder,
@@ -20,11 +18,29 @@ import {
   skill,
   tool,
   workflow
-} from "./chunk-IOLP5FFE.js";
+} from "./chunk-HLKJZAFK.js";
 import {
   appToolId,
   defineApp
-} from "./chunk-W3KPP4WN.js";
+} from "./chunk-SN2QBJUF.js";
+import {
+  Agent,
+  createAgent,
+  query,
+  ryuTool
+} from "./chunk-Z57QDDJR.js";
+import {
+  PRIMITIVE_BINDINGS,
+  createPrimitives,
+  httpPrimitiveTransport
+} from "./chunk-ZTJWBRUL.js";
+import {
+  defineAction
+} from "./chunk-4TPUZDTI.js";
+import {
+  defineTool,
+  inlineToolRunnable
+} from "./chunk-QYFUNJOH.js";
 import {
   AppDependencySchema,
   CapabilityReqSchema,
@@ -35,24 +51,17 @@ import {
   RequiresSchema,
   RunnableKindSchema,
   RunnableMetaSchema,
+  SlashCommandArgumentSchema,
+  SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema,
   SurfaceSchema,
   ToolAppConfigSchema,
   WidgetContributionSchema,
   coreManifestJsonSchema,
   validateManifestStrict,
   validatePluginId
-} from "./chunk-IEUQ3CDG.js";
-import {
-  Agent,
-  createAgent,
-  query,
-  ryuTool
-} from "./chunk-ULSVL7EC.js";
-import {
-  PRIMITIVE_BINDINGS,
-  createPrimitives,
-  httpPrimitiveTransport
-} from "./chunk-A3RGEPDG.js";
+} from "./chunk-NZKVOSC2.js";
 import {
   ModelClient,
   defineModel
@@ -105,7 +114,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));
@@ -154,6 +164,10 @@ export {
   RunnableKindSchema,
   RunnableMetaSchema,
   SkillBuilder,
+  SlashCommandArgumentSchema,
+  SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema,
   SurfaceSchema,
   ToolAppConfigSchema,
   ToolBuilder,
@@ -167,6 +181,7 @@ export {
   coreManifestJsonSchema,
   createAgent,
   createPrimitives,
+  defineAction,
   defineAgent,
   defineApp,
   defineModel,

package/dist/manifest.cjs

@@ -36,6 +36,10 @@ __export(manifest_exports, {
   RunnableKindSchema: () => RunnableKindSchema,
   RunnableMetaSchema: () => RunnableMetaSchema,
   SetupStepSchema: () => SetupStepSchema,
+  SlashCommandArgumentSchema: () => SlashCommandArgumentSchema,
+  SlashCommandContributionSchema: () => SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema: () => SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema: () => SlashCommandOptionSchema,
   SurfaceSchema: () => SurfaceSchema,
   ToolAppConfigSchema: () => ToolAppConfigSchema,
   TurnHookContributionSchema: () => TurnHookContributionSchema,
@@ -47,7 +51,7 @@ __export(manifest_exports, {
 });
 module.exports = __toCommonJS(manifest_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();
 
@@ -215,10 +219,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({
@@ -241,6 +253,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
@@ -255,7 +294,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
@@ -322,7 +361,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). */
@@ -472,6 +514,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
@@ -489,8 +534,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.
@@ -526,6 +589,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`
@@ -640,7 +706,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"
   );
@@ -684,6 +750,10 @@ function coreManifestJsonSchema() {
   RunnableKindSchema,
   RunnableMetaSchema,
   SetupStepSchema,
+  SlashCommandArgumentSchema,
+  SlashCommandContributionSchema,
+  SlashCommandCustomOptionSchema,
+  SlashCommandOptionSchema,
   SurfaceSchema,
   ToolAppConfigSchema,
   TurnHookContributionSchema,

package/dist/manifest.d.cts

@@ -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 };