@xfey/tutti 0.1.126 → 0.1.128

package/README.md

@@ -1,5 +1,7 @@
 # server
 
+当前源码的[协作输出语言](../../docs/system/communication-language.md)由 Host 统一处理：migration `0023`、共享 prompt、Scratchpad／workflow／task 语言继承。通过 Host npm 包交付，需更新项目 Host 才会生效，不依赖 Web 或飞书端新增设置；对照模型的引用语言误判作为已知项保留，不宣称所有模型均稳定通过。
+
 ## 作用
 
 `apps/server` 是 Tutti 的项目 host service，也是机器级 Local Console 的进程入口。

package/dist/approvals/decision-command.d.ts

@@ -25,8 +25,8 @@ export declare function executeApprovalDecisionCommand(input: {
         state: "pending";
         request: {
             expires_at?: string;
-            task_id?: string;
             activity_ref?: string;
+            task_id?: string;
             reason?: string;
             file_change?: {
                 paths?: string[];
@@ -69,8 +69,8 @@ export declare function executeApprovalDecisionCommand(input: {
         state: "resolved";
         request: {
             expires_at?: string;
-            task_id?: string;
             activity_ref?: string;
+            task_id?: string;
             reason?: string;
             file_change?: {
                 paths?: string[];

package/dist/chat-assistant/diagnostics.d.ts

@@ -1,11 +1,17 @@
 import type { ProviderInvocationProgress } from "../providers/invocation-progress.js";
+import type { languageDiagnosticFields } from "../communication-language/index.js";
+import type { ChatFailureCode } from "./failures.js";
 export type ChatAssistantLogger = {
     info: (fields: Record<string, unknown>, message: string) => void;
     warn: (fields: Record<string, unknown>, message: string) => void;
 };
-type ChatAssistantProgress = ProviderInvocationProgress | {
-    stage: "queued" | "inspection_wait" | "model_requested" | "reply_persisted" | "failed" | "skipped";
-    reason_code?: "queue_full" | "stopping" | "context_unavailable" | "answer_failed" | "reply_failed";
+type ChatAssistantProgress = ProviderInvocationProgress | ({
+    stage: "language_context";
+} & ReturnType<typeof languageDiagnosticFields>) | {
+    stage: "queued" | "inspection_wait" | "model_requested" | "reply_persisted" | "notification_failed" | "failed" | "skipped";
+    reason_code?: "queue_full" | "stopping" | "context_unavailable" | "answer_failed" | "reply_failed" | "request_changed";
+    error_code?: ChatFailureCode;
+    diagnostic_id?: string;
     reference_source_count?: number;
 };
 export declare function createChatAssistantDiagnostics(options: {
@@ -13,6 +19,8 @@ export declare function createChatAssistantDiagnostics(options: {
     projectId: string;
     triggerMessageId: string;
     scope: string;
+    requestRef?: string;
+    attemptRef?: string;
 }): (event: ChatAssistantProgress) => void;
 export {};
 //# sourceMappingURL=diagnostics.d.ts.map

package/dist/chat-assistant/diagnostics.js

@@ -1,18 +1,21 @@
 import { createEventRef } from "@tutti/shared/ids";
 export function createChatAssistantDiagnostics(options) {
-    const requestRef = createEventRef();
+    const requestRef = options.requestRef ?? createEventRef();
     const started = performance.now();
     return (event) => {
         try {
             const fields = {
                 project_id: options.projectId,
                 chat_request_ref: requestRef,
+                ...(options.attemptRef === undefined ? {} : { attempt_ref: options.attemptRef }),
                 trigger_message_ref: options.triggerMessageId,
                 scope: options.scope,
                 elapsed_ms: Math.round(performance.now() - started),
                 ...event,
             };
-            if (event.stage === "failed" || event.stage === "provider_failed") {
+            if (event.stage === "failed" ||
+                event.stage === "provider_failed" ||
+                event.stage === "notification_failed") {
                 options.logger?.warn(fields, "Chat assistant progress");
             }
             else {

package/dist/chat-assistant/failures.d.ts

@@ -0,0 +1,27 @@
+import type { OperationFailure } from "@tutti/shared/schemas/api";
+declare const failures: {
+    readonly reference_authorization_required: readonly ["access", "none", "Authorize document access using the group card, then send your question again. Authorization does not restart this answer."];
+    readonly chat_queue_full: readonly ["capacity", "resend_request", "Tutti is busy answering other questions. Try again shortly."];
+    readonly chat_context_unavailable: readonly ["interrupted", "none", "This question's conversation is no longer available."];
+    readonly host_restarted: readonly ["interrupted", "resend_request", "The Host restarted before this answer was saved. Send your question again."];
+    readonly provider_not_configured: readonly ["configuration", "check_provider", "Ask the project owner to configure model access, then send your question again."];
+    readonly provider_auth_invalid: readonly ["access", "check_provider", "Model access could not be verified. Ask the project owner to check it."];
+    readonly provider_quota_or_billing_required: readonly ["access", "check_provider", "Model credit is unavailable. Ask the project owner to check the account."];
+    readonly provider_rate_limited: readonly ["capacity", "resend_request", "The model service is busy. Wait a moment, then send your question again."];
+    readonly provider_network_error: readonly ["dependency", "resend_request", "The model service could not be reached. Try again when the connection is available."];
+    readonly provider_model_unavailable: readonly ["configuration", "check_provider", "The selected model is unavailable. Ask the project owner to check model access."];
+    readonly provider_timeout: readonly ["dependency", "resend_request", "The model did not finish answering in time. You can send your question again."];
+    readonly provider_output_invalid: readonly ["dependency", "resend_request", "The model did not return a usable answer. You can send your question again."];
+    readonly provider_lifecycle_failed: readonly ["internal", "restart_host", "The model process could not close safely. Restart the Host before trying again."];
+    readonly chat_reply_persistence_failed: readonly ["internal", "contact_support", "The answer could not be saved. Check the Host diagnostics before trying again."];
+    readonly internal_error: readonly ["internal", "contact_support", "Tutti could not complete this read-only answer. Share the diagnostic ID if this persists."];
+};
+export type ChatFailureCode = keyof typeof failures;
+type ChatFailure = OperationFailure & {
+    code: ChatFailureCode;
+};
+export declare function chatFailure(code: ChatFailureCode, diagnosticId?: string): ChatFailure;
+export declare function chatFailureMessage(failure: OperationFailure): string;
+export declare function classifyChatFailure(error: unknown, diagnosticId: string): ChatFailure;
+export {};
+//# sourceMappingURL=failures.d.ts.map

package/dist/chat-assistant/failures.js

@@ -0,0 +1,102 @@
+import { createEventRef } from "@tutti/shared/ids";
+import { providerFailureCode } from "../providers/failure-classification.js";
+const failures = {
+    reference_authorization_required: [
+        "access",
+        "none",
+        "Authorize document access using the group card, then send your question again. Authorization does not restart this answer.",
+    ],
+    chat_queue_full: [
+        "capacity",
+        "resend_request",
+        "Tutti is busy answering other questions. Try again shortly.",
+    ],
+    chat_context_unavailable: [
+        "interrupted",
+        "none",
+        "This question's conversation is no longer available.",
+    ],
+    host_restarted: [
+        "interrupted",
+        "resend_request",
+        "The Host restarted before this answer was saved. Send your question again.",
+    ],
+    provider_not_configured: [
+        "configuration",
+        "check_provider",
+        "Ask the project owner to configure model access, then send your question again.",
+    ],
+    provider_auth_invalid: [
+        "access",
+        "check_provider",
+        "Model access could not be verified. Ask the project owner to check it.",
+    ],
+    provider_quota_or_billing_required: [
+        "access",
+        "check_provider",
+        "Model credit is unavailable. Ask the project owner to check the account.",
+    ],
+    provider_rate_limited: [
+        "capacity",
+        "resend_request",
+        "The model service is busy. Wait a moment, then send your question again.",
+    ],
+    provider_network_error: [
+        "dependency",
+        "resend_request",
+        "The model service could not be reached. Try again when the connection is available.",
+    ],
+    provider_model_unavailable: [
+        "configuration",
+        "check_provider",
+        "The selected model is unavailable. Ask the project owner to check model access.",
+    ],
+    provider_timeout: [
+        "dependency",
+        "resend_request",
+        "The model did not finish answering in time. You can send your question again.",
+    ],
+    provider_output_invalid: [
+        "dependency",
+        "resend_request",
+        "The model did not return a usable answer. You can send your question again.",
+    ],
+    provider_lifecycle_failed: [
+        "internal",
+        "restart_host",
+        "The model process could not close safely. Restart the Host before trying again.",
+    ],
+    chat_reply_persistence_failed: [
+        "internal",
+        "contact_support",
+        "The answer could not be saved. Check the Host diagnostics before trying again.",
+    ],
+    internal_error: [
+        "internal",
+        "contact_support",
+        "Tutti could not complete this read-only answer. Share the diagnostic ID if this persists.",
+    ],
+};
+export function chatFailure(code, diagnosticId = createEventRef()) {
+    const [category, recovery] = failures[code];
+    return { code, category, recovery, diagnostic_id: diagnosticId };
+}
+export function chatFailureMessage(failure) {
+    const entry = Object.hasOwn(failures, failure.code)
+        ? failures[failure.code]
+        : failures.internal_error;
+    return `${entry[2]} Diagnostic ID: ${failure.diagnostic_id}`;
+}
+// Allowlisted error facts only; neither error.message nor diagnostic callbacks
+// establish business truth. Unknown failures remain non-automatically-retryable.
+export function classifyChatFailure(error, diagnosticId) {
+    const value = typeof error === "object" && error !== null
+        ? error
+        : {};
+    const code = typeof value.code === "string" ? value.code : value.reason;
+    const mapped = typeof code === "string" && Object.hasOwn(failures, code)
+        ? code
+        : (providerFailureCode(error) ?? "internal_error");
+    return chatFailure(mapped, diagnosticId);
+}
+//# sourceMappingURL=failures.js.map

package/dist/chat-assistant/index.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectId } from "@tutti/shared/ids";
+import { type ProjectId } from "@tutti/shared/ids";
 import type { MessageProjection } from "@tutti/shared/schemas/api";
 import { type ChatAssistantLogger } from "./diagnostics.js";
 import type { ProviderInvocationProgressObserver } from "../providers/invocation-progress.js";
@@ -33,6 +33,7 @@ export type ReadOnlyChatAssistantEnqueueResult = {
     triggered: boolean;
 };
 export type ReadOnlyChatAssistantHandle = {
+    register: (tx: SqliteDatabase, message: MessageProjection) => void;
     enqueue: (input: ReadOnlyChatAssistantTriggerInput) => ReadOnlyChatAssistantEnqueueResult;
     waitForIdle: () => Promise<void>;
     stopAccepting: () => void;
@@ -62,16 +63,26 @@ export declare function isChatAssistantOutput(value: unknown): value is ChatAssi
 export declare function containsTuttiMention(value: string): boolean;
 export declare class ReadOnlyChatAssistant implements ReadOnlyChatAssistantHandle {
     private readonly options;
-    private readonly pending;
     private readonly idleWaiters;
     private active;
     private accepting;
     private readonly maxQueuedMentions;
+    private recoveryTimer;
+    private started;
+    private activeAttemptRef;
+    private storageFailureReported;
     constructor(options: ReadOnlyChatAssistantOptions);
+    /** Call once after Host recovery/transport wiring. No old messages are backfilled. */
+    start(): void;
+    register(tx: SqliteDatabase, message: MessageProjection): void;
+    private now;
+    private report;
     enqueue(input: ReadOnlyChatAssistantTriggerInput): ReadOnlyChatAssistantEnqueueResult;
     waitForIdle(): Promise<void>;
     stopAccepting(): void;
     private pump;
+    private reportStorageFailure;
+    private pumpNext;
     private resolveIdleIfNeeded;
     private buildMainChatContext;
     private buildClarificationRoundContext;
@@ -80,6 +91,7 @@ export declare class ReadOnlyChatAssistant implements ReadOnlyChatAssistantHandl
     private appendMainChatAssistantMessage;
     private appendClarificationRoundAssistantMessage;
     private appendAssistantMessageForTrigger;
+    private recordReply;
     private respond;
 }
 //# sourceMappingURL=index.d.ts.map