@remixhq/core 0.1.21 → 0.1.22

package/dist/api.d.ts

@@ -278,10 +278,227 @@ type ReconcilePreflightResponse = {
 type OrganizationMemberRole = "owner" | "admin" | "member" | "viewer";
 type ProjectMemberRole = "owner" | "maintainer" | "editor" | "viewer";
 type AppMemberRole = "owner" | "maintainer" | "editor" | "viewer";
+type ProjectRuntimeEnvScope = {
+    repoFingerprint: string;
+    environment?: string;
+    target?: string;
+};
+type ProjectRuntimeEnvMetadata = {
+    id: string;
+    projectId: string;
+    repoFingerprint: string;
+    environment: string;
+    target: string;
+    name: string;
+    inheritancePolicy: string;
+    createdBy: string;
+    updatedBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    version: number;
+};
+type SetProjectRuntimeEnvPayload = ProjectRuntimeEnvScope & {
+    value: string;
+    inheritancePolicy?: "project_family" | "none";
+};
+type ImportProjectRuntimeEnvPayload = ProjectRuntimeEnvScope & {
+    content?: string;
+    entries?: Record<string, string>;
+    inheritancePolicy?: "project_family" | "none";
+};
+type ResolveProjectRuntimeEnvForLocalPullResponse = {
+    content: string;
+    names: string[];
+};
+type RuntimeTargetKind = "web" | "cli" | "mobile" | "test" | "worker";
+type RuntimeCommandKind = "install" | "dev" | "build" | "preview" | "test" | "custom";
+type ProjectRuntimeTargetScope = {
+    repoFingerprint: string;
+    environment?: string;
+};
+type ProjectRuntimeTargetMetadata = ProjectRuntimeTargetScope & {
+    id?: string;
+    projectId?: string;
+    targetId: string;
+    targetKind: RuntimeTargetKind;
+    commandKind: RuntimeCommandKind;
+    command: string;
+    cwd: string;
+    port: number | null;
+    readiness: Record<string, unknown>;
+    inheritancePolicy?: "project_family" | "none";
+    enabled: boolean;
+    version?: number;
+};
+type SetProjectRuntimeTargetPayload = ProjectRuntimeTargetScope & {
+    targetKind: RuntimeTargetKind;
+    commandKind: RuntimeCommandKind;
+    command: string;
+    cwd?: string;
+    port?: number | null;
+    readiness?: Record<string, unknown>;
+    inheritancePolicy?: "project_family" | "none";
+    enabled?: boolean;
+};
+type DetectProjectRuntimeTargetsPayload = Partial<ProjectRuntimeTargetScope> & {
+    appId?: string;
+    files?: Record<string, string | null>;
+    apply?: boolean;
+};
+type RunAppRuntimeTargetPayload = {
+    forceInstall?: boolean;
+    forceRestart?: boolean;
+    environment?: string;
+};
+type RunAppSandboxCommandPayload = {
+    command: string;
+    cwd?: string;
+    timeoutMs?: number;
+    environment?: string;
+};
+type AppSandboxCommandRun = {
+    id: string;
+    appId: string;
+    actorUserId: string | null;
+    sandboxExternalId: string;
+    command: string;
+    cwd: string;
+    environment: string;
+    status: "succeeded" | "failed" | "timed_out";
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    metadata: Record<string, unknown> | null;
+};
+type TriggerIntegrationStatus = "available" | "planned";
+type TriggerEventMetadata = {
+    eventType: string;
+    label: string;
+    category: string;
+    description: string;
+    integrationStatus: TriggerIntegrationStatus;
+};
+type TriggerMode = "blocking" | "async";
+type TriggerStepType = "shell" | "runtime_target";
+type TriggerEventSource = "backend" | "cli" | "cursor_plugin" | "claude_plugin" | "dashboard" | "mcp";
+type ProjectTriggerScope = {
+    repoFingerprint: string;
+    environment?: string;
+    eventType?: string;
+};
+type ProjectTriggerStepPayload = {
+    name?: string | null;
+    type: TriggerStepType;
+    command?: string | null;
+    runtimeTargetId?: string | null;
+    cwd?: string | null;
+    timeoutMs?: number | null;
+    continueOnFailure?: boolean;
+    env?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+};
+type ProjectTriggerPayload = ProjectTriggerScope & {
+    eventType: string;
+    name: string;
+    description?: string | null;
+    enabled?: boolean;
+    mode?: TriggerMode;
+    priority?: number;
+    steps?: ProjectTriggerStepPayload[];
+};
+type UpdateProjectTriggerPayload = Partial<ProjectTriggerPayload>;
+type RunAppTriggerPayload = {
+    eventSource?: TriggerEventSource;
+    eventContext?: Record<string, unknown>;
+    correlationId?: string | null;
+};
+type RunAppTriggerEventPayload = RunAppTriggerPayload & {
+    eventType: string;
+    environment?: string;
+};
+type ProjectTriggerStep = {
+    id: string;
+    triggerId: string;
+    position: number;
+    name: string | null;
+    type: string;
+    command: string | null;
+    runtimeTargetId: string | null;
+    cwd: string | null;
+    timeoutMs: number | null;
+    continueOnFailure: boolean;
+    env: Json;
+    metadata: Json;
+    createdAt: string;
+    updatedAt: string;
+};
+type ProjectTrigger = {
+    id: string;
+    projectId: string;
+    repoFingerprint: string;
+    environment: string;
+    eventType: string;
+    name: string;
+    description: string | null;
+    enabled: boolean;
+    mode: string;
+    priority: number;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    steps: ProjectTriggerStep[];
+};
+type TriggerStepRun = {
+    id: string;
+    triggerRunId: string;
+    triggerStepId: string | null;
+    position: number;
+    status: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+    durationMs: number | null;
+    typeSnapshot: string;
+    commandSnapshot: string | null;
+    runtimeTargetIdSnapshot: string | null;
+    cwdSnapshot: string | null;
+    timeoutMsSnapshot: number | null;
+    executorType: string;
+    executorId: string | null;
+    appId: string | null;
+    sandboxExternalId: string | null;
+    localRepoRoot: string | null;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    linkedSandboxCommandRunId: string | null;
+    metadata: Json;
+    createdAt: string;
+};
+type TriggerRun = {
+    id: string;
+    triggerId: string | null;
+    projectId: string;
+    appId: string | null;
+    eventType: string;
+    eventSource: string;
+    eventContext: Json;
+    mode: string;
+    status: string;
+    correlationId: string | null;
+    createdBy: string | null;
+    startedAt: string | null;
+    finishedAt: string | null;
+    createdAt: string;
+    stepRuns: TriggerStepRun[];
+};
 type AppContextAccessPath = "public" | "app_member" | "project_member" | "org_member";
 type AppContext = {
     appId: string;
     projectId: string;
+    repoFingerprint: string | null;
     organizationId: string;
     visibility: "public" | "private";
     accessPath: AppContextAccessPath;
@@ -370,6 +587,46 @@ type ApiClient = {
         clientAppId?: string;
     }): Promise<Json>;
     getProject(projectId: string): Promise<Json>;
+    listProjectRuntimeEnv(projectId: string, params: ProjectRuntimeEnvScope): Promise<Json>;
+    setProjectRuntimeEnv(projectId: string, name: string, payload: SetProjectRuntimeEnvPayload): Promise<Json>;
+    importProjectRuntimeEnv(projectId: string, payload: ImportProjectRuntimeEnvPayload): Promise<Json>;
+    deleteProjectRuntimeEnv(projectId: string, name: string, params: ProjectRuntimeEnvScope): Promise<Json>;
+    resolveProjectRuntimeEnvForLocalPull(projectId: string, payload: ProjectRuntimeEnvScope): Promise<ResolveProjectRuntimeEnvForLocalPullResponse | Json>;
+    listProjectRuntimeTargets(projectId: string, params: ProjectRuntimeTargetScope): Promise<Json>;
+    detectProjectRuntimeTargets(projectId: string, payload: DetectProjectRuntimeTargetsPayload): Promise<Json>;
+    setProjectRuntimeTarget(projectId: string, targetId: string, payload: SetProjectRuntimeTargetPayload): Promise<Json>;
+    deleteProjectRuntimeTarget(projectId: string, targetId: string, params: ProjectRuntimeTargetScope): Promise<Json>;
+    runAppRuntimeTarget(appId: string, targetId: string, payload?: RunAppRuntimeTargetPayload): Promise<Json>;
+    getAppRuntimeTargetStatus(appId: string, targetId: string, params?: {
+        environment?: string;
+    }): Promise<Json>;
+    getAppRuntimeTargetLogs(appId: string, targetId: string, params?: {
+        environment?: string;
+        limit?: number;
+    }): Promise<Json>;
+    stopAppRuntimeTarget(appId: string, targetId: string, payload?: {
+        environment?: string;
+    }): Promise<Json>;
+    runAppSandboxCommand(appId: string, payload: RunAppSandboxCommandPayload): Promise<Json>;
+    listAppSandboxCommandHistory(appId: string, params?: {
+        limit?: number;
+    }): Promise<Json>;
+    listProjectTriggerEvents(projectId: string): Promise<Json>;
+    listProjectTriggers(projectId: string, params?: Partial<ProjectTriggerScope>): Promise<Json>;
+    createProjectTrigger(projectId: string, payload: ProjectTriggerPayload): Promise<Json>;
+    updateProjectTrigger(projectId: string, triggerId: string, payload: UpdateProjectTriggerPayload): Promise<Json>;
+    deleteProjectTrigger(projectId: string, triggerId: string): Promise<Json>;
+    resolveProjectTriggers(projectId: string, params: ProjectTriggerScope & {
+        eventType: string;
+    }): Promise<Json>;
+    runAppTrigger(appId: string, triggerId: string, payload?: RunAppTriggerPayload): Promise<Json>;
+    runAppTriggerEvent(appId: string, payload: RunAppTriggerEventPayload): Promise<Json>;
+    listProjectTriggerRuns(projectId: string, params?: {
+        limit?: number;
+        eventType?: string;
+        appId?: string;
+    }): Promise<Json>;
+    getProjectTriggerRun(projectId: string, runId: string): Promise<Json>;
     resolveProjectBinding(params: {
         repoFingerprint?: string;
         remoteUrl?: string;
@@ -782,4 +1039,4 @@ declare function createApiClient(config: CoreConfig, opts?: {
     defaultRequestTimeoutMs?: number;
 }): ApiClient;
 
-export { type AgentMemoryItem, type AgentMemoryKind, type AgentMemorySearchItem, type AgentMemorySearchResponse, type AgentMemorySummary, type AgentMemoryTimelineResponse, type ApiClient, type AppContext, type AppContextAccessPath, type AppReconcileResponse, type Bundle, type BundlePlatform, type BundleStatus, type ChangeStepDiffResponse, type HistoricalTurnRecord, type HistoryImportCaptureSource, type HistoryImportProvider, type HistoryImportRecordMetadata, type HistoryImportWorkspaceMetadata, type ImportHistoryRecordOutcome, type ImportHistoryRequest, type ImportHistoryResponse, type InitiateBundleRequest, type InvitationRecord, type MergeRequest, type MergeRequestReview, type MergeRequestStatus, type ReconcilePreflightResponse, type SyncLocalResponse, type SyncUpstreamResponse, createApiClient };
+export { type AgentMemoryItem, type AgentMemoryKind, type AgentMemorySearchItem, type AgentMemorySearchResponse, type AgentMemorySummary, type AgentMemoryTimelineResponse, type ApiClient, type AppContext, type AppContextAccessPath, type AppReconcileResponse, type AppSandboxCommandRun, type Bundle, type BundlePlatform, type BundleStatus, type ChangeStepDiffResponse, type DetectProjectRuntimeTargetsPayload, type HistoricalTurnRecord, type HistoryImportCaptureSource, type HistoryImportProvider, type HistoryImportRecordMetadata, type HistoryImportWorkspaceMetadata, type ImportHistoryRecordOutcome, type ImportHistoryRequest, type ImportHistoryResponse, type ImportProjectRuntimeEnvPayload, type InitiateBundleRequest, type InvitationRecord, type MergeRequest, type MergeRequestReview, type MergeRequestStatus, type ProjectRuntimeEnvMetadata, type ProjectRuntimeEnvScope, type ProjectRuntimeTargetMetadata, type ProjectRuntimeTargetScope, type ProjectTrigger, type ProjectTriggerPayload, type ProjectTriggerScope, type ProjectTriggerStep, type ProjectTriggerStepPayload, type ReconcilePreflightResponse, type ResolveProjectRuntimeEnvForLocalPullResponse, type RunAppRuntimeTargetPayload, type RunAppSandboxCommandPayload, type RunAppTriggerEventPayload, type RunAppTriggerPayload, type RuntimeCommandKind, type RuntimeTargetKind, type SetProjectRuntimeEnvPayload, type SetProjectRuntimeTargetPayload, type SyncLocalResponse, type SyncUpstreamResponse, type TriggerEventMetadata, type TriggerEventSource, type TriggerIntegrationStatus, type TriggerMode, type TriggerRun, type TriggerStepRun, type TriggerStepType, type UpdateProjectTriggerPayload, createApiClient };

package/dist/api.js

@@ -1,6 +1,6 @@
 import {
   createApiClient
-} from "./chunk-YENZA6QR.js";
+} from "./chunk-DZRFUAOL.js";
 import "./chunk-7XJGOKEO.js";
 export {
   createApiClient

package/dist/auth.js

@@ -4,7 +4,7 @@ import {
   createSupabaseAuthHelpers,
   shouldRefreshSoon,
   storedSessionSchema
-} from "./chunk-XETDXVGM.js";
+} from "./chunk-MAM4CGDF.js";
 import "./chunk-7XJGOKEO.js";
 export {
   createLocalSessionStore,

package/dist/binding.js

@@ -3,7 +3,7 @@ import {
   readCollabBinding,
   readCollabBindingState,
   writeCollabBinding
-} from "./chunk-DBVN42RF.js";
+} from "./chunk-P4XIICU3.js";
 import "./chunk-S4ECO35X.js";
 import "./chunk-GC2MOT3U.js";
 import "./chunk-7XJGOKEO.js";

package/dist/{chunk-YENZA6QR.js → chunk-DZRFUAOL.js}

@@ -58,6 +58,29 @@ function createApiClient(config, opts) {
     const json = await readJsonSafe(res);
     return json ?? null;
   }
+  function runtimeEnvQuery(params) {
+    const qs = new URLSearchParams();
+    if (params?.repoFingerprint) qs.set("repoFingerprint", params.repoFingerprint);
+    if (params?.environment) qs.set("environment", params.environment);
+    if (params?.target) qs.set("target", params.target);
+    return qs.toString();
+  }
+  function runtimeTargetQuery(params) {
+    const qs = new URLSearchParams();
+    if (params?.repoFingerprint) qs.set("repoFingerprint", params.repoFingerprint);
+    if (params?.environment) qs.set("environment", params.environment);
+    if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+    return qs.toString();
+  }
+  function triggerQuery(params) {
+    const qs = new URLSearchParams();
+    if (params?.repoFingerprint) qs.set("repoFingerprint", params.repoFingerprint);
+    if (params?.environment) qs.set("environment", params.environment);
+    if (params?.eventType) qs.set("eventType", params.eventType);
+    if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+    if (params?.appId) qs.set("appId", params.appId);
+    return qs.toString();
+  }
   async function requestBinary(path, init, opts2) {
     if (!tokenProvider) {
       throw new RemixError("API client is missing a token provider.", {
@@ -111,6 +134,120 @@ function createApiClient(config, opts) {
       return request(`/v1/projects${suffix}`, { method: "GET" });
     },
     getProject: (projectId) => request(`/v1/projects/${encodeURIComponent(projectId)}`, { method: "GET" }),
+    listProjectRuntimeEnv: (projectId, params) => {
+      const qs = runtimeEnvQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/repo-env${suffix}`, { method: "GET" });
+    },
+    setProjectRuntimeEnv: (projectId, name, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/repo-env/${encodeURIComponent(name)}`, {
+      method: "PUT",
+      body: JSON.stringify(payload)
+    }),
+    importProjectRuntimeEnv: (projectId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/repo-env/import`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    deleteProjectRuntimeEnv: (projectId, name, params) => {
+      const qs = runtimeEnvQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/repo-env/${encodeURIComponent(name)}${suffix}`, {
+        method: "DELETE"
+      });
+    },
+    resolveProjectRuntimeEnvForLocalPull: (projectId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/repo-env/resolve-local`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    listProjectRuntimeTargets: (projectId, params) => {
+      const qs = runtimeTargetQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/runtime-targets${suffix}`, { method: "GET" });
+    },
+    detectProjectRuntimeTargets: (projectId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/runtime-targets/detect`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    setProjectRuntimeTarget: (projectId, targetId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/runtime-targets/${encodeURIComponent(targetId)}`, {
+      method: "PUT",
+      body: JSON.stringify(payload)
+    }),
+    deleteProjectRuntimeTarget: (projectId, targetId, params) => {
+      const qs = runtimeTargetQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/runtime-targets/${encodeURIComponent(targetId)}${suffix}`, {
+        method: "DELETE"
+      });
+    },
+    runAppRuntimeTarget: (appId, targetId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/runtime-targets/${encodeURIComponent(targetId)}/run`, {
+      method: "POST",
+      body: JSON.stringify(payload ?? {})
+    }),
+    getAppRuntimeTargetStatus: (appId, targetId, params) => {
+      const qs = runtimeTargetQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/runtime-targets/${encodeURIComponent(targetId)}/status${suffix}`, {
+        method: "GET"
+      });
+    },
+    getAppRuntimeTargetLogs: (appId, targetId, params) => {
+      const qs = runtimeTargetQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/runtime-targets/${encodeURIComponent(targetId)}/logs${suffix}`, {
+        method: "GET"
+      });
+    },
+    stopAppRuntimeTarget: (appId, targetId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/runtime-targets/${encodeURIComponent(targetId)}/stop`, {
+      method: "POST",
+      body: JSON.stringify(payload ?? {})
+    }),
+    runAppSandboxCommand: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/sandbox/commands/run`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    listAppSandboxCommandHistory: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (params?.limit !== void 0) qs.set("limit", String(params.limit));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/sandbox/commands/history${suffix}`, { method: "GET" });
+    },
+    listProjectTriggerEvents: (projectId) => request(`/v1/projects/${encodeURIComponent(projectId)}/triggers/events`, { method: "GET" }),
+    listProjectTriggers: (projectId, params) => {
+      const qs = triggerQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/triggers${suffix}`, { method: "GET" });
+    },
+    createProjectTrigger: (projectId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/triggers`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    updateProjectTrigger: (projectId, triggerId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/triggers/${encodeURIComponent(triggerId)}`, {
+      method: "PATCH",
+      body: JSON.stringify(payload)
+    }),
+    deleteProjectTrigger: (projectId, triggerId) => request(`/v1/projects/${encodeURIComponent(projectId)}/triggers/${encodeURIComponent(triggerId)}`, {
+      method: "DELETE"
+    }),
+    resolveProjectTriggers: (projectId, params) => {
+      const qs = triggerQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/triggers/resolve${suffix}`, { method: "GET" });
+    },
+    runAppTrigger: (appId, triggerId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/triggers/${encodeURIComponent(triggerId)}/run`, {
+      method: "POST",
+      body: JSON.stringify(payload ?? {})
+    }),
+    runAppTriggerEvent: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/triggers/run-event`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    listProjectTriggerRuns: (projectId, params) => {
+      const qs = triggerQuery(params);
+      const suffix = qs ? `?${qs}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/triggers/runs${suffix}`, { method: "GET" });
+    },
+    getProjectTriggerRun: (projectId, runId) => request(`/v1/projects/${encodeURIComponent(projectId)}/triggers/runs/${encodeURIComponent(runId)}`, {
+      method: "GET"
+    }),
     resolveProjectBinding: (params) => {
       const qs = new URLSearchParams();
       if (params.repoFingerprint) qs.set("repoFingerprint", params.repoFingerprint);

package/dist/{chunk-XCZRNB35.js → chunk-LGOQVGBB.js}

@@ -5,8 +5,13 @@ import {
 // src/config/model.ts
 import { z } from "zod";
 var DEFAULT_API_URL = "https://api.remix.one";
-var DEFAULT_SUPABASE_URL = "https://xtfxwbckjpfmqubnsusu.supabase.co";
-var DEFAULT_SUPABASE_ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Inh0Znh3YmNranBmbXF1Ym5zdXN1Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjA2MDEyMzAsImV4cCI6MjA3NjE3NzIzMH0.dzWGAWrK4CvrmHVHzf8w7JlUZohdap0ZPnLZnABMV8s";
+var DEFAULT_SUPABASE_URL = "https://iheivdccexqigeoiekvc.supabase.co";
+var DEFAULT_SUPABASE_ANON_KEY = "sb_publishable_YipyrVON-lwzW3ugjE3T1g_cE2do_JW";
+var defaultConfigRaw = {
+  apiUrl: DEFAULT_API_URL,
+  supabaseUrl: DEFAULT_SUPABASE_URL,
+  supabaseAnonKey: DEFAULT_SUPABASE_ANON_KEY
+};
 function isValidUrl(value) {
   try {
     new URL(value);
@@ -24,12 +29,7 @@ var configSchema = z.object({
 var cachedConfig = null;
 async function resolveConfig(_opts) {
   if (cachedConfig) return cachedConfig;
-  const cfgRaw = {
-    apiUrl: DEFAULT_API_URL,
-    supabaseUrl: DEFAULT_SUPABASE_URL,
-    supabaseAnonKey: DEFAULT_SUPABASE_ANON_KEY
-  };
-  const parsedCfg = configSchema.safeParse(cfgRaw);
+  const parsedCfg = configSchema.safeParse(defaultConfigRaw);
   if (!parsedCfg.success) {
     throw new RemixError("Invalid core configuration.", {
       exitCode: 1,

package/dist/{chunk-XETDXVGM.js → chunk-MAM4CGDF.js}

@@ -19,6 +19,7 @@ var storedSessionSchema = z.object({
 import fs from "fs/promises";
 import os from "os";
 import path from "path";
+var loadKeytarModule = () => new Function("return import('keytar')")();
 function xdgConfigHome() {
   const value = process.env.XDG_CONFIG_HOME;
   if (typeof value === "string" && value.trim()) return value;
@@ -26,7 +27,7 @@ function xdgConfigHome() {
 }
 async function maybeLoadKeytar() {
   try {
-    const mod = await new Function("return import('keytar')")();
+    const mod = await loadKeytarModule();
     const candidates = [mod, mod?.default].filter(Boolean);
     for (const candidate of candidates) {
       const value = candidate;

package/dist/{chunk-DBVN42RF.js → chunk-P4XIICU3.js}

@@ -75,6 +75,13 @@ function normalizeProjectId(value) {
   const normalized = String(value ?? "").trim();
   return normalized || null;
 }
+async function readCurrentBranchOrNull(repoRoot) {
+  try {
+    return normalizeBranchName(await getCurrentBranch(repoRoot));
+  } catch {
+    return null;
+  }
+}
 function normalizeBranchBinding(value) {
   if (!value?.currentAppId || !value?.upstreamAppId) return null;
   return {
@@ -121,7 +128,7 @@ async function readCollabBindingState(repoRoot, options) {
     const raw = await fs2.readFile(filePath, "utf8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object") return null;
-    const currentBranch = normalizeBranchName(await getCurrentBranch(repoRoot).catch(() => null));
+    const currentBranch = await readCurrentBranchOrNull(repoRoot);
     if (parsed.schemaVersion === 1) {
       if (!parsed.currentAppId || !parsed.upstreamAppId) return null;
       const projectId = normalizeProjectId(parsed.projectId);
@@ -281,7 +288,7 @@ async function readCollabBinding(repoRoot) {
 }
 async function writeCollabBinding(repoRoot, binding) {
   const filePath = getCollabBindingPath(repoRoot);
-  const currentBranch = normalizeBranchName(await getCurrentBranch(repoRoot).catch(() => null));
+  const currentBranch = await readCurrentBranchOrNull(repoRoot);
   const branchName = normalizeBranchName(binding.branchName) ?? currentBranch ?? binding.defaultBranch ?? "main";
   const existing = await readCollabBindingState(repoRoot, { persist: true });
   const branchBindings = { ...existing?.branchBindings ?? {} };

package/dist/collab.d.ts

@@ -43,6 +43,7 @@ declare function collabFinalizeTurn(params: {
      * When unset/null/0, behavior is unchanged: `nextRetryAt: null`, drain-immediately.
      */
     awaitingUsageDeadlineMs?: number | null;
+    initPostAwaitTimeoutMs?: number | null;
 }): Promise<CollabFinalizeTurnResult>;
 
 declare const FINALIZE_PREFLIGHT_FAILURE_CODES: readonly ["not_bound", "branch_binding_missing", "family_ambiguous", "metadata_conflict", "branch_mismatch", "missing_head", "remote_error", "pull_required", "reconcile_required", "baseline_missing"];

package/dist/collab.js

@@ -8,7 +8,7 @@ import {
   writeCollabBinding,
   writeCollabBindingSnapshot,
   writeJsonAtomic
-} from "./chunk-DBVN42RF.js";
+} from "./chunk-P4XIICU3.js";
 import {
   applyUnifiedDiffToWorktree,
   assertRepoSnapshotUnchanged,
@@ -438,7 +438,7 @@ async function summarizeAsyncJobs(params) {
   summary.newestCreatedAt = active[active.length - 1]?.createdAt ?? null;
   if (summary.processingJobCount > 0) summary.state = "processing";
   else if (summary.queuedJobCount > 0) summary.state = "queued";
-  else if (summary.failedJobCount > 0) summary.state = "failed";
+  else summary.state = "failed";
   return summary;
 }
 async function pruneTerminalAsyncJobs() {
@@ -634,7 +634,9 @@ async function inspectLocalSnapshot(params) {
     repoRoot,
     repoFingerprint: params.repoFingerprint ?? null,
     laneId: params.laneId ?? null,
+    /* v8 ignore next -- branch fallback only applies when git branch lookup races/fails. */
     branchName: params.branchName ?? await getCurrentBranch(repoRoot).catch(() => null),
+    /* v8 ignore next -- commit fallback only applies when git HEAD lookup races/fails. */
     localCommitHash: await getHeadCommitHash(repoRoot).catch(() => null),
     snapshotHash: buildSnapshotHash(normalizedManifest),
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -1027,7 +1029,7 @@ async function summarizePendingFinalizeJobs(scope) {
     summary.state = "retry_scheduled";
   } else if (summary.awaitingUsageJobCount > 0) {
     summary.state = "awaiting_usage";
-  } else if (summary.failedJobCount > 0) {
+  } else {
     summary.state = "failed";
   }
   return summary;
@@ -1685,9 +1687,11 @@ async function ensureActiveLaneBinding(params) {
     return persistResolvedLane(params.repoRoot, resolved.binding);
   }
   if (resolved.status === "binding_conflict") {
+    const serverAppId = resolved.resolvedLane.currentAppId ?? "(unknown)";
+    const operation = params.operation ?? "this command";
     throw new RemixError("Current branch binding conflicts with the server-resolved Remix lane.", {
       exitCode: 2,
-      hint: `Local app ${resolved.binding.currentAppId}; server app ${resolved.resolvedLane.currentAppId ?? "(unknown)"}. Repair the branch binding before running ${params.operation ?? "this command"}.`
+      hint: `Local app ${resolved.binding.currentAppId}; server app ${serverAppId}. Repair the branch binding before running ${operation}.`
     });
   }
   if (resolved.status === "ambiguous_family_selection") {
@@ -1799,12 +1803,15 @@ async function collabDetectRepoState(params) {
     return detected;
   }
   if (bindingResolution.status === "binding_conflict") {
+    const conflictBranch = bindingResolution.currentBranch ?? "(detached)";
+    const conflictLaneId = bindingResolution.resolvedLane.laneId ?? "(unknown)";
+    const conflictAppId = bindingResolution.resolvedLane.currentAppId ?? "(unknown)";
     detected.status = "metadata_conflict";
     detected.repoState = "metadata_conflict";
     detected.binding = bindingResolution.binding;
     detected.currentBranch = bindingResolution.currentBranch;
     detected.branchName = bindingResolution.binding.branchName;
-    detected.hint = `Local binding for ${bindingResolution.currentBranch ?? "(detached)"} points to app ${bindingResolution.binding.currentAppId}, but the server resolved lane ${bindingResolution.resolvedLane.laneId ?? "(unknown)"} / app ${bindingResolution.resolvedLane.currentAppId ?? "(unknown)"}.`;
+    detected.hint = `Local binding for ${conflictBranch} points to app ${bindingResolution.binding.currentAppId}, but the server resolved lane ${conflictLaneId} / app ${conflictAppId}.`;
     return detected;
   }
   const binding = bindingResolution.binding;
@@ -1831,6 +1838,7 @@ async function collabDetectRepoState(params) {
     return detected;
   }
   if (!params.api) {
+    const asyncSummaryBranchName = binding.branchName ?? null;
     const [inspection, pendingFinalize, pendingAsyncJobs] = await Promise.all([
       inspectLocalSnapshot({
         repoRoot,
@@ -1845,7 +1853,7 @@ async function collabDetectRepoState(params) {
         currentAppId: binding.currentAppId,
         laneId: binding.laneId
       }),
-      summarizeAsyncJobs({ repoRoot, branchName: binding.branchName ?? null })
+      summarizeAsyncJobs({ repoRoot, branchName: asyncSummaryBranchName })
     ]);
     detected.currentSnapshotHash = inspection.snapshotHash;
     detected.pendingFinalize = pendingFinalize;
@@ -1866,6 +1874,7 @@ async function collabDetectRepoState(params) {
       remoteUrl: binding.remoteUrl ?? void 0,
       defaultBranch: binding.defaultBranch ?? void 0
     }) : Promise.resolve(null);
+    const asyncSummaryBranchName = binding.branchName ?? null;
     const [headResp, inspection, parallelMetadataResp, pendingFinalize, pendingAsyncJobs] = await Promise.all([
       getAppHeadCached(params.api, binding.currentAppId),
       inspectLocalSnapshot({
@@ -1882,7 +1891,7 @@ async function collabDetectRepoState(params) {
         currentAppId: binding.currentAppId,
         laneId: binding.laneId
       }),
-      summarizeAsyncJobs({ repoRoot, branchName: binding.branchName ?? null })
+      summarizeAsyncJobs({ repoRoot, branchName: asyncSummaryBranchName })
     ]);
     const appHead = unwrapResponseObject(headResp, "app head");
     detected.currentServerRevisionId = appHead.headRevisionId ?? null;
@@ -2670,7 +2679,9 @@ async function processClaimedPendingFinalizeJobInner(params) {
       await writeBaselineFromSucceededChangeStep({ api: params.api, job, snapshot, changeStep: changeStep2 });
       await updatePendingFinalizeJob(job.id, {
         status: "completed",
-        metadata: { changeStepId: String(changeStep2.id ?? "") }
+        metadata: {
+          changeStepId: String(changeStep2.id ?? "")
+        }
       });
       return {
         mode: "changed_turn",
@@ -2785,7 +2796,9 @@ async function processClaimedPendingFinalizeJobInner(params) {
   await writeBaselineFromSucceededChangeStep({ api: params.api, job, snapshot, changeStep });
   await updatePendingFinalizeJob(job.id, {
     status: "completed",
-    metadata: { changeStepId: String(changeStep.id ?? "") }
+    metadata: {
+      changeStepId: String(changeStep.id ?? "")
+    }
   });
   return {
     mode: "changed_turn",
@@ -2901,30 +2914,44 @@ async function collabFinalizeTurn(params) {
       hint: `Init job ${pendingInit.id} is still in the background queue. Run \`remix collab status\` to check progress.`
     });
   }
+  const failedInitPost = await findFailedAsyncJob({
+    repoRoot,
+    branchName: binding.branchName ?? null,
+    kind: "init_post"
+  });
+  if (failedInitPost) {
+    throw new RemixError("The initial Remix import failed; this turn cannot be recorded.", {
+      exitCode: 2,
+      hint: (failedInitPost.error ? `Last error: ${failedInitPost.error}
+
+` : "") + "Run `remix collab init` again to retry \u2014 the post-init drainer cleared the local binding so this is safe."
+    });
+  }
   const pendingInitPost = await findPendingAsyncJob({
     repoRoot,
     branchName: binding.branchName ?? null,
     kind: "init_post"
   });
   if (pendingInitPost) {
+    const initPostTimeoutMs = params.initPostAwaitTimeoutMs ?? FINALIZE_AWAIT_INIT_POST_TIMEOUT_MS;
     const result = await awaitAsyncJob({
       jobId: pendingInitPost.id,
-      timeoutMs: FINALIZE_AWAIT_INIT_POST_TIMEOUT_MS,
+      timeoutMs: initPostTimeoutMs,
       pollIntervalMs: 500
     });
-    if (result.status === "failed") {
-      throw new RemixError("The initial Remix import failed; this turn cannot be recorded.", {
-        exitCode: 2,
-        hint: (result.job?.error ? `Last error: ${result.job.error}
+    if (result.status !== "completed") {
+      if (result.status === "failed") {
+        throw new RemixError("The initial Remix import failed; this turn cannot be recorded.", {
+          exitCode: 2,
+          hint: (result.job?.error ? `Last error: ${result.job.error}
 
 ` : "") + "Run `remix collab init` again to retry \u2014 the post-init drainer cleared the local binding so this is safe."
-      });
-    }
-    if (result.status === "timeout") {
+        });
+      }
       throw new RemixError("Timed out waiting for the initial Remix import to finish provisioning.", {
         exitCode: 2,
         hint: `Init post job ${pendingInitPost.id} did not complete within ${Math.round(
-          FINALIZE_AWAIT_INIT_POST_TIMEOUT_MS / 1e3
+          initPostTimeoutMs / 1e3
         )}s. Run \`remix collab status\` to check progress, then retry once it reports ready.`
       });
     }
@@ -2941,7 +2968,14 @@ async function collabFinalizeTurn(params) {
       hint: detected.hint
     });
   }
-  if (detected.status === "branch_binding_missing" || detected.status === "family_ambiguous") {
+  if (detected.status === "branch_binding_missing") {
+    throw new RemixError(detected.hint || "Current branch is not ready for Remix recording.", {
+      code: detected.status,
+      exitCode: 2,
+      hint: detected.hint
+    });
+  }
+  if (detected.status === "family_ambiguous") {
     throw new RemixError(detected.hint || "Current branch is not ready for Remix recording.", {
       code: detected.status,
       exitCode: 2,
@@ -2956,7 +2990,8 @@ async function collabFinalizeTurn(params) {
     });
   }
   if (detected.status === "missing_head" || detected.status === "remote_error") {
-    throw new RemixError(detected.hint || "Failed to determine the current repo state.", {
+    const message = detected.hint || "Failed to determine the current repo state.";
+    throw new RemixError(message, {
       code: detected.status,
       exitCode: 1,
       hint: detected.hint
@@ -2970,10 +3005,11 @@ async function collabFinalizeTurn(params) {
     });
   }
   if (detected.repoState === "both_changed") {
+    const hint = detected.hint || "Run `remix collab reconcile --dry-run` to inspect recovery options before retrying.";
     throw new RemixError("Local and server changes must be reconciled before finalizing this turn.", {
       code: "reconcile_required",
       exitCode: 2,
-      hint: detected.hint || "Run `remix collab reconcile --dry-run` to inspect recovery options before retrying."
+      hint
     });
   }
   if (detected.repoState === "external_local_base_changed") {
@@ -3237,6 +3273,7 @@ async function tryAcquireLock(lockDir, ownerPath, owner) {
 }
 function formatLockHint(params) {
   const lines = [
+    /* v8 ignore next -- observed-held diagnostic only appears after a timed wait. */
     params.observedHeldLock ? `Observed lock state: ${REMIX_ERROR_CODES.REPO_LOCK_HELD}.` : null,
     params.owner ? `Active operation: ${params.owner.operation}` : "Active operation: unknown",
     params.owner ? `Repo root: ${params.owner.repoRoot}` : null,
@@ -4176,9 +4213,10 @@ function resolveProjectBindingResult(response) {
 function throwAmbiguousFamilyError(params) {
   const familyCount = params.candidateCount || params.projectIds.length;
   const projectHint = params.projectIds.length > 0 ? ` Matching project ids: ${params.projectIds.join(", ")}.` : "";
+  const remoteHint = params.remoteUrl ? ` (${params.remoteUrl})` : "";
   throw new RemixError("Multiple canonical Remix families already match this repository.", {
     exitCode: 2,
-    hint: `Plain \`remix collab init\` cannot safely choose among ${familyCount} matching canonical families for repo fingerprint ${params.repoFingerprint}${params.remoteUrl ? ` (${params.remoteUrl})` : ""}.${projectHint} Run \`remix collab init --force-new\` to create a new canonical family, or continue from a checkout already bound to the intended family.`
+    hint: `Plain \`remix collab init\` cannot safely choose among ${familyCount} matching canonical families for repo fingerprint ${params.repoFingerprint}${remoteHint}.${projectHint} Run \`remix collab init --force-new\` to create a new canonical family, or continue from a checkout already bound to the intended family.`
   });
 }
 async function resolveOrEnsureLaneBinding(params) {
@@ -6212,7 +6250,10 @@ async function processInitJob(job, api) {
       headCommitHash: job.payload.headCommitHash
     });
     const imported = unwrapResponseObject(importResp, "import");
-    await logDrainerEvent(job.id, "server_accepted", { kind: "init", appId: String(imported.appId ?? "") });
+    await logDrainerEvent(job.id, "server_accepted", {
+      kind: "init",
+      appId: String(imported.appId ?? "")
+    });
     const app = await pollAppReady(api, String(imported.appId));
     let boundProjectId = String(app.projectId);
     let boundCurrentAppId = String(app.id);
@@ -6577,7 +6618,10 @@ async function drainAsyncJobs(opts) {
   if (opts.respectPidLock !== false && !lockHandle) return [];
   const outcomes = [];
   try {
-    await pruneTerminalAsyncJobs().catch(() => void 0);
+    try {
+      await pruneTerminalAsyncJobs();
+    } catch {
+    }
     const jobs = await listAsyncJobs();
     const drainable = jobs.filter(
       (job) => job.status !== "completed" && job.status !== "failed"

package/dist/config.js

@@ -1,7 +1,7 @@
 import {
   configSchema,
   resolveConfig
-} from "./chunk-XCZRNB35.js";
+} from "./chunk-LGOQVGBB.js";
 import "./chunk-7XJGOKEO.js";
 export {
   configSchema,

package/dist/index.d.ts

@@ -2,6 +2,6 @@ export { CliError, REMIX_ERROR_CODES, CliError as RemixError, RemixErrorCode } f
 export { CoreConfig, ResolveConfigOptions, configSchema, resolveConfig } from './config.js';
 export { S as SessionStore, a as StoredSession, c as createStoredSessionTokenProvider, s as shouldRefreshSoon, b as storedSessionSchema } from './tokenProvider-BWTusyj4.js';
 export { createLocalSessionStore, createSupabaseAuthHelpers } from './auth.js';
-export { AgentMemoryItem, AgentMemoryKind, AgentMemorySearchItem, AgentMemorySearchResponse, AgentMemorySummary, AgentMemoryTimelineResponse, ApiClient, AppContext, AppContextAccessPath, AppReconcileResponse, Bundle, BundlePlatform, BundleStatus, ChangeStepDiffResponse, InitiateBundleRequest, InvitationRecord, MergeRequest, MergeRequestReview, MergeRequestStatus, ReconcilePreflightResponse, SyncLocalResponse, SyncUpstreamResponse, createApiClient } from './api.js';
+export { AgentMemoryItem, AgentMemoryKind, AgentMemorySearchItem, AgentMemorySearchResponse, AgentMemorySummary, AgentMemoryTimelineResponse, ApiClient, AppContext, AppContextAccessPath, AppReconcileResponse, AppSandboxCommandRun, Bundle, BundlePlatform, BundleStatus, ChangeStepDiffResponse, DetectProjectRuntimeTargetsPayload, ImportProjectRuntimeEnvPayload, InitiateBundleRequest, InvitationRecord, MergeRequest, MergeRequestReview, MergeRequestStatus, ProjectRuntimeEnvMetadata, ProjectRuntimeEnvScope, ProjectRuntimeTargetMetadata, ProjectRuntimeTargetScope, ProjectTrigger, ProjectTriggerPayload, ProjectTriggerScope, ProjectTriggerStep, ProjectTriggerStepPayload, ReconcilePreflightResponse, ResolveProjectRuntimeEnvForLocalPullResponse, RunAppRuntimeTargetPayload, RunAppSandboxCommandPayload, RunAppTriggerEventPayload, RunAppTriggerPayload, RuntimeCommandKind, RuntimeTargetKind, SetProjectRuntimeEnvPayload, SetProjectRuntimeTargetPayload, SyncLocalResponse, SyncUpstreamResponse, TriggerEventMetadata, TriggerEventSource, TriggerIntegrationStatus, TriggerMode, TriggerRun, TriggerStepRun, TriggerStepType, UpdateProjectTriggerPayload, createApiClient } from './api.js';
 import 'zod';
 import './contracts-CuTwLa6w.js';

package/dist/index.js

@@ -1,17 +1,17 @@
 import {
   createApiClient
-} from "./chunk-YENZA6QR.js";
+} from "./chunk-DZRFUAOL.js";
 import {
   createLocalSessionStore,
   createStoredSessionTokenProvider,
   createSupabaseAuthHelpers,
   shouldRefreshSoon,
   storedSessionSchema
-} from "./chunk-XETDXVGM.js";
+} from "./chunk-MAM4CGDF.js";
 import {
   configSchema,
   resolveConfig
-} from "./chunk-XCZRNB35.js";
+} from "./chunk-LGOQVGBB.js";
 import "./chunk-4OCNZHHR.js";
 import {
   REMIX_ERROR_CODES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixhq/core",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "Remix core library",
   "homepage": "https://github.com/RemixDotOne/remix-core",
   "license": "MIT",
@@ -62,6 +62,7 @@
     "build": "tsup src/index.ts src/api.ts src/auth.ts src/binding.ts src/collab.ts src/config.ts src/errors.ts src/history.ts src/repo.ts --dts --format esm --clean",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "prepack": "npm run build"
   },
   "dependencies": {
@@ -71,8 +72,9 @@
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
+    "@vitest/coverage-v8": "^4.1.5",
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
-    "vitest": "^2.1.4"
+    "vitest": "^4.1.5"
   }
 }