langwatch 1.10.0 → 1.12.0

package/dist/{implementation-C1F0eCHp.d.mts → implementation-BA3xa5UR.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-DJyJypkv.mjs';
 
 /**
  * Filterable Batch Span Exporter for OpenTelemetry

package/dist/{implementation-BvwOB77X.d.ts → implementation-rpImK8WS.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-Cr25FO-i.js';
 
 /**
  * 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-BA3xa5UR.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-DJyJypkv.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"];
@@ -2154,6 +2312,57 @@ declare class AnalyticsApiService {
     timeseries(params: AnalyticsTimeseriesBody): Promise<AnalyticsTimeseriesResponse>;
 }
 
+/** The typed columns/rows/statistics payload `POST /api/v1/query` answers with. */
+type QueryRunResult = paths["/api/v1/query"]["post"]["responses"]["200"]["content"]["application/json"];
+/** The queryable dataset/column catalog `GET /api/v1/query/schema` answers with. */
+type QuerySchemaResult = paths["/api/v1/query/schema"]["get"]["responses"]["200"]["content"]["application/json"];
+/**
+ * The body a query request sends.
+ *
+ * Derived from the generated request body so a contract change to what the
+ * endpoint accepts breaks this at compile time rather than drifting silently.
+ */
+type QueryRunParams = NonNullable<paths["/api/v1/query"]["post"]["requestBody"]>["content"]["application/json"];
+/**
+ * Typed client for the LangWatchQL query doors (`POST /api/v1/query` and
+ * `GET /api/v1/query/schema`) — the same governed query surface the workbench
+ * and saved charts run through, exposed directly rather than only via a saved
+ * chart's statement.
+ *
+ * Unlike the chart family, these routes carry no `projectId` in their path or
+ * body — the generated operations declare `path?: never`. Project scope is
+ * resolved once, when the underlying `LangwatchApiClient` is built
+ * (`createLangWatchApiClient` bakes `scopedProjectId() ?? LANGWATCH_PROJECT_ID`
+ * into that client's `Authorization`/`Basic` header at construction time —
+ * see `src/internal/api/client.ts` and `src/internal/api/auth.ts`). A
+ * per-call `projectId()` resolution the way `ChartsApiService` has one would
+ * therefore be dead code here: there is no URL slot to put it in, and it
+ * cannot retroactively change a header already baked into an existing
+ * client. It would also wrongly force every caller to have a project in
+ * scope — legacy `sk-lw-*` project keys carry their own project identity and
+ * need none (see `buildAuthHeaders`). So this service takes the plain,
+ * project-implicit config `AnalyticsApiService` does, and lets the api
+ * client resolve the credential itself.
+ */
+declare class QueryApiService {
+    private readonly apiClient;
+    constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
+    private handleApiError;
+    /**
+     * Runs one read-only LangWatchQL `SELECT` over the analytics datasets and
+     * returns typed columns, rows, execution statistics, truncation state and
+     * diagnostics, scoped to the caller's project.
+     */
+    query(params: QueryRunParams): Promise<QueryRunResult>;
+    /**
+     * Lists the LangWatchQL analytics datasets this key may query, with each
+     * column's type, description, the permissions that unlock it, and whether
+     * this caller holds them — plus each dataset's grain, join keys,
+     * partition-pruning time column, freshness and a runnable example query.
+     */
+    schema(): Promise<QuerySchemaResult>;
+}
+
 type TriggerResponse = NonNullable<paths["/api/triggers"]["get"]["responses"]["200"]["content"]["application/json"]>[number];
 type CreateTriggerBody = NonNullable<paths["/api/triggers"]["post"]["requestBody"]>["content"]["application/json"];
 type UpdateTriggerBody = NonNullable<paths["/api/triggers/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
@@ -3654,13 +3863,20 @@ 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;
     readonly dashboards: DashboardsApiService;
     readonly modelProviders: ModelProvidersApiService;
     readonly analytics: AnalyticsApiService;
+    /** The raw LangWatchQL door — run a governed SELECT or discover the analytics schema directly, outside a saved chart. */
+    readonly query: QueryApiService;
     readonly triggers: TriggersApiService;
     readonly graphs: GraphsApiService;
     readonly simulationRuns: SimulationRunsApiService;

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-rpImK8WS.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-Cr25FO-i.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"];
@@ -2154,6 +2312,57 @@ declare class AnalyticsApiService {
     timeseries(params: AnalyticsTimeseriesBody): Promise<AnalyticsTimeseriesResponse>;
 }
 
+/** The typed columns/rows/statistics payload `POST /api/v1/query` answers with. */
+type QueryRunResult = paths["/api/v1/query"]["post"]["responses"]["200"]["content"]["application/json"];
+/** The queryable dataset/column catalog `GET /api/v1/query/schema` answers with. */
+type QuerySchemaResult = paths["/api/v1/query/schema"]["get"]["responses"]["200"]["content"]["application/json"];
+/**
+ * The body a query request sends.
+ *
+ * Derived from the generated request body so a contract change to what the
+ * endpoint accepts breaks this at compile time rather than drifting silently.
+ */
+type QueryRunParams = NonNullable<paths["/api/v1/query"]["post"]["requestBody"]>["content"]["application/json"];
+/**
+ * Typed client for the LangWatchQL query doors (`POST /api/v1/query` and
+ * `GET /api/v1/query/schema`) — the same governed query surface the workbench
+ * and saved charts run through, exposed directly rather than only via a saved
+ * chart's statement.
+ *
+ * Unlike the chart family, these routes carry no `projectId` in their path or
+ * body — the generated operations declare `path?: never`. Project scope is
+ * resolved once, when the underlying `LangwatchApiClient` is built
+ * (`createLangWatchApiClient` bakes `scopedProjectId() ?? LANGWATCH_PROJECT_ID`
+ * into that client's `Authorization`/`Basic` header at construction time —
+ * see `src/internal/api/client.ts` and `src/internal/api/auth.ts`). A
+ * per-call `projectId()` resolution the way `ChartsApiService` has one would
+ * therefore be dead code here: there is no URL slot to put it in, and it
+ * cannot retroactively change a header already baked into an existing
+ * client. It would also wrongly force every caller to have a project in
+ * scope — legacy `sk-lw-*` project keys carry their own project identity and
+ * need none (see `buildAuthHeaders`). So this service takes the plain,
+ * project-implicit config `AnalyticsApiService` does, and lets the api
+ * client resolve the credential itself.
+ */
+declare class QueryApiService {
+    private readonly apiClient;
+    constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
+    private handleApiError;
+    /**
+     * Runs one read-only LangWatchQL `SELECT` over the analytics datasets and
+     * returns typed columns, rows, execution statistics, truncation state and
+     * diagnostics, scoped to the caller's project.
+     */
+    query(params: QueryRunParams): Promise<QueryRunResult>;
+    /**
+     * Lists the LangWatchQL analytics datasets this key may query, with each
+     * column's type, description, the permissions that unlock it, and whether
+     * this caller holds them — plus each dataset's grain, join keys,
+     * partition-pruning time column, freshness and a runnable example query.
+     */
+    schema(): Promise<QuerySchemaResult>;
+}
+
 type TriggerResponse = NonNullable<paths["/api/triggers"]["get"]["responses"]["200"]["content"]["application/json"]>[number];
 type CreateTriggerBody = NonNullable<paths["/api/triggers"]["post"]["requestBody"]>["content"]["application/json"];
 type UpdateTriggerBody = NonNullable<paths["/api/triggers/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
@@ -3654,13 +3863,20 @@ 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;
     readonly dashboards: DashboardsApiService;
     readonly modelProviders: ModelProvidersApiService;
     readonly analytics: AnalyticsApiService;
+    /** The raw LangWatchQL door — run a governed SELECT or discover the analytics schema directly, outside a saved chart. */
+    readonly query: QueryApiService;
     readonly triggers: TriggersApiService;
     readonly graphs: GraphsApiService;
     readonly simulationRuns: SimulationRunsApiService;