@growthub/cli 0.3.12 → 0.3.13

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/hooks.js

@@ -1,148 +0,0 @@
-import { getSdkUiRuntimeValue } from "./runtime.js";
-// ---------------------------------------------------------------------------
-// usePluginData
-// ---------------------------------------------------------------------------
-/**
- * Fetch data from the plugin worker's registered `getData` handler.
- *
- * Calls `ctx.data.register(key, handler)` in the worker and returns the
- * result as reactive state. Re-fetches when `params` changes.
- *
- * @template T The expected shape of the returned data
- * @param key - The data key matching the handler registered with `ctx.data.register()`
- * @param params - Optional parameters forwarded to the handler
- * @returns `PluginDataResult<T>` with `data`, `loading`, `error`, and `refresh`
- *
- * @example
- * ```tsx
- * function SyncWidget({ context }: PluginWidgetProps) {
- *   const { data, loading, error } = usePluginData<SyncHealth>("sync-health", {
- *     companyId: context.companyId,
- *   });
- *
- *   if (loading) return <div>Loading…</div>;
- *   if (error) return <div>Error: {error.message}</div>;
- *   return <div>Synced Issues: {data!.syncedCount}</div>;
- * }
- * ```
- *
- * @see PLUGIN_SPEC.md §13.8 — `getData`
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
- */
-export function usePluginData(key, params) {
-    const impl = getSdkUiRuntimeValue("usePluginData");
-    return impl(key, params);
-}
-// ---------------------------------------------------------------------------
-// usePluginAction
-// ---------------------------------------------------------------------------
-/**
- * Get a callable function that invokes the plugin worker's registered
- * `performAction` handler.
- *
- * The returned function is async and throws a `PluginBridgeError` on failure.
- *
- * @param key - The action key matching the handler registered with `ctx.actions.register()`
- * @returns An async function that sends the action to the worker and resolves with the result
- *
- * @example
- * ```tsx
- * function ResyncButton({ context }: PluginWidgetProps) {
- *   const resync = usePluginAction("resync");
- *   const [error, setError] = useState<string | null>(null);
- *
- *   async function handleClick() {
- *     try {
- *       await resync({ companyId: context.companyId });
- *     } catch (err) {
- *       setError((err as PluginBridgeError).message);
- *     }
- *   }
- *
- *   return <button onClick={handleClick}>Resync Now</button>;
- * }
- * ```
- *
- * @see PLUGIN_SPEC.md §13.9 — `performAction`
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
- */
-export function usePluginAction(key) {
-    const impl = getSdkUiRuntimeValue("usePluginAction");
-    return impl(key);
-}
-// ---------------------------------------------------------------------------
-// useHostContext
-// ---------------------------------------------------------------------------
-/**
- * Read the current host context (active company, project, entity, user).
- *
- * Use this to know which context the plugin component is being rendered in
- * so you can scope data requests and actions accordingly.
- *
- * @returns The current `PluginHostContext`
- *
- * @example
- * ```tsx
- * function IssueTab() {
- *   const { companyId, entityId } = useHostContext();
- *   const { data } = usePluginData("linear-link", { issueId: entityId });
- *   return <div>{data?.linearIssueUrl}</div>;
- * }
- * ```
- *
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
- */
-export function useHostContext() {
-    const impl = getSdkUiRuntimeValue("useHostContext");
-    return impl();
-}
-// ---------------------------------------------------------------------------
-// usePluginStream
-// ---------------------------------------------------------------------------
-/**
- * Subscribe to a real-time event stream pushed from the plugin worker.
- *
- * Opens an SSE connection to `GET /api/plugins/:pluginId/bridge/stream/:channel`
- * and accumulates events as they arrive. The worker pushes events using
- * `ctx.streams.emit(channel, event)`.
- *
- * @template T The expected shape of each streamed event
- * @param channel - The stream channel name (must match what the worker uses in `ctx.streams.emit`)
- * @param options - Optional configuration for the stream
- * @returns `PluginStreamResult<T>` with `events`, `lastEvent`, connection status, and `close()`
- *
- * @example
- * ```tsx
- * function ChatMessages() {
- *   const { events, connected, close } = usePluginStream<ChatToken>("chat-stream");
- *
- *   return (
- *     <div>
- *       {events.map((e, i) => <span key={i}>{e.text}</span>)}
- *       {connected && <span className="pulse" />}
- *       <button onClick={close}>Stop</button>
- *     </div>
- *   );
- * }
- * ```
- *
- * @see PLUGIN_SPEC.md §19.8 — Real-Time Streaming
- */
-export function usePluginStream(channel, options) {
-    const impl = getSdkUiRuntimeValue("usePluginStream");
-    return impl(channel, options);
-}
-// ---------------------------------------------------------------------------
-// usePluginToast
-// ---------------------------------------------------------------------------
-/**
- * Trigger a host toast notification from plugin UI.
- *
- * This lets plugin pages and widgets surface user-facing feedback through the
- * same toast system as the host app without reaching into host internals.
- */
-export function usePluginToast() {
-    const impl = getSdkUiRuntimeValue("usePluginToast");
-    return impl();
-}
-//# sourceMappingURL=hooks.js.map

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/ui/hooks.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,MAAgC;IAEhC,MAAM,IAAI,GAAG,oBAAoB,CAE/B,eAAe,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,oBAAoB,CAAsC,iBAAiB,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,oBAAoB,CAA0B,gBAAgB,CAAC,CAAC;IAC7E,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,OAAgC;IAEhC,MAAM,IAAI,GAAG,oBAAoB,CAE/B,iBAAiB,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,oBAAoB,CAAsB,gBAAgB,CAAC,CAAC;IACzE,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC"}

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/index.d.ts

@@ -1,50 +0,0 @@
-/**
- * `@paperclipai/plugin-sdk/ui` — Paperclip plugin UI SDK.
- *
- * Import this subpath from plugin UI bundles (React components that run in
- * the host frontend).  Do **not** import this from plugin worker code.
- *
- * The worker-side SDK is available from `@paperclipai/plugin-sdk` (root).
- *
- * @see PLUGIN_SPEC.md §19.0.1 — Plugin UI SDK
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
- *
- * @example
- * ```tsx
- * // Plugin UI bundle entry (dist/ui/index.tsx)
- * import { usePluginData, usePluginAction } from "@paperclipai/plugin-sdk/ui";
- * import type { PluginWidgetProps } from "@paperclipai/plugin-sdk/ui";
- *
- * export function DashboardWidget({ context }: PluginWidgetProps) {
- *   const { data, loading, error } = usePluginData("sync-health", {
- *     companyId: context.companyId,
- *   });
- *   const resync = usePluginAction("resync");
- *
- *   if (loading) return <div>Loading…</div>;
- *   if (error) return <div>Error: {error.message}</div>;
- *
- *   return (
- *     <div style={{ display: "grid", gap: 8 }}>
- *       <strong>Synced Issues</strong>
- *       <div>{data!.syncedCount}</div>
- *       <button onClick={() => resync({ companyId: context.companyId })}>
- *         Resync Now
- *       </button>
- *     </div>
- *   );
- * }
- * ```
- */
-/**
- * Bridge hooks for plugin UI components to communicate with the plugin worker.
- *
- * - `usePluginData(key, params)` — fetch data from the worker's `getData` handler
- * - `usePluginAction(key)` — get a callable that invokes the worker's `performAction` handler
- * - `useHostContext()` — read the current active company, project, entity, and user IDs
- * - `usePluginStream(channel)` — subscribe to real-time SSE events from the worker
- */
-export { usePluginData, usePluginAction, useHostContext, usePluginStream, usePluginToast, } from "./hooks.js";
-export type { PluginBridgeError, PluginBridgeErrorCode, PluginHostContext, PluginModalBoundsRequest, PluginRenderCloseEvent, PluginRenderCloseHandler, PluginRenderCloseLifecycle, PluginRenderEnvironmentContext, PluginLauncherBounds, PluginLauncherRenderEnvironment, PluginDataResult, PluginActionFn, PluginStreamResult, PluginToastTone, PluginToastAction, PluginToastInput, PluginToastFn, } from "./types.js";
-export type { PluginPageProps, PluginWidgetProps, PluginDetailTabProps, PluginSidebarProps, PluginProjectSidebarItemProps, PluginCommentAnnotationProps, PluginCommentContextMenuItemProps, PluginSettingsPageProps, } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;;;;GAOG;AACH,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,oBAAoB,EACpB,+BAA+B,EAC/B,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,EAC5B,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/index.js

@@ -1,48 +0,0 @@
-/**
- * `@paperclipai/plugin-sdk/ui` — Paperclip plugin UI SDK.
- *
- * Import this subpath from plugin UI bundles (React components that run in
- * the host frontend).  Do **not** import this from plugin worker code.
- *
- * The worker-side SDK is available from `@paperclipai/plugin-sdk` (root).
- *
- * @see PLUGIN_SPEC.md §19.0.1 — Plugin UI SDK
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
- *
- * @example
- * ```tsx
- * // Plugin UI bundle entry (dist/ui/index.tsx)
- * import { usePluginData, usePluginAction } from "@paperclipai/plugin-sdk/ui";
- * import type { PluginWidgetProps } from "@paperclipai/plugin-sdk/ui";
- *
- * export function DashboardWidget({ context }: PluginWidgetProps) {
- *   const { data, loading, error } = usePluginData("sync-health", {
- *     companyId: context.companyId,
- *   });
- *   const resync = usePluginAction("resync");
- *
- *   if (loading) return <div>Loading…</div>;
- *   if (error) return <div>Error: {error.message}</div>;
- *
- *   return (
- *     <div style={{ display: "grid", gap: 8 }}>
- *       <strong>Synced Issues</strong>
- *       <div>{data!.syncedCount}</div>
- *       <button onClick={() => resync({ companyId: context.companyId })}>
- *         Resync Now
- *       </button>
- *     </div>
- *   );
- * }
- * ```
- */
-/**
- * Bridge hooks for plugin UI components to communicate with the plugin worker.
- *
- * - `usePluginData(key, params)` — fetch data from the worker's `getData` handler
- * - `usePluginAction(key)` — get a callable that invokes the worker's `performAction` handler
- * - `useHostContext()` — read the current active company, project, entity, and user IDs
- * - `usePluginStream(channel)` — subscribe to real-time SSE events from the worker
- */
-export { usePluginData, usePluginAction, useHostContext, usePluginStream, usePluginToast, } from "./hooks.js";
-//# sourceMappingURL=index.js.map

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;;;;;;;GAOG;AACH,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/runtime.d.ts

@@ -1,3 +0,0 @@
-export declare function getSdkUiRuntimeValue<T>(name: string): T;
-export declare function renderSdkUiComponent<TProps>(name: string, props: TProps): unknown;
-//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/runtime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/ui/runtime.ts"],"names":[],"mappings":"AAsBA,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAMvD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAiBT"}

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/runtime.js

@@ -1,30 +0,0 @@
-function getBridgeRegistry() {
-    return globalThis.__paperclipPluginBridge__;
-}
-function missingBridgeValueError(name) {
-    return new Error(`Paperclip plugin UI runtime is not initialized for "${name}". ` +
-        'Ensure the host loaded the plugin bridge before rendering this UI module.');
-}
-export function getSdkUiRuntimeValue(name) {
-    const value = getBridgeRegistry()?.sdkUi?.[name];
-    if (value === undefined) {
-        throw missingBridgeValueError(name);
-    }
-    return value;
-}
-export function renderSdkUiComponent(name, props) {
-    const registry = getBridgeRegistry();
-    const component = registry?.sdkUi?.[name];
-    if (component === undefined) {
-        throw missingBridgeValueError(name);
-    }
-    const createElement = registry?.react?.createElement;
-    if (typeof createElement === "function") {
-        return createElement(component, props);
-    }
-    if (typeof component === "function") {
-        return component(props);
-    }
-    throw new Error(`Paperclip plugin UI component "${name}" is not callable`);
-}
-//# sourceMappingURL=runtime.js.map

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/ui/runtime.ts"],"names":[],"mappings":"AAWA,SAAS,iBAAiB;IACxB,OAAQ,UAA2B,CAAC,yBAAyB,CAAC;AAChE,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAY;IAC3C,OAAO,IAAI,KAAK,CACd,uDAAuD,IAAI,KAAK;QAC9D,2EAA2E,CAC9E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,IAAY;IAClD,MAAM,KAAK,GAAG,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,KAAa;IAEb,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC;IACrD,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO,aAAa,CAAC,SAAS,EAAE,KAAgC,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,mBAAmB,CAAC,CAAC;AAC7E,CAAC"}

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/types.d.ts

@@ -1,308 +0,0 @@
-/**
- * Paperclip plugin UI SDK — types for plugin frontend components.
- *
- * Plugin UI bundles import from `@paperclipai/plugin-sdk/ui`.  This subpath
- * provides the bridge hooks, component prop interfaces, and error types that
- * plugin React components use to communicate with the host.
- *
- * Plugin UI bundles are loaded as ES modules into designated extension slots.
- * All communication with the plugin worker goes through the host bridge — plugin
- * components must NOT access host internals or call host APIs directly.
- *
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
- * @see PLUGIN_SPEC.md §19.0.1 — Plugin UI SDK
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
- */
-import type { PluginBridgeErrorCode } from "@paperclipai/shared";
-import type { PluginLauncherRenderContextSnapshot, PluginModalBoundsRequest, PluginRenderCloseEvent } from "../protocol.js";
-export type { PluginBridgeErrorCode, PluginLauncherBounds, PluginLauncherRenderEnvironment, } from "@paperclipai/shared";
-export type { PluginLauncherRenderContextSnapshot, PluginModalBoundsRequest, PluginRenderCloseEvent, } from "../protocol.js";
-/**
- * Structured error returned by the bridge when a UI → worker call fails.
- *
- * Plugin components receive this in `usePluginData()` as the `error` field
- * and may encounter it as a thrown value from `usePluginAction()`.
- *
- * Error codes:
- * - `WORKER_UNAVAILABLE` — plugin worker is not running
- * - `CAPABILITY_DENIED` — plugin lacks the required capability
- * - `WORKER_ERROR` — worker returned an error from its handler
- * - `TIMEOUT` — worker did not respond within the configured timeout
- * - `UNKNOWN` — unexpected bridge-level failure
- *
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
- */
-export interface PluginBridgeError {
-    /** Machine-readable error code. */
-    code: PluginBridgeErrorCode;
-    /** Human-readable error message. */
-    message: string;
-    /**
-     * Original error details from the worker, if available.
-     * Only present when `code === "WORKER_ERROR"`.
-     */
-    details?: unknown;
-}
-/**
- * Read-only host context passed to every plugin component via `useHostContext()`.
- *
- * Plugin components use this to know which company, project, or entity is
- * currently active so they can scope their data requests accordingly.
- *
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
- */
-export interface PluginHostContext {
-    /** UUID of the currently active company, if any. */
-    companyId: string | null;
-    /** URL prefix for the current company (e.g. `"my-company"`). */
-    companyPrefix: string | null;
-    /** UUID of the currently active project, if any. */
-    projectId: string | null;
-    /** UUID of the current entity (for detail tab contexts), if any. */
-    entityId: string | null;
-    /** Type of the current entity (e.g. `"issue"`, `"agent"`). */
-    entityType: string | null;
-    /**
-     * UUID of the parent entity when rendering nested slots.
-     * For `commentAnnotation` slots this is the issue ID containing the comment.
-     */
-    parentEntityId?: string | null;
-    /** UUID of the current authenticated user. */
-    userId: string | null;
-    /** Runtime metadata for the host container currently rendering this plugin UI. */
-    renderEnvironment?: PluginRenderEnvironmentContext | null;
-}
-/**
- * Async-capable callback invoked during a host-managed close lifecycle.
- */
-export type PluginRenderCloseHandler = (event: PluginRenderCloseEvent) => void | Promise<void>;
-/**
- * Close lifecycle hooks available when the plugin UI is rendered inside a
- * host-managed launcher environment.
- */
-export interface PluginRenderCloseLifecycle {
-    /** Register a callback before the host closes the current environment. */
-    onBeforeClose?(handler: PluginRenderCloseHandler): () => void;
-    /** Register a callback after the host closes the current environment. */
-    onClose?(handler: PluginRenderCloseHandler): () => void;
-}
-/**
- * Runtime information about the host container currently rendering a plugin UI.
- */
-export interface PluginRenderEnvironmentContext extends PluginLauncherRenderContextSnapshot {
-    /** Optional host callback for requesting new bounds while a modal is open. */
-    requestModalBounds?(request: PluginModalBoundsRequest): Promise<void>;
-    /** Optional close lifecycle callbacks for host-managed overlays. */
-    closeLifecycle?: PluginRenderCloseLifecycle | null;
-}
-/**
- * Props passed to a plugin page component.
- *
- * A page is a full-page extension at `/plugins/:pluginId` or `/:company/plugins/:pluginId`.
- *
- * @see PLUGIN_SPEC.md §19.1 — Global Operator Routes
- * @see PLUGIN_SPEC.md §19.2 — Company-Context Routes
- */
-export interface PluginPageProps {
-    /** The current host context. */
-    context: PluginHostContext;
-}
-/**
- * Props passed to a plugin dashboard widget component.
- *
- * A dashboard widget is rendered as a card or section on the main dashboard.
- *
- * @see PLUGIN_SPEC.md §19.4 — Dashboard Widgets
- */
-export interface PluginWidgetProps {
-    /** The current host context. */
-    context: PluginHostContext;
-}
-/**
- * Props passed to a plugin detail tab component.
- *
- * A detail tab is rendered as an additional tab on a project, issue, agent,
- * goal, or run detail page.
- *
- * @see PLUGIN_SPEC.md §19.3 — Detail Tabs
- */
-export interface PluginDetailTabProps {
-    /** The current host context, always including `entityId` and `entityType`. */
-    context: PluginHostContext & {
-        entityId: string;
-        entityType: string;
-    };
-}
-/**
- * Props passed to a plugin sidebar component.
- *
- * A sidebar entry adds a link or section to the application sidebar.
- *
- * @see PLUGIN_SPEC.md §19.5 — Sidebar Entries
- */
-export interface PluginSidebarProps {
-    /** The current host context. */
-    context: PluginHostContext;
-}
-/**
- * Props passed to a plugin project sidebar item component.
- *
- * A project sidebar item is rendered **once per project** under that project's
- * row in the sidebar Projects list. The host passes the current project's id
- * in `context.entityId` and `context.entityType` is `"project"`.
- *
- * Use this slot to add a link (e.g. "Files", "Linear Sync") that navigates to
- * the project detail with a plugin tab selected: `/projects/:projectRef?tab=plugin:key:slotId`.
- *
- * @see PLUGIN_SPEC.md §19.5.1 — Project sidebar items
- */
-export interface PluginProjectSidebarItemProps {
-    /** Host context plus entityId (project id) and entityType "project". */
-    context: PluginHostContext & {
-        entityId: string;
-        entityType: "project";
-    };
-}
-/**
- * Props passed to a plugin comment annotation component.
- *
- * A comment annotation is rendered below each individual comment in the
- * issue detail timeline. The host passes the comment ID as `entityId`
- * and `"comment"` as `entityType`, plus the parent issue ID as
- * `parentEntityId` so the plugin can scope data fetches to both.
- *
- * Use this slot to augment comments with parsed file links, sentiment
- * badges, inline actions, or any per-comment metadata.
- *
- * @see PLUGIN_SPEC.md §19.6 — Comment Annotations
- */
-export interface PluginCommentAnnotationProps {
-    /** Host context with comment and parent issue identifiers. */
-    context: PluginHostContext & {
-        /** UUID of the comment being annotated. */
-        entityId: string;
-        /** Always `"comment"` for comment annotation slots. */
-        entityType: "comment";
-        /** UUID of the parent issue containing this comment. */
-        parentEntityId: string;
-    };
-}
-/**
- * Props passed to a plugin comment context menu item component.
- *
- * A comment context menu item is rendered in a "more" dropdown menu on
- * each comment in the issue detail timeline. The host passes the comment
- * ID as `entityId` and `"comment"` as `entityType`, plus the parent
- * issue ID as `parentEntityId`.
- *
- * Use this slot to add per-comment actions such as "Create sub-issue from
- * comment", "Translate", "Flag for review", or any custom plugin action.
- *
- * @see PLUGIN_SPEC.md §19.7 — Comment Context Menu Items
- */
-export interface PluginCommentContextMenuItemProps {
-    /** Host context with comment and parent issue identifiers. */
-    context: PluginHostContext & {
-        /** UUID of the comment this menu item acts on. */
-        entityId: string;
-        /** Always `"comment"` for comment context menu item slots. */
-        entityType: "comment";
-        /** UUID of the parent issue containing this comment. */
-        parentEntityId: string;
-    };
-}
-/**
- * Props passed to a plugin settings page component.
- *
- * Overrides the auto-generated JSON Schema form when the plugin declares
- * a `settingsPage` UI slot. The component is responsible for reading and
- * writing config through the bridge.
- *
- * @see PLUGIN_SPEC.md §19.8 — Plugin Settings UI
- */
-export interface PluginSettingsPageProps {
-    /** The current host context. */
-    context: PluginHostContext;
-}
-/**
- * Return value of `usePluginData(key, params)`.
- *
- * Mirrors a standard async data-fetching hook pattern:
- * exactly one of `data` or `error` is non-null at any time (unless `loading`).
- *
- * @template T The type of the data returned by the worker handler
- *
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
- */
-export interface PluginDataResult<T = unknown> {
-    /** The data returned by the worker's `getData` handler. `null` while loading or on error. */
-    data: T | null;
-    /** `true` while the initial request or a refresh is in flight. */
-    loading: boolean;
-    /** Bridge error if the request failed. `null` on success or while loading. */
-    error: PluginBridgeError | null;
-    /**
-     * Manually trigger a data refresh.
-     * Useful for poll-based updates or post-action refreshes.
-     */
-    refresh(): void;
-}
-export type PluginToastTone = "info" | "success" | "warn" | "error";
-export interface PluginToastAction {
-    label: string;
-    href: string;
-}
-export interface PluginToastInput {
-    id?: string;
-    dedupeKey?: string;
-    title: string;
-    body?: string;
-    tone?: PluginToastTone;
-    ttlMs?: number;
-    action?: PluginToastAction;
-}
-export type PluginToastFn = (input: PluginToastInput) => string | null;
-/**
- * Return value of `usePluginStream<T>(channel)`.
- *
- * Provides a growing array of events pushed from the plugin worker via SSE,
- * plus connection status metadata.
- *
- * @template T The type of each event emitted by the worker
- *
- * @see PLUGIN_SPEC.md §19.8 — Real-Time Streaming
- */
-export interface PluginStreamResult<T = unknown> {
-    /** All events received so far, in arrival order. */
-    events: T[];
-    /** The most recently received event, or `null` if none yet. */
-    lastEvent: T | null;
-    /** `true` while the SSE connection is being established. */
-    connecting: boolean;
-    /** `true` once the SSE connection is open and receiving events. */
-    connected: boolean;
-    /** Error if the SSE connection failed or was interrupted. `null` otherwise. */
-    error: Error | null;
-    /** Close the SSE connection and stop receiving events. */
-    close(): void;
-}
-/**
- * Return value of `usePluginAction(key)`.
- *
- * Returns an async function that, when called, sends an action request
- * to the worker's `performAction` handler and returns the result.
- *
- * On failure, the async function throws a `PluginBridgeError`.
- *
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
- *
- * @example
- * ```tsx
- * const resync = usePluginAction("resync");
- * <button onClick={() => resync({ companyId }).catch(err => console.error(err))}>
- *   Resync Now
- * </button>
- * ```
- */
-export type PluginActionFn = (params?: Record<string, unknown>) => Promise<unknown>;
-//# sourceMappingURL=types.d.ts.map

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/types.d.ts.map

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

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/types.js

@@ -1,17 +0,0 @@
-/**
- * Paperclip plugin UI SDK — types for plugin frontend components.
- *
- * Plugin UI bundles import from `@paperclipai/plugin-sdk/ui`.  This subpath
- * provides the bridge hooks, component prop interfaces, and error types that
- * plugin React components use to communicate with the host.
- *
- * Plugin UI bundles are loaded as ES modules into designated extension slots.
- * All communication with the plugin worker goes through the host bridge — plugin
- * components must NOT access host internals or call host APIs directly.
- *
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
- * @see PLUGIN_SPEC.md §19.0.1 — Plugin UI SDK
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/runtime/server/node_modules/@paperclipai/plugin-sdk/dist/ui/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ui/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}