@naturali/cli 0.45.0 → 0.46.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.45.0";
+var version = "0.46.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -1742,6 +1742,18 @@ var Sessions = class {
 		});
 	}
 	/**
+	* Read the session's transcript
+	*
+	* The session's messages, oldest first. naturali stores no message bodies — the dialogue lives in the backing runtime conversation the session maps to, so this reads through to the runtime. Pagination is `limit`/`offset` rather than an opaque cursor because the upstream is offset-based over a stable `position` ordering. This is the one way to read back a session opened directly through this API (no [Channels](/docs/modules/channels) conversation involved) — see `GET .../channels/{channel_id}/conversations/{conversation_id}/messages` for the channel-backed equivalent.
+	*
+	*/
+	static listSessionMessages(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/agents/{agent_id}/sessions/{session_id}/messages",
+			...options
+		});
+	}
+	/**
 	* Add a message
 	*
 	* Appends a user message to the session — plain `message` text or a `document_id`, exactly one of the two. `idempotency_key` makes the append safe to retry: a repeat with the same key returns the original message (HTTP 200) and triggers no new work. When the session has `auto_generate` on, the response is the agent's reply (a Generation shape) instead of the saved message.
@@ -1989,6 +2001,19 @@ var Traces = class {
 			...options
 		});
 	}
+	/**
+	* Get a trace's steps
+	*
+	* Returns the trace's step payload: every step of the execution's model loop, exactly as the runtime recorded it — tool calls, their arguments, results and cost — passed through unreshaped rather than mapped to a narrower contract, since the payload is the runtime's own step shape.
+	* Saving the payload is fire-and-forget on the runtime, so a trace can report `has_steps: false` for a short window after it finishes; this route 404s with `steps_not_available` during that window rather than returning an empty list, so a caller does not mistake "not saved yet" for "no steps ran".
+	*
+	*/
+	static getTraceSteps(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/traces/{trace_id}/steps",
+			...options
+		});
+	}
 };
 var Webhooks = class {
 	/**
@@ -5591,6 +5616,56 @@ const routes = {
 			}
 		]
 	},
+	"list-session-messages": {
+		serviceClass: "Sessions",
+		operationId: "listSessionMessages",
+		description: "The session's messages, oldest first. naturali stores no message bodies — the dialogue lives in the backing runtime conversation the session maps to, so this reads through to the runtime. Pagination is `limit`/`offset` rather than an opaque cursor because the upstream is offset-based over a stable `position` ordering. This is the one way to read back a session opened directly through this API (no [Channels](/docs/modules/channels) conversation involved) — see `GET .../channels/{channel_id}/conversations/{conversation_id}/messages` for the channel-backed equivalent.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/sessions",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"agent_id",
+			"session_id"
+		],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "agent_id",
+				"description": "Agent public ID (agent_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "session_id",
+				"description": "Session public ID (session_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum messages per page.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of messages to skip.",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
 	"add-session-message": {
 		serviceClass: "Sessions",
 		operationId: "addSessionMessage",
@@ -6364,6 +6439,28 @@ const routes = {
 			}
 		]
 	},
+	"get-trace-steps": {
+		serviceClass: "Traces",
+		operationId: "getTraceSteps",
+		description: "Returns the trace's step payload: every step of the execution's model loop, exactly as the runtime recorded it — tool calls, their arguments, results and cost — passed through unreshaped rather than mapped to a narrower contract, since the payload is the runtime's own step shape. Saving the payload is fire-and-forget on the runtime, so a trace can report `has_steps: false` for a short window after it finishes; this route 404s with `steps_not_available` during that window rather than returning an empty list, so a caller does not mistake \"not saved yet\" for \"no steps ran\".",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/traces",
+		httpMethod: "get",
+		pathParams: ["project_id", "trace_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "trace_id",
+			"description": "Trace public ID (trace_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-webhooks": {
 		serviceClass: "Webhooks",
 		operationId: "listWebhooks",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.45.0"
+    "@naturali/sdk": "0.46.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",