@devicerail/tool-adapter 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+import type { DeviceRailClient } from "@devicerail/client";
+import type { ActionResult, Observation, RequestCancelResult, RpcId } from "@devicerail/protocol";
+export type DeviceRailToolClient = Pick<DeviceRailClient, "beginCall" | "call"> & {
+    readonly enabledFeatures?: ReadonlySet<string>;
+};
+export type ToolInputSchema = Readonly<Record<string, unknown>>;
+export interface ObservationToolDefinition {
+    readonly description: string;
+    readonly inputSchema: ToolInputSchema;
+    readonly kind: "observation";
+    readonly name: string;
+}
+export interface ActionToolDefinition {
+    readonly actionName: string;
+    readonly description: string;
+    readonly inputSchema: ToolInputSchema;
+    readonly kind: "action";
+    readonly name: string;
+    readonly protection?: "protected";
+}
+export type DeviceRailToolDefinition = ObservationToolDefinition | ActionToolDefinition;
+export interface ToolInvocation {
+    readonly arguments?: unknown;
+    readonly invocationId?: string;
+    readonly name: string;
+}
+export interface ToolInvocationOptions {
+    readonly actionTimeoutMs?: number;
+    readonly requestTimeoutMs?: number;
+    readonly signal?: AbortSignal;
+}
+export interface ObservationToolResult {
+    readonly invocationId?: string;
+    readonly kind: "observation";
+    readonly observation: Observation;
+    readonly requestId: RpcId;
+    readonly toolName: string;
+}
+export interface ActionToolResult {
+    readonly action: ActionResult;
+    readonly actionCallId: string;
+    readonly actionName: string;
+    readonly invocationId?: string;
+    readonly kind: "action";
+    readonly requestId: RpcId;
+    readonly toolName: string;
+}
+export type ToolInvocationResult = ObservationToolResult | ActionToolResult;
+interface BaseToolInvocationHandle<Result extends ToolInvocationResult> {
+    readonly requestId: RpcId;
+    readonly result: Promise<Result>;
+    cancel(): Promise<RequestCancelResult>;
+}
+export interface ObservationToolInvocationHandle extends BaseToolInvocationHandle<ObservationToolResult> {
+    readonly kind: "observation";
+}
+export interface ActionToolInvocationHandle extends BaseToolInvocationHandle<ActionToolResult> {
+    readonly actionCallId: string;
+    readonly actionName: string;
+    readonly kind: "action";
+}
+export type ToolInvocationHandle = ObservationToolInvocationHandle | ActionToolInvocationHandle;
+export interface DeviceRailToolCatalog {
+    readonly id: string;
+    readonly revision: number;
+    readonly tools: readonly DeviceRailToolDefinition[];
+    beginInvoke(invocation: ToolInvocation, options?: ToolInvocationOptions): ToolInvocationHandle;
+    invoke(invocation: ToolInvocation, options?: ToolInvocationOptions): Promise<ToolInvocationResult>;
+}
+export interface ToolDiscoveryOptions {
+    readonly requestTimeoutMs?: number;
+    readonly signal?: AbortSignal;
+}
+export interface DeviceRailToolAdapterOptions {
+    readonly includeObservation?: boolean;
+    readonly includeProtectedActions?: boolean;
+    readonly maxActions?: number;
+}
+export {};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@devicerail/tool-adapter",
+  "version": "0.1.0",
+  "description": "Provider-neutral AI tool adapter for DeviceRail device capabilities",
+  "license": "Apache-2.0",
+  "keywords": [
+    "ai-agent",
+    "ai-tools",
+    "device-automation",
+    "test-automation"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@types/node": "26.1.1",
+    "@devicerail/client": "0.1.0",
+    "@devicerail/protocol": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wangweiwei/device-rail.git",
+    "directory": "packages/tool-adapter"
+  },
+  "homepage": "https://github.com/wangweiwei/device-rail#readme",
+  "bugs": {
+    "url": "https://github.com/wangweiwei/device-rail/issues"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "node scripts/clean.mjs dist && tsc -p tsconfig.build.json && tsc -p tsconfig.package-exports.json && node scripts/check-package-exports.mjs",
+    "test": "node scripts/clean.mjs .test-dist && tsc -p tsconfig.test.json && node scripts/run-tests.mjs"
+  }
+}