@alvera-ai/platform-sdk 0.12.1-next.f7f8a3c → 0.12.1-next.g069328b

package/.agent/data_activation_clients.md

@@ -386,6 +386,30 @@ durable" signal — not just the presence of the log row.
 
 ### 6.5 Verifying ingestion: the two-step dataset search
 
+> **Simplest landing check — `executeSql`.** Ingestion is async (the row
+> commits a moment after the `202`). When you just need to know a row
+> *landed*, poll `datalakes.executeSql` with a read-only `SELECT … WHERE
+> batch_id = '…'`: **each call is a fresh read, so there is no stale
+> snapshot to recover from** — unlike a `createUserSearch` created before
+> the row commits, which captures nothing and never updates. Gate on it,
+> then run the two-step `createUserSearch` below **once** (race-free) only
+> if you need the dataset's alias-join + tokenization semantics.
+>
+> ```typescript
+> const { data: probe } = await api.datalakes.executeSql(tenantSlug, datalakeSlug, {
+>   sql: `SELECT 1 FROM patients WHERE batch_id = '${batchId}' LIMIT 1`,
+>   mode: 'unregulated',
+> })
+> // `data` is an array-of-arrays (a `string` only for { format: 'csv' });
+> // a non-empty page proves the batch landed. Reference the unregulated
+> // table by its base name — `mode: 'regulated'` uses the `regulated_` prefix.
+> const landed = typeof probe !== 'string' && probe.data.length > 0
+> ```
+>
+> `createUserSearch` is the heavier, workflow-oriented surface — reach for
+> it when you need its alias joins (`ri.value`, tokenized read-back), not
+> for a plain "did it land" check.
+
 The canonical way to **prove a row landed in the datalake** is
 to query the dataset directly. This is a two-step pattern:
 

package/LICENSE

@@ -1,93 +1,21 @@
-Elastic License 2.0
-
-URL: https://www.elastic.co/licensing/elastic-license
-
-## Acceptance
-
-By using the software, you agree to all of the terms and conditions below.
-
-## Copyright License
-
-The licensor grants you a non-exclusive, royalty-free, worldwide,
-non-sublicensable, non-transferable license to use, copy, distribute, make
-available, and prepare derivative works of the software, in each case subject to
-the limitations and conditions below.
-
-## Limitations
-
-You may not provide the software to third parties as a hosted or managed
-service, where the service provides users with access to any substantial set of
-the features or functionality of the software.
-
-You may not move, change, disable, or circumvent the license key functionality
-in the software, and you may not remove or obscure any functionality in the
-software that is protected by the license key.
-
-You may not alter, remove, or obscure any licensing, copyright, or other notices
-of the licensor in the software. Any use of the licensor’s trademarks is subject
-to applicable law.
-
-## Patents
-
-The licensor grants you a license, under any patent claims the licensor can
-license, or becomes able to license, to make, have made, use, sell, offer for
-sale, import and have imported the software, in each case subject to the
-limitations and conditions in this license. This license does not cover any
-patent claims that you cause to be infringed by modifications or additions to
-the software. If you or your company make any written claim that the software
-infringes or contributes to infringement of any patent, your patent license for
-the software granted under these terms ends immediately. If your company makes
-such a claim, your patent license ends immediately for work on behalf of your
-company.
-
-## Notices
-
-You must ensure that anyone who gets a copy of any part of the software from you
-also gets a copy of these terms.
-
-If you modify the software, you must include in any modified copies of the
-software prominent notices stating that you have modified the software.
-
-## No Other Rights
-
-These terms do not imply any licenses other than those expressly granted in
-these terms.
-
-## Termination
-
-If you use the software in violation of these terms, such use is not licensed,
-and your licenses will automatically terminate. If the licensor provides you
-with a notice of your violation, and you cease all violation of this license no
-later than 30 days after you receive that notice, your licenses will be
-reinstated retroactively. However, if you violate these terms after such
-reinstatement, any additional violation of these terms will cause your licenses
-to terminate automatically and permanently.
-
-## No Liability
-
-*As far as the law allows, the software comes as is, without any warranty or
-condition, and the licensor will not be liable to you for any damages arising
-out of these terms or the use or nature of the software, under any kind of
-legal claim.*
-
-## Definitions
-
-The **licensor** is the entity offering these terms, and the **software** is the
-software the licensor makes available under these terms, including any portion
-of it.
-
-**you** refers to the individual or entity agreeing to these terms.
-
-**your company** is any legal entity, sole proprietorship, or other kind of
-organization that you work for, plus all organizations that have control over,
-are under the control of, or are under common control with that
-organization. **control** means ownership of substantially all the assets of an
-entity, or the power to direct its management and policies by vote, contract, or
-otherwise. Control can be direct or indirect.
-
-**your licenses** are all the licenses granted to you for the software under
-these terms.
-
-**use** means anything you do with the software requiring one of your licenses.
-
-**trademark** means trademarks, service marks, and similar rights.
+MIT License
+
+Copyright (c) 2026 Alvera
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -175,4 +175,4 @@ It writes an idempotent managed block; re-running replaces only that block.
 
 ## License
 
-Elastic-2.0
+MIT — see [LICENSE](./LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alvera-ai/platform-sdk",
-  "version": "0.12.1-next.f7f8a3c",
+  "version": "0.12.1-next.g069328b",
   "description": "Typed SDK for the Alvera platform API — manage data sources, tools, generic tables, AI agents, and action status updaters.",
   "type": "module",
   "sideEffects": false,
@@ -61,7 +61,7 @@
     "api",
     "typescript"
   ],
-  "license": "Elastic-2.0",
+  "license": "MIT",
   "author": "Alvera",
   "repository": {
     "type": "git",