stitchkit 0.88.0 → 0.89.0

package/dist/tools/connections/errors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Typed failures of the external-connection surface.
+ *
+ * These are deliberately not `AppError`s: a connection failure is not a
+ * contract error and must not be confused with one by an in-process caller.
+ * The reauthorization signal is distinct because it is recoverable — the
+ * application starts its existing flow — while every other status is terminal
+ * for the call.
+ */
+/** A `401`: the current credential was rejected and must be re-obtained. */
+export declare class ConnectionAuthorizationRequiredError extends Error {
+    readonly connectionName: string;
+    readonly instanceId: string;
+    constructor(connectionName: string, instanceId: string);
+}
+/** Any non-2xx response other than the reauthorization signal. */
+export declare class ConnectionRequestError extends Error {
+    readonly connectionName: string;
+    readonly status: number;
+    readonly body: string;
+    constructor(connectionName: string, status: number, body: string);
+}
+/** A URL the SSRF guard refused before any request left the process. */
+export declare class ConnectionUrlError extends Error {
+    readonly url: string;
+    constructor(message: string, url: string);
+}
+/** The mount would expose more foreign tools than its declared budget. */
+export declare class ConnectionBudgetExceededError extends Error {
+    readonly limit: number;
+    readonly actual: number;
+    constructor(limit: number, actual: number, unit?: string);
+}
+/**
+ * A request exceeded the connection's declared deadline. This is not exported
+ * from the public subexport; it is a typed boundary between the transport and
+ * the caller, so an application can still tell a timeout from a network error.
+ */
+export declare class ConnectionTimeoutError extends Error {
+    readonly connectionName: string;
+    readonly timeoutMs: number;
+    constructor(connectionName: string, timeoutMs: number);
+}
+/** A response exceeded the connection's declared byte ceiling. Internal. */
+export declare class ConnectionResponseTooLargeError extends Error {
+    readonly connectionName: string;
+    readonly maxBytes: number;
+    constructor(connectionName: string, maxBytes: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/tools/connections/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4EAA4E;AAC5E,qBAAa,oCAAqC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,YAAY,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAKrD;CACF;AAED,kEAAkE;AAClE,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAM/D;CACF;AAED,wEAAwE;AACxE,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,YAAY,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAIvC;CACF;AAED,0EAA0E;AAC1E,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAU,EAKxD;CACF;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAKpD;CACF;AAED,4EAA4E;AAC5E,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAKnD;CACF"}

package/dist/tools/connections/http.d.ts

@@ -0,0 +1,3 @@
+/** Redirects require a new host-owned connection declaration. */
+export declare function fetchConnection(target: URL | string, init: RequestInit, allowedHosts: ReadonlySet<string>, connectionName: string): Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/tools/connections/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/http.ts"],"names":[],"mappings":"AAGA,iEAAiE;AACjE,wBAAsB,eAAe,CACnC,MAAM,EAAE,GAAG,GAAG,MAAM,EACpB,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,EACjC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,QAAQ,CAAC,CAYnB"}

package/dist/tools/connections/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `stitchkit/tools/connections` — consume external MCP servers and OpenAPI
+ * specs as typed tools.
+ *
+ * This is a server-only subexport of `stitchkit/tools`: a connection pulls in no
+ * peer package into the stable tools import, but mounts its foreign operations
+ * as plain `RuntimeToolDefinition`s, so `mountAgent({ runtimeTools })` runs them
+ * through the same lifecycle, hooks and approval path as our own.
+ *
+ * A connection URL is application configuration, not a trust boundary: every
+ * outbound request is checked against the connection's own host (plus any
+ * explicit `allowHosts`), and credentials are resolved separately for each call.
+ */
+export { defineMcpClientConnection, defineOpenApiConnection } from './define.js';
+export { ConnectionAuthorizationRequiredError, ConnectionBudgetExceededError, ConnectionRequestError, ConnectionUrlError, } from './errors.js';
+export { mountConnections } from './mount.js';
+export type { ConnectionTokenProvider } from './runtime.js';
+export type { ConnectionBudget, ConnectionDefinition, ConnectionMountOptions, McpClientConnection, McpClientConnectionConfig, McpConnectionTransport, McpToolFilter, OpenApiConnection, OpenApiConnectionConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/connections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EACL,oCAAoC,EACpC,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,SAAS,CAAC"}