@xfey/tutti 0.1.102 → 0.1.104

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

@@ -1,9 +1,8 @@
 import { GetMessagesRequestSchema, MessageWindowSchema, SendMainChatMessageBodySchema, SendMainChatMessageResponseSchema, } from "@tutti/shared/schemas/api";
-import { createMainChatMessage, readMessageProjectionById, readMainChatMessageWindow, } from "../../../../collaboration-state/index.js";
-import { createArtifactFeedbackMessage, } from "../../../../artifact-feedback/index.js";
-import { executeIdempotentCommand } from "../../../command-idempotency/index.js";
+import { createArtifactFeedbackMessage } from "../../../../artifact-feedback/index.js";
+import { ingestMainChatMessage } from "../../../../collaboration-ingestion/index.js";
+import { readMainChatMessageWindow } from "../../../../collaboration-state/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
-import { mainChatMessageInvalidates } from "./invalidations.js";
 import { requireValidMessageWindowRequest, requireValidSendMainChatPayload, } from "./payload-validation.js";
 import { requireHostProjectSession, requireProjectStore, requireWorkspaceRoot, } from "./session-requirements.js";
 export function registerMessagesRoutes(app, { options, workspaceEvents, artifactPreviewManager, }) {
@@ -30,83 +29,53 @@ export function registerMessagesRoutes(app, { options, workspaceEvents, artifact
         const session = requireHostProjectSession(request, options);
         const store = requireProjectStore(options);
         const payload = requireValidSendMainChatPayload(request.body.payload);
-        const execution = executeIdempotentCommand({
-            db: store.db,
-            command_id: request.body.command_id,
-            command_name: "messages.create",
-            target_ref: "main_chat",
-            payload: { ...payload, author_ref: session.account.account_ref },
+        return ingestMainChatMessage({
+            store,
+            events: workspaceEvents,
+            commandId: request.body.command_id,
+            payload,
+            author: session.account,
             ...(options.now === undefined ? {} : { now: options.now }),
-            execute: (tx) => {
-                let body;
-                let refs;
+            materialize: () => {
                 if ("artifact_feedback" in payload) {
                     const projection = artifactPreviewManager.readProjection({
                         workspaceRoot: requireWorkspaceRoot(options),
                     });
                     if (projection.artifact.status !== "declared" ||
                         projection.artifact.preview.status !== "ready") {
-                        return { disposition: { kind: "artifact_unavailable" } };
+                        return {
+                            kind: "rejected",
+                            disposition: { kind: "artifact_unavailable" },
+                        };
                     }
                     if (projection.artifact.preview_generation !==
                         payload.artifact_feedback.expected_preview_generation) {
-                        return { disposition: { kind: "artifact_changed" } };
+                        return {
+                            kind: "rejected",
+                            disposition: { kind: "artifact_changed" },
+                        };
                     }
                     const feedbackMessage = createArtifactFeedbackMessage({
                         artifactTitle: projection.artifact.artifact.title,
                         feedback: payload.artifact_feedback,
                     });
-                    body = feedbackMessage.body;
-                    refs = { artifact_feedback: feedbackMessage.ref };
+                    return {
+                        kind: "message",
+                        body: feedbackMessage.body,
+                        refs: { artifact_feedback: feedbackMessage.ref },
+                    };
                 }
-                else {
-                    body = payload.body;
-                }
-                const message = createMainChatMessage(tx, {
-                    body,
-                    author: {
-                        kind: "human",
-                        ref: session.account.account_ref,
-                        display_name: session.account.display_name,
-                        avatar: session.account.avatar,
-                    },
-                    ...(refs === undefined ? {} : { refs }),
-                    ...(options.now === undefined ? {} : { now: options.now }),
-                });
-                return {
-                    disposition: { kind: "created", message_id: message.id },
-                    result: { message },
-                };
+                return { kind: "message", body: payload.body };
             },
+            ...(options.controlPlane === undefined
+                ? {}
+                : {
+                    scratchpadSource: {
+                        notify: (message) => options.controlPlane?.notifyScratchpadSourceChanged(message),
+                    },
+                }),
+            ...(options.chatAssistant === undefined ? {} : { chatAssistant: options.chatAssistant }),
         });
-        const replayedMessage = execution.result === undefined &&
-            execution.disposition.kind === "created" &&
-            execution.disposition.message_id !== undefined
-            ? readMessageProjectionById(store.db, execution.disposition.message_id)
-            : null;
-        const result = execution.result ?? (replayedMessage === null ? undefined : { message: replayedMessage });
-        const response = {
-            command_id: execution.command_id,
-            disposition: execution.disposition,
-            ...(execution.disposition.kind === "created"
-                ? { invalidates: mainChatMessageInvalidates() }
-                : {}),
-        };
-        if (result !== undefined) {
-            response.result = result;
-        }
-        if (!execution.replayed && result !== undefined) {
-            workspaceEvents.publish({
-                event_type: "message.created",
-                payload: {
-                    message: result.message,
-                },
-                invalidates: mainChatMessageInvalidates(),
-            });
-            options.controlPlane?.notifyScratchpadSourceChanged(result.message);
-            options.chatAssistant?.enqueue({ message: result.message });
-        }
-        return response;
     });
 }
 //# sourceMappingURL=messages-routes.js.map

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

@@ -429,10 +429,12 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                         readonly required: readonly ["client_session_id", "transport", "connected_at"];
                         readonly additionalProperties: false;
                         readonly properties: {
-                            readonly client_session_id: import("@sinclair/typebox").TString;
+                            readonly client_session_id: {
+                                readonly oneOf: readonly [import("@sinclair/typebox").TString, import("@sinclair/typebox").TString];
+                            };
                             readonly transport: {
                                 readonly type: "string";
-                                readonly enum: readonly ["relay_tunnel"];
+                                readonly enum: readonly ["relay_tunnel", "feishu_platform_session"];
                             };
                             readonly connected_at: import("@sinclair/typebox").TString;
                         };
@@ -895,10 +897,12 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                 readonly required: readonly ["client_session_id", "transport", "connected_at"];
                                 readonly additionalProperties: false;
                                 readonly properties: {
-                                    readonly client_session_id: import("@sinclair/typebox").TString;
+                                    readonly client_session_id: {
+                                        readonly oneOf: readonly [import("@sinclair/typebox").TString, import("@sinclair/typebox").TString];
+                                    };
                                     readonly transport: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["relay_tunnel"];
+                                        readonly enum: readonly ["relay_tunnel", "feishu_platform_session"];
                                     };
                                     readonly connected_at: import("@sinclair/typebox").TString;
                                 };

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

@@ -1712,10 +1712,12 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                         readonly required: readonly ["client_session_id", "transport", "connected_at"];
                         readonly additionalProperties: false;
                         readonly properties: {
-                            readonly client_session_id: import("@sinclair/typebox").TString;
+                            readonly client_session_id: {
+                                readonly oneOf: readonly [import("@sinclair/typebox").TString, import("@sinclair/typebox").TString];
+                            };
                             readonly transport: {
                                 readonly type: "string";
-                                readonly enum: readonly ["relay_tunnel"];
+                                readonly enum: readonly ["relay_tunnel", "feishu_platform_session"];
                             };
                             readonly connected_at: import("@sinclair/typebox").TString;
                         };
@@ -2178,10 +2180,12 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                 readonly required: readonly ["client_session_id", "transport", "connected_at"];
                                 readonly additionalProperties: false;
                                 readonly properties: {
-                                    readonly client_session_id: import("@sinclair/typebox").TString;
+                                    readonly client_session_id: {
+                                        readonly oneOf: readonly [import("@sinclair/typebox").TString, import("@sinclair/typebox").TString];
+                                    };
                                     readonly transport: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["relay_tunnel"];
+                                        readonly enum: readonly ["relay_tunnel", "feishu_platform_session"];
                                     };
                                     readonly connected_at: import("@sinclair/typebox").TString;
                                 };

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

@@ -1,9 +1,9 @@
 import { GetReferenceFilesRequestSchema, GetReferenceFilesResponseSchema, RefreshReferenceSummariesBodySchema, RefreshReferenceSummariesResponseSchema, UploadReferenceFileBodySchema, UploadReferenceFileResponseSchema, } from "@tutti/shared/schemas/api";
-import { createMainChatMessage, recordReadNotificationEvent, } from "../../../../collaboration-state/index.js";
-import { REFERENCE_DIRECTORY_PATH, uploadReferenceFile, } from "../../../../workspace-ops/index.js";
+import { ingestReferenceFile, REFERENCE_FILE_INGESTION_COMMAND_NAME, REFERENCE_FILE_INGESTION_TARGET_REF, } from "../../../../collaboration-ingestion/index.js";
+import { REFERENCE_DIRECTORY_PATH } from "../../../../workspace-ops/index.js";
 import { decideCommandIdempotencyReplay, executeIdempotentCommand, readCommandIdempotencyRecord, } from "../../../command-idempotency/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
-import { readReferenceFilesResponse, referenceFileMessageRef, referenceFilesChangedInvalidates, referenceSummaryProcedureInvalidates, referenceUploadMessageBody, toReferenceFileProjection, } from "./reference-files.js";
+import { readReferenceFilesResponse, referenceSummaryProcedureInvalidates, } from "./reference-files.js";
 import { requireControlPlane, requireHostProjectSession, requireProjectStore, requireWorkspaceRoot, } from "./session-requirements.js";
 import { abortDownloadedStagedUpload, cleanupDownloadedStagedUpload, downloadStagedUpload, } from "./staged-uploads.js";
 export function registerReferenceFilesRoutes(app, { options, workspaceEvents, }) {
@@ -33,8 +33,8 @@ export function registerReferenceFilesRoutes(app, { options, workspaceEvents, })
         const store = requireProjectStore(options);
         const commandId = request.body.command_id;
         const command = {
-            command_name: "references.files.upload",
-            target_ref: REFERENCE_DIRECTORY_PATH,
+            command_name: REFERENCE_FILE_INGESTION_COMMAND_NAME,
+            target_ref: REFERENCE_FILE_INGESTION_TARGET_REF,
             payload: request.body.payload,
         };
         const replay = decideCommandIdempotencyReplay(readCommandIdempotencyRecord(store.db, commandId), command);
@@ -48,101 +48,32 @@ export function registerReferenceFilesRoutes(app, { options, workspaceEvents, })
                         purpose: "reference_file",
                     })
                     : undefined;
-            const invalidates = referenceFilesChangedInvalidates();
-            const execution = executeIdempotentCommand({
-                db: store.db,
-                command_id: commandId,
-                command_name: command.command_name,
-                target_ref: command.target_ref,
+            return await ingestReferenceFile({
+                store,
+                workspaceRoot: requireWorkspaceRoot(options),
+                events: workspaceEvents,
+                commandId,
                 payload: request.body.payload,
+                content: staged?.content,
+                author: session.account,
                 ...(options.now === undefined ? {} : { now: options.now }),
-                execute: (tx) => {
-                    if (staged === undefined) {
-                        throw new Error("Staged reference upload was not downloaded");
+                afterCommit: async () => {
+                    if (staged !== undefined) {
+                        await cleanupDownloadedStagedUpload(staged);
+                        staged = undefined;
                     }
-                    const uploaded = uploadReferenceFile({
-                        workspaceRoot: requireWorkspaceRoot(options),
-                        commandId,
-                        fileName: request.body.payload.file_name,
-                        content: staged.content,
-                        ...(request.body.payload.media_type === undefined
-                            ? {}
-                            : { mediaType: request.body.payload.media_type }),
-                        ...(request.body.payload.note === undefined
-                            ? {}
-                            : { note: request.body.payload.note }),
-                        ...(options.now === undefined ? {} : { now: options.now }),
-                    });
-                    const file = toReferenceFileProjection({
-                        workspaceRoot: requireWorkspaceRoot(options),
-                        entry: uploaded.file,
-                        ...(options.now === undefined ? {} : { now: options.now }),
-                    });
-                    const message = createMainChatMessage(tx, {
-                        body: referenceUploadMessageBody(file),
-                        author: {
-                            kind: "human",
-                            ref: session.account.account_ref,
-                            display_name: session.account.display_name,
-                            avatar: session.account.avatar,
-                        },
-                        refs: {
-                            reference_file: referenceFileMessageRef(file),
-                        },
-                        ...(options.now === undefined ? {} : { now: options.now }),
-                    });
-                    recordReadNotificationEvent(tx, {
-                        scope: "references",
-                        source_kind: "reference_file",
-                        source_ref: file.path,
-                        actor: {
-                            kind: "human",
-                            ref: session.account.account_ref,
+                },
+                ...(options.controlPlane === undefined
+                    ? {}
+                    : {
+                        scratchpadSource: {
+                            notify: (message) => options.controlPlane?.notifyScratchpadSourceChanged(message),
                         },
-                        occurred_at: message.created_at,
-                    });
-                    return {
-                        disposition: { kind: "created" },
-                        result: {
-                            file,
-                            message,
-                            index_path: uploaded.index_path,
+                        referenceSummaries: {
+                            start: (paths) => options.controlPlane?.startReferenceSummaryRefresh({ paths }),
                         },
-                    };
-                },
+                    }),
             });
-            const response = {
-                command_id: execution.command_id,
-                disposition: execution.disposition,
-                invalidates,
-            };
-            if (execution.result !== undefined) {
-                response.result = execution.result;
-            }
-            if (!execution.replayed && execution.result !== undefined) {
-                if (staged !== undefined) {
-                    await cleanupDownloadedStagedUpload(staged);
-                    staged = undefined;
-                }
-                workspaceEvents.publish({
-                    event_type: "message.created",
-                    payload: { message: execution.result.message },
-                    invalidates,
-                });
-                workspaceEvents.publish({
-                    event_type: "query.invalidate",
-                    payload: {
-                        reason: "viewer_changed",
-                        message: "Reference files changed.",
-                    },
-                    invalidates,
-                });
-                options.controlPlane?.notifyScratchpadSourceChanged(execution.result.message);
-                options.controlPlane?.startReferenceSummaryRefresh({
-                    paths: [execution.result.file.path],
-                });
-            }
-            return response;
         }
         catch (error) {
             if (staged !== undefined) {

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

@@ -1,17 +1,7 @@
-import type { GetReferenceFilesRequest, GetReferenceFilesResponse, MessageCreatedEventPayload, QueryInvalidationHint, ReferenceFileProjection } from "@tutti/shared/schemas/api";
-import { readReferenceSummaryIndex, type ViewerTreeEntry } from "../../../../workspace-ops/index.js";
-export declare function toReferenceFileProjection(options: {
-    workspaceRoot: string;
-    entry: ViewerTreeEntry;
-    summaryIndex?: ReturnType<typeof readReferenceSummaryIndex>;
-    now?: () => Date;
-}): ReferenceFileProjection;
+import type { GetReferenceFilesRequest, GetReferenceFilesResponse, QueryInvalidationHint } from "@tutti/shared/schemas/api";
 export declare function readReferenceFilesResponse(options: {
     workspaceRoot: string;
     now?: () => Date;
 }, query: GetReferenceFilesRequest): GetReferenceFilesResponse;
-export declare function referenceFilesChangedInvalidates(): QueryInvalidationHint[];
 export declare function referenceSummaryProcedureInvalidates(): QueryInvalidationHint[];
-export declare function referenceUploadMessageBody(file: ReferenceFileProjection): string;
-export declare function referenceFileMessageRef(file: ReferenceFileProjection): NonNullable<NonNullable<MessageCreatedEventPayload["message"]["refs"]>["reference_file"]>;
 //# sourceMappingURL=reference-files.d.ts.map

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

@@ -1,61 +1,6 @@
-import { REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, VIEWER_HARD_READ_LIMIT_BYTES, WorkspaceOpsError, readReferenceFileEntries, readReferenceSummaryIndex, readViewerFile, readViewerSnapshot, referenceFileCategoryForPath, referenceMediaTypeForPath, referenceSummaryProjectionForEntry, } from "../../../../workspace-ops/index.js";
+import { toReferenceFileProjection } from "../../../../collaboration-ingestion/index.js";
+import { REFERENCE_DIRECTORY_PATH, REFERENCE_FILES_DIRECTORY_PATH, REFERENCE_IMAGES_DIRECTORY_PATH, REFERENCE_INDEX_PATH, WorkspaceOpsError, readReferenceFileEntries, readReferenceSummaryIndex, readViewerFile, readViewerSnapshot, referenceFileCategoryForPath, } from "../../../../workspace-ops/index.js";
 import { paginateViewerItems, viewerPageLimit } from "./viewer-projections.js";
-function unreadableReasonForReferenceContent(content) {
-    if (content.kind === "text") {
-        return undefined;
-    }
-    return content.reason;
-}
-function referenceTextReadProjection(workspaceRoot, entry, now) {
-    if (entry.size_bytes !== undefined && entry.size_bytes > VIEWER_HARD_READ_LIMIT_BYTES) {
-        return { can_read: false, blocked_reason: "too_large" };
-    }
-    try {
-        const file = readViewerFile({
-            workspaceRoot,
-            path: entry.path,
-            maxBytes: 1,
-            ...(now === undefined ? {} : { now }),
-        });
-        const reason = unreadableReasonForReferenceContent(file.content);
-        if (reason !== undefined) {
-            return { can_read: false, blocked_reason: reason };
-        }
-        return { can_read: true };
-    }
-    catch {
-        return { can_read: false, blocked_reason: "unknown" };
-    }
-}
-export function toReferenceFileProjection(options) {
-    const category = referenceFileCategoryForPath(options.entry.path) ?? "file";
-    const summaryIndex = options.summaryIndex ?? readReferenceSummaryIndex({ workspaceRoot: options.workspaceRoot });
-    const projection = {
-        path: options.entry.path,
-        name: options.entry.name,
-        category,
-        size_bytes: options.entry.size_bytes ?? 0,
-        text_read: referenceTextReadProjection(options.workspaceRoot, options.entry, options.now),
-        summary: referenceSummaryProjectionForEntry({
-            entry: options.entry,
-            summaries: summaryIndex,
-        }),
-    };
-    if (options.entry.blob_oid !== undefined) {
-        projection.blob_oid = options.entry.blob_oid;
-    }
-    if (options.entry.extension !== undefined) {
-        projection.extension = options.entry.extension;
-    }
-    if (options.entry.language_hint !== undefined) {
-        projection.language_hint = options.entry.language_hint;
-    }
-    const mediaType = referenceMediaTypeForPath(options.entry.path);
-    if (mediaType !== undefined) {
-        projection.media_type = mediaType;
-    }
-    return projection;
-}
 function referenceDirectoryProjection(options) {
     if (options.directoryStatus === "missing") {
         return {
@@ -171,37 +116,7 @@ export function readReferenceFilesResponse(options, query) {
         page: page.page,
     };
 }
-export function referenceFilesChangedInvalidates() {
-    return [
-        { kind: "viewer", path: REFERENCE_DIRECTORY_PATH },
-        { kind: "messages", scope: "main_chat" },
-        { kind: "execution_status" },
-        { kind: "workspace" },
-        { kind: "read_state" },
-        { kind: "bootstrap" },
-    ];
-}
 export function referenceSummaryProcedureInvalidates() {
     return [{ kind: "execution_status" }, { kind: "bootstrap" }];
 }
-export function referenceUploadMessageBody(file) {
-    return file.category === "image" ? `Uploaded image: ${file.name}` : `Uploaded file: ${file.name}`;
-}
-export function referenceFileMessageRef(file) {
-    const ref = {
-        path: file.path,
-        name: file.name,
-        source: "human_upload",
-        category: file.category,
-        size_bytes: file.size_bytes,
-        text_read: file.text_read,
-    };
-    if (file.media_type !== undefined) {
-        ref.media_type = file.media_type;
-    }
-    if (file.blob_oid !== undefined) {
-        ref.blob_oid = file.blob_oid;
-    }
-    return ref;
-}
 //# sourceMappingURL=reference-files.js.map

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

@@ -415,10 +415,12 @@ export declare const SessionResponseSchema: {
             readonly required: readonly ["client_session_id", "transport", "connected_at"];
             readonly additionalProperties: false;
             readonly properties: {
-                readonly client_session_id: import("@sinclair/typebox").TString;
+                readonly client_session_id: {
+                    readonly oneOf: readonly [import("@sinclair/typebox").TString, import("@sinclair/typebox").TString];
+                };
                 readonly transport: {
                     readonly type: "string";
-                    readonly enum: readonly ["relay_tunnel"];
+                    readonly enum: readonly ["relay_tunnel", "feishu_platform_session"];
                 };
                 readonly connected_at: import("@sinclair/typebox").TString;
             };
@@ -859,10 +861,12 @@ export declare const BootstrapResponseSchema: {
                     readonly required: readonly ["client_session_id", "transport", "connected_at"];
                     readonly additionalProperties: false;
                     readonly properties: {
-                        readonly client_session_id: import("@sinclair/typebox").TString;
+                        readonly client_session_id: {
+                            readonly oneOf: readonly [import("@sinclair/typebox").TString, import("@sinclair/typebox").TString];
+                        };
                         readonly transport: {
                             readonly type: "string";
-                            readonly enum: readonly ["relay_tunnel"];
+                            readonly enum: readonly ["relay_tunnel", "feishu_platform_session"];
                         };
                         readonly connected_at: import("@sinclair/typebox").TString;
                     };

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

@@ -1,4 +1,4 @@
-import { ApprovalRequestIdSchema, ClarificationRoundRefSchema, ClarificationThreadRefSchema, IdempotencyKeySchema, IsoDateTimeStringSchema, ProjectIdSchema, RelayAccountRefSchema, RelayClientSessionIdSchema, RelayProjectRefSchema, RecoverySummaryIdSchema, TaskIdSchema, } from "@tutti/shared/schemas/domain";
+import { ApprovalRequestIdSchema, ClarificationRoundRefSchema, ClarificationThreadRefSchema, IdempotencyKeySchema, IsoDateTimeStringSchema, ProjectIdSchema, RelayAccountRefSchema, RelayClientSessionIdSchema, RelayPlatformSessionRefSchema, RelayProjectRefSchema, RecoverySummaryIdSchema, TaskIdSchema, } from "@tutti/shared/schemas/domain";
 import { ActiveClarificationProjectionSchema, ActiveApprovalProjectionSchema, ExecutionStatusProjectionSchema, MessageWindowSchema, ProjectTimelineResponseSchema, ReadStateSummaryProjectionSchema, ScratchpadProjectionSchema, WorklistProjectionSchema, } from "@tutti/shared/schemas/api";
 import { ACCOUNT_AVATAR_COLORS } from "@tutti/shared/domain";
 import { HOST_MAINLINE_BRANCH } from "./constants.js";
@@ -212,8 +212,13 @@ export const SessionResponseSchema = {
             required: ["client_session_id", "transport", "connected_at"],
             additionalProperties: false,
             properties: {
-                client_session_id: RelayClientSessionIdSchema,
-                transport: { type: "string", enum: ["relay_tunnel"] },
+                client_session_id: {
+                    oneOf: [RelayClientSessionIdSchema, RelayPlatformSessionRefSchema],
+                },
+                transport: {
+                    type: "string",
+                    enum: ["relay_tunnel", "feishu_platform_session"],
+                },
                 connected_at: IsoDateTimeStringSchema,
             },
         },

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

@@ -1,4 +1,4 @@
-import { requireRelaySessionContext, TRUSTED_RELAY_METADATA_REQUEST_HEADER, } from "../../../session/relay-session-context.js";
+import { readFeishuPlatformSessionContext, readRelaySessionContext, requireFeishuPlatformSessionContext, requireRelaySessionContext, TRUSTED_RELAY_METADATA_REQUEST_HEADER, } from "../../../session/relay-session-context.js";
 import { HostProjectForbiddenError, HostProjectStoreUnavailableError } from "./errors.js";
 import { headerToString } from "./headers.js";
 function readTrustedMetadata(request, store) {
@@ -9,8 +9,40 @@ function readTrustedMetadata(request, store) {
     return store.consume(requestId);
 }
 export function requireHostProjectSession(request, options) {
-    const context = requireRelaySessionContext(readTrustedMetadata(request, options.trustedMetadataStore));
+    const surface = options.surfaceProfile?.kind ?? "standalone";
+    const metadata = readTrustedMetadata(request, options.trustedMetadataStore);
     const relayState = options.relay.getState();
+    if (surface === "feishu") {
+        if (readRelaySessionContext(metadata).kind === "present") {
+            throw new HostProjectForbiddenError();
+        }
+        const context = requireFeishuPlatformSessionContext(metadata);
+        if (relayState.relay_project_ref !== undefined &&
+            context.membership.relay_project_ref !== relayState.relay_project_ref) {
+            throw new HostProjectForbiddenError();
+        }
+        return {
+            account: {
+                account_ref: context.account_ref,
+                display_name: context.display_name,
+                avatar: context.avatar,
+            },
+            membership: {
+                label: context.membership.label,
+                relay_project_ref: context.membership.relay_project_ref,
+                joined_at: context.membership.joined_at,
+            },
+            client_session: {
+                client_session_id: context.platform_session_ref,
+                transport: "feishu_platform_session",
+                connected_at: context.platform_session_created_at,
+            },
+        };
+    }
+    if (readFeishuPlatformSessionContext(metadata).kind === "present") {
+        throw new HostProjectForbiddenError();
+    }
+    const context = requireRelaySessionContext(metadata);
     if (relayState.relay_project_ref !== undefined &&
         context.membership.relay_project_ref !== relayState.relay_project_ref) {
         throw new HostProjectForbiddenError();

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

@@ -9,6 +9,7 @@ import type { TrustedRelaySessionMetadataStore } from "../../../session/relay-se
 import type { WorkspaceEventBus } from "../../workspace-events.js";
 import type { HOST_MAINLINE_BRANCH } from "./constants.js";
 import type { GetProviderModelsResponse, ProviderUsageProjection, RelayUploadProjection, UpdateProviderDefaultModelDisposition, UpdateProviderDefaultModelPayload } from "@tutti/shared/schemas/api";
+import type { ProjectSurfaceProfile } from "@tutti/shared/domain";
 export type ResolvedStagedUpload = {
     upload: RelayUploadProjection;
     get: {
@@ -82,6 +83,7 @@ export type HostProviderModelService = {
     }>;
 };
 export type HostProjectApiRouteOptions = {
+    surfaceProfile?: ProjectSurfaceProfile;
     artifactPreview?: Omit<ArtifactPreviewManagerOptions, "onStatusChange">;
     artifactPreviewManager?: ArtifactPreviewManager;
     project: {
@@ -134,7 +136,7 @@ export type HostSessionProjection = {
     };
     client_session: {
         client_session_id: string;
-        transport: "relay_tunnel";
+        transport: "relay_tunnel" | "feishu_platform_session";
         connected_at: string;
     };
 };

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

@@ -76,13 +76,19 @@ export function buildBootstrapSnapshots(options, eventsNow, session) {
     if (options.store === undefined) {
         return {};
     }
-    return {
-        main_chat: readMainChatMessageWindow(options.store.db),
+    const sharedSnapshots = {
         scratchpad: readScratchpadProjection(options.store.db),
         worklist: readWorklistProjection(options.store.db),
         active_clarification: readActiveClarificationProjection(options.store.db),
         active_approval: options.approvalManager?.getActiveApproval() ?? { state: "none" },
         execution_status: options.controlPlane?.getExecutionStatus() ?? createIdleExecutionStatusProjection(eventsNow),
+    };
+    if ((options.surfaceProfile?.kind ?? "standalone") === "feishu") {
+        return sharedSnapshots;
+    }
+    return {
+        main_chat: readMainChatMessageWindow(options.store.db),
+        ...sharedSnapshots,
         read_state: readReadStateSummary(options.store.db, {
             account_ref: session.account.account_ref,
             session_created_at: session.client_session.connected_at,

package/dist/server-shell/local-console/package-update-hosts.js

@@ -69,7 +69,9 @@ export async function restorePackageUpdateHosts(options) {
                 failed.push(projectId);
                 continue;
             }
-            spawnDetachedHost({
+            const startup = spawnDetachedHost({
+                tuttiHome: options.tuttiHome,
+                projectId,
                 workspaceRoot: project.workspace_root,
                 env: { ...options.env, TUTTI_HOME: options.tuttiHome },
                 inheritProcessEnv: false,
@@ -79,6 +81,7 @@ export async function restorePackageUpdateHosts(options) {
                 projectId,
                 workspaceRoot: project.workspace_root,
                 inviteMode: "preserve",
+                startupAttemptRef: startup.startup_attempt_ref,
                 ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
             });
             restored.push(projectId);