@crowdedkingdoms/crowdyjs 11.1.0 → 12.1.0

package/dist/crowdy-studio/index.js

@@ -7,3 +7,9 @@ export { isCurrentDiagnosticVersion, } from './monaco-editor.js';
 export { EMBEDDED_PLATFORM_INDEX, MAX_PLATFORM_CRATES, MAX_PLATFORM_CRATE_FIELD_LENGTH, MAX_PLATFORM_INDEX_BYTES, computePlatformIndexContentHash, loadPlatformIndex, } from '../live-coding/platform-index.js';
 export { DEFAULT_VFS_LIMITS, VfsLimitError, VirtualFileSystem, offsetAt, } from '../live-coding/vfs.js';
 export { WorkerLanguageClient, WorkerMessageReader, WorkerMessageWriter, createDefaultRustLanguageWorker, } from '../live-coding/worker-transport.js';
+export { CrowdyStudioAgentDomShell, } from './agent-dom-shell.js';
+export { STUDIO_LAYOUT_STORAGE_KEY, STUDIO_PANE_IDS, StudioLayoutController, clampStudioPaneSize, studioPaneSizeRange, } from './layout.js';
+export { createPaneSplitter, } from './splitter.js';
+export * from './embed/index.js';
+export * from '../crowdy-agent/index.js';
+export * from '../player-host/index.js';

package/dist/crowdy-studio/layout.d.ts

@@ -0,0 +1,50 @@
+/**
+ * User-directed Crowdy Studio layout state: which panes are visible and how
+ * large they are. The editor is the only always-visible surface; the explorer,
+ * project settings, agent dock, and bottom panel are toggled by the person
+ * using the Studio and their choices persist locally.
+ */
+export type StudioPaneId = 'explorer' | 'settings' | 'agent' | 'bottom';
+export interface StudioPaneSizeRange {
+    readonly min: number;
+    readonly max: number;
+}
+export interface StudioLayoutState {
+    readonly visible: Readonly<Record<StudioPaneId, boolean>>;
+    /** Pixel widths for side panes; pixel height for the bottom panel. */
+    readonly sizes: Readonly<Record<StudioPaneId, number>>;
+}
+export type StudioLayoutListener = (state: StudioLayoutState) => void;
+export type StudioLayoutStorage = Pick<Storage, 'getItem' | 'setItem'>;
+export interface StudioLayoutControllerOptions {
+    storage?: StudioLayoutStorage | null;
+    storageKey?: string;
+    defaults?: Partial<StudioLayoutState>;
+}
+export declare const STUDIO_LAYOUT_STORAGE_KEY = "ck:crowdy-studio:layout:v1";
+export declare const STUDIO_PANE_IDS: readonly StudioPaneId[];
+export declare function studioPaneSizeRange(pane: StudioPaneId): StudioPaneSizeRange;
+export declare function clampStudioPaneSize(pane: StudioPaneId, size: number): number;
+/**
+ * Headless layout state machine. DOM shells subscribe and translate the state
+ * into CSS variables / hidden attributes; tests drive it directly.
+ */
+export declare class StudioLayoutController {
+    private readonly storage;
+    private readonly storageKey;
+    private readonly listeners;
+    private visible;
+    private sizes;
+    constructor(options?: StudioLayoutControllerOptions);
+    getState(): StudioLayoutState;
+    isVisible(pane: StudioPaneId): boolean;
+    paneSize(pane: StudioPaneId): number;
+    subscribe(listener: StudioLayoutListener): () => void;
+    setVisible(pane: StudioPaneId, visible: boolean): void;
+    toggle(pane: StudioPaneId): void;
+    setSize(pane: StudioPaneId, size: number, persist?: boolean): void;
+    private emit;
+    private loadPersisted;
+    private persist;
+}
+//# sourceMappingURL=layout.d.ts.map

package/dist/crowdy-studio/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/layout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEtE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAEvE,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACvC;AAED,eAAO,MAAM,yBAAyB,+BAA+B,CAAC;AAEtE,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAKlD,CAAC;AAuBF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAE3E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,KAAK,CAA+B;gBAEhC,OAAO,GAAE,6BAAkC;IAevD,QAAQ,IAAI,iBAAiB;IAI7B,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAItC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAIpC,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAOrD,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAOtD,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIhC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI;IAW/D,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,OAAO;CAWhB"}

package/dist/crowdy-studio/layout.js

@@ -0,0 +1,155 @@
+/**
+ * User-directed Crowdy Studio layout state: which panes are visible and how
+ * large they are. The editor is the only always-visible surface; the explorer,
+ * project settings, agent dock, and bottom panel are toggled by the person
+ * using the Studio and their choices persist locally.
+ */
+export const STUDIO_LAYOUT_STORAGE_KEY = 'ck:crowdy-studio:layout:v1';
+export const STUDIO_PANE_IDS = [
+    'explorer',
+    'settings',
+    'agent',
+    'bottom',
+];
+const DEFAULT_VISIBLE = {
+    explorer: true,
+    settings: false,
+    agent: false,
+    bottom: false,
+};
+const DEFAULT_SIZES = {
+    explorer: 230,
+    settings: 280,
+    agent: 340,
+    bottom: 180,
+};
+const SIZE_RANGES = {
+    explorer: { min: 160, max: 480 },
+    settings: { min: 220, max: 480 },
+    agent: { min: 280, max: 620 },
+    bottom: { min: 96, max: 480 },
+};
+export function studioPaneSizeRange(pane) {
+    return SIZE_RANGES[pane];
+}
+export function clampStudioPaneSize(pane, size) {
+    const range = SIZE_RANGES[pane];
+    if (!Number.isFinite(size))
+        return DEFAULT_SIZES[pane];
+    return Math.round(Math.min(range.max, Math.max(range.min, size)));
+}
+/**
+ * Headless layout state machine. DOM shells subscribe and translate the state
+ * into CSS variables / hidden attributes; tests drive it directly.
+ */
+export class StudioLayoutController {
+    constructor(options = {}) {
+        this.listeners = new Set();
+        this.storage =
+            options.storage !== undefined ? options.storage : safeLocalStorage();
+        this.storageKey = options.storageKey ?? STUDIO_LAYOUT_STORAGE_KEY;
+        this.visible = { ...DEFAULT_VISIBLE, ...options.defaults?.visible };
+        this.sizes = { ...DEFAULT_SIZES };
+        if (options.defaults?.sizes) {
+            for (const pane of STUDIO_PANE_IDS) {
+                const size = options.defaults.sizes[pane];
+                if (size !== undefined)
+                    this.sizes[pane] = clampStudioPaneSize(pane, size);
+            }
+        }
+        this.loadPersisted();
+    }
+    getState() {
+        return { visible: { ...this.visible }, sizes: { ...this.sizes } };
+    }
+    isVisible(pane) {
+        return this.visible[pane];
+    }
+    paneSize(pane) {
+        return this.sizes[pane];
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    setVisible(pane, visible) {
+        if (this.visible[pane] === visible)
+            return;
+        this.visible = { ...this.visible, [pane]: visible };
+        this.persist();
+        this.emit();
+    }
+    toggle(pane) {
+        this.setVisible(pane, !this.visible[pane]);
+    }
+    setSize(pane, size, persist = true) {
+        const next = clampStudioPaneSize(pane, size);
+        if (this.sizes[pane] === next) {
+            if (persist)
+                this.persist();
+            return;
+        }
+        this.sizes = { ...this.sizes, [pane]: next };
+        if (persist)
+            this.persist();
+        this.emit();
+    }
+    emit() {
+        const state = this.getState();
+        for (const listener of [...this.listeners])
+            listener(state);
+    }
+    loadPersisted() {
+        if (!this.storage)
+            return;
+        let raw = null;
+        try {
+            raw = this.storage.getItem(this.storageKey);
+        }
+        catch {
+            return;
+        }
+        if (!raw)
+            return;
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed !== 'object' || parsed === null)
+                return;
+            const record = parsed;
+            for (const pane of STUDIO_PANE_IDS) {
+                const visible = record.visible?.[pane];
+                if (typeof visible === 'boolean')
+                    this.visible[pane] = visible;
+                const size = record.sizes?.[pane];
+                if (typeof size === 'number' && Number.isFinite(size)) {
+                    this.sizes[pane] = clampStudioPaneSize(pane, size);
+                }
+            }
+        }
+        catch {
+            // Ignore corrupt persisted layout; defaults remain in effect.
+        }
+    }
+    persist() {
+        if (!this.storage)
+            return;
+        try {
+            this.storage.setItem(this.storageKey, JSON.stringify({ visible: this.visible, sizes: this.sizes }));
+        }
+        catch {
+            // Storage can be unavailable (private mode); layout stays session-only.
+        }
+    }
+}
+function safeLocalStorage() {
+    try {
+        if (typeof window === 'undefined')
+            return null;
+        return window.localStorage;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/crowdy-studio/models.d.ts

@@ -123,6 +123,73 @@ export interface CrowdyStudioProjectProvider {
     importReferenceFile(input: ImportCrowdyStudioReferenceFileInput): Promise<CrowdyStudioProject>;
     savePersonalLibraryFile(input: SaveCrowdyStudioLibraryFileInput): Promise<CrowdyStudioReferenceFile>;
 }
+export type CrowdyStudioPatchOperation = 'CREATE' | 'REPLACE';
+/** One routine, non-destructive file replacement in an atomic agent patch. */
+export interface CrowdyStudioAtomicFileChange {
+    target: CrowdyStudioTarget;
+    path: string;
+    operation: CrowdyStudioPatchOperation;
+    content: string;
+    /** `ABSENT` for CREATE, otherwise the exact current sha256 digest. */
+    expectedContentHash: string | 'ABSENT';
+}
+export interface CrowdyStudioAtomicPatchInput {
+    expectedRevisionId: string;
+    changes: readonly CrowdyStudioAtomicFileChange[];
+}
+export interface CrowdyStudioCheckpointFile {
+    target: CrowdyStudioTarget;
+    path: string;
+    contentHash: string;
+    byteLength: number;
+}
+/** Source-free checkpoint metadata safe for Studio state and agent events. */
+export interface CrowdyStudioCheckpointMetadata {
+    checkpointId: string;
+    projectRevisionId: string;
+    contentHash: string;
+    reason: 'AGENT_WRITE' | 'RESTORE_PREIMAGE' | 'MANUAL';
+    files: readonly CrowdyStudioCheckpointFile[];
+    createdAt: string;
+    restoredAt?: string;
+}
+export interface CrowdyStudioAtomicPatchResult {
+    project: CrowdyStudioProject;
+    checkpoint: CrowdyStudioCheckpointMetadata;
+    changedFiles: readonly CrowdyStudioCheckpointFile[];
+}
+export interface CrowdyStudioCheckpointRestoreInput {
+    projectId: string;
+    checkpointId: string;
+    expectedRevisionId: string;
+    /** Opaque single-use grant from the durable orchestrator. */
+    approvalGrant: string;
+}
+export interface CrowdyStudioCheckpointRestoreResult {
+    project: CrowdyStudioProject;
+    preRestoreCheckpoint: CrowdyStudioCheckpointMetadata;
+}
+/**
+ * Optional durable synchronization hooks. A generated Game API adapter can
+ * implement these after schema reconciliation; the headless kernel stays
+ * transport-neutral and tests can inject deterministic fakes.
+ */
+export interface CrowdyStudioSynchronizationProvider {
+    applyAtomicPatch(input: CrowdyStudioProjectScope & {
+        projectId: string;
+        expectedRevisionId: string;
+        changes: readonly CrowdyStudioAtomicFileChange[];
+    }): Promise<CrowdyStudioAtomicPatchResult>;
+    listCheckpoints(input: CrowdyStudioProjectScope & {
+        projectId: string;
+    }): Promise<readonly CrowdyStudioCheckpointMetadata[]>;
+    restoreCheckpoint(input: CrowdyStudioProjectScope & CrowdyStudioCheckpointRestoreInput): Promise<CrowdyStudioCheckpointRestoreResult>;
+}
+export interface CrowdyStudioProjectSynchronization {
+    source: 'AGENT' | 'REMOTE';
+    expectedPreviousRevisionId?: string;
+    checkpoint?: CrowdyStudioCheckpointMetadata;
+}
 /** Provider error indicating that the expected revision lost a save race. */
 export declare class CrowdyStudioRevisionConflictError extends Error {
     readonly remoteProject?: CrowdyStudioProject | undefined;

package/dist/crowdy-studio/models.d.ts.map

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

package/dist/crowdy-studio/mount.d.ts

@@ -1,10 +1,25 @@
 import { CrowdyStudioController, type CrowdyStudioControllerOptions } from './controller.js';
+import { CrowdyAgentToolRegistry, CrowdyStudioAgentController, type CrowdyAgentBrowserToolHandlersV1, type CrowdyStudioAgentControllerOptionsV1 } from '../crowdy-agent/index.js';
+import { AgentControlLeaseManager, type AgentControlLeaseManagerOptionsV1, type PlayerHostAdapterV1 } from '../player-host/index.js';
 import type { CrowdyStudioEditorAdapter, CrowdyStudioEditorMode } from './editor.js';
 import { type MonacoCrowdyStudioEditorOptions } from './monaco-editor.js';
 export interface MountCrowdyStudioOptions extends CrowdyStudioControllerOptions, MonacoCrowdyStudioEditorOptions {
+    /** Optional durable Agentic Crowdy Studio vertical slice. */
+    agent?: MountCrowdyStudioAgentOptions;
+}
+export interface MountCrowdyStudioAgentOptions extends Omit<CrowdyStudioAgentControllerOptionsV1, 'browserDispatcher' | 'beforeAgentWork' | 'onEpochAttached' | 'onLeaseChanged' | 'onPreempt' | 'resolveProjectBinding'> {
+    registry?: CrowdyAgentToolRegistry;
+    /** Exact additional handlers, normally `game.extension.<game>.*`. */
+    browserHandlers?: CrowdyAgentBrowserToolHandlersV1;
+    playerHost?: PlayerHostAdapterV1;
+    controlGate?: AgentControlLeaseManagerOptionsV1;
+    onLocalPreempt?: CrowdyStudioAgentControllerOptionsV1['onPreempt'];
+    autoInitialize?: boolean;
 }
 export interface CrowdyStudioHandle {
     controller: CrowdyStudioController;
+    agent: CrowdyStudioAgentController | null;
+    controlLeaseManager: AgentControlLeaseManager | null;
     editorMode: CrowdyStudioEditorMode;
     destroy(): void;
 }

package/dist/crowdy-studio/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EACnC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,yBAAyB,EAEzB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,wBACf,SAAQ,6BAA6B,EACnC,+BAA+B;CAAG;AAEtC,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,sBAAsB,CAAC;IACnC,UAAU,EAAE,sBAAsB,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,yBAAyB,GAAG,IAAI,GACpD,MAAM,IAAI,CAmBZ;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAwG7B"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EACnC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,uBAAuB,EACvB,2BAA2B,EAE3B,KAAK,gCAAgC,EACrC,KAAK,oCAAoC,EAC1C,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,wBAAwB,EAExB,KAAK,iCAAiC,EACtC,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,yBAAyB,EAEzB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,wBACf,SAAQ,6BAA6B,EACnC,+BAA+B;IACjC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,6BAA6B,CAAC;CACvC;AAED,MAAM,WAAW,6BACf,SAAQ,IAAI,CACV,oCAAoC,EAClC,mBAAmB,GACnB,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,GACX,uBAAuB,CAC1B;IACD,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,qEAAqE;IACrE,eAAe,CAAC,EAAE,gCAAgC,CAAC;IACnD,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,WAAW,CAAC,EAAE,iCAAiC,CAAC;IAChD,cAAc,CAAC,EAAE,oCAAoC,CAAC,WAAW,CAAC,CAAC;IACnE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC1C,mBAAmB,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACrD,UAAU,EAAE,sBAAsB,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,yBAAyB,GAAG,IAAI,GACpD,MAAM,IAAI,CAmBZ;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA+O7B"}

package/dist/crowdy-studio/mount.js

@@ -1,4 +1,6 @@
 import { CrowdyStudioController, } from './controller.js';
+import { CROWDY_AGENT_TOOL_REGISTRY_V1, CrowdyAgentBrowserToolDispatcher, CrowdyStudioAgentController, createCrowdyStudioAgentTools, } from '../crowdy-agent/index.js';
+import { createPlayerHostAgentTools, } from '../player-host/index.js';
 import { CrowdyStudioDomShell } from './dom-shell.js';
 import { createMonacoCrowdyStudioEditor, } from './monaco-editor.js';
 import { createTextareaCrowdyStudioEditor } from './textarea-editor.js';
@@ -41,11 +43,104 @@ export async function mountCrowdyStudio(host, options) {
         throw new Error('mountCrowdyStudio requires a DOM document');
     }
     const controller = new CrowdyStudioController(options);
-    const shell = new CrowdyStudioDomShell(host, controller);
+    let agent = null;
+    let controlLeaseManager = null;
+    if (options.agent) {
+        const registry = options.agent.registry ?? CROWDY_AGENT_TOOL_REGISTRY_V1;
+        const hostTools = options.agent.playerHost
+            ? createPlayerHostAgentTools(options.agent.playerHost, {
+                ...options.agent.controlGate,
+                contextVersion: options.agent.controlGate?.contextVersion ??
+                    (() => agent?.getState().session?.contextVersion ??
+                        controller.getAgentContext().contextVersion),
+            })
+            : null;
+        controlLeaseManager = hostTools?.leaseManager ?? null;
+        const handlers = mergeAgentHandlers(createCrowdyStudioAgentTools(controller, {
+            getClientEpoch: () => agent?.getState().clientEpoch ?? null,
+            getContextVersion: () => agent?.getState().session?.contextVersion,
+            getLeaseKinds: () => agent
+                ?.getState()
+                .leases.filter((lease) => lease.status === 'ACTIVE')
+                .map((lease) => lease.kind) ?? [],
+            getHostCapabilityRevision: () => controlLeaseManager?.snapshot().capabilities?.revision,
+            isLeaseActive: (leaseId, kind) => agent
+                ?.getState()
+                .leases.some((lease) => lease.leaseId === leaseId &&
+                lease.kind === kind &&
+                lease.status === 'ACTIVE') ?? false,
+        }), hostTools?.handlers, options.agent.browserHandlers);
+        const dispatcher = new CrowdyAgentBrowserToolDispatcher({
+            registry,
+            handlers,
+            getSessionId: () => agent?.getState().session?.sessionId ?? null,
+            getClientEpoch: () => agent?.getState().clientEpoch ?? null,
+            getContextVersion: () => agent?.getState().session?.contextVersion ??
+                controller.getAgentContext().contextVersion,
+            getMode: () => agent?.getState().session?.mode ?? 'ASK',
+        });
+        const agentOptions = options.agent;
+        agent = new CrowdyStudioAgentController({
+            ...agentOptions,
+            browserDispatcher: dispatcher,
+            resolveProjectBinding: async () => {
+                const project = controller.getState().project;
+                if (project && !(await controller.saveNow())) {
+                    throw new Error('Resolve the selected project save before starting the agent');
+                }
+                return {
+                    ...(project ? { projectId: project.projectId } : {}),
+                    gridId: project?.gridId ?? options.gridId,
+                };
+            },
+            beforeAgentWork: async () => {
+                await controller.prepareForAgentWork();
+            },
+            onPreempt: (reason) => {
+                controlLeaseManager?.preempt(reason);
+                agentOptions.onLocalPreempt?.(reason);
+            },
+            onEpochAttached: (clientEpoch) => {
+                controlLeaseManager?.attach(clientEpoch);
+                if (controlLeaseManager) {
+                    void controlLeaseManager.refreshCapabilities().catch(() => {
+                        controlLeaseManager?.preempt('CONTEXT_CHANGED');
+                    });
+                }
+            },
+            onLeaseChanged: (lease) => {
+                if (!controlLeaseManager || lease.kind !== 'PLAY')
+                    return;
+                if (lease.status === 'ACTIVE') {
+                    void controlLeaseManager
+                        .refreshCapabilities()
+                        .then(() => controlLeaseManager?.grantLease(lease))
+                        .catch(() => controlLeaseManager?.preempt('CONTEXT_CHANGED'));
+                }
+                else {
+                    controlLeaseManager.preempt(lease.revokedReason ?? 'LEASE_EXPIRED');
+                }
+            },
+        });
+    }
+    const shell = new CrowdyStudioDomShell(host, controller, agent ?? undefined, {
+        getPlayLeaseContext: () => {
+            const capabilities = controlLeaseManager?.snapshot().capabilities;
+            return capabilities
+                ? {
+                    controlledEntityId: capabilities.controlledEntityId,
+                    hostCapabilityRevision: capabilities.revision,
+                }
+                : null;
+        },
+    });
+    const unsubscribeHumanEdit = controller.onHumanEdit(() => agent?.preemptForHumanEdit());
     let editor = null;
     let destroyed = false;
     let recoveringEditor = false;
-    const disconnectLayoutObserver = observeCrowdyStudioEditorLayout(host, () => editor);
+    // Observe the editor box itself so pane toggles and splitter drags inside
+    // the studio relayout Monaco, not only host/window resizes.
+    const disconnectLayoutObserver = observeCrowdyStudioEditorLayout(shell.editorHost, () => editor);
     const callbacks = {
         onProjectFileChange: (target, path, content) => controller.updateFile(target, path, content),
         onLocalDiagnostics: (diagnostics) => controller.setLocalDiagnostics(diagnostics),
@@ -68,12 +163,20 @@ export async function mountCrowdyStudio(host, options) {
             });
         },
     };
+    let selectedProjectId = controller.getState().project?.projectId;
     const unsubscribe = controller.subscribe((state) => {
         shell.render(state);
         editor?.sync(state);
+        const nextProjectId = state.project?.projectId;
+        if (nextProjectId !== selectedProjectId) {
+            selectedProjectId = nextProjectId;
+            agent?.projectSelectionChanged(nextProjectId);
+        }
     });
     const onVisibilityChange = () => {
-        controller.setPageVisible(document.visibilityState !== 'hidden');
+        const visible = document.visibilityState !== 'hidden';
+        controller.setPageVisible(visible);
+        agent?.setPageVisible(visible);
     };
     document.addEventListener('visibilitychange', onVisibilityChange);
     onVisibilityChange();
@@ -88,6 +191,11 @@ export async function mountCrowdyStudio(host, options) {
         }
         editor.sync(controller.getState());
         editor.layout();
+        if (agent && options.agent?.autoInitialize !== false) {
+            await agent.initialize().catch((error) => {
+                console.warn('Crowdy Studio agent could not attach; manual Studio remains available', error);
+            });
+        }
     }
     catch (error) {
         disconnectLayoutObserver();
@@ -96,11 +204,15 @@ export async function mountCrowdyStudio(host, options) {
         const failedEditor = editor;
         failedEditor?.dispose();
         shell.dispose();
+        unsubscribeHumanEdit();
+        agent?.destroy();
         controller.destroy();
         throw error;
     }
     return {
         controller,
+        agent,
+        controlLeaseManager,
         get editorMode() {
             return editor?.mode ?? 'textarea';
         },
@@ -114,7 +226,24 @@ export async function mountCrowdyStudio(host, options) {
             editor?.dispose();
             editor = null;
             shell.dispose();
+            unsubscribeHumanEdit();
+            agent?.destroy();
+            agent = null;
             controller.destroy();
         },
     };
 }
+function mergeAgentHandlers(...sets) {
+    const merged = {};
+    for (const set of sets) {
+        if (!set)
+            continue;
+        for (const [name, handler] of Object.entries(set)) {
+            if (merged[name]) {
+                throw new Error(`Duplicate Crowdy Studio browser tool handler: ${name}`);
+            }
+            merged[name] = handler;
+        }
+    }
+    return Object.freeze(merged);
+}

package/dist/crowdy-studio/splitter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Reusable accessible pane splitter for Crowdy Studio panes. Pointer drag plus
+ * Arrow/Home/End keyboard resizing, mirroring the behavior games already ship
+ * for the game/studio dock separator.
+ */
+export interface PaneSplitterRange {
+    readonly min: number;
+    readonly max: number;
+}
+export interface PaneSplitterOptions {
+    /** `vertical` separators resize widths; `horizontal` separators heights. */
+    orientation: 'vertical' | 'horizontal';
+    /**
+     * Where the sized pane sits relative to the separator in document order:
+     * `before` (explorer to its left / panel above) grows as the pointer moves
+     * right/down; `after` (right-hand or bottom panes) grows in the opposite
+     * direction.
+     */
+    pane: 'before' | 'after';
+    label: string;
+    range(): PaneSplitterRange;
+    getSize(): number;
+    /** `commit` is true for the final size of a gesture (persist it). */
+    setSize(size: number, commit: boolean): void;
+}
+export interface PaneSplitterHandle {
+    readonly element: HTMLDivElement;
+    /** Re-sync ARIA values after external size or range changes. */
+    refresh(): void;
+    dispose(): void;
+}
+export declare function createPaneSplitter(options: PaneSplitterOptions): PaneSplitterHandle;
+//# sourceMappingURL=splitter.d.ts.map

package/dist/crowdy-studio/splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitter.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/splitter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,WAAW,EAAE,UAAU,GAAG,YAAY,CAAC;IACvC;;;;;OAKG;IACH,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,IAAI,iBAAiB,CAAC;IAC3B,OAAO,IAAI,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,gEAAgE;IAChE,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;CACjB;AAKD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAoIpB"}