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

package/lib/fs/scratch-store.js

@@ -0,0 +1,61 @@
+/**
+ * In-memory files beside the project trees: screenshots under `captures/`,
+ * game observations / client logs / diagnostics under `context/`.
+ *
+ * These are not project files and never reach the game API. They exist so the
+ * stock `read` / `read_image` tools can open what the Studio page shared,
+ * through the same paths the model already knows.
+ *
+ * @module @crowdedkingdoms/crowdy-dsh/fs/scratch-store
+ */
+const MAX_FILES_PER_DIR = 40;
+export class ScratchStore {
+    dirs = new Map();
+    counter = 0;
+    putText(dir, name, text) {
+        const bytes = new TextEncoder().encode(text);
+        return this.put(dir, name, bytes, text);
+    }
+    putBytes(dir, name, bytes) {
+        return this.put(dir, name, bytes, undefined);
+    }
+    get(dir, name) {
+        return this.dirs.get(dir)?.get(name);
+    }
+    list(dir) {
+        const files = this.dirs.get(dir);
+        if (!files)
+            return [];
+        return [...files.entries()]
+            .map(([name, file]) => ({ name, file }))
+            .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    }
+    put(dir, name, bytes, text) {
+        let files = this.dirs.get(dir);
+        if (!files) {
+            files = new Map();
+            this.dirs.set(dir, files);
+        }
+        // Keep the bag bounded: drop the oldest entries first.
+        while (files.size >= MAX_FILES_PER_DIR && !files.has(name)) {
+            let oldest;
+            for (const entry of files) {
+                if (!oldest || entry[1].updatedAt < oldest[1].updatedAt)
+                    oldest = entry;
+            }
+            if (!oldest)
+                break;
+            files.delete(oldest[0]);
+        }
+        this.counter += 1;
+        const file = {
+            bytes,
+            version: `scratch:${this.counter}`,
+            updatedAt: Date.now(),
+            ...(text === undefined ? {} : { text }),
+        };
+        files.set(name, file);
+        return file;
+    }
+}
+//# sourceMappingURL=scratch-store.js.map

package/lib/fs/scratch-store.js.map

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

package/lib/index.js

@@ -0,0 +1,15 @@
+/**
+ * Package entry: the Cordis plugin DSH mounts as `ctx.fs`, plus the sibling
+ * plugins a Crowdy composition inserts (search, SDK index, page bridge, tools,
+ * in-memory attachments). Each plugin is also reachable as a subpath export so
+ * a `cordis.patch.yml` row can name it directly.
+ *
+ * @module @crowdedkingdoms/crowdy-dsh
+ */
+export { CrowdyFileSystem, default, versionOf } from './fs/crowdy-file-system.js';
+export { ScratchStore } from './fs/scratch-store.js';
+export { CrowdyApiError, CrowdyStudioClient } from './crowdy/client.js';
+export { loadCrowdyConfig, describeMissing, CROWDY_CONFIG_FILENAME } from './crowdy/config.js';
+export { GitHubProjectStore, StudioProjectStore, selectProjectStore, isSourcePath, } from './crowdy/project-store.js';
+export { CrowdyAttachmentStore, imageDimensions } from './attachments/crowdy-attachment-store.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAQvE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAE9F,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,2BAA2B,CAAA;AAGlC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA"}

package/lib/persist/index.js

@@ -0,0 +1,199 @@
+/**
+ * Session persistence for the browser worker: mirror the harness home's
+ * durable state (session logs, projection caches, user settings) from the
+ * in-memory VFS into the origin-private file system, so a reload or a later
+ * visit restores the player's sessions.
+ *
+ * The page half (`web/crowdy-boot.ts`) reads the same OPFS directory before the
+ * worker boots and feeds it back as a pre-boot overlay, so nothing here needs
+ * to run before the tree is up. In Node (the developer cockpit) OPFS does not
+ * exist and the plugin is inert: the real disk already persists `$DSH_HOME`.
+ *
+ * @module @crowdedkingdoms/crowdy-dsh/persist
+ */
+import z from '@deepseek-ai/schemastery';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+/** Cordis plugin name used by loader diagnostics. */
+export const name = 'crowdy-persist';
+export const Config = z.object({
+    scope: z.string(),
+    intervalMs: z.number().default(3_000),
+    maxBytes: z.number().default(48 * 1024 * 1024),
+});
+/** Home-relative trees worth keeping across reloads. */
+export const PERSISTED_HOME_TREES = ['sessions', 'storages'];
+/** Home-relative single files worth keeping across reloads. */
+export const PERSISTED_HOME_FILES = ['settings.yaml'];
+/** Root directory name inside OPFS; scopes hang under it. */
+export const OPFS_ROOT = 'crowdy-dsh';
+function opfsRoot() {
+    const storage = globalThis.navigator?.storage;
+    if (!storage || typeof storage.getDirectory !== 'function')
+        return undefined;
+    return storage.getDirectory();
+}
+async function ensureDirectory(root, segments) {
+    let current = root;
+    for (const segment of segments)
+        current = await current.getDirectoryHandle(segment, { create: true });
+    return current;
+}
+/** Resolve the scope from row config, then `crowdy.json`, then a fixed default. */
+export function resolveScope(config, home) {
+    if (config.scope)
+        return config.scope;
+    if (home) {
+        try {
+            const parsed = JSON.parse(readFileSync(join(home, 'crowdy.json'), 'utf8'));
+            if (typeof parsed.persistScope === 'string' && parsed.persistScope)
+                return parsed.persistScope;
+        }
+        catch {
+            // No page config: fall through to the default scope.
+        }
+    }
+    return 'default';
+}
+function listFiles(root, directory, out) {
+    let entries;
+    try {
+        entries = readdirSync(directory);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const path = join(directory, entry);
+        let info;
+        try {
+            info = statSync(path);
+        }
+        catch {
+            continue;
+        }
+        if (info.isDirectory())
+            listFiles(root, path, out);
+        else if (info.isFile())
+            out.set(relative(root, path), { mtime: info.mtimeMs, size: info.size });
+    }
+}
+/** Snapshot of every persisted file under the home, keyed by home-relative path. */
+export function snapshotHome(home) {
+    const out = new Map();
+    for (const tree of PERSISTED_HOME_TREES)
+        listFiles(home, join(home, tree), out);
+    for (const file of PERSISTED_HOME_FILES) {
+        try {
+            const info = statSync(join(home, file));
+            if (info.isFile())
+                out.set(file, { mtime: info.mtimeMs, size: info.size });
+        }
+        catch {
+            // absent
+        }
+    }
+    return out;
+}
+export class HomeMirror {
+    home;
+    scopeDir;
+    maxBytes;
+    warn;
+    seen = new Map();
+    running = false;
+    constructor(home, scopeDir, maxBytes, warn) {
+        this.home = home;
+        this.scopeDir = scopeDir;
+        this.maxBytes = maxBytes;
+        this.warn = warn;
+    }
+    /** Copy every file whose mtime moved since the last sweep. */
+    async sweep() {
+        if (this.running)
+            return 0;
+        this.running = true;
+        try {
+            const snapshot = snapshotHome(this.home);
+            const scope = await this.scopeDir;
+            let copied = 0;
+            let total = 0;
+            for (const [path, info] of snapshot) {
+                total += info.size;
+                if (this.seen.get(path) === info.mtime)
+                    continue;
+                const bytes = readFileSync(join(this.home, path));
+                const segments = path.split('/');
+                const leaf = segments.pop();
+                const directory = await ensureDirectory(scope, segments);
+                const handle = await directory.getFileHandle(leaf, { create: true });
+                const writable = await handle.createWritable();
+                await writable.write(new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength));
+                await writable.close();
+                this.seen.set(path, info.mtime);
+                copied += 1;
+            }
+            if (total > this.maxBytes)
+                await this.trim(snapshot, total);
+            return copied;
+        }
+        catch (error) {
+            this.warn(`session mirror sweep failed: ${error instanceof Error ? error.message : String(error)}`);
+            return 0;
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    /** Drop the oldest session directories from the mirror until under budget. */
+    async trim(snapshot, total) {
+        const sessions = new Map();
+        for (const [path, info] of snapshot) {
+            if (!path.startsWith('sessions/'))
+                continue;
+            const key = path.split('/').slice(0, 3).join('/');
+            const current = sessions.get(key) ?? { mtime: 0, size: 0 };
+            sessions.set(key, { mtime: Math.max(current.mtime, info.mtime), size: current.size + info.size });
+        }
+        const oldestFirst = [...sessions.entries()].sort((a, b) => a[1].mtime - b[1].mtime);
+        const scope = await this.scopeDir;
+        for (const [key, info] of oldestFirst) {
+            if (total <= this.maxBytes)
+                break;
+            const segments = key.split('/');
+            const leaf = segments.pop();
+            try {
+                const directory = await ensureDirectory(scope, segments);
+                await directory.removeEntry(leaf, { recursive: true });
+                total -= info.size;
+                for (const path of [...this.seen.keys()])
+                    if (path.startsWith(`${key}/`))
+                        this.seen.delete(path);
+            }
+            catch (error) {
+                this.warn(`session mirror trim failed for ${key}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+}
+export function apply(ctx, config = {}) {
+    const root = opfsRoot();
+    const home = process.env.DSH_HOME;
+    if (!root || !home) {
+        // Node cockpit or a browser without OPFS: the disk (or nothing) persists.
+        return;
+    }
+    const scope = resolveScope(config, home);
+    const scopeDir = root.then((directory) => ensureDirectory(directory, [OPFS_ROOT, ...scope.split('/').filter(Boolean)]));
+    const mirror = new HomeMirror(home, scopeDir, config.maxBytes ?? 48 * 1024 * 1024, (message) => {
+        console.warn(`crowdy-persist: ${message}`);
+    });
+    const interval = setInterval(() => {
+        void mirror.sweep();
+    }, config.intervalMs ?? 3_000);
+    ctx.effect(() => () => {
+        clearInterval(interval);
+    }, 'crowdy session mirror');
+    void mirror.sweep();
+}
+//# sourceMappingURL=index.js.map

package/lib/persist/index.js.map

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

package/lib/scripts/probe.js

@@ -0,0 +1,59 @@
+/**
+ * Connectivity probe: proves the cockpit's credentials and project id reach a
+ * real Crowdy Studio project before the harness is booted against it.
+ *
+ * With `--write` it also performs a guarded round-trip write, which is the
+ * end-to-end check that the agent's edits will actually land.
+ */
+import { CrowdyStudioClient } from '../crowdy/client.js';
+import { describeMissing, loadCrowdyConfig } from '../crowdy/config.js';
+import { selectProjectStore } from '../crowdy/project-store.js';
+async function main() {
+    const boot = loadCrowdyConfig();
+    const missing = describeMissing(boot);
+    if (missing) {
+        console.error(`${missing} See .env.example.`);
+        process.exit(1);
+    }
+    const client = new CrowdyStudioClient({
+        endpoint: boot.graphqlUrl,
+        appId: boot.appId,
+        appToken: boot.appToken,
+        email: boot.email,
+        password: boot.password,
+    });
+    const projectId = boot.projectId;
+    const selection = await selectProjectStore(client, projectId, {
+        githubFirst: boot.githubFirst ?? true,
+        warn: (message) => console.warn(`  warn: ${message}`),
+    });
+    console.log(`store: ${selection.store.kind} — ${selection.reason}`);
+    const snapshot = await selection.store.load();
+    console.log(`  ${snapshot.label}: ${snapshot.files.length} file(s)`);
+    const project = await client.loadProject(projectId);
+    console.log(`project ${project.name} (${project.projectId})`);
+    console.log(`  revision ${project.revision}, ${project.files.length} file(s)`);
+    for (const file of project.files) {
+        console.log(`  ${file.target.toLowerCase().padEnd(6)} ${file.path.padEnd(28)} ` +
+            `${Buffer.byteLength(file.content, 'utf8')} bytes  rev ${file.revision}`);
+    }
+    if (!process.argv.includes('--write'))
+        return;
+    // Round-trip a marker through the same mutation the filesystem backend uses.
+    const path = 'src/cockpit_probe.rs';
+    const content = `// cockpit probe ${new Date().toISOString()}\n`;
+    const updated = await client.saveFiles({
+        projectId,
+        expectedRevision: project.revision,
+        upserts: [{ target: 'SERVER', path, content }],
+    });
+    console.log(`\nwrote server/${path}; revision ${project.revision} -> ${updated.revision}`);
+    const reverted = await client.saveFiles({
+        projectId,
+        expectedRevision: updated.revision,
+        deletes: [{ target: 'SERVER', path }],
+    });
+    console.log(`removed the probe file; revision ${updated.revision} -> ${reverted.revision}`);
+}
+await main();
+//# sourceMappingURL=probe.js.map

package/lib/scripts/probe.js.map

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

package/lib/sdk-index/catalog.js

@@ -0,0 +1,237 @@
+/**
+ * Closed-world `crowdy-compute-sdk` catalog: lookup, aliases, and the
+ * system-prompt section the agent reads instead of guessing names.
+ */
+import { qualifiedName } from './parse-sdk.js';
+/**
+ * Invented names the agent has already reached for. Values are catalog
+ * function names (unqualified). Keep this list curated; the parser cannot
+ * know what the model will hallucinate.
+ */
+export const SDK_ALIASES = {
+    emit: ['emit_event', 'emit_channel', 'emit_spatial'],
+    spawn: ['voxel_set'],
+    'crowdy::spawn': ['voxel_set'],
+    host_place_block: ['voxel_set'],
+    place_block: ['voxel_set'],
+    set_block: ['voxel_set'],
+};
+const FORBIDDEN_CRATES = ['glam'];
+/** Harness tool, not a WASM host function. Looking it up in the SDK is the miss. */
+export const GAME_CONTEXT_LOOKUP_NOTE = 'game_context is the Harness tool, not a crowdy::api function and not a host_call name. ' +
+    'Call the `game_context` tool to read the live current chunk and block catalog. ' +
+    'Place blocks with crowdy::api::voxel_set using that chunk (SERVER only). ' +
+    'A disco ball is SERVER voxel_set of dirt/sand/stone in a sphere near the TOP of the claimed chunk; shine and mock rays are CLIENT mesh_asset_spawn disco_rig, not wool/gold. ' +
+    'Do not write crowdy::host_call("game_context") or crowdy::api::game_context.';
+export const PLUGIN_HOST_LOOKUP_NOTE = 'Disco look and held meshes are CLIENT host_call, not crowdy::api. ' +
+    'Appearance: crowdy::host_call("grid_skin_set", json!({ "remap": { "1": { "all": "mod_slot_00" }, "2": { "all": "mod_slot_00", "emission": 10 }, "3": { "all": "mod_slot_00" }, "6": { "all": "mod_slot_00", "emission": 8 } }, "paint": [{ "slot": 0, "fill": "#1a1a1a", "speckle": "#ffe066", "speckleCount": 28, "seed": 0 }] })). ' +
+    'Shimmer: CLIENT on_tick re-calls grid_skin_set with the same remap and a cycling paint.seed (and fill/speckle). Keep emission stable. ' +
+    'A disco ball in the sky is SERVER crowdy::api::voxel_set of dirt/sand/stone (ids 2,6,3) radius-3 near local y 12–14 of the current claimed chunk. Keep the floor. Do not voxel_set wool/gold. ' +
+    'Shine + mock rays: CLIENT mesh_asset_register { id:"disco", kind:"primitive", primitive:{ shape:"disco_rig" } } then mesh_asset_spawn { id:"disco", pose:{ x, y, z, yaw } } at the ball. on_tick re-spawns the same id with cycling pose.yaw. Not ray-traced lights and not voxel_set columns. Keep grid_skin_set shimmer on the floor. ' +
+    'Uploaded glTF: call Harness tool mesh_artifacts, then CLIENT mesh_asset_register { id, kind:"gltf", artifactHash } and mesh_asset_spawn. Never embed bytes. ' +
+    'Bow: crowdy::host_call("mesh_asset_register", json!({ "id": "bow", "kind": "primitive", "primitive": { "shape": "bow_placeholder" } })) then mesh_asset_attach { "id": "bow", "anchor": "hand" }. ' +
+    'CLIENT cannot voxel_set in Blocks with Friends.';
+const PLUGIN_HOST_LOOKUPS = new Set([
+    'grid_skin_set',
+    'grid_skin_clear',
+    'mesh_asset_register',
+    'mesh_asset_attach',
+    'mesh_asset_spawn',
+    'mesh_asset_clear',
+    'mechanics_emit',
+    'disco',
+    'disco_skin',
+    'disco_ball',
+    'disco_ray',
+    'disco_rig',
+    'rays',
+    'shimmer',
+    'restyle',
+    'skin',
+    'gltf',
+    'artifactHash',
+    'mesh_artifacts',
+    'bow',
+    'bow_placeholder',
+]);
+export function isPluginHostLookup(raw, query = '') {
+    const normalized = query || raw;
+    if (PLUGIN_HOST_LOOKUPS.has(normalized))
+        return true;
+    return /host_call\s*\(\s*["'](?:grid_skin_set|mesh_asset_register|mesh_asset_attach|mesh_asset_spawn|mechanics_emit)["']/i.test(raw);
+}
+export function isHarnessGameContextLookup(raw, query = '') {
+    const normalized = query || raw;
+    if (normalized === 'game_context')
+        return true;
+    return /host_call\s*\(\s*["']game_context["']/i.test(raw);
+}
+function normalizeQuery(raw) {
+    return raw
+        .trim()
+        .replace(/^:+/u, '')
+        .replace(/^(?:crowdy::api::|crowdy::)/u, '')
+        .replace(/\(.*$/u, '')
+        .trim();
+}
+function byName(catalog, name) {
+    return catalog.find((entry) => entry.name === name);
+}
+/** Dice coefficient on character bigrams — enough for `emit` vs `emit_event`. */
+export function nameSimilarity(a, b) {
+    if (a === b)
+        return 1;
+    if (a.length < 2 || b.length < 2)
+        return a.includes(b) || b.includes(a) ? 0.4 : 0;
+    const grams = (value) => {
+        const out = [];
+        for (let i = 0; i < value.length - 1; i += 1)
+            out.push(value.slice(i, i + 2));
+        return out;
+    };
+    const left = grams(a);
+    const right = new Map();
+    for (const g of grams(b))
+        right.set(g, (right.get(g) ?? 0) + 1);
+    let hits = 0;
+    for (const g of left) {
+        const n = right.get(g) ?? 0;
+        if (n > 0) {
+            hits += 1;
+            right.set(g, n - 1);
+        }
+    }
+    return (2 * hits) / (left.length + grams(b).length);
+}
+export function nearestEntries(catalog, query, limit = 3) {
+    return [...catalog]
+        .map((entry) => ({ entry, score: nameSimilarity(query, entry.name) }))
+        .filter((row) => row.score > 0)
+        .sort((a, b) => b.score - a.score || a.entry.name.localeCompare(b.entry.name))
+        .slice(0, limit)
+        .map((row) => row.entry);
+}
+/**
+ * Resolve a rustc / agent name against the catalog. Exact hits win;
+ * then curated aliases; then nearest real names. Never invents a function.
+ */
+export function lookupSdkName(catalog, raw) {
+    const query = normalizeQuery(raw);
+    if (!query) {
+        return {
+            found: false,
+            query: raw,
+            nearest: [],
+            note: 'empty name — pass the identifier rustc could not find',
+        };
+    }
+    if (FORBIDDEN_CRATES.includes(query)) {
+        return {
+            found: false,
+            query,
+            nearest: [],
+            note: 'glam is forbidden in Crowdy Studio crates. Do not add it to Cargo.toml. ' +
+                'Use only functions in this catalog.',
+        };
+    }
+    if (isHarnessGameContextLookup(raw, query)) {
+        const voxel = byName(catalog, 'voxel_set');
+        return {
+            found: false,
+            query,
+            nearest: voxel ? [voxel] : [],
+            note: GAME_CONTEXT_LOOKUP_NOTE,
+        };
+    }
+    if (isPluginHostLookup(raw, query)) {
+        return {
+            found: false,
+            query,
+            nearest: [],
+            note: PLUGIN_HOST_LOOKUP_NOTE,
+        };
+    }
+    const exact = byName(catalog, query);
+    if (exact) {
+        return {
+            found: true,
+            query,
+            match: exact,
+            nearest: [],
+            note: `${qualifiedName(exact)} is in the catalog.`,
+        };
+    }
+    const aliasTargets = SDK_ALIASES[query] ?? SDK_ALIASES[raw.trim()];
+    if (aliasTargets) {
+        const mapped = aliasTargets
+            .map((name) => byName(catalog, name))
+            .filter((entry) => entry !== undefined);
+        return {
+            found: false,
+            query,
+            viaAlias: query,
+            nearest: mapped,
+            note: `${query} is not a crowdy-compute-sdk function. Use ` +
+                `${mapped.map(qualifiedName).join(' / ') || 'a listed function'} instead.`,
+        };
+    }
+    const nearest = nearestEntries(catalog, query);
+    return {
+        found: false,
+        query,
+        nearest,
+        note: `${query} is not in the catalog. Do not invent crowdy::api::${query}. ` +
+            (nearest.length > 0
+                ? `Nearest real functions: ${nearest.map(qualifiedName).join(', ')}.`
+                : 'Remove the call and leave a TODO if no listed function matches.'),
+    };
+}
+export function formatLookup(hit) {
+    const lines = [hit.note];
+    const show = hit.match ? [hit.match] : hit.nearest;
+    for (const entry of show) {
+        lines.push('');
+        lines.push(qualifiedName(entry));
+        lines.push(`  ${entry.signature}`);
+        if (entry.doc)
+            lines.push(`  ${entry.doc}`);
+    }
+    return lines.join('\n');
+}
+const RULES = [
+    'Closed-world SDK. Only the functions below exist on `crowdy` / `crowdy::api`.',
+    'Do not invent names (`crowdy::api::emit`, `crowdy::spawn`, `host_place_block`).',
+    'If rustc says cannot find function X, call `sdk_lookup` with X before editing.',
+    'If no listed function matches the intent, remove the call and leave a TODO — do not guess.',
+    'Do not add crates. glam is forbidden. Cargo.toml may only declare allowlisted crates (crowdy-compute-sdk, game-kit-*, serde, serde_json, rand).',
+    'World block writes: crowdy::api::voxel_set((cx,cy,cz), (vx,vy,vz), block_i32, None) on SERVER only. Always match the Result (`out_of_grid`, `permission_denied`, `bad_args`); never `let _ = voxel_set(...)`. CLIENT cannot voxel_set in Blocks with Friends.',
+    'Call the Harness tool `game_context` (not a WASM API, not host_call) before writing. Stay inside grid bounds.',
+    'Claimed-grid disco look is CLIENT crowdy::host_call("grid_skin_set", json!({ "remap": { "1": { "all": "mod_slot_00" }, "2": { "all": "mod_slot_00", "emission": 10 }, "3": { "all": "mod_slot_00" }, "6": { "all": "mod_slot_00", "emission": 8 } }, "paint": [{ "slot": 0, "fill": "#1a1a1a", "speckle": "#ffe066", "speckleCount": 28, "seed": 0 }] })). Do not SERVER voxel_set wool, gold, or glowstone as a skin. A disco ball in the sky is SERVER voxel_set of dirt/sand/stone (ids 2,6,3) radius-3 near the TOP of the current claimed chunk (local y 12–14), keep the floor — the CLIENT skin restyles those blocks. CLIENT on_tick may re-call grid_skin_set with cycling paint.seed for shimmer; keep remap/emission stable.',
+    'Disco shine + mock rays: CLIENT mesh_asset_register primitive disco_rig then mesh_asset_spawn at the ball with pose.yaw. on_tick re-spawns the same id with cycling yaw so beams spin. Not ray-traced lights. Not voxel_set columns.',
+    'Placeholder bow is CLIENT host_call mesh_asset_register primitive bow_placeholder then mesh_asset_attach anchor hand. Not a mini-block. Not voxel_set.',
+    'Uploaded glTF meshes: call Harness tool mesh_artifacts, then CLIENT mesh_asset_register kind gltf with artifactHash from that list, then mesh_asset_spawn. Never embed GLB bytes in host_call or Studio files.',
+    'Studio Invoke payload is UTF-8 JSON `{export, params, callerUserId, gridId}`. Parse `params` (chunk / chunk_x/y/z). Never treat the first 24 bytes as coordinates.',
+    'emit_spatial uuid_hex must be exactly 64 hex characters. emit_event is denied for player modules — use emit_spatial or emit_channel.',
+].join(' ');
+/** System-prompt section: rules plus the full function index. */
+export function formatSdkPrompt(catalog) {
+    const crate = catalog.filter((e) => e.module === 'crate');
+    const api = catalog.filter((e) => e.module === 'api');
+    const block = (title, rows) => {
+        const body = rows
+            .map((entry) => {
+            const doc = entry.doc ? ` — ${entry.doc}` : '';
+            return `- ${qualifiedName(entry)} :: ${entry.signature}${doc}`;
+        })
+            .join('\n');
+        return `${title}\n${body}`;
+    };
+    return [
+        RULES,
+        '',
+        block('Crate-root helpers (`use crowdy_compute_sdk as crowdy`):', crate),
+        '',
+        block('Host API (`crowdy::api::*`):', api),
+    ].join('\n');
+}
+//# sourceMappingURL=catalog.js.map

package/lib/sdk-index/catalog.js.map

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

package/lib/sdk-index/index.js

@@ -0,0 +1,10 @@
+/**
+ * Closed-world crowdy-compute-sdk index plugin.
+ *
+ * @module @crowdy/dsh-cockpit/sdk-index
+ */
+export { apply, Config, inject, name } from './plugin.js';
+export { formatLookup, formatSdkPrompt, GAME_CONTEXT_LOOKUP_NOTE, isHarnessGameContextLookup, lookupSdkName, nearestEntries, nameSimilarity, SDK_ALIASES, } from './catalog.js';
+export { parseCrowdyComputeSdk, qualifiedName } from './parse-sdk.js';
+export { SDK_SNAPSHOT, SDK_SNAPSHOT_VERSION } from './snapshot.js';
+//# sourceMappingURL=index.js.map

package/lib/sdk-index/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk-index/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEzD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAErE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA"}