@introspection-sdk/introspection-node 0.21.0 → 0.22.0

package/dist/client.d.ts

@@ -18,6 +18,7 @@ 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";
 /**
  * Introspection REST client.
  *
@@ -60,6 +61,12 @@ 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;
     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;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;AACxE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAGnC;;;;;;;;;;;;;;;;;;;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;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;gBAEvB,OAAO,GAAE,0BAA+B;IAmDpD;;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/dist/client.js

@@ -17,6 +17,7 @@ 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 { DEV_TARGET_HEADER, resolveDevTarget } from "./dev-target.js";
 /**
  * Introspection REST client.
@@ -60,6 +61,12 @@ 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;
     constructor(options = {}) {
         const token = options.token || process.env.INTROSPECTION_TOKEN || "";
         const advanced = options.advanced || {};
@@ -99,6 +106,7 @@ export class IntrospectionClient {
         this.runtimes = attachRuntimes(this, this.cpHttp);
         this.experiments = attachExperiments(this, this.cpHttp);
         this.recipes = attachRecipes(this.cpHttp);
+        this.connectors = attachConnectors(this.cpHttp);
         sdkLogger.info(`IntrospectionClient initialized: api=${baseApiUrl}`);
     }
     /**

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAkC,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,cAAc,GAGf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,GAGlB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAmB,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,mBAAmB;IAC9B,2EAA2E;IAClE,MAAM,CAAa;IAC5B,mFAAmF;IAC1E,eAAe,CAAkB;IAE1C;;;;OAIG;IACM,QAAQ,CAAqC;IAEtD;;;OAGG;IACM,WAAW,CAA2C;IAE/D;;;;OAIG;IACM,OAAO,CAAa;IAE7B,YAAY,UAAsC,EAAE;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxC,MAAM,UAAU,GACd,QAAQ,CAAC,UAAU;YACnB,OAAO,CAAC,GAAG,CAAC,0BAA0B;YACtC,+BAA+B,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,IAAI,CACZ,+DAA+D,CAChE,CAAC;QACJ,CAAC;QAED,yEAAyE;QACzE,wEAAwE;QACxE,wEAAwE;QACxE,yEAAyE;QACzE,uEAAuE;QACvE,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;QACrC,yEAAyE;QACzE,kEAAkE;QAClE,yEAAyE;QACzE,uEAAuE;QACvE,sEAAsE;QACtE,sEAAsE;QACtE,MAAM,iBAAiB,GAAG;YACxB,YAAY,EAAE,UAAU;YACxB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,QAAQ,CAAC,iBAAiB;SAC9B,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,EAAE,GAAG,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAE1D,sEAAsE;QACtE,qEAAqE;QACrE,6DAA6D;QAC7D,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC;YAC3B,MAAM,EAAE,UAAU;YAClB,KAAK;YACL,iBAAiB,EAAE,IAAI,CAAC,eAAe,CAAC,iBAAiB;YACzD,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1C,SAAS,CAAC,IAAI,CAAC,wCAAwC,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAC7B,MAA4D;QAE5D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC3D,OAAO,IAAI,mBAAmB,CAAC;YAC7B,KAAK,EAAE,YAAY;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;SACjE,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,QAAQ;QACZ,kEAAkE;QAClE,gDAAgD;QAChD,SAAS,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -27,7 +27,8 @@ 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 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, ConnectorAuthMode, ConnectorStatus, ConnectorPersonServerMode, ConnectorApprovalPolicy, ConnectorCreateParams, ConnectorUpdateParams, ConnectorListParams, ConnectorAuthorizeParams, ConnectorAuthorizeResponse, Connection, ConnectionStatus, ConnectionSubjectType, ConnectionCreateSubjectType, ConnectionBrokerSubjectType, ConnectionCreateParams, ConnectionMissionConstraints, ConnectionTokenParams, ConnectionToken, ConnectionAuthorizationPending, ConnectionTokenResult, 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":"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"}

package/dist/index.js

@@ -25,6 +25,7 @@ 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 { 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;AAiJnC,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/connectors.d.ts

@@ -0,0 +1,85 @@
+import type { Connection, ConnectionCreateParams, ConnectionTokenParams, ConnectionTokenResult, Connector, 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>;
+    /**
+     * 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.
+     *
+     * 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,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;;;;;;;;;;;;;OAaG;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,154 @@
+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",
+        });
+    }
+    /**
+     * 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.
+     *
+     * 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/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.0";
+export declare const USER_AGENT = "introspection-sdk/0.22.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.0";
  * token, and exports arrive attributable to a client and a release.
  */
 export declare const otlpUserAgent: {
-    readonly userAgent: "introspection-sdk/0.21.0";
+    readonly userAgent: "introspection-sdk/0.22.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.0";
+export declare const VERSION = "0.22.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.0";
+export const VERSION = "0.22.0";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@introspection-sdk/introspection-node",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "license": "Apache-2.0",
   "description": "Introspection observability SDK for Node.js",
   "engines": {
@@ -45,8 +45,8 @@
     "@types/node": "^22.20.1",
     "eslint": "^9.39.5",
     "typescript": "5.9.3",
-    "@repo/typescript-config": "0.0.0",
-    "@repo/eslint-config": "0.0.0"
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-agent-core": ">=0.75.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.0",
-    "@introspection-sdk/introspection-pi": "0.21.0",
-    "@introspection-sdk/types": "0.21.0",
-    "@introspection-sdk/introspection-proxy": "0.21.0"
+    "@introspection-sdk/http": "0.22.0",
+    "@introspection-sdk/introspection-pi": "0.22.0",
+    "@introspection-sdk/introspection-proxy": "0.22.0",
+    "@introspection-sdk/types": "0.22.0"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",