@xfey/tutti 0.1.113 → 0.1.115

package/dist/skills/file-reader.d.ts

@@ -0,0 +1,14 @@
+export declare function skillReadLimitExceeded(): never;
+/** Read from one checked descriptor; never follow a SKILL.md symlink or block on a FIFO. */
+export declare function readSkillFile(input: {
+    root: string;
+    name: string;
+    maxBytes: number;
+    metadataOnly?: boolean;
+}): {
+    markdown: string;
+    updatedAt: string;
+};
+/** Bound enumeration before collecting names; a limit never returns a partial list. */
+export declare function listSkillDirectories(root: string, maxEntries?: number): string[];
+//# sourceMappingURL=file-reader.d.ts.map

package/dist/skills/file-reader.js

@@ -0,0 +1,123 @@
+import { closeSync, constants, fstatSync, lstatSync, openSync, opendirSync, readSync, realpathSync, } from "node:fs";
+import { join, resolve } from "node:path";
+import { SKILL_MD_FILE_NAME } from "./constants.js";
+import { SkillServiceError } from "./errors.js";
+import { decodeSkillMarkdown, isValidSkillName } from "./metadata.js";
+function unsafePath() {
+    throw new SkillServiceError("validation_failed", "Skill path is not a regular project skill");
+}
+export function skillReadLimitExceeded() {
+    throw new SkillServiceError("read_limit_exceeded", "Skill read exceeds the supported limit");
+}
+function mapReadError(error) {
+    if (error instanceof SkillServiceError)
+        throw error;
+    const code = error.code;
+    if (code === "ENOENT" || code === "ENOTDIR") {
+        throw new SkillServiceError("skill_not_found", "Skill does not exist");
+    }
+    throw new SkillServiceError("filesystem_error", "Skill could not be read");
+}
+function realDirectory(path) {
+    if (!lstatSync(path).isDirectory())
+        unsafePath();
+    return realpathSync(path);
+}
+function resolveSkillFile(root, name) {
+    const realRoot = realDirectory(resolve(root));
+    const directory = join(realRoot, name);
+    if (realDirectory(directory) !== directory)
+        unsafePath();
+    const file = join(directory, SKILL_MD_FILE_NAME);
+    if (!lstatSync(file).isFile() || realpathSync(file) !== file)
+        unsafePath();
+    return file;
+}
+function sameFile(left, right) {
+    return (left.dev === right.dev &&
+        left.ino === right.ino &&
+        left.size === right.size &&
+        left.mtimeMs === right.mtimeMs &&
+        left.ctimeMs === right.ctimeMs);
+}
+/** Read from one checked descriptor; never follow a SKILL.md symlink or block on a FIFO. */
+export function readSkillFile(input) {
+    if (!isValidSkillName(input.name)) {
+        throw new SkillServiceError("invalid_skill_name", "Skill name is invalid");
+    }
+    let fd;
+    try {
+        const file = resolveSkillFile(input.root, input.name);
+        fd = openSync(file, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        const before = fstatSync(fd);
+        if (!before.isFile() || !sameFile(before, lstatSync(file)))
+            unsafePath();
+        if (!input.metadataOnly && before.size > input.maxBytes)
+            skillReadLimitExceeded();
+        const buffer = Buffer.alloc(Math.min(before.size, input.maxBytes) + 1);
+        let length = 0;
+        while (length < buffer.length) {
+            const read = readSync(fd, buffer, length, buffer.length - length, length);
+            if (read === 0)
+                break;
+            length += read;
+        }
+        if (!sameFile(before, fstatSync(fd)) ||
+            resolveSkillFile(input.root, input.name) !== file ||
+            !sameFile(before, lstatSync(file))) {
+            throw new SkillServiceError("filesystem_error", "Skill changed while being read");
+        }
+        const bytes = buffer.subarray(0, length);
+        const text = decodeSkillMarkdown(bytes, input.metadataOnly === true && before.size > length);
+        if (input.metadataOnly) {
+            // Frontmatter syntax stays owned by metadata.ts. Only its bounded prefix is decoded.
+            const prefix = text.replace(/\r\n/gu, "\n");
+            const end = prefix.startsWith("---\n") ? prefix.indexOf("\n---", 4) : -1;
+            if (end !== -1) {
+                const metadata = prefix.slice(0, end + 4);
+                if (Buffer.byteLength(metadata) > input.maxBytes)
+                    skillReadLimitExceeded();
+                return { markdown: metadata, updatedAt: before.mtime.toISOString() };
+            }
+        }
+        if (length > input.maxBytes)
+            skillReadLimitExceeded();
+        return { markdown: text, updatedAt: before.mtime.toISOString() };
+    }
+    catch (error) {
+        return mapReadError(error);
+    }
+    finally {
+        if (fd !== undefined)
+            closeSync(fd);
+    }
+}
+/** Bound enumeration before collecting names; a limit never returns a partial list. */
+export function listSkillDirectories(root, maxEntries = Infinity) {
+    try {
+        const realRoot = realDirectory(resolve(root));
+        const directory = opendirSync(realRoot);
+        const names = [];
+        let count = 0;
+        try {
+            for (let entry = directory.readSync(); entry !== null; entry = directory.readSync()) {
+                if (++count > maxEntries)
+                    skillReadLimitExceeded();
+                if (entry.isDirectory() && isValidSkillName(entry.name))
+                    names.push(entry.name);
+            }
+        }
+        finally {
+            directory.closeSync();
+        }
+        if (realDirectory(resolve(root)) !== realRoot)
+            unsafePath();
+        return names.sort();
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        return mapReadError(error);
+    }
+}
+//# sourceMappingURL=file-reader.js.map

package/dist/skills/index.d.ts

@@ -26,9 +26,12 @@ export type UserSkillImportResult = {
     disposition: UserSkillImportDisposition;
     skill: SkillDetailProjection;
 };
+export type UserSkillReadOptions = {
+    mode?: "full" | "preview";
+};
 export declare function getProjectUserSkillsRoot(tuttiHome: string, projectId: ProjectId): string;
-export declare function listUserSkills(userSkillsRoot: string): SkillProjection[];
-export declare function readUserSkill(userSkillsRoot: string, skillName: string): SkillDetailProjection;
+export declare function listUserSkills(userSkillsRoot: string, options?: UserSkillReadOptions): SkillProjection[];
+export declare function readUserSkill(userSkillsRoot: string, skillName: string, options?: UserSkillReadOptions): SkillDetailProjection;
 export declare function importUserSkillZip(options: {
     userSkillsRoot: string;
     zipBuffer: Buffer;

package/dist/skills/index.js

@@ -1,9 +1,10 @@
-import { existsSync, mkdtempSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, } from "node:fs";
+import { existsSync, mkdtempSync, mkdirSync, renameSync, rmSync, statSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
-import { SKILL_MD_FILE_NAME, USER_SKILLS_DIRECTORY_NAME } from "./constants.js";
+import { MAX_SKILL_FILE_BYTES, MAX_SKILL_PREVIEW_BYTES, MAX_SKILL_PREVIEW_METADATA_BYTES, MAX_SKILL_PREVIEW_SCAN_ENTRIES, MAX_SKILL_PREVIEW_ITEMS, MAX_SKILL_PREVIEW_LIST_BYTES, USER_SKILLS_DIRECTORY_NAME, } from "./constants.js";
 import { SkillServiceError } from "./errors.js";
-import { isValidSkillName, parseSkillMarkdown, } from "./metadata.js";
+import { listSkillDirectories, readSkillFile, skillReadLimitExceeded } from "./file-reader.js";
+import { isValidSkillName, parseSkillMarkdown } from "./metadata.js";
 import { prepareUserSkillZipImport, writeCandidateFiles, } from "./zip-import.js";
 export { MAX_SKILL_DIRECTORY_DEPTH, MAX_SKILL_FILE_BYTES, MAX_SKILL_FILE_COUNT, MAX_SKILL_TOTAL_UNCOMPRESSED_BYTES, MAX_SKILL_ZIP_BYTES, SKILL_MD_FILE_NAME, USER_SKILLS_DIRECTORY_NAME, } from "./constants.js";
 export { SkillServiceError } from "./errors.js";
@@ -30,17 +31,6 @@ function skillDirectory(userSkillsRoot, skillName) {
     ensureInside(userSkillsRoot, directory);
     return directory;
 }
-function readSkillMarkdown(filePath) {
-    let skillMd;
-    try {
-        skillMd = readFileSync(filePath, "utf8");
-    }
-    catch {
-        throw new SkillServiceError("skill_not_found", "Skill does not exist");
-    }
-    const metadata = parseSkillMarkdown(skillMd);
-    return { ...metadata, skill_md: skillMd };
-}
 function toSkillProjection(options) {
     return {
         name: options.metadata.name,
@@ -53,53 +43,58 @@ function toSkillProjection(options) {
         ...(options.updatedAt === undefined ? {} : { updated_at: options.updatedAt }),
     };
 }
-function readSkillProjection(directory) {
-    const skillMdPath = join(directory, SKILL_MD_FILE_NAME);
-    const parsed = readSkillMarkdown(skillMdPath);
-    const stat = statSync(skillMdPath);
+function readSkillProjection(root, name, preview) {
+    const file = readSkillFile({
+        root,
+        name,
+        maxBytes: preview ? MAX_SKILL_PREVIEW_METADATA_BYTES : MAX_SKILL_FILE_BYTES,
+        metadataOnly: preview,
+    });
     return toSkillProjection({
-        metadata: parsed,
-        updatedAt: stat.mtime.toISOString(),
+        metadata: parseSkillMarkdown(file.markdown),
+        updatedAt: file.updatedAt,
     });
 }
-export function listUserSkills(userSkillsRoot) {
-    if (!existsSync(userSkillsRoot)) {
-        return [];
-    }
+export function listUserSkills(userSkillsRoot, options = {}) {
+    const preview = options.mode === "preview";
     const items = [];
-    for (const entry of readdirSync(userSkillsRoot, { withFileTypes: true })) {
-        if (!entry.isDirectory() || !isValidSkillName(entry.name)) {
-            continue;
-        }
+    let responseBytes = Buffer.byteLength('{"items":[]}');
+    for (const name of listSkillDirectories(userSkillsRoot, preview ? MAX_SKILL_PREVIEW_SCAN_ENTRIES : undefined)) {
         try {
-            const projection = readSkillProjection(join(userSkillsRoot, entry.name));
-            if (projection.name === entry.name) {
+            const projection = readSkillProjection(userSkillsRoot, name, preview);
+            if (projection.name === name) {
+                responseBytes += Buffer.byteLength(JSON.stringify(projection)) + 1;
+                if (preview &&
+                    (items.length >= MAX_SKILL_PREVIEW_ITEMS || responseBytes > MAX_SKILL_PREVIEW_LIST_BYTES)) {
+                    skillReadLimitExceeded();
+                }
                 items.push(projection);
             }
         }
-        catch {
+        catch (error) {
+            if (preview && error instanceof SkillServiceError && error.code === "read_limit_exceeded")
+                throw error;
             // Keep the management surface available even if a stale local directory is malformed.
         }
     }
     return items.sort((left, right) => left.name.localeCompare(right.name));
 }
-export function readUserSkill(userSkillsRoot, skillName) {
-    const directory = skillDirectory(userSkillsRoot, skillName);
-    const skillMdPath = join(directory, SKILL_MD_FILE_NAME);
-    if (!existsSync(skillMdPath)) {
-        throw new SkillServiceError("skill_not_found", "Skill does not exist");
-    }
-    const parsed = readSkillMarkdown(skillMdPath);
+export function readUserSkill(userSkillsRoot, skillName, options = {}) {
+    const file = readSkillFile({
+        root: userSkillsRoot,
+        name: skillName,
+        maxBytes: options.mode === "preview" ? MAX_SKILL_PREVIEW_BYTES : MAX_SKILL_FILE_BYTES,
+    });
+    const parsed = parseSkillMarkdown(file.markdown);
     if (parsed.name !== skillName) {
         throw new SkillServiceError("validation_failed", "Skill metadata is invalid");
     }
-    const stat = statSync(skillMdPath);
     return {
         ...toSkillProjection({
             metadata: parsed,
-            updatedAt: stat.mtime.toISOString(),
+            updatedAt: file.updatedAt,
         }),
-        skill_md: parsed.skill_md,
+        skill_md: file.markdown,
     };
 }
 export async function importUserSkillZip(options) {

package/dist/skills/metadata.d.ts

@@ -4,5 +4,7 @@ export type ParsedSkillMarkdown = {
     short_description?: string;
 };
 export declare function isValidSkillName(value: string): boolean;
+/** Keep import preflight and runtime reads consistent; partial applies only to bounded prefixes. */
+export declare function decodeSkillMarkdown(bytes: Uint8Array, partial?: boolean): string;
 export declare function parseSkillMarkdown(skillMd: string): ParsedSkillMarkdown;
 //# sourceMappingURL=metadata.d.ts.map

package/dist/skills/metadata.js

@@ -1,7 +1,16 @@
 import { SkillServiceError } from "./errors.js";
 const SKILL_NAME_PATTERN = /^[a-z0-9_-]+$/u;
 export function isValidSkillName(value) {
-    return SKILL_NAME_PATTERN.test(value);
+    return value.length <= 96 && SKILL_NAME_PATTERN.test(value);
+}
+/** Keep import preflight and runtime reads consistent; partial applies only to bounded prefixes. */
+export function decodeSkillMarkdown(bytes, partial = false) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(bytes, { stream: partial });
+    }
+    catch {
+        throw new SkillServiceError("validation_failed", "Skill text is not valid UTF-8");
+    }
 }
 export function parseSkillMarkdown(skillMd) {
     const frontmatter = extractFrontmatter(skillMd);

package/dist/skills/zip-import.js

@@ -3,7 +3,7 @@ import { dirname, join, resolve } from "node:path";
 import * as yauzl from "yauzl";
 import { MAX_SKILL_DIRECTORY_DEPTH, MAX_SKILL_FILE_BYTES, MAX_SKILL_FILE_COUNT, MAX_SKILL_TOTAL_UNCOMPRESSED_BYTES, MAX_SKILL_ZIP_BYTES, SKILL_MD_FILE_NAME, } from "./constants.js";
 import { SkillServiceError } from "./errors.js";
-import { isValidSkillName, parseSkillMarkdown } from "./metadata.js";
+import { decodeSkillMarkdown, isValidSkillName, parseSkillMarkdown, } from "./metadata.js";
 const ZIP_MAGIC = Buffer.from([0x50, 0x4b, 0x03, 0x04]);
 const UNIX_FILE_TYPE_MASK = 0o170000;
 const UNIX_REGULAR_FILE = 0o100000;
@@ -209,7 +209,7 @@ function buildImportCandidate(entries) {
     if (skillMd === undefined) {
         throw new SkillServiceError("validation_failed", "SKILL.md is missing");
     }
-    const metadata = parseSkillMarkdown(skillMd.data.toString("utf8"));
+    const metadata = parseSkillMarkdown(decodeSkillMarkdown(skillMd.data));
     if (rootPrefix !== "" && rootPrefix !== metadata.name) {
         throw new SkillServiceError("validation_failed", "Skill root does not match skill name");
     }

package/node_modules/@tutti/relay-client/dist/host-control.d.ts

@@ -46,6 +46,7 @@ export type RegisterRelayHostConnectionPayload = {
             integration_source_ingestion_v1?: boolean;
             integration_development_bot_v1?: boolean;
             integration_clarification_v1?: boolean;
+            feishu_supporting_reads_v1?: boolean;
             integration_external_references_v1?: boolean;
             integration_attachment_ingestion_v1?: boolean;
             integration_managed_reference_ingestion_v1?: boolean;

package/node_modules/@tutti/relay-client/dist/host-control.js

@@ -68,6 +68,9 @@ function createRegisterPayload(options) {
                 ...(capabilities.integration_clarification_v1 === true
                     ? { integration_clarification_v1: true }
                     : {}),
+                ...(capabilities.feishu_supporting_reads_v1 === true
+                    ? { feishu_supporting_reads_v1: true }
+                    : {}),
             },
         },
     };

package/node_modules/@tutti/shared/dist/schemas/api/clarifications.d.ts

@@ -511,6 +511,17 @@ export declare const SendClarificationRoundMessageResultSchema: import("@sinclai
         message_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user_text">, import("@sinclair/typebox").TLiteral<"agent_text">, import("@sinclair/typebox").TLiteral<"system_notice">, import("@sinclair/typebox").TLiteral<"clarification_request">, import("@sinclair/typebox").TLiteral<"clarification_card">]>;
         body: import("@sinclair/typebox").TString;
         refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            reply_context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TLiteral<"resolved">;
+                message_id: import("@sinclair/typebox").TString;
+                role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"tutti">, import("@sinclair/typebox").TLiteral<"operator">, import("@sinclair/typebox").TLiteral<"system">]>;
+                text: import("@sinclair/typebox").TString;
+                truncated: import("@sinclair/typebox").TBoolean;
+                external_reference_sources: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            }>, import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TLiteral<"unavailable">;
+                reason_code: import("@sinclair/typebox").TLiteral<"parent_not_observed_in_binding">;
+            }>]>>;
             development_operator: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<true>>;
             external_reference_reads: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
             external_references: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{

package/node_modules/@tutti/shared/dist/schemas/api/messages.d.ts

@@ -132,7 +132,29 @@ export declare const ArtifactPreviewRefSchema: import("@sinclair/typebox").TObje
     task_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     run_result_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;
+export declare const MessageReplyContextSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"resolved">;
+    message_id: import("@sinclair/typebox").TString;
+    role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"tutti">, import("@sinclair/typebox").TLiteral<"operator">, import("@sinclair/typebox").TLiteral<"system">]>;
+    text: import("@sinclair/typebox").TString;
+    truncated: import("@sinclair/typebox").TBoolean;
+    external_reference_sources: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>, import("@sinclair/typebox").TObject<{
+    status: import("@sinclair/typebox").TLiteral<"unavailable">;
+    reason_code: import("@sinclair/typebox").TLiteral<"parent_not_observed_in_binding">;
+}>]>;
 export declare const MessageRefsSchema: import("@sinclair/typebox").TObject<{
+    reply_context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        status: import("@sinclair/typebox").TLiteral<"resolved">;
+        message_id: import("@sinclair/typebox").TString;
+        role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"tutti">, import("@sinclair/typebox").TLiteral<"operator">, import("@sinclair/typebox").TLiteral<"system">]>;
+        text: import("@sinclair/typebox").TString;
+        truncated: import("@sinclair/typebox").TBoolean;
+        external_reference_sources: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    }>, import("@sinclair/typebox").TObject<{
+        status: import("@sinclair/typebox").TLiteral<"unavailable">;
+        reason_code: import("@sinclair/typebox").TLiteral<"parent_not_observed_in_binding">;
+    }>]>>;
     development_operator: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<true>>;
     external_reference_reads: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     external_references: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
@@ -345,6 +367,17 @@ export declare const MessageProjectionSchema: import("@sinclair/typebox").TObjec
     message_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user_text">, import("@sinclair/typebox").TLiteral<"agent_text">, import("@sinclair/typebox").TLiteral<"system_notice">, import("@sinclair/typebox").TLiteral<"clarification_request">, import("@sinclair/typebox").TLiteral<"clarification_card">]>;
     body: import("@sinclair/typebox").TString;
     refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        reply_context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            status: import("@sinclair/typebox").TLiteral<"resolved">;
+            message_id: import("@sinclair/typebox").TString;
+            role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"tutti">, import("@sinclair/typebox").TLiteral<"operator">, import("@sinclair/typebox").TLiteral<"system">]>;
+            text: import("@sinclair/typebox").TString;
+            truncated: import("@sinclair/typebox").TBoolean;
+            external_reference_sources: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        }>, import("@sinclair/typebox").TObject<{
+            status: import("@sinclair/typebox").TLiteral<"unavailable">;
+            reason_code: import("@sinclair/typebox").TLiteral<"parent_not_observed_in_binding">;
+        }>]>>;
         development_operator: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<true>>;
         external_reference_reads: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
         external_references: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
@@ -676,6 +709,17 @@ export declare const SendMainChatMessageResultSchema: import("@sinclair/typebox"
         message_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user_text">, import("@sinclair/typebox").TLiteral<"agent_text">, import("@sinclair/typebox").TLiteral<"system_notice">, import("@sinclair/typebox").TLiteral<"clarification_request">, import("@sinclair/typebox").TLiteral<"clarification_card">]>;
         body: import("@sinclair/typebox").TString;
         refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            reply_context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TLiteral<"resolved">;
+                message_id: import("@sinclair/typebox").TString;
+                role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"tutti">, import("@sinclair/typebox").TLiteral<"operator">, import("@sinclair/typebox").TLiteral<"system">]>;
+                text: import("@sinclair/typebox").TString;
+                truncated: import("@sinclair/typebox").TBoolean;
+                external_reference_sources: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            }>, import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TLiteral<"unavailable">;
+                reason_code: import("@sinclair/typebox").TLiteral<"parent_not_observed_in_binding">;
+            }>]>>;
             development_operator: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<true>>;
             external_reference_reads: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
             external_references: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
@@ -909,6 +953,17 @@ export declare const MessageCreatedEventPayloadSchema: import("@sinclair/typebox
         message_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user_text">, import("@sinclair/typebox").TLiteral<"agent_text">, import("@sinclair/typebox").TLiteral<"system_notice">, import("@sinclair/typebox").TLiteral<"clarification_request">, import("@sinclair/typebox").TLiteral<"clarification_card">]>;
         body: import("@sinclair/typebox").TString;
         refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            reply_context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TLiteral<"resolved">;
+                message_id: import("@sinclair/typebox").TString;
+                role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"tutti">, import("@sinclair/typebox").TLiteral<"operator">, import("@sinclair/typebox").TLiteral<"system">]>;
+                text: import("@sinclair/typebox").TString;
+                truncated: import("@sinclair/typebox").TBoolean;
+                external_reference_sources: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            }>, import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TLiteral<"unavailable">;
+                reason_code: import("@sinclair/typebox").TLiteral<"parent_not_observed_in_binding">;
+            }>]>>;
             development_operator: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<true>>;
             external_reference_reads: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
             external_references: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{

package/node_modules/@tutti/shared/dist/schemas/api/messages.js

@@ -124,7 +124,30 @@ export const ArtifactPreviewRefSchema = Type.Object({
     task_id: Type.Optional(TaskIdSchema),
     run_result_id: Type.Optional(RunResultIdSchema),
 }, { additionalProperties: false });
+export const MessageReplyContextSchema = Type.Union([
+    Type.Object({
+        status: Type.Literal("resolved"),
+        message_id: MessageIdSchema,
+        role: Type.Union([
+            Type.Literal("human"),
+            Type.Literal("tutti"),
+            Type.Literal("operator"),
+            Type.Literal("system"),
+        ]),
+        text: Type.String({ maxLength: 2_000 }),
+        truncated: Type.Boolean(),
+        external_reference_sources: Type.Array(ExternalReferenceRefSchema, {
+            maxItems: 16,
+            uniqueItems: true,
+        }),
+    }, { additionalProperties: false }),
+    Type.Object({
+        status: Type.Literal("unavailable"),
+        reason_code: Type.Literal("parent_not_observed_in_binding"),
+    }, { additionalProperties: false }),
+]);
 export const MessageRefsSchema = Type.Object({
+    reply_context: Type.Optional(MessageReplyContextSchema),
     development_operator: Type.Optional(Type.Literal(true)),
     external_reference_reads: Type.Optional(Type.Array(ExternalReferenceRefSchema, { minItems: 1, maxItems: 16, uniqueItems: true })),
     external_references: Type.Optional(Type.Array(ExternalReferenceDescriptorSchema, { minItems: 1, maxItems: 16 })),

package/node_modules/@tutti/shared/dist/schemas/api/primitives.d.ts

@@ -72,10 +72,10 @@ export declare const InterruptedCommandDispositionSchema: import("@sinclair/type
 export declare function commandEnvelopeSchema<TPayload extends TSchema>(payload: TPayload): TSchema;
 export declare function commandResponseSchema<TDisposition extends TSchema>(disposition: TDisposition): TSchema;
 export declare function commandResponseWithResultSchema<TDisposition extends TSchema, TResult extends TSchema>(disposition: TDisposition, result: TResult): TSchema;
-export declare const ApiErrorCodeSchema: 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<"internal_error">]>;
+export declare const ApiErrorCodeSchema: 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">]>;
 export declare const ApiErrorResponseSchema: 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<"internal_error">]>;
+        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>;

package/node_modules/@tutti/shared/dist/schemas/api/primitives.js

@@ -106,6 +106,7 @@ export const ApiErrorCodeSchema = Type.Union([
     Type.Literal("command_replay_mismatch"),
     Type.Literal("repo_snapshot_unavailable"),
     Type.Literal("host_unavailable"),
+    Type.Literal("skill_read_limit_exceeded"),
     Type.Literal("internal_error"),
 ]);
 export const ApiErrorResponseSchema = Type.Object({

package/node_modules/@tutti/shared/dist/schemas/api/viewer-reference.d.ts

@@ -400,6 +400,17 @@ export declare const UploadReferenceFileResultSchema: import("@sinclair/typebox"
         message_kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user_text">, import("@sinclair/typebox").TLiteral<"agent_text">, import("@sinclair/typebox").TLiteral<"system_notice">, import("@sinclair/typebox").TLiteral<"clarification_request">, import("@sinclair/typebox").TLiteral<"clarification_card">]>;
         body: import("@sinclair/typebox").TString;
         refs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            reply_context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TLiteral<"resolved">;
+                message_id: import("@sinclair/typebox").TString;
+                role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"human">, import("@sinclair/typebox").TLiteral<"tutti">, import("@sinclair/typebox").TLiteral<"operator">, import("@sinclair/typebox").TLiteral<"system">]>;
+                text: import("@sinclair/typebox").TString;
+                truncated: import("@sinclair/typebox").TBoolean;
+                external_reference_sources: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            }>, import("@sinclair/typebox").TObject<{
+                status: import("@sinclair/typebox").TLiteral<"unavailable">;
+                reason_code: import("@sinclair/typebox").TLiteral<"parent_not_observed_in_binding">;
+            }>]>>;
             development_operator: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<true>>;
             external_reference_reads: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
             external_references: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfey/tutti",
-  "version": "0.1.113",
+  "version": "0.1.115",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",