@skaile/workspaces 0.8.5 → 0.9.1

package/dist/connectors/src/connector-manager.d.ts

@@ -1,18 +1,22 @@
 /**
- * ConnectorManager — central coordinator for connector lifecycle, dispatch,
- * and tool generation. Connectors do not mount to the filesystem; for
- * filesystem projection use `MountManager` instead.
+ * ConnectorManager — unified lifecycle & mount-target allocation.
+ *
+ * Manages the full lifecycle of every connector declared in `skaile.yaml`,
+ * whether it exposes a `filesystem` face, a `tools` face, or both.
  *
  * @docLink packages/connectors/concepts#connector-manager
  */
 import type { CatalogEntry } from "@skaile/workspaces/core";
 import type { TelemetryProvider, Trace } from "@skaile/workspaces/telemetry";
 import type { ConnectorStatusEvent } from "@skaile/workspaces/types";
-import type { ConnectorAdapter, ConnectorChangeEvent, ConnectorDeclaration, ConnectorHandle, ConnectorInfo, ConnectorReport, RuntimeSkillDescriptor } from "./connector-types.js";
-import type { SecretProvider, SecretProviderChain } from "./secrets.js";
-import type { ConnectorContent, ConnectorEntry, ListOptions, OperationDescriptor, SearchOptions, SearchResult, WatchHandle, WatchOptions } from "./shared-types.js";
-interface ConnectedConnector {
-    adapter: ConnectorAdapter;
+import type { Connector, ConnectorChangeEvent, ConnectorDeclaration, ConnectorHandle, ConnectorStartupReport, RuntimeSkillDescriptor, TokenMediator } from "./connector-types.js";
+import type { PreMintedSecretProvider, SecretProvider, SecretProviderChain } from "./secrets.js";
+import type { ConnectorContent, ConnectorEntry, ListOptions, OperationDescriptor, SearchOptions, SearchResult, SyncOptions, SyncResult, WatchHandle, WatchOptions } from "./shared-types.js";
+/**
+ * Internal per-connector tracking record.
+ */
+interface ActiveConnector {
+    connector: Connector;
     handle: ConnectorHandle;
     declaration: ConnectorDeclaration;
     watchHandle?: WatchHandle;
@@ -23,17 +27,38 @@ interface LifecycleResult {
     error?: string;
     detail?: string;
 }
+export interface SyncConnectorResult {
+    id: string;
+    ok: boolean;
+    error?: string;
+}
 /**
- * Options for `ConnectorManager`. Pass as the second argument to the constructor.
+ * Options for the unified `ConnectorManager`. Pass as the second argument to the constructor.
  *
- * @example
- * ```typescript
- * const manager = new ConnectorManager(chain, {
- *   onStatusChange: (event) => transport.send(event),
- * });
- * ```
+ * Note: constructor signature is `new ConnectorManager(workspaceDir, opts?)` —
+ * `workspaceDir` comes first because mountable connectors need it.
+ * `secrets` moves into opts (was the first arg in the old `ConnectorManager`).
  */
 export interface ConnectorManagerOptions {
+    /**
+     * Secret provider (chain or bare) for resolving credential references in
+     * `describeFields()` and for passing to `Connector.connect()`.
+     */
+    secrets?: SecretProviderChain | SecretProvider;
+    /**
+     * Catalog entries for dynamic connector resolution (registry-first, catalog-fallback).
+     */
+    catalogEntries?: CatalogEntry[];
+    /**
+     * Backend token mediator — present for `auth: backend` filesystem-face connectors.
+     * Wrapped with pre-minted secrets when `preMintedSecrets` is also set.
+     */
+    tokenMediator?: TokenMediator;
+    /**
+     * Pre-minted credential store from `session_init`. When set, `auth: backend`
+     * connectors use this for the initial mint without a platform round-trip.
+     */
+    preMintedSecrets?: PreMintedSecretProvider;
     /**
      * Called whenever a connector's connection state changes.
      *
@@ -46,58 +71,98 @@ export interface ConnectorManagerOptions {
     telemetry?: TelemetryProvider;
     /** Optional active trace to attach connector spans to. */
     trace?: Trace;
-    /** Catalog entries for dynamic adapter resolution (registry-first, catalog-fallback). */
-    catalogEntries?: CatalogEntry[];
 }
 /**
- * Manages connection lifecycle, CRUD dispatch, skill catalog, and tool generation
- * for all connectors declared in `skaile.yaml`. Resolves adapters from the registry
- * or catalog. Accepts an optional `onStatusChange` callback for live status updates.
+ * `ConnectorManager` — manages the full lifecycle of all connectors declared
+ * in `skaile.yaml`, whether they expose a filesystem face, a tool face, or both.
+ *
+ * For filesystem-face connectors, the manager allocates a mount-target
+ * directory and passes it as `ctx.mountTarget`; the connector mounts its
+ * content there during `connect()`.
+ *
  * @docLink packages/connectors/concepts#connector-manager
  */
 export declare class ConnectorManager {
     private readonly opts;
-    private connectors;
+    private active;
+    readonly workspaceDir: string;
     private readonly chain?;
-    /** @deprecated Pass SecretProviderChain instead */
     private readonly secrets?;
     private readonly catalogEntries;
+    private readonly tokenMediator?;
+    private readonly preMintedSecrets?;
     private readonly mgrLog;
     /**
-     * @param chain - Optional SecretProviderChain (or legacy SecretProvider) for resolving
-     *   credential references. Pass a SecretProviderChain to enable field resolution via
-     *   describeFields(); a bare SecretProvider is accepted for backwards compatibility.
-     * @param opts - Optional manager options, e.g. onStatusChange callback.
+     * @param workspaceDir - Absolute (or relative) working directory. Filesystem-face
+     *   connectors mount into `<workspaceDir>/.mounts/<id>/` by default.
+     * @param opts - Optional configuration: secrets, catalogEntries, tokenMediator,
+     *   preMintedSecrets, onStatusChange, telemetry, trace.
+     */
+    constructor(workspaceDir: string, opts?: ConnectorManagerOptions);
+    /**
+     * Wrap the user-supplied `TokenMediator` so `reason: 'initial'` calls for an
+     * `auth: backend` connector first consult the pre-minted credentials. Falls
+     * back to the original mediator for refresh / retry-401 paths.
+     */
+    private buildWrappedMediator;
+    /**
+     * Resolve a connector by driver name: registry first, then catalog.
+     */
+    private resolveConnector;
+    /**
+     * Compute the absolute mount-target directory for a filesystem-face connector.
+     *
+     * - `local` driver + absolute source + no explicit target → bind directly to source
+     * - otherwise → `decl.mount.target ?? .mounts/<id>`, resolved relative to workspaceDir
+     */
+    private resolveMountTarget;
+    /**
+     * Build a `ConnectContext` for a connector, resolving fields and — for
+     * filesystem-face connectors — allocating the mount-target directory.
+     */
+    private buildConnectContext;
+    /**
+     * Span-wrapping helper for connector lifecycle calls.
      */
-    constructor(chain?: SecretProviderChain | SecretProvider, opts?: ConnectorManagerOptions);
-    private resolveAdapter;
-    private connectAdapter;
     private withSpan;
     /**
-     * Connect all declared connectors. resolveFields() is called automatically for
-     * adapters that implement describeFields().
+     * Connect all declared connectors. For each connector:
+     * 1. Resolves the `Connector` from the registry (or catalog).
+     * 2. Calls `setLogger` when available.
+     * 3. Resolves fields via `describeFields()` + secret chain.
+     * 4. For filesystem-face connectors: allocates mount-target dir, wraps mediator.
+     * 5. Calls `connector.connect(decl, ctx)`.
+     * 6. Tracks in the active map; emits `onStatusChange`.
+     *
+     * After the loop, if `options.failOnReadWriteError` is set and any read-write
+     * connector with a `mount` config failed → throws `ConnectorStartupError`
+     * (fail-fast lifecycle semantics for mountable connectors).
      *
-     * @returns ConnectorReport with per-connector success/error status.
+     * @param declarations - Connector declarations from `skaile.yaml`.
+     * @param options.failOnReadWriteError - Throw `ConnectorStartupError` if any
+     *   read-write connector fails. Read-only failures are always tolerated.
      */
-    connectAll(declarations: ConnectorDeclaration[]): Promise<ConnectorReport>;
-    /** Disconnect all connectors and stop all watchers. */
+    connectAll(declarations: ConnectorDeclaration[], options?: {
+        failOnReadWriteError?: boolean;
+    }): Promise<ConnectorStartupReport>;
+    /** Disconnect all connectors and stop all watchers. Best-effort — ignores disconnect errors. */
     disconnectAll(): Promise<void>;
     /**
-     * Connect a single connector (hot-plug). Resolves fields if the adapter declares them.
+     * Connect a single connector (hot-plug). Resolves fields and allocates
+     * mount target if the connector has a filesystem face.
      *
-     * @returns The ConnectorHandle for subsequent operations.
+     * @returns The `ConnectorHandle` for subsequent operations.
      */
     connect(declaration: ConnectorDeclaration): Promise<ConnectorHandle>;
     /**
-     * Disconnect a single connector by ID.
+     * Disconnect a single connector by ID and stop its watcher.
      *
      * @throws {Error} if the connector is not found
      */
     disconnect(id: string): Promise<void>;
     /**
-     * Start filesystem/operation watchers for all connected connectors.
-     *
-     * @returns Array of WatchHandle for cleanup (managed internally; use unwatchAll() to stop).
+     * Start watchers for all connected connectors that expose a `watch()` method.
+     * For filesystem-face connectors, nested-mount-path exclusion logic is applied.
      */
     watchAll(callback: (connectorId: string, event: ConnectorChangeEvent) => void, options?: WatchOptions): void;
     /** Stop all active watchers. */
@@ -106,42 +171,77 @@ export declare class ConnectorManager {
     closeAll(): Promise<LifecycleResult[]>;
     private runLifecycleHook;
     /**
-     * Return the ConnectorHandle for a connected connector.
+     * Return the internal `ActiveConnector` entry.
      *
-     * @returns The handle or undefined if not connected (internal; callers use get() which throws).
      * @throws {Error} if the connector is not found
      */
-    get(id: string): ConnectedConnector;
+    get(id: string): ActiveConnector;
     has(id: string): boolean;
     /**
      * Return summary info for all currently connected connectors.
-     *
-     * @returns Array of ConnectorInfo
      */
-    listConnectors(): ConnectorInfo[];
-    getOperations(id: string): OperationDescriptor[];
+    listConnectors(): Array<{
+        id: string;
+        driver: string;
+        access: "read-only" | "read-write";
+        mountPath?: string;
+    }>;
     /**
-     * Return RuntimeSkillDescriptors for all connected adapters that implement describeSkill().
-     * Adapters without describeSkill() receive a default descriptor built from id + driver.
-     *
-     * @returns Descriptors for all connected adapters.
+     * Lists git-backed connectors, surfacing the fields prompt-builders and the
+     * runner's wake-mid-401 refresh handler need.
      */
-    listSkills(): RuntimeSkillDescriptor[];
+    listGitConnectors(): Array<{
+        id: string;
+        source: string;
+        exposeAccessToken: boolean;
+        auth?: string;
+    }>;
     /**
-     * Return the rendered skill body for a single connector.
+     * Pull the latest remote state for a single filesystem-face connector.
      *
-     * @param id - Connector ID.
-     * @param shellAccess - When true, the adapter has access to shell tools; affects
-     *   the rendered CLI vs SDK tool call style in the skill body.
-     * @throws {Error} if not connected or adapter doesn't implement describeSkill
+     * @throws {Error} if connector is not found or has no filesystem face.
      */
-    loadSkill(id: string, shellAccess?: boolean): string;
+    sync(id: string, options?: SyncOptions): Promise<SyncResult>;
+    /**
+     * Pull the latest remote state for all connected filesystem-face connectors.
+     * Errors from individual connectors are captured and returned rather than thrown.
+     */
+    syncAll(options?: SyncOptions): Promise<SyncConnectorResult[]>;
+    /**
+     * Throw a consistent error when the tools face is absent.
+     */
+    private requireToolFace;
     read(id: string, path: string): Promise<ConnectorContent | null>;
     write(id: string, path: string, content: ConnectorContent): Promise<void>;
     delete(id: string, path: string): Promise<boolean>;
     list(id: string, path?: string, options?: ListOptions): Promise<ConnectorEntry[]>;
     search(id: string, query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Execute a custom operation on a connector's tool face.
+     *
+     * @throws {Error} if connector has no tool face, operation is unknown, or
+     *   a write operation is called on a read-only connector.
+     */
     executeOp(id: string, operation: string, args: Record<string, unknown>): Promise<string>;
+    /**
+     * Return the list of operations that a connector's tool face exposes.
+     * Returns an empty array when the connector has no tool face.
+     */
+    getOperations(id: string): OperationDescriptor[];
+    /**
+     * Return `RuntimeSkillDescriptor` for every connected connector.
+     * Uses `tools.describeSkill()` when available; falls back to `buildDefaultSkillDescriptor`.
+     */
+    listSkills(): RuntimeSkillDescriptor[];
+    /**
+     * Return the rendered skill body for a single connector.
+     *
+     * @param id - Connector ID.
+     * @param shellAccess - When true (default), CLI-style commands are used;
+     *   false renders SDK tool-call style.
+     * @throws {Error} if the connector is not found.
+     */
+    loadSkill(id: string, shellAccess?: boolean): string;
 }
 export {};
 //# sourceMappingURL=connector-manager.d.ts.map

package/dist/connectors/src/connector-manager.d.ts.map

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

package/dist/connectors/src/connector-prompt.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Merged prompt/tool-delivery module for the unified ConnectorManager.
+ *
+ * Combines the responsibilities of:
+ *   - `mount-prompt.ts`    — build a system-prompt section for filesystem-face connectors
+ *   - `connector-tools.ts` — build an SDK MCP server + system-prompt section for tool-face connectors
+ *
+ * Two exports:
+ *   1. `buildConnectorPromptSection(manager, options?)` — markdown string for the
+ *      agent's system prompt. Iterates the unified manager's connectors and:
+ *        - if `connector.filesystem` is present → emits a Mounts table row (ported from mount-prompt.ts)
+ *        - if `connector.tools` is present      → emits a Connectors list entry (ported from connector-tools.ts)
+ *        - dual-face connectors emit BOTH
+ *
+ *   2. `buildSdkConnectorTools(manager, options?)` — in-process MCP server config for
+ *      the Claude Agent SDK. Only tool-face connectors are wired to tools; filesystem-only
+ *      connectors are silently excluded.
+ *
+ * @docLink packages/connectors/concepts#connector-prompt
+ */
+import type { ConnectorManager } from "./connector-manager.js";
+/**
+ * Options for `buildSdkConnectorTools`.
+ * @docLink packages/connectors/api-reference#connector-tool-options
+ */
+export interface ConnectorToolOptions {
+    /** Pre-loaded `@anthropic-ai/claude-agent-sdk` instance (optional; auto-imported if absent). */
+    sdk?: any;
+    /** Pre-loaded `zod` namespace (optional; uses static import if absent). */
+    z?: any;
+    /** Whether the agent has shell access. Defaults to true. When true, `connector_exec` is omitted. */
+    shellAccess?: boolean;
+}
+/**
+ * Options for `buildConnectorPromptSection`.
+ * @docLink packages/connectors/api-reference#connector-prompt-options
+ */
+export interface ConnectorPromptOptions {
+    /** Whether the agent has shell access. Defaults to true. Affects CLI vs SDK tool examples. */
+    shellAccess?: boolean;
+}
+/**
+ * Build an in-process MCP server exposing connector tools for the Claude Agent SDK.
+ * Only connectors with a `tools` face are wired; filesystem-only connectors are excluded.
+ * Returns the server config to pass as `mcpServers` in the SDK query options.
+ * Returns `null` if `@anthropic-ai/claude-agent-sdk` is not available.
+ *
+ * @param manager - Connected unified `ConnectorManager`.
+ * @param options - Optional SDK/Zod overrides and shell access flag.
+ * @returns MCP server config object or `null`.
+ * @docLink packages/connectors/api-reference#build-sdk-connector-tools
+ */
+export declare function buildSdkConnectorTools(manager: ConnectorManager, options?: ConnectorToolOptions): Promise<object | null>;
+/**
+ * Build a markdown section describing all connectors for the agent's system prompt.
+ *
+ * Iterates the unified `ConnectorManager` and, per connector:
+ *   - **Filesystem face** (`connector.filesystem != null`) → emits a row in the
+ *     `## Mounts` table (id, driver, mount path, access level), plus Tier-1/Tier-2
+ *     git auth guidance for `git` connectors (ported from `mount-prompt.ts`).
+ *   - **Tool face** (`connector.tools != null`) → emits an entry in the
+ *     `## Connectors` section (ported from `connector-tools.ts`).
+ *   - Dual-face connectors appear in BOTH sections.
+ *
+ * @param manager - Connected unified `ConnectorManager`.
+ * @param options - Optional shell access flag.
+ * @returns Markdown string to append to the system prompt, or empty string when
+ *   no connectors are connected.
+ * @docLink packages/connectors/api-reference#build-connector-prompt-section
+ */
+export declare function buildConnectorPromptSection(manager: ConnectorManager, options?: ConnectorPromptOptions): string;
+//# sourceMappingURL=connector-prompt.d.ts.map

package/dist/connectors/src/connector-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-prompt.d.ts","sourceRoot":"","sources":["../../../connectors/src/connector-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,gGAAgG;IAChG,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,2EAA2E;IAC3E,CAAC,CAAC,EAAE,GAAG,CAAC;IACR,oGAAoG;IACpG,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,8FAA8F;IAC9F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwNxB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAsHR"}

package/dist/connectors/src/connector-registry.d.ts

@@ -1,12 +1,12 @@
 /**
- * Connector adapter registry.
+ * Connector registry.
  *
- * Built-in adapters from `@skaile/base-assets` are pre-registered here via
- * static ESM imports of their subpath exports so they are bundled into any
- * `bun --compile`'d agent binary AND any tsup-emitted ESM tarball. The
- * catalog path in `ConnectorManager.resolveAdapter`
- * (`await import(adapterPath)` of raw TS) is a dev-only fallback for
- * project-local third-party adapters — it cannot work inside a compiled
+ * Built-in connectors from `@skaile/workspaces/base-assets` are pre-registered
+ * here via static ESM imports of their subpath exports so they are bundled into
+ * any `bun --compile`'d agent binary AND any tsup-emitted ESM tarball. The
+ * catalog path in `ConnectorManager.resolveConnector`
+ * (`await import(connectorPath)` of raw TS) is a dev-only fallback for
+ * project-local third-party connectors — it cannot work inside a compiled
  * binary because bun cannot share its bundled symbol graph with
  * externally-loaded TS files (the import silently hangs while trying to
  * resolve `@skaile/workspaces/connectors` against an absent `node_modules`).
@@ -17,43 +17,42 @@
  * static analysis and silently drops the module from the binary.
  * Regression test: `tests/connector-tools-regression.test.ts`.
  */
-import type { ConnectorAdapter, ConnectorAdapterFactory } from "./connector-types.js";
+import type { Connector, ConnectorFactory } from "./connector-types.js";
 /**
- * Register a connector adapter factory under `name`. Overwrites any existing registration.
- * @param name - Adapter key used in `skaile.yaml` `driver:` fields (e.g. `"postgres"`, `"redis"`).
- * @param factory - Factory function that returns a fresh adapter instance.
- * @docLink packages/connectors/api-reference#register-connector-adapter
+ * Register a connector factory under `name`. Overwrites any existing registration.
+ * @param name - Connector key used in `skaile.yaml` `driver:` fields.
+ * @param factory - Factory function that returns a fresh `Connector` instance.
+ * @docLink packages/connectors/api-reference#register-connector
  */
-export declare function registerConnectorAdapter(name: string, factory: ConnectorAdapterFactory): void;
+export declare function registerConnector(name: string, factory: ConnectorFactory): void;
 /**
- * Get a connector adapter by name, calling its factory.
- * @param name - Adapter key (e.g. `"postgres"`).
- * @returns A fresh adapter instance.
- * @throws {Error} when no adapter is registered under `name`.
- * @docLink packages/connectors/api-reference#get-connector-adapter
+ * Get a connector by name, calling its factory to produce a fresh instance.
+ * @param name - Connector key (e.g. `"postgres"`).
+ * @returns A fresh `Connector` instance.
+ * @throws {Error} when no connector is registered under `name`.
+ * @docLink packages/connectors/api-reference#get-connector
  */
-export declare function getConnectorAdapter(name: string): ConnectorAdapter;
+export declare function getConnector(name: string): Connector;
 /**
- * Get a connector adapter by name, or return `undefined` if not registered.
- * @param name - Adapter key.
- * @returns A fresh adapter instance or `undefined`.
- * @docLink packages/connectors/api-reference#try-get-connector-adapter
+ * Get a connector by name, or return `undefined` if not registered.
+ * @param name - Connector key.
+ * @returns A fresh `Connector` instance or `undefined`.
+ * @docLink packages/connectors/api-reference#try-get-connector
  */
-export declare function tryGetConnectorAdapter(name: string): ConnectorAdapter | undefined;
+export declare function tryGetConnector(name: string): Connector | undefined;
 /**
- * Return the names of all currently registered connector adapters.
- * @returns Array of adapter keys (e.g. `["postgres", "redis", "memory"]`).
- * @docLink packages/connectors/api-reference#list-connector-adapters
+ * Return the names of all currently registered connectors.
+ * @returns Array of connector keys.
+ * @docLink packages/connectors/api-reference#list-connectors
  */
-export declare function listConnectorAdapters(): string[];
+export declare function listConnectors(): string[];
 /**
- * Register every built-in connector adapter from `@skaile/base-assets`.
+ * Register every built-in connector.
  *
- * Factories close over the statically-imported `createAdapter` functions
- * at the top of this file. Both `bun --compile` and tsup follow the
- * string-literal `import ... from "@skaile/workspaces/base-assets/connectors/..."`
- * specifiers at build time and bundle the adapter plus its transitive
- * `@skaile/*` deps. This sidesteps the catalog path's runtime TS-import hang.
+ * **Static import discipline.** Every subpath specifier in this file must be a
+ * string-literal `from "@skaile/workspaces/base-assets/connectors/<name>"` —
+ * never aliased through a variable. Indirection defeats `bun --compile`'s
+ * static analysis and silently drops the module from the binary.
  */
-export declare function registerBuiltinConnectorAdapters(): void;
+export declare function registerBuiltinConnectors(): void;
 //# sourceMappingURL=connector-registry.d.ts.map

package/dist/connectors/src/connector-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector-registry.d.ts","sourceRoot":"","sources":["../../../connectors/src/connector-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAsBtF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAE7F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAQlE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAGjF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAID;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAsBvD"}
+{"version":3,"file":"connector-registry.d.ts","sourceRoot":"","sources":["../../../connectors/src/connector-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAkCxE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAQpD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAID;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAkChD"}