@oxy-hq/sdk 2.10.0 → 2.11.0

package/dist/index.cjs

@@ -1,6 +1,6 @@
 // @oxy/sdk - TypeScript SDK for Oxy data platform
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_react = require('./react-Cas_DVKe.cjs');
+const require_react = require('./react-riTxd9ce.cjs');
 let react = require("react");
 react = require_react.__toESM(react, 1);
 

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 
-import { $ as loadCustomAppManifest, A as UseSemanticQueryOpts, B as FunctionError, C as UseProcedureRunInput, D as UseQueryOpts, E as UseQueryInput, F as useProcedureRun, G as apiErrorFromResponse, H as FunctionResult, I as useQuery, J as OxyAppFunctionManifest, K as interpretCustomAppError, L as useResolvedManifest, M as useAgentRun, N as useFunction, O as UseQueryResult, P as useOxyApp, Q as _resetCustomAppManifestCacheForTest, R as useSemanticQuery, S as UseFunctionResult, T as UseProcedureRunResult, U as CustomAppErrorReport, V as FunctionLog, W as OxyApiError, X as OxyAppPerformanceManifest, Y as OxyAppManifest, Z as ResolvedCustomAppManifest, _ as SemanticFilter, a as AppFetcher, b as UseAgentRunInput, c as OxyAppProvider, d as OxyChatProps, f as ProcedureProgress, g as SemanticDateRangeOp, h as SemanticArrayOp, i as AgentSqlArtifact, j as UseSemanticQueryResult, k as UseSemanticQueryInput, l as OxyAppProviderProps, m as ProcedureRunState, n as AgentRunEvent, o as OxyAnswer, p as ProcedureResult, q as LoadManifestOptions, r as AgentRunState, s as OxyAnswerProps, t as AgentArtifact, u as OxyChat, v as SemanticScalarOp, w as UseProcedureRunOpts, x as UseAgentRunResult, y as SemanticTimeDimension, z as useTrackEvent } from "./react-BGUzRMxq.cjs";
+import { $ as loadCustomAppManifest, A as UseSemanticQueryOpts, B as FunctionError, C as UseProcedureRunInput, D as UseQueryOpts, E as UseQueryInput, F as useProcedureRun, G as apiErrorFromResponse, H as FunctionResult, I as useQuery, J as OxyAppFunctionManifest, K as interpretCustomAppError, L as useResolvedManifest, M as useAgentRun, N as useFunction, O as UseQueryResult, P as useOxyApp, Q as _resetCustomAppManifestCacheForTest, R as useSemanticQuery, S as UseFunctionResult, T as UseProcedureRunResult, U as CustomAppErrorReport, V as FunctionLog, W as OxyApiError, X as OxyAppPerformanceManifest, Y as OxyAppManifest, Z as ResolvedCustomAppManifest, _ as SemanticFilter, a as AppFetcher, b as UseAgentRunInput, c as OxyAppProvider, d as OxyChatProps, f as ProcedureProgress, g as SemanticDateRangeOp, h as SemanticArrayOp, i as AgentSqlArtifact, j as UseSemanticQueryResult, k as UseSemanticQueryInput, l as OxyAppProviderProps, m as ProcedureRunState, n as AgentRunEvent, o as OxyAnswer, p as ProcedureResult, q as LoadManifestOptions, r as AgentRunState, s as OxyAnswerProps, t as AgentArtifact, u as OxyChat, v as SemanticScalarOp, w as UseProcedureRunOpts, x as UseAgentRunResult, y as SemanticTimeDimension, z as useTrackEvent } from "./react-CLONxcnA.cjs";
 //#region src/config.d.ts
 /**
  * Configuration for the Oxy SDK
@@ -787,8 +787,16 @@ interface OxyFunctionUser {
    * caller — check {@link kind} before attributing anything to it.
    */
   id: string;
-  /** Their email, or `schedule+<fn>@system.oxy` when {@link kind} is `"system"`. */
-  email: string;
+  /**
+   * Their email; `schedule+<fn>@system.oxy` when {@link kind} is `"system"`; and
+   * **`null` for a frontline worker** — a crew member enrolled by PIN on a shared
+   * device has no mailbox, and the platform stores none rather than inventing
+   * one. That null is the one field that tells the crew from the office inside
+   * a function, because a worker can never hold org membership (see
+   * `orgRole`, which is absent for them too). Treat it as `string | null` in
+   * app logic; it was typed `string` before the crew existed.
+   */
+  email: string | null;
   /**
    * The org that owns this app — the tenant boundary for anything the function
    * reads or writes.
@@ -1257,6 +1265,41 @@ interface OxyStorageApi {
 interface OxyFunctionContext {
   /** Invoking user (route) or system identity (schedule/airway). */
   user: OxyFunctionUser;
+  /**
+   * The org's people directory. Requires `"org": { "read": true }` in this
+   * function's manifest entry — without it the call is rejected before any
+   * query reaches the database.
+   *
+   * For naming a person: an assignee, a roster entry, who submitted something.
+   * Returns a display name and a role, and deliberately **no email, no phone,
+   * no location**.
+   *
+   * Who is in it: **people who can reach this app**. Org members, plus frontline
+   * workers holding a grant on this app — `kind` tells them apart, so a caller
+   * that must not name a worker can refuse on the field rather than by
+   * convention. A worker's `role` is `null`: that vocabulary is org membership's
+   * and a worker has none.
+   *
+   * REQUIRED, like every sibling here — `oltp`, `secrets`, `email`, `storage`,
+   * `airway` are all gated and all declared required. The binding is
+   * unconditional: `__buildCtx` is a static string that attaches `org` whatever
+   * the manifest says, and the refusal lives in the op, not in the binding. An
+   * optional member would therefore be a lie in the other direction, and under
+   * `strict` it makes `ctx.org.people()` — the spelling in every doc here and
+   * the only one the host binds — fail with "possibly undefined".
+   */
+  org: {
+    people(): Promise<{
+      people: Array<{
+        id: string;
+        name: string;
+        /** The org role, or `null` for a frontline worker. */
+        role: string | null;
+        kind: "member" | "frontline";
+      }>;
+      total: number;
+    }>;
+  };
   /** Read-only view of the app's configured secrets (project-scoped). */
   env: Record<string, string>;
   /** Structured per-invocation logging (captured + surfaced with the response). */

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config.ts","../src/metricTree.ts","../src/anomalies.ts","../src/custom-app/base64.ts","../src/custom-app/debug.ts","../src/custom-app/function-context.ts","../src/custom-app/inject.ts","../src/custom-app/logger.ts","../src/custom-app/metric-tree-hooks.tsx","../src/custom-app/sse.ts","../src/worldModel.ts","../src/custom-app/world-model-hooks.tsx","../src/custom-app/world-node.tsx"],"mappings":";;;;;;UAGiB;;;;EAIf;;;;EAKA;;;;EAKA;;;;EAKA;;;;EAKA;;;;;;;EAQA;;;;;EAMA;;;;KCjCU;KACA;KACA;KACA;KACA;UAEK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA,MAAM;;EAEN;EACA,WAAW;EACX,UAAU;EACV,YAAY;EACZ;EACA,MAAM;EACN;EACA;EACA;EACA;;UAGe;EACf,OAAO;EACP,OAAO;EACP;;UAKe;EACf;EACA;EACA;EACA;EACA,OAAO;EACP,WAAW;EACX,UAAU;EACV;EACA;;UAGe;EACf;EACA,SAAS;;UAKM;EACf;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,MAAM;EACN;;UAGe;EACf,QAAQ;EACR,SAAS;;KAKC;EACN;EAAmB;;EACnB;EAAmB;EAAmB;;EACtC;EAA6B;EAAmB;;EAChD;EAAuB;EAAmB;EAAe;;UAE9C;EACf,OAAO;EACP;EACA;EACA;;UAGe;EACf,OAAO;EACP;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;EACA,WAAW;;;;;;;KAQD;;;;;UAMK;EACf;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;;EAGA,YAAY;EACZ,eAAe;EACf;EACA,MAAM;;EAEN;EACA;EACA,cAAc;;KAGJ;EAEN;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;;UAGW;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,SAAS;;UAGM;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,qBAAqB;EACrB;EACA,WAAW;;UAKI;EACf;EACA;EACA;EACA;EACA;;EAEA;;UAGe;EACf;EACA;;EAEA;EACA;EACA,UAAU;EACV;;UAGe;EACf;EACA;;UAGe;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;;;;;EAKA;EACA,YAAY;EACZ,oBAAoB;EACpB,YAAY;;;;;;;;UAWG;EACf;EACA;;EAEA;;UAKe;;EAEf,SAAS;;;;;;;KAUC,e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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config.ts","../src/metricTree.ts","../src/anomalies.ts","../src/custom-app/base64.ts","../src/custom-app/debug.ts","../src/custom-app/function-context.ts","../src/custom-app/inject.ts","../src/custom-app/logger.ts","../src/custom-app/metric-tree-hooks.tsx","../src/custom-app/sse.ts","../src/worldModel.ts","../src/custom-app/world-model-hooks.tsx","../src/custom-app/world-node.tsx"],"mappings":";;;;;;UAGiB;;;;EAIf;;;;EAKA;;;;EAKA;;;;EAKA;;;;EAKA;;;;;;;EAQA;;;;;EAMA;;;;KCjCU;KACA;KACA;KACA;KACA;UAEK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA,MAAM;;EAEN;EACA,WAAW;EACX,UAAU;EACV,YAAY;EACZ;EACA,MAAM;EACN;EACA;EACA;EACA;;UAGe;EACf,OAAO;EACP,OAAO;EACP;;UAKe;EACf;EACA;EACA;EACA;EACA,OAAO;EACP,WAAW;EACX,UAAU;EACV;EACA;;UAGe;EACf;EACA,SAAS;;UAKM;EACf;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,MAAM;EACN;;UAGe;EACf,QAAQ;EACR,SAAS;;KAKC;EACN;EAAmB;;EACnB;EAAmB;EAAmB;;EACtC;EAA6B;EAAmB;;EAChD;EAAuB;EAAmB;EAAe;;UAE9C;EACf,OAAO;EACP;EACA;EACA;;UAGe;EACf,OAAO;EACP;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;EACA,WAAW;;;;;;;KAQD;;;;;UAMK;EACf;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;;EAGA,YAAY;EACZ,eAAe;EACf;EACA,MAAM;;EAEN;EACA;EACA,cAAc;;KAGJ;EAEN;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;;UAGW;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,SAAS;;UAGM;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,qBAAqB;EACrB;EACA,WAAW;;UAKI;EACf;EACA;EACA;EACA;EACA;;EAEA;;UAGe;EACf;EACA;;EAEA;EACA;EACA,UAAU;EACV;;UAGe;EACf;EACA;;UAGe;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;;;;;EAKA;EACA,YAAY;EACZ,oBAAoB;EACpB,YAAY;;;;;;;;UAWG;EACf;EACA;;EAEA;;UAKe;;EAEf,SAAS;;;;;;;KAUC,e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"}

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 
-import { $ as loadCustomAppManifest, A as UseSemanticQueryOpts, B as FunctionError, C as UseProcedureRunInput, D as UseQueryOpts, E as UseQueryInput, F as useProcedureRun, G as apiErrorFromResponse, H as FunctionResult, I as useQuery, J as OxyAppFunctionManifest, K as interpretCustomAppError, L as useResolvedManifest, M as useAgentRun, N as useFunction, O as UseQueryResult, P as useOxyApp, Q as _resetCustomAppManifestCacheForTest, R as useSemanticQuery, S as UseFunctionResult, T as UseProcedureRunResult, U as CustomAppErrorReport, V as FunctionLog, W as OxyApiError, X as OxyAppPerformanceManifest, Y as OxyAppManifest, Z as ResolvedCustomAppManifest, _ as SemanticFilter, a as AppFetcher, b as UseAgentRunInput, c as OxyAppProvider, d as OxyChatProps, f as ProcedureProgress, g as SemanticDateRangeOp, h as SemanticArrayOp, i as AgentSqlArtifact, j as UseSemanticQueryResult, k as UseSemanticQueryInput, l as OxyAppProviderProps, m as ProcedureRunState, n as AgentRunEvent, o as OxyAnswer, p as ProcedureResult, q as LoadManifestOptions, r as AgentRunState, s as OxyAnswerProps, t as AgentArtifact, u as OxyChat, v as SemanticScalarOp, w as UseProcedureRunOpts, x as UseAgentRunResult, y as SemanticTimeDimension, z as useTrackEvent } from "./react-BGUzRMxq.mjs";
+import { $ as loadCustomAppManifest, A as UseSemanticQueryOpts, B as FunctionError, C as UseProcedureRunInput, D as UseQueryOpts, E as UseQueryInput, F as useProcedureRun, G as apiErrorFromResponse, H as FunctionResult, I as useQuery, J as OxyAppFunctionManifest, K as interpretCustomAppError, L as useResolvedManifest, M as useAgentRun, N as useFunction, O as UseQueryResult, P as useOxyApp, Q as _resetCustomAppManifestCacheForTest, R as useSemanticQuery, S as UseFunctionResult, T as UseProcedureRunResult, U as CustomAppErrorReport, V as FunctionLog, W as OxyApiError, X as OxyAppPerformanceManifest, Y as OxyAppManifest, Z as ResolvedCustomAppManifest, _ as SemanticFilter, a as AppFetcher, b as UseAgentRunInput, c as OxyAppProvider, d as OxyChatProps, f as ProcedureProgress, g as SemanticDateRangeOp, h as SemanticArrayOp, i as AgentSqlArtifact, j as UseSemanticQueryResult, k as UseSemanticQueryInput, l as OxyAppProviderProps, m as ProcedureRunState, n as AgentRunEvent, o as OxyAnswer, p as ProcedureResult, q as LoadManifestOptions, r as AgentRunState, s as OxyAnswerProps, t as AgentArtifact, u as OxyChat, v as SemanticScalarOp, w as UseProcedureRunOpts, x as UseAgentRunResult, y as SemanticTimeDimension, z as useTrackEvent } from "./react-CLONxcnA.mjs";
 //#region src/config.d.ts
 /**
  * Configuration for the Oxy SDK
@@ -787,8 +787,16 @@ interface OxyFunctionUser {
    * caller — check {@link kind} before attributing anything to it.
    */
   id: string;
-  /** Their email, or `schedule+<fn>@system.oxy` when {@link kind} is `"system"`. */
-  email: string;
+  /**
+   * Their email; `schedule+<fn>@system.oxy` when {@link kind} is `"system"`; and
+   * **`null` for a frontline worker** — a crew member enrolled by PIN on a shared
+   * device has no mailbox, and the platform stores none rather than inventing
+   * one. That null is the one field that tells the crew from the office inside
+   * a function, because a worker can never hold org membership (see
+   * `orgRole`, which is absent for them too). Treat it as `string | null` in
+   * app logic; it was typed `string` before the crew existed.
+   */
+  email: string | null;
   /**
    * The org that owns this app — the tenant boundary for anything the function
    * reads or writes.
@@ -1257,6 +1265,41 @@ interface OxyStorageApi {
 interface OxyFunctionContext {
   /** Invoking user (route) or system identity (schedule/airway). */
   user: OxyFunctionUser;
+  /**
+   * The org's people directory. Requires `"org": { "read": true }` in this
+   * function's manifest entry — without it the call is rejected before any
+   * query reaches the database.
+   *
+   * For naming a person: an assignee, a roster entry, who submitted something.
+   * Returns a display name and a role, and deliberately **no email, no phone,
+   * no location**.
+   *
+   * Who is in it: **people who can reach this app**. Org members, plus frontline
+   * workers holding a grant on this app — `kind` tells them apart, so a caller
+   * that must not name a worker can refuse on the field rather than by
+   * convention. A worker's `role` is `null`: that vocabulary is org membership's
+   * and a worker has none.
+   *
+   * REQUIRED, like every sibling here — `oltp`, `secrets`, `email`, `storage`,
+   * `airway` are all gated and all declared required. The binding is
+   * unconditional: `__buildCtx` is a static string that attaches `org` whatever
+   * the manifest says, and the refusal lives in the op, not in the binding. An
+   * optional member would therefore be a lie in the other direction, and under
+   * `strict` it makes `ctx.org.people()` — the spelling in every doc here and
+   * the only one the host binds — fail with "possibly undefined".
+   */
+  org: {
+    people(): Promise<{
+      people: Array<{
+        id: string;
+        name: string;
+        /** The org role, or `null` for a frontline worker. */
+        role: string | null;
+        kind: "member" | "frontline";
+      }>;
+      total: number;
+    }>;
+  };
   /** Read-only view of the app's configured secrets (project-scoped). */
   env: Record<string, string>;
   /** Structured per-invocation logging (captured + surfaced with the response). */

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/config.ts","../src/metricTree.ts","../src/anomalies.ts","../src/custom-app/base64.ts","../src/custom-app/debug.ts","../src/custom-app/function-context.ts","../src/custom-app/inject.ts","../src/custom-app/logger.ts","../src/custom-app/metric-tree-hooks.tsx","../src/custom-app/sse.ts","../src/worldModel.ts","../src/custom-app/world-model-hooks.tsx","../src/custom-app/world-node.tsx"],"mappings":";;;;;;UAGiB;;;;EAIf;;;;EAKA;;;;EAKA;;;;EAKA;;;;EAKA;;;;;;;EAQA;;;;;EAMA;;;;KCjCU;KACA;KACA;KACA;KACA;UAEK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA,MAAM;;EAEN;EACA,WAAW;EACX,UAAU;EACV,YAAY;EACZ;EACA,MAAM;EACN;EACA;EACA;EACA;;UAGe;EACf,OAAO;EACP,OAAO;EACP;;UAKe;EACf;EACA;EACA;EACA;EACA,OAAO;EACP,WAAW;EACX,UAAU;EACV;EACA;;UAGe;EACf;EACA,SAAS;;UAKM;EACf;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,MAAM;EACN;;UAGe;EACf,QAAQ;EACR,SAAS;;KAKC;EACN;EAAmB;;EACnB;EAAmB;EAAmB;;EACtC;EAA6B;EAAmB;;EAChD;EAAuB;EAAmB;EAAe;;UAE9C;EACf,OAAO;EACP;EACA;EACA;;UAGe;EACf,OAAO;EACP;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;EACA,WAAW;;;;;;;KAQD;;;;;UAMK;EACf;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;;EAGA,YAAY;EACZ,eAAe;EACf;EACA,MAAM;;EAEN;EACA;EACA,cAAc;;KAGJ;EAEN;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;;UAGW;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,SAAS;;UAGM;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,qBAAqB;EACrB;EACA,WAAW;;UAKI;EACf;EACA;EACA;EACA;EACA;;EAEA;;UAGe;EACf;EACA;;EAEA;EACA;EACA,UAAU;EACV;;UAGe;EACf;EACA;;UAGe;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;;;;;EAKA;EACA,YAAY;EACZ,oBAAoB;EACpB,YAAY;;;;;;;;UAWG;EACf;EACA;;EAEA;;UAKe;;EAEf,SAAS;;;;;;;KAUC,eAAa,GAAG,kBAAkB,UAAU,gBAAgB,QAAQ;;;;;;;;;;;;;;;;cAiBnE;mBACM;mBACA;EAEjB,YAAY,QAAQ,WAAW,SAAS;UAKhC;UAIA;;;;;;;;;;;;;EAmBF,QAAQ,gBAAgB,QAAQ;;;;;;;;;;;;;;EAkBhC,eAAe,oBAAoB,QAAQ;;;;;;;;;;;;EAkB3C,QAAQ,SAAS,kBAAkB,QAAQ;;;;;;;;;;;;;;;EAsB3C,QAAQ,SAAS,iBAAiB,QAAQ;;;;;;;;;;;;;;;;;EAwB1C,kBAAkB,SAAS,qBAAqB,QAAQ;;;;KC/YpD;KACA;;UAGK;;EAEf;;EAEA;;;;;;;UAQe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU;EACV,QAAQ;EACR;;;;;EAKA;;;;;;;EAOA,SAAS;;;;;;;;EAQT;;EAEA,gBAAgB;EAChB;EACA;EACA;;UAGe;EACf,SAAS;;;;;;EAMT;;;;;;;;;;EAUA;;;;;EAKA;;UAGe;EACf,WAAW;;;;;;;;;;;;;;;;;;;;EAoBX;;;;;;;;;;;;EAYA;EACA;;;;;;EAMA;;;;;;;;;;;;;;EAcA;;UAGe;;;EAGf;;;;;;;;;;EAUA;;UAGe;;EAEf;;;UAIe;EACf;EACA;EACA;EACA;;EAEA;;EAEA,SAAS;EACT;;UAGe;EACf;EACA;EACA;;;;;;;EAOA;;;;;EAKA,UAAU;;UAGK;;EAEf;;KAKU,aAAa,GAAG,kBAAkB,UAAU,gBAAgB,QAAQ;;;;;;;;;;;;;;cAsBnE;mBACM;mBACA;EAEjB,YAAY,QAAQ,WAAW,SAAS;UAKhC;UAIA;;;;;;;;;;;;;;;EAqBF,KAAK,UAAS,uBAA4B,QAAQ;;;;;;;;;;;;;;;;;;;;;;EAqClD,KAAK,UAAS,cAAmB,QAAQ;;;;EAWzC,aAAa,mBAAmB,QAAQ,gBAAgB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0ChE,iBACJ;IAAU;IAAgB;IAAqB,eAAe;KAC9D,QAAQ,gBACP,QAAQ;;;;;;;;;;EA6BL,QAAQ,mBAAmB,UAAS,iBAAsB,QAAQ;;;;;;;;;;;;;;;;;;;;iBChV1D,cAAc,OAAO,aAAa,cAAc;;;;;;;;iBA8BhD,cAAc,iBAAiB;;;;;;UC9D9B;EACf;EACA;EACA;IACE;IACA;IACA;IACA;IACA;IACA;IACA;;EAEF;EACA;;EAEA,UAAU;EACV;EACA,UAAU;IAAQ;IAAc;;;;;;;;;iBASZ,kBACpB,UAAU,4BACT,QAAQ;;;;;;;;;;;UChBM;;EAEf;;;KAMU,iBAAiB;;UAGZ;EACf;EACA;;;;;;;;;;;;;;;;;KAkBU;;;;;;;;;;;UAYK;;;;;EAKf;;EAEA;;;;;;;;;EASA;;;;EAIA;;EAEA;;;;;;;;;;;;;;;;;;;;;;EAsBA;;;;;;;;;;EAUA;;;;;;;;;;;;;;;EAeA,QAAQ;;;;;;;;;;;;;;;;;;;;;EAqBR,OAAO;;;UAIQ;EACf;;EAEA;;EAEA;;;;;;KAOU,eAAe;;;;;;;EAOzB;;;;;;;;;;UAWe;;;;;;;;EAQf,MAAM,kBAAkB,cAAc;IAAU,MAAM;IAAkB;;EACxE,OAAO,kBAAkB,eAAe,MAAM,mBAAmB;EACjE,KAAK,kBAAkB,cAAc;EACrC,OACE,kBACA,eACA,MAAM,kBACN,4BACC;;;;;;;;;;;;;;UAeY;;EAEf,MAAM,aAAa,qBAAqB,QAAQ;;EAEhD,KAAK,aAAa,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAwCxB;;EAEf,MAAM,aAAa,qBAAqB,QAAQ;;EAEhD,KAAK,aAAa,qBAAqB;;;UAIxB;EACf,IAAI,aAAa,gBAAgB;;;UAIlB;EACf,MAAM,MAAM,0BAA0B;;;UAIvB;EACf,IAAI,qBAAqB,YAAY,iCAAiC;IAAU;;;;;;;;;UAWjE;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;EAMA;;;;;;;;;EASA,cAAc;;;UAIC;;EAEf;;;;;EAKA;;;;;;;;;;;;EAYA;;EAEA;;EAEA;;EAEA;;;UAIe;;EAEf;;;UAIe;EACf,KAAK,OAAO,iBAAiB,QAAQ;;;UAMtB;;;;;;EAMf;;EAEA;;EAEA;;;;;;EAMA;;EAEA;;;UAIe;;EAEf;;;;;;EAMA;;EAEA;;;;;;;;;;;;;;;;;;;;;;;;EAwBA;;;UAIe;EACf;EACA;;;UAIe;EACf;EACA;EACA;;EAEA;;;UAIe;EACf,SAAS;;EAET;EACA;;;UAIe;;EAEf;;;;;EAKA;;EAEA;;;;;EAKA;;EAEA;;;UAIe;EACf;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAiCe;;EAEf,aAAa,OAAO,wBAAwB,QAAQ;;;;;EAKpD,eACE,aACA;IAAS;IAA2B;MACnC,QAAQ;;;;;EAKX,IAAI,kBAAkB,cAAc,OAAO,oBAAoB,QAAQ;;EAEvE,IACE,aACA;IAAS;MACR;IAAU;IAAc;IAA4B;IAAc;;;EAErE,KAAK,cAAc,QAAQ;;;;;EAK3B,KAAK;IAAS;IAAiB;IAAgB;MAAoB,QAAQ;;;;;;EAM3E,OAAO,+BAA+B;IAAU;;;EAEhD,KACE,iBACA,oBACA;IAAS;MACR,QAAQ;;;;;;;UAUI;;EAEf,MAAM;;EAEN,KAAK;;EAEL,OAAO;;EAEP,MAAM,cAAc,QAAQ;;EAE5B,YACE,aACA;IAAS;MACR,eAAe;;;;;;EAMlB,MAAM,aAAa,OAAO,eAAe,QAAQ;EACjD,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCX,GAAG,GAAG,kBAAkB,KAAK,IAAI,mBAAmB,QAAQ,KAAK,IAAI,QAAQ;;;;;;;EAO7E,MAAM;EACN,SAAS;EACT,UAAU;EACV,QAAQ;EACR,OAAO;EACP,SAAS;;;KAIC,sBACV,KAAK,oBACL,KAAK,uBACF,QAAQ,YAAY;;;;;;;;UCjnBR;EACf;EACA;EACA;EACA;EACA;EACA;;EAEA;;QAGM;YACI;IACR,cAAc;;;;;;;;;iBAUF,yBAAyB;;;KCpB7B;UAEK;EACf,IAAI,OAAO,gBAAgB,aAAa,MAAM;;;iBAMhC,gBAAgB,QAAQ;;iBAKxB,mBAAmB;;;;UCIlB,qBAAqB;EACpC,MAAM;EACN;EACA,OAAO;;EAEP;;UAGQ;;EAER;;UA+De,0BAA0B;;EAEzC;;;;;;;iBAQc,cAAc,OAAM,oBAAyB,qBAAqB;;;;;iBAsBlE,eACd,0BACA,OAAM,eACL,qBAAqB;;;;;;iBAwBR,WACd,SAAS,wBACT,OAAM,eACL,qBAAqB;;;;;;;iBA0BR,WACd,SAAS,uBACT,OAAM,eACL,qBAAqB;;;;;;iBAyBR,gBACd,SAAS,4BACT,OAAM,eACL,qBAAqB;;;;;;;iBA0BR,eACd,SAAS,2BACT,OAAM,eACL,qBAAqB;;;;;;iBAyBR,kBACd,OAAM,eACL,qBAAqB;;;;;;;;iBC1QF,kBAAkB,GACtC,MAAM,UACN,UAAU,OAAO,aAChB;;;;KCNS;UAEK;EACf;EACA;EACA,YAAY;EACZ;EACA;EACA;;EAEA;;;UAIe,iCAAiC;;EAEhD;;EAEA;;UAGe;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA,YAAY;EACZ,cAAc;EACd,kBAAkB;EAClB;;;UAIe;EACf;EACA;EACA;;UAGe;EACf,UAAU;EACV,OAAO;;UAKQ;EACf;EACA;;UAGe;EACf;EACA;EACA,OAAO;;UAKQ;EACf;EACA;;EAEA;;EAEA;;UAGe;EACf,QAAQ,eAAe;;UAKR;;EAEf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;;UAGe;EACf;EACA;EACA;EACA;;;;KAKU;EAEN;EACA;EACA,OAAO,KAAK;EACZ,OAAO;;EAEP;EAAe;EAAiB;EAAsB;;EACtD;;;;UAIW;EACf;EACA,OAAO;EACP,OAAO;;;;UCzGQ;EACf,MAAM;EACN;EACA,OAAO;EACP;;;;;;;;;;;;iBAac,mBAAmB;EAAQ;IAA2B;UA6CrD;;EAEf;;EAEA;EACA;;UAGe;EACf,MAAM;EACN;EACA,OAAO;EACP;;;;;;;iBAQc,uBACd,yBACA,OAAM,6BACL;UAoDc;;EAEf,WAAW;EACX;EACA;EACA,OAAO;;;;;;;;iBAmCO,oBACd,yBACA,yBACA,yBACC;;;;KCtKS,cAAc,SAAS;;;KAIvB,cAAc,KAAK;;;KAInB,WAAW,KAAK;;;UAIX;;EAEf,MAAM;;EAEN,MAAM;;EAEN,QAAQ;;;;;;;UAQO;;WAEN;;WAEA,OAAO;;EAEhB,KAAK,SAAS,cAAc,QAAQ;;EAEpC,OAAO,SAAS,cAAc,QAAQ;;EAEtC,QAAQ,SAAS,cAAc,QAAQ;;EAEvC,QAAQ,MAAM,aAAa,SAAS,cAAc,QAAQ;;EAE1D,KAAK,MAAM,UAAU,SAAS,cAAc,QAAQ;;EAEpD,MAAM,OAAO,yBAAyB;;;;;;;UAQvB;;WAEN;;EAET,KAAK,eAAe,SAAS,cAAc,QAAQ;;EAEnD,OAAO,aAAa;;;;;;;;cAST,wCAAwC;WAC1C;WACA,OAAO;EAChB,YAAY,cAAc,OAAO;;;;;;;iBAkBnB,iBAAiB,0BAA0B,SAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;iBAqGjE,iBAAiB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/config.ts","../src/metricTree.ts","../src/anomalies.ts","../src/custom-app/base64.ts","../src/custom-app/debug.ts","../src/custom-app/function-context.ts","../src/custom-app/inject.ts","../src/custom-app/logger.ts","../src/custom-app/metric-tree-hooks.tsx","../src/custom-app/sse.ts","../src/worldModel.ts","../src/custom-app/world-model-hooks.tsx","../src/custom-app/world-node.tsx"],"mappings":";;;;;;UAGiB;;;;EAIf;;;;EAKA;;;;EAKA;;;;EAKA;;;;EAKA;;;;;;;EAQA;;;;;EAMA;;;;KCjCU;KACA;KACA;KACA;KACA;UAEK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA,MAAM;;EAEN;EACA,WAAW;EACX,UAAU;EACV,YAAY;EACZ;EACA,MAAM;EACN;EACA;EACA;EACA;;UAGe;EACf,OAAO;EACP,OAAO;EACP;;UAKe;EACf;EACA;EACA;EACA;EACA,OAAO;EACP,WAAW;EACX,UAAU;EACV;EACA;;UAGe;EACf;EACA,SAAS;;UAKM;EACf;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,MAAM;EACN;;UAGe;EACf,QAAQ;EACR,SAAS;;KAKC;EACN;EAAmB;;EACnB;EAAmB;EAAmB;;EACtC;EAA6B;EAAmB;;EAChD;EAAuB;EAAmB;EAAe;;UAE9C;EACf,OAAO;EACP;EACA;EACA;;UAGe;EACf,OAAO;EACP;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;EACA,WAAW;;;;;;;KAQD;;;;;UAMK;EACf;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;;EAGA,YAAY;EACZ,eAAe;EACf;EACA,MAAM;;EAEN;EACA;EACA,cAAc;;KAGJ;EAEN;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;EACA;;UAGW;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,SAAS;;UAGM;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,qBAAqB;EACrB;EACA,WAAW;;UAKI;EACf;EACA;EACA;EACA;EACA;;EAEA;;UAGe;EACf;EACA;;EAEA;EACA;EACA,UAAU;EACV;;UAGe;EACf;EACA;;UAGe;EACf;EACA;EACA;;UAGe;EACf;EACA;EACA;;;;;EAKA;EACA,YAAY;EACZ,oBAAoB;EACpB,YAAY;;;;;;;;UAWG;EACf;EACA;;EAEA;;UAKe;;EAEf,SAAS;;;;;;;KAUC,e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"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // @oxy/sdk - TypeScript SDK for Oxy data platform
-import { _ as interpretCustomAppError, a as useFunction, c as useQuery, d as useTrackEvent, f as _resetCustomAppManifestCacheForTest, g as apiErrorFromResponse, h as OxyApiError, i as useAgentRun, l as useResolvedManifest, m as readInjectedAppConfig, n as OxyAppProvider, o as useOxyApp, p as loadCustomAppManifest, r as OxyChat, s as useProcedureRun, t as OxyAnswer, u as useSemanticQuery, v as getOxyAppLogger, y as setOxyAppLogger } from "./react-B7zt-0RH.mjs";
+import { _ as interpretCustomAppError, a as useFunction, c as useQuery, d as useTrackEvent, f as _resetCustomAppManifestCacheForTest, g as apiErrorFromResponse, h as OxyApiError, i as useAgentRun, l as useResolvedManifest, m as readInjectedAppConfig, n as OxyAppProvider, o as useOxyApp, p as loadCustomAppManifest, r as OxyChat, s as useProcedureRun, t as OxyAnswer, u as useSemanticQuery, v as getOxyAppLogger, y as setOxyAppLogger } from "./react-DqnINwTi.mjs";
 import * as React from "react";
 
 //#region src/anomalies.ts

package/dist/{react-BGUzRMxq.d.mts → react-CLONxcnA.d.cts}

@@ -64,6 +64,25 @@ interface OxyAppFunctionManifest {
   email?: {
     send?: boolean;
   };
+  /**
+   * Capability for `ctx.org.people()` — the org's people directory, READ-ONLY
+   * (fail-closed: omit → the call is rejected before any query).
+   *
+   * Declare it for a function that has to name a person: an assignee, a roster
+   * entry, who submitted something. It answers with a display name and a role.
+   *
+   * Three things it deliberately is not, so nobody plans around them:
+   * it returns **no email and no phone** — naming a colleague is a different
+   * need from contacting them off-platform; it returns **no location**, which
+   * the platform does not hold for a member; and it does **not include
+   * frontline workers**, who hold no org-membership row by design.
+   *
+   * One flag, not `read`/`write`: there is no write. Editing the directory
+   * would put tenant membership behind an app's manifest.
+   */
+  org?: {
+    read?: boolean;
+  };
   /**
    * Capability for `ctx.oltp` — read/write the app's OWN per-org OLTP schema on
    * the managed Postgres tenant (fail-closed: omit → every `ctx.oltp` call
@@ -139,6 +158,25 @@ interface OxyAppManifest {
    * static bundle (today's default). See the functions design doc.
    */
   functions?: Record<string, OxyAppFunctionManifest>;
+  /**
+   * Schema migrations that ship WITH this bundle and run on promote.
+   *
+   * `dir` is a directory inside the built bundle holding numbered `.sql` files.
+   * The platform runs them in lexical order, **once each, ever**, inside a
+   * transaction, as the app's own writer role, and records each one.
+   *
+   * What changes for the author: you no longer write defensive
+   * `IF NOT EXISTS` / idempotent upserts, because re-running is a no-op by
+   * construction rather than by your care. And you **may not edit, rename or
+   * copy a migration that has already run** — all three fail the promote by
+   * name, and the fix is always a new file.
+   *
+   * The `.sql` files are ordinary bundle files, fetchable over the app's own
+   * host: put no secrets in them.
+   */
+  migrations?: {
+    dir: string;
+  };
   /**
    * Optional Ask Oxygen binding (agent ref + composer chips). The
    * platform's registered copy is authoritative (surfaced by
@@ -420,6 +458,12 @@ declare function useResolvedManifest(): ResolvedCustomAppManifest;
  */
 declare function useOxyApp(): {
   projectId: string | undefined;
+  /**
+   * The `apps.id` this bundle was served as — from `window.__OXY_APP__`, so
+   * it is the platform's word and not the manifest's. Undefined under `pnpm
+   * dev` against a manifest with no injected identity.
+   */
+  appId: string | undefined;
   appSlug: string | undefined;
   orgSlug: string | undefined;
   fetcher: AppFetcher;
@@ -785,4 +829,4 @@ interface OxyChatProps {
 declare function OxyChat(props: OxyChatProps): React.JSX.Element;
 //#endregion
 export { loadCustomAppManifest as $, UseSemanticQueryOpts as A, FunctionError as B, UseProcedureRunInput as C, UseQueryOpts as D, UseQueryInput as E, useProcedureRun as F, apiErrorFromResponse as G, FunctionResult as H, useQuery as I, OxyAppFunctionManifest as J, interpretCustomAppError as K, useResolvedManifest as L, useAgentRun as M, useFunction as N, UseQueryResult as O, useOxyApp as P, _resetCustomAppManifestCacheForTest as Q, useSemanticQuery as R, UseFunctionResult as S, UseProcedureRunResult as T, CustomAppErrorReport as U, FunctionLog as V, OxyApiError as W, OxyAppPerformanceManifest as X, OxyAppManifest as Y, ResolvedCustomAppManifest as Z, SemanticFilter as _, AppFetcher as a, UseAgentRunInput as b, OxyAppProvider as c, OxyChatProps as d, ProcedureProgress as f, SemanticDateRangeOp as g, SemanticArrayOp as h, AgentSqlArtifact as i, UseSemanticQueryResult as j, UseSemanticQueryInput as k, OxyAppProviderProps as l, ProcedureRunState as m, AgentRunEvent as n, OxyAnswer as o, ProcedureResult as p, LoadManifestOptions as q, AgentRunState as r, OxyAnswerProps as s, AgentArtifact as t, OxyChat as u, SemanticScalarOp as v, UseProcedureRunOpts as w, UseAgentRunResult as x, SemanticTimeDimension as y, useTrackEvent as z };
-//# sourceMappingURL=react-BGUzRMxq.d.mts.map
+//# sourceMappingURL=react-CLONxcnA.d.cts.map

package/dist/react-CLONxcnA.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-CLONxcnA.d.cts","names":[],"sources":["../src/custom-app/manifest.ts","../src/custom-app/errors.ts","../src/custom-app/function-sse.ts","../src/custom-app/react.tsx"],"mappings":"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"}

package/dist/{react-BGUzRMxq.d.cts → react-CLONxcnA.d.mts}

@@ -64,6 +64,25 @@ interface OxyAppFunctionManifest {
   email?: {
     send?: boolean;
   };
+  /**
+   * Capability for `ctx.org.people()` — the org's people directory, READ-ONLY
+   * (fail-closed: omit → the call is rejected before any query).
+   *
+   * Declare it for a function that has to name a person: an assignee, a roster
+   * entry, who submitted something. It answers with a display name and a role.
+   *
+   * Three things it deliberately is not, so nobody plans around them:
+   * it returns **no email and no phone** — naming a colleague is a different
+   * need from contacting them off-platform; it returns **no location**, which
+   * the platform does not hold for a member; and it does **not include
+   * frontline workers**, who hold no org-membership row by design.
+   *
+   * One flag, not `read`/`write`: there is no write. Editing the directory
+   * would put tenant membership behind an app's manifest.
+   */
+  org?: {
+    read?: boolean;
+  };
   /**
    * Capability for `ctx.oltp` — read/write the app's OWN per-org OLTP schema on
    * the managed Postgres tenant (fail-closed: omit → every `ctx.oltp` call
@@ -139,6 +158,25 @@ interface OxyAppManifest {
    * static bundle (today's default). See the functions design doc.
    */
   functions?: Record<string, OxyAppFunctionManifest>;
+  /**
+   * Schema migrations that ship WITH this bundle and run on promote.
+   *
+   * `dir` is a directory inside the built bundle holding numbered `.sql` files.
+   * The platform runs them in lexical order, **once each, ever**, inside a
+   * transaction, as the app's own writer role, and records each one.
+   *
+   * What changes for the author: you no longer write defensive
+   * `IF NOT EXISTS` / idempotent upserts, because re-running is a no-op by
+   * construction rather than by your care. And you **may not edit, rename or
+   * copy a migration that has already run** — all three fail the promote by
+   * name, and the fix is always a new file.
+   *
+   * The `.sql` files are ordinary bundle files, fetchable over the app's own
+   * host: put no secrets in them.
+   */
+  migrations?: {
+    dir: string;
+  };
   /**
    * Optional Ask Oxygen binding (agent ref + composer chips). The
    * platform's registered copy is authoritative (surfaced by
@@ -420,6 +458,12 @@ declare function useResolvedManifest(): ResolvedCustomAppManifest;
  */
 declare function useOxyApp(): {
   projectId: string | undefined;
+  /**
+   * The `apps.id` this bundle was served as — from `window.__OXY_APP__`, so
+   * it is the platform's word and not the manifest's. Undefined under `pnpm
+   * dev` against a manifest with no injected identity.
+   */
+  appId: string | undefined;
   appSlug: string | undefined;
   orgSlug: string | undefined;
   fetcher: AppFetcher;
@@ -785,4 +829,4 @@ interface OxyChatProps {
 declare function OxyChat(props: OxyChatProps): React.JSX.Element;
 //#endregion
 export { loadCustomAppManifest as $, UseSemanticQueryOpts as A, FunctionError as B, UseProcedureRunInput as C, UseQueryOpts as D, UseQueryInput as E, useProcedureRun as F, apiErrorFromResponse as G, FunctionResult as H, useQuery as I, OxyAppFunctionManifest as J, interpretCustomAppError as K, useResolvedManifest as L, useAgentRun as M, useFunction as N, UseQueryResult as O, useOxyApp as P, _resetCustomAppManifestCacheForTest as Q, useSemanticQuery as R, UseFunctionResult as S, UseProcedureRunResult as T, CustomAppErrorReport as U, FunctionLog as V, OxyApiError as W, OxyAppPerformanceManifest as X, OxyAppManifest as Y, ResolvedCustomAppManifest as Z, SemanticFilter as _, AppFetcher as a, UseAgentRunInput as b, OxyAppProvider as c, OxyChatProps as d, ProcedureProgress as f, SemanticDateRangeOp as g, SemanticArrayOp as h, AgentSqlArtifact as i, UseSemanticQueryResult as j, UseSemanticQueryInput as k, OxyAppProviderProps as l, ProcedureRunState as m, AgentRunEvent as n, OxyAnswer as o, ProcedureResult as p, LoadManifestOptions as q, AgentRunState as r, OxyAnswerProps as s, AgentArtifact as t, OxyChat as u, SemanticScalarOp as v, UseProcedureRunOpts as w, UseAgentRunResult as x, SemanticTimeDimension as y, useTrackEvent as z };
-//# sourceMappingURL=react-BGUzRMxq.d.cts.map
+//# sourceMappingURL=react-CLONxcnA.d.mts.map

package/dist/react-CLONxcnA.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-CLONxcnA.d.mts","names":[],"sources":["../src/custom-app/manifest.ts","../src/custom-app/errors.ts","../src/custom-app/function-sse.ts","../src/custom-app/react.tsx"],"mappings":"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"}

package/dist/{react-B7zt-0RH.mjs → react-DqnINwTi.mjs}

@@ -772,6 +772,7 @@ function useOxyApp() {
 	if (!ctx) throw new Error("useOxyApp must be called inside <OxyAppProvider>");
 	return {
 		projectId: ctx.resolved?.projectId,
+		appId: ctx.resolved?.appId,
 		appSlug: ctx.resolved?.appSlug,
 		orgSlug: ctx.resolved?.orgSlug,
 		fetcher: ctx.fetcher
@@ -1558,7 +1559,7 @@ function sleep(ms, signal) {
 * within-limit events are unaffected.
 */
 function useTrackEvent() {
-	const { projectId, fetcher } = useOxyApp();
+	const { projectId, appId, fetcher } = useOxyApp();
 	const queueRef = React.useRef([]);
 	const flushTimerRef = React.useRef(null);
 	const flush = React.useCallback(() => {
@@ -1569,7 +1570,10 @@ function useTrackEvent() {
 		queueRef.current = [];
 		for (const evt of batch) {
 			const url = `/api/customer-apps/${projectId}/events`;
-			const body = JSON.stringify(evt);
+			const body = JSON.stringify(appId ? {
+				...evt,
+				app_id: appId
+			} : evt);
 			try {
 				if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function" && document.visibilityState === "hidden") navigator.sendBeacon(url, new Blob([body], { type: "application/json" }));
 				else fetcher(url, {
@@ -1583,7 +1587,11 @@ function useTrackEvent() {
 				console.warn("[oxy] useTrackEvent enqueue failed:", e);
 			}
 		}
-	}, [projectId, fetcher]);
+	}, [
+		projectId,
+		fetcher,
+		appId
+	]);
 	React.useEffect(() => {
 		if (typeof window === "undefined") return;
 		const onHide = () => flush();
@@ -2284,4 +2292,4 @@ const styles = {
 
 //#endregion
 export { interpretCustomAppError as _, useFunction as a, useQuery as c, useTrackEvent as d, _resetCustomAppManifestCacheForTest as f, apiErrorFromResponse as g, OxyApiError as h, useAgentRun as i, useResolvedManifest as l, readInjectedAppConfig as m, OxyAppProvider as n, useOxyApp as o, loadCustomAppManifest as p, OxyChat as r, useProcedureRun as s, OxyAnswer as t, useSemanticQuery as u, getOxyAppLogger as v, setOxyAppLogger as y };
-//# sourceMappingURL=react-B7zt-0RH.mjs.map
+//# sourceMappingURL=react-DqnINwTi.mjs.map