@amodalai/amodal 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# @amodalai/amodal
+
+## 0.1.2
+
+### Patch Changes
+
+- [#13](https://github.com/amodalai/amodal/pull/13) [`2c767b7`](https://github.com/amodalai/amodal/commit/2c767b7265f112148ce88ee27001d8e38ac8c970) Thanks [@gte620v](https://github.com/gte620v)! - Fix `amodal --version` showing `0.0.0`. Read version from package.json at runtime as fallback when CLI is not bundled with esbuild. Rename package from `@amodalai/cli` to `@amodalai/amodal`.
+
+- Updated dependencies []:
+  - @amodalai/core@0.1.2
+  - @amodalai/runtime@0.1.2
+  - @amodalai/runtime-app@0.1.2
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @amodalai/runtime-app@0.1.1
+  - @amodalai/core@0.1.1
+  - @amodalai/runtime@0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amodal Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @amodalai/amodal
+
+The developer CLI for building, testing, and deploying Amodal agents.
+
+## Install
+
+```bash
+npm install -g @amodalai/amodal
+```
+
+## Quick start
+
+```bash
+amodal init my-agent
+cd my-agent
+amodal dev
+```
+
+## Commands
+
+| Command          | Description                            |
+| ---------------- | -------------------------------------- |
+| `amodal init`    | Scaffold a new agent project           |
+| `amodal dev`     | Start local dev server with hot reload |
+| `amodal chat`    | Interactive chat session               |
+| `amodal connect` | Manage external service connections    |
+| `amodal eval`    | Run evaluation suites                  |
+| `amodal build`   | Build agent snapshot                   |
+| `amodal deploy`  | Deploy to platform                     |
+| `amodal install` | Install a plugin package               |
+| `amodal publish` | Publish plugins to marketplace         |
+| `amodal search`  | Search repo contents                   |
+
+See `amodal --help` for the full command list.
+
+## Documentation
+
+[docs.amodalai.com](https://docs.amodalai.com)
+
+## License
+
+[MIT](../../LICENSE)

package/dist/src/auth/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './types.js';
+export { getRequiredEnvVars, promptForCredentials } from './prompt.js';
+export type { PromptCredentialsOptions } from './prompt.js';
+export { testConnection } from './test-connection.js';
+export type { TestConnectionOptions } from './test-connection.js';
+export { runOAuth2Flow, OAuth2Error } from './oauth2.js';
+export type { OAuth2Options } from './oauth2.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,kBAAkB,EAAE,oBAAoB,EAAC,MAAM,aAAa,CAAC;AACrE,YAAY,EAAC,wBAAwB,EAAC,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAC,aAAa,EAAE,WAAW,EAAC,MAAM,aAAa,CAAC;AACvD,YAAY,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC"}

package/dist/src/auth/index.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './types.js';
+export { getRequiredEnvVars, promptForCredentials } from './prompt.js';
+export { testConnection } from './test-connection.js';
+export { runOAuth2Flow, OAuth2Error } from './oauth2.js';
+//# sourceMappingURL=index.js.map

package/dist/src/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,kBAAkB,EAAE,oBAAoB,EAAC,MAAM,aAAa,CAAC;AAErE,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAC,aAAa,EAAE,WAAW,EAAC,MAAM,aAAa,CAAC"}

package/dist/src/auth/oauth2.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { Server } from 'node:http';
+import type { AuthResult } from './types.js';
+export type OAuth2ErrorCode = 'SERVER_FAILED' | 'BROWSER_FAILED' | 'TIMEOUT' | 'TOKEN_EXCHANGE_FAILED' | 'CALLBACK_ERROR' | 'STATE_MISMATCH';
+export declare class OAuth2Error extends Error {
+    readonly code: OAuth2ErrorCode;
+    constructor(code: OAuth2ErrorCode, message: string, cause?: unknown);
+}
+export interface OAuth2Options {
+    authorizeUrl: string;
+    tokenUrl: string;
+    scopes?: string[];
+    envVars?: Record<string, string>;
+    clientId: string;
+    clientSecret?: string;
+    timeoutMs?: number;
+}
+interface CallbackServerResult {
+    server: Server;
+    port: number;
+    codePromise: Promise<{
+        code: string;
+        state: string;
+    }>;
+}
+/**
+ * Start a local HTTP server that listens for the OAuth2 callback.
+ */
+export declare function startCallbackServer(): Promise<CallbackServerResult>;
+/**
+ * Build the OAuth2 authorize URL.
+ */
+export declare function buildAuthorizeUrl(baseUrl: string, options: OAuth2Options, port: number, state: string): string;
+/**
+ * Exchange authorization code for tokens.
+ */
+export declare function exchangeCodeForTokens(tokenUrl: string, code: string, redirectUri: string, clientId: string, clientSecret?: string): Promise<Record<string, unknown>>;
+/**
+ * Map token response fields to env var names.
+ */
+export declare function mapTokensToEnvVars(tokens: Record<string, unknown>, envVars?: Record<string, string>): Record<string, string>;
+/**
+ * Run the full OAuth2 authorization code flow.
+ */
+export declare function runOAuth2Flow(options: OAuth2Options): Promise<AuthResult>;
+export {};
+//# sourceMappingURL=oauth2.d.ts.map

package/dist/src/auth/oauth2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth2.d.ts","sourceRoot":"","sources":["../../../src/auth/oauth2.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AAKtC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,gBAAgB,GAChB,SAAS,GACT,uBAAuB,GACvB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAEnB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKpE;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,UAAU,oBAAoB;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CA6DnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAUR;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2BlC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BxB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAsD/E"}

package/dist/src/auth/oauth2.js

@@ -0,0 +1,196 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { URL, URLSearchParams } from 'node:url';
+import open from 'open';
+export class OAuth2Error extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, { cause });
+        this.name = 'OAuth2Error';
+        this.code = code;
+    }
+}
+const DEFAULT_TIMEOUT_MS = 120_000;
+/**
+ * Start a local HTTP server that listens for the OAuth2 callback.
+ */
+export function startCallbackServer() {
+    return new Promise((resolve, reject) => {
+        let resolveCode;
+        let rejectCode;
+        const codePromise = new Promise((res, rej) => {
+            resolveCode = res;
+            rejectCode = rej;
+        });
+        const server = createServer((req, res) => {
+            try {
+                const url = new URL(req.url ?? '/', `http://localhost`);
+                if (url.pathname !== '/callback') {
+                    res.writeHead(404);
+                    res.end('Not found');
+                    return;
+                }
+                const code = url.searchParams.get('code');
+                const state = url.searchParams.get('state');
+                const error = url.searchParams.get('error');
+                if (error) {
+                    const description = url.searchParams.get('error_description') ?? error;
+                    res.writeHead(200, { 'Content-Type': 'text/html' });
+                    res.end('<html><body><h1>Authorization Failed</h1><p>You can close this window.</p></body></html>');
+                    rejectCode(new OAuth2Error('CALLBACK_ERROR', `OAuth2 error: ${description}`));
+                    return;
+                }
+                if (!code || !state) {
+                    res.writeHead(400, { 'Content-Type': 'text/html' });
+                    res.end('<html><body><h1>Missing Parameters</h1></body></html>');
+                    rejectCode(new OAuth2Error('CALLBACK_ERROR', 'Missing code or state parameter'));
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'text/html' });
+                res.end('<html><body><h1>Authorization Complete</h1><p>You can close this window.</p></body></html>');
+                resolveCode({ code, state });
+            }
+            catch (err) {
+                res.writeHead(500);
+                res.end('Internal error');
+                rejectCode(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+        server.listen(0, '127.0.0.1', () => {
+            const addr = server.address();
+            if (!addr || typeof addr === 'string') {
+                server.close();
+                reject(new OAuth2Error('SERVER_FAILED', 'Failed to get server port'));
+                return;
+            }
+            resolve({ server, port: addr.port, codePromise });
+        });
+        server.on('error', (err) => {
+            reject(new OAuth2Error('SERVER_FAILED', 'Failed to start callback server', err));
+        });
+    });
+}
+/**
+ * Build the OAuth2 authorize URL.
+ */
+export function buildAuthorizeUrl(baseUrl, options, port, state) {
+    const url = new URL(baseUrl);
+    url.searchParams.set('response_type', 'code');
+    url.searchParams.set('client_id', options.clientId);
+    url.searchParams.set('redirect_uri', `http://127.0.0.1:${port}/callback`);
+    url.searchParams.set('state', state);
+    if (options.scopes && options.scopes.length > 0) {
+        url.searchParams.set('scope', options.scopes.join(' '));
+    }
+    return url.toString();
+}
+/**
+ * Exchange authorization code for tokens.
+ */
+export async function exchangeCodeForTokens(tokenUrl, code, redirectUri, clientId, clientSecret) {
+    const body = new URLSearchParams({
+        grant_type: 'authorization_code',
+        code,
+        redirect_uri: redirectUri,
+        client_id: clientId,
+    });
+    if (clientSecret) {
+        body.set('client_secret', clientSecret);
+    }
+    const response = await fetch(tokenUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: body.toString(),
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new OAuth2Error('TOKEN_EXCHANGE_FAILED', `Token exchange failed: HTTP ${response.status}${text ? ` — ${text}` : ''}`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return (await response.json());
+}
+/**
+ * Map token response fields to env var names.
+ */
+export function mapTokensToEnvVars(tokens, envVars) {
+    const result = {};
+    if (envVars && Object.keys(envVars).length > 0) {
+        // envVars maps envVarName → description (for prompting)
+        // Token fields: access_token, refresh_token, etc.
+        // Convention: env var name hints at which token field
+        for (const envVarName of Object.keys(envVars)) {
+            const lower = envVarName.toLowerCase();
+            if (lower.includes('refresh') && typeof tokens['refresh_token'] === 'string') {
+                result[envVarName] = tokens['refresh_token'];
+            }
+            else if (lower.includes('access') && typeof tokens['access_token'] === 'string') {
+                result[envVarName] = tokens['access_token'];
+            }
+            else if (typeof tokens['access_token'] === 'string') {
+                // Default: map to access_token
+                result[envVarName] = tokens['access_token'];
+            }
+        }
+    }
+    else {
+        // Default mapping
+        if (typeof tokens['access_token'] === 'string') {
+            result['OAUTH_ACCESS_TOKEN'] = tokens['access_token'];
+        }
+        if (typeof tokens['refresh_token'] === 'string') {
+            result['OAUTH_REFRESH_TOKEN'] = tokens['refresh_token'];
+        }
+    }
+    return result;
+}
+/**
+ * Run the full OAuth2 authorization code flow.
+ */
+export async function runOAuth2Flow(options) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    let server;
+    try {
+        const serverResult = await startCallbackServer();
+        server = serverResult.server;
+        const { port, codePromise } = serverResult;
+        const state = randomUUID();
+        const authorizeUrl = buildAuthorizeUrl(options.authorizeUrl, options, port, state);
+        const redirectUri = `http://127.0.0.1:${port}/callback`;
+        // Try to open browser, fall back to printing URL
+        try {
+            await open(authorizeUrl);
+        }
+        catch {
+            process.stderr.write(`\nOpen this URL in your browser to authorize:\n${authorizeUrl}\n\n`);
+        }
+        // Wait for callback or timeout
+        const timeoutPromise = new Promise((_resolve, reject) => {
+            setTimeout(() => {
+                reject(new OAuth2Error('TIMEOUT', `OAuth2 flow timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        });
+        const callbackResult = await Promise.race([codePromise, timeoutPromise]);
+        // Verify state (CSRF protection)
+        if (callbackResult.state !== state) {
+            throw new OAuth2Error('STATE_MISMATCH', 'OAuth2 state parameter mismatch');
+        }
+        // Exchange code for tokens
+        const tokens = await exchangeCodeForTokens(options.tokenUrl, callbackResult.code, redirectUri, options.clientId, options.clientSecret);
+        const credentials = mapTokensToEnvVars(tokens, options.envVars);
+        return {
+            credentials,
+            summary: `OAuth2 authorization complete. ${Object.keys(credentials).length} token${Object.keys(credentials).length === 1 ? '' : 's'} obtained`,
+        };
+    }
+    finally {
+        if (server) {
+            server.close();
+        }
+    }
+}
+//# sourceMappingURL=oauth2.js.map

package/dist/src/auth/oauth2.js.map

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

package/dist/src/auth/prompt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { PackageAuth } from '@amodalai/core';
+import type { AuthResult } from './types.js';
+export interface PromptCredentialsOptions {
+    auth: PackageAuth;
+    envFilePath: string;
+    dryRun?: boolean;
+}
+/**
+ * Extract all required env var names from any auth type.
+ */
+export declare function getRequiredEnvVars(auth: PackageAuth): string[];
+/**
+ * Prompt user for missing credentials and write them to the env file.
+ */
+export declare function promptForCredentials(options: PromptCredentialsOptions): Promise<AuthResult>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/auth/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/auth/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAmB9D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,UAAU,CAAC,CA4DrB"}

package/dist/src/auth/prompt.js

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import prompts from 'prompts';
+import { findMissingEnvVars, upsertEnvEntries, } from '@amodalai/core';
+/**
+ * Extract all required env var names from any auth type.
+ */
+export function getRequiredEnvVars(auth) {
+    const vars = [];
+    // Collect from envVars map (all auth types can have this)
+    if (auth['envVars']) {
+        vars.push(...Object.keys(auth['envVars']));
+    }
+    // For api_key, also extract $VAR references from headers values
+    if (auth.type === 'api_key' && auth['headers']) {
+        for (const value of Object.values(auth['headers'])) {
+            const match = /\$\{?([A-Z_][A-Z0-9_]*)\}?/.exec(value);
+            if (match && !vars.includes(match[1])) {
+                vars.push(match[1]);
+            }
+        }
+    }
+    return vars;
+}
+/**
+ * Prompt user for missing credentials and write them to the env file.
+ */
+export async function promptForCredentials(options) {
+    const { auth, envFilePath, dryRun } = options;
+    const required = getRequiredEnvVars(auth);
+    if (required.length === 0) {
+        return {
+            credentials: {},
+            summary: 'No credentials required',
+        };
+    }
+    const missing = await findMissingEnvVars(envFilePath, required);
+    if (missing.length === 0) {
+        return {
+            credentials: {},
+            summary: 'All credentials already set',
+        };
+    }
+    if (dryRun) {
+        return {
+            credentials: {},
+            summary: `Missing credentials: ${missing.join(', ')}`,
+        };
+    }
+    const descriptions = auth['envVars'] ?? {};
+    const collected = {};
+    for (const varName of missing) {
+        const description = descriptions[varName];
+        const message = description
+            ? `${varName} (${description})`
+            : varName;
+        const response = await prompts({
+            type: 'password',
+            name: 'value',
+            message,
+        });
+        // User cancelled (Ctrl+C)
+        if (response['value'] === undefined) {
+            return {
+                credentials: collected,
+                summary: `Cancelled. ${Object.keys(collected).length} of ${missing.length} credentials collected`,
+            };
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        collected[varName] = response['value'];
+    }
+    await upsertEnvEntries(envFilePath, collected);
+    return {
+        credentials: collected,
+        summary: `Set ${Object.keys(collected).length} credential${Object.keys(collected).length === 1 ? '' : 's'}`,
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/auth/prompt.js.map

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

package/dist/src/auth/test-connection.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { PackageAuth } from '@amodalai/core';
+import type { ConnectionTestReport } from './types.js';
+export interface TestConnectionOptions {
+    connectionName: string;
+    testEndpoints: string[];
+    envFilePath: string;
+    auth?: PackageAuth;
+    timeoutMs?: number;
+}
+/**
+ * Substitute $VAR and ${VAR} placeholders in a URL.
+ */
+export declare function resolveEndpointUrl(url: string, envVars: Map<string, string>): string;
+/**
+ * Build auth headers based on auth config and env vars.
+ */
+export declare function buildAuthHeaders(auth: PackageAuth | undefined, envVars: Map<string, string>): Record<string, string>;
+/**
+ * Test connection endpoints sequentially. Never throws.
+ */
+export declare function testConnection(options: TestConnectionOptions): Promise<ConnectionTestReport>;
+//# sourceMappingURL=test-connection.d.ts.map

package/dist/src/auth/test-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-connection.d.ts","sourceRoot":"","sources":["../../../src/auth/test-connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAC,oBAAoB,EAAqB,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8CxB;AAqED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAkC/B"}