@botiverse/raft-sdk 0.12.0 → 0.12.1

package/dist/cjs/index.cjs

@@ -10967,23 +10967,40 @@ function failureOutcome(error) {
 		text: formatOpErrorText(error)
 	};
 }
+/** A next action written for the CLI: it names a `raft` command or a `--flag`. */
+const CLI_NEXT_ACTION_PATTERN = /\braft [a-z]|(^|[\s`'"(])--[a-z]/;
 /**
-* Render the SDK's own default next action in a hint style. Only NOT_FOUND's
-* default names a command; it is set deep in the shared client-error mapping,
-* so `createRaft({ hints: "tool" })` re-renders it here instead of threading
-* the style through every failure. A Server-sent next action is left as is.
+* The attachment routes answer one uniform 404 for missing, unreadable and
+* other-subsystem ids (no existence oracle); the Server's next action names
+* the Feedback Admin CLI command, which a tool-mode model cannot run.
+*/
+const ATTACHMENT_UNAVAILABLE_TOOL_NEXT_ACTION = "This id is not an attachment you can read. Use an attachment id from a message you can see.";
+/**
+* Render a failure's next action in a hint style. In "cli" style nothing
+* changes. In "tool" style no next action names a CLI command: the SDK's own
+* NOT_FOUND default (set deep in the shared client-error mapping) is
+* re-rendered as a tool call, `ATTACHMENT_UNAVAILABLE` gets a neutral step,
+* and any other Server-sent next action written for the CLI falls back to the
+* code's default.
 */
 function restyleDefaultNextAction(outcome, style) {
 	if (style === "cli" || !outcome || typeof outcome !== "object") return outcome;
 	const failure = outcome;
-	if (failure.ok !== false || !failure.error || failure.error.nextAction !== DEFAULT_NEXT_ACTION.NOT_FOUND) return outcome;
+	if (failure.ok !== false || !failure.error) return outcome;
+	const current = failure.error.nextAction;
+	let nextAction;
+	if (current === DEFAULT_NEXT_ACTION.NOT_FOUND) nextAction = notFoundNextAction(style);
+	else if (failure.error.serverCode === "ATTACHMENT_UNAVAILABLE") nextAction = ATTACHMENT_UNAVAILABLE_TOOL_NEXT_ACTION;
+	else if (CLI_NEXT_ACTION_PATTERN.test(current)) nextAction = failure.error.code === "NOT_FOUND" ? notFoundNextAction(style) : DEFAULT_NEXT_ACTION[failure.error.code];
+	else return outcome;
+	if (nextAction === current) return outcome;
 	const error = {
 		...failure.error,
-		nextAction: notFoundNextAction(style)
+		nextAction
 	};
-	const next = failure.next && failure.next.why === DEFAULT_NEXT_ACTION.NOT_FOUND ? {
+	const next = failure.next && failure.next.why === current ? {
 		...failure.next,
-		why: error.nextAction
+		why: nextAction
 	} : failure.next ?? null;
 	return {
 		...failure,

package/dist/esm/index.js

@@ -10966,23 +10966,40 @@ function failureOutcome(error) {
 		text: formatOpErrorText(error)
 	};
 }
+/** A next action written for the CLI: it names a `raft` command or a `--flag`. */
+const CLI_NEXT_ACTION_PATTERN = /\braft [a-z]|(^|[\s`'"(])--[a-z]/;
 /**
-* Render the SDK's own default next action in a hint style. Only NOT_FOUND's
-* default names a command; it is set deep in the shared client-error mapping,
-* so `createRaft({ hints: "tool" })` re-renders it here instead of threading
-* the style through every failure. A Server-sent next action is left as is.
+* The attachment routes answer one uniform 404 for missing, unreadable and
+* other-subsystem ids (no existence oracle); the Server's next action names
+* the Feedback Admin CLI command, which a tool-mode model cannot run.
+*/
+const ATTACHMENT_UNAVAILABLE_TOOL_NEXT_ACTION = "This id is not an attachment you can read. Use an attachment id from a message you can see.";
+/**
+* Render a failure's next action in a hint style. In "cli" style nothing
+* changes. In "tool" style no next action names a CLI command: the SDK's own
+* NOT_FOUND default (set deep in the shared client-error mapping) is
+* re-rendered as a tool call, `ATTACHMENT_UNAVAILABLE` gets a neutral step,
+* and any other Server-sent next action written for the CLI falls back to the
+* code's default.
 */
 function restyleDefaultNextAction(outcome, style) {
 	if (style === "cli" || !outcome || typeof outcome !== "object") return outcome;
 	const failure = outcome;
-	if (failure.ok !== false || !failure.error || failure.error.nextAction !== DEFAULT_NEXT_ACTION.NOT_FOUND) return outcome;
+	if (failure.ok !== false || !failure.error) return outcome;
+	const current = failure.error.nextAction;
+	let nextAction;
+	if (current === DEFAULT_NEXT_ACTION.NOT_FOUND) nextAction = notFoundNextAction(style);
+	else if (failure.error.serverCode === "ATTACHMENT_UNAVAILABLE") nextAction = ATTACHMENT_UNAVAILABLE_TOOL_NEXT_ACTION;
+	else if (CLI_NEXT_ACTION_PATTERN.test(current)) nextAction = failure.error.code === "NOT_FOUND" ? notFoundNextAction(style) : DEFAULT_NEXT_ACTION[failure.error.code];
+	else return outcome;
+	if (nextAction === current) return outcome;
 	const error = {
 		...failure.error,
-		nextAction: notFoundNextAction(style)
+		nextAction
 	};
-	const next = failure.next && failure.next.why === DEFAULT_NEXT_ACTION.NOT_FOUND ? {
+	const next = failure.next && failure.next.why === current ? {
 		...failure.next,
-		why: error.nextAction
+		why: nextAction
 	} : failure.next ?? null;
 	return {
 		...failure,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/raft-sdk",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "license": "FSL-1.1-ALv2",
   "description": "Typed Raft Agent API client for external agents and bots.",
   "type": "module",