@ykurilov/agent-chat-react 0.0.0-stage → 0.56.0

package/dist/types/notices/agent-notices.d.ts

@@ -0,0 +1,40 @@
+import type { AgentChatMessage } from "../chat-types.js";
+import type { NoticeLabels } from "../labels.js";
+import type { AgentNoticeViewKind, AgentNoticeViewProps } from "../skin-contract.js";
+import type { BackgroundTask, TaskApprovalDecision, TaskDecisionState } from "../background-tasks/use-background-tasks.js";
+/** Служебное сообщение, как его пишет сервер в часть `data-agent-notice`. */
+export interface AgentNotice {
+    kind: AgentNoticeViewKind;
+    taskId?: string;
+    title: string;
+    result?: string;
+    error?: string;
+    approval?: {
+        approvalId: string;
+        toolName: string;
+        input: unknown;
+    };
+}
+export declare const AGENT_NOTICE_PART_TYPE = "data-agent-notice";
+/** Служебные сообщения из сообщения человека, кроме реплик сотрудника; пусто — это обычное сообщение или реплика. */
+export declare function agentNoticesOf(message: AgentChatMessage): AgentNotice[];
+/** Реплика живого сотрудника человеку (служебное сообщение вида `staff`, с 0.53). */
+export interface StaffReply {
+    text: string;
+    staffName?: string;
+}
+/** Реплики сотрудника из сообщения; пусто — их нет. */
+export declare function staffRepliesOf(message: AgentChatMessage): StaffReply[];
+export interface NoticeTaskControls {
+    tasks: readonly BackgroundTask[];
+    decisions: Readonly<Record<string, TaskDecisionState>>;
+    decide: (taskId: string, approvalId: string, decision: TaskApprovalDecision) => void;
+    failureText: string;
+}
+/**
+ * Вид плашки. У `conversation_started` заголовок пустой: это указание агенту от приложения, человеку его не показывают.
+ * Кнопки решения — только пока задача в списке и ждёт ответа на вопрос этой плашки; после решения — отметка.
+ */
+export declare function noticeViewOf(notice: AgentNotice, controls: NoticeTaskControls): AgentNoticeViewProps;
+/** Служебные сообщения короткими строками — для скина без `AgentNoticeView`. Указание агенту (`conversation_started`) не видно. */
+export declare function noticesAsText(notices: readonly AgentNotice[], labels: NoticeLabels): string;

package/dist/types/pause.d.ts

@@ -0,0 +1,2 @@
+/** Пауза, которую можно оборвать. Слушатель отмены снимается, когда пауза кончилась сама: на долгом сигнале они не копятся. */
+export declare function pause(ms: number, signal: AbortSignal): Promise<void>;

package/dist/types/server-refusal.d.ts

@@ -0,0 +1,16 @@
+import type { AppRefusalKind } from "./app-refusal.js";
+/**
+ * Отказ сервера 4xx с понятным человеку текстом. `final` — повтор того же запроса снова получит отказ.
+ * `kind` и `code` есть, когда отказало само приложение (`beforeTurn` или `resolveUser`).
+ */
+export interface ServerRefusal {
+    text: string;
+    final: boolean;
+    kind?: AppRefusalKind;
+    code?: string;
+}
+/**
+ * Текст отказа из тела 4xx: `{ error: "…" }` обёрток приложения или `{ error: { message: "…" } }`.
+ * `null` — не 4xx, вход истёк (401), тела нет, оно не JSON или текста в нём нет: показывается общая надпись.
+ */
+export declare function serverRefusalOf(response: Response): Promise<ServerRefusal | null>;