@agent-os-sdk/client 0.4.0 → 0.4.2

package/dist/modules/members.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../src/modules/members.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE3D,qBAAa,aAAa;IACV,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG;QACnC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAO5C;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAOzD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAO9C;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QACjC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAQhC;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAO1D;;;OAGG;IACH,MAAM,GAAI,UAAU,MAAM,gCAA2B;IAErD;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAOhE;;;OAGG;IACG,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;CAMhE"}
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../src/modules/members.ts"],"names":[],"mappings":"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"}

package/dist/modules/members.js

@@ -31,6 +31,59 @@ export class MembersModule {
             headers: this.headers(),
         });
     }
+    /**
+     * List all roles in the tenant.
+     */
+    async listRoles() {
+        return this.client.GET("/v1/api/roles", {
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a role by ID.
+     */
+    async getRole(roleId) {
+        return this.client.GET("/v1/api/roles/{id}", {
+            params: { path: { id: roleId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new custom role.
+     */
+    async createRole(body) {
+        return this.client.POST("/v1/api/roles", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Update a custom role.
+     */
+    async updateRole(roleId, body) {
+        return this.client.PUT("/v1/api/roles/{id}", {
+            params: { path: { id: roleId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a custom role.
+     */
+    async deleteRole(roleId) {
+        return this.client.DELETE("/v1/api/roles/{id}", {
+            params: { path: { id: roleId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List all available system permissions.
+     */
+    async listPermissions() {
+        return this.client.GET("/v1/api/roles/permissions", {
+            headers: this.headers(),
+        });
+    }
     /**
      * Invite a new member.
      */
@@ -84,4 +137,12 @@ export class MembersModule {
             headers: this.headers(),
         });
     }
+    /**
+     * Seed default permissions (Dev only)
+     */
+    async seedDefaults() {
+        return this.client.POST("/v1/api/roles/seed-defaults", {
+            headers: this.headers(),
+        });
+    }
 }

package/package.json

@@ -1,51 +1,52 @@
 {
-  "name": "@agent-os-sdk/client",
-  "version": "0.4.0",
-  "description": "Official TypeScript SDK for Agent OS platform",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "keywords": [
-    "agent-os",
-    "sdk",
-    "ai",
-    "agents",
-    "typescript"
-  ],
-  "author": "Agent OS Team",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/yuri12344/agent-os.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "openapi-fetch": "^0.13.0"
-  },
-  "devDependencies": {
-    "openapi-typescript": "^7.4.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.5.0",
-    "vitest": "^4.0.18"
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "scripts": {
-    "generate": "tsx scripts/generate.ts",
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  }
+    "name": "@agent-os-sdk/client",
+    "version": "0.4.2",
+    "description": "Official TypeScript SDK for Agent OS platform",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "generate": "tsx scripts/generate.ts",
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "test": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "prepublishOnly": "pnpm build"
+    },
+    "keywords": [
+        "agent-os",
+        "sdk",
+        "ai",
+        "agents",
+        "typescript"
+    ],
+    "author": "Agent OS Team",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/yuri12344/agent-os.git"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "openapi-fetch": "^0.13.0"
+    },
+    "devDependencies": {
+        "openapi-typescript": "^7.4.0",
+        "tsx": "^4.19.0",
+        "typescript": "^5.5.0",
+        "vitest": "^4.0.18"
+    },
+    "files": [
+        "dist",
+        "src"
+    ]
 }

package/src/client/raw.ts

@@ -5,11 +5,11 @@
  * All types are automatically inferred from the backend Swagger specification.
  */
 
-import createClient, { type Client, type FetchOptions } from "openapi-fetch";
-import type { paths, components } from "../generated/openapi.js";
+import createClient, { type Client } from "openapi-fetch";
+import type { components, paths } from "../generated/openapi.js";
 
 // Re-export types for external use
-export type { paths, components };
+export type { components, paths };
 
 export type ClientOptions = {
     baseUrl: string;
@@ -202,7 +202,7 @@ export function createRawClient(options: ClientOptions) {
                     code: "NETWORK_ERROR",
                     message: fetchError instanceof Error ? fetchError.message : "Network request failed"
                 },
-                response: new Response(null, { status: 0 })
+                response: new Response(null, { status: 503, statusText: "Network Error" })
             };
         }
 

package/src/index.ts

@@ -42,26 +42,16 @@ export { AgentOsClient, type AgentOsClientOptions, type AuthProvider } from "./c
 
 // Auth Provider Types
 export {
-    type ApiTokenAuth,
-    type JwtAuth,
-    isApiTokenAuth,
-    isJwtAuth,
-    isBrowser,
-    isApiToken,
-    isJwtToken,
+    isApiToken, isApiTokenAuth, isBrowser, isJwtAuth, isJwtToken, type ApiTokenAuth,
+    type JwtAuth
 } from "./client/auth.js";
 
 // ============================================================================
 // Helpers & Utilities
 // ============================================================================
 export {
-    unwrap,
-    toResult,
-    SDKError,
-    type PaginationParams,
-    type PaginatedResponse,
-    type Result,
-    type Unwrapped,
+    SDKError, toResult, unwrap, type PaginatedResponse, type PaginationParams, type Result,
+    type Unwrapped
 } from "./client/helpers.js";
 
 // ============================================================================
@@ -69,26 +59,15 @@ export {
 // ============================================================================
 export {
     // Base class
-    AgentOsError,
-    type ErrorOptions,
+    AgentOsError, ConflictError, ForbiddenError, NetworkError, NotFoundError, RateLimitError,
+    ServerError, TimeoutError,
     // Error classes
-    UnauthorizedError,
-    ForbiddenError,
-    NotFoundError,
-    ConflictError,
-    ValidationError,
-    RateLimitError,
-    ServerError,
-    NetworkError,
-    TimeoutError,
-    // Field errors
-    type FieldError,
+    UnauthorizedError, ValidationError,
     // Type guards
-    isAgentOsError,
-    isRetryableError,
-    isAuthError,
-    isClientError,
-    isServerError,
+    isAgentOsError, isAuthError,
+    isClientError, isRetryableError, isServerError, type ErrorOptions,
+    // Field errors
+    type FieldError
 } from "./errors/index.js";
 
 export { createErrorFromResponse } from "./errors/factory.js";
@@ -97,32 +76,22 @@ export { createErrorFromResponse } from "./errors/factory.js";
 // Network Configuration
 // ============================================================================
 export {
-    type RetryConfig,
-    type NetworkConfig,
-    DEFAULT_NETWORK_CONFIG,
-    INTERACTIVE_NETWORK_CONFIG,
-    BACKGROUND_NETWORK_CONFIG,
-    mergeNetworkConfig,
+    BACKGROUND_NETWORK_CONFIG, DEFAULT_NETWORK_CONFIG,
+    INTERACTIVE_NETWORK_CONFIG, mergeNetworkConfig, type NetworkConfig, type RetryConfig
 } from "./client/config.js";
 
 // ============================================================================
 // Retry & Timeout Utilities
 // ============================================================================
-export { withRetry, type RetryContext, sleep } from "./client/retry.js";
-export { withTimeout, createTimeoutController } from "./client/timeout.js";
+export { sleep, withRetry, type RetryContext } from "./client/retry.js";
+export { createTimeoutController, withTimeout } from "./client/timeout.js";
 
 // ============================================================================
 // Pagination Utilities
 // ============================================================================
 export {
-    paginate,
     collectAll,
-    getFirst,
-    type OffsetPaginatedResponse,
-    type CursorPaginatedResponse,
-    type OffsetParams,
-    type CursorParams,
-    type PaginateOptions,
+    getFirst, paginate, type CursorPaginatedResponse, type CursorParams, type OffsetPaginatedResponse, type OffsetParams, type PaginateOptions
 } from "./client/pagination.js";
 
 
@@ -131,116 +100,98 @@ export {
 // ============================================================================
 export {
     createRawClient,
-    createTypedClient,
-    type RawClient,
-    type TypedClient,
-    type ClientOptions,
-    type APIResponse,
+    createTypedClient, type APIResponse, type ClientOptions, type HookErrorContext, type HookRequestContext,
+    type HookResponseContext, type RawClient,
     // SDK Hooks for observability (OTEL, Sentry, etc.)
-    type SDKHooks,
-    type HookRequestContext,
-    type HookResponseContext,
-    type HookErrorContext,
+    type SDKHooks, type TypedClient
 } from "./client/raw.js";
 
 // Export OpenAPI types
-export type { paths, components } from "./client/raw.js";
+export type { components, paths } from "./client/raw.js";
 
 // ============================================================================
 // Module Classes
 // ============================================================================
 
 // Core modules
-export { AgentsModule, type Agent, type AgentVersion, type AgentListResponse, type AgentGraphResponse } from "./modules/agents.js";
-export { RunsModule, type Run, type RunStatus, type RunEvent, type RunListResponse, type RunEventsResponse, type CreateRunResponse, type RunEventsPollResponse, type RunEventDto, type FollowOptions, type FollowEvent } 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";
-export { TriggersModule, type Trigger, type TriggerListResponse } from "./modules/triggers.js";
+export { AgentsModule, type Agent, type AgentGraphResponse, type AgentListResponse, type AgentVersion } from "./modules/agents.js";
+export { BuilderModule, type BuilderChatRequest, type BuilderChatResponse, type BuilderStreamEvent, type GraphUpdateAction, type HintModel, type HintTargetModel, type HintDataModel } from "./modules/builder.js";
 export { CredentialsModule, type Credential, type CredentialListResponse, type CredentialType } from "./modules/credentials.js";
-export { BuilderModule, type BuilderChatRequest, type BuilderChatResponse, type BuilderStreamEvent, type GraphUpdateAction } from "./modules/builder.js";
-export { MembersModule, type Member, type MemberListResponse } from "./modules/members.js";
+export { KnowledgeModule, type KnowledgeDataset, type KnowledgeSearchResponse } from "./modules/knowledge.js";
+export { MembersModule, type Member, type MemberListResponse, type Role } from "./modules/members.js";
+export { RunsModule, type CreateRunResponse, type FollowEvent, type FollowOptions, type Run, type RunEvent, type RunEventDto, type RunEventsPollResponse, type RunEventsResponse, type RunListResponse, type RunStatus } from "./modules/runs.js";
 export { TenantsModule, type Tenant } from "./modules/tenants.js";
+export { ThreadsModule, type Thread, type ThreadListResponse, type ThreadMessage, type ThreadMessagesResponse, type ThreadRun, type ThreadState } from "./modules/threads.js";
+export { ToolsModule, type Tool, type ToolListResponse } from "./modules/tools.js";
+export { TriggersModule, type Trigger, type TriggerListResponse } from "./modules/triggers.js";
 export { WorkspacesModule, type Workspace, type WorkspaceListResponse } from "./modules/workspaces.js";
 
 // Platform modules
-export { PromptsModule, type Prompt, type PromptVersion, type PromptListResponse } from "./modules/prompts.js";
-export { TracesModule, type Trace, type Span, type TraceListResponse, type SpanData, type FeedbackRequest } from "./modules/traces.js";
-export { FilesModule, type StoredFile, type FileListResponse, type PresignedUpload } from "./modules/files.js";
-export { VectorStoresModule, type VectorStore, type VectorStoreListResponse, type VectorQueryResult } from "./modules/vectorStores.js";
-export { EvaluationModule, type EvalDataset, type Experiment, type ExampleData } from "./modules/evaluation.js";
+export { A2aModule, type A2aAgentCard, type JsonRpcRequest, type JsonRpcResponse } from "./modules/a2a.js";
+export { AuditModule, type AuditListResponse, type AuditLogEntry } from "./modules/audit.js";
+export { CatalogModule, type CatalogVersions, type NodeCatalogResponse, type NodeDefinition, type ToolCatalogResponse, type ToolDefinition, type TriggerCatalogResponse, type TriggerTemplate } from "./modules/catalog.js";
 export { CheckpointsModule, type Checkpoint, type CheckpointsResponse } from "./modules/checkpoints.js";
-export { PlaygroundModule, type PlaygroundSession } from "./modules/playground.js";
 export { CronsModule, type CronJob, type CronJobListResponse } from "./modules/crons.js";
-export { DlqModule, type DlqMessage, type DlqListResponse } from "./modules/dlq.js";
-export { StoreModule, type StoreValue } from "./modules/store.js";
-export { AuditModule, type AuditLogEntry, type AuditListResponse } from "./modules/audit.js";
-export { UsageModule, type UsageResponse, type UsageQuota } from "./modules/usage.js";
+export { DlqModule, type DlqListResponse, type DlqMessage } from "./modules/dlq.js";
+export { EvaluationModule, type EvalDataset, type ExampleData, type Experiment } from "./modules/evaluation.js";
+export { FilesModule, type FileListResponse, type PresignedUpload, type StoredFile } from "./modules/files.js";
+export { GraphsModule, type GraphIntrospectionResult, type GraphValidationResult } from "./modules/graphs.js";
+export { InfoModule, type ServerCapabilities, type ServerInfo } from "./modules/info.js";
 export { McpModule, type McpServer } from "./modules/mcp.js";
-export { A2aModule, type JsonRpcRequest, type JsonRpcResponse, type A2aAgentCard } from "./modules/a2a.js";
 export { MeModule, type MeResponse } from "./modules/me.js";
-export { InfoModule, type ServerInfo, type ServerCapabilities } from "./modules/info.js";
 export { MetricsModule, type MetricsResponse } from "./modules/metrics.js";
-export { GraphsModule, type GraphValidationResult, type GraphIntrospectionResult } from "./modules/graphs.js";
-export { CatalogModule, type CatalogVersions, type NodeCatalogResponse, type ToolCatalogResponse, type TriggerCatalogResponse, type NodeDefinition, type ToolDefinition, type TriggerTemplate } from "./modules/catalog.js";
+export { PlaygroundModule, type PlaygroundSession } from "./modules/playground.js";
+export { PromptsModule, type Prompt, type PromptListResponse, type PromptVersion } from "./modules/prompts.js";
+export { StoreModule, type StoreValue } from "./modules/store.js";
+export { TracesModule, type FeedbackRequest, type Span, type SpanData, type Trace, type TraceListResponse } from "./modules/traces.js";
+export { UsageModule, type UsageQuota, type UsageResponse } from "./modules/usage.js";
+export { VectorStoresModule, type VectorQueryResult, type VectorStore, type VectorStoreListResponse } from "./modules/vectorStores.js";
 
 // Approvals is real (has backend implementation)
-export { ApprovalsModule, type Approval, type ApprovalStatus, type ApprovalDecision, type ApprovalListResponse, type ApprovalStatusResponse } from "./modules/approvals.js";
+export { ApprovalsModule, type Approval, type ApprovalDecision, type ApprovalListResponse, type ApprovalStatus, type ApprovalStatusResponse } from "./modules/approvals.js";
 
 export { ApiTokensModule, type ApiToken, type ApiTokenSecret, type CreateTokenRequest, type RotateTokenResponse } from "./modules/apiTokens.js";
-export { MembershipsModule, type MembershipResponse, type EnsureMembershipRequest } from "./modules/memberships.js";
+export { MembershipsModule, type EnsureMembershipRequest, type MembershipResponse } from "./modules/memberships.js";
 
 // ============================================================================
 // SSE Streaming
 // ============================================================================
-export { streamSSE, parseSSE, type SSEEvent, type SSEOptions, type RunStreamEvent, type RunSSEEvent, type RunEventDto as SSERunEventDto } from "./sse/client.js";
+export { parseSSE, streamSSE, type RunSSEEvent, type RunStreamEvent, type SSEEvent, type SSEOptions, type RunEventDto as SSERunEventDto } from "./sse/client.js";
 
 // ============================================================================
 // Convenience Type Re-exports
 // ============================================================================
 export type {
+    AddMessageRequest, AgentBundle,
     // Agent types
-    Agent as AgentSchema,
-    CreateAgentRequest,
-    UpdateAgentRequest,
-    AgentBundle,
-    CreateAgentVersionRequest,
-    // Run types
-    RunResponse,
-    RunDetailResponse,
-    WaitRunResponse,
-    BatchRunResponse,
+    Agent as AgentSchema, BatchRunResponse,
     CancelRunResponse,
-    ReplayRequest,
-    // Thread types
-    ThreadRequest,
-    ThreadSearchRequest,
-    AddMessageRequest,
     // Checkpoint types
     CheckpointDetail,
-    CheckpointListResponse,
+    CheckpointListResponse, CreateAgentRequest, CreateAgentVersionRequest,
     // Credential types
     CreateCredentialRequest,
-    UpdateCredentialRequest,
     // Cron types
     CreateCronJobRequest,
-    UpdateCronJobRequest,
-    // Member types
-    InviteMemberRequest,
-    UpdateMemberRequest,
-    // Prompt types
-    CreatePromptRequest,
-    CreatePromptVersionRequest,
-    // File types
-    CreatePresignedUploadRequest,
-    PresignedUploadResponse,
-    // Vector Store types
-    VectorStoreResponse,
-    VectorQueryRequest,
-    VectorQueryResponse,
     // Evaluation types
     CreateDatasetRequest,
     CreateExperimentRequest,
+    // File types
+    CreatePresignedUploadRequest,
+    // Prompt types
+    CreatePromptRequest,
+    CreatePromptVersionRequest,
+    // Member types
+    InviteMemberRequest, PresignedUploadResponse,
     // Error types
-    ProblemDetails,
+    ProblemDetails, ReplayRequest, RunDetailResponse,
+    // Run types
+    RunResponse,
+    // Thread types
+    ThreadRequest,
+    ThreadSearchRequest, UpdateAgentRequest, UpdateCredentialRequest, UpdateCronJobRequest, UpdateMemberRequest, VectorQueryRequest,
+    VectorQueryResponse,
+    // Vector Store types
+    VectorStoreResponse, WaitRunResponse
 } from "./client/raw.js";
+

package/src/modules/builder.ts

@@ -36,35 +36,110 @@ export type CatalogVersions = {
     triggers: string;
 };
 
+export type ChatHistoryMessage = {
+    role: 'user' | 'assistant';
+    content: string;
+};
+
+/**
+ * Builder chat request.
+ * 
+ * KERNEL-FIRST: Frontend sends INTENTION only.
+ * - Graph spec is loaded from artifact storage by CP
+ * - Catalogs are loaded from DB by CP
+ * - Frontend should NOT send graph_spec or catalogs
+ */
 export type BuilderChatRequest = {
+    /** Chat message/intention */
     message: string;
-    current_graph_spec?: Record<string, unknown>;
+    /** Thread ID for conversation continuity */
     thread_id?: string;
-    /** Catalog versions to use for validation */
-    catalog_versions?: CatalogVersions;
-    /** Combined hash of all catalogs for integrity */
-    catalog_ref?: string;
+    /** Optional ETag for concurrency control */
+    base_graph_etag?: string;
+};
+
+export type HintTargetModel = {
+    node_id?: string;
+    edge_id?: string;
+    panel?: "credentials" | "triggers" | "logs" | "validation" | "deploy" | string;
+    action?: "create_credential" | "save_draft" | "publish_version" | string;
+};
+
+export type HintDataModel = {
+    // Credential hints
+    credential_slug?: string;
+    reason?: string;
+
+    // Config hints
+    fields?: string[];
+
+    // Error/validation hints
+    code?: string;
+    path?: string;
+
+    // Run/execution hints
+    run_id?: string;
+    error_code?: string;
+
+    // Cost/performance hints
+    tokens_in?: number;
+    tokens_out?: number;
+    usd_estimate?: number;
+
+    // Action hints
+    action_id?: string;
+    params?: Record<string, any>;
+};
+
+export type HintModel = {
+    id?: string;
+    scope: "graph" | "thread" | "run" | string;
+    type:
+    | "highlight_node"
+    | "needs_credential"
+    | "missing_config"
+    | "error_marker"
+    | "warning_marker"
+    | "toast"
+    | "run_started"
+    | "node_running"
+    | "node_failed"
+    | "rate_limited"
+    | "cost_estimate"
+    | "action_suggested"
+    | string;
+    severity: "info" | "warn" | "error" | "success";
+    target?: HintTargetModel;
+    message?: string;
+    ttl_ms?: number;
+    data?: HintDataModel;
 };
 
 export type GraphUpdateAction = {
+    // Legacy support
     action: string;
-    node_name?: string;
-    node_type?: string;
-    properties?: Record<string, unknown>;
-    edge_from?: string;
-    edge_to?: string;
+    // ... legacy fields omitted for brevity, keeping strict new protocol
+} | {
+    // New protocol (WAVE-3)
+    graph_spec: Record<string, unknown>;
+    hints?: HintModel[];
+    has_errors?: boolean;
 };
 
 export type BuilderStreamEvent =
     | { type: "message"; data: { text: string } }
-    | { type: "graph_update"; data: GraphUpdateAction }
-    | { type: "done"; data: { response: string; actions: GraphUpdateAction[]; thread_id: string } }
+    | { type: "validation"; data: { valid: boolean; errors: any[] } }
+    | { type: "graph_update"; data: { graph_spec: Record<string, unknown>; hints: HintModel[]; has_errors?: boolean } }
+    | { type: "done"; data: { response: string; thread_id: string } }
     | { type: "error"; data: { error: string } };
 
 export type BuilderChatResponse = {
     response: string;
-    actions: GraphUpdateAction[];
+    graph_spec?: Record<string, unknown>;
+    valid: boolean;
+    errors: any[];
     thread_id: string;
+    hints: HintModel[];
 };
 
 export class BuilderModule {
@@ -169,14 +244,27 @@ export class BuilderModule {
         request: BuilderChatRequest
     ): Promise<BuilderChatResponse> {
         let fullResponse = "";
-        const allActions: GraphUpdateAction[] = [];
+        let lastGraphSpec: Record<string, unknown> | undefined;
+        let allHints: HintModel[] = [];
+        const allErrors: any[] = [];
         let threadId = request.thread_id ?? "";
+        let isValid = true;
 
         for await (const event of this.chat(agentId, request)) {
             if (event.type === "message") {
                 fullResponse += event.data.text;
             } else if (event.type === "graph_update") {
-                allActions.push(event.data);
+                if ('graph_spec' in event.data) {
+                    lastGraphSpec = event.data.graph_spec;
+                    if (event.data.hints) {
+                        allHints.push(...event.data.hints);
+                    }
+                }
+            } else if (event.type === "validation") {
+                isValid = event.data.valid;
+                if (event.data.errors) {
+                    allErrors.push(...event.data.errors);
+                }
             } else if (event.type === "done") {
                 threadId = event.data.thread_id;
             }
@@ -184,7 +272,10 @@ export class BuilderModule {
 
         return {
             response: fullResponse,
-            actions: allActions,
+            graph_spec: lastGraphSpec,
+            hints: allHints,
+            valid: isValid,
+            errors: allErrors,
             thread_id: threadId,
         };
     }