@agentuity/react 0.0.1

package/dist/run.d.ts

@@ -0,0 +1,31 @@
+import type { InferInput, InferOutput } from '@agentuity/core';
+import type { AgentName, AgentRegistry } from './types';
+interface RunArgs {
+    /**
+     * Optional query parameters to append to the URL
+     */
+    query?: URLSearchParams;
+    /**
+     * Optional headers to send with the request
+     */
+    headers?: Record<string, string>;
+    /**
+     * Optional subpath to append to the agent path (such as /agent/:agent_name/:subpath)
+     */
+    subpath?: string;
+    /**
+     * HTTP method to use (default: POST)
+     */
+    method?: string;
+    /**
+     * Optional AbortSignal to cancel the request
+     */
+    signal?: AbortSignal;
+}
+interface UseAgentResponse<TInput, TOutput> {
+    data?: TOutput;
+    run: (input: TInput, options?: RunArgs) => Promise<TOutput>;
+}
+export declare const useAgent: <TName extends AgentName, TInput = TName extends keyof AgentRegistry ? InferInput<AgentRegistry[TName]["inputSchema"]> : never, TOutput = TName extends keyof AgentRegistry ? InferOutput<AgentRegistry[TName]["outputSchema"]> : never>(name: TName) => UseAgentResponse<TInput, TOutput>;
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,UAAU,OAAO;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,UAAU,gBAAgB,CAAC,MAAM,EAAE,OAAO;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5D;AAED,eAAO,MAAM,QAAQ,GACpB,KAAK,SAAS,SAAS,EACvB,MAAM,GAAG,KAAK,SAAS,MAAM,aAAa,GACvC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC,GAC/C,KAAK,EACR,OAAO,GAAG,KAAK,SAAS,MAAM,aAAa,GACxC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC,GACjD,KAAK,EAER,MAAM,KAAK,KACT,gBAAgB,CAAC,MAAM,EAAE,OAAO,CA4ClC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+import type { StandardSchemaV1 } from '@agentuity/core';
+/**
+ * Agent definition interface
+ */
+export interface Agent<TInput extends StandardSchemaV1 = StandardSchemaV1, TOutput extends StandardSchemaV1 = StandardSchemaV1> {
+    inputSchema: TInput;
+    outputSchema: TOutput;
+}
+/**
+ * Registry of all agents in the project.
+ * This interface is designed to be augmented by generated code in the user's project.
+ *
+ * Example usage in generated code (.agentuity/types.d.ts):
+ * ```typescript
+ * import type { Agent } from '@agentuity/react';
+ * import type { MyInputSchema, MyOutputSchema } from './schemas';
+ *
+ * declare module '@agentuity/react' {
+ *   interface AgentRegistry {
+ *     'my-agent': Agent<MyInputSchema, MyOutputSchema>;
+ *     'another-agent': Agent<AnotherInput, AnotherOutput>;
+ *   }
+ * }
+ * ```
+ */
+export interface AgentRegistry {
+}
+/**
+ * Union type of all registered agent names.
+ * Falls back to `string` when AgentRegistry is empty (before augmentation).
+ * After augmentation, this becomes a strict union of agent names for full type safety.
+ */
+export type AgentName = keyof AgentRegistry extends never ? string : keyof AgentRegistry;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,KAAK,CACrB,MAAM,SAAS,gBAAgB,GAAG,gBAAgB,EAClD,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IAEnD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,aAAa;CAAG;AAEjC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,aAAa,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,aAAa,CAAC"}

package/dist/url.d.ts

@@ -0,0 +1,3 @@
+export declare const buildUrl: (base: string, path: string, subpath?: string, query?: URLSearchParams) => string;
+export declare const defaultBaseUrl: string;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,GACpB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,QAAQ,eAAe,KACrB,MAWF,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAIL,CAAC"}

package/dist/websocket.d.ts

@@ -0,0 +1,34 @@
+import type { InferInput, InferOutput } from '@agentuity/core';
+import type { AgentName, AgentRegistry } from './types';
+type onMessageHandler<T = unknown> = (data: T) => void;
+interface WebsocketArgs {
+    /**
+     * Optional query parameters to append to the websocket URL
+     */
+    query?: URLSearchParams;
+    /**
+     * Optional subpath to append to the agent path (such as /agent/:agent_name/:subpath)
+     */
+    subpath?: string;
+    /**
+     * Optional AbortSignal to cancel the websocket connection
+     */
+    signal?: AbortSignal;
+}
+interface WebsocketResponse<TInput, TOutput> {
+    connected: boolean;
+    send: (data: TInput) => void;
+    setHandler: (handler: onMessageHandler<TOutput>) => void;
+    readyState: WebSocket['readyState'];
+    close: () => void;
+}
+export declare const useWebsocket: <TInput, TOutput>(path: string, options?: WebsocketArgs) => WebsocketResponse<TInput, TOutput>;
+interface UseAgentWebsocketResponse<TInput, TOutput> extends Omit<WebsocketResponse<TInput, TOutput>, 'setHandler'> {
+    /**
+     * Data received from the agent via WebSocket
+     */
+    data?: TOutput;
+}
+export declare const useAgentWebsocket: <TName extends AgentName, TInput = TName extends keyof AgentRegistry ? InferInput<AgentRegistry[TName]["inputSchema"]> : never, TOutput = TName extends keyof AgentRegistry ? InferOutput<AgentRegistry[TName]["outputSchema"]> : never>(agent: AgentName, options?: WebsocketArgs) => UseAgentWebsocketResponse<TInput, TOutput>;
+export {};
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,KAAK,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEvD,UAAU,aAAa;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AA8BD,UAAU,iBAAiB,CAAC,MAAM,EAAE,OAAO;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,UAAU,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACzD,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,EAAE,OAAO,EAC3C,MAAM,MAAM,EACZ,UAAU,aAAa,KACrB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CA4GnC,CAAC;AAEF,UAAU,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAClD,SAAQ,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC;IAC9D;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,eAAO,MAAM,iBAAiB,GAC7B,KAAK,SAAS,SAAS,EACvB,MAAM,GAAG,KAAK,SAAS,MAAM,aAAa,GACvC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC,GAC/C,KAAK,EACR,OAAO,GAAG,KAAK,SAAS,MAAM,aAAa,GACxC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC,GACjD,KAAK,EAER,OAAO,SAAS,EAChB,UAAU,aAAa,KACrB,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAkB3C,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+	"name": "@agentuity/react",
+	"version": "0.0.1",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"clean": "rm -rf dist",
+		"build": "bun build --target browser --outdir dist src/index.ts && bunx tsc --build --force",
+		"typecheck": "bunx tsc --noEmit",
+		"prepublishOnly": "bun run clean && bun run build"
+	},
+	"dependencies": {
+		"@agentuity/core": "workspace:*"
+	},
+	"devDependencies": {
+		"@types/react": "^19.0.0",
+		"react": "^19.0.0",
+		"typescript": "^5.9.0"
+	},
+	"peerDependencies": {
+		"react": "^18.0.0 || ^19.0.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}