@ouispec/agent-react 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAChG,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAClF,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/entity/index.js

@@ -0,0 +1,6 @@
+export { AgentEntityComponent } from './AgentEntityComponent.js';
+export { defineAgentEntity } from './defineAgentEntity.js';
+export { AgentEntity } from './AgentEntity.js';
+export { asAgentEntity } from './asAgentEntity.js';
+export { useViewAnnotation } from './useViewAnnotation.js';
+//# sourceMappingURL=index.js.map

package/dist/entity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/entity/useViewAnnotation.d.ts

@@ -0,0 +1,64 @@
+import type { EntityCapabilities, EntityDisplayContext, AgentAction, AgentCommand, AgentCommandResponse, UserObservation, EntityExecuteOptions, IntentResult, Unsubscribe } from '@ouispec/agent-core';
+/**
+ * Options for the useViewAnnotation hook.
+ */
+export interface UseViewAnnotationOptions {
+    entity: {
+        type: string;
+        id: string;
+    };
+    intents?: string[];
+    displayContext: EntityDisplayContext;
+    capabilities?: EntityCapabilities;
+    metadata?: Record<string, unknown>;
+    onTargeted?: (action: AgentAction) => void;
+    onReleased?: () => void;
+    onExecuting?: (intentId: string, params: Record<string, unknown>) => void;
+    onExecutionComplete?: (intentId: string, result: IntentResult) => void;
+    onCommandReceived?: (command: AgentCommand) => AgentCommandResponse | Promise<AgentCommandResponse> | void;
+    onObserve?: (observation: UserObservation) => void;
+}
+/**
+ * Return value of useViewAnnotation — provides the ref callback and agent entity state/methods.
+ */
+export interface UseViewAnnotationReturn {
+    ref: (element: HTMLElement | null) => void;
+    isTargeted: boolean;
+    isExecuting: boolean;
+    currentAction: AgentAction | null;
+    execute: (intentId: string, params?: Record<string, unknown>, options?: EntityExecuteOptions) => Promise<IntentResult>;
+    emit: (signal: string, data?: unknown) => void;
+    subscribe: (event: string, handler: (data: unknown) => void) => Unsubscribe;
+}
+/**
+ * useViewAnnotation — hook that registers a DOM element as an agent-addressable entity.
+ *
+ * This is the escape-hatch pattern for SVGs, portals, canvas overlays, or any case
+ * where class inheritance or wrapper components don't fit.
+ *
+ * Now delegates to the core AgentEntityBase for full lifecycle management.
+ *
+ * Example:
+ * ```tsx
+ * function CharacterCard({ character }) {
+ *   const agent = useViewAnnotation({
+ *     entity: { type: 'Character', id: character.id },
+ *     intents: ['generate-clip', 'clone-voice'],
+ *     displayContext: { label: character.name, image: character.thumbnailUrl },
+ *     onTargeted: () => setHighlighted(true),
+ *     onReleased: () => setHighlighted(false),
+ *   });
+ *
+ *   return (
+ *     <div ref={agent.ref} className={agent.isTargeted ? 'targeted' : ''}>
+ *       {character.name}
+ *       <button onClick={() => agent.execute('generate-clip', { character: character.id })}>
+ *         Generate
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useViewAnnotation(options: UseViewAnnotationOptions): UseViewAnnotationReturn;
+//# sourceMappingURL=useViewAnnotation.d.ts.map

package/dist/entity/useViewAnnotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewAnnotation.d.ts","sourceRoot":"","sources":["../../src/entity/useViewAnnotation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,oBAAoB,CAAC;IACrC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC1E,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACvE,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IAC3G,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACvH,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,KAAK,WAAW,CAAC;CAC7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAoF5F"}

package/dist/entity/useViewAnnotation.js

@@ -0,0 +1,126 @@
+import { useRef, useCallback, useEffect, useState } from 'react';
+import { AgentEntityBase, EntityRegistry, } from '@ouispec/agent-core';
+import { annotationRegistry } from '../annotations/singleton.js';
+/**
+ * useViewAnnotation — hook that registers a DOM element as an agent-addressable entity.
+ *
+ * This is the escape-hatch pattern for SVGs, portals, canvas overlays, or any case
+ * where class inheritance or wrapper components don't fit.
+ *
+ * Now delegates to the core AgentEntityBase for full lifecycle management.
+ *
+ * Example:
+ * ```tsx
+ * function CharacterCard({ character }) {
+ *   const agent = useViewAnnotation({
+ *     entity: { type: 'Character', id: character.id },
+ *     intents: ['generate-clip', 'clone-voice'],
+ *     displayContext: { label: character.name, image: character.thumbnailUrl },
+ *     onTargeted: () => setHighlighted(true),
+ *     onReleased: () => setHighlighted(false),
+ *   });
+ *
+ *   return (
+ *     <div ref={agent.ref} className={agent.isTargeted ? 'targeted' : ''}>
+ *       {character.name}
+ *       <button onClick={() => agent.execute('generate-clip', { character: character.id })}>
+ *         Generate
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useViewAnnotation(options) {
+    const [, forceUpdate] = useState(0);
+    const rerender = useCallback(() => forceUpdate(n => n + 1), []);
+    const bridgeRef = useRef(null);
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    if (!bridgeRef.current) {
+        bridgeRef.current = new HookEntityBridge();
+    }
+    const bridge = bridgeRef.current;
+    bridge._sync(options.entity.type, options.entity.id, options.intents ?? [], options.displayContext, options.capabilities ?? {});
+    bridge._setCallbacks({
+        onTargeted: options.onTargeted,
+        onReleased: options.onReleased,
+        onExecuting: options.onExecuting,
+        onExecutionComplete: options.onExecutionComplete,
+        onCommandReceived: options.onCommandReceived,
+        onObserve: options.onObserve,
+    });
+    bridge._setRerender(rerender);
+    useEffect(() => {
+        bridge.register();
+        return () => bridge.unregister();
+    }, []);
+    // Register with annotation registry so collectContext() includes metadata
+    useEffect(() => {
+        const annotationId = `annotation-${options.entity.type}-${options.entity.id}`;
+        const unregister = annotationRegistry.register({
+            id: annotationId,
+            element: null,
+            options: {
+                entity: options.entity,
+                intents: options.intents,
+                displayContext: options.displayContext,
+                metadata: options.metadata,
+            },
+            visible: true,
+        });
+        return () => unregister();
+    }, [options.entity.type, options.entity.id, options.metadata]);
+    useEffect(() => {
+        const newKey = `${options.entity.type}::${options.entity.id}`;
+        if (bridge._prevKey && bridge._prevKey !== newKey) {
+            bridge.unregister();
+            bridge._sync(options.entity.type, options.entity.id, options.intents ?? [], options.displayContext, options.capabilities ?? {});
+            bridge.register();
+        }
+        bridge._prevKey = newKey;
+    }, [options.entity.type, options.entity.id]);
+    const refCallback = useCallback((element) => {
+        EntityRegistry.instance.updateElement(optionsRef.current.entity.type, optionsRef.current.entity.id, element);
+    }, []);
+    return {
+        ref: refCallback,
+        isTargeted: bridge.isTargeted,
+        isExecuting: bridge.isExecuting,
+        currentAction: bridge.currentAction,
+        execute: (intentId, params, opts) => bridge.execute(intentId, params, opts),
+        emit: (signal, data) => bridge.emit(signal, data),
+        subscribe: (event, handler) => bridge.subscribe(event, handler),
+    };
+}
+class HookEntityBridge extends AgentEntityBase {
+    _type = '';
+    _id = '';
+    _intents = [];
+    _display = { label: '' };
+    _caps = {};
+    _callbacks = {};
+    _rerender = null;
+    _prevKey = '';
+    get entityType() { return this._type; }
+    get entityId() { return this._id; }
+    get intents() { return this._intents; }
+    get displayContext() { return this._display; }
+    get capabilities() { return this._caps; }
+    _sync(type, id, intents, display, caps) {
+        this._type = type;
+        this._id = id;
+        this._intents = intents;
+        this._display = display;
+        this._caps = caps;
+    }
+    _setCallbacks(callbacks) { this._callbacks = callbacks; }
+    _setRerender(fn) { this._rerender = fn; }
+    onTargeted(action) { this._callbacks.onTargeted?.(action); this._rerender?.(); }
+    onReleased() { this._callbacks.onReleased?.(); this._rerender?.(); }
+    onExecuting(intentId, params) { this._callbacks.onExecuting?.(intentId, params); this._rerender?.(); }
+    onExecutionComplete(intentId, result) { this._callbacks.onExecutionComplete?.(intentId, result); this._rerender?.(); }
+    onCommandReceived(command) { return this._callbacks.onCommandReceived?.(command); }
+    onObserve(observation) { this._callbacks.onObserve?.(observation); }
+}
+//# sourceMappingURL=useViewAnnotation.js.map

package/dist/entity/useViewAnnotation.js.map

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

package/dist/hooks/useFeedback.d.ts

@@ -0,0 +1,7 @@
+export interface FeedbackActions {
+    thumbsUp: (turnId: string, detail?: string) => void;
+    thumbsDown: (turnId: string, detail?: string) => void;
+    recordImplicit: (turnId: string, signal: 'positive' | 'negative', detail?: string) => void;
+}
+export declare function useFeedback(): FeedbackActions;
+//# sourceMappingURL=useFeedback.d.ts.map

package/dist/hooks/useFeedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeedback.d.ts","sourceRoot":"","sources":["../../src/hooks/useFeedback.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5F;AAED,wBAAgB,WAAW,IAAI,eAAe,CAsC7C"}

package/dist/hooks/useFeedback.js

@@ -0,0 +1,38 @@
+import { useCallback } from 'react';
+import { useAgent } from '../provider/AgentProvider.js';
+export function useFeedback() {
+    useAgent(); // validate agent context is available
+    const thumbsUp = useCallback((turnId, detail) => {
+        const record = {
+            turnId,
+            type: 'explicit',
+            signal: 'positive',
+            detail,
+            timestamp: Date.now(),
+        };
+        // Emit to learning surface if available
+        window.dispatchEvent(new CustomEvent('agent:feedback', { detail: record }));
+    }, []);
+    const thumbsDown = useCallback((turnId, detail) => {
+        const record = {
+            turnId,
+            type: 'explicit',
+            signal: 'negative',
+            detail,
+            timestamp: Date.now(),
+        };
+        window.dispatchEvent(new CustomEvent('agent:feedback', { detail: record }));
+    }, []);
+    const recordImplicit = useCallback((turnId, signal, detail) => {
+        const record = {
+            turnId,
+            type: 'implicit',
+            signal,
+            detail,
+            timestamp: Date.now(),
+        };
+        window.dispatchEvent(new CustomEvent('agent:feedback', { detail: record }));
+    }, []);
+    return { thumbsUp, thumbsDown, recordImplicit };
+}
+//# sourceMappingURL=useFeedback.js.map

package/dist/hooks/useFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeedback.js","sourceRoot":"","sources":["../../src/hooks/useFeedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAQxD,MAAM,UAAU,WAAW;IACzB,QAAQ,EAAE,CAAC,CAAC,sCAAsC;IAElD,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,MAAc,EAAE,MAAe,EAAE,EAAE;QAC/D,MAAM,MAAM,GAAmB;YAC7B,MAAM;YACN,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,UAAU;YAClB,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,wCAAwC;QACxC,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,MAAc,EAAE,MAAe,EAAE,EAAE;QACjE,MAAM,MAAM,GAAmB;YAC7B,MAAM;YACN,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,UAAU;YAClB,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,MAAc,EAAE,MAA+B,EAAE,MAAe,EAAE,EAAE;QACtG,MAAM,MAAM,GAAmB;YAC7B,MAAM;YACN,IAAI,EAAE,UAAU;YAChB,MAAM;YACN,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { AgentProvider, useAgent } from './provider/AgentProvider.js';
+export { useFeedback } from './hooks/useFeedback.js';
+export { storedToAgentMessages } from './provider/stored-messages.js';
+export { ApprovalCard } from './approvals/ApprovalCard.js';
+export type { ApprovalCardProps, ApprovalCardParts, ApprovalCardFrameProps, ApprovalCardButtonProps, ApprovalCardLabels, } from './approvals/ApprovalCard.js';
+export type { AgentApprovalRequest, AgentClientConfig, AgentContextValue, AgentHistoryState, AgentMessage, AgentToolCallState, AgentDebugState, DebugLogEntry, DebugLogLevel, DebugLogNamespace, } from './provider/types.js';
+export { AgentEntityComponent, defineAgentEntity, AgentEntity, asAgentEntity, useViewAnnotation, } from './entity/index.js';
+export type { AgentEntityRenderContext, DefineAgentEntityConfig, AgentEntityProps, AgentEntityChildContext, AsAgentEntityConfig, InjectedAgentEntityProps, UseViewAnnotationOptions, UseViewAnnotationReturn, } from './entity/index.js';
+export { AnnotationRegistry } from './annotations/AnnotationRegistry.js';
+export type { ViewAnnotationOptions, AnnotationEntry } from './annotations/types.js';
+export { annotationRegistry } from './annotations/singleton.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { AgentProvider, useAgent } from './provider/AgentProvider.js';
+export { useFeedback } from './hooks/useFeedback.js';
+export { storedToAgentMessages } from './provider/stored-messages.js';
+// Approvals (ADR-0228): the card where the person approves an irreversible call.
+export { ApprovalCard } from './approvals/ApprovalCard.js';
+// Entity integration patterns
+export { AgentEntityComponent, defineAgentEntity, AgentEntity, asAgentEntity, useViewAnnotation, } from './entity/index.js';
+// Annotation registry for view annotations
+export { AnnotationRegistry } from './annotations/AnnotationRegistry.js';
+export { annotationRegistry } from './annotations/singleton.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAsB3D,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAa3B,2CAA2C;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/provider/AgentProvider.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { AgentClientConfig } from '@ouispec/agent-core';
+import type { AgentContextValue } from './types.js';
+/**
+ * AgentProvider — turnkey provider that handles the complete agent lifecycle.
+ *
+ * The platform provides:
+ * - createConversation() / sendMessage() — API callbacks
+ * - realtime: { url, getToken } — where and how to connect
+ *
+ * The SDK owns:
+ * - Socket.IO connection lifecycle (connect, reconnect, auth)
+ * - Room subscription tied to active turns, kept across reconnects
+ * - All event parsing (agent:* protocol)
+ * - Streaming state, message history, keyboard shortcuts
+ *
+ * UI actions are not dispatched here: the client's OUI surface runtime answers
+ * them on the same socket (ADR-0209).
+ */
+export declare function AgentProvider({ config, children }: {
+    config: AgentClientConfig;
+    children: React.ReactNode;
+}): React.FunctionComponentElement<React.ProviderProps<AgentContextValue | null>>;
+export declare function useAgent(): AgentContextValue;
+//# sourceMappingURL=AgentProvider.d.ts.map

package/dist/provider/AgentProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentProvider.d.ts","sourceRoot":"","sources":["../../src/provider/AgentProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAA8E,MAAM,OAAO,CAAC;AACnG,OAAO,KAAK,EACV,iBAAiB,EAKlB,MAAM,qBAAqB,CAAC;AAW7B,OAAO,KAAK,EAEV,iBAAiB,EAOlB,MAAM,YAAY,CAAC;AA0EpB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,iFA6uB3G;AAED,wBAAgB,QAAQ,IAAI,iBAAiB,CAI5C"}