anthropic.beta.messages — net.clojars.savya/anthropic-clj 0.44.0

Clojure wrapper for the beta Messages API.

await-stream clj

beta-batch-results clj

(beta-batch-results client id)

beta-tool-runner-handle clj

(beta-tool-runner-handle runner)

(beta-tool-runner-handle client params)

(beta-tool-runner-handle client params opts)

Create a Clojure handle around the SDK's blocking BetaToolRunner.

The handle's :messages and :streaming operations return lazy sequences; :set-next-params! accepts a normal request map, and :last-tool-response returns a translated message-param map or nil. The one-argument form wraps an existing SDK runner; the other forms create one through the beta Messages service.

cancel-beta-batch clj

(cancel-beta-batch client id)

cancel-stream! clj

close-stream! clj

count-beta-tokens clj

(count-beta-tokens client req)

(count-beta-tokens client req opts)

Count beta Messages input tokens without creating a message. Request maps support cache-control, compaction, context-management, mcp-servers, response-format, output-type, effort, task-budget, output-format, speed, user-profile-id, extra-headers, extra-query, and extra-body. Returns :input-tokens and, when present, nested :context-management data.

create-beta-batch clj

(create-beta-batch client req)

create-beta-message clj

(create-beta-message client req)

(create-beta-message client req opts)

Send a beta Messages request and return a generic Clojure map response.

Request maps support compaction, context-management, diagnostics, speed, and tool-choice disable-parallel-tool-use options. Tool specs support response-inclusion, input-examples, eager-input-streaming, caching, and dated :version options. System text and text content blocks accept citation-list :citations; document content blocks accept boolean or {:enabled ...} citation configuration. Custom tools accept optional :description and :input-schema; an omitted schema defaults to the SDK's object schema.

create-beta-thread clj

(create-beta-thread client req)

Start a beta message thread from a create-beta-message request map and return an opaque thread handle for the thread-* fns. Nothing is sent until thread-send. :unsupported-request-behavior (:error by default, or :continue-unthreaded) decides what happens when a request cannot be threaded.

delete-beta-batch clj

(delete-beta-batch client id)

get-beta-batch clj

(get-beta-batch client id)

list-beta-batches clj

(list-beta-batches client)

(list-beta-batches client opts)

list-beta-batches-lazy clj

(list-beta-batches-lazy client)

(list-beta-batches-lazy client opts)

Lazily list beta message batches; accepts the same options as list-beta-batches.

reduce-beta-batch-results clj

(reduce-beta-batch-results client id f init)

run-beta-tools clj

(run-beta-tools client params)

(run-beta-tools client params opts)

Run beta Messages with local tool functions until no tool is requested.

Options include :max-iterations, :on-message, and :on-turn. :on-turn receives each assistant response and the current params, and returns params for the next iteration, allowing tools and request settings to change. Tool functions may return {:tool-result value :compact-before-next-turn true} to request a {:type :summarize} compaction turn after their result; this drops :context-management from that request. Tool specs support response-inclusion, input-examples, eager-input-streaming, caching, and dated :version options.

stream-beta-message clj

(stream-beta-message client req on-event)

stream-beta-message-handle clj

(stream-beta-message-handle client req on-event)

(stream-beta-message-handle client req on-event opts)

Start a beta Messages SSE stream on a worker thread and return a cancellable handle. on-event receives normalized event maps.

stream-beta-message-queue clj

(stream-beta-message-queue client req)

(stream-beta-message-queue client req opts)

Start a bounded pull stream of normalized beta Messages events.

stream-beta-text clj

(stream-beta-text client req on-text)

take-stream-event clj

thread-append clj

(thread-append thread message)

Add a message map, or a seq of them, to the thread without sending.

thread-fork clj

(thread-fork thread)

Copy the thread's local history into a new, independent thread handle. Its next send opens a new server-side thread.

thread-last-message clj

(thread-last-message thread)

The most recent reply as a message map, or nil before the first send.

thread-messages clj

(thread-messages thread)

The thread's local message history as message maps.

thread-previous-message-id clj

(thread-previous-message-id thread)

The id the next send continues from, or nil before the first send.

thread-send clj

(thread-send thread)

(thread-send thread message)

Send the thread's pending turns plus message (a user text string, a message map, or a seq of message maps) and return the reply as a map like create-beta-message's. With no message, sends what the thread holds.

thread-send-streaming clj

(thread-send-streaming thread message on-event)

Streaming thread-send: on-event receives normalized event maps, and the concatenated text is returned, as with stream-beta-message. The thread records the reply once the stream completes.

thread-tool-runner clj

(thread-tool-runner thread)

A beta-tool-runner-handle that runs tools within the thread.

thread-update clj

(thread-update thread
               {:keys [model max-tokens system stop-sequences thinking
                       tool-choice tools metadata inference-geo user-profile-id
                       cache-control betas]})

Change request fields used by later sends: :model, :max-tokens, :system, :stop-sequences, :thinking, :tool-choice, :tools, :metadata, :inference-geo, :user-profile-id, :cache-control, and :betas.