@pantheon-systems/puck-css 0.4.0

package/dist/agent/agentPlugin.d.ts

@@ -0,0 +1,3 @@
+import type { P1FeaturePlugin } from '../core/plugin-types.js';
+export declare const agentPlugin: P1FeaturePlugin;
+//# sourceMappingURL=agentPlugin.d.ts.map

package/dist/agent/agentPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPlugin.d.ts","sourceRoot":"","sources":["../../src/agent/agentPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAO,MAAM,WAAW,EAAE,eAIzB,CAAC"}

package/dist/agent/agentPlugin.js

@@ -0,0 +1,6 @@
+export const agentPlugin = {
+    name: 'agent',
+    featureFlags: ['agentModeEnabled'],
+    priority: 60,
+};
+//# sourceMappingURL=agentPlugin.js.map

package/dist/agent/agentPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPlugin.js","sourceRoot":"","sources":["../../src/agent/agentPlugin.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAoB;IAC1C,IAAI,EAAE,OAAO;IACb,YAAY,EAAE,CAAC,kBAAkB,CAAC;IAClC,QAAQ,EAAE,EAAE;CACb,CAAC"}

package/dist/agent/components/AgentActionButton.d.ts

@@ -0,0 +1,38 @@
+/**
+ * AgentActionButton Component
+ *
+ * Button that triggers a human-requested agent action.
+ * Shows loading state and handles errors.
+ */
+import React from 'react';
+import type { RegisteredAgent } from '@pantheon-systems/css-client';
+export interface AgentActionButtonProps {
+    /** Agent to trigger */
+    agent: RegisteredAgent;
+    /** Action to perform */
+    action: {
+        intent: string;
+        targetRegions: string[];
+        operationType?: string;
+    };
+    /** Button variant */
+    variant?: 'primary' | 'secondary' | 'ghost';
+    /** Button size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Children (button content) */
+    children: React.ReactNode;
+    /** Custom className */
+    className?: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Success callback */
+    onSuccess?: (checkpointId?: string) => void;
+    /** Error callback */
+    onError?: (error: string) => void;
+}
+/**
+ * Button that triggers a human-requested agent action.
+ * Shows loading state and handles errors.
+ */
+export declare function AgentActionButton({ agent, action, variant, size, children, className, disabled, onSuccess, onError, }: AgentActionButtonProps): React.JSX.Element;
+//# sourceMappingURL=AgentActionButton.d.ts.map

package/dist/agent/components/AgentActionButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentActionButton.d.ts","sourceRoot":"","sources":["../../../src/agent/components/AgentActionButton.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAgC,MAAM,OAAO,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,wBAAwB;IACxB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,qBAAqB;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5C,kBAAkB;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,qBAAqB;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,MAAM,EACN,OAAqB,EACrB,IAAW,EACX,QAAQ,EACR,SAAS,EACT,QAAgB,EAChB,SAAS,EACT,OAAO,GACR,EAAE,sBAAsB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2F5C"}

package/dist/agent/components/AgentActionButton.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * AgentActionButton Component
+ *
+ * Button that triggers a human-requested agent action.
+ * Shows loading state and handles errors.
+ */
+import { useState, useCallback } from 'react';
+import { usePresenceContext } from '../../core/PresenceContext.js';
+const baseClass = 'css-puck-agent-action-btn';
+/**
+ * Button that triggers a human-requested agent action.
+ * Shows loading state and handles errors.
+ */
+export function AgentActionButton({ agent, action, variant = 'secondary', size = 'md', children, className, disabled = false, onSuccess, onError, }) {
+    const context = usePresenceContext();
+    const [isLoading, setIsLoading] = useState(false);
+    const handleClick = useCallback(async () => {
+        if (isLoading || disabled || !context.documentPath) {
+            return;
+        }
+        setIsLoading(true);
+        try {
+            // Check if agent can edit
+            const permission = await context.client.agentEdit.canEdit(context.siteId, context.branchId, context.documentPath, {
+                agentId: agent.id,
+                trigger: 'human_requested',
+                intent: action.intent,
+                targetRegions: action.targetRegions,
+                requestedById: context.userId,
+            });
+            if (!permission.allowed) {
+                setIsLoading(false);
+                onError?.(permission.reason || 'Permission denied');
+                return;
+            }
+            // Start the edit session
+            const session = await context.client.agentEdit.startEdit(context.siteId, context.branchId, context.documentPath, {
+                agentId: agent.id,
+                trigger: 'human_requested',
+                intent: action.intent,
+                targetRegions: action.targetRegions,
+                requestedById: context.userId,
+            });
+            setIsLoading(false);
+            onSuccess?.(session.checkpointId);
+        }
+        catch (err) {
+            setIsLoading(false);
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            onError?.(errorMessage);
+        }
+    }, [agent, action, context, isLoading, disabled, onSuccess, onError]);
+    // Map variant prop to PDS button class
+    const pdsVariantMap = {
+        primary: 'pds-button--primary',
+        secondary: 'pds-button--secondary',
+        ghost: 'pds-button--subtle',
+    };
+    const pdsSizeMap = {
+        sm: 'pds-button--sm',
+        lg: 'pds-button--lg',
+    };
+    const buttonClasses = [
+        'pds-button',
+        pdsVariantMap[variant] ?? 'pds-button--secondary',
+        pdsSizeMap[size] ?? '',
+        baseClass,
+        isLoading && `${baseClass}--loading`,
+        className,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return (_jsxs("button", { type: "button", className: buttonClasses, onClick: handleClick, disabled: disabled || isLoading, "aria-busy": isLoading, children: [isLoading ? (_jsx("span", { className: `${baseClass}__spinner`, "aria-hidden": "true" })) : null, _jsx("span", { className: `${baseClass}__content`, children: children })] }));
+}
+//# sourceMappingURL=AgentActionButton.js.map

package/dist/agent/components/AgentActionButton.js.map

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

package/dist/agent/components/AgentActionModal.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AgentActionModal Component
+ *
+ * Modal for selecting an agent and configuring an action.
+ * Shows agent list, intent input, region selection.
+ */
+import React from 'react';
+import type { RegisteredAgent } from '@pantheon-systems/css-client';
+export interface AgentActionModalProps {
+    /** Whether modal is open */
+    isOpen: boolean;
+    /** Close handler */
+    onClose: () => void;
+    /** Available agents */
+    agents: RegisteredAgent[];
+    /** Pre-selected target regions */
+    targetRegions?: string[];
+    /** Success callback */
+    onSuccess?: (checkpointId?: string) => void;
+    /** Error callback */
+    onError?: (error: string) => void;
+}
+/**
+ * Modal for selecting an agent and configuring an action.
+ * Shows agent list, intent input, region selection.
+ */
+export declare function AgentActionModal({ isOpen, onClose, agents, targetRegions, onSuccess, onError, }: AgentActionModalProps): React.JSX.Element | null;
+//# sourceMappingURL=AgentActionModal.d.ts.map

package/dist/agent/components/AgentActionModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentActionModal.d.ts","sourceRoot":"","sources":["../../../src/agent/components/AgentActionModal.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAA2C,MAAM,OAAO,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uBAAuB;IACvB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uBAAuB;IACvB,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,qBAAqB;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAO,EACP,MAAM,EACN,aAAkB,EAClB,SAAS,EACT,OAAO,GACR,EAAE,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAuKlD"}

package/dist/agent/components/AgentActionModal.js

@@ -0,0 +1,85 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * AgentActionModal Component
+ *
+ * Modal for selecting an agent and configuring an action.
+ * Shows agent list, intent input, region selection.
+ */
+import { useState, useCallback, useEffect } from 'react';
+import { usePresenceContext } from '../../core/PresenceContext.js';
+const baseClass = 'css-puck-agent-modal';
+/**
+ * Modal for selecting an agent and configuring an action.
+ * Shows agent list, intent input, region selection.
+ */
+export function AgentActionModal({ isOpen, onClose, agents, targetRegions = [], onSuccess, onError, }) {
+    const context = usePresenceContext();
+    const [selectedAgentId, setSelectedAgentId] = useState(agents[0]?.id ?? null);
+    const [intent, setIntent] = useState('');
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    // Reset state when modal opens
+    useEffect(() => {
+        if (isOpen) {
+            setSelectedAgentId(agents[0]?.id ?? null);
+            setIntent('');
+            setIsSubmitting(false);
+        }
+    }, [isOpen, agents]);
+    const handleAgentSelect = useCallback((agentId) => {
+        setSelectedAgentId(agentId);
+    }, []);
+    const handleIntentChange = useCallback((e) => {
+        setIntent(e.target.value);
+    }, []);
+    const handleSubmit = useCallback(async () => {
+        if (!selectedAgentId || !intent.trim() || !context.documentPath || isSubmitting) {
+            return;
+        }
+        setIsSubmitting(true);
+        try {
+            // Check if agent can edit
+            const permission = await context.client.agentEdit.canEdit(context.siteId, context.branchId, context.documentPath, {
+                agentId: selectedAgentId,
+                trigger: 'human_requested',
+                intent: intent.trim(),
+                targetRegions,
+                requestedById: context.userId,
+            });
+            if (!permission.allowed) {
+                setIsSubmitting(false);
+                onError?.(permission.reason || 'Permission denied');
+                return;
+            }
+            // Start the edit session
+            const session = await context.client.agentEdit.startEdit(context.siteId, context.branchId, context.documentPath, {
+                agentId: selectedAgentId,
+                trigger: 'human_requested',
+                intent: intent.trim(),
+                targetRegions,
+                requestedById: context.userId,
+            });
+            setIsSubmitting(false);
+            onSuccess?.(session.checkpointId);
+            onClose();
+        }
+        catch (err) {
+            setIsSubmitting(false);
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            onError?.(errorMessage);
+        }
+    }, [selectedAgentId, intent, targetRegions, context, isSubmitting, onSuccess, onError, onClose]);
+    const handleCancel = useCallback(() => {
+        onClose();
+    }, [onClose]);
+    const isSubmitDisabled = !selectedAgentId || !intent.trim() || isSubmitting;
+    if (!isOpen) {
+        return null;
+    }
+    return (_jsxs("div", { className: baseClass, role: "dialog", "aria-modal": "true", "aria-labelledby": `${baseClass}-title`, children: [_jsx("div", { className: `${baseClass}__overlay`, onClick: handleCancel }), _jsxs("div", { className: `${baseClass}__content`, children: [_jsx("h2", { id: `${baseClass}-title`, className: `${baseClass}__title`, children: "Run Agent" }), _jsxs("div", { className: `${baseClass}__agents`, children: [_jsx("label", { className: `${baseClass}__label`, children: "Select Agent" }), _jsx("div", { className: `${baseClass}__agent-list`, children: agents.map((agent) => (_jsxs("button", { type: "button", className: [
+                                        `${baseClass}__agent-item`,
+                                        selectedAgentId === agent.id && `${baseClass}__agent-item--selected`,
+                                    ]
+                                        .filter(Boolean)
+                                        .join(' '), onClick: () => handleAgentSelect(agent.id), children: [_jsx("span", { className: `${baseClass}__agent-name`, children: agent.name }), agent.description && (_jsx("span", { className: `${baseClass}__agent-desc`, children: agent.description }))] }, agent.id))) })] }), _jsxs("div", { className: `${baseClass}__intent`, children: [_jsx("label", { htmlFor: `${baseClass}-intent`, className: `${baseClass}__label`, children: "Intent" }), _jsx("input", { id: `${baseClass}-intent`, type: "text", className: `${baseClass}__input`, value: intent, onChange: handleIntentChange, placeholder: "What should the agent do?" })] }), targetRegions.length > 0 && (_jsxs("div", { className: `${baseClass}__regions`, children: [_jsx("label", { className: `${baseClass}__label`, children: "Target Regions" }), _jsx("div", { className: `${baseClass}__region-list`, children: targetRegions.map((region) => (_jsx("span", { className: `${baseClass}__region`, children: region }, region))) })] })), _jsxs("div", { className: `${baseClass}__actions`, children: [_jsx("button", { type: "button", className: `${baseClass}__cancel-btn`, onClick: handleCancel, disabled: isSubmitting, children: "Cancel" }), _jsx("button", { type: "button", className: `${baseClass}__submit-btn`, onClick: handleSubmit, disabled: isSubmitDisabled, children: isSubmitting ? 'Running...' : 'Run Agent' })] })] })] }));
+}
+//# sourceMappingURL=AgentActionModal.js.map

package/dist/agent/components/AgentActionModal.js.map

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

package/dist/agent/components/AgentStatusPanel.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AgentStatusPanel Component
+ *
+ * Panel showing an agent's current status and activity.
+ * Includes progress indicator, intent, and cancel button.
+ */
+import React from 'react';
+import type { RegisteredAgent } from '@pantheon-systems/css-client';
+import type { AgentAction, AgentTriggerStatus } from '../useAgentTrigger.js';
+export interface AgentStatusPanelProps {
+    /** Agent to display status for */
+    agent: RegisteredAgent;
+    /** Current status */
+    status: AgentTriggerStatus;
+    /** Current action if any */
+    activeAction?: AgentAction;
+    /** Show in compact mode */
+    compact?: boolean;
+    /** Cancel action callback */
+    onCancel?: () => void;
+}
+/**
+ * Panel showing an agent's current status and activity.
+ * Includes progress indicator, intent, and cancel button.
+ */
+export declare function AgentStatusPanel({ agent, status, activeAction, compact, onCancel, }: AgentStatusPanelProps): React.JSX.Element;
+//# sourceMappingURL=AgentStatusPanel.d.ts.map

package/dist/agent/components/AgentStatusPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentStatusPanel.d.ts","sourceRoot":"","sources":["../../../src/agent/components/AgentStatusPanel.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,qBAAqB;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,4BAA4B;IAC5B,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAoCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,MAAM,EACN,YAAY,EACZ,OAAe,EACf,QAAQ,GACT,EAAE,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6E3C"}

package/dist/agent/components/AgentStatusPanel.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const baseClass = 'css-puck-agent-status';
+/**
+ * Get a human-readable status label.
+ */
+function getStatusLabel(status) {
+    switch (status) {
+        case 'checking':
+            return 'Checking permissions...';
+        case 'starting':
+            return 'Starting...';
+        case 'editing':
+            return 'Editing';
+        case 'completing':
+            return 'Completing...';
+        case 'error':
+            return 'Error';
+        case 'idle':
+        default:
+            return 'Idle';
+    }
+}
+/**
+ * Get initials from a name.
+ */
+function getInitials(name) {
+    return name
+        .split(' ')
+        .slice(0, 2)
+        .map((word) => word.charAt(0).toUpperCase())
+        .join('');
+}
+/**
+ * Panel showing an agent's current status and activity.
+ * Includes progress indicator, intent, and cancel button.
+ */
+export function AgentStatusPanel({ agent, status, activeAction, compact = false, onCancel, }) {
+    const isActive = status !== 'idle';
+    const containerClasses = [
+        baseClass,
+        `${baseClass}--${status}`,
+        compact && `${baseClass}--compact`,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return (_jsxs("div", { className: containerClasses, children: [_jsxs("div", { className: `${baseClass}__header`, children: [_jsxs("div", { className: `${baseClass}__avatar`, children: [_jsx("span", { className: `${baseClass}__initials`, children: getInitials(agent.name) }), _jsx("span", { className: `${baseClass}__agent-icon`, "aria-hidden": "true" })] }), _jsxs("div", { className: `${baseClass}__info`, children: [_jsx("span", { className: `${baseClass}__name`, children: agent.name }), agent.description && !compact && (_jsx("span", { className: `${baseClass}__description`, children: agent.description }))] }), _jsx("div", { className: `${baseClass}__status`, children: _jsx("span", { className: [
+                                `${baseClass}__status-badge`,
+                                `${baseClass}__status-badge--${status}`,
+                            ].join(' '), children: getStatusLabel(status) }) })] }), activeAction && (_jsxs("div", { className: `${baseClass}__action`, children: [_jsx("span", { className: `${baseClass}__intent`, children: activeAction.intent }), activeAction.targetRegions.length > 0 && !compact && (_jsx("div", { className: `${baseClass}__regions`, children: activeAction.targetRegions.map((region) => (_jsx("span", { className: `${baseClass}__region`, children: region }, region))) }))] })), !compact && agent.capabilities && agent.capabilities.length > 0 && (_jsx("div", { className: `${baseClass}__capabilities`, children: agent.capabilities.map((capability) => (_jsx("span", { className: `${baseClass}__capability`, children: capability }, capability))) })), isActive && onCancel && (_jsx("div", { className: `${baseClass}__actions`, children: _jsx("button", { type: "button", className: `pds-button pds-button--subtle pds-button--sm ${baseClass}__cancel-btn`, onClick: onCancel, "aria-label": "Cancel action", children: "Cancel" }) }))] }));
+}
+//# sourceMappingURL=AgentStatusPanel.js.map

package/dist/agent/components/AgentStatusPanel.js.map

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

package/dist/agent/components/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Agent Action Components
+ *
+ * UI components for triggering and managing agent actions.
+ */
+export { AgentActionButton } from './AgentActionButton.js';
+export type { AgentActionButtonProps } from './AgentActionButton.js';
+export { AgentActionModal } from './AgentActionModal.js';
+export type { AgentActionModalProps } from './AgentActionModal.js';
+export { AgentStatusPanel } from './AgentStatusPanel.js';
+export type { AgentStatusPanelProps } from './AgentStatusPanel.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/agent/components/index.js

@@ -0,0 +1,9 @@
+/**
+ * Agent Action Components
+ *
+ * UI components for triggering and managing agent actions.
+ */
+export { AgentActionButton } from './AgentActionButton.js';
+export { AgentActionModal } from './AgentActionModal.js';
+export { AgentStatusPanel } from './AgentStatusPanel.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/agent/index.d.ts

@@ -0,0 +1,6 @@
+export { useAgentEdit } from './useAgentEdit.js';
+export type { UseAgentEditOptions, UseAgentEditReturn } from './useAgentEdit.js';
+export { useAgentTrigger } from './useAgentTrigger.js';
+export type { UseAgentTriggerOptions, UseAgentTriggerReturn } from './useAgentTrigger.js';
+export * from './components/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,cAAc,uBAAuB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,4 @@
+export { useAgentEdit } from './useAgentEdit.js';
+export { useAgentTrigger } from './useAgentTrigger.js';
+export * from './components/index.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,cAAc,uBAAuB,CAAC"}

package/dist/agent/useAgentEdit.d.ts

@@ -0,0 +1,68 @@
+/**
+ * useAgentEdit Hook
+ *
+ * Manages agent edit sessions for a specific agent.
+ * Provides methods to check permissions, start, complete, and abort edits.
+ */
+import type { AgentEditPermission, AgentEditSession, AgentTrigger } from '@pantheon-systems/css-client';
+/**
+ * Parameters for starting or checking an edit.
+ */
+export interface AgentEditParams {
+    /** Trigger type */
+    trigger: AgentTrigger;
+    /** Intent description */
+    intent: string;
+    /** Target regions to edit */
+    targetRegions: string[];
+    /** User who requested the edit (for human_requested trigger) */
+    requestedById?: string;
+}
+/**
+ * Options for useAgentEdit hook.
+ */
+export interface UseAgentEditOptions {
+    /** Agent ID to use for operations */
+    agentId: string;
+    /** Callback when edit permission is denied */
+    onDenied?: (reason: string, conflictingRegions?: string[]) => void;
+    /** Callback when edit completes successfully */
+    onComplete?: (checkpointId: string) => void;
+    /** Callback when edit is aborted */
+    onAborted?: () => void;
+}
+/**
+ * Return value of useAgentEdit hook.
+ */
+export interface UseAgentEditReturn {
+    /** Check if agent can edit specified regions */
+    canEdit: (params: AgentEditParams) => Promise<AgentEditPermission>;
+    /** Start an edit session */
+    startEdit: (params: AgentEditParams) => Promise<AgentEditSession>;
+    /** Complete the current edit session */
+    completeEdit: () => Promise<void>;
+    /** Abort the current edit session */
+    abortEdit: () => Promise<void>;
+    /** Current session info */
+    session: AgentEditSession | null;
+    /**
+     * Current session ID for agent authorization.
+     * Convenience property - same as session?.sessionId ?? null.
+     * Use this to pass to realtime client or REST API calls.
+     */
+    sessionId: string | null;
+    /** Whether an edit session is active */
+    isEditing: boolean;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error state */
+    error: Error | null;
+}
+/**
+ * Hook for managing agent edit sessions.
+ *
+ * @param options - Hook options including agentId and callbacks
+ * @returns Methods and state for managing agent edits
+ */
+export declare function useAgentEdit(options: UseAgentEditOptions): UseAgentEditReturn;
+//# sourceMappingURL=useAgentEdit.d.ts.map

package/dist/agent/useAgentEdit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentEdit.d.ts","sourceRoot":"","sources":["../../src/agent/useAgentEdit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACb,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACnE,gDAAgD;IAChD,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnE,4BAA4B;IAC5B,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,wCAAwC;IACxC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,qCAAqC;IACrC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,2BAA2B;IAC3B,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CA4J7E"}

package/dist/agent/useAgentEdit.js

@@ -0,0 +1,125 @@
+/**
+ * useAgentEdit Hook
+ *
+ * Manages agent edit sessions for a specific agent.
+ * Provides methods to check permissions, start, complete, and abort edits.
+ */
+import { useState, useCallback } from 'react';
+import { usePresenceContext } from '../core/PresenceContext.js';
+/**
+ * Hook for managing agent edit sessions.
+ *
+ * @param options - Hook options including agentId and callbacks
+ * @returns Methods and state for managing agent edits
+ */
+export function useAgentEdit(options) {
+    const { agentId, onDenied, onComplete, onAborted } = options;
+    const context = usePresenceContext();
+    const [session, setSession] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const canEdit = useCallback(async (params) => {
+        if (!context.documentPath) {
+            throw new Error('No document path in context');
+        }
+        const permission = await context.client.agentEdit.canEdit(context.siteId, context.branchId, context.documentPath, {
+            agentId,
+            trigger: params.trigger,
+            intent: params.intent,
+            targetRegions: params.targetRegions,
+            requestedById: params.requestedById,
+        });
+        if (!permission.allowed && onDenied && permission.reason) {
+            onDenied(permission.reason, permission.conflictingRegions);
+        }
+        return permission;
+    }, [context, agentId, onDenied]);
+    const startEdit = useCallback(async (params) => {
+        if (!context.documentPath) {
+            throw new Error('No document path in context');
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            const newSession = await context.client.agentEdit.startEdit(context.siteId, context.branchId, context.documentPath, {
+                agentId,
+                trigger: params.trigger,
+                intent: params.intent,
+                targetRegions: params.targetRegions,
+                requestedById: params.requestedById,
+            });
+            setSession(newSession);
+            setIsLoading(false);
+            return newSession;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            setIsLoading(false);
+            throw e;
+        }
+    }, [context, agentId]);
+    const completeEdit = useCallback(async () => {
+        if (!session) {
+            throw new Error('No active edit session');
+        }
+        if (!context.documentPath) {
+            throw new Error('No document path in context');
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await context.client.agentEdit.completeEdit(context.siteId, context.branchId, context.documentPath, agentId);
+            setSession(null);
+            setIsLoading(false);
+            if (onComplete && result.checkpointId) {
+                onComplete(result.checkpointId);
+            }
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            setIsLoading(false);
+            throw e;
+        }
+    }, [session, context, agentId, onComplete]);
+    const abortEdit = useCallback(async () => {
+        if (!session) {
+            throw new Error('No active edit session');
+        }
+        if (!context.documentPath) {
+            throw new Error('No document path in context');
+        }
+        if (!session.checkpointId) {
+            throw new Error('No checkpoint ID in session');
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            await context.client.agentEdit.abortEdit(context.siteId, context.branchId, context.documentPath, agentId, session.checkpointId);
+            setSession(null);
+            setIsLoading(false);
+            if (onAborted) {
+                onAborted();
+            }
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            setIsLoading(false);
+            throw e;
+        }
+    }, [session, context, agentId, onAborted]);
+    return {
+        canEdit,
+        startEdit,
+        completeEdit,
+        abortEdit,
+        session,
+        sessionId: session?.sessionId ?? null,
+        isEditing: session !== null,
+        isLoading,
+        error,
+    };
+}
+//# sourceMappingURL=useAgentEdit.js.map

package/dist/agent/useAgentEdit.js.map

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