@awi-protocol/react 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,15 @@
+$ tsup src/index.ts --format cjs,esm --dts --external react
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Target: es2022
+CJS Build start
+ESM Build start
+CJS dist\index.js 2.73 KB
+CJS ⚡️ Build success in 30ms
+ESM dist\index.mjs 1.61 KB
+ESM ⚡️ Build success in 30ms
+DTS Build start
+DTS ⚡️ Build success in 729ms
+DTS dist\index.d.ts  1.28 KB
+DTS dist\index.d.mts 1.28 KB

package/dist/index.d.mts

@@ -0,0 +1,48 @@
+import { AgentRequest, AgentResponse, AWIClientOptions } from '@awi-protocol/sdk';
+export { AWIClient, AgentRequest, AgentResponse, Recipe, RegistryEntry } from '@awi-protocol/sdk';
+
+/**
+ * React hooks for AWI
+ *
+ * @example
+ * ```tsx
+ * import { useAWI } from '@awi-protocol/react';
+ *
+ * function JobSearch() {
+ *   const { execute, loading, data, error } = useAWI({
+ *     endpoint: 'https://awi.example.com',
+ *     certificate: 'your-jwt',
+ *   });
+ *
+ *   const search = async (query: string) => {
+ *     await execute({
+ *       target: 'awi://linkedin.com/jobs/search/v1',
+ *       params: { query },
+ *     });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {loading && <Spinner />}
+ *       {error && <Error message={error.message} />}
+ *       {data && <JobList jobs={data} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+
+interface UseAWIResult<T = unknown> {
+    execute: (request: Omit<AgentRequest, 'mode'>) => Promise<AgentResponse<T>>;
+    explore: (domain: string, action: string) => Promise<AgentResponse<unknown>>;
+    loading: boolean;
+    data: T | null;
+    error: Error | null;
+    metrics: {
+        latency_ms: number;
+        fallback_count: number;
+    } | null;
+}
+declare function useAWI<T = unknown>(options: AWIClientOptions): UseAWIResult<T>;
+
+export { type UseAWIResult, useAWI };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { AgentRequest, AgentResponse, AWIClientOptions } from '@awi-protocol/sdk';
+export { AWIClient, AgentRequest, AgentResponse, Recipe, RegistryEntry } from '@awi-protocol/sdk';
+
+/**
+ * React hooks for AWI
+ *
+ * @example
+ * ```tsx
+ * import { useAWI } from '@awi-protocol/react';
+ *
+ * function JobSearch() {
+ *   const { execute, loading, data, error } = useAWI({
+ *     endpoint: 'https://awi.example.com',
+ *     certificate: 'your-jwt',
+ *   });
+ *
+ *   const search = async (query: string) => {
+ *     await execute({
+ *       target: 'awi://linkedin.com/jobs/search/v1',
+ *       params: { query },
+ *     });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {loading && <Spinner />}
+ *       {error && <Error message={error.message} />}
+ *       {data && <JobList jobs={data} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+
+interface UseAWIResult<T = unknown> {
+    execute: (request: Omit<AgentRequest, 'mode'>) => Promise<AgentResponse<T>>;
+    explore: (domain: string, action: string) => Promise<AgentResponse<unknown>>;
+    loading: boolean;
+    data: T | null;
+    error: Error | null;
+    metrics: {
+        latency_ms: number;
+        fallback_count: number;
+    } | null;
+}
+declare function useAWI<T = unknown>(options: AWIClientOptions): UseAWIResult<T>;
+
+export { type UseAWIResult, useAWI };

package/dist/index.js

@@ -0,0 +1,86 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AWIClient: () => import_sdk2.AWIClient,
+  useAWI: () => useAWI
+});
+module.exports = __toCommonJS(index_exports);
+var import_react = require("react");
+var import_sdk = require("@awi-protocol/sdk");
+var import_sdk2 = require("@awi-protocol/sdk");
+function useAWI(options) {
+  const [client] = (0, import_react.useState)(() => new import_sdk.AWIClient(options));
+  const [loading, setLoading] = (0, import_react.useState)(false);
+  const [data, setData] = (0, import_react.useState)(null);
+  const [error, setError] = (0, import_react.useState)(null);
+  const [metrics, setMetrics] = (0, import_react.useState)(null);
+  const execute = (0, import_react.useCallback)(async (request) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await client.execute(request);
+      if (result.success) {
+        setData(result.data);
+      } else {
+        setError(new Error(result.errors[0]?.message || "Execution failed"));
+      }
+      setMetrics({
+        latency_ms: result.metadata?.latency_ms || 0,
+        fallback_count: result.metadata?.fallback_count || 0
+      });
+      return result;
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error(String(err));
+      setError(error2);
+      throw error2;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+  const explore = (0, import_react.useCallback)(async (domain, action) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await client.explore(domain, action);
+      return result;
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error(String(err));
+      setError(error2);
+      throw error2;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+  return {
+    execute,
+    explore,
+    loading,
+    data,
+    error,
+    metrics
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AWIClient,
+  useAWI
+});

package/dist/index.mjs

@@ -0,0 +1,60 @@
+// src/index.ts
+import { useState, useCallback } from "react";
+import { AWIClient } from "@awi-protocol/sdk";
+import { AWIClient as AWIClient2 } from "@awi-protocol/sdk";
+function useAWI(options) {
+  const [client] = useState(() => new AWIClient(options));
+  const [loading, setLoading] = useState(false);
+  const [data, setData] = useState(null);
+  const [error, setError] = useState(null);
+  const [metrics, setMetrics] = useState(null);
+  const execute = useCallback(async (request) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await client.execute(request);
+      if (result.success) {
+        setData(result.data);
+      } else {
+        setError(new Error(result.errors[0]?.message || "Execution failed"));
+      }
+      setMetrics({
+        latency_ms: result.metadata?.latency_ms || 0,
+        fallback_count: result.metadata?.fallback_count || 0
+      });
+      return result;
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error(String(err));
+      setError(error2);
+      throw error2;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+  const explore = useCallback(async (domain, action) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await client.explore(domain, action);
+      return result;
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error(String(err));
+      setError(error2);
+      throw error2;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+  return {
+    execute,
+    explore,
+    loading,
+    data,
+    error,
+    metrics
+  };
+}
+export {
+  AWIClient2 as AWIClient,
+  useAWI
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@awi-protocol/react",
+  "version": "0.1.0",
+  "description": "React hooks for AWI (Agent Web Interface)",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --external react",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "awi",
+    "agent-web-interface",
+    "react",
+    "hooks",
+    "ai-agent",
+    "browser-automation"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0"
+  },
+  "dependencies": {
+    "@awi-protocol/sdk": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "react": "^18.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,109 @@
+/**
+ * React hooks for AWI
+ * 
+ * @example
+ * ```tsx
+ * import { useAWI } from '@awi-protocol/react';
+ * 
+ * function JobSearch() {
+ *   const { execute, loading, data, error } = useAWI({
+ *     endpoint: 'https://awi.example.com',
+ *     certificate: 'your-jwt',
+ *   });
+ * 
+ *   const search = async (query: string) => {
+ *     await execute({
+ *       target: 'awi://linkedin.com/jobs/search/v1',
+ *       params: { query },
+ *     });
+ *   };
+ * 
+ *   return (
+ *     <div>
+ *       {loading && <Spinner />}
+ *       {error && <Error message={error.message} />}
+ *       {data && <JobList jobs={data} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+
+import { useState, useCallback } from 'react';
+import { AWIClient, type AgentRequest, type AgentResponse, type AWIClientOptions } from '@awi-protocol/sdk';
+
+export interface UseAWIResult<T = unknown> {
+  execute: (request: Omit<AgentRequest, 'mode'>) => Promise<AgentResponse<T>>;
+  explore: (domain: string, action: string) => Promise<AgentResponse<unknown>>;
+  loading: boolean;
+  data: T | null;
+  error: Error | null;
+  metrics: {
+    latency_ms: number;
+    fallback_count: number;
+  } | null;
+}
+
+export function useAWI<T = unknown>(options: AWIClientOptions): UseAWIResult<T> {
+  const [client] = useState(() => new AWIClient(options));
+  const [loading, setLoading] = useState(false);
+  const [data, setData] = useState<T | null>(null);
+  const [error, setError] = useState<Error | null>(null);
+  const [metrics, setMetrics] = useState<UseAWIResult['metrics']>(null);
+
+  const execute = useCallback(async (request: Omit<AgentRequest, 'mode'>) => {
+    setLoading(true);
+    setError(null);
+
+    try {
+      const result = await client.execute<T>(request);
+
+      if (result.success) {
+        setData(result.data);
+      } else {
+        setError(new Error(result.errors[0]?.message || 'Execution failed'));
+      }
+
+      setMetrics({
+        latency_ms: result.metadata?.latency_ms || 0,
+        fallback_count: (result.metadata?.fallback_count as number) || 0,
+      });
+
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      setError(error);
+      throw error;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+
+  const explore = useCallback(async (domain: string, action: string) => {
+    setLoading(true);
+    setError(null);
+
+    try {
+      const result = await client.explore(domain, action);
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      setError(error);
+      throw error;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+
+  return {
+    execute,
+    explore,
+    loading,
+    data,
+    error,
+    metrics,
+  };
+}
+
+export { AWIClient } from '@awi-protocol/sdk';
+export type { AgentRequest, AgentResponse, Recipe, RegistryEntry } from '@awi-protocol/sdk';

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "jsx": "react-jsx",
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}