@alfe.ai/integrations 0.0.2 → 0.0.4

package/dist/index.d.ts

@@ -8,11 +8,10 @@
 interface RegistryEntry {
   /** Human-readable display name (e.g. 'Alfe Voice') */
   name?: string;
-  repo: string;
-  /** GitHub repository URL (HTTPS, no .git suffix) for public clone */
-  repository?: string;
-  /** Pinned commit SHA — when present, install uses this exact commit instead of a tag */
-  commit?: string;
+  /** GitHub repository URL (HTTPS) for public clone */
+  repository: string;
+  /** Git commit SHA — installer clones and checks out this exact commit */
+  commit: string;
   /** Subdirectory within the repo where the integration lives (for monorepos) */
   subdir?: string;
   versions: string[];
@@ -58,14 +57,21 @@ interface RegistryIndex {
   version: number;
   integrations: Record<string, RegistryEntry>;
 }
+/**
+ * Fetcher function that returns the raw integrations array from the registry API.
+ * Callers wire this up using their api-client instance so Registry stays dependency-free.
+ */
+type RegistryFetcher = () => Promise<(RegistryEntry & {
+  id: string;
+})[]>;
 declare class Registry {
   private index;
-  private apiUrl;
+  private fetcher;
   /**
-   * @param apiUrl - Base URL for the Alfe API (e.g. "https://api.alfe.ai").
-   *                 Falls back to ALFE_API_URL env var, then the production URL.
+   * @param fetcher - Function that fetches the integrations array from the registry API.
+   *                  Typically backed by api-client's IntegrationsService.getRegistry().
    */
-  constructor(apiUrl?: string);
+  constructor(fetcher: RegistryFetcher);
   /**
    * Load the registry index. Uses cache if already loaded.
    */
@@ -96,11 +102,10 @@ declare class Registry {
 interface ResolvedIntegration {
   id: string;
   name?: string;
-  repo: string;
+  repository: string;
   version: string;
-  tag: string;
-  /** Pinned commit SHA — when present, installer uses this instead of tag */
-  commit?: string;
+  /** Git commit SHA to checkout after clone */
+  commit: string;
   /** Subdirectory within the repo where the integration lives (for monorepos) */
   subdir?: string;
   description: string;
@@ -116,7 +121,7 @@ declare class Resolver {
    *
    * @param name - Integration name (e.g. "discord")
    * @param version - Specific version (e.g. "1.0.0") or undefined for latest
-   * @returns Resolved integration with repo URL and git tag
+   * @returns Resolved integration with repo URL and commit hash
    */
   resolve(id: string, version?: string): Promise<ResolvedIntegration>;
   /**
@@ -158,7 +163,7 @@ declare class Installer {
    */
   getClonePath(name: string): string;
   /**
-   * Install an integration by cloning its git repo and checking out the version tag.
+   * Install an integration by cloning its git repo and checking out the pinned commit.
    * Returns the effective install path (with subdir if present).
    */
   install(resolved: ResolvedIntegration): Promise<string>;
@@ -280,6 +285,8 @@ interface IntegrationManifest {
   config_schema: ConfigSchemaField[];
   capabilities: string[];
   hooks: IntegrationHooks;
+  /** Git repository URL (HTTPS, with .git suffix) — used by installer to clone */
+  repository: string;
   /**
    * Agent runtimes this integration supports.
    * If omitted or empty, the integration is considered universal (all runtimes).
@@ -364,6 +371,8 @@ interface IntegrationManagerOptions {
   runtimeAppliers?: Map<string, RuntimeApplier>;
   /** Override lock file path (defaults to ~/.alfe/runtime-lock.json) */
   lockPath?: string;
+  /** Fetcher for the integration registry — should be wired to api-client */
+  registryFetcher: RegistryFetcher;
 }
 interface ManagerResponse {
   ok: boolean;
@@ -400,7 +409,7 @@ declare class IntegrationManager {
   private lockManager;
   /** In-memory secret store — NEVER persisted to disk */
   private secrets;
-  constructor(options?: IntegrationManagerOptions);
+  constructor(options: IntegrationManagerOptions);
   /**
    * Install an integration from the registry.
    *
@@ -714,4 +723,4 @@ declare class IntegrationManagerAdapter implements IIntegrationManager {
   uninstall(integrationId: string): Promise<void>;
 }
 //#endregion
-export { type HookEnvOptions, type HookResult, type IIntegrationManager, type InstalledInfo, Installer, InstallerError, type IntegrationConfigureParams, type IntegrationHealthParams, type IntegrationInfo, type IntegrationInstallParams, IntegrationManager, IntegrationManagerAdapter, type IntegrationManagerOptions, type IntegrationRemoveParams, LockManager, OpenClawApplier, type OpenClawApplierOptions, Registry, type RegistryEntry, type RegistryIndex, RegistryResolveError, type ResolvedIntegration, Resolver, type RuntimeApplier, type RuntimeDesiredState, type RuntimeLockFile, type RuntimePluginEntry, type RuntimeSkillEntry, StateManager, buildHookEnv, resolveInstallsForRuntime, runHook, runHookWithContext };
+export { type HookEnvOptions, type HookResult, type IIntegrationManager, type InstalledInfo, Installer, InstallerError, type IntegrationConfigureParams, type IntegrationHealthParams, type IntegrationInfo, type IntegrationInstallParams, IntegrationManager, IntegrationManagerAdapter, type IntegrationManagerOptions, type IntegrationRemoveParams, LockManager, OpenClawApplier, type OpenClawApplierOptions, Registry, type RegistryEntry, type RegistryFetcher, type RegistryIndex, RegistryResolveError, type ResolvedIntegration, Resolver, type RuntimeApplier, type RuntimeDesiredState, type RuntimeLockFile, type RuntimePluginEntry, type RuntimeSkillEntry, StateManager, buildHookEnv, resolveInstallsForRuntime, runHook, runHookWithContext };

package/dist/index.js

@@ -6,37 +6,27 @@ import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, write
 import { buildConfigValidationSchema, parseManifestFile } from "@alfe.ai/integration-manifest";
 import { createLogger } from "@auriclabs/logger";
 //#region src/registry.ts
-const DEFAULT_API_URL = "https://api.alfe.ai";
-const REGISTRY_PATH = "/integrations/registry";
 var Registry = class {
 	index = null;
-	apiUrl;
+	fetcher;
 	/**
-	* @param apiUrl - Base URL for the Alfe API (e.g. "https://api.alfe.ai").
-	*                 Falls back to ALFE_API_URL env var, then the production URL.
+	* @param fetcher - Function that fetches the integrations array from the registry API.
+	*                  Typically backed by api-client's IntegrationsService.getRegistry().
 	*/
-	constructor(apiUrl) {
-		this.apiUrl = (apiUrl ?? process.env.ALFE_API_URL ?? DEFAULT_API_URL).replace(/\/+$/, "");
+	constructor(fetcher) {
+		this.fetcher = fetcher;
 	}
 	/**
 	* Load the registry index. Uses cache if already loaded.
 	*/
 	async load() {
 		if (this.index) return this.index;
-		const url = `${this.apiUrl}${REGISTRY_PATH}`;
-		const res = await fetch(url);
-		if (!res.ok) throw new Error(`Failed to fetch registry index from ${url}: ${String(res.status)} ${res.statusText}`);
-		const body = await res.json();
-		if (!body.success || !body.data?.integrations) throw new Error(`Invalid registry response from ${url}`);
-		const raw = body.data.integrations;
-		let integrations;
-		if (Array.isArray(raw)) {
-			integrations = {};
-			for (const entry of raw) {
-				const { id, ...rest } = entry;
-				integrations[id] = rest;
-			}
-		} else integrations = raw;
+		const raw = await this.fetcher();
+		const integrations = {};
+		for (const entry of raw) {
+			const { id, ...rest } = entry;
+			integrations[id] = rest;
+		}
 		this.index = {
 			version: 1,
 			integrations
@@ -93,19 +83,18 @@ var Resolver = class {
 	*
 	* @param name - Integration name (e.g. "discord")
 	* @param version - Specific version (e.g. "1.0.0") or undefined for latest
-	* @returns Resolved integration with repo URL and git tag
+	* @returns Resolved integration with repo URL and commit hash
 	*/
 	async resolve(id, version) {
 		const entry = await this.registry.get(id);
 		if (!entry) throw new RegistryResolveError(`Integration "${id}" not found in registry`);
-		const resolvedVersion = version ?? entry.latest;
+		const resolvedVersion = version && version.length > 0 ? version : entry.latest;
 		if (!entry.versions.includes(resolvedVersion)) throw new RegistryResolveError(`Version "${resolvedVersion}" not found for integration "${id}". Available versions: ${entry.versions.join(", ")}`);
 		return {
 			id,
 			name: entry.name,
-			repo: entry.repository ? `${entry.repository}.git` : entry.repo,
+			repository: entry.repository,
 			version: resolvedVersion,
-			tag: `v${resolvedVersion}`,
 			commit: entry.commit,
 			subdir: entry.subdir,
 			description: entry.description
@@ -129,10 +118,10 @@ var Resolver = class {
 //#endregion
 //#region src/installer.ts
 /**
-* Installer — git clone/fetch integrations to ~/.alfe/integrations/{name}/.
+* Installer — git clone integrations to ~/.alfe/integrations/{name}/.
 *
 * Manages the local installation directory for integration repos.
-* Each integration is a shallow git clone checked out to a version tag.
+* Each integration is cloned and checked out to a pinned commit hash.
 */
 const execFileAsync$1 = promisify(execFile);
 const INTEGRATIONS_DIR = join(homedir(), ".alfe", "integrations");
@@ -170,7 +159,7 @@ var Installer = class {
 		return join(this.basePath, name);
 	}
 	/**
-	* Install an integration by cloning its git repo and checking out the version tag.
+	* Install an integration by cloning its git repo and checking out the pinned commit.
 	* Returns the effective install path (with subdir if present).
 	*/
 	async install(resolved) {
@@ -179,25 +168,15 @@ var Installer = class {
 		if (resolved.subdir) this.subdirs.set(resolved.id, resolved.subdir);
 		mkdirSync(this.basePath, { recursive: true });
 		try {
-			if (resolved.commit) {
-				await execFileAsync$1("git", [
-					"clone",
-					resolved.repo,
-					clonePath
-				], { timeout: GIT_TIMEOUT_MS });
-				await execFileAsync$1("git", ["checkout", resolved.commit], {
-					cwd: clonePath,
-					timeout: GIT_TIMEOUT_MS
-				});
-			} else await execFileAsync$1("git", [
+			await execFileAsync$1("git", [
 				"clone",
-				"--depth",
-				"1",
-				"--branch",
-				resolved.tag,
-				resolved.repo,
+				resolved.repository,
 				clonePath
 			], { timeout: GIT_TIMEOUT_MS });
+			await execFileAsync$1("git", ["checkout", resolved.commit], {
+				cwd: clonePath,
+				timeout: GIT_TIMEOUT_MS
+			});
 		} catch (err) {
 			if (existsSync(clonePath)) rmSync(clonePath, {
 				recursive: true,
@@ -218,18 +197,11 @@ var Installer = class {
 		if (resolved.subdir) this.subdirs.set(name, resolved.subdir);
 		else this.subdirs.delete(name);
 		try {
-			await execFileAsync$1("git", [
-				"fetch",
-				"--depth",
-				"1",
-				"origin",
-				`tag`,
-				resolved.tag
-			], {
+			await execFileAsync$1("git", ["fetch", "origin"], {
 				cwd: clonePath,
 				timeout: GIT_TIMEOUT_MS
 			});
-			await execFileAsync$1("git", ["checkout", resolved.tag], {
+			await execFileAsync$1("git", ["checkout", resolved.commit], {
 				cwd: clonePath,
 				timeout: GIT_TIMEOUT_MS
 			});
@@ -686,12 +658,12 @@ var IntegrationManager = class {
 	/** In-memory secret store — NEVER persisted to disk */
 	secrets = /* @__PURE__ */ new Map();
 	constructor(options) {
-		this.state = new StateManager(options?.statePath);
-		this.registry = new Registry();
+		this.state = new StateManager(options.statePath);
+		this.registry = new Registry(options.registryFetcher);
 		this.resolver = new Resolver(this.registry);
-		this.installer = new Installer(options?.integrationsDir);
-		this.runtimeAppliers = options?.runtimeAppliers ?? /* @__PURE__ */ new Map();
-		this.lockManager = new LockManager(options?.lockPath);
+		this.installer = new Installer(options.integrationsDir);
+		this.runtimeAppliers = options.runtimeAppliers ?? /* @__PURE__ */ new Map();
+		this.lockManager = new LockManager(options.lockPath);
 	}
 	/**
 	* Install an integration from the registry.
@@ -721,7 +693,7 @@ var IntegrationManager = class {
 		});
 		try {
 			const resolved = await this.resolver.resolve(name, version);
-			this.log.info(`Resolved ${name}@${resolved.version} from ${resolved.repo}`);
+			this.log.info(`Resolved ${name}@${resolved.version} from ${resolved.repository}`);
 			const installPath = await this.installer.install(resolved);
 			this.log.info(`Cloned to ${installPath}`);
 			const manifestPath = join(installPath, "alfe-integration.yaml");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integrations",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "@auriclabs/logger": "^0.1.1",
-    "@alfe.ai/integration-manifest": "^0.0.2"
+    "@alfe.ai/integration-manifest": "^0.0.3"
   },
   "files": [
     "dist"