@thyn-ai/sqai 0.1.5 → 0.1.6

package/NOTICE

@@ -0,0 +1,8 @@
+SQAI — Structured Query AI
+Copyright 2026 Thyn (thyn.ai)
+
+This product includes software developed by Thyn (https://thyn.ai).
+
+SQAI is built on the Algenta deterministic execution engine
+(https://algenta.ai) and consumes the published algenta-sdk (npm) and
+algenta-core (PyPI) packages.

package/README.md

@@ -0,0 +1,13 @@
+# @thyn-ai/sqai
+
+TypeScript SDK for SQAI, a deterministic, read-only structured-data tool for AI agents.
+
+Install:
+
+```bash
+npm install @thyn-ai/sqai
+```
+
+Use `createSQAI()` to connect local files or in-memory rows and ask governed queries. Run `sqai login` once before dispatching deterministic computations through the managed SQAI runtime.
+
+Docs: https://docs.sqai.com

package/dist/index.cjs

@@ -35,6 +35,8 @@ __export(index_exports, {
   ResultStore: () => ResultStore,
   RuntimeProvisioner: () => RuntimeProvisioner,
   SQAI: () => SQAI,
+  SQAI_CONNECTOR_TYPES: () => SQAI_CONNECTOR_TYPES,
+  SQAI_CONNECTOR_TYPE_ALIASES: () => SQAI_CONNECTOR_TYPE_ALIASES,
   SQAI_ERROR_CODES: () => SQAI_ERROR_CODES,
   SqaiError: () => SqaiError,
   computationHash: () => computationHash,
@@ -166,13 +168,13 @@ var SQAI_ERROR_CODES = [
   "contract_mismatch",
   "invalid_intent"
 ];
-var RETRYABLE_ALGENTA_CODES = /* @__PURE__ */ new Set([
+var RETRYABLE_ENGINE_CODES = /* @__PURE__ */ new Set([
   "network_error",
   "timeout",
   "rate_limited",
   "service_unavailable"
 ]);
-function fromAlgentaError(error) {
+function fromEngineError(error) {
   if (error instanceof SqaiError) {
     return error;
   }
@@ -182,7 +184,7 @@ function fromAlgentaError(error) {
   const details = errorLike.details && typeof errorLike.details === "object" ? errorLike.details : {};
   return new SqaiError(code, message, {
     source: "engine",
-    retryable: RETRYABLE_ALGENTA_CODES.has(code),
+    retryable: RETRYABLE_ENGINE_CODES.has(code),
     details
   });
 }
@@ -191,12 +193,14 @@ function fromAlgentaError(error) {
 var DEFAULT_BUILD_SERVICE_URL = "https://sqai-buildservice.fly.dev";
 function readEnv(env = process.env) {
   const apiKey = (env.SQAI_API_KEY ?? "").trim() || void 0;
-  const engineUrl = (env.SQAI_ENGINE_URL ?? "").trim() || void 0;
+  const deploymentUrl = (env.SQAI_DEPLOYMENT_URL ?? "").trim() || void 0;
+  const legacyEngineUrl = (env.SQAI_ENGINE_URL ?? "").trim() || void 0;
+  const engineUrl = deploymentUrl ?? legacyEngineUrl;
   const autoInstall = (env.SQAI_RUNTIME_AUTO_INSTALL ?? "").trim() !== "0";
   const modulesRaw = (env.SQAI_RUNTIME_MODULES ?? "").split(",").map((m) => m.trim()).filter((m) => m.length > 0);
   const runtimeModules = modulesRaw.length > 0 ? modulesRaw : void 0;
   const buildServiceUrl = (env.SQAI_BUILD_SERVICE_URL ?? "").trim() || DEFAULT_BUILD_SERVICE_URL;
-  return { apiKey, engineUrl, autoInstall, runtimeModules, buildServiceUrl };
+  return { apiKey, engineUrl, deploymentUrl, autoInstall, runtimeModules, buildServiceUrl };
 }
 function inferMode(explicit, resolved) {
   if (explicit) {
@@ -205,9 +209,6 @@ function inferMode(explicit, resolved) {
   if (resolved.engineUrl) {
     return "self_hosted";
   }
-  if (resolved.apiKey) {
-    return "api";
-  }
   return "local";
 }
 
@@ -897,6 +898,9 @@ function digestsEqual(actualHex, expectedHex) {
   const expected = Buffer.from(expectedHex.toLowerCase(), "utf-8");
   return actual.length === expected.length && (0, import_node_crypto5.timingSafeEqual)(actual, expected);
 }
+function isGeneratedBytecodeCache(path) {
+  return path.split("/").includes("__pycache__") && path.endsWith(".pyc") && isSafeRelativePath(path);
+}
 function parseVerifiedManifest(manifestBytes) {
   let manifest;
   try {
@@ -1105,6 +1109,9 @@ async function verifyInstalledBundleDir(installDir, expectations) {
     }
     const entry = byPath.get(relPath);
     if (entry === void 0) {
+      if (isGeneratedBytecodeCache(relPath)) {
+        continue;
+      }
       throw new BundleVerificationError(
         "unlisted_member",
         `installed file not listed in signed manifest: '${relPath}'`
@@ -1273,6 +1280,21 @@ var RuntimeProvisioner = class _RuntimeProvisioner {
     }
     return new import_algenta_sdk2.MojoRuntime(config ?? {});
   }
+  async ensureLocalLoginKey() {
+    if (this.options.runtimeFactory || process.env.ALGENTA_API_KEY || process.env.DE_API_KEY) {
+      return;
+    }
+    const key = await readCachedApiKey();
+    if (key) {
+      process.env.ALGENTA_API_KEY = key;
+      return;
+    }
+    throw new SqaiError(
+      "login_required",
+      "Local compute requires a free SQAI device login. Run `sqai login` once, or set SQAI_API_KEY in this process.",
+      { details: { reason: "login_key_missing" } }
+    );
+  }
   cacheDir() {
     return this.options.cacheDir ?? runtimeCacheDir();
   }
@@ -1378,6 +1400,7 @@ var RuntimeProvisioner = class _RuntimeProvisioner {
   async doEnsure() {
     const platformKey = currentPlatformKey();
     const filter = this.filterModules();
+    await this.ensureLocalLoginKey();
     const probeEndpoint = filter ? this.filterEndpoint(this.localCacheKey(filter, platformKey)) : void 0;
     const runtime = this.newRuntime(probeEndpoint ? { tcpAddress: probeEndpoint.tcp } : void 0);
     try {
@@ -1405,7 +1428,7 @@ var RuntimeProvisioner = class _RuntimeProvisioner {
         const supported = Object.keys(bundle.platforms);
         throw new SqaiError(
           "unsupported_platform",
-          supported.length === 0 ? "No managed runtime bundle is published yet for any platform. Start a local Algenta runtime daemon, or set SQAI_ENGINE_URL / SQAI_API_KEY to use a hosted engine." : `No managed runtime bundle is published for '${platformKey}'.`,
+          supported.length === 0 ? "No managed runtime bundle is published yet for any platform. Run `sqai login`, or set SQAI_DEPLOYMENT_URL / SQAI_API_KEY for a managed SQAI deployment." : `No managed runtime bundle is published for '${platformKey}'.`,
           { details: { platform: platformKey, supported } }
         );
       }
@@ -1513,12 +1536,22 @@ var RuntimeProvisioner = class _RuntimeProvisioner {
   }
   async lockIsStale(lockPath) {
     const freshMs = this.options.lockFreshMs ?? LOCK_FRESH_MS;
+    const ageFromMtime = async () => {
+      try {
+        const stat = await import_node_fs3.promises.stat(lockPath);
+        return Date.now() - stat.mtimeMs;
+      } catch (error) {
+        const code = error.code;
+        return code === "ENOENT" ? null : Number.POSITIVE_INFINITY;
+      }
+    };
     try {
       const raw = await import_node_fs3.promises.readFile(lockPath, "utf-8");
       const parsed = JSON.parse(raw);
       const createdAt = typeof parsed.created_at === "string" ? Date.parse(parsed.created_at) : NaN;
       if (!Number.isFinite(createdAt)) {
-        return true;
+        const age = await ageFromMtime();
+        return age !== null && age >= freshMs;
       }
       return Date.now() - createdAt >= freshMs;
     } catch (error) {
@@ -1526,7 +1559,8 @@ var RuntimeProvisioner = class _RuntimeProvisioner {
       if (code === "ENOENT") {
         return false;
       }
-      return true;
+      const age = await ageFromMtime();
+      return age !== null && age >= freshMs;
     }
   }
   /** Serialize installers on `<cacheDir>/<installKey>.lock`; returns the verified install. */
@@ -1664,12 +1698,7 @@ var RuntimeProvisioner = class _RuntimeProvisioner {
       "start",
       "--foreground"
     ];
-    if (!process.env.ALGENTA_API_KEY && !process.env.DE_API_KEY) {
-      const key = await readCachedApiKey();
-      if (key) {
-        process.env.ALGENTA_API_KEY = key;
-      }
-    }
+    await this.ensureLocalLoginKey();
     const managed = this.newRuntime(
       endpoint ? { autoStart: true, daemonCommand, tcpAddress: endpoint.tcp } : { autoStart: true, daemonCommand }
     );
@@ -1738,7 +1767,7 @@ async function dispatchComputation(target, entry, argsVector, seed, requestId, t
         request_id: response.request_id ?? requestId
       };
     } catch (error) {
-      throw fromAlgentaError(error);
+      throw fromEngineError(error);
     }
   }
   return dispatchHttp(target, module2, functionName, args, requestId);
@@ -1775,7 +1804,7 @@ async function dispatchHttp(target, module2, functionName, args, requestId) {
   } catch (error) {
     throw new SqaiError(
       "compute_runtime_unavailable",
-      `The hosted compute endpoint is unreachable: ${error.message}. Check SQAI_ENGINE_URL / SQAI_API_KEY.`,
+      `The SQAI deployment endpoint is unreachable: ${error.message}. Check SQAI_DEPLOYMENT_URL / SQAI_API_KEY.`,
       { retryable: true }
     );
   }
@@ -1958,7 +1987,7 @@ var SQAI = class {
     const env = readEnv();
     this.mode = inferMode(config.mode, env);
     this.apiKey = config.apiKey ?? env.apiKey;
-    this.engineUrl = config.engineUrl ?? env.engineUrl;
+    this.engineUrl = config.deploymentUrl ?? config.engineUrl ?? env.engineUrl;
     this.tenantId = config.tenantId ?? null;
     this.policy = config.policy;
     this.configuredTarget = config.computeTarget;
@@ -1986,7 +2015,7 @@ var SQAI = class {
     this.algentaRuntime = this.rawRuntime;
   }
   // ── Query plane ────────────────────────────────────────────────────────────
-  async connect(source, options = {}) {
+  async connect(source = null, options = {}) {
     try {
       const registration = await this.algentaRuntime.connect(source, options);
       const mapped = mapSource(registration);
@@ -2005,7 +2034,84 @@ var SQAI = class {
       this.sources.set(mapped.name, mapped);
       return mapped;
     } catch (error) {
-      throw error instanceof SqaiError ? error : fromAlgentaError(error);
+      throw error instanceof SqaiError ? error : fromEngineError(error);
+    }
+  }
+  async createConnector(request2) {
+    const createConnector = this.algentaRuntime.createConnector;
+    if (typeof createConnector !== "function") {
+      throw unsupportedSubstrateOperation("createConnector");
+    }
+    try {
+      return await createConnector.call(this.algentaRuntime, request2);
+    } catch (error) {
+      throw fromEngineError(error);
+    }
+  }
+  async listConnectors(options = {}) {
+    const listConnectors = this.algentaRuntime.listConnectors;
+    if (typeof listConnectors !== "function") {
+      throw unsupportedSubstrateOperation("listConnectors");
+    }
+    try {
+      return await listConnectors.call(this.algentaRuntime, options);
+    } catch (error) {
+      throw fromEngineError(error);
+    }
+  }
+  async getConnector(connectorId) {
+    const getConnector = this.algentaRuntime.getConnector;
+    if (typeof getConnector !== "function") {
+      throw unsupportedSubstrateOperation("getConnector");
+    }
+    try {
+      return await getConnector.call(this.algentaRuntime, connectorId);
+    } catch (error) {
+      throw fromEngineError(error);
+    }
+  }
+  async updateConnector(connectorId, request2) {
+    const updateConnector = this.algentaRuntime.updateConnector;
+    if (typeof updateConnector !== "function") {
+      throw unsupportedSubstrateOperation("updateConnector");
+    }
+    try {
+      return await updateConnector.call(this.algentaRuntime, connectorId, request2);
+    } catch (error) {
+      throw fromEngineError(error);
+    }
+  }
+  async testConnector(connectorIdOrConnector) {
+    const testConnector = this.algentaRuntime.testConnector;
+    if (typeof testConnector !== "function") {
+      throw unsupportedSubstrateOperation("testConnector");
+    }
+    try {
+      return await testConnector.call(this.algentaRuntime, connectorIdOrConnector);
+    } catch (error) {
+      throw fromEngineError(error);
+    }
+  }
+  async browseConnector(connectorIdOrConnector) {
+    const browseConnector = this.algentaRuntime.browseConnector;
+    if (typeof browseConnector !== "function") {
+      throw unsupportedSubstrateOperation("browseConnector");
+    }
+    try {
+      return await browseConnector.call(this.algentaRuntime, connectorIdOrConnector);
+    } catch (error) {
+      throw fromEngineError(error);
+    }
+  }
+  async deleteConnector(connectorId) {
+    const deleteConnector = this.algentaRuntime.deleteConnector;
+    if (typeof deleteConnector !== "function") {
+      throw unsupportedSubstrateOperation("deleteConnector");
+    }
+    try {
+      await deleteConnector.call(this.algentaRuntime, connectorId);
+    } catch (error) {
+      throw fromEngineError(error);
     }
   }
   listSources() {
@@ -2016,28 +2122,28 @@ var SQAI = class {
     try {
       return await this.algentaRuntime.resolve(spec);
     } catch (error) {
-      throw fromAlgentaError(error);
+      throw fromEngineError(error);
     }
   }
   async query(plan) {
     try {
       return await this.algentaRuntime.query(plan);
     } catch (error) {
-      throw fromAlgentaError(error);
+      throw fromEngineError(error);
     }
   }
   async queryWithMetadata(plan) {
     try {
       return await this.algentaRuntime.queryWithMetadata(plan);
     } catch (error) {
-      throw fromAlgentaError(error);
+      throw fromEngineError(error);
     }
   }
   async verify(plan) {
     try {
       return await this.algentaRuntime.verify(plan);
     } catch (error) {
-      throw fromAlgentaError(error);
+      throw fromEngineError(error);
     }
   }
   async ask(spec) {
@@ -2059,14 +2165,14 @@ var SQAI = class {
     if (typeof this.algentaRuntime.extractColumns !== "function") {
       throw new SqaiError(
         "unsupported_operation",
-        "The installed algenta-sdk build does not provide extractColumns; upgrade the substrate.",
-        { details: { required: "algenta-sdk extractColumns" } }
+        "The installed SQAI package does not provide extractColumns; upgrade SQAI.",
+        { details: { required: "sqai.extractColumns" } }
       );
     }
     try {
       return await this.algentaRuntime.extractColumns(sourceName, columns, options);
     } catch (error) {
-      throw fromAlgentaError(error);
+      throw fromEngineError(error);
     }
   }
   // ── Computation plane ──────────────────────────────────────────────────────
@@ -2196,7 +2302,7 @@ var SQAI = class {
           "API mode requires SQAI_API_KEY for the computation plane."
         );
       }
-      return { kind: "http", baseUrl: "https://api.algenta.ai", apiKey: this.apiKey };
+      return { kind: "http", baseUrl: "https://api.sqai.com", apiKey: this.apiKey };
     }
     const runtime = await this.provisioner.ensure();
     return { kind: "local", runtime };
@@ -2254,6 +2360,13 @@ var SQAI = class {
 function createSQAI(config = {}) {
   return new SQAI(config);
 }
+function unsupportedSubstrateOperation(operation) {
+  return new SqaiError(
+    "unsupported_operation",
+    `The installed SQAI package does not provide ${operation}; upgrade SQAI.`,
+    { details: { required: `sqai.${operation}` } }
+  );
+}
 function mapSource(registration) {
   const record = registration;
   return {
@@ -2267,6 +2380,52 @@ function mapSource(registration) {
     status: String(registration.status ?? "ready")
   };
 }
+
+// src/types.ts
+var SQAI_CONNECTOR_TYPES = [
+  "s3",
+  "gcs",
+  "azure",
+  "clickhouse",
+  "bigquery",
+  "snowflake",
+  "redshift",
+  "postgres",
+  "postgresql",
+  "sqlite",
+  "mysql",
+  "mssql",
+  "oracle",
+  "neo4j",
+  "redis",
+  "elastic",
+  "elasticsearch",
+  "rest",
+  "rest_api",
+  "file",
+  "file_upload",
+  "github_repo",
+  "gitlab_repo",
+  "bitbucket_repo",
+  "local_repo",
+  "repo_archive"
+];
+var SQAI_CONNECTOR_TYPE_ALIASES = {
+  postgresql: "postgres",
+  click_house: "clickhouse",
+  redis_cache: "redis",
+  elastic: "elasticsearch",
+  rest_api: "rest",
+  file_upload: "file",
+  github: "github_repo",
+  github_repository: "github_repo",
+  gitlab: "gitlab_repo",
+  gitlab_repository: "gitlab_repo",
+  bitbucket: "bitbucket_repo",
+  bitbucket_repository: "bitbucket_repo",
+  local_repository: "local_repo",
+  archive_repository: "repo_archive"
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ContractIndex,
@@ -2274,6 +2433,8 @@ function mapSource(registration) {
   ResultStore,
   RuntimeProvisioner,
   SQAI,
+  SQAI_CONNECTOR_TYPES,
+  SQAI_CONNECTOR_TYPE_ALIASES,
   SQAI_ERROR_CODES,
   SqaiError,
   computationHash,
@@ -2289,4 +2450,3 @@ function mapSource(registration) {
   sqaiHome,
   validateComputation
 });
-//# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -3,7 +3,7 @@ export { QueryResponse, ResolveResponse, ResolvedPlan } from 'algenta-sdk';
 
 /** Capability contract: the generated, hash-pinned inventory of everything
  * SQAI exposes. Loaded from the vendored contracts/algenta-capabilities.json
- * (synced hash-verified from the decision-engine generator). SQAI keeps no
+ * (synced hash-verified from the generator). SQAI keeps no
  * handwritten operation lists — this file is the only authority. */
 interface CapabilitySignatureParam {
     name: string;
@@ -66,8 +66,7 @@ declare class ContractIndex {
 /** SQAI_* environment mapping and zero-config mode inference.
  *
  * Inference order (explicit config always overrides):
- *   SQAI_ENGINE_URL present -> "self_hosted"
- *   SQAI_API_KEY present    -> "api"
+ *   SQAI_DEPLOYMENT_URL / SQAI_ENGINE_URL present -> "self_hosted"
  *   otherwise               -> "local"
  */
 type SqaiMode = "local" | "api" | "self_hosted";
@@ -187,6 +186,7 @@ declare class RuntimeProvisioner {
     status(): Promise<RuntimeStatus>;
     stop(): Promise<void>;
     private newRuntime;
+    private ensureLocalLoginKey;
     private cacheDir;
     /** Normalized module filter (sorted, unique, non-empty) or null for the default bundle. */
     private filterModules;
@@ -225,13 +225,7 @@ declare class RuntimeProvisioner {
     private spawnInstalled;
 }
 
-/** Public SQAI types.
- *
- * Vocabulary rule: Algenta envelope field names pass through verbatim
- * (plan_hash, schema_revision, intent_signature, deterministic_scope,
- * decision_path, validated, engine_used, ...). SQAI never invents parallel
- * names for the same concept.
- */
+/** Public SQAI types. */
 
 /** Contract-derived wire value: everything the computation plane can
  * transport. The wire schema transports; the capability contract authorizes. */
@@ -241,8 +235,6 @@ type SqaiValue = null | boolean | number | string | SqaiValue[] | {
     type: "decimal" | "bigint";
     value: string;
 };
-/** @deprecated Renamed to {@link SqaiValue}. Kept as a non-breaking alias. */
-type AlgentaWireValue = SqaiValue;
 interface SqaiSource {
     name: string;
     source_id: string | null;
@@ -256,6 +248,74 @@ interface SqaiSource {
     schema_revision: string | null;
     status: string;
 }
+type SqaiConnectorConfig = Record<string, unknown>;
+declare const SQAI_CONNECTOR_TYPES: readonly ["s3", "gcs", "azure", "clickhouse", "bigquery", "snowflake", "redshift", "postgres", "postgresql", "sqlite", "mysql", "mssql", "oracle", "neo4j", "redis", "elastic", "elasticsearch", "rest", "rest_api", "file", "file_upload", "github_repo", "gitlab_repo", "bitbucket_repo", "local_repo", "repo_archive"];
+type SqaiConnectorType = (typeof SQAI_CONNECTOR_TYPES)[number];
+declare const SQAI_CONNECTOR_TYPE_ALIASES: Readonly<Record<string, SqaiConnectorType>>;
+interface SqaiConnectorPreview {
+    type?: SqaiConnectorType | string;
+    connector_type?: SqaiConnectorType | string;
+    provider?: string;
+    [key: string]: unknown;
+}
+interface SqaiManagedConnectOptions {
+    name?: string;
+    description?: string;
+    connectorId?: string;
+    connector?: SqaiConnectorPreview;
+    selection?: Record<string, unknown>;
+    datasetName?: string;
+    persist?: boolean;
+    visibility?: string;
+    connectionName?: string;
+}
+interface SqaiConnectorCreateRequest {
+    name: string;
+    connectorType: SqaiConnectorType | string;
+    config?: SqaiConnectorConfig;
+    description?: string;
+    visibility?: string;
+}
+interface SqaiConnectorUpdateRequest {
+    name?: string;
+    description?: string;
+    visibility?: string;
+    config?: SqaiConnectorConfig;
+}
+interface SqaiConnectorInfo {
+    id: string;
+    name: string;
+    connector_type: string;
+    status: string;
+    visibility: string;
+    description?: string | null;
+    last_tested_at?: string | null;
+    error_message?: string | null;
+    created_at?: string;
+}
+interface SqaiConnectorListResult {
+    connectors: SqaiConnectorInfo[];
+    total: number;
+    page: number;
+    limit: number;
+    pages: number;
+}
+interface SqaiConnectorTestResult {
+    success: boolean;
+    message: string;
+    latency_ms?: number | null;
+    status?: string | null;
+    error_type?: string | null;
+    recoverable?: boolean | null;
+}
+interface SqaiConnectorBrowseResult {
+    connector_type: string;
+    items: Array<Record<string, unknown>>;
+    total: number;
+    message: string;
+    labels: Record<string, unknown>;
+    discovery: Record<string, unknown>;
+}
 interface QueryFilterCondition {
     column?: string;
     dimension_hint?: string;
@@ -414,6 +474,9 @@ type DispatchTarget = {
 interface SqaiConfig {
     mode?: SqaiMode;
     apiKey?: string;
+    /** Public SQAI deployment URL. Prefer this over engineUrl in new code. */
+    deploymentUrl?: string;
+    /** @deprecated Use deploymentUrl. Kept for backward compatibility. */
     engineUrl?: string;
     tenantId?: string;
     policy?: SqaiPolicy;
@@ -435,7 +498,7 @@ interface SqaiConfig {
     buildServiceUrl?: string;
     /** BYO substrate (tests). */
     runtime?: Runtime;
-    /** BYO computation dispatch target (tests / custom self-hosted engines). */
+    /** BYO computation dispatch target (tests / custom SQAI deployments). */
     computeTarget?: DispatchTarget;
 }
 declare class SQAI {
@@ -453,9 +516,17 @@ declare class SQAI {
     private readonly timeoutMs;
     private readonly sources;
     constructor(config?: SqaiConfig);
-    connect(source: string | Array<Record<string, unknown>> | Record<string, unknown>, options?: {
-        name?: string;
-    }): Promise<SqaiSource>;
+    connect(source?: string | Array<Record<string, unknown>> | Record<string, unknown> | null, options?: SqaiManagedConnectOptions): Promise<SqaiSource>;
+    createConnector(request: SqaiConnectorCreateRequest): Promise<SqaiConnectorInfo>;
+    listConnectors(options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<SqaiConnectorListResult>;
+    getConnector(connectorId: string): Promise<SqaiConnectorInfo>;
+    updateConnector(connectorId: string, request: SqaiConnectorUpdateRequest): Promise<SqaiConnectorInfo>;
+    testConnector(connectorIdOrConnector: string | SqaiConnectorPreview): Promise<SqaiConnectorTestResult>;
+    browseConnector(connectorIdOrConnector: string | SqaiConnectorPreview): Promise<SqaiConnectorBrowseResult>;
+    deleteConnector(connectorId: string): Promise<void>;
     listSources(): SqaiSource[];
     resolve(spec: QuerySpec): Promise<ResolveResponse>;
     query(plan: ResolvedPlan | ResolveResponse): Promise<QueryResponse>;
@@ -487,9 +558,9 @@ declare function createSQAI(config?: SqaiConfig): SQAI;
 
 /** SQAI failure contract.
  *
- * Algenta error codes pass through verbatim (`source: "engine"`); SQAI adds
- * its own codes in the same snake_case vocabulary (`source: "sqai"`). A code
- * is never renamed and the same condition never gets two codes.
+ * Engine error codes pass through verbatim (`source: "engine"`); SQAI adds its
+ * own codes in the same snake_case vocabulary (`source: "sqai"`). A code is
+ * never renamed and the same condition never gets two codes.
  */
 type SqaiErrorSource = "engine" | "sqai";
 interface SqaiErrorOptions {
@@ -513,7 +584,7 @@ declare class SqaiError extends Error {
         request_id: string | null;
     };
 }
-/** Codes SQAI adds on top of the Algenta vocabulary. */
+/** SQAI error codes surfaced by the SDK. */
 declare const SQAI_ERROR_CODES: readonly ["unsupported_operation", "seed_required", "duplicate_argument_binding", "policy_denied_source", "policy_denied_field", "policy_denied_function", "source_already_registered", "runtime_provision_failed", "daemon_port_conflict", "unsupported_platform", "compute_runtime_unavailable", "result_not_found", "contract_mismatch", "invalid_intent"];
 
 /** Two-hash determinism contract.
@@ -631,4 +702,4 @@ interface ValidatedComputation {
 declare function lookupCapability(index: ContractIndex, module: string, functionName: string): CapabilityEntry;
 declare function validateComputation(spec: ComputationSpec, index: ContractIndex, policy: SqaiPolicy | undefined, resolvedBindings: ResolvedBindingValue[]): ValidatedComputation;
 
-export { type AlgentaWireValue, type AskOutcome, type BindingProvenance, type CapabilityContract, type CapabilityEntry, type CapabilityMatch, type ColumnExtract, type ComputationBinding, type ComputationSpec, type ComputeResult, ContractIndex, type DeterminismEnvelope, type InvocationIdentity, LoginError, type LoginResult, type QueryFilterCondition, type QueryFilterSpec, type QuerySpec, type ResolvedBindingValue, ResultStore, type ResultStoreConfig, RuntimeProvisioner, type RuntimeStatus, SQAI, SQAI_ERROR_CODES, type SqaiConfig, SqaiError, type SqaiErrorSource, type SqaiIntent, type SqaiOutcome, type SqaiPolicy, type SqaiResultRecord, type SqaiSource, type SqaiValue, type ValidatedComputation, computationHash, createSQAI, currentPlatformKey, invocationHash, isReadOnlyEligible, login, logout, lookupCapability, readCachedApiKey, runtimeCacheDir, sqaiHome, validateComputation };
+export { type AskOutcome, type BindingProvenance, type CapabilityContract, type CapabilityEntry, type CapabilityMatch, type ColumnExtract, type ComputationBinding, type ComputationSpec, type ComputeResult, ContractIndex, type DeterminismEnvelope, type InvocationIdentity, LoginError, type LoginResult, type QueryFilterCondition, type QueryFilterSpec, type QuerySpec, type ResolvedBindingValue, ResultStore, type ResultStoreConfig, RuntimeProvisioner, type RuntimeStatus, SQAI, SQAI_CONNECTOR_TYPES, SQAI_CONNECTOR_TYPE_ALIASES, SQAI_ERROR_CODES, type SqaiConfig, type SqaiConnectorBrowseResult, type SqaiConnectorConfig, type SqaiConnectorCreateRequest, type SqaiConnectorInfo, type SqaiConnectorListResult, type SqaiConnectorPreview, type SqaiConnectorTestResult, type SqaiConnectorType, type SqaiConnectorUpdateRequest, SqaiError, type SqaiErrorSource, type SqaiIntent, type SqaiManagedConnectOptions, type SqaiOutcome, type SqaiPolicy, type SqaiResultRecord, type SqaiSource, type SqaiValue, type ValidatedComputation, computationHash, createSQAI, currentPlatformKey, invocationHash, isReadOnlyEligible, login, logout, lookupCapability, readCachedApiKey, runtimeCacheDir, sqaiHome, validateComputation };