@shadcn/helpers weekly downloads statistics

@shadcn/helpers

A collection of helpers for building AI applications.

createChat

Human in the loop

A tool call left unresolved pauses the turn: the input streams, the turn finishes, and the client decides what happens next. A callback turn scripted after a paused turn becomes a continuation. It materializes when the follow-up request arrives and receives the resolved toolCall in its context.

For client-executed tools, the user supplies the output through addToolOutput and the continuation reads it:

For approval-gated tools, needsApproval pauses behind the user's decision. output (or errorText) then means "stream this if approved"; denial streams tool-output-denied automatically:

Wire the client with the AI SDK's own triggers: sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithToolCalls for client-executed tools, or lastAssistantMessageIsCompleteWithApprovalResponses plus addToolApprovalResponse({ id: part.approval.id, approved }) for approvals.

Continuation callbacks must be pure; regenerating re-resolves them against the current transcript. get() stops before the first continuation turn, since a continuation has no message without a live transcript.

Installation

Documentation

Visit https://ui.shadcn.com/docs to view the documentation.

Contributing

Please read the contributing guide.

License

Licensed under the MIT license.

Description from the npm listing.