@agent-os-sdk/client 0.1.2 → 0.2.2

package/dist/modules/artifacts.js

@@ -1,12 +1,23 @@
 /**
- * Artifacts Module - Output Management
+ * Artifacts Module - Run Output Management
  *
- * // MOCK - This module contains mock implementations for future features
- *
- * Manages artifacts as first-class outputs with integrity,
- * lineage tracking, and signatures.
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
  */
 // ============================================================================
+// Helper for 501 responses
+// ============================================================================
+function notImplemented(method) {
+    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 {
@@ -16,202 +27,24 @@ export class ArtifactsModule {
         this.client = client;
         this.headers = headers;
     }
-    // MOCK - Simulated list
-    /**
-     * List all artifacts.
-     */
-    async list(params) {
-        // MOCK - Returns simulated data
-        const mockArtifacts = {
-            items: [
-                {
-                    id: "artifact_1",
-                    name: "report.pdf",
-                    type: "document",
-                    mime_type: "application/pdf",
-                    size_bytes: 245000,
-                    sha256: "abc123def456...",
-                    url: "https://storage.example.com/artifacts/report.pdf",
-                    run_id: "run_123",
-                    thread_id: "thread_456",
-                    metadata: { pages: 12, author: "Agent Support" },
-                    signed: true,
-                    signature: "sig_abc123",
-                    created_at: new Date(Date.now() - 3600000).toISOString(),
-                    created_by: "agent_support",
-                },
-                {
-                    id: "artifact_2",
-                    name: "analysis.json",
-                    type: "data",
-                    mime_type: "application/json",
-                    size_bytes: 15000,
-                    sha256: "xyz789ghi012...",
-                    url: "https://storage.example.com/artifacts/analysis.json",
-                    run_id: "run_124",
-                    metadata: { records: 500 },
-                    signed: false,
-                    created_at: new Date(Date.now() - 7200000).toISOString(),
-                    created_by: "agent_analyzer",
-                },
-            ],
-            total: 2,
-        };
-        return { data: mockArtifacts, error: undefined, response: new Response() };
+    /** @returns 501 Not Implemented */
+    async list(runId) {
+        return notImplemented("list");
     }
-    // MOCK - Simulated get
-    /**
-     * Get an artifact by ID.
-     */
+    /** @returns 501 Not Implemented */
     async get(artifactId) {
-        // MOCK - Returns simulated data
-        const mockArtifact = {
-            id: artifactId,
-            name: "report.pdf",
-            type: "document",
-            mime_type: "application/pdf",
-            size_bytes: 245000,
-            sha256: "abc123def456...",
-            url: "https://storage.example.com/artifacts/report.pdf",
-            run_id: "run_123",
-            metadata: { pages: 12 },
-            signed: true,
-            signature: "sig_abc123",
-            created_at: new Date(Date.now() - 3600000).toISOString(),
-            created_by: "agent_support",
-        };
-        return { data: mockArtifact, error: undefined, response: new Response() };
+        return notImplemented("get");
     }
-    // MOCK - Simulated create
-    /**
-     * Create a new artifact reference.
-     */
-    async create(body) {
-        // MOCK - Returns simulated data
-        const mockArtifact = {
-            id: `artifact_${Date.now()}`,
-            name: body.name,
-            type: body.type,
-            mime_type: body.mime_type,
-            size_bytes: body.size_bytes,
-            sha256: body.sha256,
-            run_id: body.run_id,
-            thread_id: body.thread_id,
-            metadata: body.metadata || {},
-            signed: false,
-            created_at: new Date().toISOString(),
-            created_by: "user_current",
-        };
-        return { data: mockArtifact, error: undefined, response: new Response() };
+    /** @returns 501 Not Implemented */
+    async getDownloadUrl(artifactId) {
+        return notImplemented("getDownloadUrl");
     }
-    // MOCK - Simulated delete
-    /**
-     * Delete an artifact.
-     */
-    async delete(artifactId) {
-        // MOCK - Returns success
-        return { data: undefined, error: undefined, response: new Response() };
+    /** @returns 501 Not Implemented */
+    async createUploadUrl(runId, name, type) {
+        return notImplemented("createUploadUrl");
     }
-    // MOCK - Simulated sign
-    /**
-     * Sign an artifact for integrity verification.
-     */
-    async sign(artifactId) {
-        // MOCK - Returns simulated signed artifact
-        const mockArtifact = {
-            id: artifactId,
-            name: "report.pdf",
-            type: "document",
-            mime_type: "application/pdf",
-            size_bytes: 245000,
-            sha256: "abc123def456...",
-            metadata: {},
-            signed: true,
-            signature: `sig_${Date.now()}`,
-            created_at: new Date(Date.now() - 3600000).toISOString(),
-            created_by: "agent_support",
-        };
-        return { data: mockArtifact, error: undefined, response: new Response() };
-    }
-    // MOCK - Simulated lineage
-    /**
-     * Get artifact lineage (provenance tracking).
-     */
-    async lineage(artifactId) {
-        // MOCK - Returns simulated lineage
-        const mockLineage = {
-            artifact_id: artifactId,
-            source: {
-                type: "run",
-                id: "run_123",
-                name: "Support Agent Run",
-                timestamp: new Date(Date.now() - 3600000).toISOString(),
-            },
-            transformations: [
-                {
-                    step: 1,
-                    operation: "generate",
-                    run_id: "run_123",
-                    tool_name: "document_generator",
-                    timestamp: new Date(Date.now() - 3500000).toISOString(),
-                },
-                {
-                    step: 2,
-                    operation: "format",
-                    run_id: "run_123",
-                    tool_name: "pdf_formatter",
-                    timestamp: new Date(Date.now() - 3400000).toISOString(),
-                },
-            ],
-            dependencies: ["artifact_raw_data", "artifact_template"],
-        };
-        return { data: mockLineage, error: undefined, response: new Response() };
-    }
-    // MOCK - Simulated getForRun
-    /**
-     * Get all artifacts produced by a run.
-     */
-    async getForRun(runId) {
-        // MOCK - Returns simulated data
-        const mockArtifacts = {
-            items: [
-                {
-                    id: "artifact_run_1",
-                    name: "output.json",
-                    type: "data",
-                    mime_type: "application/json",
-                    size_bytes: 5000,
-                    sha256: "run_output_hash",
-                    run_id: runId,
-                    metadata: {},
-                    signed: false,
-                    created_at: new Date().toISOString(),
-                    created_by: "agent",
-                },
-            ],
-            total: 1,
-        };
-        return { data: mockArtifacts, error: undefined, response: new Response() };
-    }
-    // MOCK - Simulated attachToThread
-    /**
-     * Attach an artifact to a thread.
-     */
-    async attachToThread(threadId, artifactId) {
-        // MOCK - Returns simulated data
-        const mockArtifact = {
-            id: artifactId,
-            name: "attached_file.pdf",
-            type: "document",
-            mime_type: "application/pdf",
-            size_bytes: 100000,
-            sha256: "attached_hash",
-            thread_id: threadId,
-            metadata: {},
-            signed: false,
-            created_at: new Date().toISOString(),
-            created_by: "user",
-        };
-        return { data: mockArtifact, error: undefined, response: new Response() };
+    /** @returns 501 Not Implemented */
+    async delete(artifactId) {
+        return notImplemented("delete");
     }
 }

package/dist/modules/budgets.d.ts

@@ -1,104 +1,81 @@
 /**
- * Budgets Module - Cost Control
+ * Budgets Module - Cost & Token Management
  *
- * // MOCK - This module contains mock implementations for future features
- *
- * Provides budget management, cost estimation, and spending limits.
- * Critical for CFO happiness and auto-protection.
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
  */
 import type { RawClient, APIResponse } from "../client/raw.js";
-export type BudgetPeriod = "hourly" | "daily" | "weekly" | "monthly" | "total";
-export type BudgetScope = "tenant" | "workspace" | "agent" | "environment";
+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;
-    limit_amount: number;
-    currency: string;
-    current_usage: number;
-    usage_percentage: number;
-    alert_thresholds: number[];
-    hard_limit: boolean;
+    period_start: string;
+    period_end: string;
+    alert_threshold_percent?: number;
     created_at: string;
-    updated_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;
-    total_cost: number;
-    breakdown: BudgetBreakdown[];
-}
-export interface BudgetBreakdown {
-    category: string;
-    amount: number;
-    percentage: number;
-    run_count: number;
+    breakdown: BudgetBreakdownItem[];
 }
-export interface CostEstimate {
-    estimated_min: number;
-    estimated_max: number;
-    estimated_avg: number;
-    currency: string;
-    breakdown: {
-        input_tokens: number;
-        output_tokens: number;
-        tool_calls: number;
-        model_cost: number;
-    };
-    warnings: string[];
+export interface BudgetBreakdownItem {
+    agent_id?: string;
+    agent_name?: string;
+    model?: string;
+    value: number;
+    percent_of_total: number;
 }
-export interface BudgetListResponse {
-    items: Budget[];
-    total: number;
+export interface BudgetAlert {
+    id: string;
+    budget_id: string;
+    type: "threshold_warning" | "limit_reached" | "limit_exceeded";
+    message: string;
+    triggered_at: string;
+    acknowledged: boolean;
 }
 export declare class BudgetsModule {
     private client;
     private headers;
     constructor(client: RawClient, headers: () => Record<string, string>);
-    /**
-     * List all budgets.
-     */
+    /** @returns 501 Not Implemented */
     list(params?: {
         scope?: BudgetScope;
-    }): Promise<APIResponse<BudgetListResponse>>;
-    /**
-     * Get a budget by ID.
-     */
+        scope_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<{
+        items: Budget[];
+        total: number;
+    }>>;
+    /** @returns 501 Not Implemented */
     get(budgetId: string): Promise<APIResponse<Budget>>;
-    /**
-     * Create or update a budget.
-     */
-    set(body: {
+    /** @returns 501 Not Implemented */
+    create(body: {
         name: string;
         scope: BudgetScope;
         scope_id: string;
+        resource_type: BudgetResourceType;
+        limit_value: number;
         period: BudgetPeriod;
-        limit_amount: number;
-        currency?: string;
-        alert_thresholds?: number[];
-        hard_limit?: boolean;
+        alert_threshold_percent?: number;
     }): Promise<APIResponse<Budget>>;
-    /**
-     * Get budget usage details.
-     */
+    /** @returns 501 Not Implemented */
     getUsage(budgetId: string): Promise<APIResponse<BudgetUsage>>;
-    /**
-     * Estimate cost for a run before execution.
-     */
-    estimateCost(params: {
-        agent_id: string;
-        input?: Record<string, unknown>;
-        max_iterations?: number;
-    }): Promise<APIResponse<CostEstimate>>;
-    /**
-     * Set a hard budget cap for a specific run.
-     */
-    setBudgetForRun(runId: string, limit: number): Promise<APIResponse<{
-        run_id: string;
-        limit: number;
-    }>>;
+    /** @returns 501 Not Implemented */
+    getAlerts(budgetId: string): Promise<APIResponse<BudgetAlert[]>>;
 }
 //# sourceMappingURL=budgets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/modules/budgets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAC/E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC;AAE3E,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,aAAa;IACV,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGpF;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAyCtF;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAqBzD;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,WAAW,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,YAAY,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAqBhC;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAkBnE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAmBtC;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAQ/G"}
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/modules/budgets.ts"],"names":[],"mappings":"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"}

package/dist/modules/budgets.js

@@ -1,12 +1,23 @@
 /**
- * Budgets Module - Cost Control
+ * Budgets Module - Cost & Token Management
  *
- * // MOCK - This module contains mock implementations for future features
- *
- * Provides budget management, cost estimation, and spending limits.
- * Critical for CFO happiness and auto-protection.
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
  */
 // ============================================================================
+// Helper for 501 responses
+// ============================================================================
+function notImplemented(method) {
+    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 {
@@ -16,146 +27,24 @@ export class BudgetsModule {
         this.client = client;
         this.headers = headers;
     }
-    // MOCK - Simulated list
-    /**
-     * List all budgets.
-     */
+    /** @returns 501 Not Implemented */
     async list(params) {
-        // MOCK - Returns simulated data
-        const mockBudgets = {
-            items: [
-                {
-                    id: "budget_tenant",
-                    name: "Monthly Tenant Budget",
-                    scope: "tenant",
-                    scope_id: "tenant_123",
-                    period: "monthly",
-                    limit_amount: 5000,
-                    currency: "USD",
-                    current_usage: 1250.50,
-                    usage_percentage: 25.01,
-                    alert_thresholds: [50, 80, 90],
-                    hard_limit: false,
-                    created_at: new Date(Date.now() - 2592000000).toISOString(),
-                    updated_at: new Date().toISOString(),
-                },
-                {
-                    id: "budget_agent_1",
-                    name: "Agent Daily Budget",
-                    scope: "agent",
-                    scope_id: "agent_support",
-                    period: "daily",
-                    limit_amount: 50,
-                    currency: "USD",
-                    current_usage: 12.30,
-                    usage_percentage: 24.6,
-                    alert_thresholds: [80, 95],
-                    hard_limit: true,
-                    created_at: new Date(Date.now() - 86400000).toISOString(),
-                    updated_at: new Date().toISOString(),
-                },
-            ],
-            total: 2,
-        };
-        return { data: mockBudgets, error: undefined, response: new Response() };
+        return notImplemented("list");
     }
-    // MOCK - Simulated get
-    /**
-     * Get a budget by ID.
-     */
+    /** @returns 501 Not Implemented */
     async get(budgetId) {
-        // MOCK - Returns simulated data
-        const mockBudget = {
-            id: budgetId,
-            name: "Monthly Tenant Budget",
-            scope: "tenant",
-            scope_id: "tenant_123",
-            period: "monthly",
-            limit_amount: 5000,
-            currency: "USD",
-            current_usage: 1250.50,
-            usage_percentage: 25.01,
-            alert_thresholds: [50, 80, 90],
-            hard_limit: false,
-            created_at: new Date(Date.now() - 2592000000).toISOString(),
-            updated_at: new Date().toISOString(),
-        };
-        return { data: mockBudget, error: undefined, response: new Response() };
+        return notImplemented("get");
     }
-    // MOCK - Simulated set
-    /**
-     * Create or update a budget.
-     */
-    async set(body) {
-        // MOCK - Returns simulated data
-        const mockBudget = {
-            id: `budget_${Date.now()}`,
-            name: body.name,
-            scope: body.scope,
-            scope_id: body.scope_id,
-            period: body.period,
-            limit_amount: body.limit_amount,
-            currency: body.currency || "USD",
-            current_usage: 0,
-            usage_percentage: 0,
-            alert_thresholds: body.alert_thresholds || [80, 90],
-            hard_limit: body.hard_limit ?? false,
-            created_at: new Date().toISOString(),
-            updated_at: new Date().toISOString(),
-        };
-        return { data: mockBudget, error: undefined, response: new Response() };
+    /** @returns 501 Not Implemented */
+    async create(body) {
+        return notImplemented("create");
     }
-    // MOCK - Simulated getUsage
-    /**
-     * Get budget usage details.
-     */
+    /** @returns 501 Not Implemented */
     async getUsage(budgetId) {
-        // MOCK - Returns simulated data
-        const mockUsage = {
-            budget_id: budgetId,
-            period_start: new Date(Date.now() - 2592000000).toISOString(),
-            period_end: new Date().toISOString(),
-            total_cost: 1250.50,
-            breakdown: [
-                { category: "GPT-4", amount: 800.00, percentage: 63.97, run_count: 450 },
-                { category: "Claude", amount: 300.50, percentage: 24.03, run_count: 200 },
-                { category: "Embeddings", amount: 100.00, percentage: 8.00, run_count: 1000 },
-                { category: "Tools", amount: 50.00, percentage: 4.00, run_count: 300 },
-            ],
-        };
-        return { data: mockUsage, error: undefined, response: new Response() };
-    }
-    // MOCK - Simulated estimateCost
-    /**
-     * Estimate cost for a run before execution.
-     */
-    async estimateCost(params) {
-        // MOCK - Returns simulated estimate
-        const mockEstimate = {
-            estimated_min: 0.05,
-            estimated_max: 0.25,
-            estimated_avg: 0.12,
-            currency: "USD",
-            breakdown: {
-                input_tokens: 2000,
-                output_tokens: 3000,
-                tool_calls: 5,
-                model_cost: 0.10,
-            },
-            warnings: [],
-        };
-        return { data: mockEstimate, error: undefined, response: new Response() };
+        return notImplemented("getUsage");
     }
-    // MOCK - Simulated setBudgetForRun
-    /**
-     * Set a hard budget cap for a specific run.
-     */
-    async setBudgetForRun(runId, limit) {
-        // MOCK - Returns simulated data
-        return {
-            data: { run_id: runId, limit },
-            error: undefined,
-            response: new Response()
-        };
+    /** @returns 501 Not Implemented */
+    async getAlerts(budgetId) {
+        return notImplemented("getAlerts");
     }
 }

package/dist/modules/builder.d.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 { type SSEOptions } from "../sse/client.js";
 export type BuilderChatRequest = {

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

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/modules/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,aAAa;IAElB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;gBADP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGjD;;;OAGG;IACI,IAAI,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,UAAU,GACrB,cAAc,CAAC,kBAAkB,CAAC;IA8DrC;;OAEG;IACG,QAAQ,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;OAEG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAqBlC"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/modules/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,aAAa;IAElB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;gBADP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGjD;;;OAGG;IACI,IAAI,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,UAAU,GACrB,cAAc,CAAC,kBAAkB,CAAC;IA+DrC;;OAEG;IACG,QAAQ,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAqB/B;;OAEG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAqBlC"}