@botiverse/raft-sdk 0.11.1 → 0.12.1

package/README.md

@@ -204,8 +204,7 @@ and a repeat there creates the tasks (or posts the card) again.
 - `raft.mentions.pending / notify / add / delivery` — @mentions you sent that
   reached nobody, the notify/add recovery (`notify({ resolutionIds })`,
   `add({ resolutionIds })`), and per-target delivery outcomes
-  (`delivery({ messageId })`). `execute` and `deliveries` are deprecated
-  aliases, removed in 0.12.0.
+  (`delivery({ messageId })`).
 - `raft.manual.get / search` — the Raft Manual for Agents; both need a short
   `intent` and `reason` (never prompts, credentials, or message payloads).
 - `raft.wake.webhook.register({ url, secret })` / `status()` / `unregister()`.

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,
@@ -14823,11 +14840,6 @@ function formatAgentSenderMentionDeliveries(messageId, deliveries) {
 //#region ../shared/src/agentOps/mentions.ts
 const pendingMentionActionsRequestSchema = requestSchema()(object({ limit: number$1().int().positive().optional().describe("Maximum pending mentions to list.") }));
 const mentionResolutionIdsRequestSchema = requestSchema()(object({ resolutionIds: array(string()).describe("resolutionId values from mentions.pending.") }));
-/** @deprecated The request of the deprecated `mentions.execute`; use `mentionResolutionIdsRequestSchema` (`mentions.notify` / `mentions.add`). */
-const executeMentionActionRequestSchema = requestSchema()(object({
-	action: _enum(["notify", "add"]).describe("notify: tell the mentioned target about the message; add: add them to the conversation."),
-	resolutionIds: array(string()).describe("resolutionId values from mentions.pending.")
-}));
 const senderMentionDeliveriesRequestSchema = requestSchema()(object({ messageId: string().describe("Id of a message you sent.") }));
 async function pendingMentionActions(client, request = {}, options = {}) {
 	const invalid = validateOpRequest(pendingMentionActionsRequestSchema, request);
@@ -14870,17 +14882,9 @@ async function addMentions(client, request) {
 	if (invalid) return invalid;
 	return runMentionAction(client, "add", request.resolutionIds);
 }
-/** @deprecated Backs the deprecated `mentions.execute`; use `notifyMentions` / `addMentions`. */
-async function executeMentionAction(client, request) {
-	const invalid = validateOpRequest(executeMentionActionRequestSchema, request);
-	if (invalid) return invalid;
-	const missing = "Pass an action (notify | add) and at least one resolution id.";
-	if (request.action !== "notify" && request.action !== "add") return failureOutcome(opError("INVALID_REQUEST", { message: missing }));
-	return runMentionAction(client, request.action, request.resolutionIds, missing);
-}
-async function runMentionAction(client, action, resolutionIds, missingIdsMessage = "Pass at least one resolution id.") {
+async function runMentionAction(client, action, resolutionIds) {
 	const ids = (resolutionIds ?? []).map((id) => id.trim()).filter(Boolean);
-	if (ids.length === 0) return failureOutcome(opError("INVALID_REQUEST", { message: missingIdsMessage }));
+	if (ids.length === 0) return failureOutcome(opError("INVALID_REQUEST", { message: "Pass at least one resolution id." }));
 	const result = await client.mentions.executeAction({
 		action,
 		resolutionIds: ids
@@ -15690,24 +15694,6 @@ const OPERATION_DEFS = [
 		consumes: nothing,
 		output: small
 	},
-	{
-		name: "mentions.execute",
-		description: "Deprecated: use mentions.notify / mentions.add. Removed in the next minor release. Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.",
-		schema: executeMentionActionRequestSchema,
-		routes: ["mentionActionsExecute"],
-		consumes: nothing,
-		output: small,
-		deprecated: true
-	},
-	{
-		name: "mentions.deliveries",
-		description: "Deprecated: use mentions.delivery. Removed in the next minor release. Whether each @mention in a message you sent reached its target.",
-		schema: senderMentionDeliveriesRequestSchema,
-		routes: ["senderMentionDeliveries"],
-		consumes: nothing,
-		output: small,
-		deprecated: true
-	},
 	{
 		name: "actions.prepare",
 		description: "Post an action card (create a channel, add members, create an agent, or an integration step) for a human to confirm; the human who clicks it carries it out as themselves. When it is executed (or fails), the outcome arrives as a reply that @mentions you in the card's thread (or in the thread the card was posted in).",
@@ -16181,9 +16167,7 @@ function createRaft(options) {
 			pending: (request) => pendingMentionActions(api, request, style).then(styled),
 			notify: (request) => notifyMentions(api, request).then(styled),
 			add: (request) => addMentions(api, request).then(styled),
-			delivery: (request) => senderMentionDeliveries(api, request).then(styled),
-			execute: (request) => executeMentionAction(api, request).then(styled),
-			deliveries: (request) => senderMentionDeliveries(api, request).then(styled)
+			delivery: (request) => senderMentionDeliveries(api, request).then(styled)
 		},
 		actions: { prepare: (request) => prepareActionCard(api, request, style).then(styled) },
 		manual: {
@@ -16275,8 +16259,6 @@ function createRaft(options) {
 		"mentions.notify": (args) => raft.mentions.notify(args),
 		"mentions.add": (args) => raft.mentions.add(args),
 		"mentions.delivery": (args) => raft.mentions.delivery(args),
-		"mentions.execute": (args) => raft.mentions.execute(args),
-		"mentions.deliveries": (args) => raft.mentions.deliveries(args),
 		"actions.prepare": (args) => raft.actions.prepare(args),
 		"manual.get": (args) => raft.manual.get(args),
 		"manual.search": (args) => raft.manual.search(args),
@@ -16378,7 +16360,6 @@ exports.createTasksRequestSchema = createTasksRequestSchema;
 exports.describeRaftRoute = describeRaftRoute;
 exports.downloadAttachmentUrlRequestSchema = downloadAttachmentUrlRequestSchema;
 exports.drainInboxRequestSchema = drainInboxRequestSchema;
-exports.executeMentionActionRequestSchema = executeMentionActionRequestSchema;
 exports.getManualTopicRequestSchema = getManualTopicRequestSchema;
 exports.hasAgentMessageIdentity = hasAgentMessageIdentity;
 exports.hashRaftSendContent = hashRaftSendContent;

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,
@@ -14822,11 +14839,6 @@ function formatAgentSenderMentionDeliveries(messageId, deliveries) {
 //#region ../shared/src/agentOps/mentions.ts
 const pendingMentionActionsRequestSchema = requestSchema()(object({ limit: number$1().int().positive().optional().describe("Maximum pending mentions to list.") }));
 const mentionResolutionIdsRequestSchema = requestSchema()(object({ resolutionIds: array(string()).describe("resolutionId values from mentions.pending.") }));
-/** @deprecated The request of the deprecated `mentions.execute`; use `mentionResolutionIdsRequestSchema` (`mentions.notify` / `mentions.add`). */
-const executeMentionActionRequestSchema = requestSchema()(object({
-	action: _enum(["notify", "add"]).describe("notify: tell the mentioned target about the message; add: add them to the conversation."),
-	resolutionIds: array(string()).describe("resolutionId values from mentions.pending.")
-}));
 const senderMentionDeliveriesRequestSchema = requestSchema()(object({ messageId: string().describe("Id of a message you sent.") }));
 async function pendingMentionActions(client, request = {}, options = {}) {
 	const invalid = validateOpRequest(pendingMentionActionsRequestSchema, request);
@@ -14869,17 +14881,9 @@ async function addMentions(client, request) {
 	if (invalid) return invalid;
 	return runMentionAction(client, "add", request.resolutionIds);
 }
-/** @deprecated Backs the deprecated `mentions.execute`; use `notifyMentions` / `addMentions`. */
-async function executeMentionAction(client, request) {
-	const invalid = validateOpRequest(executeMentionActionRequestSchema, request);
-	if (invalid) return invalid;
-	const missing = "Pass an action (notify | add) and at least one resolution id.";
-	if (request.action !== "notify" && request.action !== "add") return failureOutcome(opError("INVALID_REQUEST", { message: missing }));
-	return runMentionAction(client, request.action, request.resolutionIds, missing);
-}
-async function runMentionAction(client, action, resolutionIds, missingIdsMessage = "Pass at least one resolution id.") {
+async function runMentionAction(client, action, resolutionIds) {
 	const ids = (resolutionIds ?? []).map((id) => id.trim()).filter(Boolean);
-	if (ids.length === 0) return failureOutcome(opError("INVALID_REQUEST", { message: missingIdsMessage }));
+	if (ids.length === 0) return failureOutcome(opError("INVALID_REQUEST", { message: "Pass at least one resolution id." }));
 	const result = await client.mentions.executeAction({
 		action,
 		resolutionIds: ids
@@ -15689,24 +15693,6 @@ const OPERATION_DEFS = [
 		consumes: nothing,
 		output: small
 	},
-	{
-		name: "mentions.execute",
-		description: "Deprecated: use mentions.notify / mentions.add. Removed in the next minor release. Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.",
-		schema: executeMentionActionRequestSchema,
-		routes: ["mentionActionsExecute"],
-		consumes: nothing,
-		output: small,
-		deprecated: true
-	},
-	{
-		name: "mentions.deliveries",
-		description: "Deprecated: use mentions.delivery. Removed in the next minor release. Whether each @mention in a message you sent reached its target.",
-		schema: senderMentionDeliveriesRequestSchema,
-		routes: ["senderMentionDeliveries"],
-		consumes: nothing,
-		output: small,
-		deprecated: true
-	},
 	{
 		name: "actions.prepare",
 		description: "Post an action card (create a channel, add members, create an agent, or an integration step) for a human to confirm; the human who clicks it carries it out as themselves. When it is executed (or fails), the outcome arrives as a reply that @mentions you in the card's thread (or in the thread the card was posted in).",
@@ -16180,9 +16166,7 @@ function createRaft(options) {
 			pending: (request) => pendingMentionActions(api, request, style).then(styled),
 			notify: (request) => notifyMentions(api, request).then(styled),
 			add: (request) => addMentions(api, request).then(styled),
-			delivery: (request) => senderMentionDeliveries(api, request).then(styled),
-			execute: (request) => executeMentionAction(api, request).then(styled),
-			deliveries: (request) => senderMentionDeliveries(api, request).then(styled)
+			delivery: (request) => senderMentionDeliveries(api, request).then(styled)
 		},
 		actions: { prepare: (request) => prepareActionCard(api, request, style).then(styled) },
 		manual: {
@@ -16274,8 +16258,6 @@ function createRaft(options) {
 		"mentions.notify": (args) => raft.mentions.notify(args),
 		"mentions.add": (args) => raft.mentions.add(args),
 		"mentions.delivery": (args) => raft.mentions.delivery(args),
-		"mentions.execute": (args) => raft.mentions.execute(args),
-		"mentions.deliveries": (args) => raft.mentions.deliveries(args),
 		"actions.prepare": (args) => raft.actions.prepare(args),
 		"manual.get": (args) => raft.manual.get(args),
 		"manual.search": (args) => raft.manual.search(args),
@@ -16344,4 +16326,4 @@ function whoamiOutcome(result) {
 	};
 }
 //#endregion
-export { RAFT_INBOX_NOTICE_SCHEMA, RAFT_JSON_SCHEMA_KEYWORDS, RAFT_NOTICE_DELIVERY_ID_HEADER, RAFT_NOTICE_SIGNATURE_HEADER, RAFT_OPERATIONS, RAFT_OPERATIONS_SCHEMA, RAFT_OPERATIONS_VERSION, RAFT_STATE_CONTINUATIONS_PER_TARGET, RAFT_STATE_CONTINUATIONS_TOTAL, RAFT_STATE_SCHEMA, RaftCredentialError, RaftSdkConfigurationError, SeenFrontier, amendTaskRequestSchema, assignTaskRequestSchema, attachmentCommentsRequestSchema, bootstrapRaftCredential, channelInfoRequestSchema, channelMembersRequestSchema, channelTargetRequestSchema, checkInboxRequestSchema, claimTasksRequestSchema, commitInboxRequestSchema, convertMessageToTaskRequestSchema, createFileCredentialStore, createRaft, createRaftClient, createRaftClientFromStore, createRaftRoutes, createTasksRequestSchema, describeRaftRoute, downloadAttachmentUrlRequestSchema, drainInboxRequestSchema, executeMentionActionRequestSchema, getManualTopicRequestSchema, hasAgentMessageIdentity, hashRaftSendContent, inferAttachmentMimeType, isInterrupted, joinRaftChannelByTarget, listInboxRequestSchema, listRaftRoutes, listTasksRequestSchema, listThreadsRequestSchema, mentionResolutionIdsRequestSchema, parseRaftRegularChannelTarget, parseRaftState, pendingMentionActionsRequestSchema, prepareActionCardRequestSchema, projectRaftMessage, projectRaftMessages, raftToolNameFor, reactRequestSchema, readHistoryRequestSchema, readLatestReadThread, replyToRequestSchema, resolveMessageRequestSchema, searchManualRequestSchema, searchMessagesRequestSchema, sendMessageRequestSchema, senderMentionDeliveriesRequestSchema, serverInfoRequestSchema, showProfileRequestSchema, taskRefSchema, unfollowThreadRequestSchema, updateProfileRequestSchema, updateTaskStatusRequestSchema, userInfoRequestSchema, verifyInboxNotice, whoamiRequestSchema };
+export { RAFT_INBOX_NOTICE_SCHEMA, RAFT_JSON_SCHEMA_KEYWORDS, RAFT_NOTICE_DELIVERY_ID_HEADER, RAFT_NOTICE_SIGNATURE_HEADER, RAFT_OPERATIONS, RAFT_OPERATIONS_SCHEMA, RAFT_OPERATIONS_VERSION, RAFT_STATE_CONTINUATIONS_PER_TARGET, RAFT_STATE_CONTINUATIONS_TOTAL, RAFT_STATE_SCHEMA, RaftCredentialError, RaftSdkConfigurationError, SeenFrontier, amendTaskRequestSchema, assignTaskRequestSchema, attachmentCommentsRequestSchema, bootstrapRaftCredential, channelInfoRequestSchema, channelMembersRequestSchema, channelTargetRequestSchema, checkInboxRequestSchema, claimTasksRequestSchema, commitInboxRequestSchema, convertMessageToTaskRequestSchema, createFileCredentialStore, createRaft, createRaftClient, createRaftClientFromStore, createRaftRoutes, createTasksRequestSchema, describeRaftRoute, downloadAttachmentUrlRequestSchema, drainInboxRequestSchema, getManualTopicRequestSchema, hasAgentMessageIdentity, hashRaftSendContent, inferAttachmentMimeType, isInterrupted, joinRaftChannelByTarget, listInboxRequestSchema, listRaftRoutes, listTasksRequestSchema, listThreadsRequestSchema, mentionResolutionIdsRequestSchema, parseRaftRegularChannelTarget, parseRaftState, pendingMentionActionsRequestSchema, prepareActionCardRequestSchema, projectRaftMessage, projectRaftMessages, raftToolNameFor, reactRequestSchema, readHistoryRequestSchema, readLatestReadThread, replyToRequestSchema, resolveMessageRequestSchema, searchManualRequestSchema, searchMessagesRequestSchema, sendMessageRequestSchema, senderMentionDeliveriesRequestSchema, serverInfoRequestSchema, showProfileRequestSchema, taskRefSchema, unfollowThreadRequestSchema, updateProfileRequestSchema, updateTaskStatusRequestSchema, userInfoRequestSchema, verifyInboxNotice, whoamiRequestSchema };

package/dist/index.d.ts

@@ -1298,14 +1298,6 @@ export declare const pendingMentionActionsRequestSchema: z.ZodObject<{
 export declare const mentionResolutionIdsRequestSchema: z.ZodObject<{
   resolutionIds: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
-/** @deprecated The request of the deprecated `mentions.execute`; use `mentionResolutionIdsRequestSchema` (`mentions.notify` / `mentions.add`). */
-export declare const executeMentionActionRequestSchema: z.ZodObject<{
-  action: z.ZodEnum<{
-    notify: "notify";
-    add: "add";
-  }>;
-  resolutionIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
 export declare const senderMentionDeliveriesRequestSchema: z.ZodObject<{
   messageId: z.ZodString;
 }, z.core.$strip>;
@@ -1322,11 +1314,6 @@ type RaftMentionActionOutcome = RaftOutcome<{
   action: AgentMentionActionKind;
   results: AgentMentionActionResult[];
 }, "executed">;
-/** @deprecated The request of the deprecated `mentions.execute`; use `MentionResolutionIdsRequest`. */
-interface ExecuteMentionActionRequest {
-  action: AgentMentionActionKind;
-  resolutionIds: string[];
-}
 //#endregion
 //#region ../shared/src/agentOps/manual.d.ts
 interface ManualContext {
@@ -10110,42 +10097,6 @@ declare const OPERATION_DEFS: readonly [{
     mayBeLarge: false;
     boundBy: never[];
   };
-}, {
-  readonly name: "mentions.execute";
-  readonly description: "Deprecated: use mentions.notify / mentions.add. Removed in the next minor release. Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.";
-  readonly schema: z.ZodObject<{
-    action: z.ZodEnum<{
-      notify: "notify";
-      add: "add";
-    }>;
-    resolutionIds: z.ZodArray<z.ZodString>;
-  }, z.core.$strip>;
-  readonly routes: readonly ["mentionActionsExecute"];
-  readonly consumes: {
-    model: never[];
-    code: never[];
-  };
-  readonly output: {
-    mayBeLarge: false;
-    boundBy: never[];
-  };
-  readonly deprecated: true;
-}, {
-  readonly name: "mentions.deliveries";
-  readonly description: "Deprecated: use mentions.delivery. Removed in the next minor release. Whether each @mention in a message you sent reached its target.";
-  readonly schema: z.ZodObject<{
-    messageId: z.ZodString;
-  }, z.core.$strip>;
-  readonly routes: readonly ["senderMentionDeliveries"];
-  readonly consumes: {
-    model: never[];
-    code: never[];
-  };
-  readonly output: {
-    mayBeLarge: false;
-    boundBy: never[];
-  };
-  readonly deprecated: true;
 }, {
   readonly name: "actions.prepare";
   readonly description: "Post an action card (create a channel, add members, create an agent, or an integration step) for a human to confirm; the human who clicks it carries it out as themselves. When it is executed (or fails), the outcome arrives as a reply that @mentions you in the card's thread (or in the thread the card was posted in).";
@@ -10890,12 +10841,6 @@ interface Raft {
     delivery(request: {
       messageId: string;
     }): Promise<RaftOutcome<AgentApiSenderMentionDeliveriesResponse, "deliveries" | "empty">>;
-    /** @deprecated Use `mentions.notify` / `mentions.add`; removed in 0.12.0. */
-    execute(request: ExecuteMentionActionRequest): Promise<RaftMentionActionOutcome>;
-    /** @deprecated Use `mentions.delivery`; removed in 0.12.0. */
-    deliveries(request: {
-      messageId: string;
-    }): Promise<RaftOutcome<AgentApiSenderMentionDeliveriesResponse, "deliveries" | "empty">>;
   };
   actions: {
     /**
@@ -11030,4 +10975,4 @@ export declare const commitInboxRequestSchema: z.ZodObject<{
   cursor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 //#endregion
-export type { AmendTaskOutcome, AmendTaskRequest, AssignTaskRequest, BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, ConvertMessageToTaskRequest, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, CreateTasksRequest, DrainInboxRequest, ExecuteMentionActionRequest, ListInboxRequest, ListTasksRequest, ManualContext, MentionResolutionIdsRequest, PrepareActionCardRequest, Raft, RaftAckMode, RaftActionPrepareRequest, RaftActionPrepared, RaftApiError, RaftApiResult, RaftAppConfig, RaftAppConfigPatch, RaftAttachmentBytes, RaftAttachmentDownloadUrl, RaftAttachmentUploaded, RaftAvatarUpload, RaftChannelInfo, RaftChannelJoinClient, RaftChannelJoinClientResult, RaftChannelJoinError, RaftChannelJoinFailure, RaftChannelJoinOperation, RaftChannelJoinRequest, RaftChannelJoinResult, RaftChannelJoinSuccess, RaftChannelJoinTransportError, RaftChannelMuteState, RaftChannelRef, RaftClaimResult, RaftClaimRow, RaftClaimRowState, RaftClient, RaftClientError, RaftClientFailure, RaftClientResult, RaftClientSuccess, RaftClientThrottleOptions, RaftClientTransportRequest, RaftConsumption, RaftContextAgent, RaftContextData, RaftContextError, RaftContextResult, RaftContextServer, RaftCredentialErrorCode, RaftCredentialIdentity, RaftCredentialStore, RaftEvent, RaftEventAttachment, RaftEventExternalMessage, RaftEventsReceiveData, RaftEventsReceiveError, RaftEventsReceiveRequest, RaftEventsReceiveResult, RaftFailure, RaftHintStyle, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxDrained, RaftInboxListing, RaftInboxNotice, RaftInterrupt, RaftInterruptCancel, RaftInterruptReason, RaftInterruptResume, RaftInterrupted, RaftInvokeCaller, RaftInvokeResult, RaftJsonSchema, RaftJsonSchemaType, RaftLatestReadThread, RaftManageClient, RaftMentionActionOutcome, RaftMessage, RaftMessageAttachment, RaftMessageTask, RaftNextOperation, RaftNextStep, RaftNoticeFlag, RaftNoticeTarget, RaftOpError, RaftOpErrorCode, RaftOperationIdempotency, RaftOperationName, RaftOperationSpec, RaftOperationsDocument, RaftOutcome, RaftPendingMentions, RaftPreparedCard, RaftProfile, RaftProfileUpdate, RaftRouteAnnotations, RaftRouteInfo, RaftRouteKey, RaftRouteMeta, RaftRouteResult, RaftRouteRetryPolicy, RaftRoutes, RaftSdkConfigurationErrorCode, RaftSearchPage, RaftSenderType, RaftSent, RaftServerInfo, RaftServerProfile, RaftServerUpdate, RaftState, RaftStateContinuation, RaftStateSaveErrorHandler, RaftStateStore, RaftTaskBoard, RaftTaskStatus, RaftTasksCreated, RaftUserInfo, RaftUserRef, RaftWebhookStatus, ReactRequest, ReadHistoryRequest, ReadLatestReadThreadOptions, ReplyToRequest, SearchMessagesRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, ServerInfoRequest, ServerInfoSection, StoredRaftCredential, TaskRef, UpdateTaskStatusOutcome, UpdateTaskStatusRequest, UploadAttachmentRequest, UserInfoRequest, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };
+export type { AmendTaskOutcome, AmendTaskRequest, AssignTaskRequest, BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, ConvertMessageToTaskRequest, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, CreateTasksRequest, DrainInboxRequest, ListInboxRequest, ListTasksRequest, ManualContext, MentionResolutionIdsRequest, PrepareActionCardRequest, Raft, RaftAckMode, RaftActionPrepareRequest, RaftActionPrepared, RaftApiError, RaftApiResult, RaftAppConfig, RaftAppConfigPatch, RaftAttachmentBytes, RaftAttachmentDownloadUrl, RaftAttachmentUploaded, RaftAvatarUpload, RaftChannelInfo, RaftChannelJoinClient, RaftChannelJoinClientResult, RaftChannelJoinError, RaftChannelJoinFailure, RaftChannelJoinOperation, RaftChannelJoinRequest, RaftChannelJoinResult, RaftChannelJoinSuccess, RaftChannelJoinTransportError, RaftChannelMuteState, RaftChannelRef, RaftClaimResult, RaftClaimRow, RaftClaimRowState, RaftClient, RaftClientError, RaftClientFailure, RaftClientResult, RaftClientSuccess, RaftClientThrottleOptions, RaftClientTransportRequest, RaftConsumption, RaftContextAgent, RaftContextData, RaftContextError, RaftContextResult, RaftContextServer, RaftCredentialErrorCode, RaftCredentialIdentity, RaftCredentialStore, RaftEvent, RaftEventAttachment, RaftEventExternalMessage, RaftEventsReceiveData, RaftEventsReceiveError, RaftEventsReceiveRequest, RaftEventsReceiveResult, RaftFailure, RaftHintStyle, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxDrained, RaftInboxListing, RaftInboxNotice, RaftInterrupt, RaftInterruptCancel, RaftInterruptReason, RaftInterruptResume, RaftInterrupted, RaftInvokeCaller, RaftInvokeResult, RaftJsonSchema, RaftJsonSchemaType, RaftLatestReadThread, RaftManageClient, RaftMentionActionOutcome, RaftMessage, RaftMessageAttachment, RaftMessageTask, RaftNextOperation, RaftNextStep, RaftNoticeFlag, RaftNoticeTarget, RaftOpError, RaftOpErrorCode, RaftOperationIdempotency, RaftOperationName, RaftOperationSpec, RaftOperationsDocument, RaftOutcome, RaftPendingMentions, RaftPreparedCard, RaftProfile, RaftProfileUpdate, RaftRouteAnnotations, RaftRouteInfo, RaftRouteKey, RaftRouteMeta, RaftRouteResult, RaftRouteRetryPolicy, RaftRoutes, RaftSdkConfigurationErrorCode, RaftSearchPage, RaftSenderType, RaftSent, RaftServerInfo, RaftServerProfile, RaftServerUpdate, RaftState, RaftStateContinuation, RaftStateSaveErrorHandler, RaftStateStore, RaftTaskBoard, RaftTaskStatus, RaftTasksCreated, RaftUserInfo, RaftUserRef, RaftWebhookStatus, ReactRequest, ReadHistoryRequest, ReadLatestReadThreadOptions, ReplyToRequest, SearchMessagesRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, ServerInfoRequest, ServerInfoSection, StoredRaftCredential, TaskRef, UpdateTaskStatusOutcome, UpdateTaskStatusRequest, UploadAttachmentRequest, UserInfoRequest, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };

package/operations.json

@@ -1,6 +1,6 @@
 {
   "schema": "raft-sdk-operations.v1",
-  "version": "2a304e867c59570a",
+  "version": "24580df5e6c5b3bc",
   "operations": [
     {
       "name": "identity.whoami",
@@ -837,88 +837,6 @@
         "boundBy": []
       }
     },
-    {
-      "name": "mentions.execute",
-      "toolName": "mentions_execute",
-      "description": "Deprecated: use mentions.notify / mentions.add. Removed in the next minor release. Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.",
-      "inputSchema": {
-        "type": "object",
-        "properties": {
-          "action": {
-            "type": "string",
-            "description": "notify: tell the mentioned target about the message; add: add them to the conversation.",
-            "enum": [
-              "notify",
-              "add"
-            ]
-          },
-          "resolutionIds": {
-            "type": "array",
-            "description": "resolutionId values from mentions.pending.",
-            "items": {
-              "type": "string"
-            }
-          }
-        },
-        "required": [
-          "action",
-          "resolutionIds"
-        ]
-      },
-      "sideEffect": "write",
-      "idempotency": {
-        "kind": "none"
-      },
-      "capability": [
-        "mentions"
-      ],
-      "modelOnly": false,
-      "mayInterrupt": false,
-      "consumes": {
-        "model": [],
-        "code": []
-      },
-      "output": {
-        "mayBeLarge": false,
-        "boundBy": []
-      },
-      "deprecated": true
-    },
-    {
-      "name": "mentions.deliveries",
-      "toolName": "mentions_deliveries",
-      "description": "Deprecated: use mentions.delivery. Removed in the next minor release. Whether each @mention in a message you sent reached its target.",
-      "inputSchema": {
-        "type": "object",
-        "properties": {
-          "messageId": {
-            "type": "string",
-            "description": "Id of a message you sent."
-          }
-        },
-        "required": [
-          "messageId"
-        ]
-      },
-      "sideEffect": "read",
-      "idempotency": {
-        "kind": "natural"
-      },
-      "capability": [
-        "mentions"
-      ],
-      "modelOnly": false,
-      "mayInterrupt": false,
-      "consumes": {
-        "model": [],
-        "code": []
-      },
-      "output": {
-        "mayBeLarge": false,
-        "boundBy": []
-      },
-      "deprecated": true
-    },
     {
       "name": "actions.prepare",
       "toolName": "actions_prepare",

package/package.json

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