@amodalai/amodal 0.1.2

package/dist/src/commands/validate.js

@@ -0,0 +1,114 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { loadRepo, readLockFile, resolveAllPackages } from '@amodalai/core';
+import { findRepoRoot } from '../shared/repo-discovery.js';
+/**
+ * Validates the amodal project configuration by loading the full repo
+ * and running cross-reference checks.
+ *
+ * Returns the number of errors found (0 = valid).
+ */
+export async function runValidate(options = {}) {
+    const issues = [];
+    let repoPath;
+    try {
+        repoPath = findRepoRoot(options.cwd);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[validate] ${msg}\n`);
+        return 1;
+    }
+    process.stderr.write(`[validate] Loading repo from ${repoPath}\n`);
+    try {
+        const repo = await loadRepo({ localPath: repoPath });
+        // Check: at least one connection
+        if (repo.connections.size === 0) {
+            issues.push({ level: 'warning', message: 'No connections defined. The agent cannot access external systems.' });
+        }
+        // Check: surface endpoints reference valid access config
+        for (const [name, conn] of repo.connections) {
+            if (conn.surface.length === 0) {
+                issues.push({ level: 'warning', message: `Connection "${name}" has no surface endpoints.` });
+            }
+        }
+        // Check: skills have non-empty bodies
+        for (const skill of repo.skills) {
+            if (!skill.body.trim()) {
+                issues.push({ level: 'error', message: `Skill "${skill.name}" has an empty body.` });
+            }
+        }
+        // Check: automations have schedules
+        for (const auto of repo.automations) {
+            if (!auto.schedule) {
+                issues.push({ level: 'warning', message: `Automation "${auto.name}" has no schedule. It will only run via webhook.` });
+            }
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        issues.push({ level: 'error', message: `Failed to load repo: ${msg}` });
+    }
+    // Package-aware validation
+    if (options.packages) {
+        try {
+            const lockFile = await readLockFile(repoPath);
+            if (lockFile) {
+                const resolved = await resolveAllPackages({ repoPath, lockFile });
+                // Report warnings from resolution (missing packages, broken symlinks)
+                for (const warning of resolved.warnings) {
+                    issues.push({ level: 'warning', message: warning });
+                }
+                // Check for empty resolved connections
+                for (const [name, conn] of resolved.connections) {
+                    if (conn.surface.length === 0) {
+                        issues.push({ level: 'warning', message: `Resolved connection "${name}" has no surface endpoints.` });
+                    }
+                }
+                // Check for empty resolved skills
+                for (const skill of resolved.skills) {
+                    if (!skill.body.trim()) {
+                        issues.push({ level: 'error', message: `Resolved skill "${skill.name}" has an empty body.` });
+                    }
+                }
+            }
+            else {
+                process.stderr.write('[validate] No lock file found, skipping package validation.\n');
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            issues.push({ level: 'error', message: `Package resolution failed: ${msg}` });
+        }
+    }
+    // Print results
+    const errors = issues.filter((i) => i.level === 'error');
+    const warnings = issues.filter((i) => i.level === 'warning');
+    for (const issue of errors) {
+        process.stderr.write(`  ERROR: ${issue.message}\n`);
+    }
+    for (const issue of warnings) {
+        process.stderr.write(`  WARN:  ${issue.message}\n`);
+    }
+    if (errors.length === 0 && warnings.length === 0) {
+        process.stderr.write('[validate] All checks passed.\n');
+    }
+    else {
+        process.stderr.write(`[validate] ${errors.length} error(s), ${warnings.length} warning(s)\n`);
+    }
+    return errors.length;
+}
+export const validateCommand = {
+    command: 'validate',
+    describe: 'Validate the project configuration',
+    builder: (yargs) => yargs.option('packages', { type: 'boolean', default: false, describe: 'Include package resolution validation' }),
+    handler: async (argv) => {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        const code = await runValidate({ packages: argv['packages'] });
+        process.exit(code);
+    },
+};
+//# sourceMappingURL=validate.js.map

package/dist/src/commands/validate.js.map

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

package/dist/src/fixtures/incident-response.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Fixture data for the incident response e2e test.
+ *
+ * Four content types:
+ * 1. Connection: statuspage API (mock)
+ * 2. Skill: incident triage methodology
+ * 3. Knowledge: oncall runbook
+ * 4. Automation: daily health check
+ *
+ * The mock API returns deterministic data so we can assert on the
+ * agent's response content.
+ */
+import http from 'node:http';
+export declare const CONFIG: {
+    name: string;
+    version: string;
+    description: string;
+    models: {
+        main: {
+            provider: string;
+            model: string;
+        };
+    };
+};
+export declare const STATUSPAGE_SPEC: {
+    source: string;
+    format: "openapi";
+    auth: {
+        type: string;
+        header: string;
+        prefix: string;
+        token: string;
+    };
+};
+export declare const STATUSPAGE_ACCESS: {
+    endpoints: {
+        'GET /components': {
+            returns: string[];
+        };
+        'GET /incidents': {
+            returns: string[];
+        };
+        'GET /incidents/:id': {
+            returns: string[];
+        };
+        'POST /incidents': {
+            returns: string[];
+            confirm: "review";
+        };
+    };
+};
+export declare const STATUSPAGE_SURFACE = "## Included\n\n### GET /components\nList all monitored components and their current status\n\n### GET /incidents\nList recent incidents\n\n### GET /incidents/:id\nGet incident details\n\n## Excluded\n\n### POST /incidents\nCreate a new incident (requires confirmation)\n";
+export declare const TRIAGE_SKILL = "---\nname: incident-triage\ndescription: Methodology for triaging service incidents based on component status\ntrigger: When the user asks about service health, incidents, or outages\n---\n\n## Incident Triage\n\nFollow this methodology when assessing service health:\n\n1. **Check component status** \u2014 Query GET /components to see current state of all services\n2. **Identify degraded components** \u2014 Any component not in \"operational\" status needs attention\n3. **Assess severity** \u2014 Use the severity matrix from the oncall runbook\n4. **Check recent incidents** \u2014 Query GET /incidents for correlated issues\n5. **Recommend action** \u2014 Based on severity, recommend the appropriate response from the runbook\n\nAlways report the exact component names and their statuses. Never fabricate status data.\n";
+export declare const ONCALL_RUNBOOK = "# On-Call Runbook\n\n## Severity Matrix\n\n| Level | Criteria | Response Time | Escalation |\n|-------|----------|---------------|------------|\n| SEV1 | Multiple components down | 5 min | Page on-call lead immediately |\n| SEV2 | Single component degraded | 15 min | Notify #incidents channel |\n| SEV3 | Performance degradation | 1 hour | Create ticket |\n| SEV4 | Cosmetic or minor | Next business day | Log for review |\n\n## Key Contacts\n\n- **On-call lead**: Alice (alice@example.com)\n- **Platform team**: Bob (bob@example.com)\n- **Database team**: Charlie (charlie@example.com)\n\n## Components\n\n- **api-gateway**: Main API entry point. SEV1 if down.\n- **auth-service**: Authentication. SEV1 if down.\n- **database-primary**: Primary Postgres. SEV1 if down.\n- **worker-pool**: Background jobs. SEV2 if degraded.\n- **cdn**: Static assets. SEV3 if degraded.\n";
+export declare const HEALTH_CHECK_AUTOMATION = "# Automation: Daily Health Check\n\nSchedule: 0 8 * * *\n\n## Check\nQuery the statuspage API for current component status. Report any components not in \"operational\" state.\n\n## Output\nSummary of component statuses with severity assessment per the oncall runbook.\n\n## Delivery\nPost to #ops-daily channel.\n";
+/** Deterministic mock data the API returns. */
+export declare const MOCK_COMPONENTS: {
+    id: string;
+    name: string;
+    status: string;
+    updated_at: string;
+}[];
+export declare const MOCK_INCIDENTS: {
+    id: string;
+    name: string;
+    status: string;
+    impact: string;
+    created_at: string;
+    body: string;
+    components: string[];
+}[];
+/**
+ * Create a mock StatusPage API server that returns deterministic data.
+ * Returns a handle with start/stop methods.
+ */
+export declare function createMockStatusPageApi(): {
+    server: http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+    requests: {
+        method: string;
+        url: string;
+    }[];
+    readonly port: number;
+    start: () => Promise<number>;
+    stop: () => Promise<void>;
+};
+//# sourceMappingURL=incident-response.d.ts.map

package/dist/src/fixtures/incident-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-response.d.ts","sourceRoot":"","sources":["../../../src/fixtures/incident-response.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,eAAO,MAAM,MAAM;;;;;;;;;;CAOlB,CAAC;AAMF,eAAO,MAAM,eAAe;;;;;;;;;CAS3B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;CAO7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,mRAe9B,CAAC;AAMF,eAAO,MAAM,YAAY,g0BAiBxB,CAAC;AAMF,eAAO,MAAM,cAAc,62BAwB1B,CAAC;AAMF,eAAO,MAAM,uBAAuB,+TAYnC,CAAC;AAMF,+CAA+C;AAC/C,eAAO,MAAM,eAAe;;;;;GAM3B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;GAU1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB;;;gBACN,MAAM;aAAO,MAAM;;;;;EAuDnD"}

package/dist/src/fixtures/incident-response.js

@@ -0,0 +1,208 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Fixture data for the incident response e2e test.
+ *
+ * Four content types:
+ * 1. Connection: statuspage API (mock)
+ * 2. Skill: incident triage methodology
+ * 3. Knowledge: oncall runbook
+ * 4. Automation: daily health check
+ *
+ * The mock API returns deterministic data so we can assert on the
+ * agent's response content.
+ */
+import http from 'node:http';
+// ---------------------------------------------------------------------------
+// amodal.json
+// ---------------------------------------------------------------------------
+export const CONFIG = {
+    name: 'incident-response-agent',
+    version: '1.0.0',
+    description: 'Monitors services and triages incidents',
+    models: {
+        main: { provider: 'anthropic', model: 'claude-sonnet-4-20250514' },
+    },
+};
+// ---------------------------------------------------------------------------
+// Connection: statuspage
+// ---------------------------------------------------------------------------
+export const STATUSPAGE_SPEC = {
+    source: 'https://statuspage.example.com/api/v1/openapi.json',
+    format: 'openapi',
+    auth: {
+        type: 'bearer',
+        header: 'Authorization',
+        prefix: 'Bearer',
+        token: 'env:STATUSPAGE_TOKEN',
+    },
+};
+export const STATUSPAGE_ACCESS = {
+    endpoints: {
+        'GET /components': { returns: ['id', 'name', 'status', 'updated_at'] },
+        'GET /incidents': { returns: ['id', 'name', 'status', 'impact', 'created_at'] },
+        'GET /incidents/:id': { returns: ['id', 'name', 'status', 'impact', 'body', 'components'] },
+        'POST /incidents': { returns: ['id'], confirm: 'review' },
+    },
+};
+export const STATUSPAGE_SURFACE = `## Included
+
+### GET /components
+List all monitored components and their current status
+
+### GET /incidents
+List recent incidents
+
+### GET /incidents/:id
+Get incident details
+
+## Excluded
+
+### POST /incidents
+Create a new incident (requires confirmation)
+`;
+// ---------------------------------------------------------------------------
+// Skill: incident-triage
+// ---------------------------------------------------------------------------
+export const TRIAGE_SKILL = `---
+name: incident-triage
+description: Methodology for triaging service incidents based on component status
+trigger: When the user asks about service health, incidents, or outages
+---
+
+## Incident Triage
+
+Follow this methodology when assessing service health:
+
+1. **Check component status** — Query GET /components to see current state of all services
+2. **Identify degraded components** — Any component not in "operational" status needs attention
+3. **Assess severity** — Use the severity matrix from the oncall runbook
+4. **Check recent incidents** — Query GET /incidents for correlated issues
+5. **Recommend action** — Based on severity, recommend the appropriate response from the runbook
+
+Always report the exact component names and their statuses. Never fabricate status data.
+`;
+// ---------------------------------------------------------------------------
+// Knowledge: oncall-runbook
+// ---------------------------------------------------------------------------
+export const ONCALL_RUNBOOK = `# On-Call Runbook
+
+## Severity Matrix
+
+| Level | Criteria | Response Time | Escalation |
+|-------|----------|---------------|------------|
+| SEV1 | Multiple components down | 5 min | Page on-call lead immediately |
+| SEV2 | Single component degraded | 15 min | Notify #incidents channel |
+| SEV3 | Performance degradation | 1 hour | Create ticket |
+| SEV4 | Cosmetic or minor | Next business day | Log for review |
+
+## Key Contacts
+
+- **On-call lead**: Alice (alice@example.com)
+- **Platform team**: Bob (bob@example.com)
+- **Database team**: Charlie (charlie@example.com)
+
+## Components
+
+- **api-gateway**: Main API entry point. SEV1 if down.
+- **auth-service**: Authentication. SEV1 if down.
+- **database-primary**: Primary Postgres. SEV1 if down.
+- **worker-pool**: Background jobs. SEV2 if degraded.
+- **cdn**: Static assets. SEV3 if degraded.
+`;
+// ---------------------------------------------------------------------------
+// Automation: health-check
+// ---------------------------------------------------------------------------
+export const HEALTH_CHECK_AUTOMATION = `# Automation: Daily Health Check
+
+Schedule: 0 8 * * *
+
+## Check
+Query the statuspage API for current component status. Report any components not in "operational" state.
+
+## Output
+Summary of component statuses with severity assessment per the oncall runbook.
+
+## Delivery
+Post to #ops-daily channel.
+`;
+// ---------------------------------------------------------------------------
+// Mock StatusPage API
+// ---------------------------------------------------------------------------
+/** Deterministic mock data the API returns. */
+export const MOCK_COMPONENTS = [
+    { id: 'comp-1', name: 'api-gateway', status: 'operational', updated_at: '2026-03-18T08:00:00Z' },
+    { id: 'comp-2', name: 'auth-service', status: 'operational', updated_at: '2026-03-18T08:00:00Z' },
+    { id: 'comp-3', name: 'database-primary', status: 'degraded_performance', updated_at: '2026-03-18T09:15:00Z' },
+    { id: 'comp-4', name: 'worker-pool', status: 'operational', updated_at: '2026-03-18T08:00:00Z' },
+    { id: 'comp-5', name: 'cdn', status: 'operational', updated_at: '2026-03-18T08:00:00Z' },
+];
+export const MOCK_INCIDENTS = [
+    {
+        id: 'inc-42',
+        name: 'Database latency spike',
+        status: 'investigating',
+        impact: 'minor',
+        created_at: '2026-03-18T09:10:00Z',
+        body: 'We are investigating elevated query latency on the primary database cluster.',
+        components: ['database-primary'],
+    },
+];
+/**
+ * Create a mock StatusPage API server that returns deterministic data.
+ * Returns a handle with start/stop methods.
+ */
+export function createMockStatusPageApi() {
+    const requests = [];
+    const server = http.createServer((req, res) => {
+        const url = req.url ?? '';
+        const method = req.method ?? '';
+        requests.push({ method, url });
+        const json = (data) => {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(data));
+        };
+        if (method === 'GET' && url === '/components') {
+            json(MOCK_COMPONENTS);
+            return;
+        }
+        if (method === 'GET' && url === '/incidents') {
+            json(MOCK_INCIDENTS);
+            return;
+        }
+        const incidentMatch = /^\/incidents\/([^/]+)$/.exec(url);
+        if (method === 'GET' && incidentMatch) {
+            const incident = MOCK_INCIDENTS.find((i) => i.id === incidentMatch[1]);
+            if (incident) {
+                json(incident);
+            }
+            else {
+                res.writeHead(404);
+                res.end(JSON.stringify({ error: 'Not found' }));
+            }
+            return;
+        }
+        res.writeHead(404);
+        res.end(JSON.stringify({ error: 'Not found' }));
+    });
+    let port = 0;
+    return {
+        server,
+        requests,
+        get port() { return port; },
+        start: () => new Promise((resolve) => {
+            server.listen(0, '127.0.0.1', () => {
+                const addr = server.address();
+                port = typeof addr === 'object' && addr ? addr.port : 0;
+                resolve(port);
+            });
+        }),
+        stop: () => new Promise((resolve, reject) => {
+            server.close((err) => (err ? reject(err) : resolve()));
+        }),
+    };
+}
+//# sourceMappingURL=incident-response.js.map

package/dist/src/fixtures/incident-response.js.map

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

package/dist/src/main.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/src/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/src/main.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFileSync } from 'node:fs';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import { amodalCommands } from './commands/index.js';
+const raw = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf-8'));
+if (typeof raw !== 'object' || raw === null || !('version' in raw) || typeof raw.version !== 'string') {
+    throw new Error('Failed to read version from package.json');
+}
+const pkgVersion = raw.version;
+const cli = yargs(hideBin(process.argv))
+    .scriptName('amodal')
+    .usage('$0 <command> [options]');
+for (const cmd of amodalCommands) {
+    cli.command(cmd);
+}
+cli
+    .demandCommand(1, 'Run amodal <command> --help for usage')
+    .strict()
+    .help()
+    .alias('h', 'help')
+    .version(process.env['CLI_VERSION'] ?? pkgVersion)
+    .alias('v', 'version');
+void cli.parse();
+//# sourceMappingURL=main.js.map

package/dist/src/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AACtC,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAEnD,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACvG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;IACtG,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC9D,CAAC;AACD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC;AAE/B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACrC,UAAU,CAAC,QAAQ,CAAC;KACpB,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAEnC,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IACjC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,GAAG;KACA,aAAa,CAAC,CAAC,EAAE,uCAAuC,CAAC;KACzD,MAAM,EAAE;KACR,IAAI,EAAE;KACN,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC;KAClB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC;KACjD,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAEzB,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/shared/platform-client.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { DeploySnapshot } from '@amodalai/core';
+/**
+ * Metadata returned for a snapshot deployment.
+ */
+export interface SnapshotDeploymentMeta {
+    id: string;
+    environment: string;
+    isActive: boolean;
+    createdAt: string;
+    createdBy: string;
+    source: string;
+    commitSha?: string;
+    branch?: string;
+    message?: string;
+    snapshotSize: number;
+}
+/**
+ * Resolve platform URL and API key from multiple sources:
+ * 1. Explicit options (flags)
+ * 2. .amodal/project.json (platformUrl from `amodal link`)
+ * 3. ~/.amodalrc (auth token from `amodal login`)
+ * 4. Env vars (fallback)
+ */
+export declare function resolvePlatformConfig(options?: {
+    url?: string;
+    apiKey?: string;
+}): Promise<{
+    url: string;
+    apiKey: string;
+}>;
+/**
+ * Platform API client for snapshot deployments.
+ *
+ * Resolves credentials from: explicit options → project link → rc file → env vars.
+ * Use `PlatformClient.create()` for async auto-discovery, or `new PlatformClient()` for sync usage.
+ */
+export declare class PlatformClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(options?: {
+        url?: string;
+        apiKey?: string;
+    });
+    /**
+     * Create a PlatformClient with auto-discovery of credentials.
+     * Resolves from: explicit options → project link → rc file → env vars.
+     */
+    static create(options?: {
+        url?: string;
+        apiKey?: string;
+    }): Promise<PlatformClient>;
+    private headers;
+    private request;
+    /**
+     * Upload a snapshot and deploy it.
+     */
+    uploadSnapshot(snapshot: DeploySnapshot, options?: {
+        environment?: string;
+    }): Promise<SnapshotDeploymentMeta>;
+    /**
+     * List deployments for the authenticated tenant.
+     */
+    listDeployments(options?: {
+        environment?: string;
+        limit?: number;
+    }): Promise<SnapshotDeploymentMeta[]>;
+    /**
+     * Rollback to a previous deployment.
+     */
+    rollback(options?: {
+        deployId?: string;
+        environment?: string;
+    }): Promise<SnapshotDeploymentMeta>;
+    /**
+     * Promote a deployment from one environment to another.
+     */
+    promote(fromEnv: string, toEnv?: string): Promise<SnapshotDeploymentMeta>;
+    /**
+     * Get status of a specific deployment.
+     */
+    getStatus(deployId: string): Promise<SnapshotDeploymentMeta>;
+    /**
+     * Get the active snapshot for an environment.
+     */
+    getActiveSnapshot(environment?: string): Promise<DeploySnapshot>;
+}
+//# sourceMappingURL=platform-client.d.ts.map

package/dist/src/shared/platform-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-client.d.ts","sourceRoot":"","sources":["../../../src/shared/platform-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAInD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC,CAgCzC;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,CAAC,EAAE;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC;IASrD;;;OAGG;WACU,MAAM,CAAC,OAAO,CAAC,EAAE;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAKvF,OAAO,CAAC,OAAO;YAOD,OAAO;IAwBrB;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,GAAE;QACtD,WAAW,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAOxC;;OAEG;IACG,eAAe,CAAC,OAAO,GAAE;QAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAQ1C;;OAEG;IACG,QAAQ,CAAC,OAAO,GAAE;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAOxC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAO7F;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIlE;;OAEG;IACG,iBAAiB,CAAC,WAAW,GAAE,MAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;CAIrF"}