scorecard-ai 1.0.0-alpha.8 → 1.0.0

package/resources/systems/systems.d.mts

@@ -0,0 +1,229 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as VersionsAPI from "./versions.mjs";
+import { SystemVersion, SystemVersionsPaginatedResponse, VersionCreateParams, VersionListParams, Versions } from "./versions.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { PagePromise, PaginatedResponse, type PaginatedResponseParams } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Systems extends APIResource {
+    versions: VersionsAPI.Versions;
+    /**
+     * Create a new system definition that specifies the interface contracts for a
+     * component you want to evaluate.
+     *
+     * A system acts as a template that defines three key contracts through JSON
+     * Schemas:
+     *
+     * 1. Input Schema: What data your system accepts (e.g., user queries, context
+     *    documents)
+     * 2. Output Schema: What data your system produces (e.g., responses, confidence
+     *    scores)
+     * 3. Config Schema: What parameters can be adjusted (e.g., model selection,
+     *    temperature)
+     *
+     * This separation lets you evaluate any system as a black box, focusing on its
+     * interface rather than implementation details.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.create('314', {
+     *   configSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       temperature: { type: 'number' },
+     *       maxTokens: { type: 'integer' },
+     *       model: { type: 'string', enum: ['gpt-4', 'gpt-4-turbo'] },
+     *     },
+     *     required: ['model'],
+     *   },
+     *   description: 'Production chatbot powered by GPT-4',
+     *   inputSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       messages: {
+     *         type: 'array',
+     *         items: {
+     *           type: 'object',
+     *           properties: {
+     *             role: { type: 'string', enum: ['system', 'user', 'assistant'] },
+     *             content: { type: 'string' },
+     *           },
+     *           required: ['role', 'content'],
+     *         },
+     *       },
+     *     },
+     *     required: ['messages'],
+     *   },
+     *   name: 'GPT-4 Chatbot',
+     *   outputSchema: {
+     *     type: 'object',
+     *     properties: { response: { type: 'string' } },
+     *     required: ['response'],
+     *   },
+     * });
+     * ```
+     */
+    create(projectID: string, body: SystemCreateParams, options?: RequestOptions): APIPromise<System>;
+    /**
+     * Update an existing system definition. Only the fields provided in the request
+     * body will be updated. If a field is provided, the new content will replace the
+     * existing content. If a field is not provided, the existing content will remain
+     * unchanged.
+     *
+     * When updating schemas:
+     *
+     * - The system will accept your changes regardless of compatibility with existing
+     *   configurations
+     * - Schema updates won't invalidate existing evaluations or configurations
+     * - For significant redesigns, creating a new system definition provides a cleaner
+     *   separation
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.update(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     *   {
+     *     description:
+     *       'Updated production chatbot powered by GPT-4 Turbo',
+     *     name: 'GPT-4 Turbo Chatbot',
+     *   },
+     * );
+     * ```
+     */
+    update(systemID: string, body?: SystemUpdateParams | null | undefined, options?: RequestOptions): APIPromise<System>;
+    /**
+     * Retrieve a paginated list of all systems. Systems are ordered by creation date.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const system of client.systems.list('314')) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(projectID: string, query?: SystemListParams | null | undefined, options?: RequestOptions): PagePromise<SystemsPaginatedResponse, System>;
+    /**
+     * Delete a system definition by ID. This will not delete associated system
+     * versions.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.delete(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     * );
+     * ```
+     */
+    delete(systemID: string, options?: RequestOptions): APIPromise<SystemDeleteResponse>;
+    /**
+     * Retrieve a specific system by ID.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.get(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     * );
+     * ```
+     */
+    get(systemID: string, options?: RequestOptions): APIPromise<System>;
+}
+export type SystemsPaginatedResponse = PaginatedResponse<System>;
+/**
+ * A System Under Test (SUT) defines the interface to a component or service you
+ * want to evaluate.
+ *
+ * It specifies three contracts through schemas:
+ *
+ * - inputSchema: The structure of data the system accepts.
+ * - outputSchema: The structure of data the system produces.
+ * - configSchema: The parameters that modify system behavior.
+ *
+ * This abstraction lets you evaluate any system as a black box, focusing on its
+ * interface rather than implementation details. It's particularly useful for
+ * systems with variable outputs or complex internal state.
+ *
+ * Systems are templates - to run evaluations, pair them with a SystemVersion that
+ * provides specific parameter values.
+ */
+export interface System {
+    /**
+     * The ID of the system.
+     */
+    id: string;
+    /**
+     * The schema of the system's configuration.
+     */
+    configSchema: Record<string, unknown>;
+    /**
+     * The description of the system.
+     */
+    description: string;
+    /**
+     * The schema of the system's inputs.
+     */
+    inputSchema: Record<string, unknown>;
+    /**
+     * The name of the system.
+     */
+    name: string;
+    /**
+     * The schema of the system's outputs.
+     */
+    outputSchema: Record<string, unknown>;
+}
+export interface SystemDeleteResponse {
+    /**
+     * Whether the deletion was successful.
+     */
+    success: boolean;
+}
+export interface SystemCreateParams {
+    /**
+     * The schema of the system's configuration.
+     */
+    configSchema: Record<string, unknown>;
+    /**
+     * The description of the system.
+     */
+    description: string;
+    /**
+     * The schema of the system's inputs.
+     */
+    inputSchema: Record<string, unknown>;
+    /**
+     * The name of the system.
+     */
+    name: string;
+    /**
+     * The schema of the system's outputs.
+     */
+    outputSchema: Record<string, unknown>;
+}
+export interface SystemUpdateParams {
+    /**
+     * The schema of the system's configuration.
+     */
+    configSchema?: Record<string, unknown>;
+    /**
+     * The description of the system.
+     */
+    description?: string;
+    /**
+     * The schema of the system's inputs.
+     */
+    inputSchema?: Record<string, unknown>;
+    /**
+     * The name of the system.
+     */
+    name?: string;
+    /**
+     * The schema of the system's outputs.
+     */
+    outputSchema?: Record<string, unknown>;
+}
+export interface SystemListParams extends PaginatedResponseParams {
+}
+export declare namespace Systems {
+    export { type System as System, type SystemDeleteResponse as SystemDeleteResponse, type SystemsPaginatedResponse as SystemsPaginatedResponse, type SystemCreateParams as SystemCreateParams, type SystemUpdateParams as SystemUpdateParams, type SystemListParams as SystemListParams, };
+    export { Versions as Versions, type SystemVersion as SystemVersion, type SystemVersionsPaginatedResponse as SystemVersionsPaginatedResponse, type VersionCreateParams as VersionCreateParams, type VersionListParams as VersionListParams, };
+}
+//# sourceMappingURL=systems.d.mts.map

package/resources/systems/systems.d.mts.map

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

package/resources/systems/systems.d.ts

@@ -0,0 +1,229 @@
+import { APIResource } from "../../core/resource.js";
+import * as VersionsAPI from "./versions.js";
+import { SystemVersion, SystemVersionsPaginatedResponse, VersionCreateParams, VersionListParams, Versions } from "./versions.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { PagePromise, PaginatedResponse, type PaginatedResponseParams } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Systems extends APIResource {
+    versions: VersionsAPI.Versions;
+    /**
+     * Create a new system definition that specifies the interface contracts for a
+     * component you want to evaluate.
+     *
+     * A system acts as a template that defines three key contracts through JSON
+     * Schemas:
+     *
+     * 1. Input Schema: What data your system accepts (e.g., user queries, context
+     *    documents)
+     * 2. Output Schema: What data your system produces (e.g., responses, confidence
+     *    scores)
+     * 3. Config Schema: What parameters can be adjusted (e.g., model selection,
+     *    temperature)
+     *
+     * This separation lets you evaluate any system as a black box, focusing on its
+     * interface rather than implementation details.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.create('314', {
+     *   configSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       temperature: { type: 'number' },
+     *       maxTokens: { type: 'integer' },
+     *       model: { type: 'string', enum: ['gpt-4', 'gpt-4-turbo'] },
+     *     },
+     *     required: ['model'],
+     *   },
+     *   description: 'Production chatbot powered by GPT-4',
+     *   inputSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       messages: {
+     *         type: 'array',
+     *         items: {
+     *           type: 'object',
+     *           properties: {
+     *             role: { type: 'string', enum: ['system', 'user', 'assistant'] },
+     *             content: { type: 'string' },
+     *           },
+     *           required: ['role', 'content'],
+     *         },
+     *       },
+     *     },
+     *     required: ['messages'],
+     *   },
+     *   name: 'GPT-4 Chatbot',
+     *   outputSchema: {
+     *     type: 'object',
+     *     properties: { response: { type: 'string' } },
+     *     required: ['response'],
+     *   },
+     * });
+     * ```
+     */
+    create(projectID: string, body: SystemCreateParams, options?: RequestOptions): APIPromise<System>;
+    /**
+     * Update an existing system definition. Only the fields provided in the request
+     * body will be updated. If a field is provided, the new content will replace the
+     * existing content. If a field is not provided, the existing content will remain
+     * unchanged.
+     *
+     * When updating schemas:
+     *
+     * - The system will accept your changes regardless of compatibility with existing
+     *   configurations
+     * - Schema updates won't invalidate existing evaluations or configurations
+     * - For significant redesigns, creating a new system definition provides a cleaner
+     *   separation
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.update(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     *   {
+     *     description:
+     *       'Updated production chatbot powered by GPT-4 Turbo',
+     *     name: 'GPT-4 Turbo Chatbot',
+     *   },
+     * );
+     * ```
+     */
+    update(systemID: string, body?: SystemUpdateParams | null | undefined, options?: RequestOptions): APIPromise<System>;
+    /**
+     * Retrieve a paginated list of all systems. Systems are ordered by creation date.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const system of client.systems.list('314')) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(projectID: string, query?: SystemListParams | null | undefined, options?: RequestOptions): PagePromise<SystemsPaginatedResponse, System>;
+    /**
+     * Delete a system definition by ID. This will not delete associated system
+     * versions.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.delete(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     * );
+     * ```
+     */
+    delete(systemID: string, options?: RequestOptions): APIPromise<SystemDeleteResponse>;
+    /**
+     * Retrieve a specific system by ID.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.get(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     * );
+     * ```
+     */
+    get(systemID: string, options?: RequestOptions): APIPromise<System>;
+}
+export type SystemsPaginatedResponse = PaginatedResponse<System>;
+/**
+ * A System Under Test (SUT) defines the interface to a component or service you
+ * want to evaluate.
+ *
+ * It specifies three contracts through schemas:
+ *
+ * - inputSchema: The structure of data the system accepts.
+ * - outputSchema: The structure of data the system produces.
+ * - configSchema: The parameters that modify system behavior.
+ *
+ * This abstraction lets you evaluate any system as a black box, focusing on its
+ * interface rather than implementation details. It's particularly useful for
+ * systems with variable outputs or complex internal state.
+ *
+ * Systems are templates - to run evaluations, pair them with a SystemVersion that
+ * provides specific parameter values.
+ */
+export interface System {
+    /**
+     * The ID of the system.
+     */
+    id: string;
+    /**
+     * The schema of the system's configuration.
+     */
+    configSchema: Record<string, unknown>;
+    /**
+     * The description of the system.
+     */
+    description: string;
+    /**
+     * The schema of the system's inputs.
+     */
+    inputSchema: Record<string, unknown>;
+    /**
+     * The name of the system.
+     */
+    name: string;
+    /**
+     * The schema of the system's outputs.
+     */
+    outputSchema: Record<string, unknown>;
+}
+export interface SystemDeleteResponse {
+    /**
+     * Whether the deletion was successful.
+     */
+    success: boolean;
+}
+export interface SystemCreateParams {
+    /**
+     * The schema of the system's configuration.
+     */
+    configSchema: Record<string, unknown>;
+    /**
+     * The description of the system.
+     */
+    description: string;
+    /**
+     * The schema of the system's inputs.
+     */
+    inputSchema: Record<string, unknown>;
+    /**
+     * The name of the system.
+     */
+    name: string;
+    /**
+     * The schema of the system's outputs.
+     */
+    outputSchema: Record<string, unknown>;
+}
+export interface SystemUpdateParams {
+    /**
+     * The schema of the system's configuration.
+     */
+    configSchema?: Record<string, unknown>;
+    /**
+     * The description of the system.
+     */
+    description?: string;
+    /**
+     * The schema of the system's inputs.
+     */
+    inputSchema?: Record<string, unknown>;
+    /**
+     * The name of the system.
+     */
+    name?: string;
+    /**
+     * The schema of the system's outputs.
+     */
+    outputSchema?: Record<string, unknown>;
+}
+export interface SystemListParams extends PaginatedResponseParams {
+}
+export declare namespace Systems {
+    export { type System as System, type SystemDeleteResponse as SystemDeleteResponse, type SystemsPaginatedResponse as SystemsPaginatedResponse, type SystemCreateParams as SystemCreateParams, type SystemUpdateParams as SystemUpdateParams, type SystemListParams as SystemListParams, };
+    export { Versions as Versions, type SystemVersion as SystemVersion, type SystemVersionsPaginatedResponse as SystemVersionsPaginatedResponse, type VersionCreateParams as VersionCreateParams, type VersionListParams as VersionListParams, };
+}
+//# sourceMappingURL=systems.d.ts.map

package/resources/systems/systems.d.ts.map

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

package/resources/systems/systems.js

@@ -0,0 +1,151 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Systems = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const VersionsAPI = tslib_1.__importStar(require("./versions.js"));
+const versions_1 = require("./versions.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
+class Systems extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.versions = new VersionsAPI.Versions(this._client);
+    }
+    /**
+     * Create a new system definition that specifies the interface contracts for a
+     * component you want to evaluate.
+     *
+     * A system acts as a template that defines three key contracts through JSON
+     * Schemas:
+     *
+     * 1. Input Schema: What data your system accepts (e.g., user queries, context
+     *    documents)
+     * 2. Output Schema: What data your system produces (e.g., responses, confidence
+     *    scores)
+     * 3. Config Schema: What parameters can be adjusted (e.g., model selection,
+     *    temperature)
+     *
+     * This separation lets you evaluate any system as a black box, focusing on its
+     * interface rather than implementation details.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.create('314', {
+     *   configSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       temperature: { type: 'number' },
+     *       maxTokens: { type: 'integer' },
+     *       model: { type: 'string', enum: ['gpt-4', 'gpt-4-turbo'] },
+     *     },
+     *     required: ['model'],
+     *   },
+     *   description: 'Production chatbot powered by GPT-4',
+     *   inputSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       messages: {
+     *         type: 'array',
+     *         items: {
+     *           type: 'object',
+     *           properties: {
+     *             role: { type: 'string', enum: ['system', 'user', 'assistant'] },
+     *             content: { type: 'string' },
+     *           },
+     *           required: ['role', 'content'],
+     *         },
+     *       },
+     *     },
+     *     required: ['messages'],
+     *   },
+     *   name: 'GPT-4 Chatbot',
+     *   outputSchema: {
+     *     type: 'object',
+     *     properties: { response: { type: 'string' } },
+     *     required: ['response'],
+     *   },
+     * });
+     * ```
+     */
+    create(projectID, body, options) {
+        return this._client.post((0, path_1.path) `/projects/${projectID}/systems`, { body, ...options });
+    }
+    /**
+     * Update an existing system definition. Only the fields provided in the request
+     * body will be updated. If a field is provided, the new content will replace the
+     * existing content. If a field is not provided, the existing content will remain
+     * unchanged.
+     *
+     * When updating schemas:
+     *
+     * - The system will accept your changes regardless of compatibility with existing
+     *   configurations
+     * - Schema updates won't invalidate existing evaluations or configurations
+     * - For significant redesigns, creating a new system definition provides a cleaner
+     *   separation
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.update(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     *   {
+     *     description:
+     *       'Updated production chatbot powered by GPT-4 Turbo',
+     *     name: 'GPT-4 Turbo Chatbot',
+     *   },
+     * );
+     * ```
+     */
+    update(systemID, body = {}, options) {
+        return this._client.patch((0, path_1.path) `/systems/${systemID}`, { body, ...options });
+    }
+    /**
+     * Retrieve a paginated list of all systems. Systems are ordered by creation date.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const system of client.systems.list('314')) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(projectID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/projects/${projectID}/systems`, (pagination_1.PaginatedResponse), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Delete a system definition by ID. This will not delete associated system
+     * versions.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.delete(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     * );
+     * ```
+     */
+    delete(systemID, options) {
+        return this._client.delete((0, path_1.path) `/systems/${systemID}`, options);
+    }
+    /**
+     * Retrieve a specific system by ID.
+     *
+     * @example
+     * ```ts
+     * const system = await client.systems.get(
+     *   '12345678-0a8b-4f66-b6f3-2ddcfa097257',
+     * );
+     * ```
+     */
+    get(systemID, options) {
+        return this._client.get((0, path_1.path) `/systems/${systemID}`, options);
+    }
+}
+exports.Systems = Systems;
+Systems.Versions = versions_1.Versions;
+//# sourceMappingURL=systems.js.map

package/resources/systems/systems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systems.js","sourceRoot":"","sources":["../../src/resources/systems/systems.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,mEAA0C;AAC1C,4CAMoB;AAEpB,yDAAqG;AAErG,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkJ1E,CAAC;IAhJC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAwB,EAAE,OAAwB;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CACJ,QAAgB,EAChB,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,YAAY,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,SAAiB,EACjB,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAA,WAAI,EAAA,aAAa,SAAS,UAAU,EAAE,CAAA,8BAAyB,CAAA,EAAE;YAC9F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAgB,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,YAAY,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;OASG;IACH,GAAG,CAAC,QAAgB,EAAE,OAAwB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,YAAY,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;CACF;AAnJD,0BAmJC;AAoHD,OAAO,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}