@inkeep/agents-sdk 0.41.2 → 0.43.0

package/dist/credential-ref.d.ts

@@ -1,60 +1,60 @@
 //#region src/credential-ref.d.ts
 /**
- * Credential Reference System
- *
- * This module provides a way to reference credentials by ID without including
- * the full credential definition in the code. Credentials are resolved from
- * environment files at runtime during the push operation.
- */
-/**
- * Represents a reference to a credential by its ID.
- * The actual credential will be resolved from the environment file at push time.
- */
+* Credential Reference System
+*
+* This module provides a way to reference credentials by ID without including
+* the full credential definition in the code. Credentials are resolved from
+* environment files at runtime during the push operation.
+*/
+/**
+* Represents a reference to a credential by its ID.
+* The actual credential will be resolved from the environment file at push time.
+*/
 interface CredentialReference {
-  __type: 'credential-ref';
+  __type: "credential-ref";
   id: string;
 }
 /**
- * Create a reference to a credential by its ID.
- * The credential must be defined in the environment files.
- *
- * @param id - The ID of the credential to reference
- * @returns A credential reference that will be resolved at push time
- *
- * @example
- * ```typescript
- * const apiKeyRef = credentialRef('api-key');
- *
- * const fetchDef = fetchDefinition({
- *   credential: apiKeyRef,
- *   // ...
- * });
- * ```
- */
+* Create a reference to a credential by its ID.
+* The credential must be defined in the environment files.
+*
+* @param id - The ID of the credential to reference
+* @returns A credential reference that will be resolved at push time
+*
+* @example
+* ```typescript
+* const apiKeyRef = credentialRef('api-key');
+*
+* const fetchDef = fetchDefinition({
+*   credential: apiKeyRef,
+*   // ...
+* });
+* ```
+*/
 declare function credentialRef<T extends string = string>(id: T): CredentialReference;
 /**
- * Type guard to check if a value is a credential reference
- */
+* Type guard to check if a value is a credential reference
+*/
 declare function isCredentialReference(value: any): value is CredentialReference;
 /**
- * Type helper to extract credential IDs from environment configuration
- */
+* Type helper to extract credential IDs from environment configuration
+*/
 type ExtractCredentialIds<T> = T extends {
   credentials?: infer C;
 } ? C extends Record<string, any> ? keyof C : never : never;
 /**
- * Type helper to create a union of all available credential IDs from multiple environments
- */
+* Type helper to create a union of all available credential IDs from multiple environments
+*/
 type UnionCredentialIds<T extends Record<string, any>> = { [K in keyof T]: ExtractCredentialIds<T[K]> }[keyof T];
 /**
- * Type helper to extract tool IDs from environment configuration
- */
+* Type helper to extract tool IDs from environment configuration
+*/
 type ExtractMcpServerIds<T> = T extends {
   mcpServers?: infer T;
 } ? T extends Record<string, any> ? keyof T : never : never;
 /**
- * Type helper to create a union of all available tool IDs from multiple environments
- */
+* Type helper to create a union of all available tool IDs from multiple environments
+*/
 type UnionMcpServerIds<T extends Record<string, any>> = { [K in keyof T]: ExtractMcpServerIds<T[K]> }[keyof T];
 //#endregion
 export { CredentialReference, ExtractCredentialIds, ExtractMcpServerIds, UnionCredentialIds, UnionMcpServerIds, credentialRef, isCredentialReference };

package/dist/data-component.d.ts

@@ -2,7 +2,7 @@ import { DataComponentInsert } from "@inkeep/agents-core";
 import { z } from "zod";
 
 //#region src/data-component.d.ts
-type DataComponentConfigWithZod = Omit<DataComponentInsert, 'tenantId' | 'projectId' | 'props' | 'render'> & {
+type DataComponentConfigWithZod = Omit<DataComponentInsert, "tenantId" | "projectId" | "props" | "render"> & {
   props?: Record<string, unknown> | z.ZodObject<any> | null;
   render?: {
     component: string;
@@ -10,16 +10,16 @@ type DataComponentConfigWithZod = Omit<DataComponentInsert, 'tenantId' | 'projec
   } | null;
 };
 interface DataComponentInterface {
-  config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
+  config: Omit<DataComponentInsert, "tenantId" | "projectId">;
   init(): Promise<void>;
-  getId(): DataComponentInsert['id'];
-  getName(): DataComponentInsert['name'];
-  getDescription(): DataComponentInsert['description'];
-  getProps(): DataComponentInsert['props'];
+  getId(): DataComponentInsert["id"];
+  getName(): DataComponentInsert["name"];
+  getDescription(): DataComponentInsert["description"];
+  getProps(): DataComponentInsert["props"];
   setContext(tenantId: string, projectId: string, baseURL?: string): void;
 }
 declare class DataComponent implements DataComponentInterface {
-  config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
+  config: Omit<DataComponentInsert, "tenantId" | "projectId">;
   private baseURL;
   private tenantId;
   private projectId;
@@ -30,8 +30,8 @@ declare class DataComponent implements DataComponentInterface {
   getId(): string;
   getName(): string;
   getDescription(): string;
-  getProps(): DataComponentInsert['props'];
-  getRender(): DataComponentInsert['render'];
+  getProps(): DataComponentInsert["props"];
+  getRender(): DataComponentInsert["render"];
   init(): Promise<void>;
   private upsertDataComponent;
 }

package/dist/data-component.js

@@ -73,7 +73,7 @@ var DataComponent = class {
 			render: this.config.render
 		};
 		logger.info({ dataComponentData }, "dataComponentData for create/update");
-		const updateResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/data-components/${this.getId()}`, {
+		const updateResponse = await fetch(`${this.baseURL}/manage/tenants/${this.tenantId}/projects/${this.projectId}/data-components/${this.getId()}`, {
 			method: "PUT",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(dataComponentData)
@@ -88,7 +88,7 @@ var DataComponent = class {
 		}
 		if (updateResponse.status === 404) {
 			logger.info({ dataComponentId: this.getId() }, "DataComponent not found, creating new data component");
-			const createResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/data-components`, {
+			const createResponse = await fetch(`${this.baseURL}/manage/tenants/${this.tenantId}/projects/${this.projectId}/data-components`, {
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
 				body: JSON.stringify(dataComponentData)

package/dist/environment-settings.d.ts

@@ -12,16 +12,16 @@ interface EnvironmentSettingsConfig {
   };
 }
 /**
- * Create a setting helper with TypeScript autocomplete
- */
+* Create a setting helper with TypeScript autocomplete
+*/
 declare function createEnvironmentSettings<T extends Record<string, EnvironmentSettingsConfig>>(environments: T): {
   getEnvironmentCredential: (key: UnionCredentialIds<T>) => CredentialReferenceApiInsert;
   getEnvironmentMcp: (key: UnionMcpServerIds<T>) => Tool;
   getEnvironmentSetting: (key: UnionCredentialIds<T>) => CredentialReferenceApiInsert;
 };
 /**
- * Create type-safe environment configurations
- */
+* Create type-safe environment configurations
+*/
 declare function registerEnvironmentSettings<T extends EnvironmentSettingsConfig>(config: T): T;
 //#endregion
 export { type ExtractCredentialIds, type ExtractMcpServerIds, type UnionCredentialIds, type UnionMcpServerIds, createEnvironmentSettings, registerEnvironmentSettings };

package/dist/evaluationClient.d.ts

@@ -0,0 +1,78 @@
+//#region src/evaluationClient.d.ts
+interface EvaluationClientConfig {
+  tenantId: string;
+  projectId: string;
+  apiUrl: string;
+  apiKey?: string;
+}
+declare class EvaluationClient {
+  private tenantId;
+  private projectId;
+  private apiUrl;
+  private apiKey?;
+  constructor(config: EvaluationClientConfig);
+  private buildUrl;
+  private buildHeaders;
+  listDatasets(): Promise<unknown[]>;
+  getDataset(datasetId: string): Promise<unknown | null>;
+  createDataset(datasetData: Record<string, unknown>): Promise<unknown>;
+  updateDataset(datasetId: string, updateData: Record<string, unknown>): Promise<unknown>;
+  deleteDataset(datasetId: string): Promise<void>;
+  listDatasetItems(datasetId: string): Promise<unknown[]>;
+  getDatasetItem(datasetId: string, itemId: string): Promise<unknown | null>;
+  createDatasetItem(datasetId: string, itemData: Record<string, unknown>): Promise<unknown>;
+  createDatasetItems(datasetId: string, itemsData: Record<string, unknown>[]): Promise<unknown[]>;
+  updateDatasetItem(datasetId: string, itemId: string, updateData: Record<string, unknown>): Promise<unknown>;
+  deleteDatasetItem(datasetId: string, itemId: string): Promise<void>;
+  listEvaluators(): Promise<unknown[]>;
+  getEvaluator(evaluatorId: string): Promise<unknown | null>;
+  createEvaluator(evaluatorData: Record<string, unknown>): Promise<unknown>;
+  updateEvaluator(evaluatorId: string, updateData: Record<string, unknown>): Promise<unknown>;
+  deleteEvaluator(evaluatorId: string): Promise<void>;
+  listEvaluationSuiteConfigs(): Promise<unknown[]>;
+  getEvaluationSuiteConfig(configId: string): Promise<unknown | null>;
+  createEvaluationSuiteConfig(configData: Record<string, unknown>): Promise<unknown>;
+  updateEvaluationSuiteConfig(configId: string, updateData: Record<string, unknown>): Promise<unknown>;
+  deleteEvaluationSuiteConfig(configId: string): Promise<void>;
+  listEvaluationSuiteConfigEvaluators(configId: string): Promise<unknown[]>;
+  addEvaluatorToSuiteConfig(configId: string, evaluatorId: string): Promise<unknown>;
+  removeEvaluatorFromSuiteConfig(configId: string, evaluatorId: string): Promise<void>;
+  getEvaluationResult(resultId: string): Promise<unknown | null>;
+  createEvaluationResult(resultData: Record<string, unknown>): Promise<unknown>;
+  updateEvaluationResult(resultId: string, updateData: Record<string, unknown>): Promise<unknown>;
+  deleteEvaluationResult(resultId: string): Promise<void>;
+  /**
+  * Trigger batch evaluation of conversations with selected evaluators.
+  * Supports filtering by conversation IDs, date range, or dataset run IDs.
+  */
+  triggerBatchEvaluation(evaluationData: {
+    evaluatorIds: string[];
+    name?: string;
+    conversationIds?: string[];
+    dateRange?: {
+      startDate: string;
+      endDate: string;
+    };
+    datasetRunIds?: string[];
+  }): Promise<{
+    message: string;
+    evaluationJobConfigId: string;
+    evaluatorIds: string[];
+  }>;
+  listDatasetRuns(datasetId: string): Promise<unknown[]>;
+  getDatasetRun(runId: string): Promise<unknown | null>;
+  triggerDatasetRun(datasetId: string, runData: {
+    agentIds: string[];
+    evaluatorIds?: string[];
+  }): Promise<{
+    message: string;
+    datasetRunId: string;
+    datasetId: string;
+  }>;
+}
+/**
+* Helper function to create an EvaluationClient instance
+*/
+declare function evaluationClient(config: EvaluationClientConfig): EvaluationClient;
+//#endregion
+export { EvaluationClient, EvaluationClientConfig, evaluationClient };