@oxy-hq/sdk 2.5.0 → 2.8.0

package/dist/{react-BnpR8VRJ.d.cts → react-kHG5gkd-.d.mts}

@@ -1,9 +1,9 @@
 
 import * as React from "react";
-//#region src/customer-app/manifest.d.ts
+//#region src/custom-app/manifest.d.ts
 /**
  * Declaration of a single Oxy Function shipped in the bundle's
- * `functions/` dir. See `internal-docs/2026-06-12-customer-apps-functions-design.md`.
+ * `functions/` dir. See `internal-docs/customer-apps-functions.md`.
  *
  * All fields optional except that at least one invocation surface
  * (`route`, `schedule`, or `airwayStep`) must be active. Absent =
@@ -136,7 +136,7 @@ interface OxyAppManifest {
  * should treat this as the only source of truth for "which org/app
  * does this bundle belong to."
  */
-interface ResolvedCustomerAppManifest {
+interface ResolvedCustomAppManifest {
   manifest: OxyAppManifest;
   /**
    * Always an empty array for v2 manifests. Kept for API compatibility;
@@ -179,13 +179,13 @@ interface LoadManifestOptions {
  * Load + validate the manifest. Cached after the first call so callers
  * can invoke this from every component without coordinating.
  */
-declare function loadCustomerAppManifest(options?: LoadManifestOptions): Promise<ResolvedCustomerAppManifest>;
+declare function loadCustomAppManifest(options?: LoadManifestOptions): Promise<ResolvedCustomAppManifest>;
 /** For tests: reset the cache between runs. */
-declare function _resetCustomerAppManifestCacheForTest(): void;
+declare function _resetCustomAppManifestCacheForTest(): void;
 //#endregion
-//#region src/customer-app/errors.d.ts
+//#region src/custom-app/errors.d.ts
 /**
- * Error thrown by all customer-app hooks when an API call returns a
+ * Error thrown by all custom-app hooks when an API call returns a
  * non-2xx response. Carries the structured `code` + `hint` the server
  * emits so bundle UIs can render an actionable message instead of
  * "404: { ...json... }".
@@ -208,23 +208,23 @@ declare class OxyApiError extends Error {
  * dominate the bundle UI).
  */
 declare function apiErrorFromResponse(resp: Response): Promise<OxyApiError>;
-interface CustomerAppErrorReport {
+interface CustomAppErrorReport {
   title: string;
   message: string;
   hint: string;
   docs?: string;
 }
 /** Interpret a thrown error as a structured report for UI display. */
-declare function interpretCustomerAppError(err: unknown): CustomerAppErrorReport;
+declare function interpretCustomAppError(err: unknown): CustomAppErrorReport;
 //#endregion
-//#region src/customer-app/function-sse.d.ts
+//#region src/custom-app/function-sse.d.ts
 /** A captured `console.*` / `ctx.log` line from a function run. */
 interface FunctionLog {
   level: string;
   message: string;
 }
 //#endregion
-//#region src/customer-app/react.d.ts
+//#region src/custom-app/react.d.ts
 /**
  * Credentialed fetch wrapper stored in context so `useQuery` can share
  * the same request mechanism without coupling it to the global `fetch`.
@@ -237,7 +237,7 @@ interface FunctionLog {
  */
 type AppFetcher = typeof fetch;
 interface OxyAppProviderProps {
-  /** Optional manifest load options. Same shape as `loadCustomerAppManifest`. */
+  /** Optional manifest load options. Same shape as `loadCustomAppManifest`. */
   manifestOptions?: LoadManifestOptions;
   /**
    * Rendered while the manifest is loading. Defaults to nothing; pass a
@@ -249,7 +249,7 @@ interface OxyAppProviderProps {
    * report so the bundle can show its own branded error card. Defaults
    * to a minimal text-only fallback (better than a blank page).
    */
-  errorFallback?: (err: CustomerAppErrorReport) => React.ReactNode;
+  errorFallback?: (err: CustomAppErrorReport) => React.ReactNode;
   /**
    * Override the fetch implementation used by all hooks (`useQuery`).
    * Useful for test environments or proxy setups. Defaults to a wrapper
@@ -278,13 +278,18 @@ declare function OxyAppProvider(props: OxyAppProviderProps): React.JSX.Element;
  * `<OxyAppProvider>` — that's a programmer error worth surfacing
  * loudly, not silently swallowing.
  */
-declare function useResolvedManifest(): ResolvedCustomerAppManifest;
+declare function useResolvedManifest(): ResolvedCustomAppManifest;
 /**
  * Low-level hook that returns the raw context value (including the
  * fetcher). Prefer `useResolvedManifest` for manifest access; use
  * this only when you need the fetcher or identity without requiring
  * the manifest to be ready (e.g. inside `useQuery`, or the shell
  * chrome, which must never block the app on the manifest load).
+ *
+ * Exported for sibling hook modules (`metric-tree-hooks`,
+ * `world-model-hooks`) that need the same credentialed fetcher +
+ * project scope without re-deriving the context wiring. Not part of
+ * the public bundle API — bundle authors use the concrete hooks.
  */
 declare function useOxyApp(): {
   projectId: string | undefined;
@@ -310,7 +315,7 @@ interface UseQueryResult<Row = Record<string, unknown>> {
 }
 /**
  * Execute an ad-hoc SQL query against the project linked to this
- * customer app. The query is specified inline by the caller; no
+ * custom app. The query is specified inline by the caller; no
  * manifest declaration is involved.
  *
  * Re-runs whenever `input` or enabled `params` change. Use the
@@ -652,5 +657,5 @@ interface OxyChatProps {
  */
 declare function OxyChat(props: OxyChatProps): React.JSX.Element;
 //#endregion
-export { UseSemanticQueryOpts as A, CustomerAppErrorReport as B, UseProcedureRunInput as C, UseQueryOpts as D, UseQueryInput as E, useProcedureRun as F, OxyAppFunctionManifest as G, apiErrorFromResponse as H, useQuery as I, _resetCustomerAppManifestCacheForTest as J, OxyAppManifest as K, useResolvedManifest as L, useAgentRun as M, useFunction as N, UseQueryResult as O, useOxyApp as P, useSemanticQuery as R, UseFunctionResult as S, UseProcedureRunResult as T, interpretCustomerAppError as U, OxyApiError as V, LoadManifestOptions as W, loadCustomerAppManifest as Y, 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, ResolvedCustomerAppManifest 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-BnpR8VRJ.d.cts.map
+export { UseSemanticQueryOpts as A, CustomAppErrorReport as B, UseProcedureRunInput as C, UseQueryOpts as D, UseQueryInput as E, useProcedureRun as F, OxyAppFunctionManifest as G, apiErrorFromResponse as H, useQuery as I, _resetCustomAppManifestCacheForTest as J, OxyAppManifest as K, useResolvedManifest as L, useAgentRun as M, useFunction as N, UseQueryResult as O, useOxyApp as P, useSemanticQuery as R, UseFunctionResult as S, UseProcedureRunResult as T, interpretCustomAppError as U, OxyApiError as V, LoadManifestOptions as W, loadCustomAppManifest as Y, 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, ResolvedCustomAppManifest 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-kHG5gkd-.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-kHG5gkd-.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":";;;;;;;;;;;UA0BiB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;IAAe;IAAkB;;;EAEjC;;;;;;;;;EASA;IAAU;;;;;;;;;;EASV;;;;;;;EAOA;IAAY;;;;;;;;;EAQZ;IAAU;;;;;;;;;;EASV;IAAY;IAAsB;IAAuB;;;;;;;;EAOzD;;;UAIe;;EAEf;;;;;;EAMA;;;;;;;EAOA;;;;;;EAMA;;;;;;EAMA;;;;;;EAMA,YAAY,eAAe;;;;;;;EAO3B;IAAQ;IAAgB;;;;;;;;UAUT;EACf,UAAU;;;;;;;EAOV;;EAEA;;EAEA;;;;;;EAMA;;EAEA;;;;;;;;EAQA;;UAGe;;;;;;;EAOf;;;;;;iBASc,sBACd,UAAS,sBACR,QAAQ;;iBAQK;;;;;;;;;cC9KH,oBAAoB;WACtB;WACA;WACA;EACT,YAAY;IACV;IACA;IACA;IACA;;;;;;;;;iBAmBkB,qBAAqB,MAAM,WAAW,QAAQ;UA2BnD;EACf;EACA;EACA;EACA;;;iBAMc,wBAAwB,eAAe;;;;UC7EtC;EACf;EACA;;;;;;;;;;;;;;KC4CU,oBAAoB;UAsCf;;EAEf,kBAAkB;;;;;EAKlB,WAAW,MAAM;;;;;;EAMjB,iBAAiB,KAAK,yBAAyB,MAAM;;;;;;EAMrD,UAAU;;;;;;;;;;EAUV;EACA,UAAU,MAAM;;;;;;iBAOF,eAAe,OAAO,sBAAsB,MAAM,IAAI;;;;;;iBA0GtD,uBAAuB;;;;;;;;;;;;;iBA0BvB;EACd;EACA;EACA;EACA,SAAS;;UAgBM;EACf;EACA;;UAGe;EACf,SAAS;;EAET;;UAGe,eAAe,MAAM;EACpC,MAAM;EACN;EACA;EACA,OAAO;EACP;;;;;;;;;;;iBAYc,SAAS,MAAM,yBAC7B,OAAO,eACP,OAAM,eACL,eAAe;UAwFD,kBAAkB;;;;;;;;EAQjC,SAAS,gBAAgB;IAAS;QAA8B,QAAQ;;EAExE,MAAM;;EAEN;;EAEA,OAAO;;;;;;;EAOP,MAAM;;;;;;;;;;;;iBAaQ,YAAY,gBAAgB,eAAe,kBAAkB;;KAoFjE;;KAGA;;KAGA;;;;;;;;KASA;EACN;EAAe,IAAI;EAAkB;;EACrC;EAAe,IAAI;EAAiB,QAAQ;;EAC5C;EAAe,IAAI;EAAqB;EAAc;;;UAG3C;EACf;EACA;;UAGe;EACf;EACA;EACA;EACA,kBAAkB;EAClB,UAAU;EACV;;UAGe;;EAEf;;;;;;;EAOA;;UAGe,uBAAuB,MAAM;EAC5C,MAAM;EACN;;EAEA;;EAEA;EACA;EACA,OAAO;EACP;;;;;;;;;;;;iBAac,iBAAiB,MAAM,yBACrC,OAAO,uBACP,OAAM,uBACL,uBAAuB;KAoHd;UAEK;EACf;;UAGe;;;EAGf;EACA;;EAEA;;UAGe;EACf;EACA;;UAGe;EACf;EACA,SAAS;;UAGM;EACf,OAAO;EACP,MAAM,SAAS;;EAEf;EACA,UAAU;EACV,QAAQ;EACR,OAAO;;;;;;;;;;;;;;;;;;;;iBAyBO,gBACd,OAAO,sBACP,OAAM,sBACL;KAsLS;UAEK;EACf;EACA;;;;;;UAOe;EACf;;;EAGA;;;EAGA;EACA;;EAEA;IACE;IACA;IACA;;;;;EAKF;;KAGU,gBAAgB;UAEX;EACf;;UAGe;EACf,OAAO;;EAEP,MAAM,kBAAkB;IAAS;;;EAEjC;;EAEA,QAAQ;;;;EAIR,WAAW;;EAEX;;EAEA;;EAEA;;;;;;;;;;;;;;;;;;;EAmBA;EACA,OAAO;;iBAGO,YAAY,OAAO,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2hBtC,kBAAkB,cAAc,UAAU;UA6GzC;;EAEf;;EAEA,YAAY;;EAEZ,OAAO;;EAEP;;EAEA,QAAQ;;;;;;;;EAQR;;EAEA;;;EAGA;;EAEA;;;;;;;;;;;;;;;;;;;iBAoBc,UAAU,OAAO,iBAAiB,MAAM,IAAI;UAgE3C;;EAEf;;EAEA;;EAEA;;EAEA,aAAa,MAAM;;EAEnB;;EAEA;;;;;;;;;;;;;;iBAec,QAAQ,OAAO,eAAe,MAAM,IAAI"}

package/dist/{react-CVdWXcu8.mjs → react-sT7E4CbA.mjs}

@@ -2,7 +2,7 @@
 import * as React from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 
-//#region src/customer-app/logger.ts
+//#region src/custom-app/logger.ts
 let activeLogger = createConsoleLogger();
 /** Replace the global logger. Pass `null` to silence everything. */
 function setOxyAppLogger(logger) {
@@ -42,9 +42,9 @@ function silentLogger() {
 }
 
 //#endregion
-//#region src/customer-app/errors.ts
+//#region src/custom-app/errors.ts
 /**
-* Error thrown by all customer-app hooks when an API call returns a
+* Error thrown by all custom-app hooks when an API call returns a
 * non-2xx response. Carries the structured `code` + `hint` the server
 * emits so bundle UIs can render an actionable message instead of
 * "404: { ...json... }".
@@ -91,12 +91,12 @@ async function apiErrorFromResponse(resp) {
 }
 const ARCH_DOC = "internal-docs/customer-apps.md";
 /** Interpret a thrown error as a structured report for UI display. */
-function interpretCustomerAppError(err) {
+function interpretCustomAppError(err) {
 	const message = err instanceof Error ? err.message : String(err);
 	if (/Failed to load oxy-app\.json.*HTTP 404/.test(message)) return {
 		title: "Manifest not found",
 		message,
-		hint: "The bundle is being served, but oxy-app.json was not. Check that public/oxy-app.json is committed in the customer-app repo and that the build copied it into the static output. If you're using Next.js, anything under public/ is auto-copied to out/.",
+		hint: "The bundle is being served, but oxy-app.json was not. Check that public/oxy-app.json is committed in the custom-app repo and that the build copied it into the static output. If you're using Next.js, anything under public/ is auto-copied to out/.",
 		docs: ARCH_DOC
 	};
 	if (/Failed to load oxy-app\.json/.test(message)) return {
@@ -132,7 +132,7 @@ function interpretCustomerAppError(err) {
 	if (/^403:.*SELECT.*WITH/im.test(message)) return {
 		title: "Query rejected — read-only endpoint",
 		message,
-		hint: "This proxy only runs SELECT or WITH queries. Mutations (INSERT/UPDATE/DELETE/DROP) are not allowed from customer-app bundles.",
+		hint: "This proxy only runs SELECT or WITH queries. Mutations (INSERT/UPDATE/DELETE/DROP) are not allowed from custom-app bundles.",
 		docs: ARCH_DOC
 	};
 	if (/^403:/m.test(message)) return {
@@ -168,7 +168,7 @@ function interpretCustomerAppError(err) {
 	if (/Unexpected token '<'|<!doctype/i.test(message)) return {
 		title: "Fetched HTML where JSON was expected",
 		message,
-		hint: "Most likely the built bundle is stale — built against an old SDK whose endpoints no longer exist on the server. Rebuild the bundle (vite build) with @oxy-hq/sdk@^2.0.0 and reload. If the bundle is current, check that OXY_APP_BASE_PATH matches the path the customer-app row is served at.",
+		hint: "Most likely the built bundle is stale — built against an old SDK whose endpoints no longer exist on the server. Rebuild the bundle (vite build) with @oxy-hq/sdk@^2.0.0 and reload. If the bundle is current, check that OXY_APP_BASE_PATH matches the path the custom-app row is served at.",
 		docs: ARCH_DOC
 	};
 	return {
@@ -180,7 +180,7 @@ function interpretCustomerAppError(err) {
 }
 
 //#endregion
-//#region src/customer-app/inject.ts
+//#region src/custom-app/inject.ts
 /**
 * Read the runtime app-config oxy injected at serve time. Returns
 * `undefined` outside the browser or when the global isn't set
@@ -193,18 +193,18 @@ function readInjectedAppConfig() {
 }
 
 //#endregion
-//#region src/customer-app/manifest.ts
+//#region src/custom-app/manifest.ts
 let cached = null;
 /**
 * Load + validate the manifest. Cached after the first call so callers
 * can invoke this from every component without coordinating.
 */
-function loadCustomerAppManifest(options = {}) {
+function loadCustomAppManifest(options = {}) {
 	if (!cached) cached = fetchAndValidate(options);
 	return cached;
 }
 /** For tests: reset the cache between runs. */
-function _resetCustomerAppManifestCacheForTest() {
+function _resetCustomAppManifestCacheForTest() {
 	cached = null;
 }
 async function fetchAndValidate(options) {
@@ -226,7 +226,7 @@ async function fetchAndValidate(options) {
 			status: res.status,
 			statusText: res.statusText
 		});
-		throw new Error(`Failed to load oxy-app.json from ${manifestUrl} (HTTP ${res.status}). The customer-app repo must commit this file alongside the bundle.`);
+		throw new Error(`Failed to load oxy-app.json from ${manifestUrl} (HTTP ${res.status}). The custom-app repo must commit this file alongside the bundle.`);
 	}
 	const manifest = validateManifest(await res.json(), manifestUrl);
 	const resolved = {
@@ -291,7 +291,7 @@ const FUNCTION_NAME_RE = /^[a-z][a-z0-9-]{0,63}$/;
 /**
 * Validate the optional `functions` map. Each key is a function name;
 * each value declares how the function is invoked. Mirrors the
-* server-side validation in `customer_apps_publish.rs` so a bad
+* server-side validation in `custom_apps_publish.rs` so a bad
 * manifest fails at build, not at publish.
 */
 function validateFunctions(raw) {
@@ -369,7 +369,7 @@ function isRecord(v) {
 }
 
 //#endregion
-//#region src/customer-app/function-invoke.ts
+//#region src/custom-app/function-invoke.ts
 const inflight$1 = /* @__PURE__ */ new Map();
 /**
 * Dedup key for an invocation: function name + its (stable-serialized) body,
@@ -395,7 +395,7 @@ function sharedFunctionInvoke(key, run) {
 }
 
 //#endregion
-//#region src/customer-app/function-sse.ts
+//#region src/custom-app/function-sse.ts
 /**
 * Read a `text/event-stream` function response to completion. Resolves with the
 * decoded result + captured logs, or rejects (with `.logs` attached) on an
@@ -452,7 +452,7 @@ async function readFunctionSseStream(resp) {
 }
 
 //#endregion
-//#region src/customer-app/interpolate.ts
+//#region src/custom-app/interpolate.ts
 /**
 * Interpolate `{{ params.X }}` and `{{ params.X | sqlquote }}` placeholders
 * in a SQL template.
@@ -481,7 +481,7 @@ function interpolateSqlParams(sql, params) {
 }
 
 //#endregion
-//#region src/customer-app/markdown.ts
+//#region src/custom-app/markdown.ts
 /**
 * Allowlist for `[text](url)` href values in agent-emitted markdown.
 * Markdown comes from an LLM, which sits across an external trust
@@ -557,7 +557,7 @@ function isTableStart(lines, idx) {
 }
 
 //#endregion
-//#region src/customer-app/query-cache.ts
+//#region src/custom-app/query-cache.ts
 const SWR_TTL_MS = 3e4;
 const inflight = /* @__PURE__ */ new Map();
 const cache = /* @__PURE__ */ new Map();
@@ -601,7 +601,7 @@ async function sharedQuery(fetcher, projectId, sql, db, opts = {}) {
 }
 
 //#endregion
-//#region src/customer-app/react.tsx
+//#region src/custom-app/react.tsx
 function defaultFetcher(input, init) {
 	return fetch(input, {
 		credentials: "include",
@@ -642,7 +642,7 @@ function OxyAppProvider(props) {
 	});
 	React.useEffect(() => {
 		let cancelled = false;
-		loadCustomerAppManifest(manifestOptions).then((resolved) => {
+		loadCustomAppManifest(manifestOptions).then((resolved) => {
 			if (!cancelled) setState({
 				status: "ready",
 				resolved,
@@ -651,7 +651,7 @@ function OxyAppProvider(props) {
 		}).catch((e) => {
 			if (!cancelled) setState({
 				status: "error",
-				error: interpretCustomerAppError(e),
+				error: interpretCustomAppError(e),
 				fetcher
 			});
 		});
@@ -740,6 +740,11 @@ function useResolvedManifest() {
 * this only when you need the fetcher or identity without requiring
 * the manifest to be ready (e.g. inside `useQuery`, or the shell
 * chrome, which must never block the app on the manifest load).
+*
+* Exported for sibling hook modules (`metric-tree-hooks`,
+* `world-model-hooks`) that need the same credentialed fetcher +
+* project scope without re-deriving the context wiring. Not part of
+* the public bundle API — bundle authors use the concrete hooks.
 */
 function useOxyApp() {
 	const ctx = React.useContext(OxyAppContext);
@@ -753,7 +758,7 @@ function useOxyApp() {
 }
 /**
 * Execute an ad-hoc SQL query against the project linked to this
-* customer app. The query is specified inline by the caller; no
+* custom app. The query is specified inline by the caller; no
 * manifest declaration is involved.
 *
 * Re-runs whenever `input` or enabled `params` change. Use the
@@ -2254,5 +2259,5 @@ const styles = {
 };
 
 //#endregion
-export { interpretCustomerAppError as _, useFunction as a, useQuery as c, useTrackEvent as d, _resetCustomerAppManifestCacheForTest as f, apiErrorFromResponse as g, OxyApiError as h, useAgentRun as i, useResolvedManifest as l, readInjectedAppConfig as m, OxyAppProvider as n, useOxyApp as o, loadCustomerAppManifest as p, OxyChat as r, useProcedureRun as s, OxyAnswer as t, useSemanticQuery as u, getOxyAppLogger as v, setOxyAppLogger as y };
-//# sourceMappingURL=react-CVdWXcu8.mjs.map
+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-sT7E4CbA.mjs.map