agenticros 0.2.4 → 0.3.0

package/templates/skills/hello/demo.md

@@ -0,0 +1,5 @@
+# Prompt examples
+
+- Run {{displayName}}
+- Execute {{toolName}}
+- Test my first skill

package/templates/skills/hello/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "agenticros-skill-{{slug}}",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "{{description}}",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "npx agenticros skills dev"
+  },
+  "agenticros": {
+    "id": "{{slug}}",
+    "displayName": "{{displayName}}",
+    "description": "{{description}}",
+    "tutorial": true,
+    "categories": ["communication"],
+    "screenshots": ["docs/icon.png"],
+    "capabilities": [
+      {
+        "id": "{{toolName}}",
+        "verb": "run",
+        "description": "{{description}}"
+      }
+    ]
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": ["agenticros", "tutorial", "getting-started"],
+  "license": "Apache-2.0"
+}

package/templates/skills/hello/src/index.ts

@@ -0,0 +1,37 @@
+/**
+ * {{displayName}} — AgenticROS hello-world skill (local dev / tutorial).
+ */
+
+import { Type } from "@sinclair/typebox";
+
+const TOOL_NAME = "{{toolName}}";
+
+interface SkillPluginApi {
+  registerTool(tool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: unknown;
+    execute: (
+      toolCallId: string,
+      params: Record<string, unknown>,
+      signal?: AbortSignal,
+    ) => Promise<{ content: { type: string; text: string }[]; details?: unknown }>;
+  }): void;
+}
+
+export function registerSkill(api: SkillPluginApi): void {
+  api.registerTool({
+    name: TOOL_NAME,
+    label: "{{displayName}}",
+    description: "{{description}}",
+    parameters: Type.Object({}),
+    async execute() {
+      const message = "Hello from AgenticROS!";
+      return {
+        content: [{ type: "text", text: message }],
+        details: { success: true, message },
+      };
+    },
+  });
+}

package/templates/skills/hello/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}

package/templates/skills/robot/README.md

@@ -0,0 +1,18 @@
+# {{displayName}}
+
+{{description}}
+
+## Local dev
+
+```bash
+npm install
+npm run dev
+```
+
+Use `npm run dev -- --live` when your robot gateway is connected to exercise real cmd_vel.
+
+## Publish
+
+```bash
+npx agenticros publish
+```

package/templates/skills/robot/demo.md

@@ -0,0 +1,5 @@
+# Prompt examples
+
+- Wave hello
+- Run {{displayName}}
+- Make the robot wave

package/templates/skills/robot/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "agenticros-skill-{{slug}}",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "{{description}}",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "npx agenticros skills dev"
+  },
+  "agenticros": {
+    "id": "{{slug}}",
+    "displayName": "{{displayName}}",
+    "description": "{{description}}",
+    "tutorial": false,
+    "categories": ["human-interaction", "navigation"],
+    "screenshots": ["docs/icon.png"],
+    "capabilities": [
+      {
+        "id": "{{toolName}}",
+        "verb": "wave",
+        "description": "{{description}}",
+        "interruptible": true,
+        "blocks_base": true
+      }
+    ]
+  },
+  "dependencies": {
+    "@agenticros/core": "^0.5.0",
+    "@sinclair/typebox": "^0.34.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": ["agenticros", "robot", "cmd_vel"],
+  "license": "Apache-2.0"
+}

package/templates/skills/robot/src/index.ts

@@ -0,0 +1,69 @@
+/**
+ * {{displayName}} — simple cmd_vel wave gesture.
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { RosTransport } from "@agenticros/core";
+
+const TOOL_NAME = "{{toolName}}";
+const CMD_VEL_TOPIC = "cmd_vel";
+
+interface SkillContext {
+  getTransport(): RosTransport;
+}
+
+interface SkillPluginApi {
+  registerTool(tool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: unknown;
+    execute: (
+      toolCallId: string,
+      params: Record<string, unknown>,
+      signal?: AbortSignal,
+    ) => Promise<{ content: { type: string; text: string }[]; details?: unknown }>;
+  }): void;
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+async function publishTwist(
+  transport: RosTransport,
+  linear: number,
+  angular: number,
+): Promise<void> {
+  await transport.publish(CMD_VEL_TOPIC, "geometry_msgs/msg/Twist", {
+    linear: { x: linear, y: 0, z: 0 },
+    angular: { x: 0, y: 0, z: angular },
+  });
+}
+
+export function registerSkill(
+  api: SkillPluginApi,
+  _config: unknown,
+  context: SkillContext,
+): void {
+  api.registerTool({
+    name: TOOL_NAME,
+    label: "{{displayName}}",
+    description: "{{description}}",
+    parameters: Type.Object({}),
+    async execute() {
+      const transport = context.getTransport();
+      // Brief side-to-side angular motion as a "wave".
+      await publishTwist(transport, 0, 0.4);
+      await sleep(400);
+      await publishTwist(transport, 0, -0.4);
+      await sleep(400);
+      await publishTwist(transport, 0, 0);
+      const message = "I waved hello.";
+      return {
+        content: [{ type: "text", text: message }],
+        details: { success: true, message },
+      };
+    },
+  });
+}

package/templates/skills/robot/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}