@introspection-sdk/introspection-node 0.21.1 → 0.23.0

package/README.md

@@ -54,6 +54,52 @@ teardown.
 Interrupted runs resume through
 `runner.tasks.runs.resume(taskId, { resume: entries })`.
 
+### Annotations
+
+Annotations capture what a domain expert found good or bad on an OTel span. They
+are labels, comments, and assignments—not numeric scores. Writes require an
+authenticated business-member token with `annotations:write`; project API
+keys and sandbox credentials cannot write annotations.
+
+```typescript
+const client = new IntrospectionClient({
+  token: memberAccessToken,
+  cpSession: encodedMemberSession,
+  advanced: {
+    baseApiUrl: "https://api.introspection.dev", // Control Plane
+    dpUrl: memberDataPlaneUrl,
+  },
+});
+
+const span = {
+  trace_id: "0123456789abcdef0123456789abcdef",
+  span_id: "0123456789abcdef",
+};
+
+await client.projectLabels.create({
+  slug: "strong-structure",
+  color: "#f97316",
+  description: "A useful structure to preserve during distillation",
+});
+await client.annotations.create(span, { labels: ["strong-structure"] });
+await client.annotations.create(span, {
+  comment: "Keep the conclusion before the evidence.",
+});
+await client.annotations.create(span, {
+  reviewerEmails: ["expert@example.com"],
+});
+await client.annotations.create(span, { reviewerEmails: [] });
+```
+
+Labels and reviewers are complete snapshots; pass `[]` to clear one. Comments
+append. Every mutation gets a UUIDv7 `event_id` before its
+first transport attempt, so an automatic retry remains one event. Supply
+`{ event_id }` as the final method argument when retrying across processes.
+`client.annotations.list()` and `client.projectLabels.list()` are both awaitable
+for the first page and async-iterable across every cursor page.
+Read immutable annotation history with
+`client.events.list({ event_name: "introspection.annotation", trace_id, span_id })`.
+
 ## Pi instrumentation
 
 Pi is the supported agent-instrumentation path:

package/dist/client.d.ts

@@ -12,12 +12,15 @@
  * `@introspection-sdk/introspection-node/otel`.
  */
 import type { AdvancedOptions } from "@introspection-sdk/types";
+import { EventsApi } from "@introspection-sdk/http";
 import type { IntrospectionClientOptions } from "./types.js";
 import { type ServiceAccountTokenParams } from "./auth.js";
 import { HttpClient } from "./http.js";
 import { type RuntimeHandleFactory, type RuntimesApi } from "./resources/runtimes.js";
 import { type ExperimentHandleFactory, type ExperimentsApi } from "./resources/experiments.js";
 import { type RecipesApi } from "./resources/recipes.js";
+import { type ConnectorsApi } from "./resources/connectors.js";
+import { type AnnotationsApi, type ProjectLabelsApi } from "./resources/annotations.js";
 /**
  * Introspection REST client.
  *
@@ -41,6 +44,8 @@ import { type RecipesApi } from "./resources/recipes.js";
 export declare class IntrospectionClient {
     /** @internal — HTTP client pointed at the CP API with the customer key. */
     readonly cpHttp: HttpClient;
+    /** @internal — HTTP client pointed at the project Data Plane. */
+    readonly dpHttp: HttpClient;
     /** @internal — passed through to Runner so it can build its own DP HTTP client. */
     readonly advancedOptions: AdvancedOptions;
     /**
@@ -49,10 +54,7 @@ export declare class IntrospectionClient {
      * through the Introspection CLI and platform.
      */
     readonly runtimes: RuntimesApi & RuntimeHandleFactory;
-    /**
-     * Reads on `/v1/experiments` plus the `(id) => ExperimentHandle` factory
-     * for run lifecycle. Authoring experiment definitions is a CLI action.
-     */
+    /** CRUD on `/v1/experiments` plus the callable run-lifecycle handle. */
     readonly experiments: ExperimentsApi & ExperimentHandleFactory;
     /**
      * Reads on `/v1/recipes`. Recipes are immutable build artefacts
@@ -60,6 +62,18 @@ export declare class IntrospectionClient {
      * experiment arms; authoring them is a CLI action.
      */
     readonly recipes: RecipesApi;
+    /**
+     * CRUD on `/v1/connectors` (with connections nested under
+     * `.connections`) plus `connectors.authorize(id)`, which mints the
+     * single-use consent URL a Business hands its customer.
+     */
+    readonly connectors: ConnectorsApi;
+    /** Read folded span annotations and append one annotation mutation. */
+    readonly annotations: AnnotationsApi;
+    /** Manage reusable project labels. */
+    readonly projectLabels: ProjectLabelsApi;
+    /** Read immutable annotation activity and other typed platform events. */
+    readonly events: EventsApi;
     constructor(options?: IntrospectionClientOptions);
     /**
      * Authenticate as a confidential service account and return a ready

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAmB;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,oBAAoB,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,uBAAuB,CAAC;IAE/D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;gBAEjB,OAAO,GAAE,0BAA+B;IAkDpD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACU,kBAAkB,CAC7B,MAAM,EAAE,yBAAyB,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,OAAO,CAAC,mBAAmB,CAAC;IAS/B,wCAAwC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAGpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAmB;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,oBAAoB,CAAC;IAEtD,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,uBAAuB,CAAC;IAE/D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IAEnC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IAErC,sCAAsC;IACtC,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAEzC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;gBAEf,OAAO,GAAE,0BAA+B;IAiEpD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACU,kBAAkB,CAC7B,MAAM,EAAE,yBAAyB,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,OAAO,CAAC,mBAAmB,CAAC;IAa/B,wCAAwC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}

package/dist/client.js

@@ -11,12 +11,15 @@
  * helpers, use {@link IntrospectionLogs} from
  * `@introspection-sdk/introspection-node/otel`.
  */
+import { EventsApi } from "@introspection-sdk/http";
 import { logger as sdkLogger, USER_AGENT } from "./utils.js";
 import { serviceAccountToken } from "./auth.js";
 import { HttpClient } from "./http.js";
 import { attachRuntimes, } from "./resources/runtimes.js";
 import { attachExperiments, } from "./resources/experiments.js";
 import { attachRecipes } from "./resources/recipes.js";
+import { attachConnectors, } from "./resources/connectors.js";
+import { attachAnnotations, attachProjectLabels, } from "./resources/annotations.js";
 import { DEV_TARGET_HEADER, resolveDevTarget } from "./dev-target.js";
 /**
  * Introspection REST client.
@@ -41,6 +44,8 @@ import { DEV_TARGET_HEADER, resolveDevTarget } from "./dev-target.js";
 export class IntrospectionClient {
     /** @internal — HTTP client pointed at the CP API with the customer key. */
     cpHttp;
+    /** @internal — HTTP client pointed at the project Data Plane. */
+    dpHttp;
     /** @internal — passed through to Runner so it can build its own DP HTTP client. */
     advancedOptions;
     /**
@@ -49,10 +54,7 @@ export class IntrospectionClient {
      * through the Introspection CLI and platform.
      */
     runtimes;
-    /**
-     * Reads on `/v1/experiments` plus the `(id) => ExperimentHandle` factory
-     * for run lifecycle. Authoring experiment definitions is a CLI action.
-     */
+    /** CRUD on `/v1/experiments` plus the callable run-lifecycle handle. */
     experiments;
     /**
      * Reads on `/v1/recipes`. Recipes are immutable build artefacts
@@ -60,12 +62,28 @@ export class IntrospectionClient {
      * experiment arms; authoring them is a CLI action.
      */
     recipes;
+    /**
+     * CRUD on `/v1/connectors` (with connections nested under
+     * `.connections`) plus `connectors.authorize(id)`, which mints the
+     * single-use consent URL a Business hands its customer.
+     */
+    connectors;
+    /** Read folded span annotations and append one annotation mutation. */
+    annotations;
+    /** Manage reusable project labels. */
+    projectLabels;
+    /** Read immutable annotation activity and other typed platform events. */
+    events;
     constructor(options = {}) {
         const token = options.token || process.env.INTROSPECTION_TOKEN || "";
         const advanced = options.advanced || {};
         const baseApiUrl = advanced.baseApiUrl ||
             process.env.INTROSPECTION_BASE_API_URL ||
             "https://api.introspection.dev";
+        // Self-hosted/local stacks commonly route both planes on one host. Hosted
+        // token exchanges return the regional DP URL explicitly; callers pass it
+        // as `dpUrl` and fromServiceAccount wires it automatically.
+        const dpUrl = advanced.dpUrl || baseApiUrl;
         if (!token) {
             sdkLogger.warn("IntrospectionClient: No token provided. REST calls will fail.");
         }
@@ -93,12 +111,23 @@ export class IntrospectionClient {
         this.cpHttp = new HttpClient({
             apiUrl: baseApiUrl,
             token,
+            cpSession: options.cpSession,
+            additionalHeaders: this.advancedOptions.additionalHeaders,
+            fetch: advanced.fetch,
+        });
+        this.dpHttp = new HttpClient({
+            apiUrl: dpUrl,
+            token,
             additionalHeaders: this.advancedOptions.additionalHeaders,
             fetch: advanced.fetch,
         });
         this.runtimes = attachRuntimes(this, this.cpHttp);
         this.experiments = attachExperiments(this, this.cpHttp);
         this.recipes = attachRecipes(this.cpHttp);
+        this.connectors = attachConnectors(this.cpHttp);
+        this.annotations = attachAnnotations(this.cpHttp, this.dpHttp);
+        this.projectLabels = attachProjectLabels(this.dpHttp);
+        this.events = new EventsApi(this.dpHttp);
         sdkLogger.info(`IntrospectionClient initialized: api=${baseApiUrl}`);
     }
     /**
@@ -128,11 +157,15 @@ export class IntrospectionClient {
      * re-mint (call this again) for long-lived processes once it lapses.
      */
     static async fromServiceAccount(params) {
-        const { access_token } = await serviceAccountToken(params);
+        const { access_token, dp_url } = await serviceAccountToken(params);
         return new IntrospectionClient({
             token: access_token,
             serviceName: params.serviceName,
-            advanced: { baseApiUrl: params.baseApiUrl, fetch: params.fetch },
+            advanced: {
+                baseApiUrl: params.baseApiUrl,
+                dpUrl: dp_url ?? undefined,
+                fetch: params.fetch,
+            },
         });
     }
     /** Close the underlying HTTP client. */

package/dist/client.js.map

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

package/dist/http.d.ts

@@ -8,6 +8,8 @@ export interface ResolvedApiConfig {
     apiUrl: string;
     /** Bearer token. Customer API key for CP, runner JWT for DP. */
     token: string;
+    /** Encoded member session used instead of bearer auth on Control Plane calls. */
+    cpSession?: string;
     additionalHeaders?: Record<string, string>;
     fetch?: typeof fetch;
     /**
@@ -20,10 +22,9 @@ export interface ResolvedApiConfig {
     retryBaseMs?: number;
 }
 /**
- * Bearer-token HTTP client used by both the CP-bound IntrospectionClient
- * and each DP-bound Runner. The request/response machinery lives in the
- * shared {@link BaseHttpClient}; this only pins the auth strategy —
- * `Authorization: Bearer <token>` on every request, no cookie credentials.
+ * Authenticated HTTP client used by the CP-bound IntrospectionClient and each
+ * DP-bound Runner. A member-authored Node workflow may supply the encoded
+ * `intro_cp_session` for CP-only operations; all other calls use bearer auth.
  */
 export declare class HttpClient extends BaseHttpClient {
     constructor(cfg: ResolvedApiConfig);

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,cAAc;gBAChC,GAAG,EAAE,iBAAiB;CAYnC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,cAAc;gBAChC,GAAG,EAAE,iBAAiB;CAiBnC"}

package/dist/http.js

@@ -1,9 +1,8 @@
 import { BaseHttpClient } from "@introspection-sdk/http";
 /**
- * Bearer-token HTTP client used by both the CP-bound IntrospectionClient
- * and each DP-bound Runner. The request/response machinery lives in the
- * shared {@link BaseHttpClient}; this only pins the auth strategy —
- * `Authorization: Bearer <token>` on every request, no cookie credentials.
+ * Authenticated HTTP client used by the CP-bound IntrospectionClient and each
+ * DP-bound Runner. A member-authored Node workflow may supply the encoded
+ * `intro_cp_session` for CP-only operations; all other calls use bearer auth.
  */
 export class HttpClient extends BaseHttpClient {
     constructor(cfg) {
@@ -14,7 +13,12 @@ export class HttpClient extends BaseHttpClient {
             maxRetries: cfg.maxRetries,
             retryBaseMs: cfg.retryBaseMs,
             transport: {
-                authHeaders: () => ({ Authorization: `Bearer ${cfg.token}` }),
+                authHeaders: () => {
+                    if (cfg.cpSession) {
+                        return { Cookie: `intro_cp_session=${cfg.cpSession}` };
+                    }
+                    return { Authorization: `Bearer ${cfg.token}` };
+                },
             },
         });
     }

package/dist/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAuBzD;;;;;GAKG;AACH,MAAM,OAAO,UAAW,SAAQ,cAAc;IAC5C,YAAY,GAAsB;QAChC,KAAK,CAAC;YACJ,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS,EAAE;gBACT,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;aAC9D;SACF,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAyBzD;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,cAAc;IAC5C,YAAY,GAAsB;QAChC,KAAK,CAAC;YACJ,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS,EAAE;gBACT,WAAW,EAAE,GAA2B,EAAE;oBACxC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;wBAClB,OAAO,EAAE,MAAM,EAAE,oBAAoB,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC;oBACzD,CAAC;oBACD,OAAO,EAAE,aAAa,EAAE,UAAU,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;gBAClD,CAAC;aACF;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -27,7 +27,9 @@ export type { RuntimeHandleFactory } from "./resources/runtimes.js";
 export { ExperimentsApi, ExperimentHandle, attachExperiments, } from "./resources/experiments.js";
 export type { ExperimentHandleFactory } from "./resources/experiments.js";
 export { RecipesApi, attachRecipes } from "./resources/recipes.js";
-export type { AGUIEvent, BaseEvent, Interrupt, Message, ResumeEntry, RunAgentInput, Paginated, ListParams, Task, TaskCreateParams, TaskUpdateParams, TaskListParams, TaskKind, TaskStatus, TaskRunKind, TaskPrompt, TaskRun, TaskRunCreateParams, TaskRunResumeParams, TaskRunResponse, TaskCreateResponse, TaskFileRef, TaskRepoRequest, TaskCancelResponse, TaskCancelOptions, AgentInfo, File, FileType, FileListParams, FileUpdateParams, FileCreateTextParams, Runtime, RuntimeListParams, Experiment, ExperimentListParams, ExperimentStatus, ExperimentGoal, ExperimentGoalComponent, ExperimentGoalDirection, ExperimentGoalGuard, JudgeGoalComponent, TelemetryGoalComponent, ExperimentArm, Recipe, RecipeListParams, RunnerSpec, RunnerDeployment, RunnerContext, RunnerRecipeSummary, RunnerIdentity, RunRequest, RunCaller, RunCallerLibrary, RunCallerPage, RunIdentityInput, GenAiSpan, GenAiSpanList, GenAiSpanAttributes, GenAiSpanStatus, Conversation, ConversationAgent, ConversationUsage, ConversationCost, ConversationMetrics, IntrospectionSpanAttributes, IntrospectionConversation, SpanAttributes, SpanResource, ConversationItemInclude, ConversationSortField, ConversationListParams, ConversationItemListParams, ConversationExportParams, Trajectory, TrajectoryRecord, TrajectoryToolCall, ConversationsMethod, SpanEvent, SpanKind, SpanStatus, ReadFormat, ReadWindowParams, IntrospectionEventName, IntrospectionEventEnvelope, ObservationPayload, PatternPayload, PatternAssignmentPayload, ClusteringRunPayload, FeedbackPayload, JudgementPayload, ObservationEvent, PatternEvent, PatternAssignmentEvent, ClusteringRunEvent, FeedbackEvent, JudgementEvent, Event, UnknownEvent, EventForName, EventSortField, EventListParams, MetricView, MetricAggregation, MetricFilterOperator, MetricInterval, MetricSpec, MetricDimension, MetricFilter, MetricTimeDimension, MetricOrderBy, MetricHaving, MetricQueryConfig, MetricQueryRequest, MetricDimensionValue, MetricResultValue, MetricResultRow, MetricEffectiveWindow, MetricQueryMeta, MetricQueryResponse, } from "@introspection-sdk/types";
+export { ConnectorsApi, ConnectionsApi, attachConnectors, } from "./resources/connectors.js";
+export { AnnotationsApi, ProjectLabelsApi, attachAnnotations, attachProjectLabels, } from "./resources/annotations.js";
+export type { AGUIEvent, BaseEvent, Interrupt, Message, ResumeEntry, RunAgentInput, Paginated, ListParams, Task, TaskCreateParams, TaskUpdateParams, TaskListParams, TaskKind, TaskStatus, TaskRunKind, TaskPrompt, TaskRun, TaskRunCreateParams, TaskRunResumeParams, TaskRunResponse, TaskCreateResponse, TaskFileRef, TaskRepoRequest, TaskCancelResponse, TaskCancelOptions, AgentInfo, File, FileType, FileListParams, FileUpdateParams, FileCreateTextParams, Runtime, RuntimeListParams, Experiment, ExperimentListParams, ExperimentStatus, ExperimentGoal, ExperimentGoalComponent, ExperimentGoalDirection, ExperimentGoalGuard, JudgeGoalComponent, TelemetryGoalComponent, ExperimentArm, Recipe, RecipeListParams, Connector, ConnectorApp, ConnectorAppListParams, ConnectorAuthMode, ConnectorStatus, ConnectorPersonServerMode, ConnectorApprovalPolicy, ConnectorCreateParams, ConnectorUpdateParams, ConnectorListParams, ConnectorAuthorizeParams, ConnectorAuthorizeResponse, Connection, ConnectionStatus, ConnectionSubjectType, ConnectionCreateSubjectType, ConnectionBrokerSubjectType, ConnectionCreateParams, ConnectionMissionConstraints, ConnectionTokenParams, ConnectionToken, ConnectionAuthorizationPending, ConnectionTokenResult, AnnotationTarget, AnnotationState, AnnotationListParams, AnnotationMutation, AnnotationEventOptions, ProjectLabel, ProjectLabelListParams, ProjectLabelCreate, ProjectLabelUpdate, RunnerSpec, RunnerDeployment, RunnerContext, RunnerRecipeSummary, RunnerIdentity, RunRequest, RunCaller, RunCallerLibrary, RunCallerPage, RunIdentityInput, GenAiSpan, GenAiSpanList, GenAiSpanAttributes, GenAiSpanStatus, Conversation, ConversationAgent, ConversationUsage, ConversationCost, ConversationMetrics, IntrospectionSpanAttributes, IntrospectionConversation, SpanAttributes, SpanResource, ConversationItemInclude, ConversationSortField, ConversationListParams, ConversationItemListParams, ConversationExportParams, Trajectory, TrajectoryRecord, TrajectoryToolCall, ConversationsMethod, SpanEvent, SpanKind, SpanStatus, ReadFormat, ReadWindowParams, IntrospectionEventName, IntrospectionEventEnvelope, ObservationPayload, PatternPayload, PatternAssignmentPayload, ClusteringRunPayload, FeedbackPayload, JudgementPayload, ObservationEvent, PatternEvent, PatternAssignmentEvent, ClusteringRunEvent, FeedbackEvent, JudgementEvent, Event, UnknownEvent, EventForName, EventSortField, EventListParams, MetricView, MetricAggregation, MetricFilterOperator, MetricInterval, MetricSpec, MetricDimension, MetricFilter, MetricTimeDimension, MetricOrderBy, MetricHaving, MetricQueryConfig, MetricQueryRequest, MetricDimensionValue, MetricResultValue, MetricResultRow, MetricEffectiveWindow, MetricQueryMeta, MetricQueryResponse, } from "@introspection-sdk/types";
 export { ConversationsMethods, IntrospectionEventNames, genAiConversationId, genAiInputMessages, genAiOutputMessages, isKnownEvent, } from "@introspection-sdk/types";
 export { IntrospectionAPIError, AuthenticationError, InsufficientScopeError, RunnerExpiredError, NotFoundError, ConflictError, ValidationError, RateLimitError, SandboxUnavailableError, NetworkError, apiErrorFromResponse, } from "@introspection-sdk/types";
 export type { GenAiAttributes, InputMessage, OutputMessage, SystemInstruction, ToolDefinition, TextPart, ToolCallRequestPart, ToolCallResponsePart, CompactionPart, MediaUrlPart, BinaryDataPart, MessagePart, } from "@introspection-sdk/types";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,GACX,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,QAAQ,GACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,WAAW,EACX,aAAa,EACb,SAAS,EACT,UAAU,EACV,IAAI,EACJ,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,OAAO,EACP,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,eAAe,EACf,8BAA8B,EAC9B,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,QAAQ,EACR,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -25,6 +25,8 @@ export { Runner } from "./runner.js";
 export { RuntimesApi, RuntimeHandle, attachRuntimes, } from "./resources/runtimes.js";
 export { ExperimentsApi, ExperimentHandle, attachExperiments, } from "./resources/experiments.js";
 export { RecipesApi, attachRecipes } from "./resources/recipes.js";
+export { ConnectorsApi, ConnectionsApi, attachConnectors, } from "./resources/connectors.js";
+export { AnnotationsApi, ProjectLabelsApi, attachAnnotations, attachProjectLabels, } from "./resources/annotations.js";
 export { ConversationsMethods, IntrospectionEventNames, genAiConversationId, genAiInputMessages, genAiOutputMessages, isKnownEvent, } from "@introspection-sdk/types";
 export { IntrospectionAPIError, AuthenticationError, InsufficientScopeError, RunnerExpiredError, NotFoundError, ConflictError, ValidationError, RateLimitError, SandboxUnavailableError, NetworkError, apiErrorFromResponse, } from "@introspection-sdk/types";
 export { toAttributes } from "@introspection-sdk/types";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,0DAA0D;AAC1D,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAiBnB,4DAA4D;AAC5D,gCAAgC;AAChC,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,QAAQ,GACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAQrD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,yBAAyB;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA4HnE,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAiBlC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,0DAA0D;AAC1D,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAiBnB,4DAA4D;AAC5D,gCAAgC;AAChC,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,QAAQ,GACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAQrD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,yBAAyB;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AA4JpC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAiBlC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/resources/annotations.d.ts

@@ -0,0 +1,28 @@
+import { type ProjectLabel, type ProjectLabelCreate, type ProjectLabelListParams, type ProjectLabelUpdate, type AnnotationListParams, type AnnotationEventOptions, type AnnotationMutation, type AnnotationState, type AnnotationTarget } from "@introspection-sdk/types";
+import type { HttpClient } from "../http.js";
+import { Paginator } from "../pagination.js";
+/** Managed project label catalog used by annotations. */
+export declare class ProjectLabelsApi {
+    private readonly dpHttp;
+    constructor(dpHttp: HttpClient);
+    list(params?: ProjectLabelListParams): Paginator<ProjectLabel>;
+    create(body: ProjectLabelCreate): Promise<ProjectLabel>;
+    get(slug: string): Promise<ProjectLabel>;
+    update(slug: string, body: ProjectLabelUpdate): Promise<ProjectLabel>;
+}
+/**
+ * Member-authored span annotations. Every create call appends exactly one
+ * event; labels and reviewers are complete snapshots.
+ */
+export declare class AnnotationsApi {
+    private readonly cpHttp;
+    private readonly dpHttp;
+    constructor(cpHttp: HttpClient, dpHttp: HttpClient);
+    list(params?: AnnotationListParams): Paginator<AnnotationState>;
+    /** Append exactly one annotation mutation. */
+    create(target: AnnotationTarget, mutation: AnnotationMutation, options?: AnnotationEventOptions): Promise<void>;
+    private resolveReviewerIds;
+}
+export declare function attachAnnotations(cpHttp: HttpClient, dpHttp: HttpClient): AnnotationsApi;
+export declare function attachProjectLabels(dpHttp: HttpClient): ProjectLabelsApi;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/resources/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/resources/annotations.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAC;AAuD7D,yDAAyD;AACzD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,IAAI,CAAC,MAAM,GAAE,sBAA2B,GAAG,SAAS,CAAC,YAAY,CAAC;IAYlE,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2BvD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAOxC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;CAatE;AAED;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU;IAGrC,IAAI,CAAC,MAAM,GAAE,oBAAyB,GAAG,SAAS,CAAC,eAAe,CAAC;IAkDnE,8CAA8C;IACxC,MAAM,CACV,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC;YAsBF,kBAAkB;CAyCjC;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,GACjB,cAAc,CAEhB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAExE"}

package/dist/resources/annotations.js

@@ -0,0 +1,198 @@
+import { randomBytes } from "node:crypto";
+import { ConflictError, NotFoundError, ValidationError, } from "@introspection-sdk/types";
+import { cursorPaginate } from "../pagination.js";
+function clientValidationError(message, code) {
+    return new ValidationError({
+        message,
+        status: 422,
+        code,
+        body: null,
+    });
+}
+/** Mint a time-ordered UUIDv7 without adding a runtime dependency. */
+function annotationEventId(now = Date.now()) {
+    const bytes = Buffer.allocUnsafe(16);
+    let timestamp = BigInt(now);
+    for (let index = 5; index >= 0; index--) {
+        bytes[index] = Number(timestamp & 0xffn);
+        timestamp >>= 8n;
+    }
+    randomBytes(10).copy(bytes, 6);
+    bytes[6] = (bytes[6] & 0x0f) | 0x70;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString("hex");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function normalizedEmails(emails) {
+    const values = typeof emails === "string" ? [emails] : emails;
+    const normalized = [
+        ...new Set(values.map((email) => email.trim().toLowerCase())),
+    ];
+    if (normalized.length === 0 ||
+        normalized.some((email) => email.length === 0)) {
+        throw clientValidationError("At least one non-empty reviewer email is required", "invalid_annotation_reviewer_email");
+    }
+    if (normalized.length > 64) {
+        throw clientValidationError("At most 64 reviewer emails are allowed", "too_many_annotation_reviewers");
+    }
+    return normalized;
+}
+/** Managed project label catalog used by annotations. */
+export class ProjectLabelsApi {
+    dpHttp;
+    constructor(dpHttp) {
+        this.dpHttp = dpHttp;
+    }
+    list(params = {}) {
+        return cursorPaginate((next) => this.dpHttp.request({
+            method: "GET",
+            path: "/v1/project-labels",
+            query: { ...params, next },
+        }), params.next);
+    }
+    create(body) {
+        const slug = body.slug.trim();
+        if (!slug || slug.length > 128) {
+            throw clientValidationError("Project label slug must contain 1 to 128 characters", "invalid_project_label_slug");
+        }
+        if (!/^#[0-9a-f]{6}$/i.test(body.color)) {
+            throw clientValidationError("Project label color must be a six-digit hex color such as #f97316", "invalid_project_label_color");
+        }
+        if (body.description != null && body.description.length > 2_000) {
+            throw clientValidationError("Project label description must not exceed 2000 characters", "invalid_project_label_description");
+        }
+        return this.dpHttp.request({
+            method: "POST",
+            path: "/v1/project-labels",
+            body: { ...body, slug, color: body.color.toLowerCase() },
+        });
+    }
+    get(slug) {
+        return this.dpHttp.request({
+            method: "GET",
+            path: `/v1/project-labels/${encodeURIComponent(slug)}`,
+        });
+    }
+    update(slug, body) {
+        if (body.description != null && body.description.length > 2_000) {
+            throw clientValidationError("Project label description must not exceed 2000 characters", "invalid_project_label_description");
+        }
+        return this.dpHttp.request({
+            method: "PATCH",
+            path: `/v1/project-labels/${encodeURIComponent(slug)}`,
+            body,
+        });
+    }
+}
+/**
+ * Member-authored span annotations. Every create call appends exactly one
+ * event; labels and reviewers are complete snapshots.
+ */
+export class AnnotationsApi {
+    cpHttp;
+    dpHttp;
+    constructor(cpHttp, dpHttp) {
+        this.cpHttp = cpHttp;
+        this.dpHttp = dpHttp;
+    }
+    list(params = {}) {
+        if (params.annotated_by_member_id && params.annotated_by_email) {
+            throw clientValidationError("Use annotated_by_member_id or annotated_by_email, not both", "conflicting_annotation_annotator_filters");
+        }
+        if (params.assignee_member_id && params.assigned_to_email) {
+            throw clientValidationError("Use assignee_member_id or assigned_to_email, not both", "conflicting_annotation_assignee_filters");
+        }
+        const { annotated_by_email, assigned_to_email, ...wireParams } = params;
+        let resolvedFilters;
+        const resolveFilters = () => {
+            resolvedFilters ??= (async () => {
+                const emails = [annotated_by_email, assigned_to_email].filter((email) => Boolean(email));
+                const ids = emails.length ? await this.resolveReviewerIds(emails) : [];
+                const sameEmail = annotated_by_email !== undefined &&
+                    assigned_to_email !== undefined &&
+                    annotated_by_email.trim().toLowerCase() ===
+                        assigned_to_email.trim().toLowerCase();
+                return {
+                    ...wireParams,
+                    ...(annotated_by_email ? { annotated_by_member_id: ids[0] } : {}),
+                    ...(assigned_to_email
+                        ? {
+                            assignee_member_id: ids[annotated_by_email && !sameEmail ? 1 : 0],
+                        }
+                        : {}),
+                };
+            })();
+            return resolvedFilters;
+        };
+        return cursorPaginate(async (next) => this.dpHttp.request({
+            method: "GET",
+            path: "/v1/annotations",
+            query: { ...(await resolveFilters()), next },
+        }), params.next);
+    }
+    /** Append exactly one annotation mutation. */
+    async create(target, mutation, options = {}) {
+        const wireMutation = mutation.reviewerEmails !== undefined
+            ? {
+                assignee_member_ids: mutation.reviewerEmails.length === 0
+                    ? []
+                    : await this.resolveReviewerIds(mutation.reviewerEmails),
+            }
+            : mutation;
+        return this.dpHttp.request({
+            method: "POST",
+            path: "/v1/annotations",
+            body: {
+                ...target,
+                event_id: options.event_id ?? annotationEventId(),
+                ...wireMutation,
+            },
+            expect: "empty",
+        });
+    }
+    async resolveReviewerIds(emails) {
+        const requested = normalizedEmails(emails);
+        const matches = new Map();
+        for (const email of requested)
+            matches.set(email, []);
+        const members = cursorPaginate((next) => this.cpHttp.request({
+            method: "GET",
+            path: "/v1/members",
+            query: { limit: 1000, member_type: "business", next },
+        }));
+        for await (const member of members) {
+            if (member.is_deactivated || !member.email)
+                continue;
+            matches.get(member.email.trim().toLowerCase())?.push(member);
+        }
+        const memberIds = [];
+        for (const email of requested) {
+            const candidates = matches.get(email) ?? [];
+            if (candidates.length === 0) {
+                throw new NotFoundError({
+                    message: `No active domain expert found for '${email}'`,
+                    status: 404,
+                    code: "annotation_reviewer_not_found",
+                    body: { email },
+                });
+            }
+            if (candidates.length > 1) {
+                throw new ConflictError({
+                    message: `Multiple active domain experts found for '${email}'`,
+                    status: 409,
+                    code: "annotation_reviewer_ambiguous",
+                    body: { email, member_ids: candidates.map((member) => member.id) },
+                });
+            }
+            memberIds.push(candidates[0].id);
+        }
+        return memberIds;
+    }
+}
+export function attachAnnotations(cpHttp, dpHttp) {
+    return new AnnotationsApi(cpHttp, dpHttp);
+}
+export function attachProjectLabels(dpHttp) {
+    return new ProjectLabelsApi(dpHttp);
+}
+//# sourceMappingURL=annotations.js.map

package/dist/resources/annotations.js.map

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

package/dist/resources/connectors.d.ts

@@ -0,0 +1,94 @@
+import type { Connection, ConnectionCreateParams, ConnectionTokenParams, ConnectionTokenResult, Connector, ConnectorApp, ConnectorAppListParams, ConnectorAuthorizeParams, ConnectorAuthorizeResponse, ConnectorCreateParams, ConnectorListParams, ConnectorUpdateParams, CursorParams, Uuid } from "@introspection-sdk/types";
+import type { HttpClient } from "../http.js";
+import { Paginator } from "../pagination.js";
+/**
+ * Connections nested under a connector
+ * (`/v1/connectors/{connector_id}/connections`) — one authorized subject
+ * each (a Slack workspace, a person, an app credential). Every method
+ * takes the connector id as its first argument; there is no PATCH on
+ * connections, and the platform never serializes access/refresh tokens.
+ */
+export declare class ConnectionsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List a connector's connections. `await` the result for the first
+     * page, or `for await` it to stream every connection across pages
+     * (fetched lazily; stop early to stop fetching).
+     */
+    list(connectorId: Uuid, params?: CursorParams): Paginator<Connection>;
+    /**
+     * Register a connection from a token the caller already holds
+     * (registered mode). For the consent flow use
+     * {@link ConnectorsApi.authorize} instead — the callback creates the
+     * connection server-side.
+     */
+    create(connectorId: Uuid, params: ConnectionCreateParams): Promise<Connection>;
+    get(connectorId: Uuid, connectionId: Uuid): Promise<Connection>;
+    /**
+     * Revoke a connection. Named `revoke` rather than `delete` because it
+     * destroys the provider token behind it — the subject must re-consent
+     * to connect again.
+     */
+    revoke(connectorId: Uuid, connectionId: Uuid): Promise<void>;
+    /**
+     * Resolve a connector credential for the authenticated subject. For a
+     * `person_authorized` connector this may return `authorization_pending`
+     * with the mission and approval URL instead of a token.
+     */
+    getToken(connectorId: Uuid, params?: ConnectionTokenParams): Promise<ConnectionTokenResult>;
+}
+/**
+ * CRUD on `/v1/connectors` plus the consent-URL mint
+ * (`POST /v1/oauth/connections/authorize`), with connections nested as
+ * {@link ConnectionsApi} under `.connections`.
+ *
+ * Connector CRUD uses the project carried by the authenticated credential.
+ * `client_secret` / `signing_secret` are write-only — accepted on create
+ * and update, absent from every read.
+ *
+ */
+export declare class ConnectorsApi {
+    private readonly http;
+    readonly connections: ConnectionsApi;
+    constructor(http: HttpClient);
+    /**
+     * List connectors matching `params`. `await` the result for the first
+     * page, or `for await` it to stream every connector across pages
+     * (fetched lazily — `limit` sets the page size, `next` the starting
+     * cursor; stop early to stop fetching).
+     */
+    list(params?: ConnectorListParams): Paginator<Connector>;
+    /** Create a connector. Idempotent on `slug` — a repeat POST returns the live row. */
+    create(params: ConnectorCreateParams): Promise<Connector>;
+    get(connectorId: Uuid): Promise<Connector>;
+    update(connectorId: Uuid, params: ConnectorUpdateParams): Promise<Connector>;
+    /** Soft-delete a connector; the server revokes its connections. */
+    delete(connectorId: Uuid): Promise<void>;
+    /**
+     * Search the provider's application catalogue. Pipedream connectors use
+     * the returned slug when minting an application-specific Connect Link.
+     */
+    listApps(connectorId: Uuid, params?: ConnectorAppListParams): Promise<ConnectorApp[]>;
+    /**
+     * Mint a consent URL for a connector — the link a Business hands its
+     * customer to connect (e.g. install the Slack app into a workspace).
+     *
+     * The URL embeds a single-use `state`, so it must not be cached: two
+     * calls give two different URLs, and each is spent on first use. Raise
+     * `expires_in` when handing the link to someone else to open later. A
+     * chat-provider connector (`connector.requires_runtime === true`) 422s
+     * unless `runtime` names the agent that replies.
+     *
+     * Pipedream connectors additionally require `app`, selected from
+     * {@link listApps}. `allow_progressive_scopes` is optional and defaults to
+     * false, matching Pipedream's Connect API.
+     *
+     * Passing `params.identity` mints a `customer` member for the asserted
+     * end user, so it can raise a {@link ConflictError} (409) when the org has
+     * reached its member limit — a plan conflict, not back-pressure.
+     */
+    authorize(connectorId: Uuid, params?: ConnectorAuthorizeParams): Promise<ConnectorAuthorizeResponse>;
+}
+export declare function attachConnectors(http: HttpClient): ConnectorsApi;
+//# sourceMappingURL=connectors.d.ts.map

package/dist/resources/connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../../src/resources/connectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EAEZ,IAAI,EACL,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAC;AAE7D;;;;;;GAMG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,GAAE,YAAiB,GAAG,SAAS,CAAC,UAAU,CAAC;IAYzE;;;;;OAKG;IACH,MAAM,CACJ,WAAW,EAAE,IAAI,EACjB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC;IAQtB,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAO/D;;;;OAIG;IACH,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D;;;;OAIG;IACH,QAAQ,CACN,WAAW,EAAE,IAAI,EACjB,MAAM,GAAE,qBAA0B,GACjC,OAAO,CAAC,qBAAqB,CAAC;CAOlC;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;gBAER,IAAI,EAAE,UAAU;IAI7C;;;;;OAKG;IACH,IAAI,CAAC,MAAM,GAAE,mBAAwB,GAAG,SAAS,CAAC,SAAS,CAAC;IAY5D,qFAAqF;IACrF,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC;IAQzD,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC;IAO1C,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC;IAQ5E,mEAAmE;IACnE,MAAM,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;;OAGG;IACG,QAAQ,CACZ,WAAW,EAAE,IAAI,EACjB,MAAM,GAAE,sBAA2B,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC;IAS1B;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CACP,WAAW,EAAE,IAAI,EACjB,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,0BAA0B,CAAC;CAOvC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAEhE"}

package/dist/resources/connectors.js

@@ -0,0 +1,170 @@
+import { cursorPaginate } from "../pagination.js";
+/**
+ * Connections nested under a connector
+ * (`/v1/connectors/{connector_id}/connections`) — one authorized subject
+ * each (a Slack workspace, a person, an app credential). Every method
+ * takes the connector id as its first argument; there is no PATCH on
+ * connections, and the platform never serializes access/refresh tokens.
+ */
+export class ConnectionsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List a connector's connections. `await` the result for the first
+     * page, or `for await` it to stream every connection across pages
+     * (fetched lazily; stop early to stop fetching).
+     */
+    list(connectorId, params = {}) {
+        return cursorPaginate((next) => this.http.request({
+            method: "GET",
+            path: `/v1/connectors/${encodeURIComponent(connectorId)}/connections`,
+            query: { ...params, next },
+        }), params.next);
+    }
+    /**
+     * Register a connection from a token the caller already holds
+     * (registered mode). For the consent flow use
+     * {@link ConnectorsApi.authorize} instead — the callback creates the
+     * connection server-side.
+     */
+    create(connectorId, params) {
+        return this.http.request({
+            method: "POST",
+            path: `/v1/connectors/${encodeURIComponent(connectorId)}/connections`,
+            body: params,
+        });
+    }
+    get(connectorId, connectionId) {
+        return this.http.request({
+            method: "GET",
+            path: `/v1/connectors/${encodeURIComponent(connectorId)}/connections/${encodeURIComponent(connectionId)}`,
+        });
+    }
+    /**
+     * Revoke a connection. Named `revoke` rather than `delete` because it
+     * destroys the provider token behind it — the subject must re-consent
+     * to connect again.
+     */
+    revoke(connectorId, connectionId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/v1/connectors/${encodeURIComponent(connectorId)}/connections/${encodeURIComponent(connectionId)}`,
+            expect: "empty",
+        });
+    }
+    /**
+     * Resolve a connector credential for the authenticated subject. For a
+     * `person_authorized` connector this may return `authorization_pending`
+     * with the mission and approval URL instead of a token.
+     */
+    getToken(connectorId, params = {}) {
+        return this.http.request({
+            method: "POST",
+            path: "/v1/oauth/connections/token",
+            body: { connector_id: connectorId, ...params },
+        });
+    }
+}
+/**
+ * CRUD on `/v1/connectors` plus the consent-URL mint
+ * (`POST /v1/oauth/connections/authorize`), with connections nested as
+ * {@link ConnectionsApi} under `.connections`.
+ *
+ * Connector CRUD uses the project carried by the authenticated credential.
+ * `client_secret` / `signing_secret` are write-only — accepted on create
+ * and update, absent from every read.
+ *
+ */
+export class ConnectorsApi {
+    http;
+    connections;
+    constructor(http) {
+        this.http = http;
+        this.connections = new ConnectionsApi(http);
+    }
+    /**
+     * List connectors matching `params`. `await` the result for the first
+     * page, or `for await` it to stream every connector across pages
+     * (fetched lazily — `limit` sets the page size, `next` the starting
+     * cursor; stop early to stop fetching).
+     */
+    list(params = {}) {
+        return cursorPaginate((next) => this.http.request({
+            method: "GET",
+            path: "/v1/connectors",
+            query: { ...params, next },
+        }), params.next);
+    }
+    /** Create a connector. Idempotent on `slug` — a repeat POST returns the live row. */
+    create(params) {
+        return this.http.request({
+            method: "POST",
+            path: "/v1/connectors",
+            body: params,
+        });
+    }
+    get(connectorId) {
+        return this.http.request({
+            method: "GET",
+            path: `/v1/connectors/${encodeURIComponent(connectorId)}`,
+        });
+    }
+    update(connectorId, params) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/v1/connectors/${encodeURIComponent(connectorId)}`,
+            body: params,
+        });
+    }
+    /** Soft-delete a connector; the server revokes its connections. */
+    delete(connectorId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/v1/connectors/${encodeURIComponent(connectorId)}`,
+            expect: "empty",
+        });
+    }
+    /**
+     * Search the provider's application catalogue. Pipedream connectors use
+     * the returned slug when minting an application-specific Connect Link.
+     */
+    async listApps(connectorId, params = {}) {
+        const response = await this.http.request({
+            method: "GET",
+            path: `/v1/connectors/${encodeURIComponent(connectorId)}/apps`,
+            query: params,
+        });
+        return response.data;
+    }
+    /**
+     * Mint a consent URL for a connector — the link a Business hands its
+     * customer to connect (e.g. install the Slack app into a workspace).
+     *
+     * The URL embeds a single-use `state`, so it must not be cached: two
+     * calls give two different URLs, and each is spent on first use. Raise
+     * `expires_in` when handing the link to someone else to open later. A
+     * chat-provider connector (`connector.requires_runtime === true`) 422s
+     * unless `runtime` names the agent that replies.
+     *
+     * Pipedream connectors additionally require `app`, selected from
+     * {@link listApps}. `allow_progressive_scopes` is optional and defaults to
+     * false, matching Pipedream's Connect API.
+     *
+     * Passing `params.identity` mints a `customer` member for the asserted
+     * end user, so it can raise a {@link ConflictError} (409) when the org has
+     * reached its member limit — a plan conflict, not back-pressure.
+     */
+    authorize(connectorId, params = {}) {
+        return this.http.request({
+            method: "POST",
+            path: "/v1/oauth/connections/authorize",
+            body: { connector_id: connectorId, ...params },
+        });
+    }
+}
+export function attachConnectors(http) {
+    return new ConnectorsApi(http);
+}
+//# sourceMappingURL=connectors.js.map

package/dist/resources/connectors.js.map

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

package/dist/resources/experiments.d.ts

@@ -4,12 +4,9 @@ import type { IntrospectionClient } from "../client.js";
 import { Paginator } from "../pagination.js";
 import { Runner } from "../runner.js";
 /**
- * Read access and lifecycle for `/v1/experiments` on the CP.
- *
- * Lookup and lifecycle only: a runner brackets its own execution, resolving
- * the experiment and then `start` / `end` / `cancel` around the work it is
- * being measured on. Authoring an experiment is a project-authoring act and
- * lives in the CLI.
+ * CRUD, lifecycle, and execution for `/v1/experiments` on the CP. Create and
+ * update accept the exact Control Plane request document so its schema remains
+ * the source of truth.
  */
 export declare class ExperimentsApi {
     private readonly http;
@@ -23,6 +20,9 @@ export declare class ExperimentsApi {
      */
     list(params?: ExperimentListParams): Paginator<Experiment>;
     get(id: Uuid): Promise<Experiment>;
+    create(document: Record<string, unknown>): Promise<Experiment>;
+    update(id: Uuid, document: Record<string, unknown>, project?: string): Promise<Experiment>;
+    delete(id: Uuid, project?: string): Promise<void>;
     startById(id: Uuid): Promise<Experiment>;
     endById(id: Uuid): Promise<Experiment>;
     cancelById(id: Uuid): Promise<Experiment>;

package/dist/resources/experiments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experiments.d.ts","sourceRoot":"","sources":["../../src/resources/experiments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EAEpB,UAAU,EAEV,IAAI,EACL,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAqB,MAAM,cAAc,CAAC;AAyBzD;;;;;;;GAOG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,mBAAmB;IAG9C;;;;;OAKG;IACH,IAAI,CAAC,MAAM,GAAE,oBAAyB,GAAG,SAAS,CAAC,UAAU,CAAC;IAY9D,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAOlC,SAAS,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAQxC,OAAO,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAQtC,UAAU,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAQnC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAa5D;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBADF,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,IAAI;IAG3B,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAI5B,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IAI1B,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;CAG9B;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,EAAE,EAAE,IAAI,KAAK,gBAAgB,CAAC;AAErE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,UAAU,GACf,cAAc,GAAG,uBAAuB,CAY1C"}
+{"version":3,"file":"experiments.d.ts","sourceRoot":"","sources":["../../src/resources/experiments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EAEpB,UAAU,EAEV,IAAI,EACL,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAqB,MAAM,cAAc,CAAC;AAyBzD;;;;GAIG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,mBAAmB;IAG9C;;;;;OAKG;IACH,IAAI,CAAC,MAAM,GAAE,oBAAyB,GAAG,SAAS,CAAC,UAAU,CAAC;IAY9D,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAOlC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ9D,MAAM,CACJ,EAAE,EAAE,IAAI,EACR,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC;IAStB,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,SAAS,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAQxC,OAAO,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAQtC,UAAU,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAQnC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAa5D;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBADF,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,IAAI;IAG3B,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAI5B,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IAI1B,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;CAG9B;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,EAAE,EAAE,IAAI,KAAK,gBAAgB,CAAC;AAErE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,UAAU,GACf,cAAc,GAAG,uBAAuB,CAe1C"}

package/dist/resources/experiments.js

@@ -17,12 +17,9 @@ function toRunBody(opts) {
     return out;
 }
 /**
- * Read access and lifecycle for `/v1/experiments` on the CP.
- *
- * Lookup and lifecycle only: a runner brackets its own execution, resolving
- * the experiment and then `start` / `end` / `cancel` around the work it is
- * being measured on. Authoring an experiment is a project-authoring act and
- * lives in the CLI.
+ * CRUD, lifecycle, and execution for `/v1/experiments` on the CP. Create and
+ * update accept the exact Control Plane request document so its schema remains
+ * the source of truth.
  */
 export class ExperimentsApi {
     http;
@@ -50,6 +47,29 @@ export class ExperimentsApi {
             path: `/v1/experiments/${encodeURIComponent(id)}`,
         });
     }
+    create(document) {
+        return this.http.request({
+            method: "POST",
+            path: "/v1/experiments",
+            body: document,
+        });
+    }
+    update(id, document, project) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/v1/experiments/${encodeURIComponent(id)}`,
+            query: project ? { project } : undefined,
+            body: document,
+        });
+    }
+    delete(id, project) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/v1/experiments/${encodeURIComponent(id)}`,
+            query: project ? { project } : undefined,
+            expect: "empty",
+        });
+    }
     startById(id) {
         return this.http.request({
             method: "POST",
@@ -111,6 +131,9 @@ export function attachExperiments(client, http) {
     const hybrid = factory;
     hybrid.list = api.list.bind(api);
     hybrid.get = api.get.bind(api);
+    hybrid.create = api.create.bind(api);
+    hybrid.update = api.update.bind(api);
+    hybrid.delete = api.delete.bind(api);
     hybrid.startById = api.startById.bind(api);
     hybrid.endById = api.endById.bind(api);
     hybrid.cancelById = api.cancelById.bind(api);

package/dist/resources/experiments.js.map

@@ -1 +1 @@
-{"version":3,"file":"experiments.js","sourceRoot":"","sources":["../../src/resources/experiments.ts"],"names":[],"mappings":"AAUA,OAAO,EAAa,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAqB,MAAM,cAAc,CAAC;AAczD,SAAS,SAAS,CAAC,IAAiB;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,GAAG,GAA6B,EAAE,CAAC;IACzC,IAAI,IAAI,CAAC,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACpE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACvE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACrD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IAEN;IACA;IAFnB,YACmB,IAAgB,EAChB,MAA2B;QAD3B,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAqB;IAC3C,CAAC;IAEJ;;;;;OAKG;IACH,IAAI,CAAC,SAA+B,EAAE;QACpC,OAAO,cAAc,CACnB,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,IAAI,CAAC,OAAO,CAAwB;YACvC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAwC;SACjE,CAAC,EACJ,MAAM,CAAC,IAAI,CACZ,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,EAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa;YACnC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,EAAQ;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa;YACnC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,QAAQ;YACvD,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,EAAQ;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa;YACnC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,MAAM;YACrD,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,EAAQ;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa;YACnC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,SAAS;YACxD,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAQ,EAAE,IAAiB;QACvC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa;YAC/C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,MAAM;YACrD,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE;SAC5B,CAAC,CAAC;QACH,MAAM,MAAM,GAAiB;YAC3B,IAAI,EAAE,YAAY;YAClB,EAAE;YACF,OAAO,EAAE,IAAI;SACd,CAAC;QACF,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,GAAmB,EACnB,EAAQ;QADR,QAAG,GAAH,GAAG,CAAgB;QACnB,OAAE,GAAF,EAAE,CAAM;IACxB,CAAC;IAEJ,GAAG,CAAC,IAAiB;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;CACF;AAID,MAAM,UAAU,iBAAiB,CAC/B,MAA2B,EAC3B,IAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,OAAO,GAA4B,CAAC,EAAQ,EAAE,EAAE,CACpD,IAAI,gBAAgB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,OAAmD,CAAC;IACnE,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"experiments.js","sourceRoot":"","sources":["../../src/resources/experiments.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -22,7 +22,7 @@ export declare const DEFAULT_SERVICE_NAME = "introspection-client";
  *
  * Caller headers are merged last so they can override either.
  */
-export declare const USER_AGENT = "introspection-sdk/0.21.1";
+export declare const USER_AGENT = "introspection-sdk/0.23.0";
 /**
  * The OTLP HTTP transport takes the client's user agent as a dedicated option
  * rather than a header: it assigns `headers['User-Agent']` unconditionally
@@ -31,7 +31,7 @@ export declare const USER_AGENT = "introspection-sdk/0.21.1";
  * token, and exports arrive attributable to a client and a release.
  */
 export declare const otlpUserAgent: {
-    readonly userAgent: "introspection-sdk/0.21.1";
+    readonly userAgent: "introspection-sdk/0.23.0";
 };
 export declare function exporterHeaders(token: string | undefined, additionalHeaders?: Record<string, string>): Record<string, string>;
 /**

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Version information for introspection-sdk package. */
-export declare const VERSION = "0.21.1";
+export declare const VERSION = "0.23.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Version information for introspection-sdk package. */
-export const VERSION = "0.21.1";
+export const VERSION = "0.23.0";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@introspection-sdk/introspection-node",
-  "version": "0.21.1",
+  "version": "0.23.0",
   "license": "Apache-2.0",
   "description": "Introspection observability SDK for Node.js",
   "engines": {
@@ -31,7 +31,7 @@
     "dist/"
   ],
   "devDependencies": {
-    "@earendil-works/pi-agent-core": "^0.84.1",
+    "@earendil-works/pi-agent-core": "^0.84.3",
     "@opentelemetry/api-logs": "^0.221.0",
     "@opentelemetry/context-async-hooks": "^2.10.0",
     "@opentelemetry/core": "^2.10.0",
@@ -100,10 +100,10 @@
     "@opentelemetry/api": "^1.9.1",
     "https-proxy-agent": "^7.0.6",
     "proxy-from-env": "^2.1.0",
-    "@introspection-sdk/http": "0.21.1",
-    "@introspection-sdk/types": "0.21.1",
-    "@introspection-sdk/introspection-proxy": "0.21.1",
-    "@introspection-sdk/introspection-pi": "0.21.1"
+    "@introspection-sdk/http": "0.23.0",
+    "@introspection-sdk/introspection-pi": "0.23.0",
+    "@introspection-sdk/introspection-proxy": "0.23.0",
+    "@introspection-sdk/types": "0.23.0"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",