@naturali/sdk 0.162.0 → 0.162.2

package/dist/index.cjs

@@ -1198,7 +1198,7 @@ var Agents = class {
 	/**
 	* Delete an agent
 	*
-	* Deletes an agent by ID. Fails with `409` if the agent has dependent generations or traces, unless `force=true` is passed, in which case those generations and traces are deleted along with the agent.
+	* Deletes an agent by ID. Fails with `409` if the agent has dependent generations or traces, or another project has accepted a share of it, unless `force=true` is passed, in which case those generations and traces are deleted along with the agent and the shares are revoked. Every share of the agent is revoked when it is deleted.
 	*
 	*/
 	static deleteAgent(options) {
@@ -1210,7 +1210,8 @@ var Agents = class {
 	/**
 	* Get an agent
 	*
-	* Returns a single agent by ID.
+	* Returns a single agent by ID. A credential scoped to a project the agent is shared with, through an accepted share, reads its `id` and `name` only.
+	*
 	*/
 	static getAgent(options) {
 		return (options.client ?? client).get({
@@ -1253,6 +1254,8 @@ var Agents = class {
 	*
 	* Sends messages to the agent, resolves its tools, and runs the AI model loop. Background by default: returns `202 Accepted` with a `generation_id` to poll via `GET /v1/projects/{project_id}/generations/{generation_id}`. Pass `?wait=true` to block and receive the result inline, where client tools pause the generation and return `requires_action`. Streaming (`stream: true`) implies waiting. Pass `idempotency_key` to make a retry safe: a request whose key is already claimed runs nothing and answers `202` with the generation the key names.
 	*
+	* A credential scoped to a project the agent is shared with, through an accepted share, runs it in that project: on the publisher's configuration, recorded, metered and governed in the grantee project.
+	*
 	*/
 	static createAgentGeneration(options) {
 		return (options.client ?? client).post({
@@ -4827,7 +4830,7 @@ var Tools = class {
 	/**
 	* Delete a tool
 	*
-	* Deletes a tool by ID. A tool that is a decider's backend is refused with `409 TOOL_HAS_DEPENDENTS`.
+	* Deletes a tool by ID. A tool that is a decider's backend is refused with `409 TOOL_HAS_DEPENDENTS`, and so is one another project has accepted a share of, or one of its own project's ingestion rules converts with, until `force=true`. Every share of the tool is revoked when it is deleted; an ingestion rule keeps its `tool_id` and fails the documents it matches with `CONVERTER_FAILED` until repointed.
 	*/
 	static deleteTool(options) {
 		return (options.client ?? client).delete({
@@ -4838,7 +4841,8 @@ var Tools = class {
 	/**
 	* Get a tool
 	*
-	* Returns a single tool by ID.
+	* Returns a single tool by ID. A credential scoped to a project the tool is shared with, through an accepted share, reads its `id`, `name`, `description` and `parameters` only.
+	*
 	*/
 	static getTool(options) {
 		return (options.client ?? client).get({
@@ -4869,6 +4873,8 @@ var Tools = class {
 	* `preset_parameters` stored on the tool are pinned over the caller-supplied `input` before execution: a key the tool presets keeps its preset value even when `input` sets it. Keys the presets do not name are taken from `input` as sent.
 	* Guardrails attached to the tool or to its project adjudicate the call before dispatch, composing project + tool scope. A call this route cannot await a decision on — class C (human sign-off), class D, or a class-B tripwire — is refused with `422 TOOL_DISPATCH_FAILED`, whose `meta` carries the `tool_id` and the `outcome`. A `pipeline` tool is adjudicated before its first step runs, and every step is adjudicated as the call of that tool it is.
 	*
+	* A credential scoped to a project the tool is shared with, through an accepted share, calls it in that project: the calling project's guardrails adjudicate it, it is metered there with `publisher_project_id`, and the tool receives the calling project as the `calling_project_id` tool context key.
+	*
 	*/
 	static callTool(options) {
 		return (options.client ?? client).post({