@agent-os-sdk/client 0.1.1 → 0.2.1

package/src/index.ts

@@ -38,7 +38,19 @@
 // ============================================================================
 // Main Client
 // ============================================================================
-export { AgentOsClient, type AgentOsClientOptions } from "./client/AgentOsClient.js";
+export { AgentOsClient, type AgentOsClientOptions, type AgentOsClientOptionsLegacy, type AuthProvider } from "./client/AgentOsClient.js";
+
+// Auth Provider Types
+export {
+    type ApiTokenAuth,
+    type JwtAuth,
+    isApiTokenAuth,
+    isJwtAuth,
+    isNewAuthOptions,
+    isBrowser,
+    isApiToken,
+    isJwtToken,
+} from "./client/auth.js";
 
 // ============================================================================
 // Helpers & Utilities
@@ -74,7 +86,7 @@ export type { paths, components } from "./client/raw.js";
 
 // Core modules
 export { AgentsModule, type Agent, type AgentVersion, type AgentListResponse, type AgentGraphResponse } from "./modules/agents.js";
-export { RunsModule, type Run, type RunEvent, type RunListResponse, type RunEventsResponse, type CreateRunResponse } from "./modules/runs.js";
+export { RunsModule, type Run, type RunStatus, type RunEvent, type RunListResponse, type RunEventsResponse, type CreateRunResponse, type RunEventsPollResponse, type RunEventDto } from "./modules/runs.js";
 export { ThreadsModule, type Thread, type ThreadState, type ThreadMessage, type ThreadRun, type ThreadListResponse, type ThreadMessagesResponse } from "./modules/threads.js";
 export { ToolsModule, type Tool, type ToolListResponse } from "./modules/tools.js";
 export { KnowledgeModule, type KnowledgeDataset, type KnowledgeSearchResponse } from "./modules/knowledge.js";
@@ -105,6 +117,17 @@ export { InfoModule, type ServerInfo } from "./modules/info.js";
 export { MetricsModule, type MetricsResponse } from "./modules/metrics.js";
 export { GraphsModule, type GraphValidationResult, type GraphIntrospectionResult } from "./modules/graphs.js";
 
+// FUTURE modules - All return 501 Not Implemented. When backend is ready, implement real calls.
+export { HandoffModule, type HandoffOptions, type HandoffResult, type ForkOptions, type ForkResult, type RunChain, type RunChainNode, type HandoffMode, type HandoffConstraints } from "./modules/handoff.js";
+export { FlowsModule, type Flow, type FlowStep, type FlowRun, type FlowVisualization, type FlowSimulationResult, type FlowStatus, type FlowListResponse } from "./modules/flows.js";
+export { CapabilitiesModule, type Capability, type CapabilityType, type CapabilityTest, type CapabilityMatrix } from "./modules/capabilities.js";
+export { PoliciesModule, type Policy, type PolicyScope, type PolicyEnforcement, type PolicyRule, type PolicyEvaluation, type PolicyEvaluationResult } from "./modules/policies.js";
+export { ApprovalsModule, type Approval, type ApprovalStatus, type ApprovalRequest, type ApprovalDecision, type ApprovalListResponse } from "./modules/approvals.js";
+export { BudgetsModule, type Budget, type BudgetPeriod, type BudgetScope, type BudgetResourceType, type BudgetUsage, type BudgetAlert, type BudgetBreakdownItem } from "./modules/budgets.js";
+export { DeploymentsModule, type Environment, type Deployment, type DeploymentStatus, type DeploymentConfig, type DeploymentHealth } from "./modules/deployments.js";
+export { IncidentsModule, type Incident, type IncidentSeverity, type IncidentStatus, type IncidentUpdate, type IncidentMetrics } from "./modules/incidents.js";
+export { ArtifactsModule, type Artifact, type ArtifactType, type ArtifactUploadUrl } from "./modules/artifacts.js";
+
 // ============================================================================
 // SSE Streaming
 // ============================================================================

package/src/modules/approvals.ts

@@ -0,0 +1,109 @@
+/**
+ * Approvals Module - Human-in-the-Loop Native
+ *
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
+ */
+
+import type { RawClient, APIResponse } from "../client/raw.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type ApprovalStatus = "pending" | "approved" | "rejected" | "expired" | "auto_approved";
+
+export interface Approval {
+    id: string;
+    run_id: string;
+    thread_id?: string;
+    action: string;
+    payload: Record<string, unknown>;
+    status: ApprovalStatus;
+    reason?: string;
+    requested_at: string;
+    responded_at?: string;
+    responded_by?: string;
+    expires_at?: string;
+    auto_approve_after?: number;
+}
+
+export interface ApprovalRequest {
+    run_id: string;
+    action: string;
+    payload: Record<string, unknown>;
+    expires_in_seconds?: number;
+    auto_approve_after_seconds?: number;
+    notify_channels?: string[];
+}
+
+export interface ApprovalListResponse {
+    items: Approval[];
+    total: number;
+    pending_count: number;
+}
+
+export interface ApprovalDecision {
+    approval_id: string;
+    decision: "approve" | "reject";
+    reason?: string;
+    modified_payload?: Record<string, unknown>;
+}
+
+// ============================================================================
+// Helper for 501 responses
+// ============================================================================
+
+function notImplemented<T>(method: string): APIResponse<T> {
+    return {
+        data: undefined,
+        error: {
+            code: "NOT_IMPLEMENTED",
+            message: `ApprovalsModule.${method}() is not implemented. Backend endpoint not available.`,
+        },
+        response: new Response(null, { status: 501, statusText: "Not Implemented" }),
+    };
+}
+
+// ============================================================================
+// Module
+// ============================================================================
+
+export class ApprovalsModule {
+    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
+
+    /** @returns 501 Not Implemented */
+    async list(params?: {
+        status?: ApprovalStatus;
+        run_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<ApprovalListResponse>> {
+        return notImplemented<ApprovalListResponse>("list");
+    }
+
+    /** @returns 501 Not Implemented */
+    async get(approvalId: string): Promise<APIResponse<Approval>> {
+        return notImplemented<Approval>("get");
+    }
+
+    /** @returns 501 Not Implemented */
+    async create(request: ApprovalRequest): Promise<APIResponse<Approval>> {
+        return notImplemented<Approval>("create");
+    }
+
+    /** @returns 501 Not Implemented */
+    async approve(approvalId: string, reason?: string): Promise<APIResponse<Approval>> {
+        return notImplemented<Approval>("approve");
+    }
+
+    /** @returns 501 Not Implemented */
+    async reject(approvalId: string, reason?: string): Promise<APIResponse<Approval>> {
+        return notImplemented<Approval>("reject");
+    }
+
+    /** @returns 501 Not Implemented */
+    async awaitApproval(runId: string, timeoutSeconds?: number): Promise<APIResponse<Approval>> {
+        return notImplemented<Approval>("awaitApproval");
+    }
+}

package/src/modules/artifacts.ts

@@ -0,0 +1,83 @@
+/**
+ * Artifacts Module - Run Output Management
+ *
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
+ */
+
+import type { RawClient, APIResponse } from "../client/raw.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type ArtifactType = "file" | "image" | "json" | "text" | "log" | "report";
+
+export interface Artifact {
+    id: string;
+    run_id: string;
+    name: string;
+    type: ArtifactType;
+    mime_type?: string;
+    size_bytes: number;
+    checksum?: string;
+    download_url?: string;
+    preview_url?: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+    expires_at?: string;
+}
+
+export interface ArtifactUploadUrl {
+    upload_url: string;
+    artifact_id: string;
+    expires_at: string;
+}
+
+// ============================================================================
+// Helper for 501 responses
+// ============================================================================
+
+function notImplemented<T>(method: string): APIResponse<T> {
+    return {
+        data: undefined,
+        error: {
+            code: "NOT_IMPLEMENTED",
+            message: `ArtifactsModule.${method}() is not implemented. Backend endpoint not available.`,
+        },
+        response: new Response(null, { status: 501, statusText: "Not Implemented" }),
+    };
+}
+
+// ============================================================================
+// Module
+// ============================================================================
+
+export class ArtifactsModule {
+    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
+
+    /** @returns 501 Not Implemented */
+    async list(runId: string): Promise<APIResponse<{ items: Artifact[]; total: number }>> {
+        return notImplemented<{ items: Artifact[]; total: number }>("list");
+    }
+
+    /** @returns 501 Not Implemented */
+    async get(artifactId: string): Promise<APIResponse<Artifact>> {
+        return notImplemented<Artifact>("get");
+    }
+
+    /** @returns 501 Not Implemented */
+    async getDownloadUrl(artifactId: string): Promise<APIResponse<{ url: string; expires_at: string }>> {
+        return notImplemented<{ url: string; expires_at: string }>("getDownloadUrl");
+    }
+
+    /** @returns 501 Not Implemented */
+    async createUploadUrl(runId: string, name: string, type: ArtifactType): Promise<APIResponse<ArtifactUploadUrl>> {
+        return notImplemented<ArtifactUploadUrl>("createUploadUrl");
+    }
+
+    /** @returns 501 Not Implemented */
+    async delete(artifactId: string): Promise<APIResponse<void>> {
+        return notImplemented<void>("delete");
+    }
+}

package/src/modules/budgets.ts

@@ -0,0 +1,120 @@
+/**
+ * Budgets Module - Cost & Token Management
+ *
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
+ */
+
+import type { RawClient, APIResponse } from "../client/raw.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type BudgetScope = "agent" | "workspace" | "tenant" | "user";
+export type BudgetPeriod = "daily" | "weekly" | "monthly" | "total";
+export type BudgetResourceType = "tokens" | "cost" | "api_calls";
+
+export interface Budget {
+    id: string;
+    name: string;
+    scope: BudgetScope;
+    scope_id: string;
+    resource_type: BudgetResourceType;
+    limit_value: number;
+    current_value: number;
+    period: BudgetPeriod;
+    period_start: string;
+    period_end: string;
+    alert_threshold_percent?: number;
+    created_at: string;
+}
+
+export interface BudgetUsage {
+    budget_id: string;
+    current_value: number;
+    limit_value: number;
+    percent_used: number;
+    remaining: number;
+    period_start: string;
+    period_end: string;
+    breakdown: BudgetBreakdownItem[];
+}
+
+export interface BudgetBreakdownItem {
+    agent_id?: string;
+    agent_name?: string;
+    model?: string;
+    value: number;
+    percent_of_total: number;
+}
+
+export interface BudgetAlert {
+    id: string;
+    budget_id: string;
+    type: "threshold_warning" | "limit_reached" | "limit_exceeded";
+    message: string;
+    triggered_at: string;
+    acknowledged: boolean;
+}
+
+// ============================================================================
+// Helper for 501 responses
+// ============================================================================
+
+function notImplemented<T>(method: string): APIResponse<T> {
+    return {
+        data: undefined,
+        error: {
+            code: "NOT_IMPLEMENTED",
+            message: `BudgetsModule.${method}() is not implemented. Backend endpoint not available.`,
+        },
+        response: new Response(null, { status: 501, statusText: "Not Implemented" }),
+    };
+}
+
+// ============================================================================
+// Module
+// ============================================================================
+
+export class BudgetsModule {
+    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
+
+    /** @returns 501 Not Implemented */
+    async list(params?: {
+        scope?: BudgetScope;
+        scope_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<{ items: Budget[]; total: number }>> {
+        return notImplemented<{ items: Budget[]; total: number }>("list");
+    }
+
+    /** @returns 501 Not Implemented */
+    async get(budgetId: string): Promise<APIResponse<Budget>> {
+        return notImplemented<Budget>("get");
+    }
+
+    /** @returns 501 Not Implemented */
+    async create(body: {
+        name: string;
+        scope: BudgetScope;
+        scope_id: string;
+        resource_type: BudgetResourceType;
+        limit_value: number;
+        period: BudgetPeriod;
+        alert_threshold_percent?: number;
+    }): Promise<APIResponse<Budget>> {
+        return notImplemented<Budget>("create");
+    }
+
+    /** @returns 501 Not Implemented */
+    async getUsage(budgetId: string): Promise<APIResponse<BudgetUsage>> {
+        return notImplemented<BudgetUsage>("getUsage");
+    }
+
+    /** @returns 501 Not Implemented */
+    async getAlerts(budgetId: string): Promise<APIResponse<BudgetAlert[]>> {
+        return notImplemented<BudgetAlert[]>("getAlerts");
+    }
+}

package/src/modules/builder.ts

@@ -1,8 +1,28 @@
 /**
  * Builder Module - Meta-Agent for Agent Building
  * 
- * Connects to the kernel's meta-agent for AI-assisted agent creation.
+ * Connects to the Control Plane's builder endpoint which proxies to the
+ * Data Plane's meta-agent for AI-assisted agent creation.
  * Uses SSE streaming for real-time responses and graph updates.
+ * 
+ * Flow: Frontend → CP:5000/v1/api/builder/{agentId}/chat → DP:8001/v1/internal/builder/{agentId}/chat
+ * 
+ * @example
+ * ```ts
+ * const client = new AgentOsClient({ ... })
+ * 
+ * // SSE streaming chat
+ * for await (const event of client.builder.chat(agentId, {
+ *   message: "Adicione um nó de pesquisa web",
+ *   current_graph_spec: { nodes: [...], edges: [...] }
+ * })) {
+ *   if (event.type === 'message') console.log(event.data.text)
+ *   if (event.type === 'graph_update') applyAction(event.data)
+ * }
+ * 
+ * // Sync chat (no streaming)
+ * const result = await client.builder.chatSync(agentId, { message: "Mude as instruções" })
+ * ```
  */
 
 import { streamSSE, type SSEEvent, type SSEOptions } from "../sse/client.js";
@@ -36,7 +56,7 @@ export type BuilderChatResponse = {
 
 export class BuilderModule {
     constructor(
-        private kernelBaseUrl: string,
+        private baseUrl: string,
         private headers: () => Record<string, string>
     ) { }
 
@@ -49,7 +69,8 @@ export class BuilderModule {
         request: BuilderChatRequest,
         options?: SSEOptions
     ): AsyncGenerator<BuilderStreamEvent> {
-        const url = `${this.kernelBaseUrl}/v1/internal/builder/${agentId}/chat`;
+        // Use public API route (CP proxies to DP)
+        const url = `${this.baseUrl}/v1/api/builder/${agentId}/chat`;
 
         const response = await fetch(url, {
             method: "POST",
@@ -117,7 +138,8 @@ export class BuilderModule {
         agentId: string,
         request: BuilderChatRequest
     ): Promise<BuilderChatResponse> {
-        const url = `${this.kernelBaseUrl}/v1/internal/builder/${agentId}/chat/sync`;
+        // Use public API route (CP proxies to DP)
+        const url = `${this.baseUrl}/v1/api/builder/${agentId}/chat/sync`;
 
         const response = await fetch(url, {
             method: "POST",

package/src/modules/capabilities.ts

@@ -0,0 +1,95 @@
+/**
+ * Capabilities Module - Agent Capability Discovery
+ *
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
+ */
+
+import type { RawClient, APIResponse } from "../client/raw.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type CapabilityType = "tool" | "skill" | "knowledge" | "integration" | "model_feature";
+
+export interface Capability {
+    id: string;
+    name: string;
+    type: CapabilityType;
+    description?: string;
+    agent_id?: string;
+    is_available: boolean;
+    required_credentials?: string[];
+    required_permissions?: string[];
+    metadata?: Record<string, unknown>;
+}
+
+export interface CapabilityTest {
+    capability_id: string;
+    test_name: string;
+    passed: boolean;
+    message?: string;
+    duration_ms: number;
+}
+
+export interface CapabilityMatrix {
+    agent_id: string;
+    capabilities: Capability[];
+    total: number;
+    available: number;
+    unavailable: number;
+}
+
+// ============================================================================
+// Helper for 501 responses
+// ============================================================================
+
+function notImplemented<T>(method: string): APIResponse<T> {
+    return {
+        data: undefined,
+        error: {
+            code: "NOT_IMPLEMENTED",
+            message: `CapabilitiesModule.${method}() is not implemented. Backend endpoint not available.`,
+        },
+        response: new Response(null, { status: 501, statusText: "Not Implemented" }),
+    };
+}
+
+// ============================================================================
+// Module
+// ============================================================================
+
+export class CapabilitiesModule {
+    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
+
+    /** @returns 501 Not Implemented */
+    async list(params?: {
+        agent_id?: string;
+        type?: CapabilityType;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<{ items: Capability[]; total: number }>> {
+        return notImplemented<{ items: Capability[]; total: number }>("list");
+    }
+
+    /** @returns 501 Not Implemented */
+    async get(capabilityId: string): Promise<APIResponse<Capability>> {
+        return notImplemented<Capability>("get");
+    }
+
+    /** @returns 501 Not Implemented */
+    async getMatrix(agentId: string): Promise<APIResponse<CapabilityMatrix>> {
+        return notImplemented<CapabilityMatrix>("getMatrix");
+    }
+
+    /** @returns 501 Not Implemented */
+    async test(agentId: string, capabilityId: string): Promise<APIResponse<CapabilityTest>> {
+        return notImplemented<CapabilityTest>("test");
+    }
+
+    /** @returns 501 Not Implemented */
+    async testAll(agentId: string): Promise<APIResponse<CapabilityTest[]>> {
+        return notImplemented<CapabilityTest[]>("testAll");
+    }
+}

package/src/modules/deployments.ts

@@ -0,0 +1,111 @@
+/**
+ * Deployments Module - Agent Lifecycle
+ *
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
+ */
+
+import type { RawClient, APIResponse } from "../client/raw.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type DeploymentStatus = "pending" | "building" | "deploying" | "active" | "failed" | "rolled_back" | "deactivated";
+export type Environment = "development" | "staging" | "production";
+
+export interface Deployment {
+    id: string;
+    agent_id: string;
+    version_id: string;
+    environment: Environment;
+    status: DeploymentStatus;
+    endpoint_url?: string;
+    deployed_at?: string;
+    created_at: string;
+    created_by: string;
+    rollback_version_id?: string;
+}
+
+export interface DeploymentConfig {
+    replicas?: number;
+    memory_mb?: number;
+    timeout_seconds?: number;
+    env_vars?: Record<string, string>;
+    auto_scale?: boolean;
+    min_replicas?: number;
+    max_replicas?: number;
+}
+
+export interface DeploymentHealth {
+    deployment_id: string;
+    healthy: boolean;
+    replicas_running: number;
+    replicas_desired: number;
+    last_check: string;
+    error?: string;
+}
+
+// ============================================================================
+// Helper for 501 responses
+// ============================================================================
+
+function notImplemented<T>(method: string): APIResponse<T> {
+    return {
+        data: undefined,
+        error: {
+            code: "NOT_IMPLEMENTED",
+            message: `DeploymentsModule.${method}() is not implemented. Backend endpoint not available.`,
+        },
+        response: new Response(null, { status: 501, statusText: "Not Implemented" }),
+    };
+}
+
+// ============================================================================
+// Module
+// ============================================================================
+
+export class DeploymentsModule {
+    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
+
+    /** @returns 501 Not Implemented */
+    async list(params?: {
+        agent_id?: string;
+        environment?: Environment;
+        status?: DeploymentStatus;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<{ items: Deployment[]; total: number }>> {
+        return notImplemented<{ items: Deployment[]; total: number }>("list");
+    }
+
+    /** @returns 501 Not Implemented */
+    async get(deploymentId: string): Promise<APIResponse<Deployment>> {
+        return notImplemented<Deployment>("get");
+    }
+
+    /** @returns 501 Not Implemented */
+    async deploy(agentId: string, environment: Environment, config?: DeploymentConfig): Promise<APIResponse<Deployment>> {
+        return notImplemented<Deployment>("deploy");
+    }
+
+    /** @returns 501 Not Implemented */
+    async promote(deploymentId: string, toEnvironment: Environment): Promise<APIResponse<Deployment>> {
+        return notImplemented<Deployment>("promote");
+    }
+
+    /** @returns 501 Not Implemented */
+    async rollback(deploymentId: string): Promise<APIResponse<Deployment>> {
+        return notImplemented<Deployment>("rollback");
+    }
+
+    /** @returns 501 Not Implemented */
+    async health(deploymentId: string): Promise<APIResponse<DeploymentHealth>> {
+        return notImplemented<DeploymentHealth>("health");
+    }
+
+    /** @returns 501 Not Implemented */
+    async deactivate(deploymentId: string): Promise<APIResponse<void>> {
+        return notImplemented<void>("deactivate");
+    }
+}