@evref-bl/plexus-core 0.1.0-alpha.0

package/dist/projectState.js

@@ -0,0 +1,192 @@
+import fs from "node:fs";
+import { basenamePathLike, dirnamePathLike, joinPathLike, } from "./pathStyle.js";
+export const plexusStateDirectoryName = ".plexus";
+export const plexusProjectsStateDirectoryName = "projects";
+export const plexusWorkspacesStateDirectoryName = "workspaces";
+export const projectStateFileName = "state.json";
+export const defaultWorkspaceIdValue = "default";
+export const defaultProjectPortRange = {
+    start: 7_100,
+    end: 7_199,
+};
+export class PortAllocationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PortAllocationError";
+    }
+}
+export class ProjectStateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ProjectStateError";
+    }
+}
+export function defaultPlexusStateRoot(projectRoot) {
+    return joinPathLike(projectRoot, plexusStateDirectoryName);
+}
+export function sanitizeRuntimeId(value) {
+    const sanitized = value.trim().replace(/[^A-Za-z0-9._-]+/g, "-");
+    return sanitized.replace(/^-+|-+$/g, "") || defaultWorkspaceIdValue;
+}
+export function defaultWorkspaceId(projectRoot) {
+    return sanitizeRuntimeId(basenamePathLike(projectRoot));
+}
+export function defaultTargetId(projectId, workspaceId) {
+    return `${projectId}--${workspaceId}`;
+}
+export function projectWorkspacesStateDirectoryPath(options) {
+    const stateRoot = options.stateRoot ?? defaultPlexusStateRoot(options.projectRoot);
+    return joinPathLike(stateRoot, plexusProjectsStateDirectoryName, options.projectId, plexusWorkspacesStateDirectoryName);
+}
+export function projectStateDirectoryPath(options) {
+    return joinPathLike(projectWorkspacesStateDirectoryPath(options), options.workspaceId
+        ? sanitizeRuntimeId(options.workspaceId)
+        : defaultWorkspaceId(options.projectRoot));
+}
+export function projectStatePath(options) {
+    return joinPathLike(projectStateDirectoryPath(options), projectStateFileName);
+}
+export function projectStatePathForConfig(options) {
+    return projectStatePath({
+        projectRoot: options.projectRoot,
+        projectId: options.config.kanban.projectId,
+        workspaceId: options.workspaceId,
+        stateRoot: options.stateRoot,
+    });
+}
+function validatePortRange(range) {
+    if (!Number.isInteger(range.start) ||
+        !Number.isInteger(range.end) ||
+        range.start < 1 ||
+        range.end > 65_535 ||
+        range.start > range.end) {
+        throw new PortAllocationError("Port range must use integer ports between 1 and 65535 with start <= end");
+    }
+}
+function nextAvailablePort(range, unavailablePorts) {
+    for (let port = range.start; port <= range.end; port += 1) {
+        if (!unavailablePorts.has(port)) {
+            return port;
+        }
+    }
+    throw new PortAllocationError(`No available port in range ${range.start}-${range.end}`);
+}
+function previousImagePort(previousState, imageId) {
+    return previousState?.images.find((image) => image.id === imageId)
+        ?.assignedPort;
+}
+function normalizeCreateProjectStateOptions(optionsOrUpdatedAt) {
+    if (typeof optionsOrUpdatedAt === "string") {
+        const workspaceId = defaultWorkspaceIdValue;
+        return {
+            updatedAt: optionsOrUpdatedAt,
+            previousState: undefined,
+            portRange: defaultProjectPortRange,
+            reservedPorts: new Set(),
+            workspaceId,
+            targetId: undefined,
+        };
+    }
+    const workspaceId = sanitizeRuntimeId(optionsOrUpdatedAt?.workspaceId ??
+        optionsOrUpdatedAt?.previousState?.workspaceId ??
+        defaultWorkspaceIdValue);
+    return {
+        updatedAt: optionsOrUpdatedAt?.updatedAt ?? new Date().toISOString(),
+        previousState: optionsOrUpdatedAt?.previousState,
+        portRange: optionsOrUpdatedAt?.portRange ?? defaultProjectPortRange,
+        reservedPorts: new Set(optionsOrUpdatedAt?.reservedPorts ?? []),
+        workspaceId,
+        targetId: optionsOrUpdatedAt?.targetId ?? optionsOrUpdatedAt?.previousState?.targetId,
+    };
+}
+export function loadProjectState(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return undefined;
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+export function saveProjectState(filePath, state) {
+    fs.mkdirSync(dirnamePathLike(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+}
+export function collectReservedProjectPorts(options) {
+    const workspacesDir = projectWorkspacesStateDirectoryPath(options);
+    if (!fs.existsSync(workspacesDir)) {
+        return [];
+    }
+    const excludedWorkspaceId = options.excludeWorkspaceId
+        ? sanitizeRuntimeId(options.excludeWorkspaceId)
+        : undefined;
+    const ports = new Set();
+    for (const entry of fs.readdirSync(workspacesDir, { withFileTypes: true })) {
+        if (!entry.isDirectory() || entry.name === excludedWorkspaceId) {
+            continue;
+        }
+        const state = loadProjectState(joinPathLike(workspacesDir, entry.name, projectStateFileName));
+        for (const image of state?.images ?? []) {
+            if (image.status !== "stopped") {
+                ports.add(image.assignedPort);
+            }
+        }
+    }
+    return [...ports];
+}
+export function renderProjectImageName(template, context) {
+    return template.replace(/\{(projectId|projectName|workspaceId|targetId|imageId)\}/g, (_match, key) => context[key]);
+}
+export function createProjectState(config, optionsOrUpdatedAt) {
+    const options = normalizeCreateProjectStateOptions(optionsOrUpdatedAt);
+    validatePortRange(options.portRange);
+    const targetId = options.targetId ??
+        defaultTargetId(config.kanban.projectId, options.workspaceId);
+    const configuredPorts = new Set(config.images
+        .map((image) => image.mcp.port)
+        .filter((port) => port !== undefined));
+    const unavailablePorts = new Set([...options.reservedPorts, ...configuredPorts]);
+    const images = config.images.map((image) => {
+        const previousPort = previousImagePort(options.previousState, image.id);
+        let assignedPort = image.mcp.port;
+        if (assignedPort !== undefined && options.reservedPorts.has(assignedPort)) {
+            throw new PortAllocationError(`Configured port ${assignedPort} is already reserved by another workspace`);
+        }
+        if (assignedPort === undefined) {
+            if (previousPort !== undefined &&
+                !configuredPorts.has(previousPort) &&
+                !unavailablePorts.has(previousPort)) {
+                assignedPort = previousPort;
+            }
+            else {
+                assignedPort = nextAvailablePort(options.portRange, unavailablePorts);
+            }
+        }
+        unavailablePorts.add(assignedPort);
+        return {
+            id: image.id,
+            imageName: renderProjectImageName(image.imageName, {
+                projectId: config.kanban.projectId,
+                projectName: config.name,
+                workspaceId: options.workspaceId,
+                targetId,
+                imageId: image.id,
+            }),
+            assignedPort,
+            status: image.active ? "starting" : "stopped",
+        };
+    });
+    const imageNames = new Set();
+    for (const image of images) {
+        if (imageNames.has(image.imageName)) {
+            throw new ProjectStateError(`Rendered image names must be unique: ${image.imageName}`);
+        }
+        imageNames.add(image.imageName);
+    }
+    return {
+        projectId: config.kanban.projectId,
+        projectName: config.name,
+        workspaceId: options.workspaceId,
+        targetId,
+        updatedAt: options.updatedAt,
+        images,
+    };
+}
+//# sourceMappingURL=projectState.js.map

package/dist/projectState.js.map

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

package/dist/scopedPharoLauncherServer.d.ts

@@ -0,0 +1,87 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type ProjectImageState } from "./projectState.js";
+export interface ScopedPharoLauncherOptions {
+    projectRoot: string;
+    workspaceId?: string;
+    targetId?: string;
+    stateRoot?: string;
+}
+interface ResolvedScope {
+    projectRoot: string;
+    workspaceId: string;
+    targetId: string;
+    stateRoot?: string;
+}
+interface WorkspaceImageSummary {
+    imageId: string;
+    imageName: string;
+    active: boolean;
+    assignedPort?: number;
+    pid?: number;
+    status: ProjectImageState["status"] | "declared";
+    pharoMcpContract?: ProjectImageState["pharoMcpContract"];
+}
+export declare class ScopedPharoLauncherError extends Error {
+    constructor(message: string);
+}
+export declare class ScopedPharoLauncher {
+    private readonly options;
+    constructor(options: ScopedPharoLauncherOptions);
+    listImages(): {
+        scope: ResolvedScope;
+        images: WorkspaceImageSummary[];
+    };
+    imageInfo(imageId: string): {
+        scope: ResolvedScope;
+        image: WorkspaceImageSummary;
+    };
+    startImage(imageId: string): Promise<{
+        scope: ResolvedScope;
+        image: WorkspaceImageSummary;
+    }>;
+    stopImage(imageId: string): Promise<{
+        scope: ResolvedScope;
+        image: WorkspaceImageSummary;
+    }>;
+}
+export declare const scopedPharoLauncherTools: readonly [{
+    readonly name: "pharo_launcher_image_list";
+    readonly description: "List Pharo images declared in the current PLexus project/workspace scope.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "pharo_launcher_image_info";
+    readonly description: "Return scoped state for one Pharo image handle in the current PLexus workspace.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "pharo_launcher_image_start";
+    readonly description: "Start a workspace-scoped active image through PLexus project open policy.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: "pharo_launcher_image_stop";
+    readonly description: "Reserved scoped stop entry point. Does not accept arbitrary host pids or image names.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: Record<string, unknown>;
+        readonly required: string[];
+        readonly additionalProperties: false;
+    };
+}];
+export declare function createScopedPharoLauncherServer(options: ScopedPharoLauncherOptions): Server;
+export declare function startScopedPharoLauncherServer(options: ScopedPharoLauncherOptions): Promise<void>;
+export {};
+//# sourceMappingURL=scopedPharoLauncherServer.d.ts.map

package/dist/scopedPharoLauncherServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopedPharoLauncherServer.d.ts","sourceRoot":"","sources":["../src/scopedPharoLauncherServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAQnE,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAgB3B,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;IACjD,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;CAC1D;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AA6DD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,0BAA0B;IAEhE,UAAU,IAAI;QACZ,KAAK,EAAE,aAAa,CAAC;QACrB,MAAM,EAAE,qBAAqB,EAAE,CAAC;KACjC;IAuBD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG;QAC1B,KAAK,EAAE,aAAa,CAAC;QACrB,KAAK,EAAE,qBAAqB,CAAC;KAC9B;IAeK,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QACzC,KAAK,EAAE,aAAa,CAAC;QACrB,KAAK,EAAE,qBAAqB,CAAC;KAC9B,CAAC;IAmBI,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QACxC,KAAK,EAAE,aAAa,CAAC;QACrB,KAAK,EAAE,qBAAqB,CAAC;KAC9B,CAAC;CAMH;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B3B,CAAC;AAEX,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAuDR;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/scopedPharoLauncherServer.js

@@ -0,0 +1,186 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { loadProjectConfig } from "./projectConfig.js";
+import { openProject } from "./projectOpen.js";
+import { defaultTargetId, defaultWorkspaceId, loadProjectState, projectStatePathForConfig, } from "./projectState.js";
+const stringSchema = { type: "string", minLength: 1 };
+function objectSchema(properties, required = []) {
+    return {
+        type: "object",
+        properties,
+        required,
+        additionalProperties: false,
+    };
+}
+export class ScopedPharoLauncherError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ScopedPharoLauncherError";
+    }
+}
+function textResult(value, isError = false) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+        ...(isError ? { isError } : {}),
+    };
+}
+function objectInput(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        return {};
+    }
+    return input;
+}
+function requireString(input, key) {
+    const value = input[key];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new ScopedPharoLauncherError(`${key} is required`);
+    }
+    return value;
+}
+function requireConfirm(input) {
+    if (input.confirm !== true) {
+        throw new ScopedPharoLauncherError("confirm: true is required");
+    }
+}
+function resolveScope(options) {
+    const projectConfig = loadProjectConfig(options.projectRoot);
+    const workspaceId = options.workspaceId ?? defaultWorkspaceId(options.projectRoot);
+    return {
+        projectRoot: options.projectRoot,
+        workspaceId,
+        targetId: options.targetId ?? defaultTargetId(projectConfig.kanban.projectId, workspaceId),
+        ...(options.stateRoot ? { stateRoot: options.stateRoot } : {}),
+    };
+}
+function imageSummary(imageConfig, imageState) {
+    return {
+        imageId: imageConfig.id,
+        imageName: imageState?.imageName ?? imageConfig.imageName,
+        active: imageConfig.active,
+        ...(imageState?.assignedPort ? { assignedPort: imageState.assignedPort } : {}),
+        ...(imageState?.pid ? { pid: imageState.pid } : {}),
+        status: imageState?.status ?? "declared",
+        ...(imageState?.pharoMcpContract
+            ? { pharoMcpContract: imageState.pharoMcpContract }
+            : {}),
+    };
+}
+export class ScopedPharoLauncher {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    listImages() {
+        const scope = resolveScope(this.options);
+        const projectConfig = loadProjectConfig(scope.projectRoot);
+        const state = loadProjectState(projectStatePathForConfig({
+            projectRoot: scope.projectRoot,
+            config: projectConfig,
+            workspaceId: scope.workspaceId,
+            stateRoot: scope.stateRoot,
+        }));
+        return {
+            scope,
+            images: projectConfig.images.map((imageConfig) => imageSummary(imageConfig, state?.images.find((image) => image.id === imageConfig.id))),
+        };
+    }
+    imageInfo(imageId) {
+        const listed = this.listImages();
+        const image = listed.images.find((candidate) => candidate.imageId === imageId);
+        if (!image) {
+            throw new ScopedPharoLauncherError(`Image ${imageId} is not declared in this PLexus workspace`);
+        }
+        return {
+            scope: listed.scope,
+            image,
+        };
+    }
+    async startImage(imageId) {
+        const before = this.imageInfo(imageId);
+        if (!before.image.active) {
+            throw new ScopedPharoLauncherError(`Image ${imageId} is not active in project config; scoped start is rejected`);
+        }
+        await openProject({
+            projectRoot: before.scope.projectRoot,
+            workspaceId: before.scope.workspaceId,
+            targetId: before.scope.targetId,
+            stateRoot: before.scope.stateRoot,
+            imageIds: [imageId],
+        });
+        return this.imageInfo(imageId);
+    }
+    async stopImage(imageId) {
+        const before = this.imageInfo(imageId);
+        throw new ScopedPharoLauncherError(`Scoped per-image stop is not implemented for ${before.image.imageId}; use PLexus project close policy`);
+    }
+}
+export const scopedPharoLauncherTools = [
+    {
+        name: "pharo_launcher_image_list",
+        description: "List Pharo images declared in the current PLexus project/workspace scope.",
+        inputSchema: objectSchema({}),
+    },
+    {
+        name: "pharo_launcher_image_info",
+        description: "Return scoped state for one Pharo image handle in the current PLexus workspace.",
+        inputSchema: objectSchema({ imageId: stringSchema }, ["imageId"]),
+    },
+    {
+        name: "pharo_launcher_image_start",
+        description: "Start a workspace-scoped active image through PLexus project open policy.",
+        inputSchema: objectSchema({ imageId: stringSchema }, ["imageId"]),
+    },
+    {
+        name: "pharo_launcher_image_stop",
+        description: "Reserved scoped stop entry point. Does not accept arbitrary host pids or image names.",
+        inputSchema: objectSchema({
+            imageId: stringSchema,
+            confirm: { type: "boolean" },
+        }, ["imageId", "confirm"]),
+    },
+];
+export function createScopedPharoLauncherServer(options) {
+    const facade = new ScopedPharoLauncher(options);
+    const server = new Server({
+        name: "pharo-launcher",
+        version: "0.1.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [...scopedPharoLauncherTools],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        try {
+            const input = objectInput(request.params.arguments ?? {});
+            switch (request.params.name) {
+                case "pharo_launcher_image_list":
+                    return textResult(facade.listImages());
+                case "pharo_launcher_image_info":
+                    return textResult(facade.imageInfo(requireString(input, "imageId")));
+                case "pharo_launcher_image_start":
+                    return textResult(await facade.startImage(requireString(input, "imageId")));
+                case "pharo_launcher_image_stop":
+                    requireConfirm(input);
+                    return textResult(await facade.stopImage(requireString(input, "imageId")));
+                default:
+                    return textResult({ ok: false, error: `Unknown tool: ${request.params.name}` }, true);
+            }
+        }
+        catch (error) {
+            return textResult({
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            }, true);
+        }
+    });
+    return server;
+}
+export async function startScopedPharoLauncherServer(options) {
+    const server = createScopedPharoLauncherServer(options);
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=scopedPharoLauncherServer.js.map

package/dist/scopedPharoLauncherServer.js.map

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

package/dist/scopedProjectContext.d.ts

@@ -0,0 +1,93 @@
+import { type ProjectConfig } from "./projectConfig.js";
+import { type ProjectImageStatus, type ProjectState } from "./projectState.js";
+export type ScopedProjectContextSchemaVersion = 1;
+export type ScopedImageStatus = ProjectImageStatus | "declared";
+export type ScopedImageCleanupPolicy = "workspace_cleanup_only";
+export interface ScopedProjectContextScope {
+    projectRoot: string;
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    targetId: string;
+    stateRoot?: string;
+    statePath: string;
+}
+export interface ScopedImageOwnership {
+    projectId: string;
+    workspaceId: string;
+    targetId: string;
+    owned: true;
+    disposable: true;
+}
+export interface ScopedImageAffordanceAllowed {
+    allowed: true;
+    toolName: string;
+    arguments: Record<string, unknown>;
+}
+export interface ScopedImageAffordanceDenied {
+    allowed: false;
+    reason: string;
+}
+export type ScopedImageAffordance = ScopedImageAffordanceAllowed | ScopedImageAffordanceDenied;
+export interface ScopedImageAffordances {
+    create: ScopedImageAffordance;
+    start: ScopedImageAffordance;
+    stop: ScopedImageAffordance;
+    delete: ScopedImageAffordanceDenied;
+}
+export interface ScopedImageCleanupPaths {
+    imagePath?: string;
+    imageDirectoryPath?: string;
+    changesPath?: string;
+    localDirectoryPath?: string;
+    ombuDirectoryPath?: string;
+}
+export interface ScopedImageCleanupMetadata {
+    disposable: true;
+    statePath: string;
+    launcherImageName: string;
+    policy: ScopedImageCleanupPolicy;
+    paths: ScopedImageCleanupPaths;
+}
+export interface ScopedImageGatewayRouteMetadata {
+    serverName: "gateway";
+    requiredArgument: "imageId";
+    imageId: string;
+    routeReference: {
+        projectId: string;
+        workspaceId: string;
+        targetId: string;
+    };
+    imageIdSource: string;
+    recordHint: string;
+}
+export interface ScopedImageContext {
+    imageId: string;
+    launcherImageName: string;
+    active: boolean;
+    status: ScopedImageStatus;
+    assignedPort?: number;
+    pid?: number;
+    ownership: ScopedImageOwnership;
+    affordances: ScopedImageAffordances;
+    cleanup: ScopedImageCleanupMetadata;
+    route: ScopedImageGatewayRouteMetadata;
+}
+export interface ScopedProjectContext {
+    schemaVersion: ScopedProjectContextSchemaVersion;
+    scope: ScopedProjectContextScope;
+    images: ScopedImageContext[];
+}
+export interface BuildScopedProjectContextOptions {
+    projectRoot: string;
+    projectConfig?: ProjectConfig;
+    workspaceId?: string;
+    targetId?: string;
+    stateRoot?: string;
+    projectState?: ProjectState;
+}
+export declare class ScopedProjectContextError extends Error {
+    constructor(message: string);
+}
+export declare function buildScopedProjectContext(options: BuildScopedProjectContextOptions): ScopedProjectContext;
+//# sourceMappingURL=scopedProjectContext.d.ts.map

package/dist/scopedProjectContext.d.ts.map

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