@oxy-hq/sdk 2.13.0 → 2.16.0

package/dist/{react-D-Sf973d.d.mts → react-CljeXJuw.d.cts}

@@ -50,6 +50,13 @@ interface OxyAppFunctionManifest {
   };
   /** Wall-clock timeout. Default 30, max 300. */
   timeoutSeconds?: number;
+  /**
+   * Mark this function as a check. `oxyc checks run` runs it; with a
+   * `schedule` the platform runs it continuously and a failure pages. A
+   * check fails when it throws, times out, or returns `{ ok: false }`.
+   * Checks must not have customer-visible side effects.
+   */
+  check?: boolean;
   /**
    * Opt-in result caching for route invocations. Omit (the default) to never
    * cache — the safe choice for a side-effectful function (writes, external
@@ -68,13 +75,31 @@ interface OxyAppFunctionManifest {
    * destination here ONLY for a function that legitimately writes to it; a
    * read-only function omits it. This scopes writes away from the project's
    * source warehouse.
+   *
+   * A customer warehouse (anything but `airhouse` / `airhouse_managed`) is
+   * read-only: listing it here is not enough, it must also appear in
+   * `customerWarehouseWrites` with a reason.
    */
   destinations?: string[];
+  /**
+   * Customer warehouses this function writes to anyway, each with the reason —
+   * the exception to "customer warehouses are read-only". Every key must also be
+   * in `destinations`; a write to a customer warehouse not named here is refused.
+   * Prefer moving the data: facts to `airhouse`, records to `oltp`.
+   *
+   * ```json
+   * "customerWarehouseWrites": {
+   *   "clickhouse": "Journal entries stay beside the legacy ClickHouse facts until QuickBooks lands in Airhouse"
+   * }
+   * ```
+   */
+  customerWarehouseWrites?: Record<string, string>;
   /**
    * Capability to write app-scoped secrets via `ctx.secrets.set` (fail-closed:
    * omit → writes rejected). Only the app's own `apps/<app-id>/` namespace is
-   * writable. Declare for a function that persists state — e.g. a scheduled
-   * token-refresher that writes the rotated token back to Oxy Secrets.
+   * writable. Declare for a function that rotates a credential — e.g. a
+   * scheduled token-refresher that writes the rotated token back to Oxy Secrets.
+   * Secrets are not a state store: a cursor or counter is a record for `oltp`.
    */
   secrets?: {
     write?: boolean;
@@ -127,6 +152,17 @@ interface OxyAppFunctionManifest {
   oltp?: {
     enabled?: boolean;
   };
+  /**
+   * Capability for `ctx.airhouse` — append the app's own FACTS (what happened,
+   * never edited) to its schema in the workspace's Airhouse (fail-closed: omit →
+   * every `ctx.airhouse` call rejected). A pure GATE like `oltp`: the schema is
+   * derived from the app's slug (`store-ops` → `app_store_ops`), never named
+   * here. Writes run as the app, whoever invoked the function, so a scheduled
+   * run can write. Tables come from `airhouseMigrations`.
+   */
+  airhouse?: {
+    enabled?: boolean;
+  };
   /**
    * Retry policy for **background** runs (a `schedule` fire or a manual job
    * trigger). Omit → a job run is attempted once. Route (HTTP) invocations are
@@ -153,9 +189,9 @@ interface OxyAppManifest {
   /** Must be 2. v1 manifests are no longer supported. */
   schemaVersion: 2;
   /**
-   * Optional display name. The admin "Link existing" dialog prefills
-   * its Name field from this. Omit to let oxy fall back to the
-   * folder basename.
+   * Optional display name. Informational: the name an app shows is its
+   * registry row's, set when the row is created (the admin **New app**
+   * dialog, or `oxyc publish --name` on a first publish).
    */
   name?: string;
   /**
@@ -184,7 +220,8 @@ interface OxyAppManifest {
    */
   functions?: Record<string, OxyAppFunctionManifest>;
   /**
-   * Schema migrations that ship WITH this bundle and run on promote.
+   * Schema migrations for the app's OLTP store (`ctx.oltp`) 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
@@ -202,6 +239,18 @@ interface OxyAppManifest {
   migrations?: {
     dir: string;
   };
+  /**
+   * Tables for the app's FACTS, in its Airhouse schema `app_<writer>`: a
+   * directory of numbered `.sql` files run once each, at promote, with the same
+   * ledger rules as `migrations` (never edit, rename or copy one that ran).
+   *
+   * Every object must be named `app_<writer>.<name>`. Airhouse is DuckLake, so a
+   * file declaring a PRIMARY KEY, UNIQUE, an index or a foreign key is refused at
+   * publish — a table carrying one fails and leaves the writer inert.
+   */
+  airhouseMigrations?: {
+    dir: string;
+  };
   /**
    * Optional Ask Oxygen binding (agent ref + composer chips). The
    * platform's registered copy is authoritative (surfaced by
@@ -921,4 +970,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-D-Sf973d.d.mts.map
+//# sourceMappingURL=react-CljeXJuw.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-CljeXJuw.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-D-Sf973d.d.cts → react-CljeXJuw.d.mts}

@@ -50,6 +50,13 @@ interface OxyAppFunctionManifest {
   };
   /** Wall-clock timeout. Default 30, max 300. */
   timeoutSeconds?: number;
+  /**
+   * Mark this function as a check. `oxyc checks run` runs it; with a
+   * `schedule` the platform runs it continuously and a failure pages. A
+   * check fails when it throws, times out, or returns `{ ok: false }`.
+   * Checks must not have customer-visible side effects.
+   */
+  check?: boolean;
   /**
    * Opt-in result caching for route invocations. Omit (the default) to never
    * cache — the safe choice for a side-effectful function (writes, external
@@ -68,13 +75,31 @@ interface OxyAppFunctionManifest {
    * destination here ONLY for a function that legitimately writes to it; a
    * read-only function omits it. This scopes writes away from the project's
    * source warehouse.
+   *
+   * A customer warehouse (anything but `airhouse` / `airhouse_managed`) is
+   * read-only: listing it here is not enough, it must also appear in
+   * `customerWarehouseWrites` with a reason.
    */
   destinations?: string[];
+  /**
+   * Customer warehouses this function writes to anyway, each with the reason —
+   * the exception to "customer warehouses are read-only". Every key must also be
+   * in `destinations`; a write to a customer warehouse not named here is refused.
+   * Prefer moving the data: facts to `airhouse`, records to `oltp`.
+   *
+   * ```json
+   * "customerWarehouseWrites": {
+   *   "clickhouse": "Journal entries stay beside the legacy ClickHouse facts until QuickBooks lands in Airhouse"
+   * }
+   * ```
+   */
+  customerWarehouseWrites?: Record<string, string>;
   /**
    * Capability to write app-scoped secrets via `ctx.secrets.set` (fail-closed:
    * omit → writes rejected). Only the app's own `apps/<app-id>/` namespace is
-   * writable. Declare for a function that persists state — e.g. a scheduled
-   * token-refresher that writes the rotated token back to Oxy Secrets.
+   * writable. Declare for a function that rotates a credential — e.g. a
+   * scheduled token-refresher that writes the rotated token back to Oxy Secrets.
+   * Secrets are not a state store: a cursor or counter is a record for `oltp`.
    */
   secrets?: {
     write?: boolean;
@@ -127,6 +152,17 @@ interface OxyAppFunctionManifest {
   oltp?: {
     enabled?: boolean;
   };
+  /**
+   * Capability for `ctx.airhouse` — append the app's own FACTS (what happened,
+   * never edited) to its schema in the workspace's Airhouse (fail-closed: omit →
+   * every `ctx.airhouse` call rejected). A pure GATE like `oltp`: the schema is
+   * derived from the app's slug (`store-ops` → `app_store_ops`), never named
+   * here. Writes run as the app, whoever invoked the function, so a scheduled
+   * run can write. Tables come from `airhouseMigrations`.
+   */
+  airhouse?: {
+    enabled?: boolean;
+  };
   /**
    * Retry policy for **background** runs (a `schedule` fire or a manual job
    * trigger). Omit → a job run is attempted once. Route (HTTP) invocations are
@@ -153,9 +189,9 @@ interface OxyAppManifest {
   /** Must be 2. v1 manifests are no longer supported. */
   schemaVersion: 2;
   /**
-   * Optional display name. The admin "Link existing" dialog prefills
-   * its Name field from this. Omit to let oxy fall back to the
-   * folder basename.
+   * Optional display name. Informational: the name an app shows is its
+   * registry row's, set when the row is created (the admin **New app**
+   * dialog, or `oxyc publish --name` on a first publish).
    */
   name?: string;
   /**
@@ -184,7 +220,8 @@ interface OxyAppManifest {
    */
   functions?: Record<string, OxyAppFunctionManifest>;
   /**
-   * Schema migrations that ship WITH this bundle and run on promote.
+   * Schema migrations for the app's OLTP store (`ctx.oltp`) 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
@@ -202,6 +239,18 @@ interface OxyAppManifest {
   migrations?: {
     dir: string;
   };
+  /**
+   * Tables for the app's FACTS, in its Airhouse schema `app_<writer>`: a
+   * directory of numbered `.sql` files run once each, at promote, with the same
+   * ledger rules as `migrations` (never edit, rename or copy one that ran).
+   *
+   * Every object must be named `app_<writer>.<name>`. Airhouse is DuckLake, so a
+   * file declaring a PRIMARY KEY, UNIQUE, an index or a foreign key is refused at
+   * publish — a table carrying one fails and leaves the writer inert.
+   */
+  airhouseMigrations?: {
+    dir: string;
+  };
   /**
    * Optional Ask Oxygen binding (agent ref + composer chips). The
    * platform's registered copy is authoritative (surfaced by
@@ -921,4 +970,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-D-Sf973d.d.cts.map
+//# sourceMappingURL=react-CljeXJuw.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-CljeXJuw.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-CkAQg9wB.cjs → react-Dvkv2deI.cjs}

@@ -1,33 +1,7 @@
 // @oxy/sdk - TypeScript SDK for Oxy data platform
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
+const require_rolldown_runtime = require('./rolldown-runtime-KC0qvQup.cjs');
 let react = require("react");
-react = __toESM(react, 1);
+react = require_rolldown_runtime.__toESM(react, 1);
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/custom-app/logger.ts
@@ -115,6 +89,25 @@ async function apiErrorFromResponse(resp) {
 		message: snippet || `HTTP ${resp.status}`
 	});
 }
+/**
+* Normalize a rejected request into the `Error` a hook reports.
+*
+* An `AbortError` reaching a hook's `.catch` is by construction an abort the
+* hook did NOT cause — its own teardown is marked separately — so it is a
+* fetcher's request timeout, a dropped socket, or a navigation. The platform's
+* wording for those ("The user aborted a request.") is wrong on its face by
+* the time a bundle renders it, so rephrase and keep the original as `cause`.
+*
+* The name is used only to WORD an error already being reported. Whether to
+* report at all is the caller's teardown flag, never the name — that
+* conflation is what left hooks loading forever.
+*/
+function asReportableError(err) {
+	const name = typeof err === "object" && err !== null && "name" in err ? String(err.name) : "";
+	const e = err instanceof Error ? err : new Error(String(err));
+	if (name !== "AbortError" && e.name !== "AbortError") return e;
+	return Object.assign(/* @__PURE__ */ new Error("request was interrupted (the connection dropped or timed out)"), { cause: e });
+}
 const ARCH_DOC = "internal-docs/customer-apps.md";
 /** Interpret a thrown error as a structured report for UI display. */
 function interpretCustomAppError(err) {
@@ -327,7 +320,7 @@ const FUNCTION_NAME_RE = /^[a-z][a-z0-9-]{0,63}$/;
 *
 * This runs at manifest LOAD (app boot / `pnpm dev`), not at `oxy build` — the
 * build-time gate is the vite plugin's `validateManifest`, which now checks
-* function names too. `oxy publish` also validates them locally before esbuild,
+* function names too. `oxyc publish` also validates them locally before esbuild,
 * so a bad name fails before the upload regardless.
 */
 function validateFunctions(raw) {
@@ -366,6 +359,10 @@ function validateFunctions(raw) {
 			if (typeof t !== "number" || !Number.isInteger(t) || t < 1 || t > 300) throw new Error(`oxy-app.json: function "${fnName}" \`timeoutSeconds\` must be an integer in [1, 300]`);
 			fn.timeoutSeconds = t;
 		}
+		if (value.check !== void 0) {
+			if (typeof value.check !== "boolean") throw new Error(`oxy-app.json: function "${fnName}" \`check\` must be a boolean`);
+			fn.check = value.check;
+		}
 		if (value.cache !== void 0) {
 			const c = value.cache;
 			if (!isRecord(c)) throw new Error(`oxy-app.json: function "${fnName}" \`cache\` must be an object`);
@@ -920,7 +917,7 @@ function useQuery(input, opts = {}) {
 			setState((s) => ({
 				...s,
 				loading: false,
-				error: err instanceof Error ? err : new Error(String(err))
+				error: asReportableError(err)
 			}));
 		});
 		return () => {
@@ -1098,11 +1095,10 @@ function useSemanticQuery(input, opts = {}) {
 			});
 		}).catch((err) => {
 			if (cancelled) return;
-			if (err instanceof DOMException && err.name === "AbortError") return;
 			setState((s) => ({
 				...s,
 				loading: false,
-				error: err instanceof Error ? err : new Error(String(err))
+				error: asReportableError(err)
 			}));
 		});
 		return () => {
@@ -1259,13 +1255,13 @@ function useProcedureRun(input, opts = {}) {
 					return;
 				}
 			} catch (e) {
-				if (e instanceof DOMException && e.name === "AbortError") return;
+				if (ctrl.signal.aborted) return;
 				inflight.current.runId = void 0;
 				setState({
 					state: "failed",
 					progress: null,
 					result: null,
-					error: e instanceof Error ? e : new Error(String(e))
+					error: asReportableError(e)
 				});
 			}
 		})();
@@ -1366,6 +1362,8 @@ function useAgentRun(input) {
 					if (ctrl.signal.aborted) return;
 					if (terminated) return;
 					attempts += 1;
+					const idBeforeAttempt = lastEventId;
+					let windowError;
 					try {
 						await consumeSseStream({
 							url: `/api/projects/${projectId}/agents/runs/${encodeURIComponent(run_id)}/events`,
@@ -1415,36 +1413,29 @@ function useAgentRun(input) {
 							}
 						});
 					} catch (err) {
-						if (err instanceof DOMException && err.name === "AbortError") return;
-						if (attempts >= 5) {
-							inflight.current.runId = void 0;
-							setState((s) => ({
-								...s,
-								state: "failed",
-								error: err instanceof Error ? err : new Error(String(err))
-							}));
-							return;
-						}
+						if (ctrl.signal.aborted) return;
+						windowError = err;
 					}
 					if (terminated) return;
-					if (attempts >= 5) {
+					if (lastEventId !== idBeforeAttempt) attempts = 0;
+					else if (attempts >= 5) {
 						inflight.current.runId = void 0;
 						setState((s) => ({
 							...s,
 							state: "failed",
-							error: /* @__PURE__ */ new Error("run event stream closed without a terminal event")
+							error: windowError ? asReportableError(windowError) : /* @__PURE__ */ new Error("run event stream closed without a terminal event")
 						}));
 						return;
 					}
 					await sleep(1e3, ctrl.signal);
 				}
 			} catch (e) {
-				if (e instanceof DOMException && e.name === "AbortError") return;
+				if (ctrl.signal.aborted) return;
 				inflight.current.runId = void 0;
 				setState((s) => ({
 					...s,
 					state: "failed",
-					error: e instanceof Error ? e : new Error(String(e))
+					error: asReportableError(e)
 				}));
 			}
 		})();
@@ -2408,12 +2399,6 @@ Object.defineProperty(exports, 'OxyChat', {
     return OxyChat;
   }
 });
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});
 Object.defineProperty(exports, '_resetCustomAppManifestCacheForTest', {
   enumerable: true,
   get: function () {
@@ -2426,6 +2411,12 @@ Object.defineProperty(exports, 'apiErrorFromResponse', {
     return apiErrorFromResponse;
   }
 });
+Object.defineProperty(exports, 'asReportableError', {
+  enumerable: true,
+  get: function () {
+    return asReportableError;
+  }
+});
 Object.defineProperty(exports, 'getOxyAppLogger', {
   enumerable: true,
   get: function () {
@@ -2504,4 +2495,4 @@ Object.defineProperty(exports, 'useTrackEvent', {
     return useTrackEvent;
   }
 });
-//# sourceMappingURL=react-CkAQg9wB.cjs.map
+//# sourceMappingURL=react-Dvkv2deI.cjs.map