@botiverse/raft-sdk 0.3.0 → 1.0.0-alpha.1

package/dist/index.d.ts

@@ -444,8 +444,6 @@ export declare class SeenFrontier {
   private readonly targets;
   private readonly aliases;
   static fromSnapshot(snapshot: SeenFrontierSnapshot | null | undefined): SeenFrontier;
-  /** Merge a snapshot into this frontier by the same monotonic rules (never lowers a mark). */
-  absorb(snapshot: SeenFrontierSnapshot | null | undefined): void;
   /** Remember that the Server resolved `requested` to `canonical` (a thread spelling, a `~agent` suffix, …). */
   recordAlias(requested: string, canonical: string): void;
   canonical(target: string): string;
@@ -640,28 +638,6 @@ interface RaftHeld extends RaftHeldBase {
 }
 type SendMessageOutcome = RaftOutcome<RaftSent, "sent"> | RaftOutcome<RaftHeld, "held">;
 //#endregion
-//#region ../shared/src/agentText/tasks.d.ts
-interface AgentClaimConflict {
-  kind: "claim_conflict";
-  conflictScope: "implementation_execution";
-  blockedActions: string[];
-  unblockedActionExamples: string[];
-  currentAssignee: {
-    type: "user" | "agent";
-    name: string | null;
-  } | null;
-  taskStatus: string | null;
-  claimedAt: string | null;
-  observedAt: string;
-}
-interface AgentClaimResult {
-  taskNumber?: number;
-  messageId?: string;
-  success: boolean;
-  reason?: string;
-  conflict?: AgentClaimConflict;
-}
-//#endregion
 //#region ../shared/src/agentOps/tasks.d.ts
 interface ClaimTasksRequest {
   /** Channel target the tasks live in, for example `#proj-sdk`. */
@@ -684,8 +660,6 @@ interface RaftClaimRow {
     name: string | null;
   } | null;
   conflict: AgentApiTaskClaimResult["conflict"] | null;
-  /** The Server's row, as the CLI formatter reads it. */
-  raw: AgentClaimResult;
 }
 interface RaftClaimResult {
   target: string;
@@ -700,57 +674,6 @@ interface RaftClaimHeld extends Omit<RaftHeldBase, "idempotencyKey" | "continuat
   retry(): Promise<ClaimTasksOutcome>;
 }
 type ClaimTasksOutcome = RaftOutcome<RaftClaimResult, "claimed" | "partial" | "refused"> | RaftOutcome<RaftClaimHeld, "held">;
-type RaftTaskStatus = "todo" | "in_progress" | "in_review" | "done" | "closed";
-interface ListTasksRequest {
-  /** Channel board, for example `#proj-sdk`; omit with `mine: true` for your own tasks across channels. */
-  target?: string;
-  mine?: boolean;
-  status?: RaftTaskStatus | "all";
-}
-interface RaftTaskBoard {
-  scope: "channel" | "mine";
-  target: string | null;
-  tasks: AgentApiTaskListResponse["tasks"];
-  coverage: AgentApiTaskListResponse["coverage"] | null;
-}
-interface CreateTasksRequest {
-  target: string;
-  tasks: Array<{
-    title: string;
-    createsResource?: boolean;
-  }>;
-  /** `@handle`; yourself to start in_progress, or (owner/admin) someone else to reserve a todo. */
-  assignee?: string;
-}
-type RaftTasksCreated = AgentApiTaskCreateResponse & {
-  target: string;
-};
-interface TaskRef {
-  target: string;
-  taskNumber: number;
-}
-interface AssignTaskRequest extends TaskRef {
-  /** `@handle`, or null to clear the assignment. */
-  assignee: string | null;
-  /** Optimistic-concurrency token from a task you just read; lose rather than clobber. */
-  expectedRevision?: number;
-}
-interface UpdateTaskStatusRequest extends TaskRef {
-  status: RaftTaskStatus;
-}
-type UpdateTaskStatusOutcome = RaftOutcome<UpdateTaskStatusRequest, "updated"> | RaftOutcome<RaftClaimHeldLike<UpdateTaskStatusRequest>, "held">;
-/** A hold on a task write: the held context plus the request to repeat, as data. */
-type RaftClaimHeldLike<TRequest> = Omit<RaftHeldBase, "idempotencyKey" | "continuation"> & {
-  request: TRequest;
-};
-interface AmendTaskRequest extends TaskRef {
-  title?: string;
-  /** New description; `null` clears it. */
-  description?: string | null;
-}
-type AmendTaskOutcome = RaftOutcome<AgentApiTaskAmendSuccessResponse & {
-  target: string;
-}, "amended"> | RaftOutcome<RaftClaimHeldLike<AmendTaskRequest>, "held">;
 //#endregion
 //#region ../shared/src/agentOps/wake.d.ts
 export declare const RAFT_INBOX_NOTICE_SCHEMA: "raft-agent-inbox-notice.v1";
@@ -807,187 +730,6 @@ interface VerifyNoticeInput {
 export declare function verifyInboxNotice(input: VerifyNoticeInput): Promise<VerifyNoticeResult>;
 type RaftWebhookStatus = AgentApiPushWebhookStatusResponse;
 //#endregion
-//#region ../shared/src/agentOps/channels.d.ts
-interface RaftChannelRef {
-  target: string;
-  channelId: string;
-}
-interface RaftChannelMuteState extends RaftChannelRef {
-  activityMuted: boolean;
-  muteFromSeq: number | null;
-  stillArrives: string[];
-}
-//#endregion
-//#region ../shared/src/agentText/server.d.ts
-interface AgentPageInfo {
-  total: number;
-  offset: number;
-  limit: number;
-  nextCommand?: string;
-}
-//#endregion
-//#region ../shared/src/agentOps/server.d.ts
-type ServerInfoSection = "channels" | "agents" | "humans";
-interface ServerInfoRequest {
-  /** Omit for the compact summary; `full` for the whole overview; a section for a paged listing. */
-  view?: "summary" | "full" | ServerInfoSection;
-  offset?: number;
-  /** Default 50. */
-  limit?: number;
-  /** Channels only: restrict to joined channels. */
-  joined?: boolean;
-}
-interface RaftServerInfo {
-  view: NonNullable<ServerInfoRequest["view"]>;
-  server: AgentApiServerInfoResponse;
-  /** Present for a paged section. */
-  page: (AgentPageInfo & {
-    section: ServerInfoSection;
-  }) | null;
-}
-//#endregion
-//#region ../shared/src/agentOps/attachments.d.ts
-/** Explicit type wins; otherwise sniff the bytes, then the filename extension, then octet-stream. */
-export declare function inferAttachmentMimeType(filename: string, bytes: Uint8Array, explicit?: string | null): string;
-interface UploadAttachmentRequest {
-  /** Conversation the attachment will be used in: `#channel`, `dm:@peer`, or a thread target. */
-  target: string;
-  filename: string;
-  bytes: Uint8Array;
-  /** Explicit MIME type; inferred from the bytes and filename when omitted. */
-  mimeType?: string;
-}
-type RaftAttachmentUploaded = AgentApiAttachmentUploadResponse & {
-  target: string;
-  mimeType: string | null;
-};
-interface RaftAttachmentBytes {
-  attachmentId: string;
-  bytes: Uint8Array;
-}
-//#endregion
-//#region ../shared/src/agentOps/search.d.ts
-interface SearchMessagesRequest {
-  /** Free-text query; may be omitted when filtering by target or sender only. */
-  query?: string;
-  /** Restrict to a channel, DM, or thread target. */
-  target?: string;
-  /** Restrict to a sender handle. */
-  sender?: string;
-  sort?: "relevance" | "recent";
-  /** ISO timestamps, both inclusive server-side. */
-  before?: string;
-  after?: string;
-  /** 1..50; Server default 20. */
-  limit?: number;
-  offset?: number;
-}
-interface RaftSearchPage {
-  query: string;
-  results: AgentApiMessageSearchResponse["results"];
-  /** Server-reported; `null` when an older Server did not say. */
-  hasMore: boolean | null;
-}
-interface ReactRequest {
-  messageId: string;
-  emoji: string;
-}
-//#endregion
-//#region ../shared/src/agentText/mentions.d.ts
-type AgentMentionActionKind = "notify" | "add";
-interface AgentPendingMentionAction {
-  resolutionId: string;
-  messageId: string;
-  targetType: string;
-  targetHandle: string;
-  reason: string;
-  availableActions: string[];
-  expiresAt?: string | null;
-}
-type AgentMentionActionResultStatus = "queued" | "delivered" | "dropped" | "stale" | "expired" | "no_permission" | "not_found" | "ambiguous";
-interface AgentMentionActionResult {
-  resolutionId: string;
-  status: AgentMentionActionResultStatus;
-  action?: AgentMentionActionKind | null;
-  messageId?: string | null;
-  channelId?: string | null;
-  targetType?: string | null;
-  targetId?: string | null;
-  targetHandle?: string | null;
-  message?: string | null;
-  reason?: string | null;
-  dedupedResolutionIds?: string[];
-}
-//#endregion
-//#region ../shared/src/agentOps/mentions.d.ts
-interface RaftPendingMentions {
-  actions: AgentPendingMentionAction[];
-  /** Server-reported; `null` when it did not say (completeness not asserted). */
-  hasMore: boolean | null;
-  limit: number | undefined;
-}
-interface ExecuteMentionActionRequest {
-  action: AgentMentionActionKind;
-  resolutionIds: string[];
-}
-//#endregion
-//#region ../shared/src/agentOps/manual.d.ts
-interface ManualContext {
-  intent: string;
-  reason: string;
-}
-//#endregion
-//#region ../shared/src/agentOps/state.d.ts
-export declare const RAFT_STATE_SCHEMA: "raft-sdk-state.v1";
-interface RaftStateContinuation {
-  target: string;
-  idempotencyKey: string;
-  /** Hex SHA-256 of target, content and attachment ids; a resend with the same hash is the same logical message. */
-  contentHash: string;
-  /** ISO time the send was held. */
-  heldAt: string;
-}
-interface RaftState {
-  schema: typeof RAFT_STATE_SCHEMA;
-  /** Revision, incremented on every save by this SDK. Compare-and-set stores compare against it. */
-  version: number;
-  /** Last committed inbox cursor; the next pull passes it as `since`. */
-  cursor: number | null;
-  /** Cursor of the batch returned but not yet committed. */
-  pendingCursor: number | null;
-  frontier: SeenFrontierSnapshot;
-  continuations?: RaftStateContinuation[];
-}
-interface RaftStateStore {
-  load(): Promise<RaftState | null>;
-  /**
-   * Persist `state`. `expectedVersion` is the version this client loaded
-   * (`undefined` when the store was empty). Throw to reject a stale write;
-   * stores without compare-and-set may ignore it.
-   */
-  save(state: RaftState, options: {
-    expectedVersion: number | undefined;
-  }): Promise<void>;
-}
-type RaftStateSaveErrorHandler = (error: unknown, context: {
-  phase: "load" | "save";
-  version: number | undefined;
-}) => void;
-export declare const RAFT_STATE_CONTINUATIONS_PER_TARGET = 3;
-export declare const RAFT_STATE_CONTINUATIONS_TOTAL = 20;
-/** Validate a loaded value; anything unrecognised is treated as an empty store (safe: see file header). */
-export declare function parseRaftState(value: unknown): RaftState | null;
-/** Hex SHA-256 identifying one logical message (WebCrypto; Workers-safe). */
-export declare function hashRaftSendContent(target: string, content: string, attachmentIds?: readonly string[]): Promise<string>;
-//#endregion
-//#region ../shared/src/agentOps/actions.d.ts
-type PrepareActionCardRequest = AgentApiActionPrepareBody;
-interface RaftPreparedCard {
-  target: string;
-  /** The card message; a human commits it by clicking its action verb. */
-  messageId: string;
-}
-//#endregion
 //#region ../shared/src/agentApiRawClient.d.ts
 type AgentApiRawClientErrorReason = "missing_route" | "missing_path_param" | "request_contract_mismatch" | "transport_error" | "http_error" | "empty_response" | "response_contract_mismatch";
 interface AgentApiRawTransportRequest<K extends AgentApiRouteKey = AgentApiRouteKey> {
@@ -996,6 +738,25 @@ interface AgentApiRawTransportRequest<K extends AgentApiRouteKey = AgentApiRoute
   path: string;
   body?: unknown;
 }
+type AgentApiRawSuccess<K extends AgentApiRouteKey> = {
+  ok: true;
+  routeKey: K;
+  status: number;
+  data: AgentApiResponseByRoute[K];
+};
+type AgentApiRawFailure<K extends AgentApiRouteKey = AgentApiRouteKey> = {
+  ok: false;
+  routeKey?: K;
+  status?: number;
+  reason: AgentApiRawClientErrorReason;
+  message: string;
+  errorCode?: string | null;
+  suggestedNextAction?: string | null;
+  proxy?: unknown;
+  cause?: unknown;
+  response?: unknown;
+};
+type AgentApiRawResult<K extends AgentApiRouteKey> = AgentApiRawSuccess<K> | AgentApiRawFailure<K>;
 type AgentApiRawClientResource = AgentApiContract[AgentApiRouteKey]["client"]["resource"];
 type AgentApiRawClientResourceMethod<R extends AgentApiRawClientResource> = { [K in AgentApiRouteKey]: AgentApiContract[K]["client"] extends {
   resource: R;
@@ -1005,6 +766,9 @@ type AgentApiRouteKeyForClient<R extends AgentApiRawClientResource, M extends Ag
   resource: R;
   method: M;
 } ? K : never; }[AgentApiRouteKey];
+type AgentApiRawClientMethodArgs<K extends AgentApiRouteKey> = [AgentApiRequestParamsByRoute[K]] extends [never] ? [AgentApiRequestQueryByRoute[K]] extends [never] ? [AgentApiRequestBodyByRoute[K]] extends [never] ? [] : [body: AgentApiRequestBodyByRoute[K]] : [query: AgentApiRequestQueryByRoute[K]] : [AgentApiRequestQueryByRoute[K]] extends [never] ? [AgentApiRequestBodyByRoute[K]] extends [never] ? [params: AgentApiRequestParamsByRoute[K]] : [params: AgentApiRequestParamsByRoute[K], body: AgentApiRequestBodyByRoute[K]] : [AgentApiRequestBodyByRoute[K]] extends [never] ? [params: AgentApiRequestParamsByRoute[K], query: AgentApiRequestQueryByRoute[K]] : [params: AgentApiRequestParamsByRoute[K], query: AgentApiRequestQueryByRoute[K], body: AgentApiRequestBodyByRoute[K]];
+type AgentApiRawClientMethod<K extends AgentApiRouteKey> = (...args: AgentApiRawClientMethodArgs<K>) => Promise<AgentApiRawResult<K>>;
+type AgentApiRawClient = { [R in AgentApiRawClientResource]: { [M in AgentApiRawClientResourceMethod<R>]: AgentApiRawClientMethod<AgentApiRouteKeyForClient<R, M>>; }; };
 //#endregion
 //#region ../shared/src/index.d.ts
 /**
@@ -1593,16 +1357,6 @@ declare const agentApiThreadUnfollowBodySchema: z.ZodObject<{
   thread: z.ZodString;
   reason: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
-declare const agentApiThreadListItemSchema: z.ZodObject<{
-  target: z.ZodString;
-  threadChannelId: z.ZodString;
-  parentChannelRef: z.ZodString;
-  parentMessageId: z.ZodString;
-  parentMessageShortId: z.ZodString;
-  followedAt: z.ZodString;
-  reason: z.ZodString;
-  doneAt: z.ZodNullable<z.ZodString>;
-}, z.core.$loose>;
 declare const agentApiThreadListResponseSchema: z.ZodObject<{
   threads: z.ZodArray<z.ZodObject<{
     target: z.ZodString;
@@ -8334,7 +8088,6 @@ type AgentApiChannelLifecycleBody = z.infer<typeof agentApiChannelLifecycleBodyS
 type AgentApiAttachmentDownloadParams = z.infer<typeof agentApiAttachmentDownloadParamsSchema>;
 type AgentApiChannelMembersQuery = z.infer<typeof agentApiChannelMembersQuerySchema>;
 type AgentApiThreadUnfollowBody = z.infer<typeof agentApiThreadUnfollowBodySchema>;
-type AgentApiThreadListItem = z.infer<typeof agentApiThreadListItemSchema>;
 type AgentApiThreadListResponse = z.infer<typeof agentApiThreadListResponseSchema>;
 type AgentApiInboxListQuery = z.infer<typeof agentApiInboxListQuerySchema>;
 type AgentApiInboxListResponse = z.infer<typeof agentApiInboxListResponseSchema>;
@@ -8930,6 +8683,16 @@ interface AgentApiClientFailure<K extends AgentApiRouteKey = AgentApiRouteKey> {
   error: AgentApiClientError;
 }
 type AgentApiClientResult<K extends AgentApiRouteKey> = AgentApiClientSuccess<K> | AgentApiClientFailure<K>;
+type AgentApiClientMethod<K extends AgentApiRouteKey> = (...args: Parameters<AgentApiRawClientMethod<K>>) => Promise<AgentApiClientResult<K>>;
+type AgentApiClientMethods = { [R in keyof AgentApiRawClient]: { [M in keyof AgentApiRawClient[R]]: AgentApiRawClient[R][M] extends AgentApiRawClientMethod<infer K> ? AgentApiClientMethod<K> : never; }; };
+interface AgentApiClientRequestOptions<K extends AgentApiRouteKey> {
+  params?: AgentApiRequestParamsByRoute[K];
+  query?: AgentApiRequestQueryByRoute[K];
+  body?: AgentApiRequestBodyByRoute[K];
+}
+type AgentApiClient = AgentApiClientMethods & {
+  request<K extends AgentApiRouteKey>(routeKey: K, options?: AgentApiClientRequestOptions<K>): Promise<AgentApiClientResult<K>>;
+};
 type AgentApiAuthHeaders = Record<string, string>;
 type AgentApiAuthStrategy = AgentApiAuthHeaders | ((request: AgentApiRawTransportRequest) => AgentApiAuthHeaders | Promise<AgentApiAuthHeaders>);
 interface AgentApiFetchTransportOptions {
@@ -9044,24 +8807,12 @@ interface RaftRouteInfo extends RaftRouteMeta {
   annotations: RaftRouteAnnotations;
 }
 /**
- * `routes.<resource>.<method>({ params, query, body })` (one named object, typed per route) for every route in the
+ * `routes.<resource>.<method>(params?, query?, body?)` for every route in the
  * contract, plus route introspection. Reads retry (bounded); writes and
  * destructive reads make exactly one attempt regardless of client retry
  * settings, because the contract says repeating them is not safe.
  */
-type RoutePart<Name extends string, T> = [T] extends [never] ? { [P in Name]?: never; } : {} extends T ? { [P in Name]?: T; } : { [P in Name]: T; };
-/**
- * The single input every route takes: `{ params, query, body }`, typed per
- * route. A part the route does not have is `never` (passing it is a compile
- * error); a part with required fields is a required property.
- */
-type RaftRouteInput<K extends RaftRouteKey> = RoutePart<"params", AgentApiRequestParamsByRoute[K]> & RoutePart<"query", AgentApiRequestQueryByRoute[K]> & RoutePart<"body", AgentApiRequestBodyByRoute[K]>;
-type RaftRouteMethod<K extends RaftRouteKey> = {} extends RaftRouteInput<K> ? (input?: RaftRouteInput<K>) => Promise<RaftRouteResult<K>> : (input: RaftRouteInput<K>) => Promise<RaftRouteResult<K>>;
-/** `routes.<resource>.<method>({ params, query, body })` for every route in the contract. */
-type RaftRouteMethods = { [R in AgentApiRawClientResource]: { [M in AgentApiRawClientResourceMethod<R>]: RaftRouteMethod<AgentApiRouteKeyForClient<R, M>>; }; };
-type RaftRoutes = RaftRouteMethods & {
-  /** The same call by route key: `request("actionPrepare", { body })`. */
-  request<K extends RaftRouteKey>(routeKey: K, input?: RaftRouteInput<K>): Promise<RaftRouteResult<K>>;
+type RaftRoutes = AgentApiClient & {
   /** Content hash of the route manifest this SDK was built against. */
   manifestVersion: string;
   /** Static description of one route: capability, side effect, idempotency, audience, retry policy. */
@@ -9082,7 +8833,12 @@ interface CreateRaftRoutesOptions {
     beforeRequest?: infer F;
   } | undefined ? F : never;
 }
-/** Build the public routes layer directly (convenience over createRaftRouteClient + raftRoutesFromClient). */
+/**
+ * Build the routes layer over two transports: a retrying one for routes the
+ * contract marks retry-safe, and a single-attempt one for everything else.
+ * The split is decided per route from `AGENT_API_ROUTE_META`, never by the
+ * caller and never by the HTTP method.
+ */
 export declare function createRaftRoutes(options: CreateRaftRoutesOptions): RaftRoutes;
 //#endregion
 //#region src/context.d.ts
@@ -9192,7 +8948,7 @@ type RaftClient = AgentApiMessageClient & RaftManageClient & {
     join(request: RaftChannelJoinRequest): Promise<RaftChannelJoinResult>;
   };
   /**
-   * Every Agent API route as `routes.<resource>.<method>({ params, query, body })` (one named object, typed per route),
+   * Every Agent API route as `routes.<resource>.<method>(params?, query?, body?)`,
    * typed from the shared contract, with per-route metadata via `routes.describe`.
    * Retry policy follows the contract: reads may retry, writes make one attempt.
    */
@@ -9327,22 +9083,6 @@ interface CreateRaftOptions {
    * is held once and returns the unread context, which is the safe default.
    */
   frontier?: SeenFrontierSnapshot | null;
-  /**
-   * Persist the client's state (committed and pending inbox cursors, the seen
-   * frontier, held-send keys) across tool calls and processes. The store
-   * implements `load()` and `save(state, { expectedVersion })`; the SDK loads
-   * once before the first operation and saves after each successful operation
-   * that changed the state (one attempt, never fails the operation).
-   */
-  state?: RaftStateStore;
-  /** Called when loading or saving the state fails or is rejected as stale. */
-  onStateSaveError?: RaftStateSaveErrorHandler;
-}
-interface RaftInboxCommitResult {
-  /** The committed cursor, or null when there was nothing to commit. */
-  cursor: number | null;
-  /** Whether the state was persisted (true when no store is configured). */
-  saved: boolean;
 }
 interface Raft {
   identity: {
@@ -9364,22 +9104,8 @@ interface Raft {
     };
   };
   inbox: {
-    /**
-     * One bounded pull. Nothing is acknowledged by it. Without `since`, sends
-     * the last committed cursor (from `state`), which is what acknowledges the
-     * previously committed batch on the Server; the returned batch's cursor is
-     * recorded as pending until you `commit()` it.
-     */
+    /** One bounded pull. Nothing is acknowledged until the next call passes `data.cursor` as `since` (cursor mode). */
     check(request?: CheckInboxRequest): Promise<CheckInboxOutcome>;
-    /**
-     * Mark a batch as processed. With no argument, commits the pending cursor
-     * from the last `check()` (possibly in an earlier process, via `state`);
-     * also accepts `{ cursor }` or a batch. Records only; the next `check()`
-     * acknowledges it on the Server. The SDK never commits on its own.
-     */
-    commit(target?: {
-      cursor: number | null;
-    }): Promise<RaftInboxCommitResult>;
     /**
      * Pull until the Server reports nothing more, like `raft message check`, as
      * an async iterator: the pull that acknowledges a batch is only sent when
@@ -9397,141 +9123,16 @@ interface Raft {
     send(request: SendMessageRequest): Promise<SendMessageOutcome>;
     /** Reply where a received message came from. */
     reply(message: Pick<RaftMessage, "target">, request: Omit<SendMessageRequest, "target">): Promise<SendMessageOutcome>;
-    /** Find a specific message (`raft message search`); previews neutralise @handles and #channels. */
-    search(request: SearchMessagesRequest): Promise<RaftOutcome<RaftSearchPage, "results" | "empty">>;
-    /** Resolve one message id to its canonical form and reply target. */
-    resolve(request: {
-      messageId: string;
-    }): Promise<RaftOutcome<RaftMessage, "message">>;
-    react(request: ReactRequest): Promise<RaftOutcome<ReactRequest, "added" | "removed">>;
-    unreact(request: ReactRequest): Promise<RaftOutcome<ReactRequest, "added" | "removed">>;
-  };
-  attachments: {
-    /** Small-file multipart upload into a conversation; the upload alone posts nothing. */
-    upload(request: UploadAttachmentRequest): Promise<RaftOutcome<RaftAttachmentUploaded, "uploaded">>;
-    download(request: {
-      attachmentId: string;
-    }): Promise<RaftOutcome<RaftAttachmentBytes, "downloaded">>;
-    comments(request: {
-      attachmentId: string;
-      limit?: number;
-    }): Promise<RaftOutcome<AgentApiAttachmentCommentsResponse & {
-      attachmentId: string;
-    }, "comments" | "empty">>;
-  };
-  mentions: {
-    /** @mentions you sent that reached nobody, with the recovery commands. */
-    pending(request?: {
-      limit?: number;
-    }): Promise<RaftOutcome<RaftPendingMentions, "pending" | "empty">>;
-    /** `notify` the target of an unreached mention, or `add` them to the conversation. */
-    execute(request: ExecuteMentionActionRequest): Promise<RaftOutcome<{
-      action: AgentMentionActionKind;
-      results: AgentMentionActionResult[];
-    }, "executed">>;
-    /** Per-target delivery outcome for a message you sent. */
-    deliveries(request: {
-      messageId: string;
-    }): Promise<RaftOutcome<AgentApiSenderMentionDeliveriesResponse, "deliveries" | "empty">>;
-  };
-  actions: {
-    /**
-     * Post an action card for a human to confirm (channel:create,
-     * channel:add_member, agent:create, and the integration card types). The
-     * human who clicks it executes it as themselves.
-     */
-    prepare(request: PrepareActionCardRequest): Promise<RaftOutcome<RaftPreparedCard, "prepared">>;
-  };
-  manual: {
-    /** Fetch a Manual topic; `intent` and `reason` are required and must never carry prompts, credentials, or message payloads. */
-    get(request: {
-      topic: string;
-    } & ManualContext): Promise<RaftOutcome<AgentApiKnowledgeGetResponse, "topic">>;
-    search(request: {
-      query: string;
-      scope?: string;
-    } & ManualContext): Promise<RaftOutcome<AgentApiKnowledgeSearchResponse, "results" | "empty">>;
   };
   tasks: {
     /** Claim before working. Refusals are rows, not exceptions; a hold comes back as `state: "held"` with `retry`. */
     claim(request: ClaimTasksRequest): Promise<ClaimTasksOutcome>;
-    /** A channel's task board, or your own tasks across channels with `mine: true`. */
-    list(request: ListTasksRequest): Promise<RaftOutcome<RaftTaskBoard, "board" | "empty">>;
-    create(request: CreateTasksRequest): Promise<RaftOutcome<RaftTasksCreated, "created">>;
-    unclaim(request: TaskRef): Promise<RaftOutcome<TaskRef, "unclaimed">>;
-    assign(request: AssignTaskRequest): Promise<RaftOutcome<{
-      target: string;
-      taskNumber: number;
-      assignee: string | null;
-      revision: number;
-    }, "assigned" | "unassigned">>;
-    /** todo → in_progress → in_review → done; `closed` from anywhere. A hold comes back as `state: "held"` with `data.request`. */
-    updateStatus(request: UpdateTaskStatusRequest): Promise<UpdateTaskStatusOutcome>;
-    amend(request: AmendTaskRequest): Promise<AmendTaskOutcome>;
-    history(request: TaskRef): Promise<RaftOutcome<AgentApiTaskHistoryResponse & {
-      target: string;
-    }, "history">>;
-    /** Convert a top-level message into an unassigned task. */
-    convert(request: {
-      target: string;
-      messageId: string;
-    }): Promise<RaftOutcome<{
-      target: string;
-      task: AgentApiTaskCreateResponse["tasks"][number];
-    }, "converted">>;
-    delete(request: TaskRef): Promise<RaftOutcome<TaskRef, "deleted">>;
-  };
-  channels: {
-    /** Explicit, idempotent. Never a side effect of sending. */
-    join(request: {
-      target: string;
-    }): Promise<RaftOutcome<RaftChannelRef, "joined" | "already_joined">>;
-    leave(request: {
-      target: string;
-    }): Promise<RaftOutcome<RaftChannelRef, "left" | "not_joined">>;
-    /** Mute ordinary Activity delivery; @mentions, DMs, and followed threads still arrive. */
-    mute(request: {
-      target: string;
-    }): Promise<RaftOutcome<RaftChannelMuteState, "muted" | "unmuted">>;
-    unmute(request: {
-      target: string;
-    }): Promise<RaftOutcome<RaftChannelMuteState, "muted" | "unmuted">>;
-    members(request: {
-      target: string;
-    }): Promise<RaftOutcome<AgentApiChannelMembersResponse, "members">>;
-  };
-  threads: {
-    list(): Promise<RaftOutcome<AgentApiThreadListItem[], "threads" | "empty">>;
-    unfollow(request: {
-      target: string;
-      reason?: string;
-    }): Promise<RaftOutcome<{
-      target: string;
-    }, "unfollowed">>;
-  };
-  server: {
-    /** Summary by default; `view: "channels" | "agents" | "humans"` pages a section; `view: "full"` is the whole overview. */
-    info(request?: ServerInfoRequest): Promise<RaftOutcome<RaftServerInfo, "info">>;
-  };
-  profile: {
-    show(request?: {
-      target?: string;
-    }): Promise<RaftOutcome<AgentApiProfileView, "profile">>;
-    update(request: AgentApiProfileUpdateBody): Promise<RaftOutcome<AgentApiProfileView, "updated">>;
   };
   /** What this process has shown its model, per target; export it to survive restarts. */
   frontier: SeenFrontier;
-  state: {
-    /** Save now (for example after `frontier.recordHeld`). Best effort; returns whether it succeeded. */
-    save(): Promise<boolean>;
-    /** Load the persisted state now (operations do this automatically). */
-    load(): Promise<void>;
-    /** The current state value, as it would be saved. */
-    snapshot(): RaftState;
-  };
   /** Every Agent API route, typed from the shared contract. */
   routes: RaftRoutes;
 }
 export declare function createRaft(options: CreateRaftOptions): Raft;
 //#endregion
-export type { AmendTaskOutcome, AmendTaskRequest, AssignTaskRequest, BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, CreateTasksRequest, DrainInboxRequest, ExecuteMentionActionRequest, ListInboxRequest, ListTasksRequest, ManualContext, PrepareActionCardRequest, Raft, RaftAckMode, RaftActionPrepareRequest, RaftActionPrepared, RaftApiError, RaftApiResult, RaftAppConfig, RaftAppConfigPatch, RaftAttachmentBytes, RaftAttachmentUploaded, RaftAvatarUpload, RaftChannelJoinClient, RaftChannelJoinClientResult, RaftChannelJoinError, RaftChannelJoinFailure, RaftChannelJoinOperation, RaftChannelJoinRequest, RaftChannelJoinResult, RaftChannelJoinSuccess, RaftChannelJoinTransportError, RaftChannelMuteState, RaftChannelRef, RaftClaimHeld, RaftClaimHeldLike, RaftClaimResult, RaftClaimRow, RaftClaimRowState, RaftClient, RaftClientError, RaftClientFailure, RaftClientResult, RaftClientSuccess, RaftClientThrottleOptions, RaftClientTransportRequest, RaftContextAgent, RaftContextData, RaftContextError, RaftContextResult, RaftContextServer, RaftCredentialErrorCode, RaftCredentialIdentity, RaftCredentialStore, RaftEvent, RaftEventAttachment, RaftEventExternalMessage, RaftEventsReceiveData, RaftEventsReceiveError, RaftEventsReceiveRequest, RaftEventsReceiveResult, RaftFailure, RaftHeld, RaftHeldBase, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxListing, RaftInboxNotice, RaftManageClient, RaftMessage, RaftMessageAttachment, RaftMessageTask, RaftNextStep, RaftNoticeFlag, RaftNoticeTarget, RaftOpError, RaftOpErrorCode, RaftOutcome, RaftPendingMentions, RaftPreparedCard, RaftProfile, RaftProfileUpdate, RaftRouteAnnotations, RaftRouteInfo, RaftRouteKey, RaftRouteMeta, RaftRouteResult, RaftRouteRetryPolicy, RaftRoutes, RaftSdkConfigurationErrorCode, RaftSearchPage, RaftSendContinuation, RaftSenderType, RaftSent, RaftServerInfo, RaftServerProfile, RaftServerUpdate, RaftState, RaftStateContinuation, RaftStateSaveErrorHandler, RaftStateStore, RaftTaskBoard, RaftTaskStatus, RaftTasksCreated, RaftWebhookStatus, ReactRequest, ReadHistoryRequest, SearchMessagesRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, ServerInfoRequest, ServerInfoSection, StoredRaftCredential, TaskRef, UpdateTaskStatusOutcome, UpdateTaskStatusRequest, UploadAttachmentRequest, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };
+export type { BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, DrainInboxRequest, ListInboxRequest, Raft, RaftAckMode, RaftActionPrepareRequest, RaftActionPrepared, RaftApiError, RaftApiResult, RaftAppConfig, RaftAppConfigPatch, RaftAvatarUpload, RaftChannelJoinClient, RaftChannelJoinClientResult, RaftChannelJoinError, RaftChannelJoinFailure, RaftChannelJoinOperation, RaftChannelJoinRequest, RaftChannelJoinResult, RaftChannelJoinSuccess, RaftChannelJoinTransportError, RaftClaimHeld, RaftClaimResult, RaftClaimRow, RaftClaimRowState, RaftClient, RaftClientError, RaftClientFailure, RaftClientResult, RaftClientSuccess, RaftClientThrottleOptions, RaftClientTransportRequest, RaftContextAgent, RaftContextData, RaftContextError, RaftContextResult, RaftContextServer, RaftCredentialErrorCode, RaftCredentialIdentity, RaftCredentialStore, RaftEvent, RaftEventAttachment, RaftEventExternalMessage, RaftEventsReceiveData, RaftEventsReceiveError, RaftEventsReceiveRequest, RaftEventsReceiveResult, RaftFailure, RaftHeld, RaftHeldBase, RaftHistoryPage, RaftInboxBatch, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxListing, RaftInboxNotice, RaftManageClient, RaftMessage, RaftMessageAttachment, RaftMessageTask, RaftNextStep, RaftNoticeFlag, RaftNoticeTarget, RaftOpError, RaftOpErrorCode, RaftOutcome, RaftProfile, RaftProfileUpdate, RaftRouteAnnotations, RaftRouteInfo, RaftRouteKey, RaftRouteMeta, RaftRouteResult, RaftRouteRetryPolicy, RaftRoutes, RaftSdkConfigurationErrorCode, RaftSendContinuation, RaftSenderType, RaftSent, RaftServerProfile, RaftServerUpdate, RaftWebhookStatus, ReadHistoryRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, StoredRaftCredential, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };

package/package.json

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