@alfe.ai/agent-api-client 0.0.2

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+//#region ../../packages-internal/types/dist/integration.d.ts
+declare const IntegrationDesiredStatus: {
+  readonly Active: "active";
+  readonly Removed: "removed";
+};
+type IntegrationDesiredStatus = (typeof IntegrationDesiredStatus)[keyof typeof IntegrationDesiredStatus];
+declare const IntegrationActualStatus: {
+  readonly Installing: "installing";
+  readonly Active: "active";
+  readonly Error: "error";
+  readonly Removing: "removing";
+  readonly Inactive: "inactive";
+  readonly Unknown: "unknown";
+};
+type IntegrationActualStatus = (typeof IntegrationActualStatus)[keyof typeof IntegrationActualStatus];
+interface AgentIntegration {
+  agentId: string;
+  integrationId: string;
+  tenantId: string;
+  desiredStatus: IntegrationDesiredStatus;
+  actualStatus: IntegrationActualStatus;
+  version: string;
+  config: Record<string, unknown>;
+  errorMessage: string;
+  installedAt: string;
+  updatedAt: string;
+}
+interface IntegrationConfigSchemaField {
+  key: string;
+  label: string;
+  type: string;
+  description?: string;
+  required?: boolean;
+  default?: string | number | boolean;
+  options?: string[];
+  select_options?: {
+    value: string;
+    label: string;
+  }[];
+  oauth_provider?: string;
+  editable?: string;
+}
+interface IntegrationConfigResult {
+  integrationId: string;
+  config: Record<string, unknown>;
+  configSchema: IntegrationConfigSchemaField[];
+}
+interface RegistryEntry {
+  id: string;
+  name: string;
+  description: string;
+  versions: string[];
+  latest: string;
+  repository: string;
+  commit?: string;
+  icon?: string;
+  author?: {
+    name: string;
+    url?: string;
+  } | string;
+  pricing?: {
+    type: "free" | "paid";
+    price?: number;
+    currency?: string;
+    interval?: "month" | "year";
+  };
+  features?: string[];
+  preview_images?: string[];
+  config_schema?: IntegrationConfigSchemaField[];
+  supported_agents?: string[];
+}
+//# sourceMappingURL=integration.d.ts.map
+//#endregion
+//#region src/index.d.ts
+interface AgentApiClientConfig {
+  apiKey: string;
+  apiUrl: string;
+}
+declare class AgentApiClient {
+  private readonly apiKey;
+  private readonly apiUrl;
+  constructor(config: AgentApiClientConfig);
+  private request;
+  listIntegrations(): Promise<AgentIntegration[]>;
+  getIntegrationConfig(integrationId: string): Promise<IntegrationConfigResult>;
+  updateIntegrationConfig(integrationId: string, config: Record<string, unknown>): Promise<void>;
+  installIntegration(integrationId: string, options?: {
+    version?: string;
+    config?: Record<string, unknown>;
+  }): Promise<AgentIntegration>;
+  removeIntegration(integrationId: string): Promise<AgentIntegration>;
+  getRegistry(): Promise<{
+    integrations: RegistryEntry[];
+  }>;
+}
+//# sourceMappingURL=index.d.ts.map
+
+//#endregion
+export { AgentApiClient, AgentApiClientConfig, type AgentIntegration, type IntegrationConfigResult, type IntegrationConfigSchemaField, type RegistryEntry };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["IntegrationDesiredStatus","INTEGRATION_DESIRED_STATUSES","IntegrationActualStatus","INTEGRATION_ACTUAL_STATUSES","AgentIntegration","Record","IntegrationConfigSchemaField","IntegrationConfigResult","RegistryEntry"],"sources":["../../../packages-internal/types/dist/integration.d.ts","../src/index.ts"],"sourcesContent":["export declare const IntegrationDesiredStatus: {\n    readonly Active: \"active\";\n    readonly Removed: \"removed\";\n};\nexport type IntegrationDesiredStatus = (typeof IntegrationDesiredStatus)[keyof typeof IntegrationDesiredStatus];\nexport declare const INTEGRATION_DESIRED_STATUSES: readonly [\"active\" | \"removed\", ...(\"active\" | \"removed\")[]];\nexport declare const IntegrationActualStatus: {\n    readonly Installing: \"installing\";\n    readonly Active: \"active\";\n    readonly Error: \"error\";\n    readonly Removing: \"removing\";\n    readonly Inactive: \"inactive\";\n    readonly Unknown: \"unknown\";\n};\nexport type IntegrationActualStatus = (typeof IntegrationActualStatus)[keyof typeof IntegrationActualStatus];\nexport declare const INTEGRATION_ACTUAL_STATUSES: readonly [\"active\" | \"error\" | \"installing\" | \"removing\" | \"inactive\" | \"unknown\", ...(\"active\" | \"error\" | \"installing\" | \"removing\" | \"inactive\" | \"unknown\")[]];\nexport interface AgentIntegration {\n    agentId: string;\n    integrationId: string;\n    tenantId: string;\n    desiredStatus: IntegrationDesiredStatus;\n    actualStatus: IntegrationActualStatus;\n    version: string;\n    config: Record<string, unknown>;\n    errorMessage: string;\n    installedAt: string;\n    updatedAt: string;\n}\nexport interface IntegrationConfigSchemaField {\n    key: string;\n    label: string;\n    type: string;\n    description?: string;\n    required?: boolean;\n    default?: string | number | boolean;\n    options?: string[];\n    select_options?: {\n        value: string;\n        label: string;\n    }[];\n    oauth_provider?: string;\n    editable?: string;\n}\nexport interface IntegrationConfigResult {\n    integrationId: string;\n    config: Record<string, unknown>;\n    configSchema: IntegrationConfigSchemaField[];\n}\nexport interface RegistryEntry {\n    id: string;\n    name: string;\n    description: string;\n    versions: string[];\n    latest: string;\n    repository: string;\n    commit?: string;\n    icon?: string;\n    author?: {\n        name: string;\n        url?: string;\n    } | string;\n    pricing?: {\n        type: \"free\" | \"paid\";\n        price?: number;\n        currency?: string;\n        interval?: \"month\" | \"year\";\n    };\n    features?: string[];\n    preview_images?: string[];\n    config_schema?: IntegrationConfigSchemaField[];\n    supported_agents?: string[];\n}\n//# sourceMappingURL=integration.d.ts.map"],"mappings":";cAAqBA;EAAAA,SAAAA,MAAAA,EAAAA,QAAAA;EAITA,SAAAA,OAAAA,EAAAA,SAAwB;CAAA;AAAWA,KAAnCA,wBAAAA,GAAmCA,CAAAA,OAAAA,wBAAAA,CAAAA,CAAAA,MAAAA,OAAuCA,wBAAvCA,CAAAA;AAA+D,cAEzFE,uBAFyF,EAAA;EAEzFA,SAAAA,UAAAA,EAAAA,YAOpB;EACWA,SAAAA,MAAAA,EAAAA,QAAAA;EAAuB,SAAA,KAAA,EAAA,OAAA;WAAWA,QAAAA,EAAAA,UAAAA;WAAsCA,QAAAA,EAAAA,UAAAA;EAAuB,SAAA,OAAA,EAAA,SAAA;AAE3G,CAAA;AAAiC,KAFrBA,uBAAAA,GAEqB,CAAA,OAFaA,uBAEb,CAAA,CAAA,MAAA,OAFmDA,uBAEnD,CAAA;AAKfA,UALDE,gBAAAA,CAKCF;SAENG,EAAAA,MAAAA;EAAM,aAAA,EAAA,MAAA;EAKDC,QAAAA,EAAAA,MAAAA;EAeAC,aAAAA,EAvBEP,wBAuBqB;EAAA,YAAA,EAtBtBE,uBAsBsB;SAE5BG,EAAAA,MAAAA;QACMC,EAvBND,MAuBMC,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA;EAA4B,YAAA,EAAA,MAAA;EAE7BE,WAAAA,EAAAA,MAAa;;;UApBbF,4BAAAA;ECXA,GAAA,EAAA,MAAA;EAKJ,KAAA,EAAA,MAAA;EAAc,IAAA,EAAA,MAAA;aAIL,CAAA,EAAA,MAAA;UAsBc,CAAA,EAAA,OAAA;SAAR,CAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA;SAIiC,CAAA,EAAA,MAAA,EAAA;gBAAR,CAAA,EAAA;IAQzC,KAAA,EAAA,MAAA;IACP,KAAA,EAAA,MAAA;KAYsC;gBAC9B,CAAA,EAAA,MAAA;UAAR,CAAA,EAAA,MAAA;;AAW6C,UD1CjCC,uBAAAA,CC0CiC;eAOH,EAAA,MAAA;QAAxB,ED/CXF,MC+CW,CAAA,MAAA,EAAA,OAAA,CAAA;EAAO,YAAA,ED9CZC,4BC8CY,EAAA;;UD5CbE,aAAAA;;;;;;;;;;;;;;;;;;;;;kBAqBGF;;;;;;AAvDe,UCGlB,oBAAA,CDHkB;QAAWJ,EAAAA,MAAAA;QAAsCA,EAAAA,MAAAA;;AAEnEE,cCMJ,cAAA,CDNoB;EAAA,iBAAA,MAAA;mBAIdJ,MAAAA;aACDE,CAAAA,MAAAA,ECKI,oBDLJA;UAENG,OAAAA;EAAM,gBAAA,CAAA,CAAA,ECyBU,ODzBV,CCyBkB,gBDzBlB,EAAA,CAAA;EAKDC,oBAAAA,CAAAA,aAA4B,EAAA,MAAA,CAAA,ECwBQ,ODxBR,CCwBgB,uBDxBhB,CAAA;EAe5BC,uBAAAA,CAAAA,aAAuB,EAAA,MAAA,EAAA,MAAA,ECiB5B,MDjB4B,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,ECkBnC,ODlBmC,CAAA,IAAA,CAAA;EAAA,kBAAA,CAAA,aAAA,EAAA,MAAA,EAAA,OAGM,CAHN,EAAA;IAE5BF,OAAAA,CAAAA,EAAAA,MAAAA;IACMC,MAAAA,CAAAA,EC2ByB,MD3BzBA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA;EAA4B,CAAA,CAAA,EC4BzC,OD5ByC,CC4BjC,gBD5BiC,CAAA;EAE7BE,iBAAa,CAAA,aAqBVF,EAAAA,MAAAA,CAAAA,ECgB8B,ODhB9BA,CCgBsC,gBDhBV,CAAA;iBCuBzB;kBAAwB;;AA3E/C;AAKA"}

package/dist/index.js

@@ -0,0 +1,56 @@
+//#region src/index.ts
+var AgentApiClient = class {
+	apiKey;
+	apiUrl;
+	constructor(config) {
+		this.apiKey = config.apiKey;
+		this.apiUrl = config.apiUrl;
+	}
+	async request(path, options) {
+		const url = `${this.apiUrl}${path}`;
+		const headers = new Headers(options?.headers);
+		headers.set("Authorization", `Bearer ${this.apiKey}`);
+		headers.set("Content-Type", "application/json");
+		const res = await fetch(url, {
+			...options,
+			headers
+		});
+		if (!res.ok) {
+			const body = await res.text();
+			throw new Error(`Agent API error ${String(res.status)}: ${body}`);
+		}
+		return (await res.json()).data;
+	}
+	async listIntegrations() {
+		return this.request("/agents/integrations");
+	}
+	async getIntegrationConfig(integrationId) {
+		return this.request(`/agents/integrations/${encodeURIComponent(integrationId)}/config`);
+	}
+	async updateIntegrationConfig(integrationId, config) {
+		await this.request(`/agents/integrations/${encodeURIComponent(integrationId)}`, {
+			method: "PATCH",
+			body: JSON.stringify({ config })
+		});
+	}
+	async installIntegration(integrationId, options) {
+		return this.request("/agents/integrations", {
+			method: "POST",
+			body: JSON.stringify({
+				integrationId,
+				version: options?.version,
+				config: options?.config
+			})
+		});
+	}
+	async removeIntegration(integrationId) {
+		return this.request(`/agents/integrations/${encodeURIComponent(integrationId)}`, { method: "DELETE" });
+	}
+	async getRegistry() {
+		return this.request("/integrations/registry");
+	}
+};
+//#endregion
+export { AgentApiClient };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @alfe.ai/agent-api-client — Agent self-service API client.\n *\n * Used by agents calling /agents/ endpoints. The agent authenticates\n * with its API key — the backend resolves agentId + tenantId from the token.\n * No agent ID needed in paths or config.\n */\n\nexport type {\n  AgentIntegration,\n  IntegrationConfigResult,\n  RegistryEntry,\n  IntegrationConfigSchemaField,\n} from \"@alfe/types\";\n\nimport type { AgentIntegration, IntegrationConfigResult, RegistryEntry } from \"@alfe/types\";\n\nexport interface AgentApiClientConfig {\n  apiKey: string;\n  apiUrl: string;\n}\n\nexport class AgentApiClient {\n  private readonly apiKey: string;\n  private readonly apiUrl: string;\n\n  constructor(config: AgentApiClientConfig) {\n    this.apiKey = config.apiKey;\n    this.apiUrl = config.apiUrl;\n  }\n\n  private async request<T>(path: string, options?: RequestInit): Promise<T> {\n    const url = `${this.apiUrl}${path}`;\n    const headers = new Headers(options?.headers);\n    headers.set(\"Authorization\", `Bearer ${this.apiKey}`);\n    headers.set(\"Content-Type\", \"application/json\");\n\n    const res = await fetch(url, { ...options, headers });\n\n    if (!res.ok) {\n      const body = await res.text();\n      throw new Error(`Agent API error ${String(res.status)}: ${body}`);\n    }\n\n    const body = (await res.json()) as { data: T };\n    return body.data;\n  }\n\n  async listIntegrations(): Promise<AgentIntegration[]> {\n    return this.request<AgentIntegration[]>(\"/agents/integrations\");\n  }\n\n  async getIntegrationConfig(integrationId: string): Promise<IntegrationConfigResult> {\n    return this.request<IntegrationConfigResult>(\n      `/agents/integrations/${encodeURIComponent(integrationId)}/config`,\n    );\n  }\n\n  async updateIntegrationConfig(\n    integrationId: string,\n    config: Record<string, unknown>,\n  ): Promise<void> {\n    await this.request<unknown>(\n      `/agents/integrations/${encodeURIComponent(integrationId)}`,\n      {\n        method: \"PATCH\",\n        body: JSON.stringify({ config }),\n      },\n    );\n  }\n\n  async installIntegration(\n    integrationId: string,\n    options?: { version?: string; config?: Record<string, unknown> },\n  ): Promise<AgentIntegration> {\n    return this.request<AgentIntegration>(\"/agents/integrations\", {\n      method: \"POST\",\n      body: JSON.stringify({\n        integrationId,\n        version: options?.version,\n        config: options?.config,\n      }),\n    });\n  }\n\n  async removeIntegration(integrationId: string): Promise<AgentIntegration> {\n    return this.request<AgentIntegration>(\n      `/agents/integrations/${encodeURIComponent(integrationId)}`,\n      { method: \"DELETE\" },\n    );\n  }\n\n  async getRegistry(): Promise<{ integrations: RegistryEntry[] }> {\n    return this.request<{ integrations: RegistryEntry[] }>(\"/integrations/registry\");\n  }\n}\n"],"mappings":";AAsBA,IAAa,iBAAb,MAA4B;CAC1B;CACA;CAEA,YAAY,QAA8B;AACxC,OAAK,SAAS,OAAO;AACrB,OAAK,SAAS,OAAO;;CAGvB,MAAc,QAAW,MAAc,SAAmC;EACxE,MAAM,MAAM,GAAG,KAAK,SAAS;EAC7B,MAAM,UAAU,IAAI,QAAQ,SAAS,QAAQ;AAC7C,UAAQ,IAAI,iBAAiB,UAAU,KAAK,SAAS;AACrD,UAAQ,IAAI,gBAAgB,mBAAmB;EAE/C,MAAM,MAAM,MAAM,MAAM,KAAK;GAAE,GAAG;GAAS;GAAS,CAAC;AAErD,MAAI,CAAC,IAAI,IAAI;GACX,MAAM,OAAO,MAAM,IAAI,MAAM;AAC7B,SAAM,IAAI,MAAM,mBAAmB,OAAO,IAAI,OAAO,CAAC,IAAI,OAAO;;AAInE,UADc,MAAM,IAAI,MAAM,EAClB;;CAGd,MAAM,mBAAgD;AACpD,SAAO,KAAK,QAA4B,uBAAuB;;CAGjE,MAAM,qBAAqB,eAAyD;AAClF,SAAO,KAAK,QACV,wBAAwB,mBAAmB,cAAc,CAAC,SAC3D;;CAGH,MAAM,wBACJ,eACA,QACe;AACf,QAAM,KAAK,QACT,wBAAwB,mBAAmB,cAAc,IACzD;GACE,QAAQ;GACR,MAAM,KAAK,UAAU,EAAE,QAAQ,CAAC;GACjC,CACF;;CAGH,MAAM,mBACJ,eACA,SAC2B;AAC3B,SAAO,KAAK,QAA0B,wBAAwB;GAC5D,QAAQ;GACR,MAAM,KAAK,UAAU;IACnB;IACA,SAAS,SAAS;IAClB,QAAQ,SAAS;IAClB,CAAC;GACH,CAAC;;CAGJ,MAAM,kBAAkB,eAAkD;AACxE,SAAO,KAAK,QACV,wBAAwB,mBAAmB,cAAc,IACzD,EAAE,QAAQ,UAAU,CACrB;;CAGH,MAAM,cAA0D;AAC9D,SAAO,KAAK,QAA2C,yBAAyB"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@alfe.ai/agent-api-client",
+  "version": "0.0.2",
+  "description": "Agent self-service API client — agents calling /agents/ endpoints",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@alfe/types": "0.1.0"
+  },
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}