langwatch 1.9.0 → 1.11.0

package/dist/{implementation-BvwOB77X.d.ts → implementation-D58yPTJW.d.ts}

@@ -4,7 +4,7 @@ import { ExportResult } from '@opentelemetry/core';
 import { Logger, LogRecord, LoggerProvider } from '@opentelemetry/api-logs';
 import { b as SemConvLogRecordAttributes, a as SemConvAttributes } from './types-VOZv9LYO.js';
 import { TracerProvider } from '@opentelemetry/api';
-import { j as LangWatchTracer } from './types-jx13nj4M.js';
+import { j as LangWatchTracer } from './types-D_YNU-VL.js';
 
 /**
  * Filterable Batch Span Exporter for OpenTelemetry

package/dist/{implementation-C1F0eCHp.d.mts → implementation-aczLxVpV.d.mts}

@@ -4,7 +4,7 @@ import { ExportResult } from '@opentelemetry/core';
 import { Logger, LogRecord, LoggerProvider } from '@opentelemetry/api-logs';
 import { b as SemConvLogRecordAttributes, a as SemConvAttributes } from './types-VOZv9LYO.mjs';
 import { TracerProvider } from '@opentelemetry/api';
-import { j as LangWatchTracer } from './types-C3NpCWi_.mjs';
+import { j as LangWatchTracer } from './types-BmMuUDrO.mjs';
 
 /**
  * Filterable Batch Span Exporter for OpenTelemetry

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { L as Logger, C as ConsoleLogger, N as NoOpLogger } from './index-D7rKIGrO.mjs';
-export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, a as getLangWatchTracer } from './implementation-C1F0eCHp.mjs';
+export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, a as getLangWatchTracer } from './implementation-aczLxVpV.mjs';
 import { z } from 'zod';
-import { p as paths, P as PromptResponse, C as CreatePromptBody, U as UpdatePromptBody, T as TagDefinition, a as CreatedTag, o as operations, b as PromptData, F as FetchPolicy, c as Prompt, L as LangWatchSpan, d as components } from './types-C3NpCWi_.mjs';
+import { p as paths, P as PromptResponse, C as CreatePromptBody, U as UpdatePromptBody, T as TagDefinition, a as CreatedTag, o as operations, b as PromptData, F as FetchPolicy, c as Prompt, L as LangWatchSpan, d as components } from './types-BmMuUDrO.mjs';
 import openApiCreateClient from 'openapi-fetch';
 export { l as attributes } from './types-VOZv9LYO.mjs';
 import { CliHandledErrorReason, CliHandledError } from '@langwatch/langy/cards/handled-error';
@@ -1941,6 +1941,8 @@ type ScenarioResponse = NonNullable<paths["/api/scenarios"]["get"]["responses"][
 type CreateScenarioBody = NonNullable<paths["/api/scenarios"]["post"]["requestBody"]>["content"]["application/json"];
 type UpdateScenarioBody = NonNullable<paths["/api/scenarios/{id}"]["put"]["requestBody"]>["content"]["application/json"];
 type DeleteScenarioResponse = paths["/api/scenarios/{id}"]["delete"]["responses"]["200"]["content"]["application/json"];
+type ScenarioVersionListResponse = paths["/api/scenarios/{id}/versions"]["get"]["responses"]["200"]["content"]["application/json"];
+type ScenarioVersionDetail = paths["/api/scenarios/{id}/versions/{version}"]["get"]["responses"]["200"]["content"]["application/json"];
 
 declare class ScenariosApiService {
     private readonly apiClient;
@@ -1950,6 +1952,13 @@ declare class ScenariosApiService {
     get(id: string): Promise<ScenarioResponse>;
     create(params: CreateScenarioBody): Promise<ScenarioResponse>;
     update(id: string, params: UpdateScenarioBody): Promise<ScenarioResponse>;
+    /** The saved versions of a scenario, newest first. */
+    listVersions(id: string, options?: {
+        limit?: number;
+        cursor?: number;
+    }): Promise<ScenarioVersionListResponse>;
+    /** One saved version of a scenario, with the content it saved. */
+    getVersion(id: string, version: number): Promise<ScenarioVersionDetail>;
     delete(id: string): Promise<DeleteScenarioResponse>;
 }
 
@@ -1974,12 +1983,25 @@ interface SuiteRunOptions {
      * that name.
      */
     parameters?: Record<string, string | number | boolean>;
+    /**
+     * One short line saying why this batch was run, e.g. a commit hash or what
+     * changed. Every run of the batch carries it. Spaces around it are removed,
+     * and a note of only spaces is sent as no note at all.
+     */
+    note?: string;
 }
+/** Which kind of suite `getAll` returns. Defaults to run plans. */
+type SuiteKind = "custom" | "folder";
+/**
+ * @deprecated Use runPlans and testSuites; /api/suites is a frozen alias.
+ */
 declare class SuitesApiService {
     private readonly apiClient;
     constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
     private handleApiError;
-    getAll(): Promise<SuiteResponse[]>;
+    getAll(options?: {
+        kind?: SuiteKind;
+    }): Promise<SuiteResponse[]>;
     get(id: string): Promise<SuiteResponse>;
     create(params: CreateSuiteBody): Promise<SuiteResponse>;
     update(id: string, params: UpdateSuiteBody): Promise<SuiteResponse>;
@@ -1996,6 +2018,93 @@ declare class SuitesApiService {
     }>;
 }
 
+/** One run plan, exactly as the REST surface answers it. */
+type RunPlan = paths["/api/v1/run-plans/{id}"]["get"]["responses"]["200"]["content"]["application/json"];
+/** The body `POST /api/v1/run-plans/run` takes. */
+type RunPlanRunBody = NonNullable<paths["/api/v1/run-plans/run"]["post"]["requestBody"]>["content"]["application/json"];
+/** What a scheduled run answers with. */
+type RunPlanRunResult = paths["/api/v1/run-plans/run"]["post"]["responses"]["200"]["content"]["application/json"];
+/** The body `POST /api/v1/run-plans/{id}/run` takes. */
+type RunPlanRerunBody = NonNullable<paths["/api/v1/run-plans/{id}/run"]["post"]["requestBody"]>["content"]["application/json"];
+/**
+ * Typed client for the run plan family (`/api/v1/run-plans`).
+ *
+ * A run plan is identified by its NAME. Posting a configuration under a name
+ * already in use replaces that plan's configuration and joins its history;
+ * posting under a new name creates the plan; posting no name lets the platform
+ * derive one from what the run covers and what it runs against.
+ *
+ * @see specs/typescript-sdk/run-plans-and-test-suites.feature
+ */
+declare class RunPlansApiService {
+    private readonly apiClient;
+    constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
+    private handleApiError;
+    /** The project's run plans. Archived plans are left out unless asked for. */
+    list(options?: {
+        includeArchived?: boolean;
+    }): Promise<RunPlan[]>;
+    get(id: string): Promise<RunPlan>;
+    /**
+     * Runs a configuration under a name.
+     *
+     * A note of only spaces is no note: sending an empty string would store a
+     * value every reader then has to filter out.
+     */
+    run(body: RunPlanRunBody): Promise<RunPlanRunResult>;
+    /** Runs a plan again with the configuration it already holds. */
+    rerun(id: string, body?: RunPlanRerunBody): Promise<RunPlanRunResult>;
+    archive(id: string): Promise<{
+        id: string;
+        archived: true;
+    }>;
+}
+
+/** One test suite as the list answers it: a name and the scenarios filed in it. */
+type TestSuite = NonNullable<paths["/api/v1/test-suites"]["get"]["responses"]["200"]["content"]["application/json"]>[number];
+/** One test suite read on its own, with its scenarios named. */
+type TestSuiteDetail = paths["/api/v1/test-suites/{id}"]["get"]["responses"]["200"]["content"]["application/json"];
+/** The body `POST /api/v1/test-suites` takes. */
+type CreateTestSuiteBody = NonNullable<paths["/api/v1/test-suites"]["post"]["requestBody"]>["content"]["application/json"];
+/** The body `PATCH /api/v1/test-suites/{id}` takes. */
+type RenameTestSuiteBody = NonNullable<paths["/api/v1/test-suites/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
+/** The body `POST /api/v1/test-suites/{id}/run` takes. */
+type RunTestSuiteBody = NonNullable<paths["/api/v1/test-suites/{id}/run"]["post"]["requestBody"]>["content"]["application/json"];
+/** What a scheduled suite run answers with. It is a run plan run. */
+type TestSuiteRunResult = RunPlanRunResult;
+/**
+ * Typed client for the test suite family (`/api/v1/test-suites`).
+ *
+ * A test suite is a group of scenarios: a name, and the scenarios filed in it.
+ * It holds no targets and no configuration, so running one sends its targets with
+ * the request and the platform files the run under a run plan.
+ *
+ * @see specs/typescript-sdk/run-plans-and-test-suites.feature
+ */
+declare class TestSuitesApiService {
+    private readonly apiClient;
+    constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
+    private handleApiError;
+    /** The project's test suites. Archived suites are left out unless asked for. */
+    list(options?: {
+        includeArchived?: boolean;
+    }): Promise<TestSuite[]>;
+    create(params: CreateTestSuiteBody): Promise<TestSuite>;
+    get(id: string): Promise<TestSuiteDetail>;
+    /** Renames a suite. The slug is kept, so links and run history stay put. */
+    rename(id: string, params: RenameTestSuiteBody): Promise<TestSuite>;
+    /** Archives a suite. The scenarios filed in it are archived with it. */
+    archive(id: string): Promise<{
+        id: string;
+        archived: true;
+    }>;
+    /**
+     * Runs every scenario filed in the suite against the targets sent with the
+     * request. A note of only spaces is no note.
+     */
+    run(id: string, body: RunTestSuiteBody): Promise<TestSuiteRunResult>;
+}
+
 type WorkflowResponse = NonNullable<paths["/api/workflows"]["get"]["responses"]["200"]["content"]["application/json"]>[number];
 type WorkflowDeleteResponse = paths["/api/workflows/{id}"]["delete"]["responses"]["200"]["content"]["application/json"];
 declare class WorkflowsApiService {
@@ -2037,6 +2146,23 @@ declare class WorkflowsApiService {
     }): Promise<ExperimentRunWithResults>;
 }
 
+/** One run parameter an agent declares, as the platform lists it. */
+interface AgentParameterSpec {
+    name: string;
+    type: "string" | "number" | "boolean";
+    options?: string[];
+    default?: string | number | boolean;
+    description?: string;
+    required?: boolean;
+    secret?: boolean;
+}
+/** One process connected as an instance of a connected agent. */
+interface AgentInstance {
+    id: string;
+    hostname: string;
+    label?: string | null;
+    connectedAt: string;
+}
 interface AgentResponse {
     id: string;
     name: string;
@@ -2045,6 +2171,20 @@ interface AgentResponse {
     createdAt: string;
     updatedAt: string;
     platformUrl?: string;
+    /** Connected agents: the environment the SDK registered under. */
+    environment?: string | null;
+    /** Connected agents: online while at least one instance is connected. */
+    status?: "online" | "offline" | null;
+    instances?: AgentInstance[];
+    lastSeenAt?: string | null;
+    /** The owner of a personal agent. */
+    owner?: {
+        userId: string;
+        name: string;
+    } | null;
+    /** The machine a host-scoped development agent belongs to. */
+    hostLabel?: string | null;
+    parameters?: AgentParameterSpec[];
 }
 interface AgentListResponse {
     data: AgentResponse[];
@@ -2055,6 +2195,12 @@ interface AgentListResponse {
         totalPages: number;
     };
 }
+/** The body `POST /api/v1/agents/{id}/call` takes. */
+type AgentCallBody = NonNullable<paths["/api/v1/agents/{id}/call"]["post"]["requestBody"]>["content"]["application/json"];
+/** The reply of the relay: the function's output and the instance that ran it. */
+type AgentCallResponse = paths["/api/v1/agents/{id}/call"]["post"]["responses"][200]["content"]["application/json"];
+/** The ids `POST /api/v1/agents/{id}/test` answers with. */
+type AgentTestRunResponse = paths["/api/v1/agents/{id}/test"]["post"]["responses"][200]["content"]["application/json"];
 declare class AgentsApiService {
     private readonly apiClient;
     constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
@@ -2079,6 +2225,18 @@ declare class AgentsApiService {
         id: string;
         name: string;
     }>;
+    /**
+     * Runs one turn of a connected agent through the relay: the platform
+     * dispatches it to a live instance and answers with the function's output.
+     */
+    call(id: string, body: AgentCallBody): Promise<AgentCallResponse>;
+    /**
+     * Runs one scripted scenario against an agent: the user sends "ping", the
+     * agent answers, and the run succeeds when the answer arrives. The project
+     * gains no scenario, run plan or test suite, and the answer carries the run
+     * ids to follow.
+     */
+    test(id: string): Promise<AgentTestRunResponse>;
 }
 
 type AnnotationResponse = components["schemas"]["Annotation"];
@@ -3654,7 +3812,12 @@ declare class LangWatch {
     readonly evaluations: EvaluationsFacade;
     readonly evaluators: EvaluatorsApiService;
     readonly scenarios: ScenariosApiService;
+    /**
+     * @deprecated Use runPlans and testSuites; /api/suites is a frozen alias.
+     */
     readonly suites: SuitesApiService;
+    readonly runPlans: RunPlansApiService;
+    readonly testSuites: TestSuitesApiService;
     readonly workflows: WorkflowsApiService;
     readonly agents: AgentsApiService;
     readonly annotations: AnnotationsApiService;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { L as Logger, C as ConsoleLogger, N as NoOpLogger } from './index-D7rKIGrO.js';
-export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, a as getLangWatchTracer } from './implementation-BvwOB77X.js';
+export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, a as getLangWatchTracer } from './implementation-D58yPTJW.js';
 import { z } from 'zod';
-import { p as paths, P as PromptResponse, C as CreatePromptBody, U as UpdatePromptBody, T as TagDefinition, a as CreatedTag, o as operations, b as PromptData, F as FetchPolicy, c as Prompt, L as LangWatchSpan, d as components } from './types-jx13nj4M.js';
+import { p as paths, P as PromptResponse, C as CreatePromptBody, U as UpdatePromptBody, T as TagDefinition, a as CreatedTag, o as operations, b as PromptData, F as FetchPolicy, c as Prompt, L as LangWatchSpan, d as components } from './types-D_YNU-VL.js';
 import openApiCreateClient from 'openapi-fetch';
 export { l as attributes } from './types-VOZv9LYO.js';
 import { CliHandledErrorReason, CliHandledError } from '@langwatch/langy/cards/handled-error';
@@ -1941,6 +1941,8 @@ type ScenarioResponse = NonNullable<paths["/api/scenarios"]["get"]["responses"][
 type CreateScenarioBody = NonNullable<paths["/api/scenarios"]["post"]["requestBody"]>["content"]["application/json"];
 type UpdateScenarioBody = NonNullable<paths["/api/scenarios/{id}"]["put"]["requestBody"]>["content"]["application/json"];
 type DeleteScenarioResponse = paths["/api/scenarios/{id}"]["delete"]["responses"]["200"]["content"]["application/json"];
+type ScenarioVersionListResponse = paths["/api/scenarios/{id}/versions"]["get"]["responses"]["200"]["content"]["application/json"];
+type ScenarioVersionDetail = paths["/api/scenarios/{id}/versions/{version}"]["get"]["responses"]["200"]["content"]["application/json"];
 
 declare class ScenariosApiService {
     private readonly apiClient;
@@ -1950,6 +1952,13 @@ declare class ScenariosApiService {
     get(id: string): Promise<ScenarioResponse>;
     create(params: CreateScenarioBody): Promise<ScenarioResponse>;
     update(id: string, params: UpdateScenarioBody): Promise<ScenarioResponse>;
+    /** The saved versions of a scenario, newest first. */
+    listVersions(id: string, options?: {
+        limit?: number;
+        cursor?: number;
+    }): Promise<ScenarioVersionListResponse>;
+    /** One saved version of a scenario, with the content it saved. */
+    getVersion(id: string, version: number): Promise<ScenarioVersionDetail>;
     delete(id: string): Promise<DeleteScenarioResponse>;
 }
 
@@ -1974,12 +1983,25 @@ interface SuiteRunOptions {
      * that name.
      */
     parameters?: Record<string, string | number | boolean>;
+    /**
+     * One short line saying why this batch was run, e.g. a commit hash or what
+     * changed. Every run of the batch carries it. Spaces around it are removed,
+     * and a note of only spaces is sent as no note at all.
+     */
+    note?: string;
 }
+/** Which kind of suite `getAll` returns. Defaults to run plans. */
+type SuiteKind = "custom" | "folder";
+/**
+ * @deprecated Use runPlans and testSuites; /api/suites is a frozen alias.
+ */
 declare class SuitesApiService {
     private readonly apiClient;
     constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
     private handleApiError;
-    getAll(): Promise<SuiteResponse[]>;
+    getAll(options?: {
+        kind?: SuiteKind;
+    }): Promise<SuiteResponse[]>;
     get(id: string): Promise<SuiteResponse>;
     create(params: CreateSuiteBody): Promise<SuiteResponse>;
     update(id: string, params: UpdateSuiteBody): Promise<SuiteResponse>;
@@ -1996,6 +2018,93 @@ declare class SuitesApiService {
     }>;
 }
 
+/** One run plan, exactly as the REST surface answers it. */
+type RunPlan = paths["/api/v1/run-plans/{id}"]["get"]["responses"]["200"]["content"]["application/json"];
+/** The body `POST /api/v1/run-plans/run` takes. */
+type RunPlanRunBody = NonNullable<paths["/api/v1/run-plans/run"]["post"]["requestBody"]>["content"]["application/json"];
+/** What a scheduled run answers with. */
+type RunPlanRunResult = paths["/api/v1/run-plans/run"]["post"]["responses"]["200"]["content"]["application/json"];
+/** The body `POST /api/v1/run-plans/{id}/run` takes. */
+type RunPlanRerunBody = NonNullable<paths["/api/v1/run-plans/{id}/run"]["post"]["requestBody"]>["content"]["application/json"];
+/**
+ * Typed client for the run plan family (`/api/v1/run-plans`).
+ *
+ * A run plan is identified by its NAME. Posting a configuration under a name
+ * already in use replaces that plan's configuration and joins its history;
+ * posting under a new name creates the plan; posting no name lets the platform
+ * derive one from what the run covers and what it runs against.
+ *
+ * @see specs/typescript-sdk/run-plans-and-test-suites.feature
+ */
+declare class RunPlansApiService {
+    private readonly apiClient;
+    constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
+    private handleApiError;
+    /** The project's run plans. Archived plans are left out unless asked for. */
+    list(options?: {
+        includeArchived?: boolean;
+    }): Promise<RunPlan[]>;
+    get(id: string): Promise<RunPlan>;
+    /**
+     * Runs a configuration under a name.
+     *
+     * A note of only spaces is no note: sending an empty string would store a
+     * value every reader then has to filter out.
+     */
+    run(body: RunPlanRunBody): Promise<RunPlanRunResult>;
+    /** Runs a plan again with the configuration it already holds. */
+    rerun(id: string, body?: RunPlanRerunBody): Promise<RunPlanRunResult>;
+    archive(id: string): Promise<{
+        id: string;
+        archived: true;
+    }>;
+}
+
+/** One test suite as the list answers it: a name and the scenarios filed in it. */
+type TestSuite = NonNullable<paths["/api/v1/test-suites"]["get"]["responses"]["200"]["content"]["application/json"]>[number];
+/** One test suite read on its own, with its scenarios named. */
+type TestSuiteDetail = paths["/api/v1/test-suites/{id}"]["get"]["responses"]["200"]["content"]["application/json"];
+/** The body `POST /api/v1/test-suites` takes. */
+type CreateTestSuiteBody = NonNullable<paths["/api/v1/test-suites"]["post"]["requestBody"]>["content"]["application/json"];
+/** The body `PATCH /api/v1/test-suites/{id}` takes. */
+type RenameTestSuiteBody = NonNullable<paths["/api/v1/test-suites/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
+/** The body `POST /api/v1/test-suites/{id}/run` takes. */
+type RunTestSuiteBody = NonNullable<paths["/api/v1/test-suites/{id}/run"]["post"]["requestBody"]>["content"]["application/json"];
+/** What a scheduled suite run answers with. It is a run plan run. */
+type TestSuiteRunResult = RunPlanRunResult;
+/**
+ * Typed client for the test suite family (`/api/v1/test-suites`).
+ *
+ * A test suite is a group of scenarios: a name, and the scenarios filed in it.
+ * It holds no targets and no configuration, so running one sends its targets with
+ * the request and the platform files the run under a run plan.
+ *
+ * @see specs/typescript-sdk/run-plans-and-test-suites.feature
+ */
+declare class TestSuitesApiService {
+    private readonly apiClient;
+    constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
+    private handleApiError;
+    /** The project's test suites. Archived suites are left out unless asked for. */
+    list(options?: {
+        includeArchived?: boolean;
+    }): Promise<TestSuite[]>;
+    create(params: CreateTestSuiteBody): Promise<TestSuite>;
+    get(id: string): Promise<TestSuiteDetail>;
+    /** Renames a suite. The slug is kept, so links and run history stay put. */
+    rename(id: string, params: RenameTestSuiteBody): Promise<TestSuite>;
+    /** Archives a suite. The scenarios filed in it are archived with it. */
+    archive(id: string): Promise<{
+        id: string;
+        archived: true;
+    }>;
+    /**
+     * Runs every scenario filed in the suite against the targets sent with the
+     * request. A note of only spaces is no note.
+     */
+    run(id: string, body: RunTestSuiteBody): Promise<TestSuiteRunResult>;
+}
+
 type WorkflowResponse = NonNullable<paths["/api/workflows"]["get"]["responses"]["200"]["content"]["application/json"]>[number];
 type WorkflowDeleteResponse = paths["/api/workflows/{id}"]["delete"]["responses"]["200"]["content"]["application/json"];
 declare class WorkflowsApiService {
@@ -2037,6 +2146,23 @@ declare class WorkflowsApiService {
     }): Promise<ExperimentRunWithResults>;
 }
 
+/** One run parameter an agent declares, as the platform lists it. */
+interface AgentParameterSpec {
+    name: string;
+    type: "string" | "number" | "boolean";
+    options?: string[];
+    default?: string | number | boolean;
+    description?: string;
+    required?: boolean;
+    secret?: boolean;
+}
+/** One process connected as an instance of a connected agent. */
+interface AgentInstance {
+    id: string;
+    hostname: string;
+    label?: string | null;
+    connectedAt: string;
+}
 interface AgentResponse {
     id: string;
     name: string;
@@ -2045,6 +2171,20 @@ interface AgentResponse {
     createdAt: string;
     updatedAt: string;
     platformUrl?: string;
+    /** Connected agents: the environment the SDK registered under. */
+    environment?: string | null;
+    /** Connected agents: online while at least one instance is connected. */
+    status?: "online" | "offline" | null;
+    instances?: AgentInstance[];
+    lastSeenAt?: string | null;
+    /** The owner of a personal agent. */
+    owner?: {
+        userId: string;
+        name: string;
+    } | null;
+    /** The machine a host-scoped development agent belongs to. */
+    hostLabel?: string | null;
+    parameters?: AgentParameterSpec[];
 }
 interface AgentListResponse {
     data: AgentResponse[];
@@ -2055,6 +2195,12 @@ interface AgentListResponse {
         totalPages: number;
     };
 }
+/** The body `POST /api/v1/agents/{id}/call` takes. */
+type AgentCallBody = NonNullable<paths["/api/v1/agents/{id}/call"]["post"]["requestBody"]>["content"]["application/json"];
+/** The reply of the relay: the function's output and the instance that ran it. */
+type AgentCallResponse = paths["/api/v1/agents/{id}/call"]["post"]["responses"][200]["content"]["application/json"];
+/** The ids `POST /api/v1/agents/{id}/test` answers with. */
+type AgentTestRunResponse = paths["/api/v1/agents/{id}/test"]["post"]["responses"][200]["content"]["application/json"];
 declare class AgentsApiService {
     private readonly apiClient;
     constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
@@ -2079,6 +2225,18 @@ declare class AgentsApiService {
         id: string;
         name: string;
     }>;
+    /**
+     * Runs one turn of a connected agent through the relay: the platform
+     * dispatches it to a live instance and answers with the function's output.
+     */
+    call(id: string, body: AgentCallBody): Promise<AgentCallResponse>;
+    /**
+     * Runs one scripted scenario against an agent: the user sends "ping", the
+     * agent answers, and the run succeeds when the answer arrives. The project
+     * gains no scenario, run plan or test suite, and the answer carries the run
+     * ids to follow.
+     */
+    test(id: string): Promise<AgentTestRunResponse>;
 }
 
 type AnnotationResponse = components["schemas"]["Annotation"];
@@ -3654,7 +3812,12 @@ declare class LangWatch {
     readonly evaluations: EvaluationsFacade;
     readonly evaluators: EvaluatorsApiService;
     readonly scenarios: ScenariosApiService;
+    /**
+     * @deprecated Use runPlans and testSuites; /api/suites is a frozen alias.
+     */
     readonly suites: SuitesApiService;
+    readonly runPlans: RunPlansApiService;
+    readonly testSuites: TestSuitesApiService;
     readonly workflows: WorkflowsApiService;
     readonly agents: AgentsApiService;
     readonly annotations: AnnotationsApiService;