@crowdedkingdoms/crowdy-dsh 0.2.0-dev.1 → 0.2.0-dev.2

package/lib/types/bridge/protocol.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Wire protocol between the harness (running in the browser worker) and the
+ * Crowdy Studio page that embeds it. Both sides join one `BroadcastChannel`
+ * whose name the page chose and wrote into `crowdy.json`.
+ *
+ * The page executes anything that needs the game or the Studio editor
+ * (screenshots, draft tests, deploys, project switching, game observation); the
+ * worker executes file edits and model calls. CrowdyJS mirrors these types in
+ * `src/crowdy-dsh/protocol.ts`; keep the two in step.
+ *
+ * @module @crowdedkingdoms/crowdy-dsh/bridge-protocol
+ */
+export declare const CROWDY_BRIDGE_PROTOCOL_VERSION: 2;
+export type BridgeSide = 'page' | 'worker';
+/**
+ * Envelope: every frame carries the protocol version, the boot nonce `n` and
+ * the sender. A `BroadcastChannel` is open to every same-origin script, so
+ * both sides drop any frame whose nonce is not the one the page handed the
+ * worker in the boot message.
+ */
+export type BridgeFrame = {
+    v: typeof CROWDY_BRIDGE_PROTOCOL_VERSION;
+    n: string;
+    from: BridgeSide;
+    t: 'req';
+    id: string;
+    method: string;
+    params: unknown;
+} | {
+    v: typeof CROWDY_BRIDGE_PROTOCOL_VERSION;
+    n: string;
+    from: BridgeSide;
+    t: 'res';
+    id: string;
+    result: unknown;
+} | {
+    v: typeof CROWDY_BRIDGE_PROTOCOL_VERSION;
+    n: string;
+    from: BridgeSide;
+    t: 'err';
+    id: string;
+    code: string;
+    message: string;
+} | {
+    v: typeof CROWDY_BRIDGE_PROTOCOL_VERSION;
+    n: string;
+    from: BridgeSide;
+    t: 'event';
+    event: string;
+    payload: unknown;
+};
+export interface ScreenshotResult {
+    /** Suggested file name, e.g. `capture-0003.png`. */
+    name: string;
+    mediaType: 'image/png' | 'image/jpeg' | 'image/webp';
+    /** Encoded bytes (structured-cloned, not transferred). */
+    bytes: ArrayBuffer;
+    width: number;
+    height: number;
+    /** What was on screen, in the page's words (HUD text, phase). */
+    caption?: string;
+}
+export interface StudioDiagnostic {
+    target: 'SERVER' | 'CLIENT';
+    path: string;
+    line?: number;
+    column?: number;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+}
+export interface RuntimeStatus {
+    target: 'SERVER' | 'CLIENT';
+    phase: string;
+    moduleName?: string;
+    runningRevision?: string;
+    savedRevision?: string;
+    message?: string;
+}
+export interface BuildResult {
+    ok: boolean;
+    /** `draft` or `live`. */
+    mode: 'draft' | 'live';
+    summary: string;
+    diagnostics: StudioDiagnostic[];
+    /** Compiler output, truncated by the page. */
+    buildLog: string;
+    runtime: RuntimeStatus[];
+    /** Set when the page captured the game after the client target started. */
+    screenshot?: ScreenshotResult;
+}
+export interface ProjectSummary {
+    projectId: string;
+    name: string;
+    kind: string;
+    updatedAt: string;
+    /** Bound repository label when the project is GitHub-bound. */
+    github?: string;
+}
+export interface ProjectListResult {
+    projects: ProjectSummary[];
+    currentProjectId: string | null;
+}
+export interface ProjectOpenResult {
+    project: ProjectSummary;
+}
+export interface ProjectCreateParams {
+    name: string;
+    /** Template id from the Studio starter catalog; omitted means the blank full-stack template. */
+    template?: string;
+}
+export interface LogLinesResult {
+    lines: string[];
+    truncated: boolean;
+}
+export interface GameObservationResult {
+    /** Structured observation as the game's PlayerHost reports it. */
+    observation: unknown;
+    capturedAt: string;
+}
+/** Method names with their parameter and result shapes. */
+export interface BridgeRequestMap {
+    'studio.screenshot': {
+        params: {
+            label?: string;
+        };
+        result: ScreenshotResult;
+    };
+    'studio.draftTest': {
+        params: Record<string, never>;
+        result: BuildResult;
+    };
+    'studio.deployLive': {
+        params: Record<string, never>;
+        result: BuildResult;
+    };
+    'studio.runtimeStatus': {
+        params: Record<string, never>;
+        result: {
+            runtime: RuntimeStatus[];
+        };
+    };
+    'studio.runtimeLogs': {
+        params: {
+            limit?: number;
+        };
+        result: LogLinesResult;
+    };
+    'studio.clientLogs': {
+        params: {
+            limit?: number;
+        };
+        result: LogLinesResult;
+    };
+    'studio.projectList': {
+        params: Record<string, never>;
+        result: ProjectListResult;
+    };
+    'studio.projectOpen': {
+        params: {
+            projectId: string;
+        };
+        result: ProjectOpenResult;
+    };
+    'studio.projectCreate': {
+        params: ProjectCreateParams;
+        result: ProjectOpenResult;
+    };
+    'game.observe': {
+        params: Record<string, never>;
+        result: GameObservationResult;
+    };
+}
+export type BridgeMethod = keyof BridgeRequestMap;
+/** Events the page emits. */
+export interface PageEventMap {
+    /** Page joined the channel or reloaded its state. */
+    'page.hello': {
+        appId: string;
+        projectId: string | null;
+        appToken?: string;
+    };
+    'page.token': {
+        appToken: string;
+    };
+    'page.project': {
+        projectId: string | null;
+    };
+    /** The page saved the project itself; cached snapshots are stale. */
+    'page.saved': {
+        revision?: string;
+    };
+    /** Shared context the model may read under `context/`. */
+    'page.context': {
+        observation?: unknown;
+        clientLogs?: string[];
+        diagnostics?: StudioDiagnostic[];
+        runtime?: RuntimeStatus[];
+        note?: string;
+    };
+    /** A capture the player took from the pane header. */
+    'page.capture': ScreenshotResult;
+    /**
+     * Text the page wants the agent to work on (e.g. "Fix with AI" from a
+     * diagnostic). Queued into the most recent live session, or a new one.
+     */
+    'page.prompt': {
+        text: string;
+        mode?: 'queue' | 'steer';
+    };
+    /** The page is going away; tools should fail fast. */
+    'page.bye': Record<string, never>;
+}
+/** Events the worker emits. */
+export interface WorkerEventMap {
+    'worker.ready': {
+        root: string;
+        store?: string;
+    };
+    'worker.fileChanged': {
+        target: 'SERVER' | 'CLIENT';
+        path: string;
+    };
+    'worker.warning': {
+        message: string;
+    };
+    /** Ask the editor to reveal a file, e.g. from a diagnostic the model cited. */
+    'worker.openFile': {
+        target: 'SERVER' | 'CLIENT';
+        path: string;
+        line?: number;
+    };
+}
+export type PageEvent = keyof PageEventMap;
+export type WorkerEvent = keyof WorkerEventMap;
+export declare const BRIDGE_ERROR_CODES: {
+    readonly unavailable: "BRIDGE_UNAVAILABLE";
+    readonly timeout: "BRIDGE_TIMEOUT";
+    readonly refused: "BRIDGE_REFUSED";
+    readonly pageError: "PAGE_ERROR";
+};
+export declare function isBridgeFrame(value: unknown, nonce?: string): value is BridgeFrame;
+//# sourceMappingURL=protocol.d.ts.map

package/lib/types/bridge/protocol.d.ts.map

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

package/lib/types/crowdy/client.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Crowdy Studio project-file access for the cockpit, on top of CrowdyJS.
+ *
+ * The cockpit is a client of the platform exactly like a browser running Studio:
+ * it signs in as the modder with the public SDK, mints an app-scoped token for
+ * the target app, and reads / writes project files through the same GraphQL
+ * operations Studio uses. There is no private wire, no second endpoint, and no
+ * server-side component that knows this process exists.
+ *
+ * Only the operations a filesystem backend needs are exposed: authenticate,
+ * load a project with its files, save a batch of upserts / deletes under an
+ * expected project revision, and (for the setup script) create a project.
+ */
+import { type CrowdyClient } from '../vendor/crowdyjs-sdk.js';
+/** Project targets are two independent file trees with separate quotas. */
+export type CrowdyTarget = 'SERVER' | 'CLIENT';
+export interface CrowdyProjectFile {
+    target: CrowdyTarget;
+    path: string;
+    content: string;
+    /** Per-file counter, incremented on every successful upsert of this target/path. */
+    revision: string;
+    updatedAt: string;
+}
+export interface CrowdyProject {
+    projectId: string;
+    appId: string;
+    ownerUserId: string;
+    name: string;
+    /** Project-wide counter guarding every mutation; `expectedRevision` must equal it. */
+    revision: string;
+    archived: boolean;
+    files: CrowdyProjectFile[];
+    updatedAt: string;
+}
+export interface CrowdyFileUpsert {
+    target: CrowdyTarget;
+    path: string;
+    content: string;
+}
+export interface CrowdyFileDelete {
+    target: CrowdyTarget;
+    path: string;
+}
+/**
+ * A GraphQL error surfaced with the server's error code intact so callers can
+ * branch on it. Revision conflicts in particular need distinct handling.
+ */
+export declare class CrowdyApiError extends Error {
+    readonly code: string | undefined;
+    readonly remediation?: string | undefined;
+    constructor(message: string, code: string | undefined, remediation?: string | undefined);
+    /** True when the write lost an optimistic-concurrency race and must be replayed. */
+    get isRevisionConflict(): boolean;
+    /** True when the bearer is missing, expired, or not app-scoped. */
+    get isAuthFailure(): boolean;
+}
+export interface CrowdyClientOptions {
+    /** Absolute GraphQL endpoint, e.g. `http://localhost:3000/graphql`. */
+    endpoint: string;
+    /** Numeric app id, carried as a string because it is a GraphQL BigInt. */
+    appId: string;
+    /** Pre-minted app-scoped token; when absent, supply `email`/`password` to mint one. */
+    appToken?: string;
+    email?: string;
+    password?: string;
+}
+/**
+ * Project-file client. One instance per configured `(endpoint, appId)`; the
+ * bearer is resolved lazily on the first call and held in memory only.
+ */
+export declare class CrowdyStudioClient {
+    private readonly options;
+    private readonly sdk;
+    private appToken;
+    private authenticating;
+    constructor(options: CrowdyClientOptions);
+    /** The app id every call is scoped to. */
+    get appId(): string;
+    /**
+     * Replace the bearer, e.g. when the Studio page refreshes the app token over
+     * the bridge. An empty token falls back to the credential mint path.
+     */
+    setToken(token: string | undefined): void;
+    /** GitHub loop of the bound repository; every call carries `(appId, projectId)`. */
+    get github(): CrowdyClient['crowdyStudioGitHub'];
+    /** Projects the caller owns in this app. */
+    listProjects(): Promise<Array<{
+        projectId: string;
+        name: string;
+        kind: string;
+        updatedAt: string;
+    }>>;
+    /**
+     * Resolve the app-scoped bearer. A pre-minted `appToken` wins; otherwise sign
+     * in as the modder (first-party, no browser Origin — the same path
+     * CrowdyCPP and the load tests use) and mint a token for `appId`.
+     */
+    authenticate(): Promise<string>;
+    /** Load a project and the full text of every file it contains. */
+    loadProject(projectId: string): Promise<CrowdyProject>;
+    /**
+     * Apply upserts and deletes in one transaction guarded by `expectedRevision`.
+     * A stale revision throws {@link CrowdyApiError} with `isRevisionConflict`.
+     *
+     * Studio's own editor goes through `crowdyStudioProjectSave` with the whole
+     * file list; a filesystem needs the files-only twin so a single `write`
+     * cannot disturb metadata it never read.
+     *
+     * @returns the project as it exists after the write, with its new revision.
+     */
+    saveFiles(args: {
+        projectId: string;
+        expectedRevision: string;
+        upserts?: CrowdyFileUpsert[];
+        deletes?: CrowdyFileDelete[];
+        idempotencyKey?: string;
+    }): Promise<CrowdyProject>;
+    /** Create a project, used by the setup script to produce a scratch target. */
+    createProject(args: {
+        name: string;
+        description?: string;
+        initialFiles?: CrowdyFileUpsert[];
+    }): Promise<CrowdyProject>;
+}
+//# sourceMappingURL=client.d.ts.map

package/lib/types/crowdy/client.d.ts.map

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

package/lib/types/crowdy/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../../src/crowdy/client.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/lib/types/crowdy/config.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Boot configuration shared by every Crowdy plugin.
+ *
+ * Two hosts run these plugins:
+ *
+ *   - the **browser worker image** embedded by Crowdy Studio, where the page
+ *     writes `$DSH_HOME/crowdy.json` into the worker's virtual filesystem as a
+ *     pre-boot overlay before the harness tree mounts;
+ *   - the **developer cockpit** (`dsh web --patch profile/crowdy-node.patch.yml`
+ *     on Node 22), where the same keys arrive as `CROWDY_*` environment
+ *     variables.
+ *
+ * Both hosts converge here. Environment wins over the file so a developer can
+ * override one field without editing the overlay.
+ *
+ * @module @crowdedkingdoms/crowdy-dsh/crowdy/config
+ */
+/** File the page-side bridge writes into the worker's `$DSH_HOME`. */
+export declare const CROWDY_CONFIG_FILENAME = "crowdy.json";
+export interface CrowdyBootConfig {
+    /** GraphQL endpoint of the game API serving Crowdy Studio. */
+    graphqlUrl: string;
+    /** App tenant id (a GraphQL BigInt carried as a decimal string). */
+    appId: string;
+    /** Project whose files become the agent's filesystem. */
+    projectId: string;
+    /**
+     * App-scoped bearer. In the browser it arrives ONLY over the bridge
+     * (`page.hello` / `page.token`) and is held in memory; the page never writes
+     * it into `crowdy.json`. In the cockpit it is `CROWDY_APP_TOKEN`.
+     */
+    appToken?: string;
+    /** Fallback credentials for the cockpit only (never present in the browser). */
+    email?: string;
+    password?: string;
+    /** Virtual mount point for the project trees. */
+    root?: string;
+    /**
+     * Name of the `BroadcastChannel` the Studio page listens on. Absent in the
+     * cockpit, where there is no page and page-executed tools are unavailable.
+     */
+    bridgeChannel?: string;
+    /** One-time secret the page put in the boot message; every bridge frame carries it. */
+    bridgeNonce?: string;
+    /** Prefer the bound GitHub repository as the file source of truth. */
+    githubFirst?: boolean;
+    /** Studio origin used to render wallet links in tool messages. */
+    studioOrigin?: string;
+    /** OPFS scope for session persistence (browser only); see `./persist`. */
+    persistScope?: string;
+}
+/**
+ * Resolve the boot configuration from `$DSH_HOME/crowdy.json` and the
+ * environment. Missing required fields are reported together so the first
+ * failed tool call names every problem at once.
+ */
+export declare function loadCrowdyConfig(overrides?: Partial<CrowdyBootConfig>): CrowdyBootConfig;
+/** Human-readable reason the configuration cannot reach a project yet. */
+export declare function describeMissing(config: CrowdyBootConfig): string | undefined;
+//# sourceMappingURL=config.d.ts.map

package/lib/types/crowdy/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/crowdy/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AA4BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,gBAAgB,CA2B5F;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAO5E"}

package/lib/types/crowdy/github-layout.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Repository layout of a GitHub-bound Crowdy Studio project.
+ *
+ * Mirrors `CrowdyJS/src/crowdy-studio/github/sync.ts` (the Studio panel's
+ * push/pull), which is the source of truth. It is restated here rather than
+ * imported because that module lives in the `crowdy-studio` entry beside the
+ * Monaco editor, and the worker image must not carry the editor.
+ *
+ * Layout (from `crowdy.json` at the repo root, else inferred from the tree):
+ *
+ *   SERVER src/lib.rs  <->  <serverRoot>/src/lib.rs
+ *   CLIENT src/lib.rs  <->  <clientRoot>/src/lib.rs
+ *
+ * @module @crowdedkingdoms/crowdy-dsh/crowdy/github-layout
+ */
+import type { CrowdyTarget } from './client.js';
+export interface GitHubLayout {
+    serverRoot: string | null;
+    clientRoot: string | null;
+}
+export interface GitHubTreeEntryLike {
+    path: string;
+    type: string;
+}
+export declare const DEFAULT_FULL_STACK_CROWDY_JSON = "{\n  \"server\": \"server\",\n  \"client\": \"client\"\n}\n";
+export declare function trimSlash(path: string): string;
+export declare function joinRepo(root: string, rel: string): string;
+export declare function underRoot(path: string, root: string | null): string | null;
+export declare function parseCrowdyJson(content: string): GitHubLayout | null;
+export declare function layoutFromTree(entries: ReadonlyArray<GitHubTreeEntryLike>): GitHubLayout;
+export declare function repoPathToStudioFile(layout: GitHubLayout, repoPath: string): {
+    target: CrowdyTarget;
+    path: string;
+} | null;
+export declare function studioFileToRepoPath(layout: GitHubLayout, target: CrowdyTarget, path: string): string | null;
+//# sourceMappingURL=github-layout.d.ts.map

package/lib/types/crowdy/github-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-layout.d.ts","sourceRoot":"","sources":["../../../src/crowdy/github-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,8BAA8B,gEAI1C,CAAA;AAKD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAO1E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAUpE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAAG,YAAY,CAQxF;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU/C;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAIf"}

package/lib/types/crowdy/paths.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Path mapping between the virtual tree the agent sees and the flat
+ * `(target, path)` pairs Crowdy Studio stores.
+ *
+ * A Crowdy project is not a directory tree: it is two independent bags of files
+ * keyed by target. We present them as two directories under one root so ordinary
+ * path-shaped tools work unchanged:
+ *
+ *   <root>/server/src/main.rs  <->  (SERVER, "src/main.rs")
+ *   <root>/client/Cargo.toml   <->  (CLIENT, "Cargo.toml")
+ */
+import type { CrowdyTarget } from './client.js';
+export declare const DEFAULT_ROOT = "/crowdy";
+export interface CrowdyLocation {
+    target: CrowdyTarget;
+    /** Project-relative path, e.g. `src/main.rs`. Never empty. */
+    path: string;
+}
+/**
+ * Scratch directories beside the two targets. They are not project files:
+ * `captures/` holds screenshots the page took, `context/` holds game
+ * observations, client logs and the latest build diagnostics. Both live only
+ * in memory for the life of the harness.
+ */
+export declare const SCRATCH_DIRS: readonly ["captures", "context"];
+export type ScratchDir = (typeof SCRATCH_DIRS)[number];
+/** What a virtual absolute path denotes. */
+export type Resolved = {
+    kind: 'root';
+} | {
+    kind: 'target';
+    target: CrowdyTarget;
+} | {
+    kind: 'file';
+    location: CrowdyLocation;
+} | {
+    kind: 'scratch-dir';
+    dir: ScratchDir;
+} | {
+    kind: 'scratch-file';
+    dir: ScratchDir;
+    name: string;
+};
+/**
+ * Collapse `.`/`..` segments and duplicate separators without touching the
+ * filesystem. Crowdy paths are virtual, so `realpath` semantics do not apply and
+ * traversal must be resolved textually.
+ *
+ * @returns an absolute path with no `.`/`..` segments.
+ */
+export declare function normalizeAbsolute(input: string): string;
+/** Join a possibly-relative path against a cwd, then normalize. */
+export declare function resolveAgainst(cwd: string, input: string): string;
+/**
+ * Interpret an absolute virtual path relative to the configured root.
+ *
+ * @param absolute - normalized absolute path.
+ * @param root - the virtual root the project is mounted at.
+ * @returns what the path denotes, or `undefined` when it falls outside the root.
+ */
+export declare function classify(absolute: string, root?: string): Resolved | undefined;
+/** Virtual absolute path of a scratch file. */
+export declare function toScratchPath(dir: ScratchDir, name: string, root?: string): string;
+/** The scratch directories in name order. */
+export declare function scratchDirectories(root?: string): string[];
+/** Build the virtual absolute path for a stored file. */
+export declare function toVirtualPath(target: CrowdyTarget, path: string, root?: string): string;
+/** The two target directories in name order, used for listing the root. */
+export declare function targetDirectories(root?: string): string[];
+/**
+ * Direct children of a directory within one target, derived from the flat file
+ * list. Intermediate directories exist only implicitly, so they are synthesized
+ * from the path segments of the files beneath them.
+ *
+ * @param paths - every stored path for the target.
+ * @param prefix - project-relative directory prefix, `''` for the target root.
+ * @returns the direct children, each flagged as a file or directory.
+ */
+export declare function directChildren(paths: string[], prefix: string): Array<{
+    name: string;
+    isDirectory: boolean;
+}>;
+/**
+ * Whether a project-relative path is one Crowdy Studio will accept: `Cargo.toml`
+ * at the target root, or a `.rs` file below `src/`. Rejecting early gives the
+ * model a precise message instead of a generic server validation failure.
+ */
+export declare function isAcceptableProjectPath(path: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/lib/types/crowdy/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/crowdy/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,eAAO,MAAM,YAAY,YAAY,CAAA;AAMrC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAA;IACpB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,kCAAmC,CAAA;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAe,GAAG,QAAQ,GAAG,SAAS,CAsBpF;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAe,GAAG,MAAM,CAExF;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,IAAI,SAAe,GAAG,MAAM,EAAE,CAGhE;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,SAAe,GAClB,MAAM,CAER;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,SAAe,GAAG,MAAM,EAAE,CAK/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAmB/C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI7D"}

package/lib/types/crowdy/project-store.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Where a project's files live: the bound GitHub repository when the owner
+ * bound one (GitHub is then the source of truth and Studio holds the deployable
+ * mirror), otherwise the Crowdy Studio project itself.
+ *
+ * Both stores present the same versioned bag of `(target, path, content)` so
+ * the filesystem backend never learns which one it is talking to.
+ *
+ * @module @crowdedkingdoms/crowdy-dsh/crowdy/project-store
+ */
+import { CrowdyStudioClient } from './client.js';
+import type { CrowdyFileDelete, CrowdyFileUpsert, CrowdyProjectFile } from './client.js';
+export interface ProjectSnapshot {
+    /** Opaque store-wide version; every mutation must present the one it read. */
+    revision: string;
+    files: CrowdyProjectFile[];
+    source: 'studio' | 'github';
+    /** Human-readable origin for tool messages, e.g. `owner/repo@main`. */
+    label: string;
+}
+export interface ProjectBatch {
+    upserts?: CrowdyFileUpsert[];
+    deletes?: CrowdyFileDelete[];
+}
+export interface ProjectStore {
+    readonly kind: 'studio' | 'github';
+    load(): Promise<ProjectSnapshot>;
+    /**
+     * Apply a batch against `snapshot`. A lost race throws {@link CrowdyApiError}
+     * with `isRevisionConflict`; the caller re-reads and retries or reports.
+     */
+    commit(snapshot: ProjectSnapshot, batch: ProjectBatch): Promise<ProjectSnapshot>;
+}
+/** Crowdy Studio project files behind `crowdyStudioProject*`. */
+export declare class StudioProjectStore implements ProjectStore {
+    private readonly client;
+    private readonly projectId;
+    readonly kind: "studio";
+    constructor(client: CrowdyStudioClient, projectId: string);
+    load(): Promise<ProjectSnapshot>;
+    commit(snapshot: ProjectSnapshot, batch: ProjectBatch): Promise<ProjectSnapshot>;
+}
+/**
+ * The bound GitHub repository, read through `crowdyStudioGitHubTree/File` and
+ * written through `crowdyStudioGitHubPutFile` (Contents API, SHA-guarded).
+ *
+ * After every successful GitHub write the same batch is mirrored onto the
+ * Studio project so a draft test or deploy compiles what the agent wrote. The
+ * mirror is best-effort: GitHub already holds the truth, and a Studio revision
+ * race is reported, not treated as a failed write.
+ */
+export declare class GitHubProjectStore implements ProjectStore {
+    private readonly client;
+    private readonly projectId;
+    private readonly repoLabel;
+    private readonly warn;
+    readonly kind: "github";
+    private shas;
+    private layout;
+    /** Last mirror failure, surfaced once by the filesystem in its next result. */
+    mirrorWarning: string | undefined;
+    constructor(client: CrowdyStudioClient, projectId: string, repoLabel: string, warn?: (message: string) => void);
+    private get scope();
+    load(): Promise<ProjectSnapshot>;
+    commit(snapshot: ProjectSnapshot, batch: ProjectBatch): Promise<ProjectSnapshot>;
+    /** Copy the batch onto the Studio project so builds see the same bytes. */
+    private mirrorToStudio;
+}
+/** Crowdy Studio stores only `Cargo.toml` and `.rs` files under `src/`. */
+export declare function isSourcePath(path: string): boolean;
+export interface StoreSelection {
+    store: ProjectStore;
+    /** Why this store was chosen, for the system prompt and tool messages. */
+    reason: string;
+}
+/**
+ * Choose the store for a project: GitHub when the project is bound to a
+ * connected repository and the caller prefers it, otherwise Studio files.
+ */
+export declare function selectProjectStore(client: CrowdyStudioClient, projectId: string, options: {
+    githubFirst: boolean;
+    warn?: (message: string) => void;
+}): Promise<StoreSelection>;
+//# sourceMappingURL=project-store.d.ts.map