create-ryu-app 0.1.14 → 0.2.2

package/README.md

@@ -20,6 +20,7 @@ Ryu extensions come in two shapes, and `--template` picks which one you get.
 | Template | Emits | Factory |
 |---|---|---|
 | `agent` | A loop-owning Runnable agent | `Agent` / `ryuTool` |
+| `action` | A governed business operation with input/output contracts | `defineAction` |
 | `hook-plugin` | A post-assistant-turn plugin | `definePlugin` + `defineTurnHook` |
 | `ryu-app` | An interactive in-chat widget | `defineApp` + a self-contained widget |
 | `companion-plugin` | A Ryu App whose widget calls a companion tool, plus a panel surface | `defineApp` |

package/dist/index.js

@@ -16,13 +16,18 @@ var RE_WORD_SEPARATOR = /[-_\s]+/;
 var RE_VALID_NAME = /^[a-z0-9][a-z0-9-_]*$/i;
 var RE_LABEL_IMPERSONATES = /ryu|system/i;
 var SAFE_COMPANION_LABEL = "App Panel";
-var SDK_DEPENDENCY_RANGE = "^0.1.14";
+var SDK_DEPENDENCY_RANGE = "^0.2.2";
 var TEMPLATES = {
   agent: {
     kind: "plugin",
     summary: "a loop-owning Runnable agent (Agent + ryuTool)",
     devEntry: "src/agent.ts"
   },
+  action: {
+    kind: "plugin",
+    summary: "a governed business action (defineAction)",
+    devEntry: "src/action.ts"
+  },
   "hook-plugin": {
     kind: "plugin",
     summary: "a post-assistant-turn hook (definePlugin + defineTurnHook)",

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "create-ryu-app",
-  "version": "0.1.14",
+  "version": "0.2.2",
   "type": "module",
   "description": "Scaffold a starter Ryu SDK project with a Runnable, gateway-pointed model config, and manifest.json manifest",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amajorai/ryu"
+  },
   "bin": {
     "create-ryu-app": "./dist/index.js"
   },
@@ -20,10 +24,10 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@ryuhq/sdk": "^0.1.14"
+    "@ryuhq/sdk": "^0.2.2"
   },
   "devDependencies": {
-    "@types/bun": "^1.3.4",
+    "@types/bun": "catalog:",
     "tsup": "^8.5.1",
     "typescript": "^5"
   }

package/template/action/manifest.json

@@ -0,0 +1,45 @@
+{
+  "id": "com.example.__APP_NAME__",
+  "name": "__APP_DISPLAY_NAME__",
+  "version": "0.1.0",
+  "runnables": [
+    {
+      "id": "action-main",
+      "name": "Main Action",
+      "kind": "tool",
+      "config": {
+        "slug": "action-main",
+        "backend": "inline_deno",
+        "code": "return await (async ({ message }) => ({ ok: true, message }))(input, host);",
+        "action": true,
+        "description": "Accept a message and return a governed receipt.",
+        "input_schema": {
+          "type": "object",
+          "properties": {
+            "message": {
+              "type": "string",
+              "description": "The message to record."
+            }
+          },
+          "required": ["message"]
+        },
+        "output_schema": {
+          "type": "object",
+          "properties": {
+            "ok": { "type": "boolean" },
+            "message": { "type": "string" }
+          },
+          "required": ["ok", "message"]
+        },
+        "annotations": {
+          "readOnlyHint": false,
+          "destructiveHint": true
+        },
+        "needs_approval": true
+      }
+    }
+  ],
+  "permission_grants": ["tool:execute"],
+  "activation_events": ["*"],
+  "targets": []
+}

package/template/action/src/action.ts

@@ -0,0 +1,48 @@
+#!/usr/bin/env bun
+/**
+ * __APP_DISPLAY_NAME__ — a governed business Action.
+ *
+ * The Action is the single implementation used by local TypeScript callers,
+ * the SDK MCP adapter, and the Core inline tool emitted by toManifest().
+ *
+ *   bun run src/action.ts   # prints the generated manifest
+ *   bunx ryu pack .         # validates and bundles manifest.json
+ */
+
+import { defineAction } from "@ryuhq/sdk";
+
+const action = defineAction({
+	id: "action-main",
+	name: "Main Action",
+	description: "Accept a message and return a governed receipt.",
+	schema: {
+		type: "object",
+		properties: {
+			message: { type: "string", description: "The message to record." },
+		},
+		required: ["message"],
+	},
+	outputSchema: {
+		type: "object",
+		properties: {
+			ok: { type: "boolean" },
+			message: { type: "string" },
+		},
+		required: ["ok", "message"],
+	},
+	effect: "mutate",
+	needsApproval: true,
+	run: async ({ message }) => ({ ok: true, message }),
+});
+
+const manifest = action.toManifest({
+	id: "com.example.__APP_NAME__",
+	name: "__APP_DISPLAY_NAME__",
+	version: "0.1.0",
+});
+
+export default manifest;
+
+if (import.meta.main) {
+	process.stdout.write(`${JSON.stringify(manifest, null, 2)}\n`);
+}

package/template/agent/src/agent.ts

@@ -36,7 +36,7 @@ const agent = new Agent({
 		"expense emails, read the relevant ones, and return a concise list of " +
 		"expenses with amount, merchant, date, and a category.",
 	tools: {
-		gmailSearch: ryuTool("composio__GMAIL_SEARCH_EMAILS", {
+		gmailSearch: ryuTool("composio.GMAIL_SEARCH_EMAILS", {
 			description: "Search the user's Gmail messages",
 			parameters: {
 				type: "object",
@@ -50,7 +50,7 @@ const agent = new Agent({
 				required: ["query"],
 			},
 		}),
-		gmailGet: ryuTool("composio__GMAIL_GET_EMAIL", {
+		gmailGet: ryuTool("composio.GMAIL_GET_EMAIL", {
 			description: "Fetch a single Gmail message by id",
 		}),
 	},

package/template/app/sidecar/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@example/__APP_NAME__-sidecar",
   "private": true,
-  "version": "0.1.14",
+  "version": "0.2.2",
   "type": "module",
   "bin": {
     "ryu-__APP_NAME__": "./src/main/index.ts"

package/template/companion-plugin/manifest.json

@@ -4,11 +4,11 @@
   "version": "0.1.0",
   "runnables": [
     {
-      "id": "__APP_NAME____render",
+      "id": "__APP_NAME__.render",
       "name": "render",
       "kind": "tool",
       "config": {
-        "slug": "__APP_NAME____render",
+        "slug": "__APP_NAME__.render",
         "description": "Render the interactive panel inline in the chat reply.",
         "widget": true,
         "widget_accessible": true,
@@ -17,11 +17,11 @@
       }
     },
     {
-      "id": "__APP_NAME____save",
+      "id": "__APP_NAME__.save",
       "name": "save",
       "kind": "tool",
       "config": {
-        "slug": "__APP_NAME____save",
+        "slug": "__APP_NAME__.save",
         "description": "Persist the panel's current state. Callable by the mounted widget via callTool.",
         "widget": false,
         "widget_accessible": true,
@@ -46,7 +46,7 @@
     "slash_commands": [],
     "widgets": [
       {
-        "tool_id": "__APP_NAME____render",
+        "tool_id": "__APP_NAME__.render",
         "uri": "ui://widget/__APP_NAME__.html",
         "ui_entry": "src/widget.tsx",
         "mime": "text/html+skybridge",

package/template/companion-plugin/src/app.ts

@@ -5,7 +5,7 @@
  * that mounts the widget, it declares a `save` tool marked `accessible: true` — a
  * COMPANION the mounted widget may invoke over the capability-gated bridge:
  *
- *     await window.openai.callTool("__APP_NAME____save", { state })
+ *     await window.openai.callTool("__APP_NAME__.save", { state })
  *
  * The host routes that call through the Gateway (allowlist + audit) before it
  * reaches Core; the frame never holds a token. It also declares a full-page

package/template/companion-plugin/src/widget.tsx

@@ -27,7 +27,7 @@ declare global {
 	}
 }
 
-const SAVE_TOOL_ID = "__APP_NAME____save";
+const SAVE_TOOL_ID = "__APP_NAME__.save";
 
 function Widget() {
 	const bridge = window.openai ?? {};

package/template/ryu-app/manifest.json

@@ -4,11 +4,11 @@
   "version": "0.1.0",
   "runnables": [
     {
-      "id": "__APP_NAME____render",
+      "id": "__APP_NAME__.render",
       "name": "render",
       "kind": "tool",
       "config": {
-        "slug": "__APP_NAME____render",
+        "slug": "__APP_NAME__.render",
         "description": "Render the __APP_DISPLAY_NAME__ widget inline in the chat reply.",
         "widget": true,
         "widget_accessible": false,
@@ -43,7 +43,7 @@
     "slash_commands": [],
     "widgets": [
       {
-        "tool_id": "__APP_NAME____render",
+        "tool_id": "__APP_NAME__.render",
         "uri": "ui://widget/__APP_NAME__.html",
         "ui_entry": "src/widget.tsx",
         "mime": "text/html+skybridge",