@crowdedkingdoms/crowdyjs 15.12.1 → 16.0.0-dev.1

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

@@ -1,418 +0,0 @@
-const PLAY_SCOPES = [
-    'observe',
-    'locomotion',
-    'interact',
-    'craft',
-    'combat',
-    'communicate',
-    'travel',
-];
-/**
- * Accessible, text-only rendering for the integrated durable agent dock.
- *
- * The conversation is the primary surface. Play-control, activity, and
- * change-tracking sections are collapsible disclosures so the dock stays
- * minimal, with one deliberate exception: pending exact approvals and the
- * active Play lease countdown always render prominently.
- */
-export class CrowdyStudioAgentDomShell {
-    constructor(host, controller, options = {}) {
-        this.controller = controller;
-        this.options = options;
-        this.modeButtons = new Map();
-        this.scopeInputs = new Map();
-        this.lastPendingApprovals = 0;
-        this.lastPlayLeaseActive = false;
-        this.disposed = false;
-        this.lastState = controller.getState();
-        this.root = document.createElement('aside');
-        this.root.className = 'ck-crowdy-studio-agent-dock';
-        this.root.setAttribute('aria-label', 'Crowdy Studio agent');
-        const header = document.createElement('header');
-        const title = document.createElement('h2');
-        title.textContent = 'Crowdy Agent';
-        this.status = document.createElement('span');
-        this.status.className = 'ck-crowdy-studio-agent-status';
-        this.status.setAttribute('role', 'status');
-        this.status.setAttribute('aria-live', 'polite');
-        header.append(title, this.status);
-        const controlsRow = document.createElement('div');
-        controlsRow.className = 'ck-crowdy-studio-agent-controls-row';
-        const modeGroup = document.createElement('div');
-        modeGroup.className = 'ck-crowdy-studio-agent-modes';
-        modeGroup.setAttribute('role', 'group');
-        modeGroup.setAttribute('aria-label', 'Agent mode');
-        for (const mode of ['ASK', 'BUILD', 'PLAY']) {
-            const control = button(titleCase(mode));
-            control.addEventListener('click', () => {
-                void this.run(() => this.controller.setMode(mode));
-            });
-            control.setAttribute('aria-pressed', 'false');
-            this.modeButtons.set(mode, control);
-            modeGroup.append(control);
-        }
-        const controls = document.createElement('div');
-        controls.className = 'ck-crowdy-studio-agent-controls';
-        const pause = button('Pause');
-        pause.addEventListener('click', () => void this.run(() => this.controller.pause()));
-        const resume = button('Resume');
-        resume.addEventListener('click', () => void this.run(() => this.controller.resume()));
-        const stop = button('Stop');
-        stop.className = 'ck-crowdy-studio-agent-stop';
-        stop.addEventListener('click', () => void this.run(() => this.controller.stop()));
-        controls.append(pause, resume, stop);
-        controlsRow.append(modeGroup, controls);
-        // Safety surfaces: approvals and the active Play lease stay prominent and
-        // are never hidden behind a disclosure.
-        this.approvals = document.createElement('section');
-        this.approvals.className = 'ck-crowdy-studio-agent-approvals';
-        this.approvals.setAttribute('aria-label', 'Pending exact approvals');
-        this.lease = document.createElement('div');
-        this.lease.className = 'ck-crowdy-studio-agent-lease';
-        this.lease.setAttribute('role', 'status');
-        this.lease.setAttribute('aria-label', 'Agent control lease');
-        this.messages = document.createElement('div');
-        this.messages.className = 'ck-crowdy-studio-agent-messages';
-        this.messages.setAttribute('role', 'log');
-        this.messages.setAttribute('aria-live', 'polite');
-        this.messages.setAttribute('aria-relevant', 'additions text');
-        this.stream = document.createElement('div');
-        this.stream.className = 'ck-crowdy-studio-agent-stream';
-        this.stream.setAttribute('aria-label', 'Streaming assistant response');
-        this.messages.append(this.stream);
-        const form = document.createElement('form');
-        form.className = 'ck-crowdy-studio-agent-composer';
-        this.composer = document.createElement('textarea');
-        this.composer.maxLength = 32768;
-        this.composer.rows = 3;
-        this.composer.placeholder = 'Ask, build, or play…';
-        this.composer.setAttribute('aria-label', 'Message Crowdy Agent');
-        this.send = button('Send', 'submit');
-        form.append(this.composer, this.send);
-        form.addEventListener('submit', (event) => {
-            event.preventDefault();
-            const content = this.composer.value;
-            if (!content.trim())
-                return;
-            void this.run(async () => {
-                await this.controller.sendMessage(content);
-                this.composer.value = '';
-            });
-        });
-        this.composer.addEventListener('keydown', (event) => {
-            if (event.key === 'Enter' && (event.metaKey || event.ctrlKey)) {
-                event.preventDefault();
-                form.requestSubmit();
-            }
-        });
-        // Collapsible secondary sections.
-        const playBody = document.createElement('div');
-        const leaseControls = document.createElement('fieldset');
-        leaseControls.className = 'ck-crowdy-studio-agent-lease-controls';
-        const leaseLegend = document.createElement('legend');
-        leaseLegend.textContent = 'Play lease scopes';
-        leaseControls.append(leaseLegend);
-        for (const scope of PLAY_SCOPES) {
-            const label = document.createElement('label');
-            const input = document.createElement('input');
-            input.type = 'checkbox';
-            input.value = scope;
-            input.checked = scope === 'observe';
-            this.scopeInputs.set(scope, input);
-            const text = document.createElement('span');
-            text.textContent = scope.replace('_', ' ');
-            label.append(input, text);
-            leaseControls.append(label);
-        }
-        const grant = button('Grant 60 second Play lease');
-        grant.addEventListener('click', () => {
-            const context = this.options.getPlayLeaseContext?.();
-            if (!context) {
-                this.status.textContent =
-                    'The game host must advertise a controlled entity before Play.';
-                return;
-            }
-            const scopes = [...this.scopeInputs]
-                .filter(([, input]) => input.checked)
-                .map(([scope]) => scope);
-            void this.run(() => this.controller.grantPlayLease({
-                scopes,
-                durationSeconds: 60,
-                ...context,
-            }));
-        });
-        leaseControls.append(grant);
-        playBody.append(leaseControls);
-        [this.playDisclosure, this.playSummary] = disclosure('Play control', playBody);
-        this.timeline = document.createElement('ol');
-        this.timeline.className = 'ck-crowdy-studio-agent-timeline';
-        this.timeline.setAttribute('aria-label', 'Agent plan and tool timeline');
-        [this.activityDisclosure, this.activitySummary] = disclosure('Activity', this.timeline);
-        this.checkpoints = document.createElement('section');
-        this.checkpoints.className = 'ck-crowdy-studio-agent-checkpoints';
-        this.checkpoints.setAttribute('aria-label', 'Agent diffs and checkpoints');
-        [this.changesDisclosure, this.changesSummary] = disclosure('Changes', this.checkpoints);
-        this.budget = document.createElement('div');
-        this.budget.className = 'ck-crowdy-studio-agent-budget';
-        this.budget.setAttribute('aria-label', 'Agent budget');
-        this.root.append(header, controlsRow, this.approvals, this.lease, this.messages, form, this.playDisclosure, this.activityDisclosure, this.changesDisclosure, this.budget);
-        host.dataset.agent = 'true';
-        host.append(this.root);
-        this.unsubscribe = controller.subscribe((state) => this.render(state));
-        this.countdownTimer = setInterval(() => this.renderLease(this.lastState), 1000);
-        this.render(this.lastState);
-    }
-    render(state) {
-        if (this.disposed)
-            return;
-        this.lastState = state;
-        this.status.textContent = state.lastError
-            ? `${state.connection} · ${state.lastError.code}: ${state.lastError.message}`
-            : state.reconnectRequired
-                ? `${state.connection} · explicit resume required`
-                : state.connection;
-        const mode = state.session?.mode;
-        for (const [candidate, control] of this.modeButtons) {
-            control.setAttribute('aria-pressed', String(candidate === mode));
-            control.dataset.active = String(candidate === mode);
-            control.disabled = state.connection !== 'CONNECTED';
-        }
-        this.send.disabled =
-            state.connection !== 'CONNECTED' ||
-                state.session?.status !== 'ACTIVE';
-        this.renderBudget(state);
-        this.renderLease(state);
-        this.renderMessages(state);
-        this.renderTimeline(state);
-        this.renderApprovals(state);
-        this.renderCheckpoints(state);
-        this.autoReveal(state);
-    }
-    dispose() {
-        if (this.disposed)
-            return;
-        this.disposed = true;
-        clearInterval(this.countdownTimer);
-        this.unsubscribe();
-        this.root.remove();
-    }
-    /**
-     * Safety-critical auto-reveal: a newly pending exact approval or a Play
-     * lease activation opens the dock and the Play disclosure so the human is
-     * always shown what needs their decision or is acting on their behalf.
-     */
-    autoReveal(state) {
-        const pending = state.approvals.filter((approval) => approval.status === 'PENDING').length;
-        const playLeaseActive = state.leases.some((lease) => lease.kind === 'PLAY' && lease.status === 'ACTIVE');
-        if (pending > this.lastPendingApprovals) {
-            this.options.layout?.setVisible('agent', true);
-        }
-        if (playLeaseActive && !this.lastPlayLeaseActive) {
-            this.options.layout?.setVisible('agent', true);
-            this.playDisclosure.open = true;
-        }
-        if (state.session?.mode === 'PLAY' && !playLeaseActive) {
-            this.playDisclosure.open = true;
-        }
-        this.lastPendingApprovals = pending;
-        this.lastPlayLeaseActive = playLeaseActive;
-    }
-    renderBudget(state) {
-        if (!state.budget) {
-            this.budget.textContent = 'Budget unavailable';
-            return;
-        }
-        const dimensions = state.budget.dimensions.map((dimension) => `${dimension.name.toLowerCase().replace(/_/gu, ' ')} ${dimension.consumed}/${dimension.limit} ${dimension.unit}`);
-        this.budget.textContent = [
-            state.budget.platformFunded ? 'Platform-funded pilot' : state.budget.payer,
-            ...dimensions,
-        ].join(' · ');
-    }
-    renderLease(state) {
-        const lease = state.leases.find((entry) => entry.kind === 'PLAY' && entry.status === 'ACTIVE');
-        if (!lease) {
-            this.lease.textContent = 'No active Play lease';
-            this.lease.dataset.active = 'false';
-            this.playSummary.textContent = 'Play control';
-            return;
-        }
-        const remaining = Math.max(0, Math.ceil((Date.parse(lease.expiresAt) - Date.now()) / 1000));
-        this.lease.dataset.active = 'true';
-        this.lease.textContent = [
-            `Play lease: ${remaining}s`,
-            `holder ${lease.holder}`,
-            `entity ${lease.controlledEntityId ?? 'none'}`,
-            `scopes ${lease.scopes.join(', ')}`,
-        ].join(' · ');
-        this.playSummary.textContent = `Play control · lease ${remaining}s`;
-    }
-    renderMessages(state) {
-        const rows = state.messages.map((message) => {
-            const article = document.createElement('article');
-            article.className = 'ck-crowdy-studio-agent-message';
-            article.dataset.role = message.role;
-            const author = document.createElement('strong');
-            author.textContent = message.role === 'USER' ? 'You' : 'Crowdy Agent';
-            const content = document.createElement('p');
-            content.textContent = message.content;
-            article.append(author, content);
-            return article;
-        });
-        this.messages.replaceChildren(...rows, this.stream);
-        this.stream.textContent = state.streamingText;
-        this.stream.hidden = state.streamingText.length === 0;
-    }
-    renderTimeline(state) {
-        const runItems = state.events
-            .filter((event) => event.type.startsWith('RUN_'))
-            .map((event) => {
-            const item = document.createElement('li');
-            item.dataset.status = event.type;
-            const title = document.createElement('strong');
-            title.textContent = event.type.replace(/_/gu, ' ').toLowerCase();
-            const timestamp = document.createElement('span');
-            timestamp.textContent = event.createdAt;
-            item.append(title, timestamp);
-            const payload = event.payload;
-            if (payload.code || payload.reason || payload.error) {
-                const detail = document.createElement('p');
-                detail.textContent = [
-                    payload.code,
-                    payload.reason,
-                    payload.error
-                        ? `${payload.error.code}: ${payload.error.message}`
-                        : '',
-                ]
-                    .filter(Boolean)
-                    .join(' · ');
-                item.append(detail);
-            }
-            return item;
-        });
-        const toolItems = state.tools.map((tool) => {
-            const item = document.createElement('li');
-            item.dataset.status = tool.status;
-            const title = document.createElement('strong');
-            title.textContent = `${tool.name} ${tool.version}`;
-            const status = document.createElement('span');
-            status.textContent = tool.status.replace(/_/gu, ' ').toLowerCase();
-            item.append(title, status);
-            if (tool.safeSummary) {
-                const summary = document.createElement('p');
-                summary.textContent = tool.safeSummary;
-                item.append(summary);
-            }
-            if (tool.error) {
-                const error = document.createElement('p');
-                error.textContent = `${tool.error.code}: ${tool.error.message}`;
-                item.append(error);
-            }
-            return item;
-        });
-        const items = [...runItems, ...toolItems];
-        this.timeline.replaceChildren(...items);
-        this.activitySummary.textContent =
-            items.length > 0 ? `Activity (${items.length})` : 'Activity';
-        if (items.length === 0) {
-            const empty = document.createElement('li');
-            empty.textContent = 'No tool activity.';
-            this.timeline.append(empty);
-        }
-    }
-    renderApprovals(state) {
-        const pending = state.approvals.filter((approval) => approval.status === 'PENDING');
-        const cards = pending.map((approval) => {
-            const card = document.createElement('article');
-            card.className = 'ck-crowdy-studio-agent-approval';
-            const tool = state.tools.find((entry) => entry.toolCallId === approval.toolCallId);
-            const title = heading(tool
-                ? `Exact approval: ${tool.name} ${tool.version}`
-                : 'Exact approval required', 3);
-            const summary = document.createElement('p');
-            summary.textContent = `Server-verified execution plan: ${approval.safeSummary}`;
-            const call = document.createElement('p');
-            call.textContent = `Tool call ${approval.toolCallId}`;
-            const reasons = document.createElement('p');
-            reasons.textContent = approval.reasons.join(' · ');
-            const hash = document.createElement('code');
-            hash.textContent = approval.argumentHash;
-            const expiry = document.createElement('p');
-            expiry.textContent = `Expires ${approval.expiresAt}`;
-            const actions = document.createElement('div');
-            const approve = button('Approve exact call');
-            approve.addEventListener('click', () => void this.run(() => this.controller.approveTool(approval.toolCallId, approval.argumentHash)));
-            const deny = button('Deny');
-            deny.addEventListener('click', () => void this.run(() => this.controller.rejectTool(approval.toolCallId)));
-            actions.append(approve, deny);
-            card.append(title, call, summary, reasons, hash, expiry, actions);
-            return card;
-        });
-        this.approvals.replaceChildren(...cards);
-        this.approvals.hidden = cards.length === 0;
-    }
-    renderCheckpoints(state) {
-        const diffTools = state.tools.filter((tool) => tool.name === 'workspace.file.patch' ||
-            tool.name === 'workspace.conflict.resolve');
-        const cards = diffTools.map((tool) => {
-            const card = document.createElement('article');
-            card.className = 'ck-crowdy-studio-agent-diff';
-            const title = heading('Project diff', 3);
-            const summary = document.createElement('p');
-            summary.textContent =
-                tool.safeSummary ?? `${tool.name} · ${tool.status.toLowerCase()}`;
-            card.append(title, summary);
-            return card;
-        });
-        for (const checkpoint of state.checkpoints) {
-            const card = document.createElement('article');
-            card.className = 'ck-crowdy-studio-agent-checkpoint';
-            const title = heading('Checkpoint', 3);
-            const detail = document.createElement('p');
-            detail.textContent = `${checkpoint.checkpointId} · revision ${checkpoint.projectRevision} · ${checkpoint.reason.toLowerCase().replace(/_/gu, ' ')}`;
-            const restore = button('Restore checkpoint');
-            restore.addEventListener('click', () => void this.run(() => this.controller.restoreCheckpoint(checkpoint.checkpointId)));
-            card.append(title, detail, restore);
-            cards.push(card);
-        }
-        this.checkpoints.replaceChildren(...cards);
-        this.changesSummary.textContent =
-            cards.length > 0 ? `Changes (${cards.length})` : 'Changes';
-        if (cards.length === 0) {
-            const none = document.createElement('p');
-            none.className = 'ck-crowdy-studio-empty';
-            none.textContent = 'No agent edits or checkpoints yet.';
-            this.checkpoints.append(none);
-        }
-    }
-    async run(operation) {
-        try {
-            await operation();
-        }
-        catch (error) {
-            this.status.textContent =
-                error instanceof Error ? error.message : 'Agent action failed';
-        }
-    }
-}
-function disclosure(label, body) {
-    const details = document.createElement('details');
-    details.className = 'ck-crowdy-studio-agent-disclosure';
-    const summary = document.createElement('summary');
-    summary.textContent = label;
-    details.append(summary, body);
-    return [details, summary];
-}
-function button(label, type = 'button') {
-    const control = document.createElement('button');
-    control.type = type;
-    control.textContent = label;
-    return control;
-}
-function heading(text, level = 2) {
-    const value = document.createElement(`h${level}`);
-    value.textContent = text;
-    return value;
-}
-function titleCase(value) {
-    return `${value[0]}${value.slice(1).toLowerCase()}`;
-}

package/dist/player-host/control-banner.d.ts

@@ -1,40 +0,0 @@
-import type { CrowdyStudioAgentStateV1 } from '../crowdy-agent/controller.js';
-import type { PlayerControlGate } from './control-gate.js';
-export interface AgentControlBannerController {
-    getState(): CrowdyStudioAgentStateV1;
-    subscribe(listener: (state: CrowdyStudioAgentStateV1) => void): () => void;
-}
-/**
- * Always-visible-on-control safety surface outside the Studio dock. Text,
- * status, Pause, and Stop remain keyboard/screen-reader accessible over the
- * game canvas; Stop clears locally before any transport promise is attempted.
- */
-export declare class AgentControlBanner {
-    private readonly gate;
-    readonly root: HTMLElement;
-    private readonly summary;
-    private readonly expiry;
-    private readonly pauseButton;
-    private readonly stopButton;
-    private controller;
-    private agentState;
-    private gateState;
-    private unsubscribeAgent;
-    private unsubscribeGate;
-    private readonly countdown;
-    constructor(parent: HTMLElement, gate: PlayerControlGate);
-    bind(controller: AgentControlBannerController): () => void;
-    showUnavailable(message: string): void;
-    unbind(): void;
-    destroy(): void;
-    private render;
-}
-export declare function ensureAgentControlBannerStyles(doc?: Document | null): void;
-/**
- * Injected presentation for the visible lease safety surface. Games that
- * dock a studio can set `--ck-game-right-inset` on `document.body` so the
- * banner keeps clear of the dock (the Crowdy Studio embed kit does this
- * automatically).
- */
-export declare const AGENT_CONTROL_BANNER_STYLES = "\n.ck-agent-control-banner {\n  position: fixed;\n  top: 12px;\n  right: calc(12px + var(--ck-game-right-inset, 0px));\n  z-index: 65;\n  display: grid;\n  grid-template-columns: auto minmax(180px, 1fr) auto auto;\n  align-items: center;\n  gap: 10px;\n  max-width: min(760px, calc(100vw - var(--ck-game-right-inset, 0px) - 24px));\n  padding: 9px 10px;\n  border: 1px solid rgba(110, 231, 183, 0.65);\n  border-radius: 10px;\n  color: #ecfdf5;\n  background: rgba(2, 44, 34, 0.94);\n  box-shadow: 0 12px 30px rgba(2, 6, 23, 0.45);\n  pointer-events: auto;\n}\n\n.ck-agent-control-banner[hidden] {\n  display: none;\n}\n\n.ck-agent-control-banner[data-state=\"unavailable\"] {\n  border-color: rgba(251, 191, 36, 0.65);\n  background: rgba(69, 26, 3, 0.94);\n}\n\n.ck-agent-control-summary,\n.ck-agent-control-expiry {\n  overflow: hidden;\n  color: #d1fae5;\n  font-size: 12px;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.ck-agent-control-expiry {\n  color: #a7f3d0;\n}\n\n.ck-agent-control-actions {\n  display: flex;\n  gap: 6px;\n}\n\n.ck-agent-control-actions button {\n  padding: 6px 9px;\n  border: 1px solid rgba(167, 243, 208, 0.5);\n  border-radius: 7px;\n  color: #ecfdf5;\n  background: rgba(6, 78, 59, 0.85);\n  cursor: pointer;\n}\n\n.ck-agent-control-actions .ck-agent-control-stop {\n  border-color: rgba(254, 202, 202, 0.75);\n  background: rgba(153, 27, 27, 0.9);\n}\n\n.ck-agent-control-actions button:focus-visible {\n  outline: 2px solid #fef3c7;\n  outline-offset: 2px;\n}\n\n@media (max-width: 900px) {\n  .ck-agent-control-banner {\n    right: 8px;\n    left: 8px;\n    grid-template-columns: auto minmax(0, 1fr) auto;\n    max-width: none;\n  }\n\n  .ck-agent-control-expiry {\n    display: none;\n  }\n}\n\n@media (max-width: 620px) {\n  .ck-agent-control-banner {\n    grid-template-columns: minmax(0, 1fr) auto;\n  }\n\n  .ck-agent-control-banner > strong {\n    display: none;\n  }\n}\n";
-//# sourceMappingURL=control-banner.d.ts.map

package/dist/player-host/control-banner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"control-banner.d.ts","sourceRoot":"","sources":["../../src/player-host/control-banner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,IAAI,wBAAwB,CAAC;IACrC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5E;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAe3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAdvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;gBAGzD,MAAM,EAAE,WAAW,EACF,IAAI,EAAE,iBAAiB;IAqC1C,IAAI,CAAC,UAAU,EAAE,4BAA4B,GAAG,MAAM,IAAI;IAc1D,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUtC,MAAM,IAAI,IAAI;IASd,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,MAAM;CAuDf;AA2BD,wBAAgB,8BAA8B,CAC5C,GAAG,GAAE,QAAQ,GAAG,IAAwD,GACvE,IAAI,CAMN;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,+4DAwFvC,CAAC"}