@respan/respan-sdk 1.0.0

package/dist/types/clientTypes.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Options for initializing the Respan SDK.
+ */
+export interface RespanOptions {
+    /**
+     * The app name to be used when reporting traces.
+     */
+    appName?: string;
+    /**
+     * Sends traces and spans without batching, for local development.
+     * Defaults to false.
+     */
+    disableBatch?: boolean;
+    /**
+     * The API endpoint for sending data.
+     */
+    baseUrl?: string;
+    /**
+     * The API Key for authentication.
+     */
+    apiKey: string;
+    /**
+     * Explicitly specify modules to instrument.
+     */
+    instrumentModules?: {
+        openAI?: any;
+        anthropic?: any;
+        azureOpenAI?: any;
+        cohere?: any;
+        bedrock?: any;
+        google_vertexai?: any;
+        google_aiplatform?: any;
+        pinecone?: any;
+        langchain?: {
+            chainsModule?: any;
+            agentsModule?: any;
+            toolsModule?: any;
+            runnablesModule?: any;
+            vectorStoreModule?: any;
+        };
+        llamaIndex?: any;
+        chromadb?: any;
+        qdrant?: any;
+    };
+}
+/**
+ * The main client options for Respan.
+ */
+export interface RespanClientOptions {
+    apiKey: string;
+    appName: string;
+    baseUrl?: string;
+}
+/**
+ * Base class for all Respan errors.
+ */
+export declare class RespanError extends Error {
+    constructor(message: string);
+}
+export declare class InitializationError extends RespanError {
+    constructor(message?: string);
+}
+export declare class NotInitializedError extends RespanError {
+    constructor();
+}

package/dist/types/clientTypes.js

@@ -0,0 +1,22 @@
+/**
+ * Base class for all Respan errors.
+ */
+export class RespanError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RespanError';
+    }
+}
+export class InitializationError extends RespanError {
+    constructor(message) {
+        super(message || 'Failed to initialize Respan');
+        this.name = 'InitializationError';
+    }
+}
+export class NotInitializedError extends RespanError {
+    constructor() {
+        super('Respan has not been initialized');
+        this.name = 'NotInitializedError';
+    }
+}
+//# sourceMappingURL=clientTypes.js.map

package/dist/types/clientTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientTypes.js","sourceRoot":"","sources":["../../src/types/clientTypes.ts"],"names":[],"mappings":"AA8DA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAChD,YAAY,OAAgB;QACxB,KAAK,CAAC,OAAO,IAAI,6BAA6B,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAChD;QACI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ"}

package/dist/types/datasetTypes.d.ts

@@ -0,0 +1,65 @@
+import { DatasetType, DatasetStatus, DatasetLLMRunStatus } from "../constants/datasetConstants.js";
+export type FilterParamDict = Record<string, any>;
+export interface Dataset {
+    id: string;
+    name: string;
+    type?: DatasetType;
+    description?: string;
+    created_at: string;
+    running_progress?: number;
+    running_status?: DatasetLLMRunStatus;
+    running_at?: string;
+    updated_at: string;
+    updated_by?: Record<string, any> | number | string;
+    organization: Record<string, any> | number | string;
+    initial_log_filters?: FilterParamDict;
+    log_ids?: string[];
+    unique_organization_ids?: string[];
+    timestamps?: string[];
+    log_count?: number;
+    evaluator?: string;
+    status?: DatasetStatus;
+    completed_annotation_count?: number;
+}
+export interface DatasetCreate {
+    name: string;
+    description?: string;
+    type?: DatasetType;
+    sampling?: number;
+    start_time?: string;
+    end_time?: string;
+    initial_log_filters?: FilterParamDict;
+}
+export interface DatasetUpdate {
+    name?: string;
+    description?: string;
+}
+export interface DatasetList {
+    results: Dataset[];
+    count?: number;
+    next?: string;
+    previous?: string;
+}
+export interface LogManagementRequest {
+    start_time?: string;
+    end_time?: string;
+    filters: FilterParamDict;
+}
+export interface EvalRunRequest {
+    evaluator_slugs: string[];
+}
+export interface EvalReport {
+    id: string;
+    dataset_id: string;
+    evaluator_slugs: string[];
+    status: string;
+    created_at: string;
+    updated_at: string;
+    results?: Record<string, any>;
+}
+export interface EvalReportList {
+    results: EvalReport[];
+    count?: number;
+    next?: string;
+    previous?: string;
+}

package/dist/types/datasetTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=datasetTypes.js.map

package/dist/types/datasetTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasetTypes.js","sourceRoot":"","sources":["../../src/types/datasetTypes.ts"],"names":[],"mappings":""}

package/dist/types/decoratorTypes.d.ts

@@ -0,0 +1,3 @@
+export interface DecoratorOptions {
+}
+export type DecoratorFunction = (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => any;

package/dist/types/decoratorTypes.js

@@ -0,0 +1,4 @@
+// Decorator types for Respan SDK
+// This file contains type definitions for decorators used in the SDK
+export {};
+//# sourceMappingURL=decoratorTypes.js.map

package/dist/types/decoratorTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoratorTypes.js","sourceRoot":"","sources":["../../src/types/decoratorTypes.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,qEAAqE"}

package/dist/types/evaluatorTypes.d.ts

@@ -0,0 +1,10 @@
+import { PaginatedResponseType } from "./genericTypes.js";
+export interface Evaluator {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+}
+export type EvaluatorList = PaginatedResponseType<Evaluator>;

package/dist/types/evaluatorTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=evaluatorTypes.js.map

package/dist/types/evaluatorTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluatorTypes.js","sourceRoot":"","sources":["../../src/types/evaluatorTypes.ts"],"names":[],"mappings":""}

package/dist/types/experimentTypes.d.ts

@@ -0,0 +1,158 @@
+import { Message } from "./promptTypes.js";
+import { ToolChoiceType } from "../constants/promptConstants.js";
+export type StatusTypes = "ready" | "running" | "error" | "stopped" | "completed";
+export interface FunctionTool {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, any>;
+    };
+}
+export type ToolChoice = ToolChoiceType | {
+    type: "function";
+    function: {
+        name: string;
+    };
+};
+export declare const UTC_EPOCH = "1970-01-01T00:00:00Z";
+export interface ExperimentColumnType {
+    id?: string;
+    model: string;
+    name: string;
+    temperature: number;
+    max_completion_tokens: number;
+    top_p: number;
+    frequency_penalty: number;
+    presence_penalty: number;
+    tools?: FunctionTool[];
+    prompt_messages?: Message[];
+    reasoning_effort?: string;
+    stream?: boolean;
+    tool_choice?: string | ToolChoice;
+    response_format?: string | Record<string, any>;
+}
+export interface ExperimentLLMInferenceMetrics {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    prompt_tokens_details?: Record<string, any>;
+    completion_tokens_details?: Record<string, any>;
+    latency?: number;
+}
+export interface ExperimentResultItemType {
+    id?: string;
+    column_id?: string;
+    output?: Record<string, any>;
+    error?: string;
+    ran_at?: string;
+    status?: StatusTypes;
+    evaluation_result?: Record<string, any>;
+    llm_inference_metrics?: ExperimentLLMInferenceMetrics;
+}
+export interface ExperimentRowType {
+    id?: string;
+    input?: Record<string, any>;
+    status?: StatusTypes;
+    results?: (ExperimentResultItemType | null)[];
+    ideal_output?: string;
+}
+export interface ExperimentRowV2Type {
+    id?: string;
+    inputs?: Record<string, any>;
+    items?: Record<string, ExperimentResultItemType>;
+    ideal_output?: string;
+}
+export interface ExperimentType {
+    id?: string;
+    column_count?: number;
+    columns?: ExperimentColumnType[];
+    created_at?: string;
+    created_by?: Record<string, any> | number | string;
+    name: string;
+    organization?: Record<string, any> | number | string;
+    row_count?: number;
+    rows?: ExperimentRowType[];
+    status?: string;
+    test_id?: string;
+    updated_at?: string;
+    updated_by?: Record<string, any> | number | string;
+    variables?: string[];
+    variable_definitions?: Record<string, any>[];
+    starred?: boolean;
+    tags?: (Record<string, any> | number | string)[];
+    description?: string;
+}
+export interface CreateExperimentRequest {
+    columns: ExperimentColumnType[];
+    rows?: ExperimentRowType[];
+    name: string;
+    description?: string;
+}
+export interface ListExperimentsResponse {
+    experiments: ExperimentType[];
+    total?: number;
+    page?: number;
+    page_size?: number;
+}
+export interface AddExperimentRowsRequest {
+    rows: ExperimentRowType[];
+}
+export interface RemoveExperimentRowsRequest {
+    rows: string[];
+}
+export interface UpdateExperimentRowsRequest {
+    rows: ExperimentRowType[];
+}
+export interface AddExperimentColumnsRequest {
+    columns: ExperimentColumnType[];
+}
+export interface RemoveExperimentColumnsRequest {
+    columns: string[];
+}
+export interface UpdateExperimentColumnsRequest {
+    columns: ExperimentColumnType[];
+}
+export interface RunExperimentRequest {
+    columns?: ExperimentColumnType[];
+}
+export interface RunExperimentEvalsRequest {
+    evaluator_slugs: string[];
+}
+export interface Columns {
+    columns: ExperimentColumnType[];
+}
+export interface Rows {
+    rows: ExperimentRowType[];
+}
+export interface EditorType {
+    id: number;
+    name: string;
+}
+export interface TestCaseType {
+    description?: string;
+    name?: string;
+    headers?: string[];
+    rows?: Record<string, string | number | null>[];
+}
+export interface TestsetColumnDefinition {
+    field: string;
+    width?: number;
+    mapped_name?: string;
+    is_hidden?: boolean;
+    type?: "text" | "image_url" | "note";
+}
+export declare enum TestsetOperationType {
+    INSERT_ROWS = "insert_rows",
+    UPDATE_ROWS = "update_rows",
+    DELETE_ROWS = "delete_rows",
+    REORDER_ROWS = "reorder_rows"
+}
+export interface TestsetRowData {
+    row_index?: number;
+    height?: number;
+    row_data?: Record<string, string | number | null | boolean>;
+}
+export interface TestsetRowOperationsPayload {
+    testset_rows: TestsetRowData[];
+}

package/dist/types/experimentTypes.js

@@ -0,0 +1,10 @@
+// Constants
+export const UTC_EPOCH = "1970-01-01T00:00:00Z";
+export var TestsetOperationType;
+(function (TestsetOperationType) {
+    TestsetOperationType["INSERT_ROWS"] = "insert_rows";
+    TestsetOperationType["UPDATE_ROWS"] = "update_rows";
+    TestsetOperationType["DELETE_ROWS"] = "delete_rows";
+    TestsetOperationType["REORDER_ROWS"] = "reorder_rows";
+})(TestsetOperationType || (TestsetOperationType = {}));
+//# sourceMappingURL=experimentTypes.js.map

package/dist/types/experimentTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experimentTypes.js","sourceRoot":"","sources":["../../src/types/experimentTypes.ts"],"names":[],"mappings":"AAkBA,YAAY;AACZ,MAAM,CAAC,MAAM,SAAS,GAAG,sBAAsB,CAAC;AAiKhD,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC5B,mDAA2B,CAAA;IAC3B,mDAA2B,CAAA;IAC3B,mDAA2B,CAAA;IAC3B,qDAA6B,CAAA;AACjC,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B"}

package/dist/types/genericTypes.d.ts

@@ -0,0 +1,18 @@
+export interface RangeType {
+    min: number;
+    max: number;
+}
+export interface ParamType {
+    name: string;
+    type?: "string" | "number" | "boolean" | "object" | "array" | "int";
+    default?: string | number | boolean | object | any[] | null;
+    range?: RangeType;
+    description?: string;
+    required?: boolean;
+}
+export interface PaginatedResponseType<T> {
+    results: T[];
+    count: number;
+    next?: string;
+    previous?: string;
+}

package/dist/types/genericTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=genericTypes.js.map

package/dist/types/genericTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genericTypes.js","sourceRoot":"","sources":["../../src/types/genericTypes.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./decoratorTypes.js";
+export * from "./clientTypes.js";
+export * from "./spanTypes.js";
+export * from "./baseTypes.js";
+export * from "./logTypes.js";
+export * from "./tracingTypes.js";
+export * from "./genericTypes.js";
+export * from "./datasetTypes.js";
+export * from "./promptTypes.js";
+export * from "./evaluatorTypes.js";
+export * from "./experimentTypes.js";

package/dist/types/index.js

@@ -0,0 +1,12 @@
+export * from "./decoratorTypes.js";
+export * from "./clientTypes.js";
+export * from "./spanTypes.js";
+export * from "./baseTypes.js";
+export * from "./logTypes.js";
+export * from "./tracingTypes.js";
+export * from "./genericTypes.js";
+export * from "./datasetTypes.js";
+export * from "./promptTypes.js";
+export * from "./evaluatorTypes.js";
+export * from "./experimentTypes.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}