@xfey/tutti 0.1.113 → 0.1.115

package/dist/artifact-feedback/index.d.ts

@@ -1,4 +1,4 @@
-import { type ArtifactFeedbackCommand, type ArtifactFeedbackRef, type ArtifactSemanticSnapshot, type MessageProjection } from "@tutti/shared/schemas/api";
+import { type ArtifactFeedbackCommand, type ArtifactFeedbackRef, type ArtifactSemanticSnapshot } from "@tutti/shared/schemas/api";
 export declare class ArtifactFeedbackValidationError extends Error {
     constructor(message: string);
 }
@@ -14,6 +14,4 @@ export declare function createArtifactFeedbackMessage(options: {
 export declare function formatArtifactFeedbackForModel(ref: ArtifactFeedbackRef, options?: {
     maxChars?: number;
 }): string;
-export declare function messageTextForModel(message: MessageProjection): string;
-export declare function messageTextForTuttiMention(message: MessageProjection): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/artifact-feedback/index.js

@@ -61,8 +61,7 @@ export function normalizeArtifactFeedbackCommand(input) {
         annotations,
     };
     if (normalized.expected_preview_generation === "" ||
-        Buffer.byteLength(JSON.stringify(normalized), "utf8") >
-            ARTIFACT_FEEDBACK_MAX_SERIALIZED_BYTES) {
+        Buffer.byteLength(JSON.stringify(normalized), "utf8") > ARTIFACT_FEEDBACK_MAX_SERIALIZED_BYTES) {
         throw new ArtifactFeedbackValidationError("Artifact feedback payload is too large");
     }
     return normalized;
@@ -180,17 +179,4 @@ export function formatArtifactFeedbackForModel(ref, options = {}) {
     });
     return [header, ...(overall === undefined ? [] : [overall]), ...annotations].join("\n");
 }
-export function messageTextForModel(message) {
-    const feedback = message.refs?.artifact_feedback;
-    return feedback === undefined ? message.body : formatArtifactFeedbackForModel(feedback);
-}
-export function messageTextForTuttiMention(message) {
-    const feedback = message.refs?.artifact_feedback;
-    if (feedback === undefined) {
-        return message.body;
-    }
-    return [feedback.summary, ...feedback.annotations.map((annotation) => annotation.comment)]
-        .filter((value) => value !== undefined)
-        .join("\n");
-}
 //# sourceMappingURL=index.js.map

package/dist/chat-assistant/index.js

@@ -2,7 +2,7 @@ import { createChatAssistantDiagnostics } from "./diagnostics.js";
 import { createClarificationRoundAgentMessage, createMainChatAgentMessage, readClarificationRoundMessagesWindow, readClarificationRoundProjection, readMainChatMessageWindow, readMainChatMessagesBeforeCursor, readMessageProjectionById, } from "../collaboration-state/index.js";
 import { renderPromptTemplate } from "../prompt-templates/index.js";
 import { withHostStoreTransaction, } from "../store/index.js";
-import { messageTextForModel, messageTextForTuttiMention } from "../artifact-feedback/index.js";
+import { messageTextForModel, messageTextForTuttiMention, } from "../collaboration-state/message-context.js";
 import { externalReferenceMessageContext } from "../reference-access/message-context.js";
 import { readExternalReferenceReadSources } from "../reference-access/read-evidence.js";
 const CHAT_ASSISTANT_CONTEXT_MESSAGE_LIMIT = 3;

package/dist/collaboration-ingestion/external-source.d.ts

@@ -12,6 +12,9 @@ export type IngestTrustedConversationSourceOptions = {
     scratchpadSource?: ScratchpadSourceNotifier;
     chatAssistant?: ChatAssistantEnqueuer;
     now?: () => Date;
+    logger?: {
+        info: (fields: Record<string, unknown>, message: string) => void;
+    };
 };
 export declare function ingestTrustedConversationSource(options: IngestTrustedConversationSourceOptions): IntegrationDeliveryDisposition;
 //# sourceMappingURL=external-source.d.ts.map

package/dist/collaboration-ingestion/external-source.js

@@ -2,6 +2,7 @@ import { createHash } from "node:crypto";
 import { INTEGRATION_CONVERSATION_SOURCE_TUNNEL_PATH, isTrustedConversationSourceIngestionCommand, } from "@tutti/shared/schemas/internal";
 import { ingestMainChatMessage } from "./main-chat.js";
 import { ingestClarificationMessage } from "./clarification.js";
+import { captureReplyContext } from "./reply-context.js";
 export const TRUSTED_INTEGRATION_INGESTION_PATH = INTEGRATION_CONVERSATION_SOURCE_TUNNEL_PATH;
 function sha256Text(value) {
     return `sha256:${createHash("sha256").update(value, "utf8").digest("hex")}`;
@@ -122,13 +123,23 @@ export function ingestTrustedConversationSource(options) {
             account_ref: options.command.actor.account_ref,
             display_name: options.command.actor.display_name,
         },
-        materialize: () => ({
-            kind: "message",
-            body: source.content.text,
-            ...(source.external_references === undefined
-                ? {}
-                : { refs: { external_references: source.external_references } }),
-        }),
+        materialize: () => {
+            const reply = captureReplyContext(options.store.db, options.command);
+            return {
+                kind: "message",
+                body: source.content.text,
+                ...(source.external_references === undefined && reply === undefined
+                    ? {}
+                    : {
+                        refs: {
+                            ...(source.external_references === undefined
+                                ? {}
+                                : { external_references: source.external_references }),
+                            ...(reply === undefined ? {} : { reply_context: reply }),
+                        },
+                    }),
+            };
+        },
         idempotencyContext: {
             kind: "external_conversation_source",
             platform: source.locator.conversation.installation.platform,
@@ -159,6 +170,21 @@ export function ingestTrustedConversationSource(options) {
         return { kind: "invalid", reason_code: "main_chat_ingestion_rejected" };
     }
     const messageId = response.disposition.message_id ?? response.result?.message.id;
+    try {
+        options.logger?.info({
+            stage: "integration_source_accepted",
+            command_id: options.command.command_id,
+            receipt_key: options.command.receipt.receipt_key,
+            binding_ref: options.command.binding_ref,
+            message_id: messageId,
+            adapter_version: source.adapter_version,
+            reply_resolution: response.result?.message.refs?.reply_context?.status ?? "none",
+            reference_count: source.external_references?.length ?? 0,
+        }, "Integration conversation source accepted");
+    }
+    catch {
+        /* Logging must not turn a committed source into a failed delivery. */
+    }
     return messageId === undefined
         ? { kind: "invalid", reason_code: "message_identity_missing" }
         : { kind: "created", message_id: messageId };

package/dist/collaboration-ingestion/reply-context.d.ts

@@ -0,0 +1,10 @@
+import type { MessageProjection } from "@tutti/shared/schemas/api";
+import type { TrustedConversationSourceIngestionCommand } from "@tutti/shared/schemas/internal";
+import type { SqliteDatabase } from "../store/index.js";
+type ReplyContext = NonNullable<NonNullable<MessageProjection["refs"]>["reply_context"]>;
+/** Capture only an already observed direct parent in this exact binding.
+ * No root/thread guessing, remote history request, recursive quote or late backfill.
+ */
+export declare function captureReplyContext(db: SqliteDatabase, command: TrustedConversationSourceIngestionCommand): ReplyContext | undefined;
+export {};
+//# sourceMappingURL=reply-context.d.ts.map

package/dist/collaboration-ingestion/reply-context.js

@@ -0,0 +1,43 @@
+import { redactText } from "@tutti/shared/utils";
+import { readMessageProjectionById } from "../collaboration-state/index.js";
+import { externalReferenceMessageContext } from "../reference-access/message-context.js";
+/** Capture only an already observed direct parent in this exact binding.
+ * No root/thread guessing, remote history request, recursive quote or late backfill.
+ */
+export function captureReplyContext(db, command) {
+    const conversation = command.source.locator.conversation;
+    if (conversation.parent_message_ref === undefined)
+        return undefined;
+    const row = db
+        .prepare(`
+    SELECT message_id FROM external_source_mappings
+    WHERE platform = ? AND installation_ref = ? AND conversation_ref = ?
+      AND binding_ref = ? AND external_message_ref = ?
+  `)
+        .get(conversation.installation.platform, conversation.installation.installation_ref, conversation.conversation_ref, command.binding_ref, conversation.parent_message_ref);
+    const parent = row === undefined ? null : readMessageProjectionById(db, row.message_id);
+    if (parent === null || parent.scope.kind !== "main_chat")
+        return { status: "unavailable", reason_code: "parent_not_observed_in_binding" };
+    const text = redactText(parent.body);
+    return {
+        status: "resolved",
+        message_id: parent.id,
+        role: parent.refs?.development_operator === true
+            ? "operator"
+            : parent.author.kind === "agent"
+                ? "tutti"
+                : parent.author.kind,
+        text: text.slice(0, 2_000),
+        truncated: text.length > 2_000,
+        // Do not recursively inherit an ancestor's hints from a reply to another reply.
+        external_reference_sources: externalReferenceMessageContext({
+            ...(parent.refs?.external_references === undefined
+                ? {}
+                : { external_references: parent.refs.external_references }),
+            ...(parent.refs?.external_reference_reads === undefined
+                ? {}
+                : { external_reference_reads: parent.refs.external_reference_reads }),
+        }).external_reference_sources ?? [],
+    };
+}
+//# sourceMappingURL=reply-context.js.map

package/dist/collaboration-state/clarification-snapshot.d.ts

@@ -160,6 +160,17 @@ export declare function readSubmittedClarificationMessages(db: SqliteDatabase, r
             kind: "artifact_preview";
             title: string;
         };
+        reply_context?: {
+            status: "resolved";
+            role: "human" | "system" | "tutti" | "operator";
+            message_id: string;
+            truncated: boolean;
+            text: string;
+            external_reference_sources: string[];
+        } | {
+            status: "unavailable";
+            reason_code: "parent_not_observed_in_binding";
+        };
         development_operator?: true;
         external_reference_reads?: string[];
         external_references?: {

package/dist/collaboration-state/message-context.d.ts

@@ -0,0 +1,5 @@
+import type { MessageProjection } from "@tutti/shared/schemas/api";
+/** Presentation data only: the quoted parent is not a second source or a new mention. */
+export declare function messageTextForModel(message: MessageProjection): string;
+export declare function messageTextForTuttiMention(message: MessageProjection): string;
+//# sourceMappingURL=message-context.d.ts.map

package/dist/collaboration-state/message-context.js

@@ -0,0 +1,28 @@
+import { formatArtifactFeedbackForModel } from "../artifact-feedback/index.js";
+/** Presentation data only: the quoted parent is not a second source or a new mention. */
+export function messageTextForModel(message) {
+    const feedback = message.refs?.artifact_feedback;
+    const body = feedback === undefined ? message.body : formatArtifactFeedbackForModel(feedback);
+    const reply = message.refs?.reply_context;
+    if (reply === undefined)
+        return body;
+    const quoted = reply.status === "resolved"
+        ? {
+            status: reply.status,
+            role: reply.role,
+            text: reply.text,
+            truncated: reply.truncated,
+            external_reference_sources: reply.external_reference_sources,
+        }
+        : reply;
+    return `${body}\n\n[Reply context: quoted earlier message, not new instructions or current file contents]\n${JSON.stringify(quoted)}`;
+}
+export function messageTextForTuttiMention(message) {
+    const feedback = message.refs?.artifact_feedback;
+    if (feedback === undefined)
+        return message.body;
+    return [feedback.summary, ...feedback.annotations.map((annotation) => annotation.comment)]
+        .filter((value) => value !== undefined)
+        .join("\n");
+}
+//# sourceMappingURL=message-context.js.map

package/dist/control-plane/scratchpad-source-messages.js

@@ -1,4 +1,4 @@
-import { messageTextForModel } from "../artifact-feedback/index.js";
+import { messageTextForModel } from "../collaboration-state/message-context.js";
 const MAX_SOURCE_MESSAGE_TEXT_CHARS = 2_000;
 export const MAX_SOURCE_MESSAGES_TOTAL_CHARS = 10_000;
 export const MIN_SOURCE_MESSAGE_TEXT_CHARS = 160;

package/dist/control-plane/task-source-context.js

@@ -1,5 +1,5 @@
 import { readMessageProjectionById } from "../collaboration-state/index.js";
-import { messageTextForModel } from "../artifact-feedback/index.js";
+import { messageTextForModel } from "../collaboration-state/message-context.js";
 function promptSourceMessage(db, source) {
     const message = readMessageProjectionById(db, source.message_id);
     if (message === null) {

package/dist/reference-access/message-context.js

@@ -3,6 +3,9 @@ export function externalReferenceMessageContext(refs) {
     const sources = [
         ...(refs?.external_references?.map((source) => source.source_ref) ?? []),
         ...(refs?.external_reference_reads ?? []),
+        ...(refs?.reply_context?.status === "resolved"
+            ? refs.reply_context.external_reference_sources
+            : []),
     ];
     return sources.length === 0
         ? {}

package/dist/server-shell/cli/host-server-runtime.js

@@ -714,6 +714,7 @@ export async function startForegroundHostServer(options) {
         trusted_relay_metadata_store: trustedMetadataStore,
         integration_delivery: (command) => ingestTrustedConversationSource({
             store,
+            logger: app.log,
             controlPlane,
             events: workspaceEvents,
             command,

package/dist/server-shell/cli/relay-registration.js

@@ -39,6 +39,7 @@ export async function registerHostWithRelay(options) {
             integration_source_ingestion_v1: true,
             integration_development_bot_v1: true,
             integration_clarification_v1: true,
+            feishu_supporting_reads_v1: true,
             integration_external_references_v1: true,
             integration_attachment_ingestion_v1: true,
             integration_managed_reference_ingestion_v1: true,

package/dist/server-shell/http/routes/agent-context-messages-routes.js

@@ -1,4 +1,5 @@
 import { readMainChatMessageWindow } from "../../../collaboration-state/index.js";
+import { messageTextForModel } from "../../../collaboration-state/message-context.js";
 import { externalReferenceMessageContext } from "../../../reference-access/message-context.js";
 import { authorizeAgentContextRequest } from "./agent-context-auth.js";
 import { AgentContextBadRequestError } from "./agent-context-errors.js";
@@ -35,7 +36,7 @@ export function registerAgentContextMessageRoutes(app, options) {
         return {
             scope: "main_chat",
             items: window.items.map((message) => {
-                const body = truncateText(message.body, MESSAGE_BODY_MAX_CHARS);
+                const body = truncateText(messageTextForModel(message), MESSAGE_BODY_MAX_CHARS);
                 return {
                     message_id: message.id,
                     created_at: message.created_at,

package/dist/server-shell/http/routes/agent-context-skills-routes.js

@@ -1,5 +1,5 @@
 import { redactText } from "@tutti/shared/utils";
-import { listUserSkills, readUserSkill, SkillServiceError, } from "../../../skills/index.js";
+import { listUserSkills, readUserSkill, SkillServiceError } from "../../../skills/index.js";
 import { authorizeAgentContextRequest } from "./agent-context-auth.js";
 import { AgentContextBadRequestError } from "./agent-context-errors.js";
 import { boundedLimit, pageByOffset, queryString, truncateText } from "./agent-context-query.js";
@@ -23,6 +23,7 @@ function handleSkillReadError(error, skillName) {
         case "validation_failed":
             return skillUnavailable({ skillName, reason: "invalid" });
         case "filesystem_error":
+        case "read_limit_exceeded":
             return skillUnavailable({ skillName, reason: "unavailable" });
         case "invalid_zip":
             return skillUnavailable({ skillName, reason: "invalid" });

package/dist/server-shell/http/routes/project-api/openapi-skills-routes.d.ts

@@ -17,6 +17,17 @@ export declare const HOST_PROJECT_SKILLS_OPENAPI_ROUTES: ({
                 }>>;
             }>;
         };
+        413: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                error: import("@sinclair/typebox").TObject<{
+                    code: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"bad_request">, import("@sinclair/typebox").TLiteral<"unauthorized">, import("@sinclair/typebox").TLiteral<"forbidden">, import("@sinclair/typebox").TLiteral<"not_found">, import("@sinclair/typebox").TLiteral<"conflict">, import("@sinclair/typebox").TLiteral<"validation_failed">, import("@sinclair/typebox").TLiteral<"provider_not_configured">, import("@sinclair/typebox").TLiteral<"provider_auth_invalid">, import("@sinclair/typebox").TLiteral<"provider_quota_or_billing_required">, import("@sinclair/typebox").TLiteral<"provider_rate_limited">, import("@sinclair/typebox").TLiteral<"provider_model_unavailable">, import("@sinclair/typebox").TLiteral<"provider_network_error">, import("@sinclair/typebox").TLiteral<"relay_session_invalid">, import("@sinclair/typebox").TLiteral<"project_membership_required">, import("@sinclair/typebox").TLiteral<"command_replay_mismatch">, import("@sinclair/typebox").TLiteral<"repo_snapshot_unavailable">, import("@sinclair/typebox").TLiteral<"host_unavailable">, import("@sinclair/typebox").TLiteral<"skill_read_limit_exceeded">, import("@sinclair/typebox").TLiteral<"internal_error">]>;
+                    message: import("@sinclair/typebox").TString;
+                    retryable: import("@sinclair/typebox").TBoolean;
+                    details: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+                }>;
+            }>;
+        };
     };
     parameters?: never;
     requestBody?: never;
@@ -41,6 +52,17 @@ export declare const HOST_PROJECT_SKILLS_OPENAPI_ROUTES: ({
                 }>;
             }>;
         };
+        413: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                error: import("@sinclair/typebox").TObject<{
+                    code: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"bad_request">, import("@sinclair/typebox").TLiteral<"unauthorized">, import("@sinclair/typebox").TLiteral<"forbidden">, import("@sinclair/typebox").TLiteral<"not_found">, import("@sinclair/typebox").TLiteral<"conflict">, import("@sinclair/typebox").TLiteral<"validation_failed">, import("@sinclair/typebox").TLiteral<"provider_not_configured">, import("@sinclair/typebox").TLiteral<"provider_auth_invalid">, import("@sinclair/typebox").TLiteral<"provider_quota_or_billing_required">, import("@sinclair/typebox").TLiteral<"provider_rate_limited">, import("@sinclair/typebox").TLiteral<"provider_model_unavailable">, import("@sinclair/typebox").TLiteral<"provider_network_error">, import("@sinclair/typebox").TLiteral<"relay_session_invalid">, import("@sinclair/typebox").TLiteral<"project_membership_required">, import("@sinclair/typebox").TLiteral<"command_replay_mismatch">, import("@sinclair/typebox").TLiteral<"repo_snapshot_unavailable">, import("@sinclair/typebox").TLiteral<"host_unavailable">, import("@sinclair/typebox").TLiteral<"skill_read_limit_exceeded">, import("@sinclair/typebox").TLiteral<"internal_error">]>;
+                    message: import("@sinclair/typebox").TString;
+                    retryable: import("@sinclair/typebox").TBoolean;
+                    details: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+                }>;
+            }>;
+        };
     };
     requestBody?: never;
 } | {
@@ -54,6 +76,7 @@ export declare const HOST_PROJECT_SKILLS_OPENAPI_ROUTES: ({
             description: string;
             schema: import("@sinclair/typebox").TSchema;
         };
+        413?: never;
     };
     parameters?: never;
 })[];

package/dist/server-shell/http/routes/project-api/openapi-skills-routes.js

@@ -1,4 +1,4 @@
-import { DeleteSkillBodySchema, DeleteSkillResponseSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipResponseSchema, } from "@tutti/shared/schemas/api";
+import { ApiErrorResponseSchema, DeleteSkillBodySchema, DeleteSkillResponseSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipResponseSchema, } from "@tutti/shared/schemas/api";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { SkillNamePathParameter } from "./openapi-path-parameters.js";
 export const HOST_PROJECT_SKILLS_OPENAPI_ROUTES = [
@@ -9,6 +9,10 @@ export const HOST_PROJECT_SKILLS_OPENAPI_ROUTES = [
         tags: ["skills"],
         responses: {
             200: { description: "User skills projection.", schema: GetSkillsResponseSchema },
+            413: {
+                description: "Feishu preview list budget exceeded; no partial list.",
+                schema: ApiErrorResponseSchema,
+            },
         },
     },
     {
@@ -19,6 +23,10 @@ export const HOST_PROJECT_SKILLS_OPENAPI_ROUTES = [
         parameters: [SkillNamePathParameter],
         responses: {
             200: { description: "User skill detail projection.", schema: GetSkillResponseSchema },
+            413: {
+                description: "Skill read budget exceeded; no truncated skill.",
+                schema: ApiErrorResponseSchema,
+            },
         },
     },
     {

package/dist/server-shell/http/routes/project-api/openapi.d.ts

@@ -885,6 +885,17 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                 }>>;
             }>;
         };
+        413: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                error: import("@sinclair/typebox").TObject<{
+                    code: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"bad_request">, import("@sinclair/typebox").TLiteral<"unauthorized">, import("@sinclair/typebox").TLiteral<"forbidden">, import("@sinclair/typebox").TLiteral<"not_found">, import("@sinclair/typebox").TLiteral<"conflict">, import("@sinclair/typebox").TLiteral<"validation_failed">, import("@sinclair/typebox").TLiteral<"provider_not_configured">, import("@sinclair/typebox").TLiteral<"provider_auth_invalid">, import("@sinclair/typebox").TLiteral<"provider_quota_or_billing_required">, import("@sinclair/typebox").TLiteral<"provider_rate_limited">, import("@sinclair/typebox").TLiteral<"provider_model_unavailable">, import("@sinclair/typebox").TLiteral<"provider_network_error">, import("@sinclair/typebox").TLiteral<"relay_session_invalid">, import("@sinclair/typebox").TLiteral<"project_membership_required">, import("@sinclair/typebox").TLiteral<"command_replay_mismatch">, import("@sinclair/typebox").TLiteral<"repo_snapshot_unavailable">, import("@sinclair/typebox").TLiteral<"host_unavailable">, import("@sinclair/typebox").TLiteral<"skill_read_limit_exceeded">, import("@sinclair/typebox").TLiteral<"internal_error">]>;
+                    message: import("@sinclair/typebox").TString;
+                    retryable: import("@sinclair/typebox").TBoolean;
+                    details: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+                }>;
+            }>;
+        };
     };
     parameters?: never;
     requestBody?: never;
@@ -909,6 +920,17 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                 }>;
             }>;
         };
+        413: {
+            description: string;
+            schema: import("@sinclair/typebox").TObject<{
+                error: import("@sinclair/typebox").TObject<{
+                    code: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"bad_request">, import("@sinclair/typebox").TLiteral<"unauthorized">, import("@sinclair/typebox").TLiteral<"forbidden">, import("@sinclair/typebox").TLiteral<"not_found">, import("@sinclair/typebox").TLiteral<"conflict">, import("@sinclair/typebox").TLiteral<"validation_failed">, import("@sinclair/typebox").TLiteral<"provider_not_configured">, import("@sinclair/typebox").TLiteral<"provider_auth_invalid">, import("@sinclair/typebox").TLiteral<"provider_quota_or_billing_required">, import("@sinclair/typebox").TLiteral<"provider_rate_limited">, import("@sinclair/typebox").TLiteral<"provider_model_unavailable">, import("@sinclair/typebox").TLiteral<"provider_network_error">, import("@sinclair/typebox").TLiteral<"relay_session_invalid">, import("@sinclair/typebox").TLiteral<"project_membership_required">, import("@sinclair/typebox").TLiteral<"command_replay_mismatch">, import("@sinclair/typebox").TLiteral<"repo_snapshot_unavailable">, import("@sinclair/typebox").TLiteral<"host_unavailable">, import("@sinclair/typebox").TLiteral<"skill_read_limit_exceeded">, import("@sinclair/typebox").TLiteral<"internal_error">]>;
+                    message: import("@sinclair/typebox").TString;
+                    retryable: import("@sinclair/typebox").TBoolean;
+                    details: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+                }>;
+            }>;
+        };
     };
     requestBody?: never;
 } | {

package/dist/server-shell/http/routes/project-api/project-timeline-projection.js

@@ -1,3 +1,5 @@
+import { clarificationAnswerRole } from "@tutti/shared/utils";
+import { readSubmittedClarificationMessages } from "../../../../collaboration-state/index.js";
 import { readProviderUsageBreakdownForAnchors, readProviderUsageModelSummariesForAnchors, readProviderUsageProjection, readProviderUsageSourceSummariesForAnchors, } from "../../../../provider-usage/index.js";
 import { runGitRaw } from "../../../../workspace-ops/git.js";
 const TIMELINE_LIMIT = 50;
@@ -178,34 +180,24 @@ function clarificationChatLink(messageId) {
         message_id: messageId,
     };
 }
-function readClarificationAnswerSnippets(db, submittedRefsJson) {
-    const submittedRefs = parseJsonStringArray(submittedRefsJson);
-    if (submittedRefs.length === 0) {
-        return { answer_count: 0, answers: [] };
-    }
-    const readMessage = db.prepare(`
-      SELECT
-        id AS message_id,
-        author_kind,
-        author_display_name,
-        body,
-        created_at
-      FROM messages
-      WHERE id = ?
-        AND message_kind = 'user_text'
-        AND author_kind = 'human'
-      LIMIT 1
-    `);
-    const answers = submittedRefs.flatMap((messageId) => {
-        const row = readMessage.get(messageId);
-        return row === undefined ? [] : [row];
+function readClarificationAnswerSnippets(db, roundId) {
+    const answers = readSubmittedClarificationMessages(db, roundId).filter((message) => clarificationAnswerRole(message) !== null);
+    const visibleAnswers = answers.slice(0, TRACE_SOURCE_SNIPPET_LIMIT).map((answer) => {
+        let author = authorLabel({
+            author_kind: answer.author.kind,
+            author_display_name: answer.author.display_name ?? null,
+        });
+        if (clarificationAnswerRole(answer) === "operator") {
+            const displayName = answer.author.display_name?.trim();
+            author = displayName ? `${displayName} (operator)` : "Development operator";
+        }
+        return {
+            message_id: answer.id,
+            author,
+            body: truncateSnippetBody(answer.body),
+            created_at: answer.created_at,
+        };
     });
-    const visibleAnswers = answers.slice(0, TRACE_SOURCE_SNIPPET_LIMIT).map((answer) => ({
-        message_id: answer.message_id,
-        author: authorLabel(answer),
-        body: truncateSnippetBody(answer.body),
-        created_at: answer.created_at,
-    }));
     return {
         answer_count: answers.length,
         answers: visibleAnswers,
@@ -213,7 +205,7 @@ function readClarificationAnswerSnippets(db, submittedRefsJson) {
 }
 function clarificationTraceFromRow(db, row) {
     const payload = parseJsonObject(row.request_payload_json);
-    const answers = readClarificationAnswerSnippets(db, row.submitted_message_refs_json);
+    const answers = readClarificationAnswerSnippets(db, row.round_id);
     const visibleAnswers = answers.answers;
     const title = stringValue(payload, "title");
     const summary = stringValue(payload, "summary");
@@ -247,7 +239,6 @@ function readLatestTaskCompileClarificationTrace(db, workflowRef) {
           clarification_rounds.status AS round_status,
           clarification_rounds.request_payload_json,
           clarification_rounds.card_message_id,
-          clarification_rounds.submitted_message_refs_json,
           clarification_rounds.submitted_at,
           clarification_rounds.updated_at
         FROM clarification_rounds
@@ -273,7 +264,6 @@ function readLatestClarificationTraceByThread(db, threadId) {
           clarification_rounds.status AS round_status,
           clarification_rounds.request_payload_json,
           clarification_rounds.card_message_id,
-          clarification_rounds.submitted_message_refs_json,
           clarification_rounds.submitted_at,
           clarification_rounds.updated_at
         FROM clarification_threads
@@ -302,7 +292,6 @@ function readLatestResolvedTaskClarificationTrace(db, taskId, throughCreatedAt)
           clarification_rounds.status AS round_status,
           clarification_rounds.request_payload_json,
           clarification_rounds.card_message_id,
-          clarification_rounds.submitted_message_refs_json,
           clarification_rounds.submitted_at,
           clarification_rounds.updated_at
         FROM clarification_rounds
@@ -533,7 +522,10 @@ function readPromotedCommitChanges(workspaceRoot, commitOid) {
     if (result.status !== 0) {
         return undefined;
     }
-    const fields = result.stdout.toString("utf8").split("\0").filter((field) => field !== "");
+    const fields = result.stdout
+        .toString("utf8")
+        .split("\0")
+        .filter((field) => field !== "");
     const changes = [];
     for (let index = 0; index < fields.length;) {
         const status = fields[index];
@@ -843,7 +835,9 @@ export function readProjectTimelineProjection(input) {
     ].sort(compareTimelineItemsByTimeDesc);
     return {
         generated_at: now().toISOString(),
-        usage_overview: input.db === undefined ? emptyUsageOverview() : readProviderUsageProjection(input.db, { now }),
+        usage_overview: input.db === undefined
+            ? emptyUsageOverview()
+            : readProviderUsageProjection(input.db, { now }),
         items: items.slice(0, TIMELINE_LIMIT),
     };
 }

package/dist/server-shell/http/routes/project-api/skills-helpers.js

@@ -1,5 +1,12 @@
 import { getProjectUserSkillsRoot, SkillServiceError } from "../../../../skills/index.js";
 import { HostProjectBadRequestError, HostProjectNotFoundError, HostProjectStoreUnavailableError, HostProjectValidationError, } from "./errors.js";
+class HostSkillReadLimitError extends Error {
+    statusCode = 413;
+    code = "skill_read_limit_exceeded";
+    constructor() {
+        super("Skill read exceeds the supported limit");
+    }
+}
 export function skillsChangedInvalidates() {
     return [{ kind: "skills" }, { kind: "read_state" }, { kind: "bootstrap" }];
 }
@@ -24,6 +31,8 @@ function toHostProjectSkillError(error) {
             return new HostProjectValidationError(error.message);
         case "filesystem_error":
             return new HostProjectStoreUnavailableError();
+        case "read_limit_exceeded":
+            return new HostSkillReadLimitError();
     }
 }
 export async function withAsyncSkillServiceErrorMapping(fn) {

package/dist/server-shell/http/routes/project-api/skills-routes.js

@@ -14,9 +14,11 @@ export function registerSkillRoutes(app, { options, workspaceEvents, }) {
             },
         },
     }, (request) => {
-        requireHostProjectSession(request, options);
+        const session = requireHostProjectSession(request, options);
         return withSkillServiceErrorMapping(() => ({
-            items: listUserSkills(requireProjectUserSkillsRoot(options)),
+            items: listUserSkills(requireProjectUserSkillsRoot(options), {
+                mode: session.client_session.transport === "feishu_platform_session" ? "preview" : "full",
+            }),
         }));
     });
     app.get(`${HOST_PROJECT_API_BASE_PATH}/skills/:skillName`, {
@@ -26,9 +28,11 @@ export function registerSkillRoutes(app, { options, workspaceEvents, }) {
             },
         },
     }, (request) => {
-        requireHostProjectSession(request, options);
+        const session = requireHostProjectSession(request, options);
         return withSkillServiceErrorMapping(() => ({
-            skill: readUserSkill(requireProjectUserSkillsRoot(options), request.params.skillName),
+            skill: readUserSkill(requireProjectUserSkillsRoot(options), request.params.skillName, {
+                mode: session.client_session.transport === "feishu_platform_session" ? "preview" : "full",
+            }),
         }));
     });
     app.post(`${HOST_PROJECT_API_BASE_PATH}/skills/import`, {

package/dist/server-shell/http/validation.js

@@ -17,6 +17,7 @@ const API_ERROR_CODES = new Set([
     "command_replay_mismatch",
     "repo_snapshot_unavailable",
     "host_unavailable",
+    "skill_read_limit_exceeded",
     "internal_error",
 ]);
 function isApiErrorCode(value) {

package/dist/skills/constants.d.ts

@@ -5,4 +5,9 @@ export declare const MAX_SKILL_TOTAL_UNCOMPRESSED_BYTES: number;
 export declare const MAX_SKILL_FILE_BYTES: number;
 export declare const MAX_SKILL_FILE_COUNT = 1000;
 export declare const MAX_SKILL_DIRECTORY_DEPTH = 24;
+export declare const MAX_SKILL_PREVIEW_BYTES: number;
+export declare const MAX_SKILL_PREVIEW_METADATA_BYTES: number;
+export declare const MAX_SKILL_PREVIEW_SCAN_ENTRIES = 512;
+export declare const MAX_SKILL_PREVIEW_ITEMS = 256;
+export declare const MAX_SKILL_PREVIEW_LIST_BYTES: number;
 //# sourceMappingURL=constants.d.ts.map

package/dist/skills/constants.js

@@ -6,4 +6,10 @@ export const MAX_SKILL_TOTAL_UNCOMPRESSED_BYTES = 200 * 1024 * 1024;
 export const MAX_SKILL_FILE_BYTES = 50 * 1024 * 1024;
 export const MAX_SKILL_FILE_COUNT = 1_000;
 export const MAX_SKILL_DIRECTORY_DEPTH = 24;
+// Browser preview budgets are independent of the full skill used by the runtime.
+export const MAX_SKILL_PREVIEW_BYTES = 200 * 1024;
+export const MAX_SKILL_PREVIEW_METADATA_BYTES = 32 * 1024;
+export const MAX_SKILL_PREVIEW_SCAN_ENTRIES = 512;
+export const MAX_SKILL_PREVIEW_ITEMS = 256;
+export const MAX_SKILL_PREVIEW_LIST_BYTES = 512 * 1024;
 //# sourceMappingURL=constants.js.map

package/dist/skills/errors.d.ts

@@ -1,4 +1,4 @@
-export type SkillServiceErrorCode = "invalid_skill_name" | "skill_not_found" | "invalid_zip" | "validation_failed" | "filesystem_error";
+export type SkillServiceErrorCode = "invalid_skill_name" | "skill_not_found" | "invalid_zip" | "validation_failed" | "read_limit_exceeded" | "filesystem_error";
 export declare class SkillServiceError extends Error {
     readonly code: SkillServiceErrorCode;
     constructor(code: SkillServiceErrorCode, message: string);