@lotics/app-sdk 0.47.1 → 0.48.0

package/dist/src/analytics.js

@@ -8,10 +8,11 @@
  * with autocapture OFF (the product captures explicit events, not DOM
  * autocapture), and that project setting overrides any client `autocapture`
  * flag — so apps can't rely on autocapture. The SDK instead emits explicit
- * events for genuine user actions: `app_opened`, plus `app_workflow_run` /
- * `app_file_uploaded` from the hooks. Data-read mechanics (a `useQuery`
- * refetch) are a system signal, not a user action, and are deliberately not
- * events.
+ * events for genuine user actions only: `app_opened`, `app_file_uploaded`, and
+ * `app_comment_*`. System signals — data-read mechanics (a `useQuery` refetch)
+ * and workflow/agent run outcomes — are not events: the backend already logs
+ * and persists every run (`workflow_executions`, `app_agent_runs`), so a client
+ * event would be redundant system telemetry, not a gesture.
  *
  * Every event is tagged with app identity and rolls up under the existing
  * `organization` group; embedded apps `identify` the member the host passes
@@ -93,6 +94,10 @@ export async function bootstrapAnalytics() {
         autocapture: false,
         capture_pageview: false,
         capture_pageleave: false,
+        // Dead-click autocapture (enabled by the defaults preset) is a UX-research
+        // signal nobody consumes; explicit user actions + exception capture cover
+        // the app's monitoring needs.
+        capture_dead_clicks: false,
         // Error tracking (the project opts in). mount() only renders a local
         // banner, so this is the app's one exception channel.
         capture_exceptions: true,

package/dist/src/hooks.js

@@ -23,17 +23,7 @@ import { initialAgentRunState, reduceAgentChunk, parseSseChunks, } from "./agent
 import { getMockRows } from "./mock.js";
 import { captureAppEvent } from "./analytics.js";
 export function useWorkflow(alias) {
-    return useCallback(async (inputs) => {
-        try {
-            const result = await rpc("workflow", { alias, inputs: inputs ?? {} });
-            captureAppEvent("app_workflow_run", { alias, ok: result.status !== "error" });
-            return result;
-        }
-        catch (err) {
-            captureAppEvent("app_workflow_run", { alias, ok: false });
-            throw err;
-        }
-    }, [alias]);
+    return useCallback((inputs) => rpc("workflow", { alias, inputs: inputs ?? {} }), [alias]);
 }
 // Shared SWR config: surface a failed query immediately, keep the last good
 // rows (no retry loop that masks the error), and honor the focus/reconnect
@@ -413,7 +403,6 @@ export function useAgentRun(alias) {
                 acc = { ...acc, status: "completed" };
                 safeSetState(acc);
             }
-            captureAppEvent("app_agent_run", { alias, ok: acc.status !== "error" });
             return acc.output;
         })
             .catch(async (err) => {
@@ -431,7 +420,6 @@ export function useAgentRun(alias) {
                             ? { ...acc, status: "completed", output: settled.output ?? acc.output }
                             : { ...acc, status: "error", error: settled.error_message ?? "The run was stopped." };
                     safeSetState(acc);
-                    captureAppEvent("app_agent_run", { alias, ok: settled.status === "completed" });
                     return acc.output;
                 }
                 if (aborted)
@@ -439,7 +427,6 @@ export function useAgentRun(alias) {
             }
             acc = { ...acc, status: "error", error: err.message };
             safeSetState(acc);
-            captureAppEvent("app_agent_run", { alias, ok: false });
             throw err;
         });
     }, [alias, safeSetState]);

package/docs/runtime.md

@@ -333,17 +333,18 @@ await checkIn({ latitude: r.coords.latitude, longitude: r.coords.longitude });
 bundle, invisible to the product's own analytics. **No per-app wiring**: don't
 install `posthog-js` or call any analytics API from app code.
 
-- **Explicit events only.** Autocapture, pageviews, and session replay are off
-  (autocapture is disabled at the project level — a client flag could not
-  re-enable it). Data reads (`useQuery` fetches) are deliberately not events.
+- **Explicit events only — user gestures.** Autocapture, pageviews, and session
+  replay are off (autocapture is disabled at the project level — a client flag
+  could not re-enable it). System signals are deliberately not events: data
+  reads (`useQuery` fetches) and workflow/agent run outcomes. The backend
+  already logs and persists every run (`workflow_executions`, `app_agent_runs`),
+  so a client run event would be redundant system telemetry, not a gesture.
 - Events the SDK emits automatically:
 
 | Event | Fired when | Properties |
 |---|---|---|
 | `app_opened` | analytics finished initializing after `mount()` | — |
-| `app_workflow_run` | each `useWorkflow` call settles | `alias`, `ok` |
 | `app_file_uploaded` | a `useFileUpload` upload succeeds | `mime_type` |
-| `app_agent_run` | a `useAgentRun` run finishes | `alias`, `ok` |
 | `app_comment_created` | a comment is created via `useComments` | `has_files` |
 | `app_comment_updated` / `app_comment_deleted` | comment edit/delete succeeds | — |
 
@@ -359,9 +360,8 @@ install `posthog-js` or call any analytics API from app code.
   and never breaks the app. Events fired before init completes are buffered
   (bounded) and drained on init.
 - **Limitation:** there is no public API for custom app events — the capture
-  function is internal to the SDK. If a bespoke funnel matters, model it as a
-  workflow (which produces `app_workflow_run`) or request the surface as a
-  platform change.
+  function is internal to the SDK. If a bespoke funnel matters, request the
+  surface as a platform change.
 - **Limitation:** PostHog's default bot/user-agent filter applies — headless
   browsers (e.g. Playwright) are never tracked, so analytics cannot be verified
   through headless automation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.47.1",
+  "version": "0.48.0",
   "description": "Runtime SDK for Lotics custom-code apps — typed hooks, postMessage bridge, mount entry point",
   "type": "module",
   "exports": {