@cardelli/ambit 0.1.2 → 0.1.4

package/esm/src/discovery.d.ts

@@ -25,6 +25,16 @@ export interface RouterTailscaleInfo {
 export declare const listRouterApps: (fly: FlyProvider, org: string) => Promise<RouterApp[]>;
 /** Find the router app for a specific network. */
 export declare const findRouterApp: (fly: FlyProvider, org: string, network: string) => Promise<RouterApp | null>;
+/** A workload (non-router) app discovered from the Fly REST API. */
+export interface WorkloadApp {
+    appName: string;
+    network: string;
+    org: string;
+}
+/** List all non-router apps on a specific custom network in an org. */
+export declare const listWorkloadAppsOnNetwork: (fly: FlyProvider, org: string, network: string) => Promise<WorkloadApp[]>;
+/** Find a specific workload app by name, optionally verifying network. */
+export declare const findWorkloadApp: (fly: FlyProvider, org: string, appName: string, network?: string) => Promise<WorkloadApp | null>;
 /** Get machine info for a router app. Returns null if no machines exist. */
 export declare const getRouterMachineInfo: (fly: FlyProvider, appName: string) => Promise<RouterMachineInfo | null>;
 /** Get tailscale device info for a router. Returns null if not found. */

package/esm/src/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/src/discovery.ts"],"names":[],"mappings":"AAcA,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOlE,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAaD,wDAAwD;AACxD,eAAO,MAAM,cAAc,GACzB,KAAK,WAAW,EAChB,KAAK,MAAM,KACV,OAAO,CAAC,SAAS,EAAE,CAcrB,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,aAAa,GACxB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,SAAS,MAAM,KACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAG1B,CAAC;AAMF,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,GAC/B,KAAK,WAAW,EAChB,SAAS,MAAM,KACd,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAclC,CAAC;AAMF,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,GACjC,WAAW,iBAAiB,EAC5B,SAAS,MAAM,KACd,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAcpC,CAAC"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/src/discovery.ts"],"names":[],"mappings":"AAcA,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOlE,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAaD,wDAAwD;AACxD,eAAO,MAAM,cAAc,GACzB,KAAK,WAAW,EAChB,KAAK,MAAM,KACV,OAAO,CAAC,SAAS,EAAE,CAcrB,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,aAAa,GACxB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,SAAS,MAAM,KACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAG1B,CAAC;AAMF,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,GACpC,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,SAAS,MAAM,KACd,OAAO,CAAC,WAAW,EAAE,CAcvB,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAC1B,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,SAAS,MAAM,EACf,UAAU,MAAM,KACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAmB5B,CAAC;AAMF,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,GAC/B,KAAK,WAAW,EAChB,SAAS,MAAM,KACd,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAclC,CAAC;AAMF,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,GACjC,WAAW,iBAAiB,EAC5B,SAAS,MAAM,KACd,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAcpC,CAAC"}

package/esm/src/discovery.js

@@ -39,6 +39,34 @@ export const findRouterApp = async (fly, org, network) => {
     const apps = await listRouterApps(fly, org);
     return apps.find((a) => a.network === network) ?? null;
 };
+/** List all non-router apps on a specific custom network in an org. */
+export const listWorkloadAppsOnNetwork = async (fly, org, network) => {
+    const apps = await fly.listAppsWithNetwork(org);
+    return apps
+        .filter((app) => !app.name.startsWith(ROUTER_APP_PREFIX) &&
+        app.network === network)
+        .map((app) => ({
+        appName: app.name,
+        network: app.network,
+        org: app.organization?.slug ?? org,
+    }));
+};
+/** Find a specific workload app by name, optionally verifying network. */
+export const findWorkloadApp = async (fly, org, appName, network) => {
+    const apps = await fly.listAppsWithNetwork(org);
+    const workloads = apps
+        .filter((app) => !app.name.startsWith(ROUTER_APP_PREFIX) &&
+        app.network !== DEFAULT_NETWORK)
+        .map((app) => ({
+        appName: app.name,
+        network: app.network,
+        org: app.organization?.slug ?? org,
+    }));
+    if (network) {
+        return workloads.find((a) => a.appName === appName && a.network === network) ?? null;
+    }
+    return workloads.find((a) => a.appName === appName) ?? null;
+};
 // =============================================================================
 // 2. What's the machine state? (Fly Machines API)
 // =============================================================================

package/esm/src/template.d.ts

@@ -0,0 +1,40 @@
+import type { Result } from "../lib/result.js";
+/** Kinds of errors that can occur when fetching a template from GitHub. */
+export type TemplateErrorKind = "NotFound" | "RateLimited" | "HttpError" | "ExtractionFailed" | "PathNotFound" | "PathNotDirectory" | "EmptyArchive" | "NetworkError";
+/** Parsed GitHub template reference. */
+export interface TemplateRef {
+    owner: string;
+    repo: string;
+    path: string;
+    ref: string | undefined;
+}
+/** Result of fetching a template from GitHub. */
+export type TemplateFetchResult = Result<{
+    tempDir: string;
+    templateDir: string;
+}, TemplateErrorKind>;
+/**
+ * Parse a template reference string into its components.
+ * Returns null if the format is invalid.
+ *
+ * Format: owner/repo[/path][@ref]
+ *
+ * The first two segments are always owner/repo. Everything after the second
+ * slash up to an optional @ref is the path within the repository. When no
+ * path is provided, the repository root is used as the template directory.
+ * This is unambiguous because GitHub owner and repo names cannot contain
+ * slashes.
+ */
+export declare const parseTemplateRef: (raw: string) => TemplateRef | null;
+/**
+ * Download a template from GitHub and extract the target subdirectory
+ * to a temp directory.
+ *
+ * On success, returns the temp dir (for cleanup) and the path to the
+ * extracted template directory. The caller is responsible for removing
+ * tempDir when done.
+ *
+ * On failure, cleans up the temp dir and returns a typed error.
+ */
+export declare const fetchTemplate: (ref: TemplateRef) => Promise<TemplateFetchResult>;
+//# sourceMappingURL=template.d.ts.map

package/esm/src/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/src/template.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAM/C,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,cAAc,CAAC;AAMnB,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CACtC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EACxC,iBAAiB,CAClB,CAAC;AAgCF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,WAAW,GAAG,IAyB5D,CAAC;AAMF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACxB,KAAK,WAAW,KACf,OAAO,CAAC,mBAAmB,CAsH7B,CAAC"}

package/esm/src/template.js

@@ -0,0 +1,167 @@
+// =============================================================================
+// Template - Fetch Deploy Templates from GitHub Repositories
+// =============================================================================
+//
+// Downloads a subdirectory from a GitHub repository for use as a deploy
+// template. Templates are expected to contain at least a fly.toml and
+// typically a Dockerfile.
+//
+// Reference format: owner/repo[/path][@ref]
+//
+//   ToxicPine/ambit-openclaw               → repo root, default branch
+//   ToxicPine/ambit-templates/cdp          → subdirectory, default branch
+//   ToxicPine/ambit-templates/cdp@v1.0     → tagged release
+//   ToxicPine/ambit-templates/cdp@main     → explicit branch
+//
+// =============================================================================
+import * as dntShim from "../_dnt.shims.js";
+import { join } from "../deps/jsr.io/@std/path/1.1.4/mod.js";
+import { runCommand } from "../lib/command.js";
+// =============================================================================
+// Internal Helpers
+// =============================================================================
+/** Shorthand for returning a typed fetch error. */
+const fail = (kind, message) => ({
+    ok: false,
+    kind,
+    message,
+});
+/** Format a template reference for display. */
+const formatRef = (ref) => {
+    const base = ref.path === "."
+        ? `${ref.owner}/${ref.repo}`
+        : `${ref.owner}/${ref.repo}/${ref.path}`;
+    return base + (ref.ref ? `@${ref.ref}` : "");
+};
+/** Format owner/repo with optional ref for display. */
+const formatRepo = (ref) => `${ref.owner}/${ref.repo}` + (ref.ref ? `@${ref.ref}` : "");
+// =============================================================================
+// Parse Template Reference
+// =============================================================================
+/**
+ * Parse a template reference string into its components.
+ * Returns null if the format is invalid.
+ *
+ * Format: owner/repo[/path][@ref]
+ *
+ * The first two segments are always owner/repo. Everything after the second
+ * slash up to an optional @ref is the path within the repository. When no
+ * path is provided, the repository root is used as the template directory.
+ * This is unambiguous because GitHub owner and repo names cannot contain
+ * slashes.
+ */
+export const parseTemplateRef = (raw) => {
+    // Split off @ref suffix
+    const atIndex = raw.lastIndexOf("@");
+    let body;
+    let ref;
+    if (atIndex > 0) {
+        body = raw.slice(0, atIndex);
+        ref = raw.slice(atIndex + 1);
+        if (!ref)
+            return null;
+    }
+    else {
+        body = raw;
+    }
+    // Need at least owner/repo
+    const parts = body.split("/");
+    if (parts.length < 2)
+        return null;
+    const owner = parts[0];
+    const repo = parts[1];
+    const path = parts.length > 2 ? parts.slice(2).join("/") : ".";
+    if (!owner || !repo || !path)
+        return null;
+    return { owner, repo, path, ref };
+};
+// =============================================================================
+// Fetch Template
+// =============================================================================
+/**
+ * Download a template from GitHub and extract the target subdirectory
+ * to a temp directory.
+ *
+ * On success, returns the temp dir (for cleanup) and the path to the
+ * extracted template directory. The caller is responsible for removing
+ * tempDir when done.
+ *
+ * On failure, cleans up the temp dir and returns a typed error.
+ */
+export const fetchTemplate = async (ref) => {
+    const tempDir = dntShim.Deno.makeTempDirSync({ prefix: "ambit-template-" });
+    const cleanup = () => {
+        try {
+            dntShim.Deno.removeSync(tempDir, { recursive: true });
+        }
+        catch { /* ignore */ }
+    };
+    const cleanFail = (kind, message) => {
+        cleanup();
+        return fail(kind, message);
+    };
+    try {
+        const url = ref.ref
+            ? `https://api.github.com/repos/${ref.owner}/${ref.repo}/tarball/${ref.ref}`
+            : `https://api.github.com/repos/${ref.owner}/${ref.repo}/tarball`;
+        const response = await fetch(url, {
+            headers: {
+                Accept: "application/vnd.github+json",
+                "User-Agent": "ambit-cli",
+            },
+        });
+        if (!response.ok) {
+            const repo = formatRepo(ref);
+            if (response.status === 404) {
+                return cleanFail("NotFound", `Template Repository Not Found: ${repo}. ` +
+                    "Check that the repository exists and is public.");
+            }
+            if (response.status === 403) {
+                return cleanFail("RateLimited", "GitHub API Rate Limit Exceeded. Try again later.");
+            }
+            return cleanFail("HttpError", `GitHub API Returned HTTP ${response.status} for ${repo}`);
+        }
+        // Write tarball to disk
+        const tarballPath = join(tempDir, "template.tar.gz");
+        const tarball = new Uint8Array(await response.arrayBuffer());
+        dntShim.Deno.writeFileSync(tarballPath, tarball);
+        // Extract
+        const extractDir = join(tempDir, "extract");
+        dntShim.Deno.mkdirSync(extractDir);
+        const extractResult = await runCommand([
+            "tar",
+            "xzf",
+            tarballPath,
+            "-C",
+            extractDir,
+        ]);
+        if (!extractResult.success) {
+            return cleanFail("ExtractionFailed", "Failed to Extract Template Archive");
+        }
+        // GitHub tarballs have a single top-level dir (owner-repo-commitish/)
+        const entries = [...dntShim.Deno.readDirSync(extractDir)];
+        const topLevel = entries.find((e) => e.isDirectory);
+        if (!topLevel) {
+            return cleanFail("EmptyArchive", "Template Archive Has No Top-Level Directory");
+        }
+        // Locate the template subdirectory
+        const templateDir = join(extractDir, topLevel.name, ref.path);
+        try {
+            const stat = dntShim.Deno.statSync(templateDir);
+            if (!stat.isDirectory) {
+                return cleanFail("PathNotDirectory", `Template Path '${ref.path}' Is Not a Directory in ${formatRepo(ref)}`);
+            }
+        }
+        catch {
+            return cleanFail("PathNotFound", `Template Path '${ref.path}' Not Found in ${formatRepo(ref)}`);
+        }
+        return { ok: true, tempDir, templateDir };
+    }
+    catch (e) {
+        if (e instanceof TypeError) {
+            return cleanFail("NetworkError", "Network Error: Could Not Reach GitHub");
+        }
+        cleanup();
+        throw e;
+    }
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cardelli/ambit",
-  "version": "0.1.2",
-  "description": "Tailscale subnet router manager for Fly.io custom networks",
+  "version": "0.1.4",
+  "description": "Deploy apps to the cloud that only you and your AI agents can reach",
   "license": "MIT",
   "module": "./esm/src/providers/fly.js",
   "exports": {

package/esm/deps/jsr.io/@std/cli/1.0.27/_data.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_data.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/cli/1.0.27/_data.js"],"names":[],"mappings":""}

package/esm/deps/jsr.io/@std/collections/1.1.3/_utils.d.ts

@@ -1,6 +0,0 @@
-/**
- * Filters the given array, removing all elements that do not match the given predicate
- * **in place. This means `array` will be modified!**.
- */
-export declare function filterInPlace<T>(array: Array<T>, predicate: (el: T) => boolean): Array<T>;
-//# sourceMappingURL=_utils.d.ts.map

package/esm/deps/jsr.io/@std/collections/1.1.3/_utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.1.3/_utils.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,GAC5B,KAAK,CAAC,CAAC,CAAC,CAeV"}

package/esm/deps/jsr.io/@std/collections/1.1.3/_utils.js

@@ -1,18 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-/**
- * Filters the given array, removing all elements that do not match the given predicate
- * **in place. This means `array` will be modified!**.
- */
-export function filterInPlace(array, predicate) {
-    let outputIndex = 0;
-    for (const cur of array) {
-        if (!predicate(cur)) {
-            continue;
-        }
-        array[outputIndex] = cur;
-        outputIndex += 1;
-    }
-    array.splice(outputIndex);
-    return array;
-}