@alfe.ai/gateway 0.2.0 → 0.2.1

package/README.md

@@ -161,3 +161,8 @@ See `src/protocol.ts` for full type definitions.
 
 - Dashboard integration management (backend wired, UI in progress)
 - Voice migration to integration model (`packages/openclaw-voice/` exists, not yet full integration)
+
+## Links
+
+- 🌐 Website: <https://alfe.ai>
+- 📚 Docs: <https://docs.alfe.ai>

package/dist/health.js

@@ -495,6 +495,15 @@ var AuthService = class {
 	getSubscriptionStatus() {
 		return this.client.request(`${this.prefix}/subscription`);
 	}
+	/**
+	* Mint a short-lived, single-use Clerk sign-in token for the calling user so
+	* a native client can hand its logged-in session to the web dashboard
+	* (`${dashboard}/handoff?__clerk_ticket=<token>`). Server mints only for the
+	* authenticated user — never a caller-supplied id.
+	*/
+	createHandoffToken() {
+		return this.client.request(`${this.prefix}/handoff-token`, { method: "POST" });
+	}
 	applyForStartup(input) {
 		return this.client.request(`${this.prefix}/subscription/apply-startup`, {
 			method: "POST",
@@ -566,10 +575,8 @@ var AuthService = class {
 //#region ../../packages-internal/api-client/dist/services/integrations.js
 var IntegrationsService = class {
 	client;
-	voiceClient;
-	constructor(client, voiceClient) {
+	constructor(client) {
 		this.client = client;
-		this.voiceClient = voiceClient;
 	}
 	listScopedInstalls(scope, scopeId) {
 		const params = new URLSearchParams({
@@ -618,8 +625,11 @@ var IntegrationsService = class {
 		});
 	}
 	listIntegrations(agentId, options) {
-		const qs = options?.includeInherited ? "?includeInherited=true" : "";
-		return this.client.request(`/integrations/agents/${agentId}${qs}`);
+		const params = new URLSearchParams();
+		if (options?.includeInherited) params.set("includeInherited", "true");
+		if (options?.effective) params.set("effective", "true");
+		const qs = params.toString();
+		return this.client.request(`/integrations/agents/${agentId}${qs ? `?${qs}` : ""}`);
 	}
 	installIntegration(agentId, data) {
 		return this.client.request(`/integrations/agents/${agentId}`, {
@@ -651,10 +661,6 @@ var IntegrationsService = class {
 			body: JSON.stringify({ agentId })
 		});
 	}
-	listVoices() {
-		if (this.voiceClient) return this.voiceClient.request("/api/voices");
-		return this.client.request("/integrations/voices");
-	}
 	getDiscordGuildChannels(guildId) {
 		return this.client.request(`/discord/guilds/${encodeURIComponent(guildId)}/channels`);
 	}
@@ -4483,6 +4489,15 @@ enumValues({
 	NanoClaw: "nanoclaw",
 	Hermes: "hermes"
 });
+const TTS_MODELS = enumValues({
+	ElevenLabsTurbo: "elevenlabs-turbo",
+	ElevenLabsStandard: "elevenlabs-standard"
+});
+object({
+	voiceId: string().regex(/^[A-Za-z0-9]{8,64}$/).optional(),
+	ttsModel: _enum(TTS_MODELS).optional(),
+	enabled: boolean().optional()
+});
 enumValues({
 	Org: "org",
 	Team: "team",
@@ -4769,10 +4784,12 @@ const NotificationType = {
 	SubscriptionCancelled: "subscription.cancelled",
 	SubscriptionPastDue: "subscription.past_due",
 	BalanceThresholdWarning: "balance.threshold.warning",
+	PlatformTierPriceIncrease: "platform.tier_price_increase",
 	AgentCreated: "agent.created",
 	AgentProvisionFailed: "agent.provision.failed",
 	AgentBillingSuspended: "agent.billing.suspended",
 	AgentDisconnectedExtended: "agent.disconnected.extended",
+	BrowserTakeoverRequested: "browser_takeover_requested",
 	InviteCreated: "onboarding.invite.created",
 	OrgClaimed: "onboarding.org.claimed",
 	TeamMemberAdded: "team.member.added",
@@ -4789,7 +4806,7 @@ const RecipientStrategy = {
 	TenantAdmins: "tenant_admins",
 	SpecificUser: "specific_user"
 };
-NotificationType.PaymentSucceeded, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.PaymentFailed, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationChannel.Sms, NotificationType.TopUpCompleted, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AutoRechargeCompleted, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationType.AutoRechargeFailed, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationChannel.Sms, NotificationType.SubscriptionCreated, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationType.SubscriptionCancelled, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.SubscriptionPastDue, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationChannel.Sms, NotificationType.BalanceThresholdWarning, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AgentCreated, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AgentProvisionFailed, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AgentBillingSuspended, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AgentDisconnectedExtended, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Push, NotificationType.InviteCreated, NotificationCategory.System, RecipientStrategy.SpecificUser, NotificationChannel.Email, NotificationType.OrgClaimed, NotificationCategory.System, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.TeamMemberAdded, NotificationCategory.Team, RecipientStrategy.SpecificUser, NotificationChannel.Email, NotificationChannel.Push, NotificationType.ProjectMemberAdded, NotificationCategory.Team, RecipientStrategy.SpecificUser, NotificationChannel.Email, NotificationChannel.Push, NotificationType.IntegrationInstalled, NotificationCategory.Integrations, RecipientStrategy.TenantAdmins, NotificationChannel.Push, NotificationType.IntegrationRemoved, NotificationCategory.Integrations, RecipientStrategy.TenantAdmins, NotificationChannel.Push;
+NotificationType.PaymentSucceeded, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.PaymentFailed, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationChannel.Sms, NotificationType.TopUpCompleted, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AutoRechargeCompleted, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationType.AutoRechargeFailed, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationChannel.Sms, NotificationType.SubscriptionCreated, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationType.SubscriptionCancelled, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.SubscriptionPastDue, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationChannel.Sms, NotificationType.BalanceThresholdWarning, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.PlatformTierPriceIncrease, NotificationCategory.Billing, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationType.AgentCreated, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AgentProvisionFailed, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AgentBillingSuspended, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.AgentDisconnectedExtended, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Push, NotificationType.BrowserTakeoverRequested, NotificationCategory.Agents, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.InviteCreated, NotificationCategory.System, RecipientStrategy.SpecificUser, NotificationChannel.Email, NotificationType.OrgClaimed, NotificationCategory.System, RecipientStrategy.TenantAdmins, NotificationChannel.Email, NotificationChannel.Push, NotificationType.TeamMemberAdded, NotificationCategory.Team, RecipientStrategy.SpecificUser, NotificationChannel.Email, NotificationChannel.Push, NotificationType.ProjectMemberAdded, NotificationCategory.Team, RecipientStrategy.SpecificUser, NotificationChannel.Email, NotificationChannel.Push, NotificationType.IntegrationInstalled, NotificationCategory.Integrations, RecipientStrategy.TenantAdmins, NotificationChannel.Push, NotificationType.IntegrationRemoved, NotificationCategory.Integrations, RecipientStrategy.TenantAdmins, NotificationChannel.Push;
 //#endregion
 //#region src/config.ts
 /**
@@ -5047,6 +5064,7 @@ async function fetchAgentConfig(apiKey, apiEndpoint) {
 		const wsResult = await wsResponse.json();
 		const templateKey = wsResult.data?.templateKey;
 		const defaultModel = wsResult.data?.defaultModel ?? void 0;
+		const installedFrom = wsResult.data?.installedFrom;
 		if (!templateKey) {
 			logger$1.debug("No templateKey in workspace response");
 			return defaultModel ? {
@@ -5054,8 +5072,14 @@ async function fetchAgentConfig(apiKey, apiEndpoint) {
 				files: {}
 			} : null;
 		}
-		logger$1.debug({ templateKey }, "Fetching template files...");
-		const filesResponse = await fetch(`${apiEndpoint}/templates/${encodeURIComponent(templateKey)}/files`, {
+		const pinnedVersion = installedFrom?.templateKey === templateKey ? installedFrom.version : void 0;
+		const filesUrl = new URL(`${apiEndpoint}/templates/${encodeURIComponent(templateKey)}/files`);
+		if (pinnedVersion !== void 0) filesUrl.searchParams.set("version", String(pinnedVersion));
+		logger$1.debug({
+			templateKey,
+			version: pinnedVersion
+		}, "Fetching template files...");
+		const filesResponse = await fetch(filesUrl.toString(), {
 			method: "GET",
 			headers: { "Authorization": `Bearer ${apiKey}` }
 		});
@@ -5067,16 +5091,18 @@ async function fetchAgentConfig(apiKey, apiEndpoint) {
 				files: {}
 			};
 		}
-		const filesResult = await filesResponse.json();
-		const fileCount = Object.keys(filesResult.data?.files ?? {}).length;
+		const files = (await filesResponse.json()).data?.files ?? {};
+		const fileCount = Object.keys(files).length;
 		logger$1.debug({
 			templateKey,
+			version: pinnedVersion,
 			fileCount
 		}, "Template files fetched");
 		return {
 			templateKey,
 			defaultModel,
-			files: filesResult.data?.files ?? {}
+			files,
+			personaFiles: Object.keys(files)
 		};
 	} catch (err) {
 		logger$1.debug({ err: err instanceof Error ? err.message : String(err) }, "fetchAgentConfig failed");

package/dist/src/index.d.ts

@@ -60,6 +60,18 @@ interface AgentWorkspaceConfig {
   templateKey?: string;
   defaultModel?: string;
   files: Record<string, string>;
+  /**
+   * Filenames within `files` that are agent-owned persona files (SOUL.md,
+   * IDENTITY.md, AGENTS.md, USER.md, BOOTSTRAP.md, …). The consumer
+   * (`writeWorkspaceFiles`) seeds these ONLY IF ABSENT so an agent's own edits
+   * — restored by the openclaw-sync backup on a fresh VM — are never clobbered
+   * by a setup-time re-seed. Filenames NOT in this set keep overwrite-on-write
+   * semantics. The templates `/files` endpoint returns persona files
+   * exclusively today, so `fetchAgentConfig` populates this with every key; the
+   * field is threaded explicitly rather than assumed so a future workspace-file
+   * source can mix persona (seed-if-missing) and non-persona (overwrite) files.
+   */
+  personaFiles?: string[];
 }
 declare const ALFE_DIR: string;
 declare const SOCKET_PATH: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/gateway",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Alfe local gateway daemon — persistent control plane for agent integrations",
   "type": "module",
   "bin": {
@@ -22,14 +22,22 @@
     "pino-roll": "^1.2.0",
     "smol-toml": ">=1.6.1",
     "ws": "^8.18.0",
-    "@alfe.ai/agent-api-client": "^0.3.0",
-    "@alfe.ai/ai-proxy-local": "^0.0.11",
-    "@alfe.ai/config": "^0.1.0",
-    "@alfe.ai/integration-manifest": "^0.3.0",
-    "@alfe.ai/integrations": "^0.2.0",
-    "@alfe.ai/mcp-bundler": "^0.2.1"
+    "@alfe.ai/agent-api-client": "^0.4.0",
+    "@alfe.ai/ai-proxy-local": "^0.0.12",
+    "@alfe.ai/config": "^0.2.0",
+    "@alfe.ai/integration-manifest": "^0.3.1",
+    "@alfe.ai/integrations": "^0.2.4",
+    "@alfe.ai/mcp-bundler": "^0.2.2"
   },
   "license": "UNLICENSED",
+  "homepage": "https://alfe.ai",
+  "author": "Alfe (https://alfe.ai)",
+  "keywords": [
+    "alfe",
+    "ai-agents",
+    "agent",
+    "llm"
+  ],
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",