@crowdedkingdoms/crowdyjs 11.0.0 → 12.0.0

package/dist/crowdy-studio/controller.js

@@ -1,4 +1,5 @@
 import { PlayerCodeBroker, } from '../player-runtime/player-code-broker.js';
+import { digestCanonicalJson, sha256Digest, } from '../crowdy-agent/schema.js';
 import { parseRustcDiagnostics } from './diagnostics.js';
 import { cloneCrowdyStudioProject, crowdyStudioFileKey, normalizeCrowdyStudioPath, projectTargets, CrowdyStudioOfflineError, CrowdyStudioRevisionConflictError, } from './models.js';
 import { createCrowdyStudioStarterProject, } from './starter-projects.js';
@@ -21,6 +22,9 @@ export class CrowdyStudioController {
             activeFile: null,
             saveState: 'SAVED',
             runtime: { phase: 'IDLE' },
+            runtimeSync: { state: 'NEVER_RUN' },
+            agentActivity: 'IDLE',
+            checkpoints: [],
             buildOutput: '',
             authoritativeDiagnostics: [],
             localDiagnostics: [],
@@ -31,6 +35,7 @@ export class CrowdyStudioController {
             invokeResult: null,
         };
         this.listeners = new Set();
+        this.humanEditListeners = new Set();
         this.autosaveTimer = null;
         this.retryTimer = null;
         this.savePromise = null;
@@ -39,6 +44,7 @@ export class CrowdyStudioController {
         this.conflictRemote = null;
         this.broker = null;
         this.operationGeneration = 0;
+        this.agentOperationGeneration = 0;
         this.visibleSurfaces = new Set();
         this.surfaceTimers = new Map();
         this.pageVisible = true;
@@ -54,6 +60,51 @@ export class CrowdyStudioController {
         listener(this.state);
         return () => this.listeners.delete(listener);
     }
+    /** Subscribe to synchronous human-edit preemption signals. */
+    onHumanEdit(listener) {
+        this.humanEditListeners.add(listener);
+        return () => this.humanEditListeners.delete(listener);
+    }
+    /**
+     * Flush autosave before a durable agent turn. Conflict/offline state fails
+     * closed so Build never starts from an uncommitted browser snapshot.
+     */
+    async prepareForAgentWork() {
+        this.ensureAlive();
+        this.update({ agentActivity: 'PREPARING' });
+        const saved = await this.saveNow();
+        if (!saved || this.state.saveState !== 'SAVED') {
+            this.update({ agentActivity: 'PAUSED' });
+            throw new Error('Resolve the project save before starting agent work');
+        }
+        const project = this.state.project;
+        this.update({ agentActivity: 'WORKING' });
+        return {
+            ...(project
+                ? {
+                    projectId: project.projectId,
+                    projectRevisionId: project.revision.id,
+                }
+                : {}),
+            saveState: 'SAVED',
+            runtimeSync: { ...this.state.runtimeSync },
+        };
+    }
+    finishAgentWork(paused = false) {
+        this.update({ agentActivity: paused ? 'PAUSED' : 'IDLE' });
+    }
+    beginAgentOperation() {
+        return ++this.agentOperationGeneration;
+    }
+    /** Synchronously fence an in-flight agent compile/deploy/invoke operation. */
+    cancelAgentOperation(message = 'Agent operation cancelled') {
+        ++this.agentOperationGeneration;
+        ++this.operationGeneration;
+        this.update({
+            agentActivity: 'PAUSED',
+            runtime: { phase: 'IDLE', message },
+        });
+    }
     canTarget(target, action) {
         const permission = this.options.targetPermissions?.[target];
         return permission
@@ -62,6 +113,32 @@ export class CrowdyStudioController {
                 : permission.canRun
             : true;
     }
+    /** Credential-free context projection used by exact browser agent tools. */
+    getAgentContext() {
+        const project = this.state.project;
+        return {
+            appRef: this.options.appId,
+            ...(project ? { projectRef: project.projectId } : {}),
+            gridRef: this.options.gridId,
+            contextVersion: digestCanonicalJson({
+                contract: 'crowdy.studio-context/1',
+                appRef: this.options.appId,
+                gridRef: this.options.gridId,
+                ...(project
+                    ? {
+                        projectRef: project.projectId,
+                        projectRevisionId: project.revision.id,
+                        projectContentHash: projectContentHash(project),
+                    }
+                    : {}),
+                saveState: this.state.saveState,
+                runtimeSync: this.state.runtimeSync,
+            }),
+            ...(project
+                ? { projectContentHash: projectContentHash(project) }
+                : {}),
+        };
+    }
     async initialize() {
         this.ensureAlive();
         const scope = this.scope();
@@ -128,6 +205,9 @@ export class CrowdyStudioController {
             projectId,
         });
         this.installProject(project);
+        if (this.options.synchronizationProvider) {
+            await this.refreshCheckpoints();
+        }
     }
     installProject(project) {
         ++this.operationGeneration;
@@ -148,6 +228,12 @@ export class CrowdyStudioController {
             saveState: 'SAVED',
             saveMessage: undefined,
             runtime: { phase: 'IDLE' },
+            runtimeSync: {
+                state: 'NEVER_RUN',
+                savedRevisionId: clone.revision.id,
+            },
+            agentActivity: 'IDLE',
+            checkpoints: [],
             buildOutput: '',
             authoritativeDiagnostics: [],
             localDiagnostics: [],
@@ -352,19 +438,183 @@ export class CrowdyStudioController {
         this.update({ saveState: 'SAVING', saveMessage: undefined });
         return this.saveNow();
     }
-    async testDraft() {
-        await this.deployProject(true);
+    async refreshCheckpoints() {
+        const project = this.requireProject();
+        const checkpoints = this.options.synchronizationProvider
+            ? await this.options.synchronizationProvider.listCheckpoints({
+                ...this.scope(),
+                projectId: project.projectId,
+            })
+            : this.state.checkpoints;
+        this.update({ checkpoints: [...checkpoints] });
+        return checkpoints;
+    }
+    /**
+     * Validate every change against one immutable baseline, then persist and
+     * synchronize all files or none. Routine agent patches cannot delete/rename.
+     */
+    async applyAtomicPatch(input) {
+        if (!(await this.saveNow())) {
+            throw new Error('Resolve the current project save before applying an agent patch');
+        }
+        const baseline = cloneCrowdyStudioProject(this.requireProject());
+        if (baseline.revision.id !== input.expectedRevisionId) {
+            throw new CrowdyStudioRevisionConflictError(`Expected revision ${input.expectedRevisionId}, found ${baseline.revision.id}`, baseline);
+        }
+        applyValidatedPatch(baseline, input);
+        if (!this.options.synchronizationProvider) {
+            throw new Error('Atomic agent patches require a durable synchronization provider');
+        }
+        const result = await this.options.synchronizationProvider.applyAtomicPatch({
+            ...this.scope(),
+            projectId: baseline.projectId,
+            expectedRevisionId: input.expectedRevisionId,
+            changes: input.changes,
+        });
+        if (result.project.projectId !== baseline.projectId) {
+            throw new Error('Atomic patch returned a different project');
+        }
+        if (result.project.revision.id === baseline.revision.id ||
+            result.checkpoint.projectRevisionId !== baseline.revision.id) {
+            throw new Error('Atomic patch returned invalid revision/checkpoint metadata');
+        }
+        for (const change of input.changes) {
+            const persisted = result.project.files.find((file) => file.target === change.target &&
+                file.path === normalizeCrowdyStudioPath(change.path));
+            if (!persisted || persisted.content !== change.content) {
+                throw new Error(`Atomic patch did not synchronize ${change.target}:${change.path}`);
+            }
+        }
+        this.synchronizeProject(result.project, {
+            source: 'AGENT',
+            expectedPreviousRevisionId: baseline.revision.id,
+            checkpoint: result.checkpoint,
+        });
+        return result;
+    }
+    /**
+     * Apply a server-published project revision to Monaco/kernel state. Pending
+     * human edits win and turn the update into an explicit conflict.
+     */
+    synchronizeProject(project, synchronization) {
+        const current = this.requireProject();
+        if (project.projectId !== current.projectId) {
+            throw new Error('Project synchronization target does not match the open project');
+        }
+        if (synchronization.expectedPreviousRevisionId &&
+            synchronization.expectedPreviousRevisionId !== current.revision.id) {
+            throw new CrowdyStudioRevisionConflictError('Project synchronization started from a stale revision', project);
+        }
+        if (this.persistedGeneration !== this.editGeneration) {
+            this.conflictRemote = cloneCrowdyStudioProject(project);
+            this.update({
+                saveState: 'CONFLICT',
+                saveMessage: 'Human edits preempted an incoming agent project revision',
+                agentActivity: 'PAUSED',
+            });
+            throw new CrowdyStudioRevisionConflictError('Human edits preempted the agent project synchronization', project);
+        }
+        this.clearSaveTimers();
+        const clone = cloneCrowdyStudioProject(project);
+        this.editGeneration = 0;
+        this.persistedGeneration = 0;
+        this.conflictRemote = null;
+        const openFiles = this.state.openFiles.filter((ref) => fileRefExists(clone, this.state, ref));
+        const activeFile = this.state.activeFile &&
+            openFiles.some((ref) => sameFileRef(ref, this.state.activeFile))
+            ? this.state.activeFile
+            : openFiles.at(-1) ?? null;
+        const checkpoint = synchronization.checkpoint;
+        this.update({
+            project: clone,
+            projects: upsertSummary(this.state.projects, summaryOf(clone)),
+            openFiles,
+            activeFile,
+            saveState: 'SAVED',
+            saveMessage: undefined,
+            checkpoints: checkpoint
+                ? upsertCheckpoint(this.state.checkpoints, checkpoint)
+                : this.state.checkpoints,
+            runtimeSync: {
+                ...this.state.runtimeSync,
+                savedRevisionId: clone.revision.id,
+                state: this.state.runtimeSync.state === 'RUNNING_SAVED' ||
+                    this.state.runtimeSync.state === 'RUNNING_STALE'
+                    ? this.state.runtimeSync.runningRevisionId === clone.revision.id
+                        ? 'RUNNING_SAVED'
+                        : 'RUNNING_STALE'
+                    : this.state.runtimeSync.state,
+            },
+        });
+        this.options.onProjectSynchronized?.(cloneCrowdyStudioProject(clone), synchronization);
+    }
+    async restoreCheckpoint(checkpointId, approvalGrant, expectedRevisionId = this.requireProject().revision.id) {
+        if (approvalGrant.trim().length < 8) {
+            throw new Error('Checkpoint restore requires an opaque exact approval grant');
+        }
+        if (!(await this.saveNow())) {
+            throw new Error('Resolve the current project save before restoring a checkpoint');
+        }
+        const current = cloneCrowdyStudioProject(this.requireProject());
+        if (current.revision.id !== expectedRevisionId) {
+            throw new CrowdyStudioRevisionConflictError(`Expected revision ${expectedRevisionId}, found ${current.revision.id}`, current);
+        }
+        let restoredProject;
+        let preRestoreCheckpoint;
+        if (!this.options.synchronizationProvider) {
+            throw new Error('Checkpoint restore requires a durable synchronization provider');
+        }
+        const restored = await this.options.synchronizationProvider.restoreCheckpoint({
+            ...this.scope(),
+            projectId: current.projectId,
+            checkpointId,
+            expectedRevisionId,
+            approvalGrant,
+        });
+        restoredProject = restored.project;
+        preRestoreCheckpoint = restored.preRestoreCheckpoint;
+        if (restoredProject.projectId !== current.projectId ||
+            restoredProject.revision.id === current.revision.id ||
+            preRestoreCheckpoint.projectRevisionId !== current.revision.id) {
+            throw new Error('Checkpoint restore returned invalid synchronization metadata');
+        }
+        this.synchronizeProject(restoredProject, {
+            source: 'AGENT',
+            expectedPreviousRevisionId: expectedRevisionId,
+            checkpoint: preRestoreCheckpoint,
+        });
+        return preRestoreCheckpoint;
+    }
+    async testDraft(agentOperation) {
+        return this.deployProject(true, agentOperation);
     }
-    async deployLive() {
-        await this.deployProject(false);
+    async testDraftPlan(plan, agentOperation) {
+        return this.deployProject(true, agentOperation, plan);
     }
-    async deployProject(draft) {
+    async deployLive(agentOperation) {
+        return this.deployProject(false, agentOperation);
+    }
+    async deployLivePlan(plan, agentOperation) {
+        return this.deployProject(false, agentOperation, plan);
+    }
+    async deployProject(draft, agentOperation, plan) {
+        this.checkAgentOperation(agentOperation);
         this.requireProject();
         if (!(await this.saveNow())) {
             this.setRuntime('ERROR', 'Project must be saved before it can be built');
-            return;
+            return {
+                deployment: draft ? 'DRAFT' : 'LIVE',
+                status: 'FAILED',
+                projectRevisionId: this.requireProject().revision.id,
+                targets: projectTargets(this.requireProject().kind),
+                message: 'Project must be saved before it can be built',
+            };
         }
+        this.checkAgentOperation(agentOperation);
         const project = this.requireProject();
+        if (plan)
+            this.assertDeploymentPlan(project, plan, draft);
+        const targets = plan ? [...plan.targets] : projectTargets(project.kind);
         const operation = ++this.operationGeneration;
         this.stopSurfacePolling();
         this.update({
@@ -373,12 +623,18 @@ export class CrowdyStudioController {
             authoritativeDiagnostics: [],
         });
         try {
-            const targets = projectTargets(project.kind);
             if (targets.length === 1) {
                 const target = targets[0];
                 const compiled = await this.compileTarget(project, target, draft, operation);
-                if (!compiled)
-                    return;
+                if (!compiled) {
+                    return {
+                        deployment: draft ? 'DRAFT' : 'LIVE',
+                        status: 'COMPILE_FAILED',
+                        projectRevisionId: project.revision.id,
+                        targets,
+                        message: this.state.runtime.message ?? 'Compilation failed',
+                    };
+                }
                 if (target === 'SERVER') {
                     await this.enableServer(compiled.name, operation);
                 }
@@ -390,11 +646,25 @@ export class CrowdyStudioController {
                 // Compile the client first so a client failure never publishes a new
                 // server version or alters the currently live pairing requirement.
                 const client = await this.compileTarget(project, 'CLIENT', draft, operation);
-                if (!client)
-                    return;
+                if (!client) {
+                    return {
+                        deployment: draft ? 'DRAFT' : 'LIVE',
+                        status: 'COMPILE_FAILED',
+                        projectRevisionId: project.revision.id,
+                        targets,
+                        message: this.state.runtime.message ?? 'Client compilation failed',
+                    };
+                }
                 const server = await this.compileTarget(project, 'SERVER', draft, operation);
-                if (!server)
-                    return;
+                if (!server) {
+                    return {
+                        deployment: draft ? 'DRAFT' : 'LIVE',
+                        status: 'COMPILE_FAILED',
+                        projectRevisionId: project.revision.id,
+                        targets,
+                        message: this.state.runtime.message ?? 'Server compilation failed',
+                    };
+                }
                 this.checkOperation(operation);
                 const requiredClientName = project.metadata.pairingPreference === 'REQUIRED'
                     ? client.name
@@ -413,13 +683,41 @@ export class CrowdyStudioController {
                     phase: 'RUNNING',
                     message: draft ? 'Draft test is running' : 'Project is live',
                 },
+                runtimeSync: {
+                    state: 'RUNNING_SAVED',
+                    savedRevisionId: project.revision.id,
+                    runningRevisionId: project.revision.id,
+                    deployment: draft ? 'DRAFT' : 'LIVE',
+                    startedAt: new Date().toISOString(),
+                },
             });
             await this.refreshSurface('usage').catch(() => { });
+            return {
+                deployment: draft ? 'DRAFT' : 'LIVE',
+                status: 'RUNNING',
+                projectRevisionId: project.revision.id,
+                targets,
+                message: draft ? 'Draft test is running' : 'Project is live',
+            };
         }
         catch (error) {
-            if (error instanceof OperationCancelledError)
-                return;
+            if (error instanceof OperationCancelledError) {
+                return {
+                    deployment: draft ? 'DRAFT' : 'LIVE',
+                    status: 'FAILED',
+                    projectRevisionId: project.revision.id,
+                    targets,
+                    message: 'Deployment was cancelled',
+                };
+            }
             this.setRuntime('ERROR', errorMessage(error));
+            return {
+                deployment: draft ? 'DRAFT' : 'LIVE',
+                status: 'FAILED',
+                projectRevisionId: project.revision.id,
+                targets,
+                message: errorMessage(error),
+            };
         }
         finally {
             if (operation === this.operationGeneration) {
@@ -591,10 +889,15 @@ export class CrowdyStudioController {
                     phase: 'PARTIAL_FAILURE',
                     message: failures.join(' · '),
                 },
+            runtimeSync: {
+                ...this.state.runtimeSync,
+                state: 'STOPPED',
+            },
         });
         return result;
     }
-    async invoke(exportName, paramsJson) {
+    async invoke(exportName, paramsJson, agentOperation) {
+        this.checkAgentOperation(agentOperation);
         const project = this.requireProject();
         if (!projectTargets(project.kind).includes('SERVER')) {
             throw new Error('Invoke requires a SERVER target');
@@ -605,6 +908,7 @@ export class CrowdyStudioController {
             exportName: exportName.trim() || 'invoke',
             paramsJson: paramsJson?.trim() || null,
         });
+        this.checkAgentOperation(agentOperation);
         this.update({ invokeResult: result });
         return result;
     }
@@ -671,6 +975,7 @@ export class CrowdyStudioController {
         this.broker?.stop();
         this.broker = null;
         this.listeners.clear();
+        this.humanEditListeners.clear();
     }
     async performSaveLoop() {
         while (this.persistedGeneration !== this.editGeneration) {
@@ -701,6 +1006,16 @@ export class CrowdyStudioController {
                     projects: upsertSummary(this.state.projects, summaryOf(saved)),
                     saveState: this.persistedGeneration === this.editGeneration ? 'SAVED' : 'SAVING',
                     saveMessage: undefined,
+                    runtimeSync: {
+                        ...this.state.runtimeSync,
+                        savedRevisionId: saved.revision.id,
+                        state: this.state.runtimeSync.state === 'RUNNING_SAVED' ||
+                            this.state.runtimeSync.state === 'RUNNING_STALE'
+                            ? this.state.runtimeSync.runningRevisionId === saved.revision.id
+                                ? 'RUNNING_SAVED'
+                                : 'RUNNING_STALE'
+                            : this.state.runtimeSync.state,
+                    },
                 });
             }
             catch (error) {
@@ -723,8 +1038,19 @@ export class CrowdyStudioController {
         return true;
     }
     markEdited() {
+        for (const listener of this.humanEditListeners)
+            listener();
         this.editGeneration++;
-        this.update({ saveState: 'SAVING', saveMessage: undefined });
+        this.update({
+            saveState: 'SAVING',
+            saveMessage: undefined,
+            agentActivity: this.state.agentActivity === 'WORKING'
+                ? 'PAUSED'
+                : this.state.agentActivity,
+            runtimeSync: this.state.runtimeSync.state === 'RUNNING_SAVED'
+                ? { ...this.state.runtimeSync, state: 'RUNNING_STALE' }
+                : this.state.runtimeSync,
+        });
         this.clearTimer('autosave');
         this.autosaveTimer = setTimeout(() => {
             this.autosaveTimer = null;
@@ -797,11 +1123,41 @@ export class CrowdyStudioController {
             onHostCall: this.options.onHostCall,
         };
     }
+    assertDeploymentPlan(project, plan, draft) {
+        if (project.revision.id !== plan.expectedRevisionId) {
+            throw new CrowdyStudioRevisionConflictError(`Expected revision ${plan.expectedRevisionId}, found ${project.revision.id}`, project);
+        }
+        const authoritativeTargets = [...projectTargets(project.kind)].sort();
+        const requestedTargets = [...new Set(plan.targets)].sort();
+        if (requestedTargets.length !== authoritativeTargets.length ||
+            requestedTargets.some((target, index) => target !== authoritativeTargets[index])) {
+            throw new Error(`Deployment targets must exactly match ${authoritativeTargets.join(', ')}`);
+        }
+        if (plan.pairingPreference !== undefined &&
+            plan.pairingPreference !== project.metadata.pairingPreference) {
+            throw new Error('Deployment pairing preference changed after approval');
+        }
+        if (plan.projectContentHash !== undefined &&
+            plan.projectContentHash !== projectContentHash(project)) {
+            throw new Error('Deployment project content changed after approval');
+        }
+        if (!draft &&
+            (plan.pairingPreference === undefined ||
+                plan.projectContentHash === undefined)) {
+            throw new Error('Live deployment requires exact pairing and project content bindings');
+        }
+    }
     checkOperation(generation) {
         if (generation !== this.operationGeneration || this.destroyed) {
             throw new OperationCancelledError();
         }
     }
+    checkAgentOperation(generation) {
+        if (generation !== undefined &&
+            (generation !== this.agentOperationGeneration || this.destroyed)) {
+            throw new OperationCancelledError();
+        }
+    }
     sleep(ms) {
         return (this.options.sleep ??
             ((delay) => new Promise((resolve) => setTimeout(resolve, delay))))(ms);
@@ -910,6 +1266,83 @@ function normalizeUsage(value) {
         gateReason: value.gateReason ?? null,
     };
 }
+function applyValidatedPatch(baseline, input) {
+    if (input.changes.length < 1 || input.changes.length > 16) {
+        throw new Error('Atomic patch must contain 1 to 16 file changes');
+    }
+    const next = cloneCrowdyStudioProject(baseline);
+    const seen = new Set();
+    for (const change of input.changes) {
+        const path = normalizeCrowdyStudioPath(change.path);
+        const key = crowdyStudioFileKey(change.target, path);
+        if (seen.has(key))
+            throw new Error(`Atomic patch repeats ${key}`);
+        seen.add(key);
+        if (!projectTargets(next.kind).includes(change.target)) {
+            throw new Error(`${next.kind} projects do not have a ${change.target} target`);
+        }
+        const bytes = new TextEncoder().encode(change.content).byteLength;
+        if (bytes > 65536)
+            throw new Error(`${key} exceeds the 65536-byte file limit`);
+        const index = next.files.findIndex((file) => file.target === change.target && file.path === path);
+        if (change.operation === 'CREATE') {
+            if (change.expectedContentHash !== 'ABSENT' || index >= 0) {
+                throw new CrowdyStudioRevisionConflictError(`${key} was expected to be absent`, baseline);
+            }
+            next.files.push({ target: change.target, path, content: change.content });
+            continue;
+        }
+        if (index < 0) {
+            throw new CrowdyStudioRevisionConflictError(`${key} no longer exists`, baseline);
+        }
+        const currentHash = sha256Digest(next.files[index].content);
+        if (change.expectedContentHash !== currentHash) {
+            throw new CrowdyStudioRevisionConflictError(`${key} content hash changed`, baseline);
+        }
+        next.files[index] = {
+            target: change.target,
+            path,
+            content: change.content,
+        };
+    }
+    if (next.files.length > 128) {
+        throw new Error('Project exceeds the 128-file limit');
+    }
+    next.files.sort(compareProjectFile);
+    return next;
+}
+function projectContentHash(project) {
+    return digestCanonicalJson({
+        contract: 'crowdy.studio-project-content/1',
+        projectId: project.projectId,
+        metadata: project.metadata,
+        files: project.files
+            .map((file) => ({
+            target: file.target,
+            path: file.path,
+            contentHash: sha256Digest(file.content),
+        }))
+            .sort((left, right) => crowdyStudioFileKey(left.target, left.path).localeCompare(crowdyStudioFileKey(right.target, right.path))),
+    });
+}
+function upsertCheckpoint(checkpoints, checkpoint) {
+    return [
+        checkpoint,
+        ...checkpoints.filter((entry) => entry.checkpointId !== checkpoint.checkpointId),
+    ];
+}
+function fileRefExists(project, state, ref) {
+    if (ref.source === 'PROJECT') {
+        return project.files.some((file) => file.target === ref.target &&
+            file.path === normalizeCrowdyStudioPath(ref.path));
+    }
+    const references = ref.source === 'PERSONAL_LIBRARY'
+        ? state.personalLibraryFiles
+        : state.commonFiles;
+    return references.some((file) => ref.referenceId
+        ? file.id === ref.referenceId
+        : file.target === ref.target && file.path === ref.path);
+}
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/dist/crowdy-studio/dom-shell.d.ts

@@ -1,4 +1,6 @@
 import { type CrowdyStudioController, type CrowdyStudioState } from './controller.js';
+import type { CrowdyStudioAgentController } from '../crowdy-agent/controller.js';
+import { type CrowdyStudioAgentDomShellOptions } from './agent-dom-shell.js';
 /** Modular DOM shell; editor implementations mount into `editorHost`. */
 export declare class CrowdyStudioDomShell {
     private readonly controller;
@@ -32,9 +34,10 @@ export declare class CrowdyStudioDomShell {
     private readonly invokeResult;
     private readonly panelButtons;
     private readonly panels;
+    private readonly agentShell;
     private activePanel;
     private disposed;
-    constructor(host: HTMLElement, controller: CrowdyStudioController);
+    constructor(host: HTMLElement, controller: CrowdyStudioController, agentController?: CrowdyStudioAgentController, agentOptions?: CrowdyStudioAgentDomShellOptions);
     render(state: CrowdyStudioState): void;
     dispose(): void;
     private createPanel;

package/dist/crowdy-studio/dom-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom-shell.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/dom-shell.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAYzB,yEAAyE;AACzE,qBAAa,oBAAoB;IAoC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAnC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAS;gBAGvB,IAAI,EAAE,WAAW,EACA,UAAU,EAAE,sBAAsB;IAoMrD,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IA+BtC,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,cAAc;IAkDtB,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,iBAAiB;YAgBX,GAAG;CAQlB"}
+{"version":3,"file":"dom-shell.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/dom-shell.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,sBAAsB,CAAC;AAY9B,yEAAyE;AACzE,qBAAa,oBAAoB;IAqC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IApC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAS;gBAGvB,IAAI,EAAE,WAAW,EACA,UAAU,EAAE,sBAAsB,EACnD,eAAe,CAAC,EAAE,2BAA2B,EAC7C,YAAY,GAAE,gCAAqC;IA2MrD,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IA+BtC,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,cAAc;IAkDtB,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,iBAAiB;YAgBX,GAAG;CAQlB"}

package/dist/crowdy-studio/dom-shell.js

@@ -1,8 +1,9 @@
+import { CrowdyStudioAgentDomShell, } from './agent-dom-shell.js';
 import { projectTargets, } from './models.js';
 import { CROWDY_STUDIO_STYLES } from './styles.js';
 /** Modular DOM shell; editor implementations mount into `editorHost`. */
 export class CrowdyStudioDomShell {
-    constructor(host, controller) {
+    constructor(host, controller, agentController, agentOptions = {}) {
         this.controller = controller;
         this.panelButtons = new Map();
         this.panels = new Map();
@@ -99,6 +100,9 @@ export class CrowdyStudioDomShell {
         this.invokePanel.append(invokeControls, this.invokeResult);
         this.root.append(toolbar, this.newForm, main, bottom);
         host.appendChild(this.root);
+        this.agentShell = agentController
+            ? new CrowdyStudioAgentDomShell(this.root, agentController, agentOptions)
+            : null;
         newButton.addEventListener('click', () => {
             this.newForm.dataset.open =
                 this.newForm.dataset.open === 'true' ? 'false' : 'true';
@@ -184,6 +188,7 @@ export class CrowdyStudioDomShell {
         this.controller.setSurfaceVisible('usage', false);
         this.controller.setSurfaceVisible('logs', false);
         this.controller.setSurfaceVisible('runs', false);
+        this.agentShell?.dispose();
         this.root.remove();
     }
     createPanel(name, label, tabs) {