@particle-academy/agent-integrations 0.8.0 → 0.9.0

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { a as MicroMcpServer } from './server-C2OpfPEo.cjs';
-export { M as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-C2OpfPEo.cjs';
-export { T as ToolHost, a as ToolRegistry } from './tool-host-CX3WFXgh.cjs';
+import { M as MicroMcpServer } from './server-BsSwfemr.cjs';
+export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-BsSwfemr.cjs';
+export { T as ToolHost, a as ToolRegistry } from './tool-host-BQuUygLF.cjs';
 export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.cjs';
-export { C as CallToolResult, a as ContentBlock, I as InitializeResult, f as JsonObject, i as JsonRpcMessage, j as JsonRpcNotification, k as JsonRpcRequest, m as JsonValue, M as MCP_PROTOCOL_VERSION, S as ServerCapabilities, n as ServerInfo, T as ToolDefinition, o as ToolHandler } from './types-C2zdUpzn.cjs';
-export { B as Bridge, a as BridgeFactory } from './types-Cq5u8MJ8.cjs';
+export { C as CallToolResult, d as ContentBlock, I as InitializeResult, c as JsonObject, J as JsonRpcMessage, e as JsonRpcNotification, f as JsonRpcRequest, g as JsonValue, M as MCP_PROTOCOL_VERSION, a as ServerCapabilities, S as ServerInfo, T as ToolDefinition, b as ToolHandler } from './types-aOQLTW0E.cjs';
+export { B as Bridge, a as BridgeFactory } from './types-CCSBGW9T.cjs';
 import { FormFieldDescriptor } from './bridges/forms.cjs';
 export { FormBridgeAdapter, FormBridgeOptions, registerFormBridge } from './bridges/forms.cjs';
 export { SheetsBridgeAdapter, SheetsBridgeOptions, registerSheetsBridge } from './bridges/sheets.cjs';
@@ -13,12 +13,13 @@ export { ChartsBridgeAdapter, ChartsBridgeOptions, registerChartsBridge } from '
 export { SceneBridgeAdapter, SceneBridgeOptions, SceneCamera, SceneObject, SceneObjectKind, SceneState, registerSceneBridge } from './bridges/scene.cjs';
 export { ScreenSnapshot, ScreensBridgeAdapter, ScreensBridgeOptions, registerScreensBridge } from './bridges/screens.cjs';
 export { SlidesBridgeAdapter, SlidesBridgeOptions, registerSlidesBridge } from './bridges/slides.cjs';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode, CSSProperties } from 'react';
-import { S as SessionDescriptor } from './token-C1O22GxJ.cjs';
-export { b as buildShareConfig, a as buildShareUrl, d as createSessionDescriptor, e as describeSession, r as readSessionFromUrl } from './token-C1O22GxJ.cjs';
-export { ActivityAgent, ActivityFilter, ActivityResolverContext, ActivityTargetResolver, ToolHandler as ActivityWrappedHandler, AgentActivityEvent, AgentActivityListener, AgentTarget, AgentTargetKind, emitActivity, onActivity, readActivityHistory, resetActivityRegistry, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity } from './presence/index.cjs';
-export { UndoEntry, UndoToolsOptions, clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne, useUndoStack } from './undo/index.cjs';
+import { S as SessionDescriptor } from './token-CrJF76oH.cjs';
+export { b as buildShareConfig, a as buildShareUrl, c as createSessionDescriptor, d as describeSession, r as readSessionFromUrl } from './token-CrJF76oH.cjs';
+export { ActivityFilter, AutoActivityEvent as AgentActivityEvent, AutoActivityListener as AgentActivityListener, AutoTarget as AgentTarget, AutoTargetKind as AgentTargetKind, UndoEntry, clearStack as clearUndoStack, emitActivity, onActivity, pushUndoEntry, readActivityHistory, readHistory as readUndoHistory, redoOne, resetActivityRegistry, resetAllUndoStacks, undoOne } from '@particle-academy/fancy-auto-common';
+export { ActivityAgent, ActivityResolverContext, ActivityTargetResolver, ToolHandler as ActivityWrappedHandler, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity } from './presence/index.cjs';
+export { UndoToolsOptions, ensureUndoToolsRegistered, registerUndoTools, useUndoStack } from './undo/index.cjs';
 export { RelayState, SseRelayOptions, SseRelayTransport, attachSseRelay } from './sharing/index.cjs';
 import '@particle-academy/fancy-slides';
 
@@ -57,7 +58,7 @@ type AgentPanelProps = {
  * and an optional input composer. Pure presentational: hosts feed it the
  * activity stream from their own state (typically the MCP transport log).
  */
-declare function AgentPanel({ agent, activity, onSubmit, busy, actions, className, style }: AgentPanelProps): react_jsx_runtime.JSX.Element;
+declare function AgentPanel({ agent, activity, onSubmit, busy, actions, className, style }: AgentPanelProps): react.JSX.Element;
 
 type AgentCursorProps = {
     x: number;
@@ -74,7 +75,7 @@ type AgentCursorProps = {
  * (or alongside) a fancy-whiteboard <Board> at screen coords matching
  * the agent's reported position.
  */
-declare function AgentCursor({ x, y, name, color, status, className, style }: AgentCursorProps): react_jsx_runtime.JSX.Element;
+declare function AgentCursor({ x, y, name, color, status, className, style }: AgentCursorProps): react.JSX.Element;
 
 type AgentActivityHighlightProps = {
     /** Bounds of the highlighted item in the parent's coord system. */
@@ -96,7 +97,7 @@ type AgentActivityHighlightProps = {
  * item the agent just touched. Position the parent so this can be placed
  * absolutely matching the item's bounds.
  */
-declare function AgentActivityHighlight({ x, y, width, height, pulseKey, color, duration, className, style, }: AgentActivityHighlightProps): react_jsx_runtime.JSX.Element | null;
+declare function AgentActivityHighlight({ x, y, width, height, pulseKey, color, duration, className, style, }: AgentActivityHighlightProps): react.JSX.Element | null;
 
 type BridgedFormProps = {
     /** Stable id for this form. Used by agents in `form_*` tool calls. */
@@ -142,7 +143,7 @@ type BridgedFormProps = {
  *
  * Agents can then call form_describe, form_set_value, form_submit, etc.
  */
-declare function BridgedForm({ id, title, screenId, fields, values, onChange, onSubmit, server, agent, children, }: BridgedFormProps): react_jsx_runtime.JSX.Element;
+declare function BridgedForm({ id, title, screenId, fields, values, onChange, onSubmit, server, agent, children, }: BridgedFormProps): react.JSX.Element;
 
 /**
  * Loose shape of the fancy-screens system context — kept here so this
@@ -197,6 +198,6 @@ type ShareControlsProps = {
  * ShareControls — the host-facing UI for turning sharing on/off and
  * surfacing the resulting connection details (URL / JSON / cURL).
  */
-declare function ShareControls({ session, onStart, onStop, status, shareBaseUrl, className, style, }: ShareControlsProps): react_jsx_runtime.JSX.Element;
+declare function ShareControls({ session, onStart, onStop, status, shareBaseUrl, className, style, }: ShareControlsProps): react.JSX.Element;
 
 export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, BridgedForm, type BridgedFormProps, FormFieldDescriptor, MicroMcpServer, ScreensActivityBridge, type ScreensActivityBridgeProps, SessionDescriptor, ShareControls, type ShareControlsProps };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { a as MicroMcpServer } from './server-CKAqFTyc.js';
-export { M as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-CKAqFTyc.js';
-export { T as ToolHost, a as ToolRegistry } from './tool-host-DldwGNqR.js';
+import { M as MicroMcpServer } from './server-Du3-IGqM.js';
+export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-Du3-IGqM.js';
+export { T as ToolHost, a as ToolRegistry } from './tool-host-C8JMMGYq.js';
 export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.js';
-export { C as CallToolResult, a as ContentBlock, I as InitializeResult, f as JsonObject, i as JsonRpcMessage, j as JsonRpcNotification, k as JsonRpcRequest, m as JsonValue, M as MCP_PROTOCOL_VERSION, S as ServerCapabilities, n as ServerInfo, T as ToolDefinition, o as ToolHandler } from './types-C2zdUpzn.js';
-export { B as Bridge, a as BridgeFactory } from './types-DyaHnqNC.js';
+export { C as CallToolResult, d as ContentBlock, I as InitializeResult, c as JsonObject, J as JsonRpcMessage, e as JsonRpcNotification, f as JsonRpcRequest, g as JsonValue, M as MCP_PROTOCOL_VERSION, a as ServerCapabilities, S as ServerInfo, T as ToolDefinition, b as ToolHandler } from './types-aOQLTW0E.js';
+export { B as Bridge, a as BridgeFactory } from './types-DIVNcIQO.js';
 import { FormFieldDescriptor } from './bridges/forms.js';
 export { FormBridgeAdapter, FormBridgeOptions, registerFormBridge } from './bridges/forms.js';
 export { SheetsBridgeAdapter, SheetsBridgeOptions, registerSheetsBridge } from './bridges/sheets.js';
@@ -13,12 +13,13 @@ export { ChartsBridgeAdapter, ChartsBridgeOptions, registerChartsBridge } from '
 export { SceneBridgeAdapter, SceneBridgeOptions, SceneCamera, SceneObject, SceneObjectKind, SceneState, registerSceneBridge } from './bridges/scene.js';
 export { ScreenSnapshot, ScreensBridgeAdapter, ScreensBridgeOptions, registerScreensBridge } from './bridges/screens.js';
 export { SlidesBridgeAdapter, SlidesBridgeOptions, registerSlidesBridge } from './bridges/slides.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode, CSSProperties } from 'react';
-import { S as SessionDescriptor } from './token-C1O22GxJ.js';
-export { b as buildShareConfig, a as buildShareUrl, d as createSessionDescriptor, e as describeSession, r as readSessionFromUrl } from './token-C1O22GxJ.js';
-export { ActivityAgent, ActivityFilter, ActivityResolverContext, ActivityTargetResolver, ToolHandler as ActivityWrappedHandler, AgentActivityEvent, AgentActivityListener, AgentTarget, AgentTargetKind, emitActivity, onActivity, readActivityHistory, resetActivityRegistry, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity } from './presence/index.js';
-export { UndoEntry, UndoToolsOptions, clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne, useUndoStack } from './undo/index.js';
+import { S as SessionDescriptor } from './token-CrJF76oH.js';
+export { b as buildShareConfig, a as buildShareUrl, c as createSessionDescriptor, d as describeSession, r as readSessionFromUrl } from './token-CrJF76oH.js';
+export { ActivityFilter, AutoActivityEvent as AgentActivityEvent, AutoActivityListener as AgentActivityListener, AutoTarget as AgentTarget, AutoTargetKind as AgentTargetKind, UndoEntry, clearStack as clearUndoStack, emitActivity, onActivity, pushUndoEntry, readActivityHistory, readHistory as readUndoHistory, redoOne, resetActivityRegistry, resetAllUndoStacks, undoOne } from '@particle-academy/fancy-auto-common';
+export { ActivityAgent, ActivityResolverContext, ActivityTargetResolver, ToolHandler as ActivityWrappedHandler, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity } from './presence/index.js';
+export { UndoToolsOptions, ensureUndoToolsRegistered, registerUndoTools, useUndoStack } from './undo/index.js';
 export { RelayState, SseRelayOptions, SseRelayTransport, attachSseRelay } from './sharing/index.js';
 import '@particle-academy/fancy-slides';
 
@@ -57,7 +58,7 @@ type AgentPanelProps = {
  * and an optional input composer. Pure presentational: hosts feed it the
  * activity stream from their own state (typically the MCP transport log).
  */
-declare function AgentPanel({ agent, activity, onSubmit, busy, actions, className, style }: AgentPanelProps): react_jsx_runtime.JSX.Element;
+declare function AgentPanel({ agent, activity, onSubmit, busy, actions, className, style }: AgentPanelProps): react.JSX.Element;
 
 type AgentCursorProps = {
     x: number;
@@ -74,7 +75,7 @@ type AgentCursorProps = {
  * (or alongside) a fancy-whiteboard <Board> at screen coords matching
  * the agent's reported position.
  */
-declare function AgentCursor({ x, y, name, color, status, className, style }: AgentCursorProps): react_jsx_runtime.JSX.Element;
+declare function AgentCursor({ x, y, name, color, status, className, style }: AgentCursorProps): react.JSX.Element;
 
 type AgentActivityHighlightProps = {
     /** Bounds of the highlighted item in the parent's coord system. */
@@ -96,7 +97,7 @@ type AgentActivityHighlightProps = {
  * item the agent just touched. Position the parent so this can be placed
  * absolutely matching the item's bounds.
  */
-declare function AgentActivityHighlight({ x, y, width, height, pulseKey, color, duration, className, style, }: AgentActivityHighlightProps): react_jsx_runtime.JSX.Element | null;
+declare function AgentActivityHighlight({ x, y, width, height, pulseKey, color, duration, className, style, }: AgentActivityHighlightProps): react.JSX.Element | null;
 
 type BridgedFormProps = {
     /** Stable id for this form. Used by agents in `form_*` tool calls. */
@@ -142,7 +143,7 @@ type BridgedFormProps = {
  *
  * Agents can then call form_describe, form_set_value, form_submit, etc.
  */
-declare function BridgedForm({ id, title, screenId, fields, values, onChange, onSubmit, server, agent, children, }: BridgedFormProps): react_jsx_runtime.JSX.Element;
+declare function BridgedForm({ id, title, screenId, fields, values, onChange, onSubmit, server, agent, children, }: BridgedFormProps): react.JSX.Element;
 
 /**
  * Loose shape of the fancy-screens system context — kept here so this
@@ -197,6 +198,6 @@ type ShareControlsProps = {
  * ShareControls — the host-facing UI for turning sharing on/off and
  * surfacing the resulting connection details (URL / JSON / cURL).
  */
-declare function ShareControls({ session, onStart, onStop, status, shareBaseUrl, className, style, }: ShareControlsProps): react_jsx_runtime.JSX.Element;
+declare function ShareControls({ session, onStart, onStop, status, shareBaseUrl, className, style, }: ShareControlsProps): react.JSX.Element;
 
 export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, BridgedForm, type BridgedFormProps, FormFieldDescriptor, MicroMcpServer, ScreensActivityBridge, type ScreensActivityBridgeProps, SessionDescriptor, ShareControls, type ShareControlsProps };

package/dist/index.js

@@ -1,23 +1,23 @@
-export { useUndoStack } from './chunk-RGO42EQ6.js';
-export { registerChartsBridge } from './chunk-NTDZWGYB.js';
-export { registerSceneBridge } from './chunk-XRAJSOPS.js';
-export { registerScreensBridge } from './chunk-57ZDHD53.js';
-export { registerSlidesBridge } from './chunk-KABXGJJ4.js';
-export { useSheetsActivityHighlights, useSheetsAdapter } from './chunk-5XELJIJR.js';
-export { AgentActivityHighlight, AgentCursor, AgentPanel, ShareControls } from './chunk-ZHAK2DQR.js';
+export { useUndoStack } from './chunk-GHY3PBPN.js';
+export { registerChartsBridge } from './chunk-SJ7H242B.js';
+export { registerSceneBridge } from './chunk-VUMFO2UW.js';
+export { registerScreensBridge } from './chunk-CKK4QKD2.js';
+export { registerSlidesBridge } from './chunk-R5OA26MJ.js';
+export { useSheetsActivityHighlights, useSheetsAdapter } from './chunk-KHKSQEMC.js';
+export { AgentActivityHighlight, AgentCursor, AgentPanel, ShareControls } from './chunk-J5KYPEYB.js';
 import './chunk-IJ6JX5VC.js';
-export { SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './chunk-LVQXIUJH.js';
-export { useAgentActivity, useAgentActivityForScreen } from './chunk-X66JWQBB.js';
+export { SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './chunk-CPNOF4HI.js';
+export { useAgentActivity, useAgentActivityForScreen } from './chunk-UCKJAUBY.js';
 export { RelayTransport, attachRelay } from './chunk-G6N2TQVO.js';
 export { InProcessTransport, attachInProcess } from './chunk-AFUULW5E.js';
-export { clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne } from './chunk-GQ7XXK7G.js';
-import { registerFormBridge } from './chunk-4BL5M3U3.js';
-export { registerFormBridge } from './chunk-4BL5M3U3.js';
-export { registerSheetsBridge } from './chunk-IANI25IT.js';
-export { registerCodeBridge } from './chunk-HSTW7ZNO.js';
-export { wrapToolWithActivity } from './chunk-52S7XYZK.js';
-import { onActivity } from './chunk-JU2N4KK6.js';
-export { emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from './chunk-JU2N4KK6.js';
+export { clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne } from './chunk-KJ5AOOV7.js';
+import { registerFormBridge } from './chunk-5AD35HS5.js';
+export { registerFormBridge } from './chunk-5AD35HS5.js';
+export { registerSheetsBridge } from './chunk-GSVVIT2O.js';
+export { registerCodeBridge } from './chunk-FYGMFIY5.js';
+export { wrapToolWithActivity } from './chunk-ULJL53DL.js';
+import { onActivity } from './chunk-C3TYI5TJ.js';
+export { emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from './chunk-C3TYI5TJ.js';
 export { MCP_PROTOCOL_VERSION, MicroMcpServer, ToolRegistry, errorResult, rpcError, textResult } from './chunk-4KAIV6OD.js';
 import { useRef, useEffect, useMemo } from 'react';
 import { jsx } from 'react/jsx-runtime';

package/dist/mcp/index.d.cts

@@ -1,8 +1,8 @@
-import { T as Transport, a as MicroMcpServer } from '../server-C2OpfPEo.cjs';
-export { M as McpServerOptions, e as errorResult, r as rpcError, t as textResult } from '../server-C2OpfPEo.cjs';
-import { i as JsonRpcMessage } from '../types-C2zdUpzn.cjs';
-export { C as CallToolResult, a as ContentBlock, I as InitializeResult, J as JSONRPC_INTERNAL_ERROR, b as JSONRPC_INVALID_PARAMS, c as JSONRPC_INVALID_REQUEST, d as JSONRPC_METHOD_NOT_FOUND, e as JSONRPC_PARSE_ERROR, f as JsonObject, g as JsonRpcError, h as JsonRpcId, j as JsonRpcNotification, k as JsonRpcRequest, l as JsonRpcSuccess, m as JsonValue, M as MCP_PROTOCOL_VERSION, R as RegisteredTool, S as ServerCapabilities, n as ServerInfo, T as ToolDefinition, o as ToolHandler, p as ToolInputSchema } from '../types-C2zdUpzn.cjs';
-import '../tool-host-CX3WFXgh.cjs';
+import { T as Transport, M as MicroMcpServer } from '../server-BsSwfemr.cjs';
+export { a as McpServerOptions, e as errorResult, r as rpcError, t as textResult } from '../server-BsSwfemr.cjs';
+import { J as JsonRpcMessage } from '../types-aOQLTW0E.cjs';
+export { C as CallToolResult, d as ContentBlock, I as InitializeResult, h as JSONRPC_INTERNAL_ERROR, i as JSONRPC_INVALID_PARAMS, j as JSONRPC_INVALID_REQUEST, k as JSONRPC_METHOD_NOT_FOUND, l as JSONRPC_PARSE_ERROR, c as JsonObject, m as JsonRpcError, n as JsonRpcId, e as JsonRpcNotification, f as JsonRpcRequest, o as JsonRpcSuccess, g as JsonValue, M as MCP_PROTOCOL_VERSION, R as RegisteredTool, a as ServerCapabilities, S as ServerInfo, T as ToolDefinition, b as ToolHandler, p as ToolInputSchema } from '../types-aOQLTW0E.cjs';
+import '../tool-host-BQuUygLF.cjs';
 
 /**
  * InProcessTransport — direct function-call wiring between an in-page MCP

package/dist/mcp/index.d.ts

@@ -1,8 +1,8 @@
-import { T as Transport, a as MicroMcpServer } from '../server-CKAqFTyc.js';
-export { M as McpServerOptions, e as errorResult, r as rpcError, t as textResult } from '../server-CKAqFTyc.js';
-import { i as JsonRpcMessage } from '../types-C2zdUpzn.js';
-export { C as CallToolResult, a as ContentBlock, I as InitializeResult, J as JSONRPC_INTERNAL_ERROR, b as JSONRPC_INVALID_PARAMS, c as JSONRPC_INVALID_REQUEST, d as JSONRPC_METHOD_NOT_FOUND, e as JSONRPC_PARSE_ERROR, f as JsonObject, g as JsonRpcError, h as JsonRpcId, j as JsonRpcNotification, k as JsonRpcRequest, l as JsonRpcSuccess, m as JsonValue, M as MCP_PROTOCOL_VERSION, R as RegisteredTool, S as ServerCapabilities, n as ServerInfo, T as ToolDefinition, o as ToolHandler, p as ToolInputSchema } from '../types-C2zdUpzn.js';
-import '../tool-host-DldwGNqR.js';
+import { T as Transport, M as MicroMcpServer } from '../server-Du3-IGqM.js';
+export { a as McpServerOptions, e as errorResult, r as rpcError, t as textResult } from '../server-Du3-IGqM.js';
+import { J as JsonRpcMessage } from '../types-aOQLTW0E.js';
+export { C as CallToolResult, d as ContentBlock, I as InitializeResult, h as JSONRPC_INTERNAL_ERROR, i as JSONRPC_INVALID_PARAMS, j as JSONRPC_INVALID_REQUEST, k as JSONRPC_METHOD_NOT_FOUND, l as JSONRPC_PARSE_ERROR, c as JsonObject, m as JsonRpcError, n as JsonRpcId, e as JsonRpcNotification, f as JsonRpcRequest, o as JsonRpcSuccess, g as JsonValue, M as MCP_PROTOCOL_VERSION, R as RegisteredTool, a as ServerCapabilities, S as ServerInfo, T as ToolDefinition, b as ToolHandler, p as ToolInputSchema } from '../types-aOQLTW0E.js';
+import '../tool-host-C8JMMGYq.js';
 
 /**
  * InProcessTransport — direct function-call wiring between an in-page MCP

package/dist/presence/index.d.cts

@@ -1,60 +1,6 @@
-import { C as CallToolResult } from '../types-C2zdUpzn.cjs';
-
-/**
- * Presence layer types — describe what the agent is doing right now and
- * where. Every bridge tool emits one of these when it runs; the registry
- * fans them out to in-process subscribers + the SSE relay so external
- * clients can render presence indicators across the whole app.
- */
-type AgentTargetKind = "whiteboard" | "flow" | "form" | "sheet" | "code" | "chart" | "scene" | "custom";
-type AgentTarget = {
-    /** Which package surface the action affects. */
-    kind: AgentTargetKind | string;
-    /** Optional fancy-screens screen id, for screen-scoped UIs. */
-    screenId?: string;
-    /** Optional element id within the surface (sticky id, node id, field name, …). */
-    elementId?: string;
-    /** Free-form label the host can render (e.g. "the 'email' field"). */
-    label?: string;
-};
-type AgentActivityEvent = {
-    /** Stable identifier for the acting agent. */
-    agentId: string;
-    /** Human-friendly name (used by indicators / activity log). */
-    agentName?: string;
-    /** Color for cursor / highlight CSS. */
-    agentColor?: string;
-    /** What the agent is touching. */
-    target: AgentTarget;
-    /** Snake-case action verb mirroring the tool name (e.g. "whiteboard_add_sticky"). */
-    action: string;
-    /** Wall-clock ms — when the action ran. */
-    timestamp: number;
-    /** Optional small structured payload describing the action's effect. */
-    meta?: Record<string, unknown>;
-    /** Optional duration in ms — how long the activity should "stick" on the
-     *  UI before fading. Default 1500. */
-    ttlMs?: number;
-};
-type AgentActivityListener = (event: AgentActivityEvent) => void;
-type ActivityFilter = {
-    agentId?: string;
-    screenId?: string;
-    kind?: string;
-};
-
-/** Emit an activity event. All current listeners receive it synchronously. */
-declare function emitActivity(event: AgentActivityEvent): void;
-/**
- * Subscribe to all events (or a filtered subset). Returns an unsubscribe
- * function. Filter checks all provided keys with strict equality; omit a
- * key to ignore it.
- */
-declare function onActivity(listener: AgentActivityListener, filter?: ActivityFilter): () => void;
-/** Read the recent history (newest last). Optional filter. */
-declare function readActivityHistory(filter?: ActivityFilter): AgentActivityEvent[];
-/** Wipe history + clear listeners. Test/teardown helper. */
-declare function resetActivityRegistry(): void;
+import { AutoTarget, ActivityFilter, AutoActivityEvent } from '@particle-academy/fancy-auto-common';
+export { ActivityFilter, AutoActivityEvent as AgentActivityEvent, AutoActivityListener as AgentActivityListener, AutoTarget as AgentTarget, AutoTargetKind as AgentTargetKind, emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from '@particle-academy/fancy-auto-common';
+import { C as CallToolResult } from '../types-aOQLTW0E.cjs';
 
 type ActivityAgent = {
     id: string;
@@ -77,7 +23,7 @@ type ActivityResolverContext<TArgs = Record<string, unknown>> = {
  * The resolver runs AFTER the tool handler so it can inspect the result
  * (e.g. read a newly-created item id from `structuredContent`).
  */
-type ActivityTargetResolver<TArgs = Record<string, unknown>> = (ctx: ActivityResolverContext<TArgs>) => AgentTarget | null;
+type ActivityTargetResolver<TArgs = Record<string, unknown>> = (ctx: ActivityResolverContext<TArgs>) => AutoTarget | null;
 type ToolHandler<TArgs = Record<string, unknown>> = (args: TArgs) => Promise<CallToolResult> | CallToolResult;
 /**
  * wrapToolWithActivity — decorate a bridge tool handler so every successful
@@ -101,7 +47,7 @@ declare function wrapToolWithActivity<TArgs = Record<string, unknown>>(handler:
     /** Optional fancy-screens screen id this bridge is scoped to. */
     screenId?: string;
     /** Default target kind if the resolver returns one without `kind`. */
-    kind: AgentTarget["kind"];
+    kind: AutoTarget["kind"];
     /** Per-call resolver. Return `null` to skip emitting (e.g. for read-only tools). */
     resolveTarget?: ActivityTargetResolver<TArgs>;
     /** Optional ttl override. */
@@ -118,8 +64,8 @@ declare function wrapToolWithActivity<TArgs = Record<string, unknown>>(handler:
 declare function useAgentActivity(filter?: ActivityFilter, options?: {
     capacity?: number;
 }): {
-    events: AgentActivityEvent[];
-    latest: AgentActivityEvent | null;
+    events: AutoActivityEvent[];
+    latest: AutoActivityEvent | null;
 };
 /**
  * useAgentActivityForScreen — convenience wrapper that filters by screen id.
@@ -128,9 +74,9 @@ declare function useAgentActivity(filter?: ActivityFilter, options?: {
 declare function useAgentActivityForScreen(screenId: string, options?: {
     capacity?: number;
 }): {
-    events: AgentActivityEvent[];
-    latest: AgentActivityEvent | null;
+    events: AutoActivityEvent[];
+    latest: AutoActivityEvent | null;
     isAgentActive: boolean;
 };
 
-export { type ActivityAgent, type ActivityFilter, type ActivityResolverContext, type ActivityTargetResolver, type AgentActivityEvent, type AgentActivityListener, type AgentTarget, type AgentTargetKind, type ToolHandler, emitActivity, onActivity, readActivityHistory, resetActivityRegistry, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity };
+export { type ActivityAgent, type ActivityResolverContext, type ActivityTargetResolver, type ToolHandler, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity };

package/dist/presence/index.d.ts

@@ -1,60 +1,6 @@
-import { C as CallToolResult } from '../types-C2zdUpzn.js';
-
-/**
- * Presence layer types — describe what the agent is doing right now and
- * where. Every bridge tool emits one of these when it runs; the registry
- * fans them out to in-process subscribers + the SSE relay so external
- * clients can render presence indicators across the whole app.
- */
-type AgentTargetKind = "whiteboard" | "flow" | "form" | "sheet" | "code" | "chart" | "scene" | "custom";
-type AgentTarget = {
-    /** Which package surface the action affects. */
-    kind: AgentTargetKind | string;
-    /** Optional fancy-screens screen id, for screen-scoped UIs. */
-    screenId?: string;
-    /** Optional element id within the surface (sticky id, node id, field name, …). */
-    elementId?: string;
-    /** Free-form label the host can render (e.g. "the 'email' field"). */
-    label?: string;
-};
-type AgentActivityEvent = {
-    /** Stable identifier for the acting agent. */
-    agentId: string;
-    /** Human-friendly name (used by indicators / activity log). */
-    agentName?: string;
-    /** Color for cursor / highlight CSS. */
-    agentColor?: string;
-    /** What the agent is touching. */
-    target: AgentTarget;
-    /** Snake-case action verb mirroring the tool name (e.g. "whiteboard_add_sticky"). */
-    action: string;
-    /** Wall-clock ms — when the action ran. */
-    timestamp: number;
-    /** Optional small structured payload describing the action's effect. */
-    meta?: Record<string, unknown>;
-    /** Optional duration in ms — how long the activity should "stick" on the
-     *  UI before fading. Default 1500. */
-    ttlMs?: number;
-};
-type AgentActivityListener = (event: AgentActivityEvent) => void;
-type ActivityFilter = {
-    agentId?: string;
-    screenId?: string;
-    kind?: string;
-};
-
-/** Emit an activity event. All current listeners receive it synchronously. */
-declare function emitActivity(event: AgentActivityEvent): void;
-/**
- * Subscribe to all events (or a filtered subset). Returns an unsubscribe
- * function. Filter checks all provided keys with strict equality; omit a
- * key to ignore it.
- */
-declare function onActivity(listener: AgentActivityListener, filter?: ActivityFilter): () => void;
-/** Read the recent history (newest last). Optional filter. */
-declare function readActivityHistory(filter?: ActivityFilter): AgentActivityEvent[];
-/** Wipe history + clear listeners. Test/teardown helper. */
-declare function resetActivityRegistry(): void;
+import { AutoTarget, ActivityFilter, AutoActivityEvent } from '@particle-academy/fancy-auto-common';
+export { ActivityFilter, AutoActivityEvent as AgentActivityEvent, AutoActivityListener as AgentActivityListener, AutoTarget as AgentTarget, AutoTargetKind as AgentTargetKind, emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from '@particle-academy/fancy-auto-common';
+import { C as CallToolResult } from '../types-aOQLTW0E.js';
 
 type ActivityAgent = {
     id: string;
@@ -77,7 +23,7 @@ type ActivityResolverContext<TArgs = Record<string, unknown>> = {
  * The resolver runs AFTER the tool handler so it can inspect the result
  * (e.g. read a newly-created item id from `structuredContent`).
  */
-type ActivityTargetResolver<TArgs = Record<string, unknown>> = (ctx: ActivityResolverContext<TArgs>) => AgentTarget | null;
+type ActivityTargetResolver<TArgs = Record<string, unknown>> = (ctx: ActivityResolverContext<TArgs>) => AutoTarget | null;
 type ToolHandler<TArgs = Record<string, unknown>> = (args: TArgs) => Promise<CallToolResult> | CallToolResult;
 /**
  * wrapToolWithActivity — decorate a bridge tool handler so every successful
@@ -101,7 +47,7 @@ declare function wrapToolWithActivity<TArgs = Record<string, unknown>>(handler:
     /** Optional fancy-screens screen id this bridge is scoped to. */
     screenId?: string;
     /** Default target kind if the resolver returns one without `kind`. */
-    kind: AgentTarget["kind"];
+    kind: AutoTarget["kind"];
     /** Per-call resolver. Return `null` to skip emitting (e.g. for read-only tools). */
     resolveTarget?: ActivityTargetResolver<TArgs>;
     /** Optional ttl override. */
@@ -118,8 +64,8 @@ declare function wrapToolWithActivity<TArgs = Record<string, unknown>>(handler:
 declare function useAgentActivity(filter?: ActivityFilter, options?: {
     capacity?: number;
 }): {
-    events: AgentActivityEvent[];
-    latest: AgentActivityEvent | null;
+    events: AutoActivityEvent[];
+    latest: AutoActivityEvent | null;
 };
 /**
  * useAgentActivityForScreen — convenience wrapper that filters by screen id.
@@ -128,9 +74,9 @@ declare function useAgentActivity(filter?: ActivityFilter, options?: {
 declare function useAgentActivityForScreen(screenId: string, options?: {
     capacity?: number;
 }): {
-    events: AgentActivityEvent[];
-    latest: AgentActivityEvent | null;
+    events: AutoActivityEvent[];
+    latest: AutoActivityEvent | null;
     isAgentActive: boolean;
 };
 
-export { type ActivityAgent, type ActivityFilter, type ActivityResolverContext, type ActivityTargetResolver, type AgentActivityEvent, type AgentActivityListener, type AgentTarget, type AgentTargetKind, type ToolHandler, emitActivity, onActivity, readActivityHistory, resetActivityRegistry, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity };
+export { type ActivityAgent, type ActivityResolverContext, type ActivityTargetResolver, type ToolHandler, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity };

package/dist/presence.cjs

@@ -1,37 +1,9 @@
 'use strict';
 
+var fancyAutoCommon = require('@particle-academy/fancy-auto-common');
 var react = require('react');
 
 // src/presence/registry.ts
-var HISTORY_CAP = 200;
-var listeners = /* @__PURE__ */ new Set();
-var history = [];
-function emitActivity(event) {
-  history.push(event);
-  if (history.length > HISTORY_CAP) history.splice(0, history.length - HISTORY_CAP);
-  for (const l of listeners) l(event);
-}
-function onActivity(listener, filter) {
-  const wrapped = filter ? (e) => {
-    if (matches(e, filter)) listener(e);
-  } : listener;
-  listeners.add(wrapped);
-  return () => listeners.delete(wrapped);
-}
-function readActivityHistory(filter) {
-  if (!filter) return history.slice();
-  return history.filter((e) => matches(e, filter));
-}
-function resetActivityRegistry() {
-  listeners.clear();
-  history.length = 0;
-}
-function matches(e, f) {
-  if (f.agentId !== void 0 && e.agentId !== f.agentId) return false;
-  if (f.screenId !== void 0 && e.target.screenId !== f.screenId) return false;
-  if (f.kind !== void 0 && e.target.kind !== f.kind) return false;
-  return true;
-}
 
 // src/presence/wrap-tool-with-activity.ts
 function wrapToolWithActivity(handler, options) {
@@ -45,7 +17,7 @@ function wrapToolWithActivity(handler, options) {
       target = { kind: options.kind, screenId: options.screenId };
     }
     if (!target) return result;
-    emitActivity({
+    fancyAutoCommon.emitActivity({
       agentId: options.agent.id,
       agentName: options.agent.name,
       agentColor: options.agent.color,
@@ -67,10 +39,10 @@ function extractMeta(result) {
 }
 function useAgentActivity(filter, options = {}) {
   const cap = options.capacity ?? 50;
-  const [events, setEvents] = react.useState(() => readActivityHistory(filter).slice(-cap));
+  const [events, setEvents] = react.useState(() => fancyAutoCommon.readActivityHistory(filter).slice(-cap));
   react.useEffect(() => {
-    setEvents(readActivityHistory(filter).slice(-cap));
-    return onActivity((event) => {
+    setEvents(fancyAutoCommon.readActivityHistory(filter).slice(-cap));
+    return fancyAutoCommon.onActivity((event) => {
       setEvents((prev) => {
         const next = prev.length >= cap ? prev.slice(prev.length - cap + 1) : prev.slice();
         next.push(event);
@@ -96,10 +68,22 @@ function useAgentActivityForScreen(screenId, options = {}) {
   return { events, latest, isAgentActive };
 }
 
-exports.emitActivity = emitActivity;
-exports.onActivity = onActivity;
-exports.readActivityHistory = readActivityHistory;
-exports.resetActivityRegistry = resetActivityRegistry;
+Object.defineProperty(exports, "emitActivity", {
+  enumerable: true,
+  get: function () { return fancyAutoCommon.emitActivity; }
+});
+Object.defineProperty(exports, "onActivity", {
+  enumerable: true,
+  get: function () { return fancyAutoCommon.onActivity; }
+});
+Object.defineProperty(exports, "readActivityHistory", {
+  enumerable: true,
+  get: function () { return fancyAutoCommon.readActivityHistory; }
+});
+Object.defineProperty(exports, "resetActivityRegistry", {
+  enumerable: true,
+  get: function () { return fancyAutoCommon.resetActivityRegistry; }
+});
 exports.useAgentActivity = useAgentActivity;
 exports.useAgentActivityForScreen = useAgentActivityForScreen;
 exports.wrapToolWithActivity = wrapToolWithActivity;

package/dist/presence.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/presence/registry.ts","../src/presence/wrap-tool-with-activity.ts","../src/presence/use-agent-activity.ts"],"names":["useState","useEffect"],"mappings":"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","file":"presence.cjs","sourcesContent":["import type { ActivityFilter, AgentActivityEvent, AgentActivityListener } from \"./types\";\n\n/**\n * In-process registry of agent activity events. Bridges call `emitActivity`\n * after a tool runs; React hooks + the SSE relay subscribe via\n * `onActivity()`.\n *\n * Holds a short scrollback of recent events (default 200) so newly-mounted\n * subscribers can render the recent past — useful for activity-log UIs\n * that rejoin a session mid-stream.\n */\n\nconst HISTORY_CAP = 200;\n\nconst listeners = new Set<AgentActivityListener>();\nconst history: AgentActivityEvent[] = [];\n\n/** Emit an activity event. All current listeners receive it synchronously. */\nexport function emitActivity(event: AgentActivityEvent): void {\n  history.push(event);\n  if (history.length > HISTORY_CAP) history.splice(0, history.length - HISTORY_CAP);\n  for (const l of listeners) l(event);\n}\n\n/**\n * Subscribe to all events (or a filtered subset). Returns an unsubscribe\n * function. Filter checks all provided keys with strict equality; omit a\n * key to ignore it.\n */\nexport function onActivity(listener: AgentActivityListener, filter?: ActivityFilter): () => void {\n  const wrapped: AgentActivityListener = filter\n    ? (e) => { if (matches(e, filter)) listener(e); }\n    : listener;\n  listeners.add(wrapped);\n  return () => listeners.delete(wrapped);\n}\n\n/** Read the recent history (newest last). Optional filter. */\nexport function readActivityHistory(filter?: ActivityFilter): AgentActivityEvent[] {\n  if (!filter) return history.slice();\n  return history.filter((e) => matches(e, filter));\n}\n\n/** Wipe history + clear listeners. Test/teardown helper. */\nexport function resetActivityRegistry(): void {\n  listeners.clear();\n  history.length = 0;\n}\n\nfunction matches(e: AgentActivityEvent, f: ActivityFilter): boolean {\n  if (f.agentId !== undefined && e.agentId !== f.agentId) return false;\n  if (f.screenId !== undefined && e.target.screenId !== f.screenId) return false;\n  if (f.kind !== undefined && e.target.kind !== f.kind) return false;\n  return true;\n}\n","import type { CallToolResult } from \"../mcp/types\";\nimport { emitActivity } from \"./registry\";\nimport type { AgentTarget } from \"./types\";\n\nexport type ActivityAgent = { id: string; name?: string; color?: string };\n\nexport type ActivityResolverContext<TArgs = Record<string, unknown>> = {\n  /** Tool name as registered. */\n  toolName: string;\n  /** Arguments the tool was called with. */\n  args: TArgs;\n  /** The CallToolResult the underlying handler produced. */\n  result: CallToolResult;\n};\n\n/**\n * Resolves an `AgentTarget` for an executed tool. Bridges declare one of\n * these per registration so the wrapper knows which surface / element /\n * screen the activity belongs to.\n *\n * The resolver runs AFTER the tool handler so it can inspect the result\n * (e.g. read a newly-created item id from `structuredContent`).\n */\nexport type ActivityTargetResolver<TArgs = Record<string, unknown>> = (\n  ctx: ActivityResolverContext<TArgs>,\n) => AgentTarget | null;\n\nexport type ToolHandler<TArgs = Record<string, unknown>> = (\n  args: TArgs,\n) => Promise<CallToolResult> | CallToolResult;\n\n/**\n * wrapToolWithActivity — decorate a bridge tool handler so every successful\n * call emits an `AgentActivityEvent`. Returns a new handler with the same shape.\n *\n * Usage in a bridge:\n *\n *   server.registerTool(\n *     definition,\n *     wrapToolWithActivity(\n *       handler,\n *       { agent, kind: \"whiteboard\", resolveTarget: ({ args }) => ({\n *           kind: \"whiteboard\", elementId: args.id as string,\n *         }) },\n *     ),\n *   );\n */\nexport function wrapToolWithActivity<TArgs = Record<string, unknown>>(\n  handler: ToolHandler<TArgs>,\n  options: {\n    toolName: string;\n    agent: ActivityAgent;\n    /** Optional fancy-screens screen id this bridge is scoped to. */\n    screenId?: string;\n    /** Default target kind if the resolver returns one without `kind`. */\n    kind: AgentTarget[\"kind\"];\n    /** Per-call resolver. Return `null` to skip emitting (e.g. for read-only tools). */\n    resolveTarget?: ActivityTargetResolver<TArgs>;\n    /** Optional ttl override. */\n    ttlMs?: number;\n  },\n): ToolHandler<TArgs> {\n  return async (args) => {\n    const result = await handler(args);\n    if (result.isError) return result;\n\n    let target: AgentTarget | null;\n    if (options.resolveTarget) {\n      target = options.resolveTarget({ toolName: options.toolName, args, result });\n    } else {\n      target = { kind: options.kind, screenId: options.screenId };\n    }\n    if (!target) return result;\n\n    emitActivity({\n      agentId: options.agent.id,\n      agentName: options.agent.name,\n      agentColor: options.agent.color,\n      target: { ...target, kind: target.kind ?? options.kind, screenId: target.screenId ?? options.screenId },\n      action: options.toolName,\n      timestamp: Date.now(),\n      meta: extractMeta(result),\n      ttlMs: options.ttlMs,\n    });\n    return result;\n  };\n}\n\nfunction extractMeta(result: CallToolResult): Record<string, unknown> | undefined {\n  const sc = result.structuredContent;\n  if (sc && typeof sc === \"object\" && !Array.isArray(sc)) {\n    return sc as Record<string, unknown>;\n  }\n  return undefined;\n}\n","import { useEffect, useState } from \"react\";\nimport { onActivity, readActivityHistory } from \"./registry\";\nimport type { ActivityFilter, AgentActivityEvent } from \"./types\";\n\n/**\n * useAgentActivity — React subscription to the in-process activity stream.\n *\n * Returns:\n *   - `events`: capped scrollback of recent events matching the filter\n *   - `latest`: the most recent event (handy for transient highlights)\n */\nexport function useAgentActivity(\n  filter?: ActivityFilter,\n  options: { capacity?: number } = {},\n): { events: AgentActivityEvent[]; latest: AgentActivityEvent | null } {\n  const cap = options.capacity ?? 50;\n  const [events, setEvents] = useState<AgentActivityEvent[]>(() => readActivityHistory(filter).slice(-cap));\n\n  useEffect(() => {\n    setEvents(readActivityHistory(filter).slice(-cap));\n    return onActivity((event) => {\n      setEvents((prev) => {\n        const next = prev.length >= cap ? prev.slice(prev.length - cap + 1) : prev.slice();\n        next.push(event);\n        return next;\n      });\n    }, filter);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [filter?.agentId, filter?.screenId, filter?.kind, cap]);\n\n  return { events, latest: events.length > 0 ? events[events.length - 1] : null };\n}\n\n/**\n * useAgentActivityForScreen — convenience wrapper that filters by screen id.\n * Drives \"agent is here\" badges in fancy-screens-based shells.\n */\nexport function useAgentActivityForScreen(\n  screenId: string,\n  options: { capacity?: number } = {},\n): { events: AgentActivityEvent[]; latest: AgentActivityEvent | null; isAgentActive: boolean } {\n  const { events, latest } = useAgentActivity({ screenId }, options);\n  const fadeAfter = latest?.ttlMs ?? 1500;\n  const [isAgentActive, setActive] = useState(false);\n\n  useEffect(() => {\n    if (!latest) {\n      setActive(false);\n      return;\n    }\n    setActive(true);\n    const timer = setTimeout(() => setActive(false), fadeAfter);\n    return () => clearTimeout(timer);\n  }, [latest, fadeAfter]);\n\n  return { events, latest, isAgentActive };\n}\n"]}
+{"version":3,"sources":["../src/presence/wrap-tool-with-activity.ts","../src/presence/use-agent-activity.ts"],"names":["emitActivity","useState","readActivityHistory","useEffect","onActivity"],"mappings":";;;;;;;;AA+CO,SAAS,oBAAA,CACd,SACA,OAAA,EAYoB;AACpB,EAAA,OAAO,OAAO,IAAA,KAAS;AACrB,IAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,IAAI,CAAA;AACjC,IAAA,IAAI,MAAA,CAAO,SAAS,OAAO,MAAA;AAE3B,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI,QAAQ,aAAA,EAAe;AACzB,MAAA,MAAA,GAAS,OAAA,CAAQ,cAAc,EAAE,QAAA,EAAU,QAAQ,QAAA,EAAU,IAAA,EAAM,QAAQ,CAAA;AAAA,IAC7E,CAAA,MAAO;AACL,MAAA,MAAA,GAAS,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAM,QAAA,EAAU,QAAQ,QAAA,EAAS;AAAA,IAC5D;AACA,IAAA,IAAI,CAAC,QAAQ,OAAO,MAAA;AAEpB,IAAAA,4BAAA,CAAa;AAAA,MACX,OAAA,EAAS,QAAQ,KAAA,CAAM,EAAA;AAAA,MACvB,SAAA,EAAW,QAAQ,KAAA,CAAM,IAAA;AAAA,MACzB,UAAA,EAAY,QAAQ,KAAA,CAAM,KAAA;AAAA,MAC1B,MAAA,EAAQ,EAAE,GAAG,MAAA,EAAQ,IAAA,EAAM,MAAA,CAAO,IAAA,IAAQ,OAAA,CAAQ,IAAA,EAAM,QAAA,EAAU,MAAA,CAAO,QAAA,IAAY,QAAQ,QAAA,EAAS;AAAA,MACtG,QAAQ,OAAA,CAAQ,QAAA;AAAA,MAChB,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,MACpB,IAAA,EAAM,YAAY,MAAM,CAAA;AAAA,MACxB,OAAO,OAAA,CAAQ;AAAA,KAChB,CAAA;AACD,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACF;AAEA,SAAS,YAAY,MAAA,EAA6D;AAChF,EAAA,MAAM,KAAK,MAAA,CAAO,iBAAA;AAClB,EAAA,IAAI,EAAA,IAAM,OAAO,EAAA,KAAO,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,EAAE,CAAA,EAAG;AACtD,IAAA,OAAO,EAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA;AACT;ACnFO,SAAS,gBAAA,CACd,MAAA,EACA,OAAA,GAAiC,EAAC,EACmC;AACrE,EAAA,MAAM,GAAA,GAAM,QAAQ,QAAA,IAAY,EAAA;AAChC,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIC,cAAA,CAA+B,MAAMC,mCAAA,CAAoB,MAAM,CAAA,CAAE,KAAA,CAAM,CAAC,GAAG,CAAC,CAAA;AAExG,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,SAAA,CAAUD,oCAAoB,MAAM,CAAA,CAAE,KAAA,CAAM,CAAC,GAAG,CAAC,CAAA;AACjD,IAAA,OAAOE,0BAAA,CAAW,CAAC,KAAA,KAAU;AAC3B,MAAA,SAAA,CAAU,CAAC,IAAA,KAAS;AAClB,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,IAAU,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,GAAS,GAAA,GAAM,CAAC,CAAA,GAAI,IAAA,CAAK,KAAA,EAAM;AACjF,QAAA,IAAA,CAAK,KAAK,KAAK,CAAA;AACf,QAAA,OAAO,IAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH,GAAG,MAAM,CAAA;AAAA,EAEX,CAAA,EAAG,CAAC,MAAA,EAAQ,OAAA,EAAS,QAAQ,QAAA,EAAU,MAAA,EAAQ,IAAA,EAAM,GAAG,CAAC,CAAA;AAEzD,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,MAAA,CAAO,MAAA,GAAS,CAAA,GAAI,MAAA,CAAO,MAAA,CAAO,MAAA,GAAS,CAAC,CAAA,GAAI,IAAA,EAAK;AAChF;AAMO,SAAS,yBAAA,CACd,QAAA,EACA,OAAA,GAAiC,EAAC,EAC2D;AAC7F,EAAA,MAAM,EAAE,QAAQ,MAAA,EAAO,GAAI,iBAAiB,EAAE,QAAA,IAAY,OAAO,CAAA;AACjE,EAAA,MAAM,SAAA,GAAY,QAAQ,KAAA,IAAS,IAAA;AACnC,EAAA,MAAM,CAAC,aAAA,EAAe,SAAS,CAAA,GAAIH,eAAS,KAAK,CAAA;AAEjD,EAAAE,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,SAAA,CAAU,KAAK,CAAA;AACf,MAAA;AAAA,IACF;AACA,IAAA,SAAA,CAAU,IAAI,CAAA;AACd,IAAA,MAAM,QAAQ,UAAA,CAAW,MAAM,SAAA,CAAU,KAAK,GAAG,SAAS,CAAA;AAC1D,IAAA,OAAO,MAAM,aAAa,KAAK,CAAA;AAAA,EACjC,CAAA,EAAG,CAAC,MAAA,EAAQ,SAAS,CAAC,CAAA;AAEtB,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,aAAA,EAAc;AACzC","file":"presence.cjs","sourcesContent":["import type { CallToolResult } from \"../mcp/types\";\nimport { emitActivity } from \"./registry\";\nimport type { AgentTarget } from \"./types\";\n\nexport type ActivityAgent = { id: string; name?: string; color?: string };\n\nexport type ActivityResolverContext<TArgs = Record<string, unknown>> = {\n  /** Tool name as registered. */\n  toolName: string;\n  /** Arguments the tool was called with. */\n  args: TArgs;\n  /** The CallToolResult the underlying handler produced. */\n  result: CallToolResult;\n};\n\n/**\n * Resolves an `AgentTarget` for an executed tool. Bridges declare one of\n * these per registration so the wrapper knows which surface / element /\n * screen the activity belongs to.\n *\n * The resolver runs AFTER the tool handler so it can inspect the result\n * (e.g. read a newly-created item id from `structuredContent`).\n */\nexport type ActivityTargetResolver<TArgs = Record<string, unknown>> = (\n  ctx: ActivityResolverContext<TArgs>,\n) => AgentTarget | null;\n\nexport type ToolHandler<TArgs = Record<string, unknown>> = (\n  args: TArgs,\n) => Promise<CallToolResult> | CallToolResult;\n\n/**\n * wrapToolWithActivity — decorate a bridge tool handler so every successful\n * call emits an `AgentActivityEvent`. Returns a new handler with the same shape.\n *\n * Usage in a bridge:\n *\n *   server.registerTool(\n *     definition,\n *     wrapToolWithActivity(\n *       handler,\n *       { agent, kind: \"whiteboard\", resolveTarget: ({ args }) => ({\n *           kind: \"whiteboard\", elementId: args.id as string,\n *         }) },\n *     ),\n *   );\n */\nexport function wrapToolWithActivity<TArgs = Record<string, unknown>>(\n  handler: ToolHandler<TArgs>,\n  options: {\n    toolName: string;\n    agent: ActivityAgent;\n    /** Optional fancy-screens screen id this bridge is scoped to. */\n    screenId?: string;\n    /** Default target kind if the resolver returns one without `kind`. */\n    kind: AgentTarget[\"kind\"];\n    /** Per-call resolver. Return `null` to skip emitting (e.g. for read-only tools). */\n    resolveTarget?: ActivityTargetResolver<TArgs>;\n    /** Optional ttl override. */\n    ttlMs?: number;\n  },\n): ToolHandler<TArgs> {\n  return async (args) => {\n    const result = await handler(args);\n    if (result.isError) return result;\n\n    let target: AgentTarget | null;\n    if (options.resolveTarget) {\n      target = options.resolveTarget({ toolName: options.toolName, args, result });\n    } else {\n      target = { kind: options.kind, screenId: options.screenId };\n    }\n    if (!target) return result;\n\n    emitActivity({\n      agentId: options.agent.id,\n      agentName: options.agent.name,\n      agentColor: options.agent.color,\n      target: { ...target, kind: target.kind ?? options.kind, screenId: target.screenId ?? options.screenId },\n      action: options.toolName,\n      timestamp: Date.now(),\n      meta: extractMeta(result),\n      ttlMs: options.ttlMs,\n    });\n    return result;\n  };\n}\n\nfunction extractMeta(result: CallToolResult): Record<string, unknown> | undefined {\n  const sc = result.structuredContent;\n  if (sc && typeof sc === \"object\" && !Array.isArray(sc)) {\n    return sc as Record<string, unknown>;\n  }\n  return undefined;\n}\n","import { useEffect, useState } from \"react\";\nimport { onActivity, readActivityHistory } from \"./registry\";\nimport type { ActivityFilter, AgentActivityEvent } from \"./types\";\n\n/**\n * useAgentActivity — React subscription to the in-process activity stream.\n *\n * Returns:\n *   - `events`: capped scrollback of recent events matching the filter\n *   - `latest`: the most recent event (handy for transient highlights)\n */\nexport function useAgentActivity(\n  filter?: ActivityFilter,\n  options: { capacity?: number } = {},\n): { events: AgentActivityEvent[]; latest: AgentActivityEvent | null } {\n  const cap = options.capacity ?? 50;\n  const [events, setEvents] = useState<AgentActivityEvent[]>(() => readActivityHistory(filter).slice(-cap));\n\n  useEffect(() => {\n    setEvents(readActivityHistory(filter).slice(-cap));\n    return onActivity((event) => {\n      setEvents((prev) => {\n        const next = prev.length >= cap ? prev.slice(prev.length - cap + 1) : prev.slice();\n        next.push(event);\n        return next;\n      });\n    }, filter);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [filter?.agentId, filter?.screenId, filter?.kind, cap]);\n\n  return { events, latest: events.length > 0 ? events[events.length - 1] : null };\n}\n\n/**\n * useAgentActivityForScreen — convenience wrapper that filters by screen id.\n * Drives \"agent is here\" badges in fancy-screens-based shells.\n */\nexport function useAgentActivityForScreen(\n  screenId: string,\n  options: { capacity?: number } = {},\n): { events: AgentActivityEvent[]; latest: AgentActivityEvent | null; isAgentActive: boolean } {\n  const { events, latest } = useAgentActivity({ screenId }, options);\n  const fadeAfter = latest?.ttlMs ?? 1500;\n  const [isAgentActive, setActive] = useState(false);\n\n  useEffect(() => {\n    if (!latest) {\n      setActive(false);\n      return;\n    }\n    setActive(true);\n    const timer = setTimeout(() => setActive(false), fadeAfter);\n    return () => clearTimeout(timer);\n  }, [latest, fadeAfter]);\n\n  return { events, latest, isAgentActive };\n}\n"]}

package/dist/presence.js

@@ -1,5 +1,5 @@
-export { useAgentActivity, useAgentActivityForScreen } from './chunk-X66JWQBB.js';
-export { wrapToolWithActivity } from './chunk-52S7XYZK.js';
-export { emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from './chunk-JU2N4KK6.js';
+export { useAgentActivity, useAgentActivityForScreen } from './chunk-UCKJAUBY.js';
+export { wrapToolWithActivity } from './chunk-ULJL53DL.js';
+export { emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from './chunk-C3TYI5TJ.js';
 //# sourceMappingURL=presence.js.map
 //# sourceMappingURL=presence.js.map

package/dist/registry-TFWVXQOU.js

@@ -0,0 +1,3 @@
+export { emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from './chunk-C3TYI5TJ.js';
+//# sourceMappingURL=registry-TFWVXQOU.js.map
+//# sourceMappingURL=registry-TFWVXQOU.js.map

package/dist/{registry-2DRURS6U.js.map → registry-TFWVXQOU.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"registry-2DRURS6U.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"registry-TFWVXQOU.js"}

package/dist/{server-C2OpfPEo.d.cts → server-BsSwfemr.d.cts}

@@ -1,5 +1,5 @@
-import { n as ServerInfo, S as ServerCapabilities, i as JsonRpcMessage, C as CallToolResult } from './types-C2zdUpzn.cjs';
-import { a as ToolRegistry } from './tool-host-CX3WFXgh.cjs';
+import { S as ServerInfo, a as ServerCapabilities, J as JsonRpcMessage, C as CallToolResult } from './types-aOQLTW0E.cjs';
+import { a as ToolRegistry } from './tool-host-BQuUygLF.cjs';
 
 type McpServerOptions = {
     info: ServerInfo;
@@ -60,4 +60,4 @@ declare function rpcError(code: number, message: string, data?: any): {
 declare function textResult(text: string, structured?: any): CallToolResult;
 declare function errorResult(text: string): CallToolResult;
 
-export { type McpServerOptions as M, type Transport as T, MicroMcpServer as a, errorResult as e, rpcError as r, textResult as t };
+export { MicroMcpServer as M, type Transport as T, type McpServerOptions as a, errorResult as e, rpcError as r, textResult as t };