@mastra/factory 0.0.0-aggregate-trace-20261015182851

package/dist/workspace.d.ts

@@ -0,0 +1,131 @@
+import { SandboxFilesystem } from '@mastra/code-sdk/agents/sandbox-filesystem';
+import type { getDynamicWorkspace } from '@mastra/code-sdk/agents/workspace';
+import { Workspace } from '@mastra/core/workspace';
+import type { FactorySandbox, SkillSource, SkillSourceEntry, SkillSourceStat, WorkspaceSandbox } from '@mastra/core/workspace';
+import type { RepositoryAccess, VersionControl } from './capabilities/version-control.js';
+import type { GithubIntegration } from './integrations/github/integration.js';
+import type { FactorySandboxContext } from './sandbox/session-sandbox.js';
+import type { FactoryProject, FactoryProjectsStorage } from './storage/domains/projects/base.js';
+import type { SourceControlStorageHandle } from './storage/domains/source-control/base.js';
+import type { WorkItemsStorage } from './storage/domains/work-items/base.js';
+export declare const BUNDLED_FACTORY_SKILLS_PATH: string;
+/**
+ * Resolve the consumer repo's local Factory skills root, if any. Checked in
+ * addition to the bundled skills so projects can add (or override) Factory
+ * skills without patching the installed package. Candidates cover the cwd
+ * variants the dev server runs with (`repo root`, `--dir src/mastra` which
+ * runs with cwd `src/mastra/public`).
+ */
+export declare function resolveLocalFactorySkillsPath(cwd?: string): string | undefined;
+export declare const FACTORY_SKILL_NAMES: Set<string>;
+/** Review skills only sessions with an active review run binding may discover or load. */
+export declare const REVIEW_ONLY_FACTORY_SKILLS: Set<string>;
+/**
+ * Rescan a session's skill cache so a role gained after the cache was built
+ * (a review binding minted after the session's workspace resolved) takes effect.
+ * The source still checks the live binding, so this never widens access.
+ */
+export declare function rescanFactorySkills(skills: NonNullable<Workspace['skills']>): Promise<void>;
+export declare class FactorySkillSource implements SkillSource {
+    #private;
+    readonly fallback: SkillSource;
+    /** Evaluated per call because a session's bound role changes across stages. */
+    readonly isReviewSession: () => Promise<boolean>;
+    constructor(fallback: SkillSource, fallbackSkillRoots: string[], localSkillsPath?: string | undefined, 
+    /** Evaluated per call because a session's bound role changes across stages. */
+    isReviewSession?: () => Promise<boolean>);
+    exists(skillPath: string): Promise<boolean>;
+    stat(skillPath: string): Promise<SkillSourceStat>;
+    readFile(skillPath: string): Promise<string | Buffer>;
+    readdir(skillPath: string): Promise<SkillSourceEntry[]>;
+    realpath(skillPath: string): Promise<string>;
+}
+type DynamicWorkspaceContext = Parameters<typeof getDynamicWorkspace>[0];
+/**
+ * When a session's sandbox boots: on the agent's first command (`'lazy'`, the
+ * default) or as soon as the session's workspace is first resolved (`'eager'`).
+ * An eager start is fire-and-forget; if it fails, the lazy path still runs.
+ */
+export type FactorySandboxStart = 'lazy' | 'eager';
+export interface WorkspaceSourceControlProvider {
+    /** Stable integration id used to select the provider-owned storage partition. */
+    id: string;
+    /** Provider capability used to resolve fresh repository credentials. */
+    versionControl: Pick<VersionControl, 'getRepositoryAccess' | 'getRepositoriesAccess'>;
+    /** Provider-owned source-control rows, including Factory sessions. */
+    storage: SourceControlStorageHandle;
+    /** Present only for GitHub, whose CLI PAT rotation has additional semantics. */
+    github?: GithubIntegration;
+}
+export interface CreateWorkspaceFactoryOptions {
+    /** The normalized factory sandbox constructing one sandbox per session. */
+    sandbox?: FactorySandbox;
+    /** Defaults to `'lazy'`. */
+    sandboxStart?: FactorySandboxStart;
+    /** Source-control providers whose repositories may back Factory sessions. */
+    sourceControls?: WorkspaceSourceControlProvider[];
+    /** @deprecated GitHub-only compatibility path; prefer sourceControls. */
+    github?: GithubIntegration;
+    /** Work-items storage used to resolve the session's run-binding role, so
+     * review-board sessions get the reviewer PAT as `GH_TOKEN`. Optional —
+     * without it every session uses the default (worker) PAT. */
+    workItems?: Pick<WorkItemsStorage, 'findActiveRunBindingForSession'>;
+    /** Projects storage used to authorize workspace-free supervisor sessions. */
+    projects?: Pick<FactoryProjectsStorage, 'get'>;
+    /** Runtime workspace/token registrations invalidated when a session retires. */
+    workspaceRegistry?: FactoryWorkspaceRegistry;
+}
+type WorkspaceUnregister = () => Promise<void> | void;
+/** Tracks dynamic Factory workspaces by persisted session id for retirement. */
+export declare class FactoryWorkspaceRegistry {
+    #private;
+    generation(sessionId: string): number;
+    register(sessionId: string, workspaceId: string, generation: number, unregister: WorkspaceUnregister): Promise<boolean>;
+    invalidateSession(sessionId: string): Promise<void>;
+}
+/** One environment repository as the sandbox context and the boot need it, in position order. */
+export interface SessionEnvironmentRepo {
+    projectRepositoryId: string;
+    repositoryId: string;
+    slug: string;
+    /** The session's base branch: the link's branch when set, else the repository default. */
+    defaultBranch: string;
+    /** The repository's own default branch, which the template image clones and pins. */
+    templateBranch: string;
+    position: number;
+    setupCommand: string | undefined;
+    teardownCommand: string | undefined;
+}
+/** The session's factory environment, resolved from the project and its `inEnvironment` links. */
+export interface SessionEnvironment {
+    repos: SessionEnvironmentRepo[];
+    workspaceSetupCommand: string | undefined;
+    /** Only an absolute root is passed on; the templates reject anything else. */
+    workingDirectory: string | undefined;
+    /** The project's stored provider settings document, `{}` when nothing was set. */
+    settings: Record<string, unknown>;
+}
+/**
+ * The project's environment as a session (or an environment build) sees it:
+ * every `inEnvironment` link under this source-control integration in
+ * position order, plus the project's settings, setup command and workdir.
+ */
+export declare function resolveProjectEnvironment(storage: Pick<SourceControlStorageHandle, 'projectRepositories' | 'repositories'>, project: FactoryProject): Promise<SessionEnvironment>;
+/**
+ * The context fields the list form of the repo templates needs: one entry per
+ * environment repository, each minting its own token at build time, with
+ * `getRepositoryAccess` present but undefined (the two are mutually exclusive
+ * for the template). Shared by session boot and environment builds so both
+ * resolve the same template identity; `resolveHead` is only set when given.
+ */
+export declare function environmentSandboxContext(environment: SessionEnvironment, options: {
+    orgId: string;
+    getRepositoryAccess: (args: {
+        orgId: string;
+        repositoryId: string;
+    }) => Promise<RepositoryAccess>;
+    resolveHead?: FactorySandboxContext['resolveHead'];
+}): Omit<FactorySandboxContext, 'sessionId'>;
+export declare function createWorkspaceFactory(options?: CreateWorkspaceFactoryOptions): ({ requestContext, mastra, skillExtension }: DynamicWorkspaceContext) => Promise<Workspace<import("@mastra/core/workspace").WorkspaceFilesystem | undefined, WorkspaceSandbox | undefined, undefined> | Workspace<SandboxFilesystem, WorkspaceSandbox, undefined> | undefined>;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

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