@agentuity/server 1.0.32 → 1.0.34

package/dist/api/webhook/webhooks.d.ts

@@ -1,146 +0,0 @@
-import { z } from 'zod';
-import { type APIClient } from '../api.ts';
-import { type CreateWebhookRequest, type ListWebhooksRequest, type UpdateWebhookRequest, type Webhook, type WebhookApiOptions } from './types.ts';
-export declare const WebhookResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    success: z.ZodLiteral<false>;
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    success: z.ZodLiteral<true>;
-    data: z.ZodObject<{
-        id: z.ZodString;
-        created_at: z.ZodString;
-        updated_at: z.ZodString;
-        created_by: z.ZodString;
-        name: z.ZodString;
-        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        url: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-}, z.core.$strip>], "success">;
-export declare const WebhooksListResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    success: z.ZodLiteral<false>;
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    success: z.ZodLiteral<true>;
-    data: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        created_at: z.ZodString;
-        updated_at: z.ZodString;
-        created_by: z.ZodString;
-        name: z.ZodString;
-        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        url: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>], "success">;
-export declare const DeleteWebhookResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    success: z.ZodLiteral<false>;
-    message: z.ZodString;
-    code: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    success: z.ZodLiteral<true>;
-}, z.core.$strip>], "success">;
-/**
- * Create a new webhook.
- *
- * Creates a webhook with the specified name and optional description.
- *
- * @param client - The API client instance
- * @param params - Webhook creation parameters
- * @param options - Optional API options (e.g., orgId)
- * @returns The created webhook
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * const webhook = await createWebhook(client, {
- *   name: 'github-events',
- *   description: 'Receives GitHub webhook events',
- * });
- * console.log(`Created webhook: ${webhook.id}`);
- * ```
- */
-export declare function createWebhook(client: APIClient, params: CreateWebhookRequest, options?: WebhookApiOptions): Promise<Webhook>;
-/**
- * Get a webhook by ID.
- *
- * Retrieves the webhook details.
- *
- * @param client - The API client instance
- * @param webhookId - The webhook ID (prefixed with wh_)
- * @param options - Optional API options (e.g., orgId)
- * @returns The webhook details
- * @throws {WebhookNotFoundError} If the webhook does not exist
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * const webhook = await getWebhook(client, 'wh_abc123');
- * console.log(`Webhook: ${webhook.name}`);
- * ```
- */
-export declare function getWebhook(client: APIClient, webhookId: string, options?: WebhookApiOptions): Promise<Webhook>;
-/**
- * List all webhooks with optional pagination.
- *
- * @param client - The API client instance
- * @param params - Optional pagination parameters
- * @param options - Optional API options (e.g., orgId)
- * @returns Object containing the list of webhooks
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * // List first 10 webhooks
- * const { webhooks } = await listWebhooks(client, { limit: 10 });
- * console.log(`Found ${webhooks.length} webhooks`);
- *
- * // Paginate through all webhooks
- * const { webhooks: page2 } = await listWebhooks(client, { limit: 10, offset: 10 });
- * ```
- */
-export declare function listWebhooks(client: APIClient, params?: ListWebhooksRequest, options?: WebhookApiOptions): Promise<{
-    webhooks: Webhook[];
-}>;
-/**
- * Update an existing webhook.
- *
- * Updates the webhook name and/or description.
- *
- * @param client - The API client instance
- * @param webhookId - The webhook ID (prefixed with wh_)
- * @param params - Update parameters
- * @param options - Optional API options (e.g., orgId)
- * @returns The updated webhook
- * @throws {WebhookNotFoundError} If the webhook does not exist
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * const webhook = await updateWebhook(client, 'wh_abc123', {
- *   name: 'github-events-v2',
- *   description: 'Updated description',
- * });
- * ```
- */
-export declare function updateWebhook(client: APIClient, webhookId: string, params: UpdateWebhookRequest, options?: WebhookApiOptions): Promise<Webhook>;
-/**
- * Delete a webhook.
- *
- * Permanently deletes a webhook and all its destinations, receipts, and deliveries.
- * This action cannot be undone.
- *
- * @param client - The API client instance
- * @param webhookId - The webhook ID (prefixed with wh_)
- * @param options - Optional API options (e.g., orgId)
- * @throws {WebhookNotFoundError} If the webhook does not exist
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * await deleteWebhook(client, 'wh_abc123');
- * console.log('Webhook deleted');
- * ```
- */
-export declare function deleteWebhook(client: APIClient, webhookId: string, options?: WebhookApiOptions): Promise<void>;
-//# sourceMappingURL=webhooks.d.ts.map

package/dist/api/webhook/webhooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/api/webhook/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,WAAW,CAAC;AACvF,OAAO,EACN,KAAK,oBAAoB,EAEzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAEzB,KAAK,OAAO,EACZ,KAAK,iBAAiB,EAEtB,MAAM,YAAY,CAAC;AASpB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;8BAAmC,CAAC;AACtE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;8BAA4C,CAAC;AACpF,eAAO,MAAM,2BAA2B;;;;;;8BAA4B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAelB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CA6BlC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/api/webhook/webhooks.js

@@ -1,165 +0,0 @@
-import { z } from 'zod';
-import { APIResponseSchema, APIResponseSchemaNoData } from "../api.js";
-import { CreateWebhookRequestSchema, UpdateWebhookRequestSchema, WebhookSchema, } from "./types.js";
-import { buildWebhookHeaders, WebhookError, webhookApiPath, webhookApiPathWithQuery, withWebhookErrorHandling, } from "./util.js";
-export const WebhookResponseSchema = APIResponseSchema(WebhookSchema);
-export const WebhooksListResponseSchema = APIResponseSchema(z.array(WebhookSchema));
-export const DeleteWebhookResponseSchema = APIResponseSchemaNoData();
-/**
- * Create a new webhook.
- *
- * Creates a webhook with the specified name and optional description.
- *
- * @param client - The API client instance
- * @param params - Webhook creation parameters
- * @param options - Optional API options (e.g., orgId)
- * @returns The created webhook
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * const webhook = await createWebhook(client, {
- *   name: 'github-events',
- *   description: 'Receives GitHub webhook events',
- * });
- * console.log(`Created webhook: ${webhook.id}`);
- * ```
- */
-export async function createWebhook(client, params, options) {
-    const url = webhookApiPath('create');
-    const resp = await withWebhookErrorHandling(() => client.post(url, params, WebhookResponseSchema, CreateWebhookRequestSchema, undefined, buildWebhookHeaders(options?.orgId)), {});
-    if (resp.success) {
-        return resp.data;
-    }
-    throw new WebhookError({
-        message: resp.message || 'Failed to create webhook',
-    });
-}
-/**
- * Get a webhook by ID.
- *
- * Retrieves the webhook details.
- *
- * @param client - The API client instance
- * @param webhookId - The webhook ID (prefixed with wh_)
- * @param options - Optional API options (e.g., orgId)
- * @returns The webhook details
- * @throws {WebhookNotFoundError} If the webhook does not exist
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * const webhook = await getWebhook(client, 'wh_abc123');
- * console.log(`Webhook: ${webhook.name}`);
- * ```
- */
-export async function getWebhook(client, webhookId, options) {
-    const url = webhookApiPath('get', webhookId);
-    const resp = await withWebhookErrorHandling(() => client.get(url, WebhookResponseSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId });
-    if (resp.success) {
-        return resp.data;
-    }
-    throw new WebhookError({
-        webhookId,
-        message: resp.message || 'Failed to get webhook',
-    });
-}
-/**
- * List all webhooks with optional pagination.
- *
- * @param client - The API client instance
- * @param params - Optional pagination parameters
- * @param options - Optional API options (e.g., orgId)
- * @returns Object containing the list of webhooks
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * // List first 10 webhooks
- * const { webhooks } = await listWebhooks(client, { limit: 10 });
- * console.log(`Found ${webhooks.length} webhooks`);
- *
- * // Paginate through all webhooks
- * const { webhooks: page2 } = await listWebhooks(client, { limit: 10, offset: 10 });
- * ```
- */
-export async function listWebhooks(client, params, options) {
-    const searchParams = new URLSearchParams();
-    if (params?.limit !== undefined) {
-        searchParams.set('limit', String(params.limit));
-    }
-    if (params?.offset !== undefined) {
-        searchParams.set('offset', String(params.offset));
-    }
-    const queryString = searchParams.toString();
-    const url = webhookApiPathWithQuery('list', queryString || undefined);
-    const resp = await withWebhookErrorHandling(() => client.get(url, WebhooksListResponseSchema, undefined, buildWebhookHeaders(options?.orgId)), {});
-    if (resp.success) {
-        return { webhooks: resp.data };
-    }
-    throw new WebhookError({
-        message: resp.message || 'Failed to list webhooks',
-    });
-}
-/**
- * Update an existing webhook.
- *
- * Updates the webhook name and/or description.
- *
- * @param client - The API client instance
- * @param webhookId - The webhook ID (prefixed with wh_)
- * @param params - Update parameters
- * @param options - Optional API options (e.g., orgId)
- * @returns The updated webhook
- * @throws {WebhookNotFoundError} If the webhook does not exist
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * const webhook = await updateWebhook(client, 'wh_abc123', {
- *   name: 'github-events-v2',
- *   description: 'Updated description',
- * });
- * ```
- */
-export async function updateWebhook(client, webhookId, params, options) {
-    const url = webhookApiPath('update', webhookId);
-    const resp = await withWebhookErrorHandling(() => client.put(url, params, WebhookResponseSchema, UpdateWebhookRequestSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId });
-    if (resp.success) {
-        return resp.data;
-    }
-    throw new WebhookError({
-        webhookId,
-        message: resp.message || 'Failed to update webhook',
-    });
-}
-/**
- * Delete a webhook.
- *
- * Permanently deletes a webhook and all its destinations, receipts, and deliveries.
- * This action cannot be undone.
- *
- * @param client - The API client instance
- * @param webhookId - The webhook ID (prefixed with wh_)
- * @param options - Optional API options (e.g., orgId)
- * @throws {WebhookNotFoundError} If the webhook does not exist
- * @throws {WebhookError} If the API request fails
- *
- * @example
- * ```typescript
- * await deleteWebhook(client, 'wh_abc123');
- * console.log('Webhook deleted');
- * ```
- */
-export async function deleteWebhook(client, webhookId, options) {
-    const url = webhookApiPath('delete', webhookId);
-    const resp = await withWebhookErrorHandling(() => client.delete(url, DeleteWebhookResponseSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId });
-    if (resp.success) {
-        return;
-    }
-    throw new WebhookError({
-        webhookId,
-        message: resp.message || 'Failed to delete webhook',
-    });
-}
-//# sourceMappingURL=webhooks.js.map

package/dist/api/webhook/webhooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../src/api/webhook/webhooks.ts"],"names":[],"mappings":"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"}

package/src/api/api-example.md

@@ -1,164 +0,0 @@
-# APIClient Usage Examples
-
-The `APIClient` has a friendly interface with built-in Zod schema validation.
-
-## Public API (no authentication)
-
-```typescript
-import { APIClient, createLogger } from '@agentuity/server';
-
-const logger = createLogger('info');
-
-// Simple - just URL, logger, and optional config
-const client = new APIClient('https://api.agentuity.com', logger);
-
-// With config
-const client = new APIClient('https://api.agentuity.com', logger, {
-	skipVersionCheck: true,
-	userAgent: 'MyApp/1.0.0',
-});
-```
-
-## Authenticated API
-
-```typescript
-import { APIClient, createLogger } from '@agentuity/server';
-
-const logger = createLogger('info');
-const apiKey = 'your-api-key';
-
-// With API key
-const client = new APIClient('https://api.agentuity.com', logger, apiKey);
-
-// With API key and config
-const client = new APIClient('https://api.agentuity.com', logger, apiKey, {
-	skipVersionCheck: true,
-	userAgent: 'MyApp/1.0.0',
-});
-```
-
-## Making Requests
-
-Use the HTTP verb methods (recommended) or the generic `request()` method:
-
-```typescript
-import { APIClient, z, ValidationError } from '@agentuity/server';
-
-// Define schemas
-const UserSchema = z.object({
-	id: z.string(),
-	name: z.string(),
-	email: z.string().email(),
-});
-
-const CreateUserSchema = z.object({
-	name: z.string(),
-	email: z.string().email(),
-});
-
-const logger = createLogger('info');
-const client = new APIClient('https://api.agentuity.com', logger, apiKey);
-
-// GET request with response validation (recommended)
-try {
-	const user = await client.get('/users/123', UserSchema);
-	console.log(user.name); // Fully typed!
-} catch (error) {
-	if (error instanceof ValidationError) {
-		console.error('Validation failed:', error.issues);
-	}
-}
-
-// POST request with request and response validation (recommended)
-const newUser = await client.post(
-	'/users',
-	{
-		// request body
-		name: 'John Doe',
-		email: 'john@example.com',
-	},
-	UserSchema, // response schema (optional)
-	CreateUserSchema // request body schema (optional)
-);
-
-// PUT request
-const updatedUser = await client.put('/users/123', { name: 'Jane Doe' }, UserSchema);
-
-// DELETE request
-await client.delete('/users/123');
-
-// PATCH request
-const patchedUser = await client.patch('/users/123', { email: 'newemail@example.com' }, UserSchema);
-```
-
-## API Response Wrapper Pattern
-
-For APIs that wrap responses in a standard format:
-
-```typescript
-import { z } from '@agentuity/server';
-
-// Generic wrapper schema
-const APIResponseSchema = <T extends z.ZodType>(dataSchema: T) =>
-	z.object({
-		success: z.boolean(),
-		message: z.string(),
-		data: dataSchema.optional(),
-	});
-
-// Use it
-const UserDataSchema = z.object({ id: z.string(), name: z.string() });
-
-const response = await client.get('/users/123', APIResponseSchema(UserDataSchema));
-
-if (response.success && response.data) {
-	console.log(response.data.name);
-}
-```
-
-## CLI-specific Usage
-
-The CLI wrapper automatically handles version checking and user agent:
-
-```typescript
-import { APIClient, z } from '@agentuity/cli';
-import type { Config, Logger } from '@agentuity/cli';
-
-const logger: Logger = /* get from CLI context */;
-const config: Config = {
-	/* ... */
-};
-
-// Public API
-const client = new APIClient('https://api.agentuity.com', logger, config);
-
-// Authenticated API
-const client = new APIClient('https://api.agentuity.com', logger, apiKey, config);
-
-// Making requests (schema validation is built-in)
-const ResponseSchema = z.object({
-	/* ... */
-});
-const data = await client.get('/endpoint', ResponseSchema);
-```
-
-## Error Handling
-
-```typescript
-import { APIClient, APIError, ValidationError, UpgradeRequiredError } from '@agentuity/server';
-
-try {
-	const data = await client.get('/endpoint', schema);
-} catch (error) {
-	if (error instanceof ValidationError) {
-		// Response didn't match schema
-		console.error('Validation error:', error.issues);
-	} else if (error instanceof APIError) {
-		// HTTP error from API
-		console.error(`API error ${error.status}:`, error.message);
-	} else if (error instanceof UpgradeRequiredError) {
-		// Client needs upgrade
-		console.error('Please upgrade:', error.message);
-	}
-}
-```

package/src/api/apikey/create.ts

@@ -1,41 +0,0 @@
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { APIKeyResponseError } from './util.ts';
-
-export const APIKeyCreateResponseSchema = z.object({
-	id: z.string().describe('the API key id'),
-	value: z.string().describe('the API key value'),
-});
-
-export const APIKeyCreateFullResponseSchema = APIResponseSchema(APIKeyCreateResponseSchema);
-
-type _APIKeyCreateFullResponse = z.infer<typeof APIKeyCreateFullResponseSchema>;
-
-export type APIKeyCreateResponse = z.infer<typeof APIKeyCreateResponseSchema>;
-
-export interface APIKeyCreateRequest {
-	name: string;
-	expiresAt: string;
-	projectId?: string | null;
-	orgId?: string | null;
-}
-
-/**
- * Create a new API key
- *
- * @param client
- * @param request the API key creation request
- * @returns
- */
-export async function apikeyCreate(
-	client: APIClient,
-	request: APIKeyCreateRequest
-): Promise<APIKeyCreateResponse> {
-	const resp = await client.post('/cli/apikey', request, APIKeyCreateFullResponseSchema);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new APIKeyResponseError({ message: resp.message });
-}

package/src/api/apikey/delete.ts

@@ -1,30 +0,0 @@
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { APIKeyResponseError } from './util.ts';
-
-export const APIKeyDeleteResponseSchema = APIResponseSchema(
-	z.number().describe('number of rows affected')
-);
-
-type APIKeyDeleteResponse = z.infer<typeof APIKeyDeleteResponseSchema>;
-
-/**
- * Delete an API key (soft delete)
- *
- * @param client
- * @param id the API key id to delete
- * @returns number of rows affected
- */
-export async function apikeyDelete(client: APIClient, id: string): Promise<number> {
-	const resp = await client.request<APIKeyDeleteResponse>(
-		'DELETE',
-		`/cli/apikey/${id}`,
-		APIKeyDeleteResponseSchema
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new APIKeyResponseError({ message: resp.message });
-}

package/src/api/apikey/get.ts

@@ -1,48 +0,0 @@
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { APIKeyResponseError } from './util.ts';
-
-export const APIKeyDetailSchema = z.object({
-	id: z.string().describe('the API key id'),
-	name: z.string().describe('the API key name'),
-	orgId: z.string().describe('the organization id'),
-	type: z.string().describe('the API key type'),
-	expiresAt: z.string().datetime().nullable().describe('the expiration date'),
-	lastUsedAt: z.string().datetime().nullable().optional().describe('the last used date'),
-	createdAt: z.string().datetime().describe('the creation date'),
-	project: z
-		.object({
-			id: z.string().describe('the project id'),
-			name: z.string().describe('the project name'),
-		})
-		.nullable()
-		.optional()
-		.describe('the associated project'),
-});
-
-export const APIKeyGetResponseSchema = APIResponseSchema(APIKeyDetailSchema);
-
-type APIKeyGetResponse = z.infer<typeof APIKeyGetResponseSchema>;
-
-export type APIKeyDetail = z.infer<typeof APIKeyDetailSchema>;
-
-/**
- * Get a specific API key by id
- *
- * @param client
- * @param id the API key id
- * @returns
- */
-export async function apikeyGet(client: APIClient, id: string): Promise<APIKeyDetail> {
-	const resp = await client.request<APIKeyGetResponse>(
-		'GET',
-		`/cli/apikey/${id}`,
-		APIKeyGetResponseSchema
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new APIKeyResponseError({ message: resp.message });
-}

package/src/api/apikey/index.ts

@@ -1,5 +0,0 @@
-export * from './create.ts';
-export * from './delete.ts';
-export * from './get.ts';
-export * from './list.ts';
-export * from './util.ts';

package/src/api/apikey/list.ts

@@ -1,64 +0,0 @@
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { APIKeyResponseError } from './util.ts';
-
-export const APIKeySchema = z.object({
-	id: z.string().describe('the API key id'),
-	name: z.string().describe('the API key name'),
-	orgId: z.string().describe('the organization id'),
-	type: z.string().describe('the API key type'),
-	expiresAt: z.string().datetime().nullable().describe('the expiration date'),
-	lastUsedAt: z.string().datetime().nullable().optional().describe('the last used date'),
-	createdAt: z.string().datetime().describe('the creation date'),
-	project: z
-		.object({
-			id: z.string().describe('the project id'),
-			name: z.string().describe('the project name'),
-		})
-		.nullable()
-		.optional()
-		.describe('the associated project'),
-});
-
-export const APIKeyListResponseArray = z.array(APIKeySchema);
-
-export const APIKeyListResponseSchema = APIResponseSchema(APIKeyListResponseArray);
-
-export type APIKeyListResponse = z.infer<typeof APIKeyListResponseSchema>;
-export type APIKeyList = z.infer<typeof APIKeyListResponseArray>;
-export type APIKey = z.infer<typeof APIKeySchema>;
-
-export interface APIKeyListRequest {
-	orgId?: string;
-	projectId?: string;
-}
-
-/**
- * List all API keys
- *
- * @param client
- * @param request optional filters for orgId and projectId
- * @returns
- */
-export async function apikeyList(
-	client: APIClient,
-	request?: APIKeyListRequest
-): Promise<APIKeyList> {
-	const params = new URLSearchParams();
-	if (request?.orgId) {
-		params.set('orgId', request.orgId);
-	}
-	if (request?.projectId) {
-		params.set('projectId', request.projectId);
-	}
-	const queryString = params.toString();
-	const endpoint = `/cli/apikey${queryString ? `?${queryString}` : ''}`;
-
-	const resp = await client.get<APIKeyListResponse>(endpoint, APIKeyListResponseSchema);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new APIKeyResponseError({ message: resp.message });
-}

package/src/api/apikey/util.ts

@@ -1,3 +0,0 @@
-import { StructuredError } from '@agentuity/core';
-
-export const APIKeyResponseError = StructuredError('APIKeyResponseError');