@agent-os-sdk/client 0.9.14 → 0.9.15

package/src/modules/graphs.ts

@@ -1,188 +0,0 @@
-/**
- * Graphs Module - V2 Graph Specification Management
- * 
- * Pure V2 contract - no legacy. All types namespaced with "Graphs" prefix.
- */
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-// ============ Shared Types ============
-
-export interface GraphsValidationMessage {
-    code: string;
-    message: string;
-    path?: string;
-    node_id?: string;
-    severity?: "error" | "warning";
-}
-
-export interface GraphsValidationResult {
-    valid: boolean;
-    errors?: GraphsValidationMessage[];
-}
-
-// ============ GET /v2/api/graph/{agentId} ============
-
-export interface GraphsGetResponse {
-    agent_id: string;
-    revision: string;
-    canonical_spec: unknown;
-    committed_at: string;
-    warnings?: GraphsValidationMessage[];
-    validation?: GraphsValidationResult;
-}
-
-// ============ POST /v2/api/graph/commit ============
-
-export interface GraphsCommitRequest {
-    agent_id: string;
-    graph_spec: unknown;
-    expected_revision?: string;
-    source?: string;
-}
-
-export type GraphsCommitStatus = "committed" | "no_change";
-
-export interface GraphsCommitResponse {
-    status: GraphsCommitStatus;
-    agent_id: string;
-    revision: string;
-    canonical_spec: unknown;
-    committed_at: string;
-    warnings?: GraphsValidationMessage[];
-    validation?: GraphsValidationResult;
-}
-
-// 409 Conflict body (ProblemDetails.Extensions)
-// Envelope around GET response - agent_id lives in current.agent_id
-export interface GraphsConflictPayload {
-    hint: "reload_and_retry";
-    expected_revision: string;
-    current: GraphsGetResponse;
-}
-
-// ============ GET /v2/api/graph/{agentId}/revisions ============
-
-export interface GraphsRevisionSummary {
-    revision: string;
-    created_at: string;
-    source?: string;
-}
-
-export interface GraphsRevisionsListResponse {
-    agent_id: string;
-    revisions: GraphsRevisionSummary[];
-}
-
-// ============ GET /v2/api/graph/{agentId}/revisions/{revision} ============
-
-export interface GraphsRevisionResponse {
-    revision: string;
-    canonical_spec: unknown;
-    created_at: string;
-    source?: string;
-    warnings?: GraphsValidationMessage[];
-    validation?: GraphsValidationResult;
-}
-
-// ============ Validation (DP) ============
-
-export interface GraphsValidateRequest {
-    graph_spec: unknown;
-    normalize?: boolean;
-    catalog_versions?: Record<string, string>;
-}
-
-export interface GraphsValidateResponse {
-    valid: boolean;
-    canonical_spec_json?: string;
-    mermaid?: string;
-    nodes?: string[];
-    edges?: [string, string][];
-    errors?: GraphsValidationMessage[];
-    warnings?: GraphsValidationMessage[];
-}
-
-// ============ Introspection (DP) ============
-
-export interface GraphsIntrospectRequest {
-    agent_id?: string;
-    graph_spec?: unknown;
-    catalog_versions?: Record<string, string>;
-}
-
-export interface GraphsIntrospectResponse {
-    mermaid: string;
-    nodes: string[];
-    edges: [string, string][];
-    type?: string;
-}
-
-// ============ Module ============
-
-export class GraphsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    // ============ V2 Graph Spec (CP) ============
-
-    /**
-     * Get current graph spec by revision.
-     * @returns 200 with graph spec, or 404 if not initialized
-     */
-    async get(agentId: string): Promise<APIResponse<GraphsGetResponse>> {
-        return this.client.GET<GraphsGetResponse>(`/v1/api/graph/${agentId}`, {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Commit graph spec atomically.
-     * @returns 200 (committed/no_change), or 409 on conflict
-     */
-    async commit(request: GraphsCommitRequest): Promise<APIResponse<GraphsCommitResponse>> {
-        return this.client.POST<GraphsCommitResponse>("/v1/api/graph/commit", {
-            body: request,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * List revision history for an agent.
-     */
-    async listRevisions(agentId: string): Promise<APIResponse<GraphsRevisionsListResponse>> {
-        return this.client.GET<GraphsRevisionsListResponse>(`/v1/api/graph/${agentId}/revisions`, {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a specific revision.
-     */
-    async getRevision(agentId: string, revision: string): Promise<APIResponse<GraphsRevisionResponse>> {
-        return this.client.GET<GraphsRevisionResponse>(`/v1/api/graph/${agentId}/revisions/${revision}`, {
-            headers: this.headers(),
-        });
-    }
-
-    // ============ Validation (DP proxy) ============
-
-    /**
-     * Validate a graph specification.
-     */
-    async validate(body: GraphsValidateRequest): Promise<APIResponse<GraphsValidateResponse>> {
-        return this.client.POST<GraphsValidateResponse>("/v1/api/graphs/validate", {
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Introspect a graph structure.
-     */
-    async introspect(body: GraphsIntrospectRequest): Promise<APIResponse<GraphsIntrospectResponse>> {
-        return this.client.POST<GraphsIntrospectResponse>("/v1/api/graphs/introspect", {
-            body,
-            headers: this.headers(),
-        });
-    }
-}