tiny.acp.PermissionRequest

1/// One `session/request_permission` request from the agent: the tool call it names, the decision,2/// and the exact line. The caller records what the agent asked for and what was answered because3/// the observer receives each permission request and its decision as one of these records. The4/// client builds one twice per request: a preview for `permissionFn` with outcome `pending`, empty5/// option fields, and an empty line, then the full record for `permissionCommitFn`. The record owns6/// every `[]u8` field, and `deinit` frees them.7pub const PermissionRequest = struct {8    /// The exact line the agent sent, trimmed of surrounding whitespace, and empty in the preview.9    /// The line is borrowed from the reader's buffer and remains valid only until10    /// `permissionCommitFn` returns.11    envelope: []const u8,12    /// The request's `params.sessionId`, empty when absent.13    session_id: []u8,14    /// The tool call's `toolCallId`, empty when absent.15    tool_call_id: []u8,16    /// The tool call's `title`, empty when absent. The permission policy matches its title prefixes17    /// against it.18    title: []u8,19    /// The tool call's `kind`, empty when the tool call omits a kind.20    tool_kind: []u8,21    /// The tool call's `status`, empty when absent.22    status: []u8,23    /// The id of the chosen option, empty when the outcome is `cancelled` and in the preview.24    option_id: []u8,25    /// The kind of the chosen option, such as `allow_once` or `reject_once`, empty when an option26    /// remains unchosen.27    option_kind: []u8,28    /// The decision: `selected`, `cancelled`, or `pending` in the preview.29    outcome: []u8,30    /// The number of options the agent offered. The field defaults to 0.31    options: usize = 0,32    /// A minified JSON copy of the request's `params` object.33    raw: []u8,3435    /// Frees every owned string with the given allocator and leaves the value undefined for a36    /// record built with `fromClientRequest`. The call leaves the borrowed line alone.37    pub fn deinit(self: *PermissionRequest, allocator: Allocator) void {38        if (self.session_id.len != 0) allocator.free(self.session_id);39        if (self.tool_call_id.len != 0) allocator.free(self.tool_call_id);40        if (self.title.len != 0) allocator.free(self.title);41        if (self.tool_kind.len != 0) allocator.free(self.tool_kind);42        if (self.status.len != 0) allocator.free(self.status);43        if (self.option_id.len != 0) allocator.free(self.option_id);44        if (self.option_kind.len != 0) allocator.free(self.option_kind);45        if (self.outcome.len != 0) allocator.free(self.outcome);46        if (self.raw.len != 0) allocator.free(self.raw);47        self.* = undefined;48    }4950    /// Turns one parsed permission request and its decision into a `PermissionRequest` by reading51    /// `params` and `params.toolCall` from a parsed request object and adding the given decision52    /// and line, as the client does for the preview and the record. The call fails with53    /// `error.AgentProtocolError` when `params` or `params.toolCall` is missing. The function54    /// copies every string it keeps with the allocator, keeps the line by reference, and the caller55    /// frees the rest with `deinit`. The call fails with `error.OutOfMemory` and leaves nothing56    /// allocated when a copy fails.57    pub fn fromClientRequest(58        allocator: Allocator,59        object: std.json.ObjectMap,60        envelope: []const u8,61        outcome: []const u8,62        option_id: []const u8,63        option_kind: []const u8,64    ) !PermissionRequest {65        const params = json.objectObject(object, "params") orelse return error.AgentProtocolError;66        const tool_call = json.objectObject(params, "toolCall") orelse return error.AgentProtocolError;67        const session_id = try optionalStringAlloc(allocator, params, "sessionId");68        errdefer if (session_id.len != 0) allocator.free(session_id);69        const tool_call_id = try optionalStringAlloc(allocator, tool_call, "toolCallId");70        errdefer if (tool_call_id.len != 0) allocator.free(tool_call_id);71        const title = try optionalStringAlloc(allocator, tool_call, "title");72        errdefer if (title.len != 0) allocator.free(title);73        const tool_kind = try optionalStringAlloc(allocator, tool_call, "kind");74        errdefer if (tool_kind.len != 0) allocator.free(tool_kind);75        const status = try optionalStringAlloc(allocator, tool_call, "status");76        errdefer if (status.len != 0) allocator.free(status);77        const owned_option_id = try allocator.dupe(u8, option_id);78        errdefer allocator.free(owned_option_id);79        const owned_option_kind = try allocator.dupe(u8, option_kind);80        errdefer allocator.free(owned_option_kind);81        const owned_outcome = try allocator.dupe(u8, outcome);82        errdefer allocator.free(owned_outcome);83        const raw = try rawJsonAlloc(allocator, params);84        errdefer if (raw.len != 0) allocator.free(raw);85        return .{86            .envelope = envelope,87            .session_id = session_id,88            .tool_call_id = tool_call_id,89            .title = title,90            .tool_kind = tool_kind,91            .status = status,92            .option_id = owned_option_id,93            .option_kind = owned_option_kind,94            .outcome = owned_outcome,95            .options = arrayLength(params, "options"),96            .raw = raw,97        };98    }99};

1pub const PermissionRequest = protocol.PermissionRequest;