agenticros 0.2.3 → 0.3.0

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

@@ -0,0 +1,68 @@
+/**
+ * {{displayName}} — capture one frame from the robot camera.
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { RosTransport } from "@agenticros/core";
+
+const TOOL_NAME = "{{toolName}}";
+
+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;
+}
+
+export function registerSkill(
+  api: SkillPluginApi,
+  config: { robot?: { cameraTopic?: string } },
+  context: SkillContext,
+): void {
+  api.registerTool({
+    name: TOOL_NAME,
+    label: "{{displayName}}",
+    description: "{{description}}",
+    parameters: Type.Object({
+      topic: Type.Optional(
+        Type.String({ description: "Camera topic override (default from robot config)." }),
+      ),
+    }),
+    async execute(_id, params) {
+      const transport = context.getTransport();
+      const topic =
+        (typeof params.topic === "string" && params.topic) ||
+        config.robot?.cameraTopic ||
+        "camera/color/image_raw";
+      const msg = await transport.subscribeOnce(topic, 5000);
+      const encoding =
+        msg && typeof msg === "object" && "encoding" in msg
+          ? String((msg as { encoding?: string }).encoding ?? "unknown")
+          : "unknown";
+      const width =
+        msg && typeof msg === "object" && "width" in msg
+          ? Number((msg as { width?: number }).width ?? 0)
+          : 0;
+      const height =
+        msg && typeof msg === "object" && "height" in msg
+          ? Number((msg as { height?: number }).height ?? 0)
+          : 0;
+      const summary = `Captured ${width}x${height} frame (${encoding}) from ${topic}.`;
+      return {
+        content: [{ type: "text", text: summary }],
+        details: { topic, width, height, encoding, captured: Boolean(msg) },
+      };
+    },
+  });
+}

package/templates/skills/camera/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/depth/README.md

@@ -0,0 +1,16 @@
+# {{displayName}}
+
+{{description}}
+
+## Local dev
+
+```bash
+npm install
+npm run dev
+```
+
+## Publish
+
+```bash
+npx agenticros publish
+```

package/templates/skills/depth/demo.md

@@ -0,0 +1,5 @@
+# Prompt examples
+
+- Measure distance to the object in front of the robot
+- Run {{displayName}}
+- How far away is the obstacle?

package/templates/skills/depth/package.json

@@ -0,0 +1,38 @@
+{
+  "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": ["vision", "telemetry"],
+    "screenshots": ["docs/icon.png"],
+    "capabilities": [
+      {
+        "id": "{{toolName}}",
+        "verb": "measure",
+        "description": "{{description}}"
+      }
+    ]
+  },
+  "dependencies": {
+    "@agenticros/core": "^0.5.0",
+    "@sinclair/typebox": "^0.34.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": ["agenticros", "depth", "realsense"],
+  "license": "Apache-2.0"
+}

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

@@ -0,0 +1,69 @@
+/**
+ * {{displayName}} — sample depth at image center (RealSense / depth camera).
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { RosTransport } from "@agenticros/core";
+
+const TOOL_NAME = "{{toolName}}";
+
+interface DepthSampleResult {
+  distance_m: number;
+  valid: boolean;
+  topic: string;
+}
+
+interface SkillContext {
+  getTransport(): RosTransport;
+  getDepthDistance(
+    transport: RosTransport,
+    topic: string,
+    timeoutMs?: number,
+  ): Promise<DepthSampleResult>;
+}
+
+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,
+  config: { robot?: { depthTopic?: string } },
+  context: SkillContext,
+): void {
+  api.registerTool({
+    name: TOOL_NAME,
+    label: "{{displayName}}",
+    description: "{{description}}",
+    parameters: Type.Object({
+      topic: Type.Optional(
+        Type.String({ description: "Depth topic override (default: depth/image_rect_raw)." }),
+      ),
+    }),
+    async execute(_id, params) {
+      const transport = context.getTransport();
+      const topic =
+        (typeof params.topic === "string" && params.topic) ||
+        config.robot?.depthTopic ||
+        "depth/image_rect_raw";
+      const sample = await context.getDepthDistance(transport, topic, 5000);
+      const text = sample.valid
+        ? `Object is ${sample.distance_m.toFixed(1)} meters away.`
+        : `No valid depth reading on ${topic}.`;
+      return {
+        content: [{ type: "text", text }],
+        details: sample,
+      };
+    },
+  });
+}

package/templates/skills/depth/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/hello/README.md

@@ -0,0 +1,32 @@
+# {{displayName}}
+
+{{description}}
+
+> **Tutorial skill** — meant for local learning with `npm run dev`. Customize the code or scaffold with `--template robot` before publishing to the marketplace.
+
+## Local dev
+
+```bash
+npm install
+npm run dev
+```
+
+## Invoke (OpenClaw / Claude / Gemini)
+
+After registering with your gateway:
+
+```bash
+agenticros skills add .
+agenticros skills sync
+# restart gateway
+```
+
+Try prompts from [demo.md](./demo.md).
+
+## Publish
+
+```bash
+npx agenticros publish
+```
+
+Tutorial skills stay unlisted on [skills.agenticros.com](https://skills.agenticros.com) unless you customize and use `--graduate`.

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/**/*"]
+}