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

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-store.d.ts","sourceRoot":"","sources":["../../../src/crowdy/project-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAkB,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAA;AAStG,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC3B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAClC,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,CAAA;IAChC;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACjF;AAED,iEAAiE;AACjE,qBAAa,kBAAmB,YAAW,YAAY;IAInD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;gBAGd,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM;IAG9B,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAUhC,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;CAavF;AAOD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IAQnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVvB,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IACjC,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,MAAM,CAA0B;IACxC,+EAA+E;IAC/E,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;gBAGd,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAsB;IAGpE,OAAO,KAAK,KAAK,GAEhB;IAEK,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAsDhC,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAkDtF,2EAA2E;YAC7D,cAAc;CAe7B;AAaD,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,CAAA;IACnB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAClE,OAAO,CAAC,cAAc,CAAC,CAqBzB"}

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

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

package/lib/types/fs/crowdy-file-system.d.ts

@@ -0,0 +1,173 @@
+/**
+ * A DeepSeek Harness `ctx.fs` backend whose execution world is a Crowdy Studio
+ * project instead of a disk.
+ *
+ * The harness expects a filesystem; Crowdy Studio offers a small versioned bag
+ * of files behind a GraphQL API (or, for a GitHub-bound project, the bound
+ * repository). This class bridges the two:
+ *
+ *   - identity  — a target key is the virtual absolute path, which is stable
+ *                 because Crowdy paths never alias (no symlinks, no hardlinks).
+ *   - freshness — `FsVersion` is a content hash, so a version changes exactly
+ *                 when the bytes change.
+ *   - atomicity — every mutation is one store commit guarded by the revision it
+ *                 read, and a lost race surfaces as `FS_STALE_VERSION` rather
+ *                 than a silent overwrite.
+ *
+ * Beside the two project trees the mount carries in-memory scratch directories
+ * (`captures/`, `context/`) the Studio page fills over the bridge; see
+ * {@link ScratchStore}.
+ *
+ * @module @crowdedkingdoms/crowdy-dsh/fs
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { FileSystem, FsVersion } from '@deepseek-ai/dsh-fs';
+import type { FsDirEntry, FsEditOutcome, FsEditRequest, FsInfo, FsPathInfo, FsTarget, FsWriteIntent, FsWriteOutcome } from '@deepseek-ai/dsh-fs';
+import { CrowdyStudioClient } from '../crowdy/client.js';
+import type { CrowdyTarget } from '../crowdy/client.js';
+import { type CrowdyBootConfig } from '../crowdy/config.js';
+import { type ProjectSnapshot } from '../crowdy/project-store.js';
+import { ScratchStore } from './scratch-store.js';
+export type Config = Partial<CrowdyBootConfig> & {
+    /** How long a project snapshot may be reused for reads, in milliseconds. */
+    snapshotTtlMs?: number;
+    /** How often the GitHub/Studio store choice is re-evaluated, in milliseconds. */
+    storeTtlMs?: number;
+};
+/**
+ * Content-addressed freshness token. FNV-1a over UTF-16 code units: no
+ * `node:crypto` (absent in the browser worker), synchronous, and collisions
+ * only ever cost one spurious re-read of a small Rust file.
+ */
+export declare function versionOf(content: string): FsVersion;
+/**
+ * The model route resolves its bearer through `apiKeyEnv: CROWDY_APP_TOKEN`.
+ * The credentials provider reads the process environment on every request and
+ * the browser worker never sees a `.env` file (the launcher that reads those is
+ * absent there), so the token is published to `process.env` directly. In the
+ * cockpit the variable is already set by the operator and this is a no-op.
+ */
+export declare const APP_TOKEN_ENV = "CROWDY_APP_TOKEN";
+export declare class CrowdyFileSystem extends FileSystem {
+    static Config: z<Config>;
+    /** Effective boot configuration (file + environment + row config). */
+    boot: CrowdyBootConfig;
+    /** API client; replaceable in tests, mirroring the local backend's `internals` hook. */
+    client: CrowdyStudioClient;
+    /** In-memory scratch files the page and tools share. */
+    readonly scratch: ScratchStore;
+    private readonly root;
+    private readonly snapshotTtl;
+    private readonly storeTtl;
+    /** Cached project snapshot; reads may reuse it briefly, mutations never do. */
+    private snapshot;
+    private inflight;
+    private store;
+    private storeInflight;
+    /** Per-path tail promise serializing each read-guard-write critical section. */
+    private readonly locks;
+    /** Listeners told when the project files changed through this backend. */
+    private readonly changeListeners;
+    private readonly warnings;
+    private readonly warningListeners;
+    /** Resolved (and replaced) each time a bearer arrives over the bridge. */
+    private tokenWaiters;
+    constructor(ctx: Context, config?: Config);
+    /** Virtual root the project is mounted at. */
+    get mountRoot(): string;
+    /** Human-readable description of where files currently come from. */
+    get storeReason(): string | undefined;
+    /** Point the backend at another project (the page switched projects). */
+    setProject(projectId: string): void;
+    /** Replace the bearer after the page refreshed the app token. */
+    setToken(token: string | undefined): void;
+    /** Whether a bearer (or cockpit credentials) is available right now. */
+    get hasCredentials(): boolean;
+    /**
+     * In the browser the token follows the boot over the bridge rather than
+     * riding in `crowdy.json`, so the first project load may run a beat ahead of
+     * it. Wait briefly for it instead of failing the model's first tool call.
+     */
+    private waitForCredentials;
+    /** Subscribe to warnings (store fallbacks, failed mirrors) as they happen. */
+    onWarning(listener: (message: string) => void): () => void;
+    private warn;
+    /** Subscribe to writes made through this backend. */
+    onChange(listener: (change: {
+        target: CrowdyTarget;
+        path: string;
+    }) => void): () => void;
+    /** Drop any cached snapshot so the next read refetches (the page saved). */
+    invalidate(): void;
+    /** Warnings accumulated since the last drain (mirror failures, fallbacks). */
+    drainWarnings(): string[];
+    resolve(path: string, opts?: {
+        cwd?: string;
+        signal?: AbortSignal;
+    }): Promise<FsTarget>;
+    /**
+     * Pick the base for relative paths. A session's cwd comes from the host
+     * workspace and may point anywhere; resolving against a directory outside
+     * the mount would make every relative path a miss, so a foreign cwd falls
+     * back to the project root.
+     */
+    private baseFor;
+    processPath(target: FsTarget): string;
+    fileUrl(target: FsTarget): string;
+    contains(parent: FsTarget, child: FsTarget): boolean;
+    stat(target: FsTarget, signal?: AbortSignal): Promise<FsInfo | undefined>;
+    lstat(path: string, opts?: {
+        cwd?: string;
+    }, signal?: AbortSignal): Promise<FsPathInfo | undefined>;
+    readText(target: FsTarget, signal?: AbortSignal): Promise<string>;
+    streamText(target: FsTarget, signal?: AbortSignal): Promise<AsyncIterable<string>>;
+    readBytes(target: FsTarget, signal: AbortSignal | undefined, maxBytes: number): Promise<Uint8Array>;
+    readByteRange(target: FsTarget, range: {
+        offset: number;
+        length: number;
+    }, signal?: AbortSignal): Promise<Uint8Array>;
+    private bytesOf;
+    listDir(target: FsTarget, signal?: AbortSignal): Promise<FsDirEntry[]>;
+    writeText(target: FsTarget, content: string, expected?: FsWriteIntent, signal?: AbortSignal): Promise<FsWriteOutcome>;
+    editText(target: FsTarget, edit: FsEditRequest, expected?: {
+        version: FsVersion;
+    }, signal?: AbortSignal): Promise<FsEditOutcome>;
+    /**
+     * Apply a batch under the snapshot's revision, translating a lost optimistic
+     * race into the harness's stale-version vocabulary so the tool layer can tell
+     * the model to re-read rather than reporting an opaque server error.
+     */
+    private commit;
+    /**
+     * One coherent view of every project file for the search tools: the virtual
+     * mount root plus each file's virtual absolute path and content. Reuses the
+     * same snapshot as reads, so glob/grep and read describe the same tree.
+     */
+    searchSnapshot(): Promise<{
+        root: string;
+        files: Array<{
+            virtualPath: string;
+            content: string;
+        }>;
+    }>;
+    /** The current project snapshot, for tools that want the whole tree. */
+    currentProject(): Promise<ProjectSnapshot>;
+    /** Fetch the project, collapsing bursts and deduping concurrent fetches. */
+    private project;
+    /** Decide (and periodically re-decide) whether GitHub or Studio holds the files. */
+    private currentStore;
+    private find;
+    private requireFile;
+    /**
+     * Reject a write that Crowdy Studio would refuse anyway, so the model gets a
+     * precise reason instead of a generic server validation failure.
+     */
+    private requireWritableLocation;
+    private absolute;
+    private assertLive;
+    /** Serialize mutations per path so a read-guard-write window cannot interleave. */
+    private withLock;
+}
+export default CrowdyFileSystem;
+//# sourceMappingURL=crowdy-file-system.d.ts.map

package/lib/types/fs/crowdy-file-system.d.ts.map

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

package/lib/types/fs/crowdy-file-system.test.d.ts.map

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

package/lib/types/fs/scratch-store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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
+ */
+import type { ScratchDir } from '../crowdy/paths.js';
+export interface ScratchFile {
+    bytes: Uint8Array;
+    /** Decoded text when the file is UTF-8 text; absent for binary content. */
+    text?: string;
+    version: string;
+    updatedAt: number;
+}
+export declare class ScratchStore {
+    private readonly dirs;
+    private counter;
+    putText(dir: ScratchDir, name: string, text: string): ScratchFile;
+    putBytes(dir: ScratchDir, name: string, bytes: Uint8Array): ScratchFile;
+    get(dir: ScratchDir, name: string): ScratchFile | undefined;
+    list(dir: ScratchDir): Array<{
+        name: string;
+        file: ScratchFile;
+    }>;
+    private put;
+}
+//# sourceMappingURL=scratch-store.d.ts.map

package/lib/types/fs/scratch-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratch-store.d.ts","sourceRoot":"","sources":["../../../src/fs/scratch-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAA;IACjB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkD;IACvE,OAAO,CAAC,OAAO,CAAI;IAEnB,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAKjE,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,WAAW;IAIvE,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI3D,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAQjE,OAAO,CAAC,GAAG;CAyBZ"}

package/lib/types/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 type { Config } from './fs/crowdy-file-system.js';
+export { ScratchStore } from './fs/scratch-store.js';
+export { CrowdyApiError, CrowdyStudioClient } from './crowdy/client.js';
+export type { CrowdyFileDelete, CrowdyFileUpsert, CrowdyProject, CrowdyProjectFile, CrowdyTarget, } from './crowdy/client.js';
+export { loadCrowdyConfig, describeMissing, CROWDY_CONFIG_FILENAME } from './crowdy/config.js';
+export type { CrowdyBootConfig } from './crowdy/config.js';
+export { GitHubProjectStore, StudioProjectStore, selectProjectStore, isSourcePath, } from './crowdy/project-store.js';
+export type { ProjectSnapshot, ProjectStore } from './crowdy/project-store.js';
+export { CrowdyAttachmentStore, imageDimensions } from './attachments/crowdy-attachment-store.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACjF,YAAY,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvE,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC9F,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,2BAA2B,CAAA;AAClC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE9E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA"}

package/lib/types/persist/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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 type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export interface Config {
+    /**
+     * OPFS directory that holds this harness's mirror. The page derives it from
+     * the app and player so two players on one browser never share sessions.
+     * Also readable from `$DSH_HOME/crowdy.json` as `persistScope`.
+     */
+    scope?: string;
+    /** Sweep interval in milliseconds. */
+    intervalMs?: number;
+    /** Total bytes kept in the mirror; the oldest session directories go first. */
+    maxBytes?: number;
+}
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "crowdy-persist";
+export declare const Config: z<Config>;
+/** Home-relative trees worth keeping across reloads. */
+export declare const PERSISTED_HOME_TREES: readonly ["sessions", "storages"];
+/** Home-relative single files worth keeping across reloads. */
+export declare const PERSISTED_HOME_FILES: readonly ["settings.yaml"];
+/** Root directory name inside OPFS; scopes hang under it. */
+export declare const OPFS_ROOT = "crowdy-dsh";
+interface OpfsDirectory {
+    getDirectoryHandle(name: string, options?: {
+        create?: boolean;
+    }): Promise<OpfsDirectory>;
+    getFileHandle(name: string, options?: {
+        create?: boolean;
+    }): Promise<OpfsFile>;
+    removeEntry(name: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    entries?(): AsyncIterableIterator<[string, OpfsDirectory | OpfsFile]>;
+    keys?(): AsyncIterableIterator<string>;
+    kind: 'directory';
+}
+interface OpfsFile {
+    kind: 'file';
+    createWritable(): Promise<{
+        write(data: Uint8Array): Promise<void>;
+        close(): Promise<void>;
+    }>;
+    getFile(): Promise<{
+        size: number;
+        arrayBuffer(): Promise<ArrayBuffer>;
+        lastModified: number;
+    }>;
+}
+/** Resolve the scope from row config, then `crowdy.json`, then a fixed default. */
+export declare function resolveScope(config: Config, home: string | undefined): string;
+/** Snapshot of every persisted file under the home, keyed by home-relative path. */
+export declare function snapshotHome(home: string): Map<string, {
+    mtime: number;
+    size: number;
+}>;
+export declare class HomeMirror {
+    private readonly home;
+    private readonly scopeDir;
+    private readonly maxBytes;
+    private readonly warn;
+    private readonly seen;
+    private running;
+    constructor(home: string, scopeDir: Promise<OpfsDirectory>, maxBytes: number, warn: (message: string) => void);
+    /** Copy every file whose mtime moved since the last sweep. */
+    sweep(): Promise<number>;
+    /** Drop the oldest session directories from the mirror until under budget. */
+    private trim;
+}
+export declare function apply(ctx: Context, config?: Config): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/types/persist/index.d.ts.map

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

package/lib/types/scripts/probe.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=probe.d.ts.map

package/lib/types/scripts/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/scripts/probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/lib/types/sdk-index/catalog.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Closed-world `crowdy-compute-sdk` catalog: lookup, aliases, and the
+ * system-prompt section the agent reads instead of guessing names.
+ */
+import { type SdkEntry } from './parse-sdk.js';
+export interface SdkLookupHit {
+    found: boolean;
+    query: string;
+    /** Exact catalog entry when `found`. */
+    match?: SdkEntry;
+    /** Alias mapping that fired (`emit` → emit_event / emit_channel / …). */
+    viaAlias?: string;
+    /** Nearby real names when the query is not in the catalog. */
+    nearest: SdkEntry[];
+    note: string;
+}
+/**
+ * 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 declare const SDK_ALIASES: Readonly<Record<string, readonly string[]>>;
+/** Harness tool, not a WASM host function. Looking it up in the SDK is the miss. */
+export declare const GAME_CONTEXT_LOOKUP_NOTE: string;
+export declare const PLUGIN_HOST_LOOKUP_NOTE: string;
+export declare function isPluginHostLookup(raw: string, query?: string): boolean;
+export declare function isHarnessGameContextLookup(raw: string, query?: string): boolean;
+/** Dice coefficient on character bigrams — enough for `emit` vs `emit_event`. */
+export declare function nameSimilarity(a: string, b: string): number;
+export declare function nearestEntries(catalog: readonly SdkEntry[], query: string, limit?: number): SdkEntry[];
+/**
+ * Resolve a rustc / agent name against the catalog. Exact hits win;
+ * then curated aliases; then nearest real names. Never invents a function.
+ */
+export declare function lookupSdkName(catalog: readonly SdkEntry[], raw: string): SdkLookupHit;
+export declare function formatLookup(hit: SdkLookupHit): string;
+/** System-prompt section: rules plus the full function index. */
+export declare function formatSdkPrompt(catalog: readonly SdkEntry[]): string;
+//# sourceMappingURL=catalog.d.ts.map

package/lib/types/sdk-index/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/sdk-index/catalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE7D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,OAAO,EAAE,QAAQ,EAAE,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAOnE,CAAA;AAID,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,QAK2C,CAAA;AAEhF,eAAO,MAAM,uBAAuB,QAQe,CAAA;AA0BnD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAInE;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAI3E;AAeD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoB3D;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,KAAK,EAAE,MAAM,EACb,KAAK,SAAI,GACR,QAAQ,EAAE,CAOZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CA8ErF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAUtD;AAkBD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAmBpE"}

package/lib/types/sdk-index/catalog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.test.d.ts","sourceRoot":"","sources":["../../../src/sdk-index/catalog.test.ts"],"names":[],"mappings":""}

package/lib/types/sdk-index/index.d.ts

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

package/lib/types/sdk-index/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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;AACzD,YAAY,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EACL,YAAY,EACZ,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACrE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA"}

package/lib/types/sdk-index/parse-sdk.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pull public `pub fn` entries out of `crowdy-compute-sdk` source.
+ *
+ * The crate is one file. Crate-root helpers (`log`, `state_get`, …) live
+ * above `pub mod api`; typed host wrappers live inside it. `impl` methods
+ * (Predicate::new) are skipped — they are not callable as `crowdy::api::*`.
+ *
+ * @module @crowdy/dsh-cockpit/sdk-index
+ */
+export type SdkModule = 'crate' | 'api';
+export interface SdkEntry {
+    name: string;
+    module: SdkModule;
+    /** Compact `fn name(...) -> Type` line, whitespace folded. */
+    signature: string;
+    /** First `///` line above the function, if any. */
+    doc: string;
+}
+/**
+ * Parse crate-root and `pub mod api` functions from one `lib.rs`.
+ */
+export declare function parseCrowdyComputeSdk(source: string): SdkEntry[];
+/** Path used when rustc / the seed names a function. */
+export declare function qualifiedName(entry: SdkEntry): string;
+//# sourceMappingURL=parse-sdk.d.ts.map

package/lib/types/sdk-index/parse-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-sdk.d.ts","sourceRoot":"","sources":["../../../src/sdk-index/parse-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,CAAA;AAEvC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,CAAA;IACjB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;CACZ;AA4CD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CA2BhE;AA2CD,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAErD"}

package/lib/types/sdk-index/plugin.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Cordis plugin: inject the closed-world crowdy-compute-sdk index and a
+ * `sdk_lookup` tool.
+ *
+ * The Studio project does not contain the SDK crate, so grep/read cannot
+ * discover `crowdy::api::*`. This plugin is the swappable source of truth:
+ * disable the row and the agent loses the index; point `sdkSourcePath` at a
+ * newer `lib.rs` and the prompt rebuilds without a Studio seed change.
+ *
+ * @module @crowdy/dsh-cockpit/sdk-index
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export interface Config {
+    /**
+     * Optional path to `crowdy-compute-sdk/src/lib.rs`. When set, the prompt
+     * and lookup tool parse that file instead of the vendored 0.1.5 snapshot.
+     */
+    sdkSourcePath?: string;
+}
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "sdk-index-crowdy";
+export declare const inject: string[];
+export declare const Config: z<Config>;
+export declare function apply(ctx: Context, config?: Config): Promise<void>;
+//# sourceMappingURL=plugin.d.ts.map

package/lib/types/sdk-index/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/sdk-index/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAQxC,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,qDAAqD;AACrD,eAAO,MAAM,IAAI,qBAAqB,CAAA;AAEtC,eAAO,MAAM,MAAM,UAA4B,CAAA;AAE/C,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAI4B,CAAA;AAsBzD,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD5E"}

package/lib/types/sdk-index/snapshot.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Vendored crowdy-compute-sdk 0.1.5 catalog.
+ *
+ * The cockpit must not import the CK API repository at runtime. When the SDK crate
+ * source is available, `parseCrowdyComputeSdk` can rebuild this list; tests
+ * compare the two so a bump without a snapshot update fails loudly.
+ */
+import type { SdkEntry } from './parse-sdk.js';
+export declare const SDK_SNAPSHOT_VERSION = "0.1.5";
+export declare const SDK_SNAPSHOT: readonly SdkEntry[];
+//# sourceMappingURL=snapshot.d.ts.map

package/lib/types/sdk-index/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/sdk-index/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAE3C,eAAO,MAAM,YAAY,EAAE,SAAS,QAAQ,EA0N3C,CAAA"}

package/lib/types/search/glob-match.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Minimal glob matching for the Crowdy search tools.
+ *
+ * The stock `glob`/`grep` tools hand patterns to ripgrep; the Crowdy project
+ * lives behind a GraphQL API, so matching happens in memory instead. This
+ * module implements the subset of rg's glob syntax the tools document:
+ * `*` (within a segment), `?`, `**` (across segments), `[...]` classes, and
+ * `{a,b}` alternation. Following rg, a pattern with no `/` matches the
+ * BASENAME at any depth, and a pattern with a separator anchors to the whole
+ * relative path.
+ *
+ * @module @crowdy/dsh-cockpit/search/glob-match
+ */
+/** Thrown for a pattern the converter cannot interpret (e.g. unclosed brace). */
+export declare class GlobSyntaxError extends Error {
+}
+/**
+ * Compile one glob to an anchored RegExp over a `/`-separated relative path.
+ * @throws {GlobSyntaxError} for an uninterpretable pattern.
+ */
+export declare function globToRegExp(pattern: string): RegExp;
+/**
+ * Whether a project-relative path matches one glob, following rg's rule: a
+ * pattern with no `/` tests the basename at any depth; a pattern with a
+ * separator tests the whole relative path.
+ *
+ * @param relativePath - `/`-separated path relative to the search root.
+ * @param pattern - the glob to test.
+ */
+export declare function globMatches(relativePath: string, pattern: string): boolean;
+//# sourceMappingURL=glob-match.d.ts.map

package/lib/types/search/glob-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-match.d.ts","sourceRoot":"","sources":["../../../src/search/glob-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,iFAAiF;AACjF,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAiE7C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAM1E"}

package/lib/types/search/glob-match.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-match.test.d.ts","sourceRoot":"","sources":["../../../src/search/glob-match.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/lib/types/search/search-tools.d.ts

@@ -0,0 +1,81 @@
+/**
+ * The model-facing `glob` / `grep` discovery tools for a Crowdy Studio
+ * project.
+ *
+ * The stock `tool-fs-search` spawns ripgrep on this machine's disk, which is
+ * exactly the world the crowdy preset removes: the project lives behind the
+ * game API, not in the launch directory. This plugin registers tools with the
+ * SAME names and near-identical schemas, but matching happens in memory over
+ * the Crowdy filesystem backend's project snapshot (`ctx.fs` must be
+ * {@link CrowdyFileSystem}), so search, read, and write always describe the
+ * same files.
+ *
+ * A Crowdy project is small (two targets, a handful of files, 64 KiB per
+ * file), so there is no subprocess, no spill store, and no pagination beyond
+ * a defensive inline cap. Returned paths are relative to the project mount,
+ * which is the same base the `read` tool resolves against, so every result
+ * is follow-up-readable.
+ *
+ * @module @crowdy/dsh-cockpit/search
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export interface Config {
+    /** Max paths one `glob` call returns inline. */
+    globMaxResults?: number;
+    /** Max matches one `grep` call returns inline. */
+    grepMaxMatches?: number;
+    /** Max bytes retained for one matched-line preview. */
+    grepMaxLineBytes?: number;
+}
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "tool-fs-search-crowdy";
+/** Services required by the Crowdy search tool suite. */
+export declare const inject: string[];
+export declare const Config: z<Config>;
+/** One file of the project snapshot the pure search core operates on. */
+export interface SearchFile {
+    /** Virtual absolute path, e.g. `/mnt/crowdy/server/src/main.rs`. */
+    virtualPath: string;
+    content: string;
+}
+/** One grep hit in the canonical output shape shared with the stock tool. */
+export interface GrepMatch {
+    path: string;
+    lineNumber: number;
+    line: string;
+}
+/**
+ * Resolve the optional `path` argument against the mount root, rejecting a
+ * target outside the mount so the model gets a precise message instead of a
+ * silent empty result.
+ */
+export declare function resolveSearchRoot(mountRoot: string, pathArg: string | undefined): string;
+/**
+ * Discover project files matching one glob, scoped to `searchRoot`. Matching
+ * follows the stock tool's rule (no `/` in the pattern = basename at any
+ * depth); display paths are mount-relative and returned in path order,
+ * because Crowdy files have no modification times.
+ */
+export declare function globProjectPaths(files: readonly SearchFile[], mountRoot: string, searchRoot: string, pattern: string): string[];
+/** Bound one matched-line preview to `maxBytes`, preserving UTF-8 boundaries. */
+export declare function previewLine(line: string, maxBytes: number): string;
+/**
+ * Search project file contents with a regular expression, scoped to
+ * `searchRoot` (a directory or a single file) and optionally filtered by one
+ * `include` glob. Lines are 1-based; a file's trailing newline does not
+ * produce a phantom empty line.
+ */
+export declare function grepProjectFiles(files: readonly SearchFile[], mountRoot: string, searchRoot: string, pattern: string, include: string | undefined, maxLineBytes: number): GrepMatch[];
+/** Group flat matches by file into the model-facing body. */
+export declare function formatGrepMatches(matches: readonly GrepMatch[]): string;
+/** Format the model-facing `grep` result, with the inline cap applied. */
+export declare function renderGrepResult(matches: readonly GrepMatch[], maxMatches: number): string;
+/** Format the model-facing `glob` result, with the inline cap applied. */
+export declare function renderGlobResult(paths: readonly string[], maxResults: number): string;
+/**
+ * Register the Crowdy-backed `glob` / `grep` tool suite and its system-prompt
+ * guidance.
+ */
+export declare function apply(ctx: Context, config: Config): Promise<void>;
+//# sourceMappingURL=search-tools.d.ts.map

package/lib/types/search/search-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../../../src/search/search-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAaxC,MAAM,WAAW,MAAM;IACrB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,qDAAqD;AACrD,eAAO,MAAM,IAAI,0BAA0B,CAAA;AAE3C,yDAAyD;AACzD,eAAO,MAAM,MAAM,UAAkC,CAAA;AAErD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAIH,CAAA;AAE1B,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASxF;AAkBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAWV;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,YAAY,EAAE,MAAM,GACnB,SAAS,EAAE,CAkCb;AAOD,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAYvE;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAU1F;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAOrF;AAsED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8KvE"}