@agentuity/claude-code 1.0.5 → 1.0.7

package/skills/agentuity-command-runner/SKILL.md

@@ -34,33 +34,33 @@ Before running ANY command, detect the correct runtime:
 
 ### JavaScript/TypeScript (bun/npm/pnpm/yarn)
 
-| Task | bun | npm | pnpm |
-|------|-----|-----|------|
-| install | `bun install` | `npm install` | `pnpm install` |
-| build | `bun run build` | `npm run build` | `pnpm run build` |
-| test | `bun test` | `npm test` | `pnpm test` |
+| Task      | bun                 | npm                 | pnpm                 |
+| --------- | ------------------- | ------------------- | -------------------- |
+| install   | `bun install`       | `npm install`       | `pnpm install`       |
+| build     | `bun run build`     | `npm run build`     | `pnpm run build`     |
+| test      | `bun test`          | `npm test`          | `pnpm test`          |
 | typecheck | `bun run typecheck` | `npm run typecheck` | `pnpm run typecheck` |
-| lint | `bun run lint` | `npm run lint` | `pnpm run lint` |
-| format | `bun run format` | `npm run format` | `pnpm run format` |
-| clean | `bun run clean` | `npm run clean` | `pnpm run clean` |
+| lint      | `bun run lint`      | `npm run lint`      | `pnpm run lint`      |
+| format    | `bun run format`    | `npm run format`    | `pnpm run format`    |
+| clean     | `bun run clean`     | `npm run clean`     | `pnpm run clean`     |
 
 ### Go
 
-| Task | Command |
-|------|---------|
-| build | `go build ./...` |
-| test | `go test ./...` |
-| lint | `golangci-lint run` |
-| format | `go fmt ./...` |
+| Task   | Command             |
+| ------ | ------------------- |
+| build  | `go build ./...`    |
+| test   | `go test ./...`     |
+| lint   | `golangci-lint run` |
+| format | `go fmt ./...`      |
 
 ### Rust (cargo)
 
-| Task | Command |
-|------|---------|
-| build | `cargo build` |
-| test | `cargo test` |
-| lint | `cargo clippy` |
-| format | `cargo fmt` |
+| Task   | Command        |
+| ------ | -------------- |
+| build  | `cargo build`  |
+| test   | `cargo test`   |
+| lint   | `cargo clippy` |
+| format | `cargo fmt`    |
 
 ## Output Parsing Intelligence
 
@@ -74,17 +74,18 @@ Before running ANY command, detect the correct runtime:
 
 ### Error Classification
 
-| Type | Signal Words |
-|------|-------------|
-| Type Error | "Type", "TS", "cannot assign", "not assignable" |
-| Syntax Error | "Unexpected", "SyntaxError", "Parse error" |
-| Lint Error | "eslint", "biome", "warning", "rule" |
-| Test Failure | "FAIL", "AssertionError", "expect", "assert" |
-| Build Error | "Build failed", "Cannot find module" |
+| Type         | Signal Words                                    |
+| ------------ | ----------------------------------------------- |
+| Type Error   | "Type", "TS", "cannot assign", "not assignable" |
+| Syntax Error | "Unexpected", "SyntaxError", "Parse error"      |
+| Lint Error   | "eslint", "biome", "warning", "rule"            |
+| Test Failure | "FAIL", "AssertionError", "expect", "assert"    |
+| Build Error  | "Build failed", "Cannot find module"            |
 
 ### Location Extraction
 
 Extract file:line from common formats:
+
 - TypeScript: `src/foo.ts(10,5): error TS2322`
 - ESLint: `src/foo.ts:10:5 error`
 - Go: `./pkg/foo.go:10:5:`
@@ -103,15 +104,15 @@ Extract file:line from common formats:
 
 ### Errors ([count])
 
-| File | Line | Type | Message |
-|------|------|------|---------|
-| `src/foo.ts` | 45 | Type | Type 'string' is not assignable to type 'number' |
+| File         | Line | Type | Message                                          |
+| ------------ | ---- | ---- | ------------------------------------------------ |
+| `src/foo.ts` | 45   | Type | Type 'string' is not assignable to type 'number' |
 
 ### Warnings ([count])
 
-| File | Line | Message |
-|------|------|---------|
-| `src/baz.ts` | 8 | Unused import 'y' |
+| File         | Line | Message           |
+| ------------ | ---- | ----------------- |
+| `src/baz.ts` | 8    | Unused import 'y' |
 
 ### Summary
 

package/skills/agentuity-frontend/SKILL.md

@@ -10,16 +10,17 @@ Deep reference material for the Agentuity SDK frontend packages used to build we
 
 ## Package Overview
 
-| Package | Purpose |
-|---------|---------|
-| `@agentuity/react` | React hooks for calling agents (useAPI, useWebsocket) |
-| `@agentuity/frontend` | Framework-agnostic web utilities |
-| `@agentuity/auth` | Authentication (server + client) |
-| `@agentuity/workbench` | Dev UI for testing agents |
+| Package                | Purpose                                               |
+| ---------------------- | ----------------------------------------------------- |
+| `@agentuity/react`     | React hooks for calling agents (useAPI, useWebsocket) |
+| `@agentuity/frontend`  | Framework-agnostic web utilities                      |
+| `@agentuity/auth`      | Authentication (server + client)                      |
+| `@agentuity/workbench` | Dev UI for testing agents                             |
 
 ## Reference URLs
 
 When uncertain, look up:
+
 - **SDK Source**: https://github.com/agentuity/sdk/tree/main/packages
 - **Docs**: https://agentuity.dev
 - **React Package**: https://github.com/agentuity/sdk/tree/main/packages/react/src
@@ -37,11 +38,11 @@ React hooks and components for Agentuity web applications.
 import { AgentuityProvider } from '@agentuity/react';
 
 function App() {
-   return (
-      <AgentuityProvider>
-         <MyApp />
-      </AgentuityProvider>
-   );
+	return (
+		<AgentuityProvider>
+			<MyApp />
+		</AgentuityProvider>
+	);
 }
 ```
 
@@ -55,42 +56,43 @@ Call agents/routes from React components with automatic type inference.
 import { useAPI } from '@agentuity/react';
 
 function ChatComponent() {
-   // For POST/mutation routes
-   const { data, invoke, isLoading, isSuccess, isError, error, reset } = useAPI('POST /agent/chat');
-
-   const handleSubmit = async (message: string) => {
-      await invoke({ message });
-   };
-
-   return (
-      <div>
-         {isLoading && <p>Loading...</p>}
-         {data && <p>Response: {data.reply}</p>}
-         {error && <p>Error: {error.message}</p>}
-         <button onClick={() => handleSubmit('Hello!')}>Send</button>
-      </div>
-   );
+	// For POST/mutation routes
+	const { data, invoke, isLoading, isSuccess, isError, error, reset } = useAPI('POST /agent/chat');
+
+	const handleSubmit = async (message: string) => {
+		await invoke({ message });
+	};
+
+	return (
+		<div>
+			{isLoading && <p>Loading...</p>}
+			{data && <p>Response: {data.reply}</p>}
+			{error && <p>Error: {error.message}</p>}
+			<button onClick={() => handleSubmit('Hello!')}>Send</button>
+		</div>
+	);
 }
 
 // For GET routes (auto-fetches on mount)
 function UserProfile() {
-   const { data, isLoading, isFetching, refetch } = useAPI('GET /api/user');
-   // data is fetched automatically on mount
-   // isFetching is true during refetches
+	const { data, isLoading, isFetching, refetch } = useAPI('GET /api/user');
+	// data is fetched automatically on mount
+	// isFetching is true during refetches
 }
 ```
 
 **Options:**
+
 ```typescript
 const { data, invoke } = useAPI({
-   route: 'POST /agent/my-agent',
-   headers: { 'X-Custom': 'value' },
+	route: 'POST /agent/my-agent',
+	headers: { 'X-Custom': 'value' },
 });
 
 // Streaming support
 const { data, invoke } = useAPI('POST /agent/stream', {
-   delimiter: '\n',
-   onChunk: (chunk) => console.log('Received chunk:', chunk),
+	delimiter: '\n',
+	onChunk: (chunk) => console.log('Received chunk:', chunk),
 });
 ```
 
@@ -102,37 +104,40 @@ Real-time bidirectional communication.
 import { useWebsocket } from '@agentuity/react';
 
 function LiveChat() {
-   const {
-      isConnected,
-      send,
-      close,
-      data,           // Latest message
-      messages,       // All messages array
-      clearMessages,  // Clear message history
-      error,
-      readyState
-   } = useWebsocket('/ws/chat');
-
-   // Messages are accessed via data (latest) or messages (all)
-   useEffect(() => {
-      if (data) {
-         console.log('Received:', data);
-      }
-   }, [data]);
-
-   return (
-      <div>
-         <p>Status: {isConnected ? 'Connected' : 'Disconnected'}</p>
-         <button onClick={() => send({ type: 'ping' })}>Ping</button>
-         <ul>
-            {messages.map((msg, i) => <li key={i}>{JSON.stringify(msg)}</li>)}
-         </ul>
-      </div>
-   );
+	const {
+		isConnected,
+		send,
+		close,
+		data, // Latest message
+		messages, // All messages array
+		clearMessages, // Clear message history
+		error,
+		readyState,
+	} = useWebsocket('/ws/chat');
+
+	// Messages are accessed via data (latest) or messages (all)
+	useEffect(() => {
+		if (data) {
+			console.log('Received:', data);
+		}
+	}, [data]);
+
+	return (
+		<div>
+			<p>Status: {isConnected ? 'Connected' : 'Disconnected'}</p>
+			<button onClick={() => send({ type: 'ping' })}>Ping</button>
+			<ul>
+				{messages.map((msg, i) => (
+					<li key={i}>{JSON.stringify(msg)}</li>
+				))}
+			</ul>
+		</div>
+	);
 }
 ```
 
 **Features:**
+
 - Auto-reconnection on connection loss
 - Message queuing when disconnected
 - Auth tokens auto-injected when AuthProvider is in tree
@@ -146,12 +151,12 @@ Access authentication state.
 import { useAuth } from '@agentuity/react';
 
 function UserProfile() {
-   const { isAuthenticated, authLoading, authHeader } = useAuth();
+	const { isAuthenticated, authLoading, authHeader } = useAuth();
 
-   if (authLoading) return <p>Loading...</p>;
-   if (!isAuthenticated) return <p>Please sign in</p>;
+	if (authLoading) return <p>Loading...</p>;
+	if (!isAuthenticated) return <p>Please sign in</p>;
 
-   return <p>Welcome back!</p>;
+	return <p>Welcome back!</p>;
 }
 ```
 
@@ -171,9 +176,9 @@ import { createRouter } from '@agentuity/runtime';
 
 // Create auth instance
 const auth = createAuth({
-   connectionString: process.env.DATABASE_URL,
-   // Optional: custom base path (default: /api/auth)
-   basePath: '/api/auth',
+	connectionString: process.env.DATABASE_URL,
+	// Optional: custom base path (default: /api/auth)
+	basePath: '/api/auth',
 });
 
 const router = createRouter();
@@ -193,16 +198,16 @@ When using auth middleware, `ctx.auth` is available in agent handlers:
 import { createAgent } from '@agentuity/runtime';
 
 export default createAgent('protected-agent', {
-   handler: async (ctx, input) => {
-      // ctx.auth is null for unauthenticated requests
-      if (!ctx.auth) {
-         return { error: 'Please sign in' };
-      }
-
-      // Get authenticated user
-      const user = await ctx.auth.getUser();
-      return { message: `Hello ${user.name}` };
-   },
+	handler: async (ctx, input) => {
+		// ctx.auth is null for unauthenticated requests
+		if (!ctx.auth) {
+			return { error: 'Please sign in' };
+		}
+
+		// Get authenticated user
+		const user = await ctx.auth.getUser();
+		return { message: `Hello ${user.name}` };
+	},
 });
 ```
 
@@ -212,13 +217,13 @@ export default createAgent('protected-agent', {
 import { AuthProvider } from '@agentuity/react';
 
 function App() {
-   return (
-      <AuthProvider>
-         <AgentuityProvider>
-            <MyApp />
-         </AgentuityProvider>
-      </AuthProvider>
-   );
+	return (
+		<AuthProvider>
+			<AgentuityProvider>
+				<MyApp />
+			</AgentuityProvider>
+		</AuthProvider>
+	);
 }
 ```
 
@@ -232,7 +237,7 @@ import * as schema from './schema';
 const { db, close } = createPostgresDrizzle({ schema });
 
 const auth = createAuth({
-   database: drizzleAdapter(db, { provider: 'pg' }),
+	database: drizzleAdapter(db, { provider: 'pg' }),
 });
 ```
 
@@ -287,35 +292,35 @@ src/
 import { AuthProvider, AgentuityProvider, useAPI, useAuth } from '@agentuity/react';
 
 function App() {
-   return (
-      <AuthProvider>
-         <AgentuityProvider>
-            <ProtectedChat />
-         </AgentuityProvider>
-      </AuthProvider>
-   );
+	return (
+		<AuthProvider>
+			<AgentuityProvider>
+				<ProtectedChat />
+			</AgentuityProvider>
+		</AuthProvider>
+	);
 }
 
 function ProtectedChat() {
-   const { isAuthenticated } = useAuth();
-   const { data, invoke } = useAPI('POST /agent/chat');
+	const { isAuthenticated } = useAuth();
+	const { data, invoke } = useAPI('POST /agent/chat');
 
-   if (!isAuthenticated) return <SignIn />;
+	if (!isAuthenticated) return <SignIn />;
 
-   return (
-      <div>
-         <button onClick={() => invoke({ message: 'Hello' })}>Chat</button>
-         {data && <p>{data.reply}</p>}
-      </div>
-   );
+	return (
+		<div>
+			<button onClick={() => invoke({ message: 'Hello' })}>Chat</button>
+			{data && <p>{data.reply}</p>}
+		</div>
+	);
 }
 ```
 
 ## Common Mistakes
 
-| Mistake | Better Approach | Why |
-|---------|-----------------|-----|
-| Adding `baseUrl` inside Agentuity project | Omit `baseUrl` | Auto-detected in full-stack projects |
-| Using `fetch` directly for agents | Use `useAPI` hook | Type inference, auth injection, loading states |
-| Manual WebSocket management | Use `useWebsocket` hook | Auto-reconnect, auth injection, message queuing |
-| Missing AuthProvider | Wrap app with AuthProvider | Required for auth token injection |
+| Mistake                                   | Better Approach            | Why                                             |
+| ----------------------------------------- | -------------------------- | ----------------------------------------------- |
+| Adding `baseUrl` inside Agentuity project | Omit `baseUrl`             | Auto-detected in full-stack projects            |
+| Using `fetch` directly for agents         | Use `useAPI` hook          | Type inference, auth injection, loading states  |
+| Manual WebSocket management               | Use `useWebsocket` hook    | Auto-reconnect, auth injection, message queuing |
+| Missing AuthProvider                      | Wrap app with AuthProvider | Required for auth token injection               |

package/skills/agentuity-ops/SKILL.md

@@ -37,15 +37,15 @@ cat agentuity.json 2>/dev/null | grep region
 
 ## Golden Commands
 
-| Purpose | Command |
-|---------|---------|
-| Create project | `agentuity new` (interactive) or `agentuity new --name <name>` |
-| Start dev server | `bun run dev` → read output for actual URL |
-| Deploy | `agentuity deploy` → read output for deployment URL |
-| Check auth | `agentuity auth whoami` |
-| List regions | `agentuity region list` |
-| Get CLI help | `agentuity <command> --help` |
-| Show all commands | `agentuity ai schema show` |
+| Purpose           | Command                                                        |
+| ----------------- | -------------------------------------------------------------- |
+| Create project    | `agentuity new` (interactive) or `agentuity new --name <name>` |
+| Start dev server  | `bun run dev` → read output for actual URL                     |
+| Deploy            | `agentuity deploy` → read output for deployment URL            |
+| Check auth        | `agentuity auth whoami`                                        |
+| List regions      | `agentuity region list`                                        |
+| Get CLI help      | `agentuity <command> --help`                                   |
+| Show all commands | `agentuity ai schema show`                                     |
 
 ---
 
@@ -127,13 +127,13 @@ agentuity cloud sandbox snapshot list --json
 
 ### Network & Public URLs
 
-| Scenario | Use `--network`? | Use `--port`? |
-|----------|------------------|---------------|
-| Running tests locally | No | No |
-| Installing npm packages | Yes | No |
-| Running web server for internal testing | Yes | No |
-| Exposing dev preview to share | Yes | Yes |
-| API that external services call | Yes | Yes |
+| Scenario                                | Use `--network`? | Use `--port`? |
+| --------------------------------------- | ---------------- | ------------- |
+| Running tests locally                   | No               | No            |
+| Installing npm packages                 | Yes              | No            |
+| Running web server for internal testing | Yes              | No            |
+| Exposing dev preview to share           | Yes              | Yes           |
+| API that external services call         | Yes              | Yes           |
 
 **Public URL format:** `https://s{identifier}.agentuity.run`
 
@@ -186,9 +186,9 @@ agentuity cloud deployment get <deploymentId> --json
 
 ```json
 {
-  "projectId": "proj_abc123",
-  "orgId": "org_xyz",
-  "region": "use"
+	"projectId": "proj_abc123",
+	"orgId": "org_xyz",
+	"region": "use"
 }
 ```
 
@@ -198,10 +198,10 @@ Contains `orgId` from `preferences.orgId` — used as fallback when `agentuity.j
 
 ## Common Mistakes
 
-| Mistake | Better Approach | Why |
-|---------|-----------------|-----|
-| Blindly adding `--region` flag | Check config first | Region may already be configured |
-| Using npm for Agentuity projects | Always use `bun` | Agentuity is Bun-native |
+| Mistake                            | Better Approach       | Why                                  |
+| ---------------------------------- | --------------------- | ------------------------------------ |
+| Blindly adding `--region` flag     | Check config first    | Region may already be configured     |
+| Using npm for Agentuity projects   | Always use `bun`      | Agentuity is Bun-native              |
 | Hardcoding sandbox paths as `/app` | Use `/home/agentuity` | That's the default working directory |
-| Making up CLI flags | Run `--help` first | Flags change between versions |
-| Fabricating deployment URLs | Read actual output | URLs are generated dynamically |
+| Making up CLI flags                | Run `--help` first    | Flags change between versions        |
+| Fabricating deployment URLs        | Read actual output    | URLs are generated dynamically       |

package/src/install.ts

@@ -5,8 +5,8 @@
  * Sets up permissions for Agentuity Cloud CLI commands.
  */
 
-import { join } from "node:path";
-import { homedir } from "node:os";
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 
 export interface InstallConfig {
 	projectId?: string;
@@ -23,16 +23,13 @@ interface ClaudeSettings {
 	[key: string]: unknown;
 }
 
-const AGENTUITY_PERMISSIONS = [
-	"Bash(agentuity cloud *)",
-	"Bash(agentuity auth whoami *)",
-];
+const AGENTUITY_PERMISSIONS = ['Bash(agentuity cloud *)', 'Bash(agentuity auth whoami *)'];
 
 const AGENTUITY_DENY_PERMISSIONS = [
-	"Bash(agentuity cloud secrets *)",
-	"Bash(agentuity cloud secret *)",
-	"Bash(agentuity cloud apikey *)",
-	"Bash(agentuity auth token *)",
+	'Bash(agentuity cloud secrets *)',
+	'Bash(agentuity cloud secret *)',
+	'Bash(agentuity cloud apikey *)',
+	'Bash(agentuity auth token *)',
 ];
 
 /**
@@ -40,7 +37,7 @@ const AGENTUITY_DENY_PERMISSIONS = [
  */
 export async function readProjectConfig(): Promise<InstallConfig> {
 	try {
-		const file = Bun.file("agentuity.json");
+		const file = Bun.file('agentuity.json');
 		if (await file.exists()) {
 			const config = await file.json();
 			return {
@@ -73,11 +70,8 @@ async function readSettings(path: string): Promise<ClaudeSettings> {
 /**
  * Write a Claude Code settings JSON file.
  */
-async function writeSettings(
-	path: string,
-	settings: ClaudeSettings,
-): Promise<void> {
-	await Bun.write(path, JSON.stringify(settings, null, 2) + "\n");
+async function writeSettings(path: string, settings: ClaudeSettings): Promise<void> {
+	await Bun.write(path, JSON.stringify(settings, null, 2) + '\n');
 }
 
 /**
@@ -85,7 +79,7 @@ async function writeSettings(
  * Adds allow rules for agentuity cloud commands and deny rules for sensitive ones.
  */
 async function configurePermissions(): Promise<{ added: number }> {
-	const settingsPath = join(homedir(), ".claude", "settings.local.json");
+	const settingsPath = join(homedir(), '.claude', 'settings.local.json');
 	const settings = await readSettings(settingsPath);
 
 	if (!settings.permissions) {
@@ -131,18 +125,14 @@ export async function install(): Promise<void> {
 	// Configure Claude Code permissions for Agentuity Cloud commands
 	const { added } = await configurePermissions();
 	if (added > 0) {
-		console.log(
-			`Configured ${added} permission rules for Agentuity Cloud commands`,
-		);
+		console.log(`Configured ${added} permission rules for Agentuity Cloud commands`);
 	}
 
 	if (config.projectId) {
-		console.log(
-			`Agentuity Coder configured for project: ${config.projectId}`,
-		);
+		console.log(`Agentuity Coder configured for project: ${config.projectId}`);
 	} else {
 		console.log(
-			"Agentuity Coder installed (no agentuity.json found - will use session-start hook for context)",
+			'Agentuity Coder installed (no agentuity.json found - will use session-start hook for context)'
 		);
 	}
 }