@mastra/factory 0.0.0-fix-thread-subscription-multi-instance-redis-streams-20260730204150

package/dist/storage/domains/queue-health/base.js

@@ -0,0 +1,122 @@
+import { FactoryStorageDomain, UniqueViolationError } from "@mastra/core/storage";
+//#region src/storage/domains/queue-health/base.ts
+/**
+* Queue-health threshold configuration domain: per-project age buckets for the
+* Factory Overview queue-health chart.
+*
+* Stored per `(org, github_project)` — each connected GitHub project gets its
+* own age thresholds so a fast-moving automated pipeline and a slow human one
+* can bucket "how old is the work" differently. `thresholdsSeconds` is an
+* ordered-ascending list of age boundaries in seconds: an item younger than
+* the first boundary is green, younger than the second amber, younger than the
+* third orange, and red otherwise. Seconds (not hours) so sub-minute buckets
+* are representable for fast automated flows.
+*/
+/** Default: green <4h, amber <24h, orange <72h, red 72h+. */
+const DEFAULT_QUEUE_HEALTH_CONFIG = { thresholdsSeconds: [
+	14400,
+	86400,
+	259200
+] };
+/**
+* Throw unless `thresholdsSeconds` is a non-empty ascending number list. A
+* descending config would silently invert bucket semantics, so validate at the
+* write boundary rather than trusting callers.
+*/
+function assertValidThresholds(config) {
+	const t = config.thresholdsSeconds;
+	if (!Array.isArray(t) || t.length === 0 || t.some((v) => typeof v !== "number" || !Number.isFinite(v))) throw new Error("[QueueHealthStorage] thresholdsSeconds must be a non-empty array of finite numbers.");
+	for (let i = 1; i < t.length; i++) if (t[i] <= t[i - 1]) throw new Error("[QueueHealthStorage] thresholdsSeconds must be strictly ascending.");
+}
+/** Validate untrusted JSON into a `QueueHealthConfig`, or `null` when invalid. */
+function parseQueueHealthConfig(body) {
+	if (typeof body !== "object" || body === null) return null;
+	const config = body;
+	if (!Array.isArray(config.thresholdsSeconds)) return null;
+	try {
+		assertValidThresholds(config);
+	} catch {
+		return null;
+	}
+	return { thresholdsSeconds: [...config.thresholdsSeconds] };
+}
+/**
+* Return `config.thresholdsSeconds` when valid, else the default. Validation
+* lives at the `saveConfig` write boundary, but `getConfig` round-trips a
+* stored JSON row — a corrupted or hand-edited row (empty / non-ascending)
+* would otherwise reach the chart and invert bucket colors, so the read route
+* re-validates and falls back.
+*/
+function thresholdsOrDefault(config) {
+	return parseQueueHealthConfig(config)?.thresholdsSeconds ?? DEFAULT_QUEUE_HEALTH_CONFIG.thresholdsSeconds;
+}
+const QUEUE_HEALTH_SETTINGS_SCHEMA = {
+	name: "queue_health_settings",
+	columns: {
+		id: { type: "uuid-pk" },
+		org_id: { type: "text" },
+		factory_project_id: { type: "text" },
+		config: { type: "json" },
+		created_at: { type: "timestamp" },
+		updated_at: { type: "timestamp" }
+	},
+	uniqueIndexes: [{
+		name: "queue_health_settings_org_project_unique",
+		columns: ["org_id", "factory_project_id"]
+	}]
+};
+/**
+* Queue-health settings storage, written once against the generic
+* `FactoryStorageOps` surface — works on any `FactoryStorage` backend.
+*/
+var QueueHealthStorage = class extends FactoryStorageDomain {
+	constructor() {
+		super("queue-health");
+	}
+	async init() {
+		await this.ensureCollections([QUEUE_HEALTH_SETTINGS_SCHEMA]);
+	}
+	async dangerouslyClearAll() {
+		await this.ops.deleteMany("queue_health_settings", {});
+	}
+	get #db() {
+		return this.ops;
+	}
+	/** Read the project's queue-health config, falling back to {@link DEFAULT_QUEUE_HEALTH_CONFIG}. */
+	async getConfig(orgId, factoryProjectId) {
+		const row = await this.#db.findOne("queue_health_settings", {
+			org_id: orgId,
+			factory_project_id: factoryProjectId
+		});
+		return structuredClone(parseQueueHealthConfig(row?.config) ?? DEFAULT_QUEUE_HEALTH_CONFIG);
+	}
+	/** Upsert the project's queue-health config (`created_at` is preserved on update). */
+	async saveConfig(orgId, factoryProjectId, config) {
+		assertValidThresholds(config);
+		const where = {
+			org_id: orgId,
+			factory_project_id: factoryProjectId
+		};
+		const updateExisting = () => this.#db.updateAtomic("queue_health_settings", where, () => ({
+			config,
+			updated_at: /* @__PURE__ */ new Date()
+		}));
+		if (await updateExisting()) return;
+		const now = /* @__PURE__ */ new Date();
+		try {
+			await this.#db.insertOne("queue_health_settings", {
+				...where,
+				config,
+				created_at: now,
+				updated_at: now
+			});
+		} catch (error) {
+			if (!(error instanceof UniqueViolationError)) throw error;
+			if (!await updateExisting()) throw error;
+		}
+	}
+};
+//#endregion
+export { DEFAULT_QUEUE_HEALTH_CONFIG, QUEUE_HEALTH_SETTINGS_SCHEMA, QueueHealthStorage, assertValidThresholds, parseQueueHealthConfig, thresholdsOrDefault };
+
+//# sourceMappingURL=base.js.map

package/dist/storage/domains/queue-health/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","names":["#db"],"sources":["../../../../src/storage/domains/queue-health/base.ts"],"sourcesContent":["/**\n * Queue-health threshold configuration domain: per-project age buckets for the\n * Factory Overview queue-health chart.\n *\n * Stored per `(org, github_project)` — each connected GitHub project gets its\n * own age thresholds so a fast-moving automated pipeline and a slow human one\n * can bucket \"how old is the work\" differently. `thresholdsSeconds` is an\n * ordered-ascending list of age boundaries in seconds: an item younger than\n * the first boundary is green, younger than the second amber, younger than the\n * third orange, and red otherwise. Seconds (not hours) so sub-minute buckets\n * are representable for fast automated flows.\n */\n\nimport { FactoryStorageDomain, UniqueViolationError } from '@mastra/core/storage';\nimport type { CollectionSchema, FactoryStorageOps } from '@mastra/core/storage';\n\nexport interface QueueHealthConfig {\n  /** Ordered-ascending age boundaries in seconds, e.g. `[14400, 86400, 259200]`. */\n  thresholdsSeconds: number[];\n}\n\n/** Default: green <4h, amber <24h, orange <72h, red 72h+. */\nexport const DEFAULT_QUEUE_HEALTH_CONFIG: QueueHealthConfig = {\n  thresholdsSeconds: [14400, 86400, 259200],\n};\n\n/**\n * Throw unless `thresholdsSeconds` is a non-empty ascending number list. A\n * descending config would silently invert bucket semantics, so validate at the\n * write boundary rather than trusting callers.\n */\nexport function assertValidThresholds(config: QueueHealthConfig): void {\n  const t = config.thresholdsSeconds;\n  if (!Array.isArray(t) || t.length === 0 || t.some(v => typeof v !== 'number' || !Number.isFinite(v))) {\n    throw new Error('[QueueHealthStorage] thresholdsSeconds must be a non-empty array of finite numbers.');\n  }\n  for (let i = 1; i < t.length; i++) {\n    if (t[i]! <= t[i - 1]!) {\n      throw new Error('[QueueHealthStorage] thresholdsSeconds must be strictly ascending.');\n    }\n  }\n}\n\n/** Validate untrusted JSON into a `QueueHealthConfig`, or `null` when invalid. */\nexport function parseQueueHealthConfig(body: unknown): QueueHealthConfig | null {\n  if (typeof body !== 'object' || body === null) return null;\n  const config = body as { thresholdsSeconds?: unknown };\n  if (!Array.isArray(config.thresholdsSeconds)) return null;\n  try {\n    assertValidThresholds(config as QueueHealthConfig);\n  } catch {\n    return null;\n  }\n  return { thresholdsSeconds: [...(config as QueueHealthConfig).thresholdsSeconds] };\n}\n\n/**\n * Return `config.thresholdsSeconds` when valid, else the default. Validation\n * lives at the `saveConfig` write boundary, but `getConfig` round-trips a\n * stored JSON row — a corrupted or hand-edited row (empty / non-ascending)\n * would otherwise reach the chart and invert bucket colors, so the read route\n * re-validates and falls back.\n */\nexport function thresholdsOrDefault(config: QueueHealthConfig): number[] {\n  return parseQueueHealthConfig(config)?.thresholdsSeconds ?? DEFAULT_QUEUE_HEALTH_CONFIG.thresholdsSeconds;\n}\n\nexport const QUEUE_HEALTH_SETTINGS_SCHEMA: CollectionSchema = {\n  name: 'queue_health_settings',\n  columns: {\n    id: { type: 'uuid-pk' },\n    org_id: { type: 'text' },\n    factory_project_id: { type: 'text' },\n    config: { type: 'json' },\n    created_at: { type: 'timestamp' },\n    updated_at: { type: 'timestamp' },\n  },\n  uniqueIndexes: [{ name: 'queue_health_settings_org_project_unique', columns: ['org_id', 'factory_project_id'] }],\n};\n\n/**\n * Queue-health settings storage, written once against the generic\n * `FactoryStorageOps` surface — works on any `FactoryStorage` backend.\n */\nexport class QueueHealthStorage extends FactoryStorageDomain {\n  constructor() {\n    super('queue-health');\n  }\n\n  async init(): Promise<void> {\n    await this.ensureCollections([QUEUE_HEALTH_SETTINGS_SCHEMA]);\n  }\n\n  async dangerouslyClearAll(): Promise<void> {\n    await this.ops.deleteMany('queue_health_settings', {});\n  }\n\n  get #db(): FactoryStorageOps {\n    return this.ops;\n  }\n\n  /** Read the project's queue-health config, falling back to {@link DEFAULT_QUEUE_HEALTH_CONFIG}. */\n  async getConfig(orgId: string, factoryProjectId: string): Promise<QueueHealthConfig> {\n    const row = await this.#db.findOne<{ config: unknown }>('queue_health_settings', {\n      org_id: orgId,\n      factory_project_id: factoryProjectId,\n    });\n    return structuredClone(parseQueueHealthConfig(row?.config) ?? DEFAULT_QUEUE_HEALTH_CONFIG);\n  }\n\n  /** Upsert the project's queue-health config (`created_at` is preserved on update). */\n  async saveConfig(orgId: string, factoryProjectId: string, config: QueueHealthConfig): Promise<void> {\n    assertValidThresholds(config);\n    const where = { org_id: orgId, factory_project_id: factoryProjectId };\n    const updateExisting = () =>\n      this.#db.updateAtomic('queue_health_settings', where, () => ({ config, updated_at: new Date() }));\n    if (await updateExisting()) return;\n\n    const now = new Date();\n    try {\n      await this.#db.insertOne('queue_health_settings', { ...where, config, created_at: now, updated_at: now });\n    } catch (error) {\n      if (!(error instanceof UniqueViolationError)) throw error;\n      // Lost the insert race — update the winning row under the backend's serialized write primitive.\n      if (!(await updateExisting())) throw error;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAsBA,MAAa,8BAAiD,EAC5D,mBAAmB;CAAC;CAAO;CAAO;AAAM,EAC1C;;;;;;AAOA,SAAgB,sBAAsB,QAAiC;CACrE,MAAM,IAAI,OAAO;CACjB,IAAI,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,KAAK,EAAE,MAAK,MAAK,OAAO,MAAM,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC,GACjG,MAAM,IAAI,MAAM,qFAAqF;CAEvG,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAC5B,IAAI,EAAE,MAAO,EAAE,IAAI,IACjB,MAAM,IAAI,MAAM,oEAAoE;AAG1F;;AAGA,SAAgB,uBAAuB,MAAyC;CAC9E,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM,OAAO;CACtD,MAAM,SAAS;CACf,IAAI,CAAC,MAAM,QAAQ,OAAO,iBAAiB,GAAG,OAAO;CACrD,IAAI;EACF,sBAAsB,MAA2B;CACnD,QAAQ;EACN,OAAO;CACT;CACA,OAAO,EAAE,mBAAmB,CAAC,GAAI,OAA6B,iBAAiB,EAAE;AACnF;;;;;;;;AASA,SAAgB,oBAAoB,QAAqC;CACvE,OAAO,uBAAuB,MAAM,CAAC,EAAE,qBAAqB,4BAA4B;AAC1F;AAEA,MAAa,+BAAiD;CAC5D,MAAM;CACN,SAAS;EACP,IAAI,EAAE,MAAM,UAAU;EACtB,QAAQ,EAAE,MAAM,OAAO;EACvB,oBAAoB,EAAE,MAAM,OAAO;EACnC,QAAQ,EAAE,MAAM,OAAO;EACvB,YAAY,EAAE,MAAM,YAAY;EAChC,YAAY,EAAE,MAAM,YAAY;CAClC;CACA,eAAe,CAAC;EAAE,MAAM;EAA4C,SAAS,CAAC,UAAU,oBAAoB;CAAE,CAAC;AACjH;;;;;AAMA,IAAa,qBAAb,cAAwC,qBAAqB;CAC3D,cAAc;EACZ,MAAM,cAAc;CACtB;CAEA,MAAM,OAAsB;EAC1B,MAAM,KAAK,kBAAkB,CAAC,4BAA4B,CAAC;CAC7D;CAEA,MAAM,sBAAqC;EACzC,MAAM,KAAK,IAAI,WAAW,yBAAyB,CAAC,CAAC;CACvD;CAEA,IAAIA,MAAyB;EAC3B,OAAO,KAAK;CACd;;CAGA,MAAM,UAAU,OAAe,kBAAsD;EACnF,MAAM,MAAM,MAAM,KAAKA,IAAI,QAA6B,yBAAyB;GAC/E,QAAQ;GACR,oBAAoB;EACtB,CAAC;EACD,OAAO,gBAAgB,uBAAuB,KAAK,MAAM,KAAK,2BAA2B;CAC3F;;CAGA,MAAM,WAAW,OAAe,kBAA0B,QAA0C;EAClG,sBAAsB,MAAM;EAC5B,MAAM,QAAQ;GAAE,QAAQ;GAAO,oBAAoB;EAAiB;EACpE,MAAM,uBACJ,KAAKA,IAAI,aAAa,yBAAyB,cAAc;GAAE;GAAQ,4BAAY,IAAI,KAAK;EAAE,EAAE;EAClG,IAAI,MAAM,eAAe,GAAG;EAE5B,MAAM,sBAAM,IAAI,KAAK;EACrB,IAAI;GACF,MAAM,KAAKA,IAAI,UAAU,yBAAyB;IAAE,GAAG;IAAO;IAAQ,YAAY;IAAK,YAAY;GAAI,CAAC;EAC1G,SAAS,OAAO;GACd,IAAI,EAAE,iBAAiB,uBAAuB,MAAM;GAEpD,IAAI,CAAE,MAAM,eAAe,GAAI,MAAM;EACvC;CACF;AACF"}

package/dist/storage/domains/source-control/base.d.ts

@@ -0,0 +1,358 @@
+import { FactoryStorageDomain } from '@mastra/core/storage';
+import type { CollectionSchema } from '@mastra/core/storage';
+export declare const SOURCE_CONTROL_SCHEMAS: CollectionSchema[];
+export type SourceControlProviderMetadata = Record<string, unknown>;
+export interface SourceControlInstallation {
+    id: string;
+    integrationId: string;
+    orgId: string;
+    connectedByUserId: string;
+    externalId: string;
+    accountName: string | null;
+    accountType: string | null;
+    providerMetadata: SourceControlProviderMetadata;
+    createdAt: Date;
+}
+export interface UpsertSourceControlInstallationInput {
+    orgId: string;
+    connectedByUserId: string;
+    externalId: string;
+    accountName?: string | null;
+    accountType?: string | null;
+    providerMetadata?: SourceControlProviderMetadata;
+}
+export interface SourceControlRepository {
+    id: string;
+    installationId: string;
+    externalId: string;
+    slug: string;
+    defaultBranch: string;
+    providerMetadata: SourceControlProviderMetadata;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface UpsertSourceControlRepositoryInput {
+    installationId: string;
+    externalId: string;
+    slug: string;
+    defaultBranch: string;
+    providerMetadata?: SourceControlProviderMetadata;
+}
+export interface ProjectSourceControlConnection {
+    id: string;
+    factoryProjectId: string;
+    integrationId: string;
+    installationId: string;
+    createdByUserId: string;
+    createdAt: Date;
+}
+export interface CreateProjectSourceControlConnectionInput {
+    orgId: string;
+    factoryProjectId: string;
+    installationId: string;
+    createdByUserId: string;
+}
+export interface ProjectRepository {
+    id: string;
+    connectionId: string;
+    repositoryId: string;
+    createdByUserId: string;
+    branch: string | null;
+    sandboxProvider: string;
+    sandboxWorkdir: string;
+    setupCommand: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface ExternalRepositoryProjectTarget {
+    orgId: string;
+    factoryProjectId: string;
+    projectRepository: ProjectRepository;
+}
+/** External id pair identifying a repository linked to a factory project. */
+export interface ConfiguredExternalRepositoryKey {
+    installationExternalId: string;
+    repositoryExternalId: string;
+}
+export interface LinkProjectRepositoryInput {
+    orgId: string;
+    connectionId: string;
+    repositoryId: string;
+    createdByUserId: string;
+    branch?: string | null;
+    sandboxProvider: string;
+    sandboxWorkdir: string;
+    setupCommand?: string | null;
+}
+export interface UpdateProjectRepositoryInput {
+    branch?: string | null;
+    sandboxProvider?: string;
+    sandboxWorkdir?: string;
+    setupCommand?: string | null;
+}
+export interface ProjectRepositorySandbox {
+    id: string;
+    projectRepositoryId: string;
+    userId: string;
+    sandboxId: string | null;
+    sandboxWorkdir: string;
+    materializedAt: Date | null;
+    createdAt: Date;
+}
+/**
+ * A provider sandbox that is no longer bound to any session and can be handed
+ * to the next session for the same project-repository link instead of
+ * provisioning a fresh VM. Pooling is per-repository, not per-user: no
+ * credentials are baked into the VM (tokens are injected per command), so any
+ * user's session can safely claim it. `userId` records who released it,
+ * purely as provenance.
+ */
+export interface PooledSandbox {
+    id: string;
+    orgId: string;
+    projectRepositoryId: string;
+    /** User whose session released this sandbox (provenance, not a claim key). */
+    userId: string;
+    sandboxId: string;
+    sandboxWorkdir: string;
+    releasedAt: Date;
+}
+export interface ReleasePooledSandboxInput {
+    orgId: string;
+    projectRepositoryId: string;
+    userId: string;
+    sandboxId: string;
+    sandboxWorkdir: string;
+}
+export interface SourceControlWorktree {
+    id: string;
+    projectRepositoryId: string;
+    userId: string;
+    branch: string;
+    baseBranch: string;
+    worktreePath: string;
+    createdAt: Date;
+}
+export interface UpsertSourceControlWorktreeInput {
+    projectRepositoryId: string;
+    userId: string;
+    branch: string;
+    baseBranch: string;
+    worktreePath: string;
+}
+export interface SourceControlSession {
+    id: string;
+    sessionId: string;
+    projectRepositoryId: string;
+    orgId: string;
+    userId: string;
+    branch: string;
+    baseBranch: string;
+    sandboxId: string | null;
+    sandboxWorkdir: string | null;
+    materializedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CreateSourceControlSessionInput {
+    sessionId: string;
+    projectRepositoryId: string;
+    orgId: string;
+    userId: string;
+    branch: string;
+    baseBranch: string;
+}
+export interface SourceControlStorageHandle {
+    readonly integrationId: string;
+    readonly installations: {
+        list(args: {
+            orgId: string;
+        }): Promise<SourceControlInstallation[]>;
+        get(args: {
+            orgId: string;
+            id: string;
+        }): Promise<SourceControlInstallation | null>;
+        findByExternalId(args: {
+            orgId: string;
+            externalId: string;
+        }): Promise<SourceControlInstallation | null>;
+        upsert(args: UpsertSourceControlInstallationInput): Promise<SourceControlInstallation>;
+        delete(args: {
+            orgId: string;
+            id: string;
+        }): Promise<boolean>;
+    };
+    readonly repositories: {
+        list(args: {
+            orgId: string;
+            installationId: string;
+        }): Promise<SourceControlRepository[]>;
+        get(args: {
+            orgId: string;
+            id: string;
+        }): Promise<SourceControlRepository | null>;
+        findByExternalId(args: {
+            orgId: string;
+            externalId: string;
+        }): Promise<SourceControlRepository | null>;
+        findBySlug(args: {
+            orgId: string;
+            installationId: string;
+            slug: string;
+        }): Promise<SourceControlRepository | null>;
+        upsert(args: {
+            orgId: string;
+            input: UpsertSourceControlRepositoryInput;
+        }): Promise<SourceControlRepository>;
+        /**
+         * Migrate a repository and its dependent connections to a new installation.
+         * Used when a GitHub App is reinstalled with a new installation ID on the same account.
+         * Returns the repository under the new installation (either migrated or existing).
+         */
+        migrateInstallation(args: {
+            orgId: string;
+            id: string;
+            newInstallationId: string;
+        }): Promise<SourceControlRepository>;
+    };
+    readonly connections: {
+        list(args: {
+            orgId: string;
+            factoryProjectId: string;
+        }): Promise<ProjectSourceControlConnection[]>;
+        get(args: {
+            orgId: string;
+            id: string;
+        }): Promise<ProjectSourceControlConnection | null>;
+        create(args: CreateProjectSourceControlConnectionInput): Promise<ProjectSourceControlConnection>;
+        delete(args: {
+            orgId: string;
+            id: string;
+        }): Promise<boolean>;
+    };
+    readonly projectRepositories: {
+        list(args: {
+            orgId: string;
+            connectionId: string;
+        }): Promise<ProjectRepository[]>;
+        listByExternalRepository(args: {
+            installationExternalId: string;
+            repositoryExternalId: string;
+        }): Promise<ExternalRepositoryProjectTarget[]>;
+        /**
+         * Distinct external (installation, repository) id pairs linked to any
+         * factory project. Lets sweeps scope work to configured repositories
+         * without probing every repository an installation can see.
+         */
+        listConfiguredExternalKeys(): Promise<ConfiguredExternalRepositoryKey[]>;
+        get(args: {
+            orgId: string;
+            id: string;
+        }): Promise<ProjectRepository | null>;
+        link(args: LinkProjectRepositoryInput): Promise<ProjectRepository>;
+        update(args: {
+            orgId: string;
+            id: string;
+            input: UpdateProjectRepositoryInput;
+        }): Promise<ProjectRepository | null>;
+        unlink(args: {
+            orgId: string;
+            id: string;
+        }): Promise<boolean>;
+    };
+    readonly sandboxes: {
+        getOrCreate(args: {
+            projectRepository: ProjectRepository;
+            userId: string;
+        }): Promise<ProjectRepositorySandbox>;
+        getById(args: {
+            id: string;
+        }): Promise<ProjectRepositorySandbox | null>;
+        /**
+         * Point the binding at a new workdir and clear `materializedAt` — a moved
+         * workdir means the checkout must be re-cloned. Used to heal bindings whose
+         * inherited workdir went stale (e.g. the sandbox provider changed).
+         */
+        setWorkdir(args: {
+            id: string;
+            sandboxWorkdir: string;
+        }): Promise<void>;
+        setSandboxId(args: {
+            id: string;
+            sandboxId: string;
+        }): Promise<void>;
+        clearBinding(args: {
+            id: string;
+        }): Promise<void>;
+        markMaterialized(args: {
+            id: string;
+        }): Promise<void>;
+    };
+    readonly sandboxPool: {
+        /**
+         * Return a sandbox to the reuse pool. Idempotent per provider sandbox ID —
+         * releasing the same sandbox twice keeps one pool row.
+         */
+        release(args: ReleasePooledSandboxInput): Promise<void>;
+        /**
+         * Atomically take one pooled sandbox for the given project-repository
+         * link, preferring the most recently released (warmest) VM. Returns
+         * `null` when the pool is empty. Each pooled sandbox is handed to exactly
+         * one claimer even under concurrent claims.
+         */
+        claim(args: {
+            projectRepositoryId: string;
+        }): Promise<PooledSandbox | null>;
+    };
+    readonly worktrees: {
+        upsert(args: UpsertSourceControlWorktreeInput): Promise<void>;
+        list(args: {
+            projectRepositoryId: string;
+            userId: string;
+        }): Promise<SourceControlWorktree[]>;
+        get(args: {
+            projectRepositoryId: string;
+            userId: string;
+            branch: string;
+        }): Promise<SourceControlWorktree | null>;
+        findByPath(args: {
+            projectRepositoryId: string;
+            userId: string;
+            worktreePath: string;
+        }): Promise<SourceControlWorktree | null>;
+        delete(args: {
+            projectRepositoryId: string;
+            userId: string;
+            branch: string;
+        }): Promise<void>;
+    };
+    readonly sessions: {
+        list(args: {
+            projectRepositoryId: string;
+            userId: string;
+        }): Promise<SourceControlSession[]>;
+        getBySessionId(sessionId: string): Promise<SourceControlSession | null>;
+        getForBranch(args: {
+            projectRepositoryId: string;
+            userId: string;
+            branch: string;
+        }): Promise<SourceControlSession | null>;
+        create(input: CreateSourceControlSessionInput): Promise<SourceControlSession>;
+        setSandbox(args: {
+            id: string;
+            sandboxId: string | null;
+            sandboxWorkdir: string;
+        }): Promise<void>;
+        markMaterialized(args: {
+            id: string;
+        }): Promise<void>;
+        delete(id: string): Promise<void>;
+    };
+}
+export declare class SourceControlStorage extends FactoryStorageDomain {
+    constructor();
+    init(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    forIntegration(integrationId: string): SourceControlStorageHandle;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/storage/domains/source-control/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/source-control/base.ts"],"names":[],"mappings":"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"}