@remixhq/core 0.1.8 → 0.1.10

package/dist/chunk-XC2FV57P.js

@@ -0,0 +1,385 @@
+import {
+  RemixError
+} from "./chunk-YZ34ICNN.js";
+
+// src/api/client.ts
+async function readJsonSafe(res) {
+  const ct = res.headers.get("content-type") ?? "";
+  if (!ct.toLowerCase().includes("application/json")) return null;
+  try {
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+function createApiClient(config, opts) {
+  const apiKey = (opts?.apiKey ?? "").trim();
+  const tokenProvider = opts?.tokenProvider;
+  const CLIENT_KEY_HEADER = "x-comerge-api-key";
+  async function request(path, init) {
+    if (!tokenProvider) {
+      throw new RemixError("API client is missing a token provider.", {
+        exitCode: 1,
+        hint: "Configure auth before creating the Remix API client."
+      });
+    }
+    const auth = await tokenProvider();
+    const url = new URL(path, config.apiUrl).toString();
+    const doFetch = async (bearer) => fetch(url, {
+      ...init,
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        ...init?.headers ?? {},
+        Authorization: `Bearer ${bearer}`,
+        ...apiKey ? { [CLIENT_KEY_HEADER]: apiKey } : {}
+      }
+    });
+    let res = await doFetch(auth.token);
+    if (res.status === 401 && !auth.fromEnv && auth.session?.refresh_token) {
+      const refreshed = await tokenProvider({ forceRefresh: true });
+      res = await doFetch(refreshed.token);
+    }
+    if (!res.ok) {
+      const body = await readJsonSafe(res);
+      const msg = (body && typeof body === "object" && body && "message" in body && typeof body.message === "string" ? body.message : null) ?? `Request failed (status ${res.status})`;
+      throw new RemixError(msg, { exitCode: 1, hint: body ? JSON.stringify(body, null, 2) : null });
+    }
+    const json = await readJsonSafe(res);
+    return json ?? null;
+  }
+  async function requestBinary(path, init) {
+    if (!tokenProvider) {
+      throw new RemixError("API client is missing a token provider.", {
+        exitCode: 1,
+        hint: "Configure auth before creating the Remix API client."
+      });
+    }
+    const auth = await tokenProvider();
+    const url = new URL(path, config.apiUrl).toString();
+    const doFetch = async (bearer) => fetch(url, {
+      ...init,
+      headers: {
+        Accept: "*/*",
+        ...init?.headers ?? {},
+        Authorization: `Bearer ${bearer}`,
+        ...apiKey ? { [CLIENT_KEY_HEADER]: apiKey } : {}
+      }
+    });
+    let res = await doFetch(auth.token);
+    if (res.status === 401 && !auth.fromEnv && auth.session?.refresh_token) {
+      const refreshed = await tokenProvider({ forceRefresh: true });
+      res = await doFetch(refreshed.token);
+    }
+    if (!res.ok) {
+      const body = await readJsonSafe(res);
+      const msg = (body && typeof body === "object" && body && "message" in body && typeof body.message === "string" ? body.message : null) ?? `Request failed (status ${res.status})`;
+      throw new RemixError(msg, { exitCode: 1, hint: body ? JSON.stringify(body, null, 2) : null });
+    }
+    const contentDisposition = res.headers.get("content-disposition") ?? "";
+    const fileNameMatch = contentDisposition.match(/filename=\"([^\"]+)\"/i);
+    return {
+      data: Buffer.from(await res.arrayBuffer()),
+      fileName: fileNameMatch?.[1] ?? null,
+      contentType: res.headers.get("content-type")
+    };
+  }
+  return {
+    getMe: () => request("/v1/me", { method: "GET" }),
+    listOrganizations: () => request("/v1/organizations", { method: "GET" }),
+    getOrganization: (orgId) => request(`/v1/organizations/${encodeURIComponent(orgId)}`, { method: "GET" }),
+    listProjects: (params) => {
+      const qs = new URLSearchParams();
+      if (params?.organizationId) qs.set("organizationId", params.organizationId);
+      if (params?.clientAppId) qs.set("clientAppId", params.clientAppId);
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/projects${suffix}`, { method: "GET" });
+    },
+    getProject: (projectId) => request(`/v1/projects/${encodeURIComponent(projectId)}`, { method: "GET" }),
+    resolveProjectBinding: (params) => {
+      const qs = new URLSearchParams();
+      if (params.repoFingerprint) qs.set("repoFingerprint", params.repoFingerprint);
+      if (params.remoteUrl) qs.set("remoteUrl", params.remoteUrl);
+      return request(`/v1/projects/bindings/resolve?${qs.toString()}`, { method: "GET" });
+    },
+    autoEnableDeveloper: () => request("/v1/developer/auto-enable", { method: "POST" }),
+    listClientApps: (params) => {
+      const qs = params?.orgId ? `?orgId=${encodeURIComponent(params.orgId)}` : "";
+      return request(`/v1/developer/client-apps${qs}`, { method: "GET" });
+    },
+    createClientApp: (payload) => request("/v1/developer/client-apps", { method: "POST", body: JSON.stringify(payload) }),
+    createClientAppKey: (clientAppId, payload) => request(`/v1/developer/client-apps/${encodeURIComponent(clientAppId)}/keys`, {
+      method: "POST",
+      body: JSON.stringify(payload ?? {})
+    }),
+    listApps: (params) => {
+      const qs = new URLSearchParams();
+      if (params?.projectId) qs.set("projectId", params.projectId);
+      if (params?.organizationId) qs.set("organizationId", params.organizationId);
+      if (params?.forked) qs.set("forked", params.forked);
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps${suffix}`, { method: "GET" });
+    },
+    getApp: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}`, { method: "GET" }),
+    getAppContext: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/context`, { method: "GET" }),
+    getAppOverview: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/overview`, { method: "GET" }),
+    listAppTimeline: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (params?.cursor) qs.set("cursor", params.cursor);
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/timeline${suffix}`, { method: "GET" });
+    },
+    getAppTimelineEvent: (appId, eventId) => request(`/v1/apps/${encodeURIComponent(appId)}/timeline/${encodeURIComponent(eventId)}`, { method: "GET" }),
+    listAppEditQueue: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/edit-queue${suffix}`, { method: "GET" });
+    },
+    getMergeRequest: (mrId) => request(`/v1/merge-requests/${encodeURIComponent(mrId)}`, { method: "GET" }),
+    presignImportUpload: (payload) => request("/v1/apps/import/upload/presign", { method: "POST", body: JSON.stringify(payload) }),
+    importFromUpload: (payload) => request("/v1/apps/import/upload", { method: "POST", body: JSON.stringify(payload) }),
+    presignImportUploadFirstParty: (payload) => request("/v1/apps/import/upload/presign/first-party", { method: "POST", body: JSON.stringify(payload) }),
+    importFromUploadFirstParty: (payload) => request("/v1/apps/import/upload/first-party", { method: "POST", body: JSON.stringify(payload) }),
+    importFromGithubFirstParty: (payload) => request("/v1/apps/import/github/first-party", { method: "POST", body: JSON.stringify(payload) }),
+    forkApp: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/fork`, { method: "POST", body: JSON.stringify(payload ?? {}) }),
+    downloadAppBundle: (appId) => requestBinary(`/v1/apps/${encodeURIComponent(appId)}/download.bundle`, { method: "GET" }),
+    createChangeStep: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/change-steps`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    createCollabTurn: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/collab-turns`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    listCollabTurns: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (params?.limit !== void 0) qs.set("limit", String(params.limit));
+      if (params?.offset !== void 0) qs.set("offset", String(params.offset));
+      if (params?.changeStepId) qs.set("changeStepId", params.changeStepId);
+      if (params?.threadId) qs.set("threadId", params.threadId);
+      if (params?.createdAfter) qs.set("createdAfter", params.createdAfter);
+      if (params?.createdBefore) qs.set("createdBefore", params.createdBefore);
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/collab-turns${suffix}`, { method: "GET" });
+    },
+    getCollabTurn: (appId, collabTurnId) => request(`/v1/apps/${encodeURIComponent(appId)}/collab-turns/${encodeURIComponent(collabTurnId)}`, {
+      method: "GET"
+    }),
+    getAgentMemorySummary: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/agent-memory/summary`, { method: "GET" }),
+    listAgentMemoryTimeline: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (params?.limit !== void 0) qs.set("limit", String(params.limit));
+      if (params?.offset !== void 0) qs.set("offset", String(params.offset));
+      if (params?.createdAfter) qs.set("createdAfter", params.createdAfter);
+      if (params?.createdBefore) qs.set("createdBefore", params.createdBefore);
+      if (params?.kinds?.length) {
+        for (const kind of params.kinds) qs.append("kinds", kind);
+      }
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/agent-memory/timeline${suffix}`, { method: "GET" });
+    },
+    searchAgentMemory: (appId, params) => {
+      const qs = new URLSearchParams();
+      qs.set("q", params.q);
+      if (params.limit !== void 0) qs.set("limit", String(params.limit));
+      if (params.offset !== void 0) qs.set("offset", String(params.offset));
+      if (params.createdAfter) qs.set("createdAfter", params.createdAfter);
+      if (params.createdBefore) qs.set("createdBefore", params.createdBefore);
+      if (params.kinds?.length) {
+        for (const kind of params.kinds) qs.append("kinds", kind);
+      }
+      return request(`/v1/apps/${encodeURIComponent(appId)}/agent-memory/search?${qs.toString()}`, { method: "GET" });
+    },
+    getChangeStep: (appId, changeStepId) => request(`/v1/apps/${encodeURIComponent(appId)}/change-steps/${encodeURIComponent(changeStepId)}`, { method: "GET" }),
+    getChangeStepDiff: (appId, changeStepId) => request(`/v1/apps/${encodeURIComponent(appId)}/change-steps/${encodeURIComponent(changeStepId)}/diff`, {
+      method: "GET"
+    }),
+    startChangeStepReplay: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/change-steps/replays`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    getChangeStepReplay: (appId, replayId) => request(`/v1/apps/${encodeURIComponent(appId)}/change-steps/replays/${encodeURIComponent(replayId)}`, {
+      method: "GET"
+    }),
+    getChangeStepReplayDiff: (appId, replayId) => request(`/v1/apps/${encodeURIComponent(appId)}/change-steps/replays/${encodeURIComponent(replayId)}/diff`, {
+      method: "GET"
+    }),
+    listMergeRequests: (params) => {
+      const qs = new URLSearchParams();
+      if (params?.queue) qs.set("queue", params.queue);
+      if (params?.appId) qs.set("appId", params.appId);
+      if (params?.sourceAppId) qs.set("sourceAppId", params.sourceAppId);
+      if (params?.targetAppId) qs.set("targetAppId", params.targetAppId);
+      if (Array.isArray(params?.status)) {
+        for (const status of params.status) qs.append("status", status);
+      } else if (typeof params?.status === "string") {
+        qs.set("status", params.status);
+      }
+      if (params?.kind) qs.set("kind", params.kind);
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/merge-requests${suffix}`, { method: "GET" });
+    },
+    openMergeRequest: (sourceAppId) => request("/v1/merge-requests", { method: "POST", body: JSON.stringify({ sourceAppId }) }),
+    getMergeRequestReview: (mrId) => request(`/v1/merge-requests/${encodeURIComponent(mrId)}/review`, { method: "GET" }),
+    updateMergeRequest: (mrId, payload) => request(`/v1/merge-requests/${encodeURIComponent(mrId)}`, { method: "PATCH", body: JSON.stringify(payload) }),
+    createOrganizationInvite: (orgId, payload) => request(`/v1/organizations/${encodeURIComponent(orgId)}/invitations`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    createProjectInvite: (projectId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/invitations`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    createAppInvite: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/invitations`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    listOrganizationMembers: (orgId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/organizations/${encodeURIComponent(orgId)}/members${suffix}`, { method: "GET" });
+    },
+    updateOrganizationMember: (orgId, userId, payload) => request(`/v1/organizations/${encodeURIComponent(orgId)}/members/${encodeURIComponent(userId)}`, {
+      method: "PATCH",
+      body: JSON.stringify(payload)
+    }),
+    listProjectMembers: (projectId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/members${suffix}`, { method: "GET" });
+    },
+    updateProjectMember: (projectId, userId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/members/${encodeURIComponent(userId)}`, {
+      method: "PATCH",
+      body: JSON.stringify(payload)
+    }),
+    listAppMembers: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/members${suffix}`, { method: "GET" });
+    },
+    updateAppMember: (appId, userId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/members/${encodeURIComponent(userId)}`, {
+      method: "PATCH",
+      body: JSON.stringify(payload)
+    }),
+    listOrganizationInvites: (orgId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/organizations/${encodeURIComponent(orgId)}/invitations${suffix}`, { method: "GET" });
+    },
+    listProjectInvites: (projectId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/projects/${encodeURIComponent(projectId)}/invitations${suffix}`, { method: "GET" });
+    },
+    listAppInvites: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/invitations${suffix}`, { method: "GET" });
+    },
+    resendOrganizationInvite: (orgId, inviteId, payload) => request(`/v1/organizations/${encodeURIComponent(orgId)}/invitations/${encodeURIComponent(inviteId)}/resend`, {
+      method: "POST",
+      body: JSON.stringify(payload ?? {})
+    }),
+    resendProjectInvite: (projectId, inviteId, payload) => request(`/v1/projects/${encodeURIComponent(projectId)}/invitations/${encodeURIComponent(inviteId)}/resend`, {
+      method: "POST",
+      body: JSON.stringify(payload ?? {})
+    }),
+    resendAppInvite: (appId, inviteId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/invitations/${encodeURIComponent(inviteId)}/resend`, {
+      method: "POST",
+      body: JSON.stringify(payload ?? {})
+    }),
+    revokeOrganizationInvite: (orgId, inviteId) => request(`/v1/organizations/${encodeURIComponent(orgId)}/invitations/${encodeURIComponent(inviteId)}`, {
+      method: "DELETE"
+    }),
+    revokeProjectInvite: (projectId, inviteId) => request(`/v1/projects/${encodeURIComponent(projectId)}/invitations/${encodeURIComponent(inviteId)}`, {
+      method: "DELETE"
+    }),
+    revokeAppInvite: (appId, inviteId) => request(`/v1/apps/${encodeURIComponent(appId)}/invitations/${encodeURIComponent(inviteId)}`, {
+      method: "DELETE"
+    }),
+    acceptInvitation: (payload) => request("/v1/invitations/accept", { method: "POST", body: JSON.stringify(payload) }),
+    syncUpstreamApp: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/sync-upstream`, {
+      method: "POST",
+      body: JSON.stringify({})
+    }),
+    preflightAppReconcile: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/reconcile/preflight`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    startAppReconcile: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/reconcile/start`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    getAppReconcile: (appId, reconcileId) => request(`/v1/apps/${encodeURIComponent(appId)}/reconcile/${encodeURIComponent(reconcileId)}`, { method: "GET" }),
+    downloadAppReconcileBundle: (appId, reconcileId) => requestBinary(`/v1/apps/${encodeURIComponent(appId)}/reconcile/${encodeURIComponent(reconcileId)}/download.bundle`, {
+      method: "GET"
+    }),
+    syncLocalApp: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/sync-local`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    }),
+    initiateBundle: (appId, payload) => request(`/v1/apps/${encodeURIComponent(appId)}/bundles`, { method: "POST", body: JSON.stringify(payload) }),
+    getBundle: (appId, bundleId) => request(`/v1/apps/${encodeURIComponent(appId)}/bundles/${encodeURIComponent(bundleId)}`, { method: "GET" }),
+    getBundleDownloadUrl: (appId, bundleId, options) => request(
+      `/v1/apps/${encodeURIComponent(appId)}/bundles/${encodeURIComponent(bundleId)}/download?redirect=${options?.redirect ?? false}`,
+      { method: "GET" }
+    ),
+    getBundleAssetsDownloadUrl: (appId, bundleId, options) => {
+      const qs = new URLSearchParams({
+        redirect: String(options?.redirect ?? false),
+        kind: options?.kind ?? "metro-assets"
+      });
+      return request(
+        `/v1/apps/${encodeURIComponent(appId)}/bundles/${encodeURIComponent(bundleId)}/assets/download?${qs.toString()}`,
+        { method: "GET" }
+      );
+    },
+    listAgentRuns: (appId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      if (params?.status) qs.set("status", params.status);
+      if (params?.currentPhase) qs.set("currentPhase", params.currentPhase);
+      if (params?.createdAfter) qs.set("createdAfter", params.createdAfter);
+      if (params?.createdBefore) qs.set("createdBefore", params.createdBefore);
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/agent-runs${suffix}`, { method: "GET" });
+    },
+    getAgentRun: (appId, runId) => request(`/v1/apps/${encodeURIComponent(appId)}/agent-runs/${encodeURIComponent(runId)}`, { method: "GET" }),
+    listAgentRunEvents: (appId, runId, params) => {
+      const qs = new URLSearchParams();
+      if (typeof params?.limit === "number") qs.set("limit", String(params.limit));
+      if (typeof params?.offset === "number") qs.set("offset", String(params.offset));
+      if (params?.createdAfter) qs.set("createdAfter", params.createdAfter);
+      if (params?.createdBefore) qs.set("createdBefore", params.createdBefore);
+      const suffix = qs.toString() ? `?${qs.toString()}` : "";
+      return request(`/v1/apps/${encodeURIComponent(appId)}/agent-runs/${encodeURIComponent(runId)}/events${suffix}`, {
+        method: "GET"
+      });
+    },
+    getSandboxStatus: (appId) => request(`/v1/apps/${encodeURIComponent(appId)}/sandbox/status`, { method: "GET" })
+  };
+}
+
+export {
+  createApiClient
+};

package/dist/collab.d.ts

@@ -241,6 +241,26 @@ type CollabTurn = {
     prompt: string | null;
     assistantResponse: string | null;
 };
+type CollabFinalizeTurnMode = "changed_turn" | "no_diff_turn";
+type CollabFinalizeTurnAutoSync = {
+    requested: boolean;
+    eligible: boolean;
+    attempted: boolean;
+    applied: boolean;
+    trackedChangesDiscarded: boolean;
+    capturedUntrackedPathsCandidate: string[];
+    localHeadBefore: string | null;
+    localHeadAfter: string | null;
+    localRepoMutated: boolean;
+};
+type CollabFinalizeTurnResult = {
+    mode: CollabFinalizeTurnMode;
+    idempotencyKey: string;
+    changeStep: JsonObject | null;
+    collabTurn: CollabTurn | null;
+    autoSync: CollabFinalizeTurnAutoSync | null;
+    warnings: string[];
+};
 type InvitationScopeType = "organization" | "project" | "app";
 type MembershipScopeType = InvitationScopeType;
 type OrganizationMemberRole = "owner" | "admin" | "member" | "viewer";
@@ -284,7 +304,12 @@ type CollabApiClient = {
     listApps(params?: {
         projectId?: string;
         organizationId?: string;
+        ownership?: "mine" | "shared" | "all";
+        accessScope?: "all_readable" | "explicit_member";
+        createdBy?: "me" | string;
         forked?: "only" | "exclude" | "all";
+        limit?: number;
+        offset?: number;
     }): Promise<unknown>;
     getApp(appId: string): Promise<unknown>;
     getMergeRequest(mrId: string): Promise<unknown>;
@@ -376,6 +401,8 @@ type CollabApiClient = {
         targetAppId?: string;
         status?: string | string[];
         kind?: string;
+        limit?: number;
+        offset?: number;
     }): Promise<unknown>;
     openMergeRequest(sourceAppId: string): Promise<unknown>;
     getMergeRequestReview(mrId: string): Promise<unknown>;
@@ -399,21 +426,39 @@ type CollabApiClient = {
         role?: string;
         ttlDays?: number;
     }): Promise<unknown>;
-    listOrganizationMembers(orgId: string): Promise<unknown>;
+    listOrganizationMembers(orgId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
     updateOrganizationMember(orgId: string, userId: string, payload: {
         role: OrganizationMemberRole;
     }): Promise<unknown>;
-    listProjectMembers(projectId: string): Promise<unknown>;
+    listProjectMembers(projectId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
     updateProjectMember(projectId: string, userId: string, payload: {
         role: ProjectMemberRole;
     }): Promise<unknown>;
-    listAppMembers(appId: string): Promise<unknown>;
+    listAppMembers(appId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
     updateAppMember(appId: string, userId: string, payload: {
         role: AppMemberRole;
     }): Promise<unknown>;
-    listOrganizationInvites(orgId: string): Promise<unknown>;
-    listProjectInvites(projectId: string): Promise<unknown>;
-    listAppInvites(appId: string): Promise<unknown>;
+    listOrganizationInvites(orgId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    listProjectInvites(projectId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    listAppInvites(appId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
     resendOrganizationInvite(orgId: string, inviteId: string, payload?: {
         ttlDays?: number;
     }): Promise<unknown>;
@@ -474,6 +519,24 @@ declare function collabAdd(params: {
     };
 }): Promise<JsonObject>;
 
+declare function collabFinalizeTurn(params: {
+    api: CollabApiClient;
+    cwd: string;
+    prompt: string;
+    assistantResponse: string;
+    diff?: string | null;
+    diffSource?: "worktree" | "external";
+    sync?: boolean;
+    allowBranchMismatch?: boolean;
+    idempotencyKey?: string | null;
+    actor?: {
+        type?: string;
+        name?: string;
+        version?: string;
+        provider?: string;
+    };
+}): Promise<CollabFinalizeTurnResult>;
+
 declare function collabRecordingPreflight(params: {
     api: CollabApiClient;
     cwd: string;
@@ -524,10 +587,17 @@ declare function collabListMergeRequests(params: {
     appId?: string | null;
     status?: string | string[];
     kind?: string | null;
+    limit?: number;
+    offset?: number;
 }): Promise<{
     queue: MergeRequestQueue;
     appId: string | null;
     mergeRequests: MergeRequest[];
+    pagination: {
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
 }>;
 
 declare function getMemberRolesForScope(scope: InvitationScopeType): readonly string[];
@@ -537,10 +607,17 @@ declare function collabListMembers(params: {
     cwd: string;
     scope: InvitationScopeType;
     targetId?: string | null;
+    limit?: number;
+    offset?: number;
 }): Promise<{
     scopeType: InvitationScopeType;
     targetId: string;
     members: CollabMember[];
+    pagination: {
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
 }>;
 declare function collabUpdateMemberRole(params: {
     api: CollabApiClient;
@@ -599,8 +676,19 @@ declare function collabInvite(params: {
 
 declare function collabList(params: {
     api: CollabApiClient;
+    ownership?: "mine" | "shared" | "all";
+    accessScope?: "all_readable" | "explicit_member";
+    createdBy?: "me" | string;
+    forked?: "only" | "exclude" | "all";
+    limit?: number;
+    offset?: number;
 }): Promise<{
     apps: JsonObject[];
+    pagination: {
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
 }>;
 
 declare function collabReconcile(params: {
@@ -797,4 +885,4 @@ declare function collabView(params: {
     mrId: string;
 }): Promise<MergeRequestReview>;
 
-export { type AppMember, type AppMemberRole, type AppReconcileResponse, type CollabApiClient, type CollabApproveMode, type CollabApproveResult, type CollabMember, type CollabRecordingPreflight, type CollabRecordingPreflightStatus, type CollabStatus, type CollabStatusBlockedReason, type CollabStatusRecommendedAction, type CollabTurn, type InvitationScopeType, type JsonObject, type MembershipScopeType, type MergeRequest, type MergeRequestQueue, type MergeRequestReview, type MergeRequestStatus, type OrganizationMember, type OrganizationMemberRole, type ProjectMember, type ProjectMemberRole, type ReconcilePreflightResponse, type SyncLocalResponse, type SyncUpstreamResponse, collabAdd, collabApprove, collabCheckout, collabInit, collabInvite, collabList, collabListMembers, collabListMergeRequests, collabReconcile, collabRecordTurn, collabRecordingPreflight, collabReject, collabRemix, collabRequestMerge, collabStatus, collabSync, collabSyncUpstream, collabUpdateMemberRole, collabView, getMemberRolesForScope, validateMemberRole };
+export { type AppMember, type AppMemberRole, type AppReconcileResponse, type CollabApiClient, type CollabApproveMode, type CollabApproveResult, type CollabFinalizeTurnAutoSync, type CollabFinalizeTurnMode, type CollabFinalizeTurnResult, type CollabMember, type CollabRecordingPreflight, type CollabRecordingPreflightStatus, type CollabStatus, type CollabStatusBlockedReason, type CollabStatusRecommendedAction, type CollabTurn, type InvitationScopeType, type JsonObject, type MembershipScopeType, type MergeRequest, type MergeRequestQueue, type MergeRequestReview, type MergeRequestStatus, type OrganizationMember, type OrganizationMemberRole, type ProjectMember, type ProjectMemberRole, type ReconcilePreflightResponse, type SyncLocalResponse, type SyncUpstreamResponse, collabAdd, collabApprove, collabCheckout, collabFinalizeTurn, collabInit, collabInvite, collabList, collabListMembers, collabListMergeRequests, collabReconcile, collabRecordTurn, collabRecordingPreflight, collabReject, collabRemix, collabRequestMerge, collabStatus, collabSync, collabSyncUpstream, collabUpdateMemberRole, collabView, getMemberRolesForScope, validateMemberRole };