robotrock 0.8.4 → 0.9.0

package/dist/{client-D-XEBOWd.d.ts → client-Cy7YLxms.d.ts}

@@ -1,4 +1,4 @@
-import { TaskContextInput, AssignToInput, TaskPriority, ThreadUpdateStatus, AgentTelemetryInput, TaskResponse, DiscriminatedApprovalResult, Task, ThreadUpdate } from './schemas/index.js';
+import { TaskContextFormatVersion, TaskContextInput, AssignToInput, TaskPriority, ThreadUpdateStatus, TaskResponse, DiscriminatedApprovalResult, Task, ThreadUpdate } from './schemas/index.js';
 
 type RobotRockWebhookConfig = {
     url: string;
@@ -14,6 +14,11 @@ interface RobotRockPollingOptions {
      */
     timeoutMs?: number;
 }
+/** Advanced client settings rarely changed by integrators. */
+type RobotRockAdvancedConfig = {
+    /** Task context wire format version sent on every request. @default 2 */
+    contextVersion?: TaskContextFormatVersion;
+};
 type RobotRockClientBaseConfig = {
     /** Optional override for API key. Falls back to ROBOTROCK_API_KEY. */
     apiKey?: string;
@@ -28,10 +33,12 @@ type RobotRockClientBaseConfig = {
      */
     app?: string;
     /**
-     * Task context format version sent on every `sendToHuman` request.
-     * @default 2
+     * Agent release version (semver, git SHA, deploy tag).
+     * Defaults to `AGENT_VERSION` or `ROBOTROCK_AGENT_VERSION` from env when omitted.
      */
-    version?: 2;
+    version?: string;
+    /** Advanced settings (context wire format, etc.). */
+    advanced?: RobotRockAdvancedConfig;
 };
 /** Client config with a webhook (mutually exclusive with `polling`). */
 type RobotRockWebhookClientConfig = RobotRockClientBaseConfig & {
@@ -46,7 +53,7 @@ type RobotRockPollingClientConfig = RobotRockClientBaseConfig & {
 type RobotRockConfig = RobotRockWebhookClientConfig | RobotRockPollingClientConfig;
 type SendToHumanActionInput = Omit<TaskContextInput["actions"][number], "handlers">;
 type SendToHumanValidUntil = Date | string;
-type SendToHumanInput<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = Omit<TaskContextInput, "app" | "actions" | "version" | "validUntil"> & {
+type SendToHumanInput<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = Omit<TaskContextInput, "app" | "actions" | "contextVersion" | "version" | "validUntil"> & {
     actions: A;
     /** Task deadline; serialized to an ISO 8601 string on the wire. */
     validUntil?: SendToHumanValidUntil;
@@ -75,10 +82,10 @@ type SendToHumanInput<A extends readonly SendToHumanActionInput[] = readonly Sen
         status?: ThreadUpdateStatus;
     };
     /**
-     * Agent telemetry (version, cost, tool calls) — not shown in inbox UI.
+     * Agent release version override. When omitted, uses the client `version`.
      * Used for statistics and feedback analysis.
      */
-    agent?: AgentTelemetryInput;
+    version?: string;
 };
 type SendToHumanWithAppInput<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = (SendToHumanInput<A> | Readonly<SendToHumanInput<A>>) & {
     /** Inbox app bucket. Overrides the client `app` when set. */
@@ -111,7 +118,8 @@ declare class RobotRock {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly app?;
-    private readonly version;
+    private readonly agentVersion?;
+    private readonly contextVersion;
     private readonly webhook?;
     private readonly polling;
     constructor(config: RobotRockConfig);
@@ -134,4 +142,4 @@ declare class RobotRock {
 declare function createClient(config: RobotRockConfig): RobotRock;
 declare function attachWebhookToActions(actions: readonly SendToHumanActionInput[], webhook: RobotRockWebhookConfig): TaskContextInput["actions"];
 
-export { RobotRock as R, type SendToHumanActionInput as S, type SendToHumanInput as a, type RobotRockConfig as b, RobotRockError as c, type RobotRockPollingClientConfig as d, type RobotRockPollingOptions as e, type RobotRockWebhookClientConfig as f, type RobotRockWebhookConfig as g, type SendToHumanResult as h, type SendToHumanValidUntil as i, type SendUpdateInput as j, attachWebhookToActions as k, createClient as l };
+export { RobotRock as R, type SendToHumanActionInput as S, type SendToHumanInput as a, type RobotRockConfig as b, type RobotRockAdvancedConfig as c, RobotRockError as d, type RobotRockPollingClientConfig as e, type RobotRockPollingOptions as f, type RobotRockWebhookClientConfig as g, type RobotRockWebhookConfig as h, type SendToHumanResult as i, type SendToHumanValidUntil as j, type SendUpdateInput as k, attachWebhookToActions as l, createClient as m };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { R as RobotRock, b as RobotRockConfig } from './client-D-XEBOWd.js';
-export { c as RobotRockError, d as RobotRockPollingClientConfig, e as RobotRockPollingOptions, f as RobotRockWebhookClientConfig, g as RobotRockWebhookConfig, S as SendToHumanActionInput, a as SendToHumanInput, h as SendToHumanResult, i as SendToHumanValidUntil, j as SendUpdateInput, k as attachWebhookToActions, l as createClient } from './client-D-XEBOWd.js';
+import { R as RobotRock, b as RobotRockConfig } from './client-Cy7YLxms.js';
+export { c as RobotRockAdvancedConfig, d as RobotRockError, e as RobotRockPollingClientConfig, f as RobotRockPollingOptions, g as RobotRockWebhookClientConfig, h as RobotRockWebhookConfig, S as SendToHumanActionInput, a as SendToHumanInput, i as SendToHumanResult, j as SendToHumanValidUntil, k as SendUpdateInput, l as attachWebhookToActions, m as createClient } from './client-Cy7YLxms.js';
 import { Task, DiscriminatedApprovalResult } from './schemas/index.js';
-export { AGENT_OTEL_SPANS_MAX, AgentCost, AgentCostTokens, AgentOtel, AgentOtelSpanStatus, AgentOtelSpanSummary, AgentTelemetry, AgentTelemetryInput, AgentToolCalls, ApprovalResult, AssignToInput, CreateTaskBody, CreateTaskBodyInput, DEFAULT_TASK_PRIORITY, DEFAULT_THREAD_UPDATE_STATUS, Handler, InferActionData, LOWEST_TASK_PRIORITY, TASK_PRIORITY_RANK, TaskAction, TaskContext, TaskContextInput, TaskPriority, TaskResponse, TaskResult, TaskStatus, ThreadUpdate, ThreadUpdateBody, ThreadUpdateBodyInput, ThreadUpdateInput, ThreadUpdateResponse, ThreadUpdateSource, ThreadUpdateStatus, TriggerHandler, TupleElementIndices, WebhookHandler, agentCostSchema, agentCostTokensSchema, agentOtelSchema, agentOtelSpanStatusSchema, agentOtelSpanSummarySchema, agentTelemetrySchema, agentToolCallsSchema, assignToSchema, createTaskBodySchema, taskContextSchema, taskPriorities, taskPrioritySchema, threadUpdateBodySchema, threadUpdateInputSchema, threadUpdateStatusSchema, threadUpdateStatuses } from './schemas/index.js';
+export { AgentTelemetry, AgentTelemetryInput, ApprovalResult, AssignToInput, CreateTaskBody, CreateTaskBodyInput, DEFAULT_TASK_PRIORITY, DEFAULT_THREAD_UPDATE_STATUS, Handler, InferActionData, LOWEST_TASK_PRIORITY, TASK_CONTEXT_FORMAT_VERSION, TASK_PRIORITY_RANK, TaskAction, TaskContext, TaskContextFormatVersion, TaskContextInput, TaskPriority, TaskResponse, TaskResult, TaskStatus, ThreadUpdate, ThreadUpdateBody, ThreadUpdateBodyInput, ThreadUpdateInput, ThreadUpdateResponse, ThreadUpdateSource, ThreadUpdateStatus, TriggerHandler, TupleElementIndices, WebhookHandler, agentTelemetrySchema, assignToSchema, createTaskBodySchema, taskContextSchema, taskPriorities, taskPrioritySchema, threadUpdateBodySchema, threadUpdateInputSchema, threadUpdateStatusSchema, threadUpdateStatuses } from './schemas/index.js';
 import { z } from 'zod';
-export { R as RobotRockHandlerWebhookPayload } from './handler-webhook-BqEi6Bk-.js';
-export { AgentTelemetryFromOtelOptions, OtelSpanLike, OtelSpanSummaryInput, agentTelemetryFromOtel, toolCallsFromOtelSpans } from './otel/index.js';
+export { E as EndRobotRockHumanWaitSpanOptions, b as RobotRockCreatedTask, c as RobotRockHandledOtelInput, a as RobotRockHandlerWebhookPayload, d as RobotRockHumanWaitOtelSession, e as RobotRockOtelHandle, f as RobotRockOtelRecordOptions, R as RobotRockPlatformOtelFields, g as beginRobotRockHumanWaitOtel, h as captureRobotRockOtelHandle, i as endRobotRockHumanWaitSpan, j as finishRobotRockHumanWaitOtel, r as recordRobotRockHandledToOtel, s as shouldRecordRobotRockOtel, k as startRobotRockHumanWaitSpan, l as stripPlatformOtelFields, t as toRobotRockHandledOtelInput } from './otel-platform-DzHyHkGk.js';
+import '@opentelemetry/api';
 
 /**
  * Read RobotRock client config from environment variables.
@@ -32,7 +32,73 @@ declare function toDiscriminatedApprovalResult<A extends readonly {
     schema?: unknown;
 }[]>(actions: A, task: Task): DiscriminatedApprovalResult<A>;
 
-declare const robotRockWebhookPayloadSchema: z.ZodObject<{
+/**
+ * Reserved inbox actions that reviewers can take outside your task's defined actions.
+ * Agents and integrations must treat these as terminal — stop the run and do not retry sendToHuman.
+ */
+declare const PLATFORM_MARK_DONE_ACTION_ID: "robotrock:mark-done";
+declare const PLATFORM_REJECT_REQUEST_ACTION_ID: "robotrock:reject-request";
+declare const PLATFORM_MARK_DONE_ACTION_TITLE = "Mark as done";
+declare const PLATFORM_REJECT_REQUEST_ACTION_TITLE = "Reject request";
+declare const PLATFORM_TERMINAL_ACTION_IDS: readonly ["robotrock:mark-done", "robotrock:reject-request"];
+type PlatformTerminalActionId = (typeof PLATFORM_TERMINAL_ACTION_IDS)[number];
+type PlatformRejectRequestData = {
+    feedback: string;
+};
+type HandledActionInput = {
+    actionId: string;
+    data?: unknown;
+    handledBy?: string;
+    handledAt?: number | Date;
+};
+type PlatformMarkDoneOutcome = {
+    source: "platform";
+    kind: "mark-done";
+    actionId: typeof PLATFORM_MARK_DONE_ACTION_ID;
+    data: Record<string, never>;
+    handledBy?: string;
+    handledAt?: Date;
+};
+type PlatformRejectRequestOutcome = {
+    source: "platform";
+    kind: "reject-request";
+    actionId: typeof PLATFORM_REJECT_REQUEST_ACTION_ID;
+    data: PlatformRejectRequestData;
+    handledBy?: string;
+    handledAt?: Date;
+};
+type TaskActionOutcome = {
+    source: "task";
+    actionId: string;
+    data: unknown;
+    handledBy?: string;
+    handledAt?: Date;
+};
+type HandledOutcome = PlatformMarkDoneOutcome | PlatformRejectRequestOutcome | TaskActionOutcome;
+declare class PlatformRejectRequestError extends Error {
+    readonly actionId: "robotrock:reject-request";
+    readonly feedback: string;
+    constructor(feedback: string, message?: string);
+}
+declare function isPlatformMarkDoneAction(actionId: string | undefined): actionId is typeof PLATFORM_MARK_DONE_ACTION_ID;
+declare function isPlatformRejectRequestAction(actionId: string | undefined): actionId is typeof PLATFORM_REJECT_REQUEST_ACTION_ID;
+declare function isPlatformTerminalAction(actionId: string | undefined): actionId is PlatformTerminalActionId;
+declare function parsePlatformRejectRequestData(data: unknown): PlatformRejectRequestData | null;
+/**
+ * Classify a handled task action as a platform terminal outcome or a normal task action.
+ */
+declare function parseHandledOutcome(input: HandledActionInput): HandledOutcome;
+/**
+ * Throw when a human rejected the request from the inbox (not your task's reject action).
+ * Use after polling, webhooks, or getTask when you want agents to stop immediately.
+ */
+declare function assertNotPlatformRejectRequest(actionId: string, data?: unknown): void;
+/**
+ * Returns true when the agent should stop — platform mark-done or reject-request.
+ */
+declare function shouldStopAgentForHandledAction(actionId: string | undefined): boolean;
+
+declare const robotRockWebhookPayloadBodySchema: z.ZodObject<{
     taskId: z.ZodString;
     action: z.ZodObject<{
         id: z.ZodString;
@@ -42,15 +108,16 @@ declare const robotRockWebhookPayloadSchema: z.ZodObject<{
     handledBy: z.ZodOptional<z.ZodString>;
     handledAt: z.ZodString;
     handlerType: z.ZodString;
-    headers: z.ZodRecord<z.ZodString, z.ZodString>;
 }, z.core.$strip>;
+type RobotRockWebhookPayload = z.infer<typeof robotRockWebhookPayloadBodySchema> & {
+    headers: Record<string, string>;
+};
 type RobotRockWebhookErrorCode = "MISSING_WEBHOOK_SECRET" | "MISSING_SIGNATURE" | "INVALID_SIGNATURE" | "INVALID_JSON" | "INVALID_PAYLOAD";
 declare class RobotRockWebhookError extends Error {
     readonly code: RobotRockWebhookErrorCode;
     readonly details?: unknown | undefined;
     constructor(message: string, code: RobotRockWebhookErrorCode, details?: unknown | undefined);
 }
-type RobotRockWebhookPayload = z.infer<typeof robotRockWebhookPayloadSchema>;
 interface VerifyRobotRockWebhookOptions {
     /**
      * Override shared secret (defaults to ROBOTROCK_WEBHOOK_SECRET).
@@ -71,4 +138,4 @@ interface VerifyRobotRockWebhookOptions {
  */
 declare function verifyRobotRockWebhook(request: Request, options?: VerifyRobotRockWebhookOptions): Promise<RobotRockWebhookPayload>;
 
-export { DiscriminatedApprovalResult, RobotRock, RobotRockConfig, RobotRockWebhookError, type RobotRockWebhookErrorCode, type RobotRockWebhookPayload, Task, TaskExpiredError, TaskTimeoutError, type VerifyRobotRockWebhookOptions, resolveRobotRockClient, resolveRobotRockConfig, toDiscriminatedApprovalResult, verifyRobotRockWebhook };
+export { DiscriminatedApprovalResult, type HandledActionInput, type HandledOutcome, PLATFORM_MARK_DONE_ACTION_ID, PLATFORM_MARK_DONE_ACTION_TITLE, PLATFORM_REJECT_REQUEST_ACTION_ID, PLATFORM_REJECT_REQUEST_ACTION_TITLE, PLATFORM_TERMINAL_ACTION_IDS, type PlatformMarkDoneOutcome, type PlatformRejectRequestData, PlatformRejectRequestError, type PlatformRejectRequestOutcome, type PlatformTerminalActionId, RobotRock, RobotRockConfig, RobotRockWebhookError, type RobotRockWebhookErrorCode, type RobotRockWebhookPayload, Task, type TaskActionOutcome, TaskExpiredError, TaskTimeoutError, type VerifyRobotRockWebhookOptions, assertNotPlatformRejectRequest, isPlatformMarkDoneAction, isPlatformRejectRequestAction, isPlatformTerminalAction, parseHandledOutcome, parsePlatformRejectRequestData, resolveRobotRockClient, resolveRobotRockConfig, shouldStopAgentForHandledAction, toDiscriminatedApprovalResult, verifyRobotRockWebhook };