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

package/lib/bridge/client.js.map

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

package/lib/bridge/index.js

@@ -0,0 +1,155 @@
+/**
+ * Cordis service `ctx.crowdyBridge`: the harness's link to the Crowdy Studio
+ * page. It joins the page's `BroadcastChannel`, keeps the filesystem backend's
+ * token and project in step with the page, mirrors page-shared context into
+ * the `context/` and `captures/` scratch directories, and lets tools ask the
+ * page to run a draft test, take a screenshot, or switch projects.
+ *
+ * @module @crowdedkingdoms/crowdy-dsh/bridge
+ */
+import { Service } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { CrowdyFileSystem } from '../fs/crowdy-file-system.js';
+import { BridgeClient } from './client.js';
+export { BridgeClient, BridgeError } from './client.js';
+export * from './protocol.js';
+/** Cordis plugin name used by loader diagnostics. */
+export const name = 'crowdy-bridge';
+export class CrowdyBridge extends Service {
+    static inject = ['fs'];
+    static Config = z.object({
+        channel: z.string(),
+        nonce: z.string(),
+        timeoutMs: z.number().default(15_000),
+    });
+    client;
+    fs;
+    captureCounter = 0;
+    disposers = [];
+    constructor(ctx, config = {}) {
+        super(ctx, 'crowdyBridge');
+        const fs = ctx.fs;
+        if (!(fs instanceof CrowdyFileSystem)) {
+            throw new Error('crowdy-bridge: ctx.fs must be the Crowdy filesystem backend (@crowdedkingdoms/crowdy-dsh/fs).');
+        }
+        this.fs = fs;
+        this.client = new BridgeClient({
+            channel: config.channel ?? fs.boot.bridgeChannel,
+            nonce: config.nonce ?? fs.boot.bridgeNonce,
+            timeoutMs: config.timeoutMs,
+        });
+        this.wire();
+        // Registrations unwind with the plugin: the channel closes and the fs
+        // listeners detach when the row unloads.
+        ctx.effect(() => () => {
+            for (const dispose of this.disposers)
+                dispose();
+            this.disposers.length = 0;
+            this.client.close();
+        }, 'crowdy bridge');
+    }
+    /** Whether a Studio page is attached (page-executed tools can work). */
+    get pageConnected() {
+        return this.client.available && this.client.pagePresent;
+    }
+    /** Store a capture under `captures/` and return its virtual path. */
+    putCapture(shot) {
+        this.captureCounter += 1;
+        const extension = shot.mediaType === 'image/jpeg' ? 'jpg' : shot.mediaType === 'image/webp' ? 'webp' : 'png';
+        const name = shot.name && /^[\w.-]+$/.test(shot.name) ? shot.name : `capture-${String(this.captureCounter).padStart(4, '0')}.${extension}`;
+        const file = this.fs.scratch.putBytes('captures', name, new Uint8Array(shot.bytes));
+        if (shot.caption)
+            this.fs.scratch.putText('captures', `${name}.txt`, shot.caption);
+        return { path: `${this.fs.mountRoot}/captures/${name}`, file };
+    }
+    /** Store page-shared context as readable files under `context/`. */
+    putContext(payload) {
+        const written = [];
+        const put = (name, text) => {
+            this.fs.scratch.putText('context', name, text);
+            written.push(`${this.fs.mountRoot}/context/${name}`);
+        };
+        if (payload.observation !== undefined)
+            put('game-observation.json', JSON.stringify(payload.observation, null, 2));
+        if (payload.clientLogs)
+            put('client-logs.txt', payload.clientLogs.join('\n'));
+        if (payload.diagnostics)
+            put('diagnostics.json', JSON.stringify(payload.diagnostics, null, 2));
+        if (payload.runtime)
+            put('runtime.json', JSON.stringify(payload.runtime, null, 2));
+        if (payload.note)
+            put('note.txt', payload.note);
+        return written;
+    }
+    /**
+     * Queue text into the player's current session: the most recently created
+     * live agent, or a fresh session in the project mount when none is live.
+     * Uses the same host controller the web client's composer goes through, so
+     * the message shows up in the pane like a typed one.
+     */
+    async promptAgent(text, mode) {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return;
+        const sessions = this.ctx.get('sessionController');
+        if (!sessions)
+            throw new Error('no session controller in this composition');
+        const agents = this.ctx.get('agents');
+        const live = agents?.list() ?? [];
+        let sessionId = live.length > 0 ? live[live.length - 1].session.id : undefined;
+        if (sessionId === undefined) {
+            const created = await sessions.create({ cwd: this.fs.mountRoot, agentPreset: 'crowdy' });
+            sessionId = created.sessionId;
+        }
+        await sessions.prompt({
+            requestId: `crowdy-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
+            sessionId,
+            mode,
+            content: [{ type: 'text', text: trimmed }],
+        }, new AbortController().signal);
+    }
+    wire() {
+        const { client, fs } = this;
+        if (!client.available)
+            return;
+        this.disposers.push(client.on('page.hello', (payload) => {
+            if (payload.appToken)
+                fs.setToken(payload.appToken);
+            if (payload.projectId)
+                fs.setProject(payload.projectId);
+            fs.invalidate();
+            client.emit('worker.ready', { root: fs.mountRoot, ...(fs.storeReason ? { store: fs.storeReason } : {}) });
+        }), client.on('page.token', (payload) => {
+            // Also republishes CROWDY_APP_TOKEN, which the model route reads per request.
+            fs.setToken(payload.appToken);
+        }), client.on('page.project', (payload) => {
+            if (payload.projectId)
+                fs.setProject(payload.projectId);
+        }), client.on('page.saved', () => {
+            fs.invalidate();
+        }), client.on('page.context', (payload) => {
+            this.putContext(payload);
+        }), client.on('page.capture', (payload) => {
+            this.putCapture(payload);
+        }), client.on('page.prompt', (payload) => {
+            void this.promptAgent(payload.text, payload.mode ?? 'queue').catch((error) => {
+                client.emit('worker.warning', {
+                    message: `The prompt from Crowdy Studio was not delivered: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            });
+        }), fs.onChange((change) => {
+            client.emit('worker.fileChanged', change);
+        }), 
+        // A GitHub->Studio fallback or a failed mirror is the player's business:
+        // the page shows it in the pane instead of it sitting in a buffer.
+        fs.onWarning((message) => {
+            client.emit('worker.warning', { message });
+        }));
+        for (const message of fs.drainWarnings())
+            client.emit('worker.warning', { message });
+        // Announce so a page that connected before the worker booted learns we exist.
+        client.emit('worker.ready', { root: fs.mountRoot });
+    }
+}
+export default CrowdyBridge;
+//# sourceMappingURL=index.js.map

package/lib/bridge/index.js.map

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

package/lib/bridge/protocol.js

@@ -0,0 +1,30 @@
+/**
+ * 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 const CROWDY_BRIDGE_PROTOCOL_VERSION = 2;
+export const BRIDGE_ERROR_CODES = {
+    unavailable: 'BRIDGE_UNAVAILABLE',
+    timeout: 'BRIDGE_TIMEOUT',
+    refused: 'BRIDGE_REFUSED',
+    pageError: 'PAGE_ERROR',
+};
+export function isBridgeFrame(value, nonce) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const frame = value;
+    if (frame.v !== CROWDY_BRIDGE_PROTOCOL_VERSION || typeof frame.n !== 'string' || typeof frame.t !== 'string')
+        return false;
+    if (frame.from !== 'page' && frame.from !== 'worker')
+        return false;
+    return nonce === undefined || frame.n === nonce;
+}
+//# sourceMappingURL=protocol.js.map

package/lib/bridge/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/bridge/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAA;AAyJxD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW,EAAE,oBAAoB;IACjC,OAAO,EAAE,gBAAgB;IACzB,OAAO,EAAE,gBAAgB;IACzB,SAAS,EAAE,YAAY;CACf,CAAA;AAEV,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,KAAc;IAC1D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,KAAK,GAAG,KAA6B,CAAA;IAC3C,IAAI,KAAK,CAAC,CAAC,KAAK,8BAA8B,IAAI,OAAO,KAAK,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC1H,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAClE,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,KAAK,KAAK,CAAA;AACjD,CAAC"}

package/lib/crowdy/client.js

@@ -0,0 +1,247 @@
+/**
+ * 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 { createCrowdyClient, CrowdyGraphQLError, CrowdyStudioProjectCreateDocument, CrowdyStudioProjectDocument, } from '../vendor/crowdyjs-sdk.js';
+/**
+ * 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 class CrowdyApiError extends Error {
+    code;
+    remediation;
+    constructor(message, code, remediation) {
+        super(message);
+        this.code = code;
+        this.remediation = remediation;
+        this.name = 'CrowdyApiError';
+    }
+    /** True when the write lost an optimistic-concurrency race and must be replayed. */
+    get isRevisionConflict() {
+        return this.code === 'CROWDY_STUDIO_REVISION_CONFLICT' || this.code === 'GITHUB_STALE_SHA';
+    }
+    /** True when the bearer is missing, expired, or not app-scoped. */
+    get isAuthFailure() {
+        return (this.code === 'UNAUTHENTICATED' ||
+            this.code === 'UNAUTHORIZED' ||
+            this.code === 'TOKEN_EXPIRED' ||
+            this.code === 'SCOPE_MISSING');
+    }
+}
+function toProject(dto) {
+    return {
+        projectId: dto.projectId,
+        appId: String(dto.appId),
+        ownerUserId: String(dto.ownerUserId),
+        name: dto.name,
+        revision: String(dto.revision),
+        archived: dto.archived,
+        updatedAt: dto.updatedAt,
+        files: dto.files.map((file) => ({
+            target: file.target,
+            path: file.path,
+            content: file.content,
+            revision: String(file.revision),
+            updatedAt: file.updatedAt,
+        })),
+    };
+}
+/**
+ * Translate CrowdyJS's error into the cockpit's, keeping `extensions.code` and
+ * `extensions.remediation` so the filesystem can map conflicts and denials.
+ */
+function toApiError(error) {
+    if (error instanceof CrowdyApiError)
+        return error;
+    if (error instanceof CrowdyGraphQLError) {
+        const first = error.graphqlErrors[0];
+        const extensions = (first?.extensions ?? {});
+        return new CrowdyApiError(first?.message ?? error.message, typeof extensions.code === 'string' ? extensions.code : undefined, typeof extensions.remediation === 'string' ? extensions.remediation : undefined);
+    }
+    if (error instanceof Error) {
+        return new CrowdyApiError(error.message, 'CROWDY_DSH_TRANSPORT');
+    }
+    return new CrowdyApiError(String(error), 'CROWDY_DSH_TRANSPORT');
+}
+/**
+ * Project-file client. One instance per configured `(endpoint, appId)`; the
+ * bearer is resolved lazily on the first call and held in memory only.
+ */
+export class CrowdyStudioClient {
+    options;
+    sdk;
+    appToken;
+    authenticating;
+    constructor(options) {
+        this.options = options;
+        // The SDK expects an origin; the cockpit is configured with the endpoint.
+        this.sdk = createCrowdyClient({ graphqlEndpoint: options.endpoint });
+        this.appToken = options.appToken;
+        if (this.appToken)
+            this.sdk.setToken(this.appToken);
+    }
+    /** The app id every call is scoped to. */
+    get appId() {
+        return this.options.appId;
+    }
+    /**
+     * 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) {
+        this.appToken = token || undefined;
+        this.sdk.setToken(this.appToken ?? null);
+    }
+    /** GitHub loop of the bound repository; every call carries `(appId, projectId)`. */
+    get github() {
+        return this.sdk.crowdyStudioGitHub;
+    }
+    /** Projects the caller owns in this app. */
+    async listProjects() {
+        await this.authenticate();
+        try {
+            // The SDK scope type also names a grid, but the query is app-wide; the grid
+            // is irrelevant to listing and is passed empty.
+            const projects = await this.sdk.crowdyStudio.listProjects({ appId: this.options.appId, gridId: '' });
+            return projects.map((project) => ({
+                projectId: project.projectId,
+                name: project.name,
+                kind: String(project.kind),
+                updatedAt: project.updatedAt,
+            }));
+        }
+        catch (error) {
+            throw toApiError(error);
+        }
+    }
+    /**
+     * 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`.
+     */
+    async authenticate() {
+        if (this.appToken)
+            return this.appToken;
+        if (this.authenticating)
+            return this.authenticating;
+        const { email, password, appId } = this.options;
+        if (!email || !password) {
+            throw new CrowdyApiError('No appToken supplied and no email/password available to mint one.', 'CROWDY_DSH_NO_CREDENTIALS', 'Set CROWDY_APP_TOKEN, or set CROWDY_EMAIL and CROWDY_PASSWORD.');
+        }
+        this.authenticating = (async () => {
+            try {
+                await this.sdk.auth.login({ email, password });
+                const minted = await this.sdk.portal.mintAppToken(appId);
+                this.appToken = minted.token;
+                this.sdk.setToken(this.appToken);
+                return this.appToken;
+            }
+            catch (error) {
+                throw toApiError(error);
+            }
+            finally {
+                this.authenticating = undefined;
+            }
+        })();
+        return this.authenticating;
+    }
+    /** Load a project and the full text of every file it contains. */
+    async loadProject(projectId) {
+        await this.authenticate();
+        try {
+            const data = await this.sdk.graphql.request(CrowdyStudioProjectDocument, {
+                appId: this.options.appId,
+                projectId,
+            });
+            return toProject(data.crowdyStudioProject);
+        }
+        catch (error) {
+            throw toApiError(error);
+        }
+    }
+    /**
+     * 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.
+     */
+    async saveFiles(args) {
+        await this.authenticate();
+        try {
+            const data = await this.sdk.graphql.query(SAVE_FILES, {
+                input: {
+                    appId: this.options.appId,
+                    projectId: args.projectId,
+                    expectedRevision: args.expectedRevision,
+                    ...(args.upserts?.length ? { upserts: args.upserts } : {}),
+                    ...(args.deletes?.length ? { deletes: args.deletes } : {}),
+                    ...(args.idempotencyKey ? { idempotencyKey: args.idempotencyKey } : {}),
+                },
+            });
+            return toProject(data.crowdyStudioProjectSaveFiles);
+        }
+        catch (error) {
+            throw toApiError(error);
+        }
+    }
+    /** Create a project, used by the setup script to produce a scratch target. */
+    async createProject(args) {
+        await this.authenticate();
+        try {
+            const data = await this.sdk.graphql.request(CrowdyStudioProjectCreateDocument, {
+                input: {
+                    appId: this.options.appId,
+                    name: args.name,
+                    ...(args.description ? { description: args.description } : {}),
+                    ...(args.initialFiles?.length
+                        ? { initialFiles: args.initialFiles.map((f) => ({ ...f, target: f.target })) }
+                        : {}),
+                },
+            });
+            return toProject(data.crowdyStudioProjectCreate);
+        }
+        catch (error) {
+            throw toApiError(error);
+        }
+    }
+}
+const PROJECT_FIELDS = `
+  projectId
+  appId
+  ownerUserId
+  name
+  revision
+  archived
+  updatedAt
+  files {
+    target
+    path
+    content
+    revision
+    updatedAt
+  }
+`;
+/**
+ * The files-only save is not in CrowdyJS's generated document set (Studio's
+ * editor saves whole projects), so it is carried here as a named operation
+ * against the same public schema.
+ */
+const SAVE_FILES = `
+  mutation CrowdyDshSaveFiles($input: SaveCrowdyStudioProjectFilesInput!) {
+    crowdyStudioProjectSaveFiles(input: $input) { ${PROJECT_FIELDS} }
+  }
+`;
+//# sourceMappingURL=client.js.map

package/lib/crowdy/client.js.map

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

package/lib/crowdy/config.js

@@ -0,0 +1,95 @@
+/**
+ * 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
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** File the page-side bridge writes into the worker's `$DSH_HOME`. */
+export const CROWDY_CONFIG_FILENAME = 'crowdy.json';
+const ENV_KEYS = {
+    graphqlUrl: 'CROWDY_GRAPHQL_URL',
+    appId: 'CROWDY_APP_ID',
+    projectId: 'CROWDY_PROJECT_ID',
+    appToken: 'CROWDY_APP_TOKEN',
+    email: 'CROWDY_EMAIL',
+    password: 'CROWDY_PASSWORD',
+    root: 'CROWDY_MOUNT',
+    bridgeChannel: 'CROWDY_BRIDGE_CHANNEL',
+    bridgeNonce: 'CROWDY_BRIDGE_NONCE',
+    githubFirst: 'CROWDY_GITHUB_FIRST',
+    studioOrigin: 'CROWDY_STUDIO_ORIGIN',
+    persistScope: 'CROWDY_PERSIST_SCOPE',
+};
+function readFile(home) {
+    if (!home)
+        return {};
+    try {
+        const text = readFileSync(join(home, CROWDY_CONFIG_FILENAME), 'utf8');
+        const parsed = JSON.parse(text);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 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 function loadCrowdyConfig(overrides = {}) {
+    const env = process.env;
+    const file = readFile(env.DSH_HOME);
+    const pick = (key) => {
+        const fromEnv = env[ENV_KEYS[key]];
+        if (fromEnv !== undefined && fromEnv !== '') {
+            return (key === 'githubFirst' ? fromEnv === '1' || fromEnv === 'true' : fromEnv);
+        }
+        if (overrides[key] !== undefined)
+            return overrides[key];
+        return file[key];
+    };
+    const graphqlUrl = pick('graphqlUrl') ?? 'http://localhost:3000/graphql';
+    const config = {
+        graphqlUrl,
+        appId: pick('appId') ?? '0',
+        projectId: pick('projectId') ?? '',
+        appToken: pick('appToken'),
+        email: pick('email'),
+        password: pick('password'),
+        root: pick('root'),
+        bridgeChannel: pick('bridgeChannel'),
+        bridgeNonce: pick('bridgeNonce'),
+        githubFirst: pick('githubFirst') ?? true,
+        studioOrigin: pick('studioOrigin'),
+        persistScope: pick('persistScope'),
+    };
+    return config;
+}
+/** Human-readable reason the configuration cannot reach a project yet. */
+export function describeMissing(config) {
+    const missing = [];
+    if (!config.appId || config.appId === '0')
+        missing.push('appId');
+    if (!config.projectId)
+        missing.push('projectId');
+    if (!config.appToken && !(config.email && config.password))
+        missing.push('appToken');
+    if (missing.length === 0)
+        return undefined;
+    return `Crowdy Studio is not connected yet (missing ${missing.join(', ')}). Open a project in Crowdy Studio and try again.`;
+}
+//# sourceMappingURL=config.js.map

package/lib/crowdy/config.js.map

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