@cavi-ai/api-client 0.1.0

package/dist/core/gateway/agent/config.d.ts

@@ -0,0 +1,158 @@
+import { BaseHttpApiClient } from "../../http/client.js";
+import type { HttpApiClientOptions } from "../../http/types.js";
+import { type AgentVoiceConfig } from "./voice-config.js";
+export declare const AGENT_PROFILE_CONFIG_CONTRACT = "AGENT_PROFILE_CONFIG_V1";
+export declare const AGENT_PROFILE_CONFIG_PATCH_CONTRACT = "AGENT_PROFILE_CONFIG_PATCH_V1";
+export type AgentConfigFieldValue = string | number | boolean | null | readonly unknown[] | Record<string, unknown>;
+export type AgentConfigFieldKind = {
+    type: "text";
+    placeholder?: string;
+} | {
+    type: "multiline";
+    placeholder?: string;
+    minRows?: number;
+} | {
+    type: "number";
+    min?: number;
+    max?: number;
+    step?: number;
+} | {
+    type: "toggle";
+} | {
+    type: "select";
+    options: readonly {
+        value: string;
+        label: string;
+    }[];
+} | {
+    type: "chips";
+    suggestions?: readonly string[];
+} | {
+    type: "list";
+    placeholder?: string;
+    suggestions?: readonly string[];
+} | {
+    type: "json";
+    minRows?: number;
+};
+export type AgentConfigField = {
+    key: string;
+    label: string;
+    description?: string;
+    kind: AgentConfigFieldKind;
+    value: AgentConfigFieldValue;
+    editable?: boolean;
+    sourcePath?: readonly string[];
+};
+export type AgentConfigSectionId = string;
+export type AgentConfigSection = {
+    id: AgentConfigSectionId;
+    label: string;
+    fields: readonly AgentConfigField[];
+};
+export type AgentConfig = {
+    agentId: string;
+    agentName: string;
+    sourcePath?: string;
+    etag?: string;
+    sections: readonly AgentConfigSection[];
+    voice?: AgentVoiceConfig;
+    fetchedAt: number;
+};
+export type AgentConfigDraftDiff = Record<string, AgentConfigFieldValue>;
+export type GatewayConfigSchemaField = {
+    type?: string;
+    description?: string;
+    category?: string;
+    options?: readonly unknown[];
+    min?: number;
+    max?: number;
+    step?: number;
+};
+export type GatewayConfigSchemaPayload = {
+    fields?: Record<string, GatewayConfigSchemaField | unknown>;
+    category_order?: readonly string[];
+};
+export type AgentProfileSummary = {
+    agentId: string;
+    agentName: string;
+    sourcePath?: string;
+    isActive?: boolean;
+    isDefault?: boolean;
+    model?: string | null;
+    provider?: string | null;
+};
+export type AgentProfileSourcePathResolver = (agentId: string) => string;
+export type AgentProfileConfigPatchBody = {
+    contract: typeof AGENT_PROFILE_CONFIG_PATCH_CONTRACT;
+    version: 1;
+    agentId: string;
+    profile: string;
+    source: "profile-config-yaml";
+    sourcePath: string;
+    patch: AgentConfigDraftDiff;
+    baseEtag?: string;
+};
+export declare class GatewayAgentConfigApiError extends Error {
+    readonly status?: number;
+    readonly path?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        path?: string;
+    });
+}
+export declare function setAgentConfigPathValue(config: Record<string, unknown>, path: string, value: AgentConfigFieldValue): Record<string, unknown>;
+export declare function assertAgentProfileId(agentId: string): string;
+export declare function agentProfileConfigPath(agentId: string): string;
+export declare function agentProfileConfigSourcePath(agentId: string): string;
+export declare function isMissingAgentConfigRouteError(error: unknown): boolean;
+export declare function normalizeAgentProfiles(payload: unknown): AgentProfileSummary[];
+export declare function findAgentProfile(profiles: readonly AgentProfileSummary[], agentId: string): AgentProfileSummary | null;
+export declare function buildAgentConfigFromConfigSnapshot(input: {
+    agentId: string;
+    config: unknown;
+    schema?: unknown;
+    defaults?: unknown;
+    profile?: AgentProfileSummary | null;
+    defaultSourcePath?: AgentProfileSourcePathResolver;
+    fetchedAt?: number;
+    etag?: string;
+}): AgentConfig;
+export declare function buildAgentProfileConfigPatchBody(params: {
+    agentId: string;
+    diff: AgentConfigDraftDiff;
+    baseEtag?: string;
+    sourcePath?: string;
+    defaultSourcePath?: AgentProfileSourcePathResolver;
+}): AgentProfileConfigPatchBody;
+export type GatewayAgentConfigEndpointMap = {
+    profiles: string;
+    config: string;
+    configDefaults: string;
+    configSchema: string;
+    agentConfigs: string;
+    agentConfig: (agentId: string) => string;
+};
+export type GatewayAgentConfigApiClientOptions = {
+    endpoints?: GatewayAgentConfigEndpointMap;
+    surface?: string;
+    defaultSourcePath?: AgentProfileSourcePathResolver;
+};
+export type PatchProfileConfigOptions = {
+    baseEtag?: string;
+    sourcePath?: string;
+};
+export interface GatewayAgentConfigClient {
+    listProfiles(): Promise<AgentProfileSummary[]>;
+    getProfileConfig(agentId: string): Promise<AgentConfig>;
+    patchProfileConfig(agentId: string, diff: AgentConfigDraftDiff, options?: PatchProfileConfigOptions): Promise<AgentConfig>;
+}
+export declare class GatewayAgentConfigApiClient extends BaseHttpApiClient implements GatewayAgentConfigClient {
+    readonly endpoints: GatewayAgentConfigEndpointMap;
+    protected readonly defaultSourcePath: AgentProfileSourcePathResolver;
+    constructor(options: HttpApiClientOptions, configOptions?: GatewayAgentConfigApiClientOptions);
+    listProfiles(): Promise<AgentProfileSummary[]>;
+    getProfileConfig(agentId: string): Promise<AgentConfig>;
+    patchProfileConfig(agentId: string, diff: AgentConfigDraftDiff, options?: PatchProfileConfigOptions): Promise<AgentConfig>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/core/gateway/agent/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/agent/config.ts"],"names":[],"mappings":"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"}