@myagentroam/server 0.13.7 → 0.13.8

package/node_modules/@myagentroam/protocol/dist/composer-tags.d.ts

@@ -1,4 +1,185 @@
 import { z } from 'zod';
+export declare const MAX_COMPOSER_QUOTE_CHARACTERS = 8000;
+export declare const MAX_COMPOSER_MESSAGE_CHARACTERS = 100000;
+/** Explicit snapshots describe a source; they never grant access to a live resource. */
+export declare const composerQuoteSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"source", [z.ZodObject<{
+    source: z.ZodLiteral<"file">;
+    path: z.ZodString;
+    origin: z.ZodEnum<["WORKING_TREE", "HISTORY"]>;
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+    revision: z.ZodOptional<z.ZodString>;
+    unsaved: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"quote">;
+    id: z.ZodString;
+    label: z.ZodString;
+    text: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    type: "quote";
+    source: "file";
+    origin: "WORKING_TREE" | "HISTORY";
+    startLine: number;
+    endLine: number;
+    id: string;
+    label: string;
+    text: string;
+    revision?: string | undefined;
+    unsaved?: boolean | undefined;
+}, {
+    path: string;
+    type: "quote";
+    source: "file";
+    origin: "WORKING_TREE" | "HISTORY";
+    startLine: number;
+    endLine: number;
+    id: string;
+    label: string;
+    text: string;
+    revision?: string | undefined;
+    unsaved?: boolean | undefined;
+}>, z.ZodObject<{
+    source: z.ZodLiteral<"diff">;
+    path: z.ZodString;
+    origin: z.ZodEnum<["WORKING_TREE", "HISTORY", "TOOL_CHANGE"]>;
+    revision: z.ZodOptional<z.ZodString>;
+    side: z.ZodOptional<z.ZodEnum<["old", "new", "mixed"]>>;
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
+    oldStartLine: z.ZodOptional<z.ZodNumber>;
+    oldEndLine: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"quote">;
+    id: z.ZodString;
+    label: z.ZodString;
+    text: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    type: "quote";
+    source: "diff";
+    origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+    id: string;
+    label: string;
+    text: string;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+    revision?: string | undefined;
+    side?: "old" | "new" | "mixed" | undefined;
+    oldStartLine?: number | undefined;
+    oldEndLine?: number | undefined;
+}, {
+    path: string;
+    type: "quote";
+    source: "diff";
+    origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+    id: string;
+    label: string;
+    text: string;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+    revision?: string | undefined;
+    side?: "old" | "new" | "mixed" | undefined;
+    oldStartLine?: number | undefined;
+    oldEndLine?: number | undefined;
+}>, z.ZodObject<{
+    source: z.ZodLiteral<"assistant">;
+    messageId: z.ZodString;
+    timestamp: z.ZodOptional<z.ZodString>;
+    streaming: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"quote">;
+    id: z.ZodString;
+    label: z.ZodString;
+    text: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    type: "quote";
+    source: "assistant";
+    id: string;
+    label: string;
+    text: string;
+    messageId: string;
+    timestamp?: string | undefined;
+    streaming?: boolean | undefined;
+}, {
+    type: "quote";
+    source: "assistant";
+    id: string;
+    label: string;
+    text: string;
+    messageId: string;
+    timestamp?: string | undefined;
+    streaming?: boolean | undefined;
+}>]>, {
+    path: string;
+    type: "quote";
+    source: "file";
+    origin: "WORKING_TREE" | "HISTORY";
+    startLine: number;
+    endLine: number;
+    id: string;
+    label: string;
+    text: string;
+    revision?: string | undefined;
+    unsaved?: boolean | undefined;
+} | {
+    path: string;
+    type: "quote";
+    source: "diff";
+    origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+    id: string;
+    label: string;
+    text: string;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+    revision?: string | undefined;
+    side?: "old" | "new" | "mixed" | undefined;
+    oldStartLine?: number | undefined;
+    oldEndLine?: number | undefined;
+} | {
+    type: "quote";
+    source: "assistant";
+    id: string;
+    label: string;
+    text: string;
+    messageId: string;
+    timestamp?: string | undefined;
+    streaming?: boolean | undefined;
+}, {
+    path: string;
+    type: "quote";
+    source: "file";
+    origin: "WORKING_TREE" | "HISTORY";
+    startLine: number;
+    endLine: number;
+    id: string;
+    label: string;
+    text: string;
+    revision?: string | undefined;
+    unsaved?: boolean | undefined;
+} | {
+    path: string;
+    type: "quote";
+    source: "diff";
+    origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+    id: string;
+    label: string;
+    text: string;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+    revision?: string | undefined;
+    side?: "old" | "new" | "mixed" | undefined;
+    oldStartLine?: number | undefined;
+    oldEndLine?: number | undefined;
+} | {
+    type: "quote";
+    source: "assistant";
+    id: string;
+    label: string;
+    text: string;
+    messageId: string;
+    timestamp?: string | undefined;
+    streaming?: boolean | undefined;
+}>;
+export type ComposerQuote = z.infer<typeof composerQuoteSchema>;
+export type ComposerQuoteDraft = ComposerQuote extends infer Q ? Q extends ComposerQuote ? Omit<Q, 'id'> : never : never;
 export declare const channelDisplayNameSchema: z.ZodEffects<z.ZodString, string, string>;
 export declare const channelOriginSchema: z.ZodObject<{
     source: z.ZodLiteral<"WEB_SHARE">;
@@ -229,34 +410,279 @@ export declare const composerTagSchemas: {
             label: z.ZodString;
         }, "strict", z.ZodTypeAny, {
             type: "session";
-            sessionId: string;
             label: string;
+            sessionId: string;
         }, {
             type: "session";
+            label: string;
             sessionId: string;
+        }>, z.ZodEffects<z.ZodDiscriminatedUnion<"source", [z.ZodObject<{
+            source: z.ZodLiteral<"file">;
+            path: z.ZodString;
+            origin: z.ZodEnum<["WORKING_TREE", "HISTORY"]>;
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+            revision: z.ZodOptional<z.ZodString>;
+            unsaved: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"quote">;
+            id: z.ZodString;
+            label: z.ZodString;
+            text: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            type: "quote";
+            source: "file";
+            origin: "WORKING_TREE" | "HISTORY";
+            startLine: number;
+            endLine: number;
+            id: string;
+            label: string;
+            text: string;
+            revision?: string | undefined;
+            unsaved?: boolean | undefined;
+        }, {
+            path: string;
+            type: "quote";
+            source: "file";
+            origin: "WORKING_TREE" | "HISTORY";
+            startLine: number;
+            endLine: number;
+            id: string;
+            label: string;
+            text: string;
+            revision?: string | undefined;
+            unsaved?: boolean | undefined;
+        }>, z.ZodObject<{
+            source: z.ZodLiteral<"diff">;
+            path: z.ZodString;
+            origin: z.ZodEnum<["WORKING_TREE", "HISTORY", "TOOL_CHANGE"]>;
+            revision: z.ZodOptional<z.ZodString>;
+            side: z.ZodOptional<z.ZodEnum<["old", "new", "mixed"]>>;
+            startLine: z.ZodOptional<z.ZodNumber>;
+            endLine: z.ZodOptional<z.ZodNumber>;
+            oldStartLine: z.ZodOptional<z.ZodNumber>;
+            oldEndLine: z.ZodOptional<z.ZodNumber>;
+            type: z.ZodLiteral<"quote">;
+            id: z.ZodString;
+            label: z.ZodString;
+            text: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            type: "quote";
+            source: "diff";
+            origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+            id: string;
+            label: string;
+            text: string;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+            revision?: string | undefined;
+            side?: "old" | "new" | "mixed" | undefined;
+            oldStartLine?: number | undefined;
+            oldEndLine?: number | undefined;
+        }, {
+            path: string;
+            type: "quote";
+            source: "diff";
+            origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+            id: string;
+            label: string;
+            text: string;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+            revision?: string | undefined;
+            side?: "old" | "new" | "mixed" | undefined;
+            oldStartLine?: number | undefined;
+            oldEndLine?: number | undefined;
+        }>, z.ZodObject<{
+            source: z.ZodLiteral<"assistant">;
+            messageId: z.ZodString;
+            timestamp: z.ZodOptional<z.ZodString>;
+            streaming: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"quote">;
+            id: z.ZodString;
+            label: z.ZodString;
+            text: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            type: "quote";
+            source: "assistant";
+            id: string;
+            label: string;
+            text: string;
+            messageId: string;
+            timestamp?: string | undefined;
+            streaming?: boolean | undefined;
+        }, {
+            type: "quote";
+            source: "assistant";
+            id: string;
+            label: string;
+            text: string;
+            messageId: string;
+            timestamp?: string | undefined;
+            streaming?: boolean | undefined;
+        }>]>, {
+            path: string;
+            type: "quote";
+            source: "file";
+            origin: "WORKING_TREE" | "HISTORY";
+            startLine: number;
+            endLine: number;
+            id: string;
+            label: string;
+            text: string;
+            revision?: string | undefined;
+            unsaved?: boolean | undefined;
+        } | {
+            path: string;
+            type: "quote";
+            source: "diff";
+            origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+            id: string;
+            label: string;
+            text: string;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+            revision?: string | undefined;
+            side?: "old" | "new" | "mixed" | undefined;
+            oldStartLine?: number | undefined;
+            oldEndLine?: number | undefined;
+        } | {
+            type: "quote";
+            source: "assistant";
+            id: string;
+            label: string;
+            text: string;
+            messageId: string;
+            timestamp?: string | undefined;
+            streaming?: boolean | undefined;
+        }, {
+            path: string;
+            type: "quote";
+            source: "file";
+            origin: "WORKING_TREE" | "HISTORY";
+            startLine: number;
+            endLine: number;
+            id: string;
+            label: string;
+            text: string;
+            revision?: string | undefined;
+            unsaved?: boolean | undefined;
+        } | {
+            path: string;
+            type: "quote";
+            source: "diff";
+            origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+            id: string;
             label: string;
+            text: string;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+            revision?: string | undefined;
+            side?: "old" | "new" | "mixed" | undefined;
+            oldStartLine?: number | undefined;
+            oldEndLine?: number | undefined;
+        } | {
+            type: "quote";
+            source: "assistant";
+            id: string;
+            label: string;
+            text: string;
+            messageId: string;
+            timestamp?: string | undefined;
+            streaming?: boolean | undefined;
         }>]>, "many">;
     }, "strict", z.ZodTypeAny, {
         references: ({
+            path: string;
+            type: "quote";
+            source: "file";
+            origin: "WORKING_TREE" | "HISTORY";
+            startLine: number;
+            endLine: number;
+            id: string;
+            label: string;
+            text: string;
+            revision?: string | undefined;
+            unsaved?: boolean | undefined;
+        } | {
+            path: string;
+            type: "quote";
+            source: "diff";
+            origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+            id: string;
+            label: string;
+            text: string;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+            revision?: string | undefined;
+            side?: "old" | "new" | "mixed" | undefined;
+            oldStartLine?: number | undefined;
+            oldEndLine?: number | undefined;
+        } | {
+            type: "quote";
+            source: "assistant";
+            id: string;
+            label: string;
+            text: string;
+            messageId: string;
+            timestamp?: string | undefined;
+            streaming?: boolean | undefined;
+        } | {
             path: string;
             type: "file" | "directory";
             label: string;
             runnerPath?: string | undefined;
         } | {
             type: "session";
-            sessionId: string;
             label: string;
+            sessionId: string;
         })[];
     }, {
         references: ({
+            path: string;
+            type: "quote";
+            source: "file";
+            origin: "WORKING_TREE" | "HISTORY";
+            startLine: number;
+            endLine: number;
+            id: string;
+            label: string;
+            text: string;
+            revision?: string | undefined;
+            unsaved?: boolean | undefined;
+        } | {
+            path: string;
+            type: "quote";
+            source: "diff";
+            origin: "WORKING_TREE" | "HISTORY" | "TOOL_CHANGE";
+            id: string;
+            label: string;
+            text: string;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+            revision?: string | undefined;
+            side?: "old" | "new" | "mixed" | undefined;
+            oldStartLine?: number | undefined;
+            oldEndLine?: number | undefined;
+        } | {
+            type: "quote";
+            source: "assistant";
+            id: string;
+            label: string;
+            text: string;
+            messageId: string;
+            timestamp?: string | undefined;
+            streaming?: boolean | undefined;
+        } | {
             path: string;
             type: "file" | "directory";
             label: string;
             runnerPath?: string | undefined;
         } | {
             type: "session";
-            sessionId: string;
             label: string;
+            sessionId: string;
         })[];
     }>;
 };
@@ -266,8 +692,8 @@ export type ComposerTagPayloads = {
 };
 export type ComposerAttachmentFile = ComposerTagPayloads['mar_attachments']['files'][number];
 export type ComposerReference = ComposerTagPayloads['mar_references']['references'][number];
-export type ComposerFileReference = Exclude<ComposerReference, {
-    type: 'session';
+export type ComposerFileReference = Extract<ComposerReference, {
+    type: 'file' | 'directory';
 }>;
 export type ComposerTagPart = {
     readonly kind: 'text';

package/node_modules/@myagentroam/protocol/dist/composer-tags.js

@@ -3,6 +3,69 @@ import { composerMarkupEnd, escapeMarkup, markupAttributes, parseComposerMarkup
 const path = z.string().min(1).max(4096);
 const name = z.string().min(1).max(512);
 const MAX_COMPOSER_TAG_BYTES = 128 * 1024;
+export const MAX_COMPOSER_QUOTE_CHARACTERS = 8000;
+export const MAX_COMPOSER_MESSAGE_CHARACTERS = 100_000;
+const quoteFields = {
+    type: z.literal('quote'),
+    id: z.string().min(1).max(128),
+    label: name,
+    text: z
+        .string()
+        .min(1)
+        .max(MAX_COMPOSER_QUOTE_CHARACTERS)
+        .refine((value) => value.trim().length > 0)
+};
+const quoteLine = z.number().int().positive().max(Number.MAX_SAFE_INTEGER);
+/** Explicit snapshots describe a source; they never grant access to a live resource. */
+export const composerQuoteSchema = z
+    .discriminatedUnion('source', [
+    z
+        .object({
+        ...quoteFields,
+        source: z.literal('file'),
+        path,
+        origin: z.enum(['WORKING_TREE', 'HISTORY']),
+        startLine: quoteLine,
+        endLine: quoteLine,
+        revision: name.optional(),
+        unsaved: z.boolean().optional()
+    })
+        .strict(),
+    z
+        .object({
+        ...quoteFields,
+        source: z.literal('diff'),
+        path,
+        origin: z.enum(['WORKING_TREE', 'HISTORY', 'TOOL_CHANGE']),
+        revision: name.optional(),
+        side: z.enum(['old', 'new', 'mixed']).optional(),
+        startLine: quoteLine.optional(),
+        endLine: quoteLine.optional(),
+        oldStartLine: quoteLine.optional(),
+        oldEndLine: quoteLine.optional()
+    })
+        .strict(),
+    z
+        .object({
+        ...quoteFields,
+        source: z.literal('assistant'),
+        messageId: z.string().min(1).max(512),
+        timestamp: name.optional(),
+        streaming: z.boolean().optional()
+    })
+        .strict()
+])
+    .refine((quote) => {
+    if (quote.source === 'assistant')
+        return true;
+    if ((quote.startLine === undefined) !== (quote.endLine === undefined))
+        return false;
+    if (quote.startLine !== undefined && quote.endLine < quote.startLine)
+        return false;
+    return (quote.source !== 'diff' ||
+        ((quote.oldStartLine === undefined) === (quote.oldEndLine === undefined) &&
+            (quote.oldStartLine === undefined || quote.oldEndLine >= quote.oldStartLine)));
+});
 export const channelDisplayNameSchema = z
     .string()
     .trim()
@@ -95,7 +158,8 @@ export const composerTagSchemas = {
                 sessionId: z.string().min(1).max(512),
                 label: name
             })
-                .strict()
+                .strict(),
+            composerQuoteSchema
         ]))
             .min(1)
             .max(128)
@@ -129,8 +193,14 @@ export function serializeComposerTag(kind, payload) {
             attributes[key] = item;
         else if (Array.isArray(item)) {
             const leaf = key === 'files' ? 'file' : key === 'skills' ? 'skill' : 'reference';
-            for (const entry of item)
-                children.push(`  <${leaf}${markupAttributes(entry)} />`);
+            for (const entry of item) {
+                if (kind === 'mar_references' && entry.type === 'quote') {
+                    const { text, ...attributes } = entry;
+                    children.push(`  <${leaf}${markupAttributes(attributes)}>${escapeMarkup(text)}</${leaf}>`);
+                }
+                else
+                    children.push(`  <${leaf}${markupAttributes(entry)} />`);
+            }
         }
         else
             children.push(item === '' ? `  <${key} />` : `  <${key}>${escapeMarkup(String(item))}</${key}>`);
@@ -176,12 +246,25 @@ function parseComposerPayload(raw) {
                         : [];
         for (const field of root.fields) {
             if (list && field.name === list[0]) {
-                if (field.text !== '')
+                const quote = kind === 'mar_references' && field.attributes.type === 'quote';
+                if (!quote && field.text !== '')
                     return undefined;
                 const values = (payload[list[1]] ??= []);
                 if (!Array.isArray(values))
                     return undefined;
-                values.push({ ...field.attributes });
+                const entry = { ...field.attributes };
+                if (quote) {
+                    entry.text = field.text;
+                    for (const key of ['startLine', 'endLine', 'oldStartLine', 'oldEndLine']) {
+                        if (typeof entry[key] === 'string' && /^[1-9]\d*$/u.test(entry[key]))
+                            entry[key] = Number(entry[key]);
+                    }
+                    for (const key of ['unsaved', 'streaming']) {
+                        if (entry[key] === 'true' || entry[key] === 'false')
+                            entry[key] = entry[key] === 'true';
+                    }
+                }
+                values.push(entry);
             }
             else {
                 if (!scalar.includes(field.name) ||