@pellux/goodvibes-sdk 0.33.9 → 0.33.11

package/dist/platform/companion/companion-chat-manager.js

@@ -19,6 +19,7 @@
  *   for that specific session — never the global TUI event feed.
  * - A GC sweep closes sessions that have been idle beyond the TTL.
  */
+import { Buffer } from 'node:buffer';
 import { randomUUID } from 'node:crypto';
 import { ConversationManager } from '../core/conversation.js';
 import { CompanionChatPersistence, defaultSessionsDir, } from './companion-chat-persistence.js';
@@ -34,6 +35,16 @@ const DEFAULT_IDLE_ACTIVE_MS = 30 * 60 * 1_000; // 30 minutes with messages
 const DEFAULT_IDLE_EMPTY_MS = 5 * 60 * 1_000; // 5 minutes empty session
 const GC_INTERVAL_MS = 60 * 1_000; // sweep every minute
 const MAX_TOOL_ROUNDS_PER_TURN = 8;
+const MAX_ATTACHMENTS_PER_MESSAGE = 8;
+const MAX_INLINE_IMAGE_ATTACHMENT_BYTES = 20 * 1024 * 1024;
+const MAX_INLINE_TEXT_ATTACHMENT_BYTES = 200 * 1024;
+function toNodeBuffer(buffer) {
+    if (Buffer.isBuffer(buffer))
+        return buffer;
+    if (buffer instanceof ArrayBuffer)
+        return Buffer.from(new Uint8Array(buffer));
+    return Buffer.from(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+}
 function assertCompleteProviderModelRoute(input) {
     if ((input.model !== undefined) === (input.provider !== undefined))
         return;
@@ -50,6 +61,7 @@ export class CompanionChatManager {
     permissionManager;
     hookDispatcher;
     runtimeBus;
+    artifactStore;
     persistence;
     rateLimiter;
     idleActiveMs;
@@ -71,6 +83,7 @@ export class CompanionChatManager {
         this.permissionManager = config.permissionManager ?? null;
         this.hookDispatcher = config.hookDispatcher ?? null;
         this.runtimeBus = config.runtimeBus ?? null;
+        this.artifactStore = config.artifactStore ?? null;
         this.idleActiveMs = config.idleActiveMs ?? DEFAULT_IDLE_ACTIVE_MS;
         this.idleEmptyMs = config.idleEmptyMs ?? DEFAULT_IDLE_EMPTY_MS;
         // Persistence
@@ -109,15 +122,16 @@ export class CompanionChatManager {
         }
         const stored = await this.persistence.loadAll();
         for (const { meta, messages } of stored) {
+            const normalizedMessages = messages.map((message) => this.normalizeMessage(message));
             // Skip sessions that were already closed before the restart — they are
             // in a terminal state and don't need to be in memory.
             if (meta.status === 'closed')
                 continue;
             const conversation = new ConversationManager();
             // Replay messages into the conversation to restore LLM context
-            for (const msg of messages) {
+            for (const msg of normalizedMessages) {
                 if (msg.role === 'user') {
-                    conversation.addUserMessage(msg.content);
+                    conversation.addUserMessage(this.buildReplayUserContent(msg));
                 }
                 else {
                     conversation.addAssistantMessage(msg.content);
@@ -126,7 +140,7 @@ export class CompanionChatManager {
             this.sessions.set(meta.id, {
                 meta,
                 conversation,
-                messages: [...messages],
+                messages: normalizedMessages,
                 abortController: new AbortController(),
                 lastActivityAt: meta.updatedAt,
                 subscriberClientId: null,
@@ -192,6 +206,12 @@ export class CompanionChatManager {
     getMessages(sessionId) {
         return this.sessions.get(sessionId)?.messages ?? [];
     }
+    normalizeMessage(message) {
+        return {
+            ...message,
+            attachments: message.attachments ?? [],
+        };
+    }
     updateSession(sessionId, input) {
         assertCompleteProviderModelRoute(input);
         const session = this.sessions.get(sessionId);
@@ -255,8 +275,10 @@ export class CompanionChatManager {
      * @param clientId  - The SSE/HTTP client identity for per-client rate limiting.
      *                    Pass '' to skip client-level rate limiting.
      */
-    async postMessage(sessionId, content, clientId = '') {
-        return await this._postMessageInternal(sessionId, content, clientId);
+    async postMessage(sessionId, content, clientId = '', options = {}) {
+        return await this._postMessageInternal(sessionId, content, clientId, {
+            attachments: options.attachments,
+        });
     }
     async postMessageAndWaitForReply(sessionId, content, clientId = '', options = {}) {
         let messageId = '';
@@ -267,7 +289,10 @@ export class CompanionChatManager {
                 resolve({ messageId, error: 'Timed out waiting for companion chat reply' });
             }, options.timeoutMs ?? 120_000);
             timeout.unref?.();
-            void this._postMessageInternal(sessionId, content, clientId, { resolve, timeout })
+            void this._postMessageInternal(sessionId, content, clientId, {
+                pendingReply: { resolve, timeout },
+                attachments: options.attachments,
+            })
                 .then((id) => { messageId = id; })
                 .catch((error) => {
                 clearTimeout(timeout);
@@ -279,7 +304,7 @@ export class CompanionChatManager {
         });
         return result;
     }
-    async _postMessageInternal(sessionId, content, clientId, pendingReply) {
+    async _postMessageInternal(sessionId, content, clientId, options = {}) {
         const session = this.sessions.get(sessionId);
         if (!session) {
             throw Object.assign(new Error(`Session not found: ${sessionId}`), { code: 'SESSION_NOT_FOUND', status: 404 });
@@ -289,6 +314,10 @@ export class CompanionChatManager {
         }
         // Rate-limit check (throws GoodVibesSdkError on violation)
         this.rateLimiter?.check(sessionId, clientId);
+        const attachments = this.resolveAttachments(options.attachments ?? []);
+        if (!content.trim() && attachments.length === 0) {
+            throw Object.assign(new Error('content or attachments are required'), { code: 'INVALID_INPUT', status: 400 });
+        }
         const messageId = randomUUID();
         const now = Date.now();
         const userMsg = {
@@ -296,18 +325,19 @@ export class CompanionChatManager {
             sessionId,
             role: 'user',
             content,
+            attachments,
             createdAt: now,
         };
         session.messages.push(userMsg);
-        session.conversation.addUserMessage(content);
+        session.conversation.addUserMessage(await this.buildProviderUserContent(content, attachments));
         session.lastActivityAt = now;
         this._updateMeta(session, {
             messageCount: session.messages.length,
             updatedAt: now,
         });
         this._persist(sessionId);
-        if (pendingReply) {
-            this.pendingReplies.set(messageId, pendingReply);
+        if (options.pendingReply) {
+            this.pendingReplies.set(messageId, options.pendingReply);
         }
         void this._runTurn(session, messageId).catch((error) => {
             logger.warn('[companion-chat] turn execution failed', {
@@ -318,6 +348,106 @@ export class CompanionChatManager {
         });
         return messageId;
     }
+    resolveAttachments(inputs) {
+        if (inputs.length === 0)
+            return [];
+        if (inputs.length > MAX_ATTACHMENTS_PER_MESSAGE) {
+            throw Object.assign(new Error(`A companion chat message can include at most ${MAX_ATTACHMENTS_PER_MESSAGE} attachments.`), { code: 'TOO_MANY_ATTACHMENTS', status: 400 });
+        }
+        if (!this.artifactStore) {
+            throw Object.assign(new Error('Companion chat attachments require an artifact store.'), { code: 'ATTACHMENTS_UNAVAILABLE', status: 501 });
+        }
+        return inputs.map((input) => {
+            const artifactId = input.artifactId.trim();
+            if (!artifactId) {
+                throw Object.assign(new Error('Attachment artifactId is required.'), {
+                    code: 'INVALID_ATTACHMENT',
+                    status: 400,
+                });
+            }
+            const artifact = this.artifactStore.get(artifactId);
+            if (!artifact) {
+                throw Object.assign(new Error(`Unknown attachment artifact: ${artifactId}`), {
+                    code: 'UNKNOWN_ARTIFACT',
+                    status: 404,
+                });
+            }
+            return {
+                ...artifact,
+                artifactId: artifact.id,
+                ...(input.label?.trim() ? { label: input.label.trim() } : {}),
+                metadata: {
+                    ...artifact.metadata,
+                    ...(input.metadata ?? {}),
+                },
+            };
+        });
+    }
+    formatAttachmentSummary(attachments) {
+        if (attachments.length === 0)
+            return '';
+        const lines = attachments.map((attachment, index) => {
+            const name = attachment.label ?? attachment.filename ?? attachment.artifactId;
+            return `${index + 1}. ${name} (${attachment.mimeType}, ${attachment.sizeBytes} bytes, artifact ${attachment.artifactId})`;
+        });
+        return `\n\nAttached file${attachments.length === 1 ? '' : 's'}:\n${lines.join('\n')}`;
+    }
+    buildReplayUserContent(message) {
+        return `${message.content}${this.formatAttachmentSummary(message.attachments ?? [])}`;
+    }
+    isInlineTextAttachment(attachment) {
+        const lower = attachment.mimeType.toLowerCase();
+        return attachment.sizeBytes <= MAX_INLINE_TEXT_ATTACHMENT_BYTES
+            && (lower.startsWith('text/')
+                || lower === 'application/json'
+                || lower === 'application/xml'
+                || lower === 'application/yaml'
+                || lower === 'text/csv');
+    }
+    isInlineImageAttachment(attachment) {
+        const lower = attachment.mimeType.toLowerCase();
+        return attachment.sizeBytes <= MAX_INLINE_IMAGE_ATTACHMENT_BYTES
+            && (lower === 'image/png'
+                || lower === 'image/jpeg'
+                || lower === 'image/gif'
+                || lower === 'image/webp');
+    }
+    async buildProviderUserContent(content, attachments) {
+        if (attachments.length === 0)
+            return content;
+        const textSections = [content.trim() ? content : 'Please review the attached file(s).'];
+        const imageParts = [];
+        for (const attachment of attachments) {
+            if (!this.artifactStore)
+                continue;
+            try {
+                if (this.isInlineTextAttachment(attachment)) {
+                    const { buffer } = await this.artifactStore.readContent(attachment.artifactId);
+                    const text = toNodeBuffer(buffer).toString('utf-8');
+                    textSections.push(`\n\n--- Attachment: ${attachment.label ?? attachment.filename ?? attachment.artifactId} ---\n${text}`);
+                    continue;
+                }
+                if (this.isInlineImageAttachment(attachment)) {
+                    const { buffer } = await this.artifactStore.readContent(attachment.artifactId);
+                    imageParts.push({
+                        type: 'image',
+                        mediaType: attachment.mimeType,
+                        data: toNodeBuffer(buffer).toString('base64'),
+                    });
+                }
+            }
+            catch (error) {
+                logger.warn('[companion-chat] failed to inline attachment for provider prompt', {
+                    artifactId: attachment.artifactId,
+                    error: summarizeError(error),
+                });
+            }
+        }
+        textSections.push(this.formatAttachmentSummary(attachments));
+        if (imageParts.length === 0)
+            return textSections.join('');
+        return [{ type: 'text', text: textSections.join('') }, ...imageParts];
+    }
     dispose() {
         if (this.gcTimer) {
             clearInterval(this.gcTimer);
@@ -347,6 +477,7 @@ export class CompanionChatManager {
             body: userMsg?.content ?? '',
             source: 'companion-chat-user',
             timestamp: userMsg?.createdAt ?? Date.now(),
+            ...(userMsg?.attachments?.length ? { attachments: userMsg.attachments } : {}),
         };
         publish({ type: 'turn.started', sessionId, messageId: userMessageId, turnId, envelope: startEnvelope });
         let assistantContent = '';
@@ -435,6 +566,7 @@ export class CompanionChatManager {
                 sessionId,
                 role: 'assistant',
                 content: assistantContent,
+                attachments: [],
                 createdAt: now,
             };
             session.messages.push(assistantMsg);

package/dist/platform/companion/companion-chat-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"companion-chat-routes.d.ts","sourceRoot":"","sources":["../../../src/platform/companion/companion-chat-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAMjF;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAoD1B;AA8MD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAMlF"}
+{"version":3,"file":"companion-chat-routes.d.ts","sourceRoot":"","sources":["../../../src/platform/companion/companion-chat-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAMjF;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAoD1B;AA8MD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAMlF"}

package/dist/platform/companion/companion-chat-routes.js

@@ -225,6 +225,35 @@ export function readCompanionChatMessageBody(body) {
             ? body['content']
             : '';
 }
+function readCompanionChatAttachments(body) {
+    const raw = body['attachments'];
+    if (raw === undefined)
+        return [];
+    if (!Array.isArray(raw)) {
+        return Response.json({ error: 'attachments must be an array', code: 'INVALID_INPUT' }, { status: 400 });
+    }
+    const attachments = [];
+    for (const [index, item] of raw.entries()) {
+        if (typeof item !== 'object' || item === null || Array.isArray(item)) {
+            return Response.json({ error: `attachments[${index}] must be an object`, code: 'INVALID_INPUT' }, { status: 400 });
+        }
+        const record = item;
+        if (typeof record['artifactId'] !== 'string' || record['artifactId'].trim().length === 0) {
+            return Response.json({ error: `attachments[${index}].artifactId is required`, code: 'INVALID_INPUT' }, { status: 400 });
+        }
+        const attachment = {
+            artifactId: record['artifactId'].trim(),
+        };
+        if (typeof record['label'] === 'string' && record['label'].trim()) {
+            attachment.label = record['label'].trim();
+        }
+        if (typeof record['metadata'] === 'object' && record['metadata'] !== null && !Array.isArray(record['metadata'])) {
+            attachment.metadata = record['metadata'];
+        }
+        attachments.push(attachment);
+    }
+    return attachments;
+}
 // ---------------------------------------------------------------------------
 // POST /api/companion/chat/sessions/:sessionId/messages
 // ---------------------------------------------------------------------------
@@ -245,17 +274,23 @@ async function handlePostMessage(req, sessionId, context) {
         : typeof body['content'] === 'string'
             ? body['content']
             : '';
+    const attachments = readCompanionChatAttachments(body);
+    if (attachments instanceof Response)
+        return attachments;
     const input = {
         content: rawContent,
+        attachments,
         metadata: typeof body['metadata'] === 'object' && body['metadata'] !== null
             ? body['metadata']
             : undefined,
     };
-    if (!input.content.trim()) {
-        return Response.json({ error: 'content or body is required and must be a non-empty string', code: 'INVALID_INPUT' }, { status: 400 });
+    if (!input.content.trim() && attachments.length === 0) {
+        return Response.json({ error: 'content, body, or attachments are required', code: 'INVALID_INPUT' }, { status: 400 });
     }
     try {
-        const messageId = await context.chatManager.postMessage(sessionId, input.content);
+        const messageId = await context.chatManager.postMessage(sessionId, input.content, '', {
+            attachments: input.attachments,
+        });
         return Response.json({ messageId }, { status: 202 });
     }
     catch (err) {

package/dist/platform/companion/companion-chat-types.d.ts

@@ -7,6 +7,7 @@
  * via CompanionChatPersistence so they survive daemon restarts.
  */
 import type { ConversationMessageEnvelope } from '../control-plane/conversation-message.js';
+import type { ArtifactDescriptor } from '../artifacts/index.js';
 /**
  * Re-export the shared envelope so chat-mode code can import from one place.
  * The envelope shape is the canonical message unit flowing through
@@ -16,11 +17,21 @@ export type { ConversationMessageEnvelope } from '../control-plane/conversation-
 export type CompanionChatSessionKind = 'companion-chat';
 export type CompanionChatSessionStatus = 'active' | 'closed';
 export type CompanionChatMessageRole = 'user' | 'assistant';
+export interface CompanionChatMessageAttachmentInput {
+    readonly artifactId: string;
+    readonly label?: string | undefined;
+    readonly metadata?: Record<string, unknown> | undefined;
+}
+export interface CompanionChatMessageAttachment extends ArtifactDescriptor {
+    readonly artifactId: string;
+    readonly label?: string | undefined;
+}
 export interface CompanionChatMessage {
     readonly id: string;
     readonly sessionId: string;
     readonly role: CompanionChatMessageRole;
     readonly content: string;
+    readonly attachments: readonly CompanionChatMessageAttachment[];
     readonly createdAt: number;
 }
 export interface CompanionChatSession {
@@ -70,6 +81,7 @@ export interface UpdateCompanionChatSessionOutput {
 }
 export interface PostCompanionChatMessageInput {
     readonly content: string;
+    readonly attachments?: readonly CompanionChatMessageAttachmentInput[] | undefined;
     readonly metadata?: Record<string, unknown> | undefined;
 }
 export interface PostCompanionChatMessageOutput {

package/dist/platform/companion/companion-chat-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"companion-chat-types.d.ts","sourceRoot":"","sources":["../../../src/platform/companion/companion-chat-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"companion-chat-types.d.ts","sourceRoot":"","sources":["../../../src/platform/companion/companion-chat-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;GAIG;AACH,YAAY,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAE5F,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAExD,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,WAAW,8BAA+B,SAAQ,kBAAkB;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAMD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,mCAAmC,EAAE,GAAG,SAAS,CAAC;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAMD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B,2BAA2B,GAC3B,8BAA8B,GAC9B,gCAAgC,GAChC,+BAA+B,GAC/B,2BAA2B,CAAC"}

package/dist/platform/companion/index.d.ts

@@ -1,5 +1,5 @@
-export type { CompanionChatMessage, CompanionChatSession, CompanionChatSessionKind, CompanionChatSessionStatus, CompanionChatMessageRole, CompanionChatTurnEvent, CompanionChatTurnStartedEvent, CompanionChatTurnDeltaEvent, CompanionChatTurnToolCallEvent, CompanionChatTurnToolResultEvent, CompanionChatTurnCompletedEvent, CompanionChatTurnErrorEvent, CreateCompanionChatSessionInput, CreateCompanionChatSessionOutput, ListCompanionChatSessionsInput, ListCompanionChatSessionsOutput, UpdateCompanionChatSessionInput, UpdateCompanionChatSessionOutput, PostCompanionChatMessageInput, PostCompanionChatMessageOutput, GetCompanionChatSessionOutput, ConversationMessageEnvelope, } from './companion-chat-types.js';
-export type { CompanionLLMProvider, CompanionChatEventPublisher, CompanionChatManagerConfig, CompanionProviderMessage, CompanionProviderChunk, } from './companion-chat-manager.js';
+export type { CompanionChatMessage, CompanionChatMessageAttachment, CompanionChatMessageAttachmentInput, CompanionChatSession, CompanionChatSessionKind, CompanionChatSessionStatus, CompanionChatMessageRole, CompanionChatTurnEvent, CompanionChatTurnStartedEvent, CompanionChatTurnDeltaEvent, CompanionChatTurnToolCallEvent, CompanionChatTurnToolResultEvent, CompanionChatTurnCompletedEvent, CompanionChatTurnErrorEvent, CreateCompanionChatSessionInput, CreateCompanionChatSessionOutput, ListCompanionChatSessionsInput, ListCompanionChatSessionsOutput, UpdateCompanionChatSessionInput, UpdateCompanionChatSessionOutput, PostCompanionChatMessageInput, PostCompanionChatMessageOutput, GetCompanionChatSessionOutput, ConversationMessageEnvelope, } from './companion-chat-types.js';
+export type { CompanionLLMProvider, CompanionChatEventPublisher, CompanionChatManagerConfig, CompanionChatArtifactStore, CompanionProviderMessage, CompanionProviderChunk, } from './companion-chat-manager.js';
 export { CompanionChatManager } from './companion-chat-manager.js';
 export { dispatchCompanionChatRoutes } from './companion-chat-routes.js';
 export type { CompanionChatRouteContext } from './companion-chat-route-types.js';

package/dist/platform/companion/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/companion/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,gCAAgC,EAChC,+BAA+B,EAC/B,2BAA2B,EAC3B,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,+BAA+B,EAC/B,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAEjF,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,YAAY,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/companion/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,8BAA8B,EAC9B,mCAAmC,EACnC,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,gCAAgC,EAChC,+BAA+B,EAC/B,2BAA2B,EAC3B,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,+BAA+B,EAC/B,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAEjF,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,YAAY,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/platform/control-plane/conversation-message.d.ts

@@ -1,3 +1,4 @@
+import type { ArtifactDescriptor } from '../artifacts/index.js';
 /**
  * conversation-message.ts
  *
@@ -23,6 +24,11 @@ export interface ConversationMessageEnvelope {
     readonly body: string;
     readonly source: MessageSource;
     readonly timestamp: number;
+    /** Artifacts attached to this conversation message. */
+    readonly attachments?: readonly (ArtifactDescriptor & {
+        readonly artifactId: string;
+        readonly label?: string | undefined;
+    })[] | undefined;
     /** Optional metadata for tool info, model id, etc. */
     readonly metadata?: Readonly<Record<string, unknown>> | undefined;
 }

package/dist/platform/control-plane/conversation-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-message.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/conversation-message.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,qBAAqB,GACrB,0BAA0B,GAC1B,oBAAoB,GACpB,WAAW,GACX,QAAQ,GACR,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACnE"}
+{"version":3,"file":"conversation-message.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/conversation-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,qBAAqB,GACrB,0BAA0B,GAC1B,oBAAoB,GACpB,WAAW,GACX,QAAQ,GACR,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,kBAAkB,GAAG;QACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACrC,CAAC,EAAE,GAAG,SAAS,CAAC;IACjB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACnE"}

package/dist/platform/control-plane/conversation-message.js

@@ -1,9 +1 @@
-/**
- * conversation-message.ts
- *
- * Shared envelope types for conversation messages flowing through the
- * control-plane gateway. All consumers — SSE companion-chat streams,
- * TUI-surface follow-up listeners, and web-UI clients — depend on this
- * stable shape.
- */
 export {};

package/dist/platform/control-plane/method-catalog-control-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"method-catalog-control-core.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/method-catalog-control-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AA4D1E,eAAO,MAAM,0CAA0C,EAAE,SAAS,uBAAuB,EAknBxF,CAAC"}
+{"version":3,"file":"method-catalog-control-core.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/method-catalog-control-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AA4D1E,eAAO,MAAM,0CAA0C,EAAE,SAAS,uBAAuB,EAunBxF,CAAC"}

package/dist/platform/control-plane/method-catalog-control-core.js

@@ -591,13 +591,18 @@ export const builtinGatewayControlCoreMethodDescriptors = [
     methodDescriptor({
         id: 'companion.chat.messages.create',
         title: 'Send Companion Chat Message',
-        description: 'Post a user message to a companion-chat session. Accepts either `body` or `content` in the payload; `body` wins when both are provided.',
+        description: 'Post a user message to a companion-chat session. Accepts either `body` or `content` in the payload; `body` wins when both are provided. Attachments reference artifacts created through `artifacts.create`.',
         category: 'companion',
         scopes: ['write:sessions'],
         http: { method: 'POST', path: '/api/companion/chat/sessions/{sessionId}/messages' },
         inputSchema: bodyEnvelopeSchema({
             body: STRING_SCHEMA,
             content: STRING_SCHEMA,
+            attachments: arraySchema(objectSchema({
+                artifactId: STRING_SCHEMA,
+                label: STRING_SCHEMA,
+                metadata: objectSchema({}, []),
+            }, ['artifactId'])),
             metadata: objectSchema({}, []),
         }, []),
         outputSchema: objectSchema({

package/dist/platform/control-plane/method-catalog-knowledge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"method-catalog-knowledge.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/method-catalog-knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AA6D1E,eAAO,MAAM,wCAAwC,EAAE,SAAS,uBAAuB,EA8tBtF,CAAC"}
+{"version":3,"file":"method-catalog-knowledge.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/method-catalog-knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAkE1E,eAAO,MAAM,wCAAwC,EAAE,SAAS,uBAAuB,EAmuBtF,CAAC"}

package/dist/platform/control-plane/method-catalog-knowledge.js

@@ -3,6 +3,10 @@ import { builtinGatewayHomeGraphMethodDescriptors } from './method-catalog-homeg
 import { GRAPHQL_VARIABLES_SCHEMA, JSON_RECORD_SCHEMA, METADATA_SCHEMA, STRING_LIST_SCHEMA } from './operator-contract-schemas-shared.js';
 import { KNOWLEDGE_BATCH_INGEST_RESULT_SCHEMA, KNOWLEDGE_BROWSER_SYNC_RESULT_SCHEMA, KNOWLEDGE_ASK_OUTPUT_SCHEMA, KNOWLEDGE_CONSOLIDATION_DECISION_SCHEMA, KNOWLEDGE_CANDIDATE_OUTPUT_SCHEMA, KNOWLEDGE_CANDIDATES_OUTPUT_SCHEMA, KNOWLEDGE_CONNECTOR_INGEST_INPUT_SCHEMA, KNOWLEDGE_CONNECTOR_DOCTOR_OUTPUT_SCHEMA, KNOWLEDGE_CONNECTORS_OUTPUT_SCHEMA, KNOWLEDGE_CONNECTOR_ENTITY_OUTPUT_SCHEMA, KNOWLEDGE_EXTRACTION_OUTPUT_SCHEMA, KNOWLEDGE_EXTRACTIONS_OUTPUT_SCHEMA, KNOWLEDGE_GRAPHQL_EXECUTE_OUTPUT_SCHEMA, KNOWLEDGE_GRAPHQL_SCHEMA_OUTPUT_SCHEMA, KNOWLEDGE_INGEST_RESULT_SCHEMA, KNOWLEDGE_ITEM_ENTITY_OUTPUT_SCHEMA, KNOWLEDGE_JOB_OUTPUT_SCHEMA, KNOWLEDGE_JOB_RUN_OUTPUT_SCHEMA, KNOWLEDGE_JOB_RUN_REQUEST_SCHEMA, KNOWLEDGE_JOB_RUNS_OUTPUT_SCHEMA, KNOWLEDGE_JOBS_OUTPUT_SCHEMA, KNOWLEDGE_LINT_OUTPUT_SCHEMA, KNOWLEDGE_MAP_OUTPUT_SCHEMA, KNOWLEDGE_MATERIALIZED_PROJECTION_SCHEMA, KNOWLEDGE_NODES_OUTPUT_SCHEMA, KNOWLEDGE_PACKET_SCHEMA, KNOWLEDGE_PACKET_DETAIL_SCHEMA, KNOWLEDGE_PROJECTION_BUNDLE_SCHEMA, KNOWLEDGE_PROJECTION_TARGETS_OUTPUT_SCHEMA, KNOWLEDGE_REINDEX_OUTPUT_SCHEMA, KNOWLEDGE_REFINEMENT_RUN_OUTPUT_SCHEMA, KNOWLEDGE_REFINEMENT_TASK_OUTPUT_SCHEMA, KNOWLEDGE_REFINEMENT_TASKS_OUTPUT_SCHEMA, KNOWLEDGE_REPORT_OUTPUT_SCHEMA, KNOWLEDGE_REPORTS_OUTPUT_SCHEMA, KNOWLEDGE_SCHEDULE_INPUT_SCHEMA, KNOWLEDGE_SCHEDULE_OUTPUT_SCHEMA, KNOWLEDGE_SCHEDULES_OUTPUT_SCHEMA, KNOWLEDGE_SEARCH_OUTPUT_SCHEMA, KNOWLEDGE_SOURCE_TYPE_SCHEMA, KNOWLEDGE_SOURCES_OUTPUT_SCHEMA, KNOWLEDGE_STATUS_SCHEMA, KNOWLEDGE_ISSUE_REVIEW_OUTPUT_SCHEMA, KNOWLEDGE_ISSUES_OUTPUT_SCHEMA, KNOWLEDGE_USAGE_OUTPUT_SCHEMA, } from './operator-contract-schemas-knowledge.js';
 import { PROJECT_PLANNING_DECISION_OUTPUT_SCHEMA, PROJECT_PLANNING_DECISIONS_OUTPUT_SCHEMA, PROJECT_PLANNING_EVALUATION_SCHEMA, PROJECT_PLANNING_LANGUAGE_OUTPUT_SCHEMA, PROJECT_PLANNING_SPACE_INPUT_SCHEMA, PROJECT_PLANNING_STATE_OUTPUT_SCHEMA, PROJECT_PLANNING_STATUS_SCHEMA, } from './operator-contract-schemas-project-planning.js';
+const KNOWLEDGE_SPACE_INPUT_FIELDS = {
+    knowledgeSpaceId: STRING_SCHEMA,
+    includeAllSpaces: BOOLEAN_SCHEMA,
+};
 export const builtinGatewayKnowledgeMethodDescriptors = [
     methodDescriptor({
         id: 'knowledge.status',
@@ -11,7 +15,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         category: 'knowledge',
         scopes: ['read:knowledge'],
         http: { method: 'GET', path: '/api/knowledge/status' },
-        inputSchema: EMPTY_OBJECT_SCHEMA,
+        inputSchema: objectSchema(KNOWLEDGE_SPACE_INPUT_FIELDS),
         outputSchema: KNOWLEDGE_STATUS_SCHEMA,
     }),
     methodDescriptor({
@@ -21,7 +25,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         category: 'knowledge',
         scopes: ['read:knowledge'],
         http: { method: 'GET', path: '/api/knowledge/sources' },
-        inputSchema: objectSchema({ limit: NUMBER_SCHEMA }),
+        inputSchema: objectSchema({ limit: NUMBER_SCHEMA, ...KNOWLEDGE_SPACE_INPUT_FIELDS }),
         outputSchema: KNOWLEDGE_SOURCES_OUTPUT_SCHEMA,
     }),
     methodDescriptor({
@@ -31,7 +35,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         category: 'knowledge',
         scopes: ['read:knowledge'],
         http: { method: 'GET', path: '/api/knowledge/nodes' },
-        inputSchema: objectSchema({ limit: NUMBER_SCHEMA }),
+        inputSchema: objectSchema({ limit: NUMBER_SCHEMA, ...KNOWLEDGE_SPACE_INPUT_FIELDS }),
         outputSchema: KNOWLEDGE_NODES_OUTPUT_SCHEMA,
     }),
     methodDescriptor({
@@ -41,7 +45,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         category: 'knowledge',
         scopes: ['read:knowledge'],
         http: { method: 'GET', path: '/api/knowledge/issues' },
-        inputSchema: objectSchema({ limit: NUMBER_SCHEMA }),
+        inputSchema: objectSchema({ limit: NUMBER_SCHEMA, ...KNOWLEDGE_SPACE_INPUT_FIELDS }),
         outputSchema: KNOWLEDGE_ISSUES_OUTPUT_SCHEMA,
     }),
     methodDescriptor({
@@ -67,7 +71,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         category: 'knowledge',
         scopes: ['read:knowledge'],
         http: { method: 'GET', path: '/api/knowledge/items/{id}' },
-        inputSchema: objectSchema({ id: STRING_SCHEMA }, ['id']),
+        inputSchema: objectSchema({ id: STRING_SCHEMA, ...KNOWLEDGE_SPACE_INPUT_FIELDS }, ['id']),
         outputSchema: KNOWLEDGE_ITEM_ENTITY_OUTPUT_SCHEMA,
     }),
     methodDescriptor({
@@ -220,6 +224,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         inputSchema: bodyEnvelopeSchema({
             query: STRING_SCHEMA,
             limit: NUMBER_SCHEMA,
+            ...KNOWLEDGE_SPACE_INPUT_FIELDS,
             includeSources: BOOLEAN_SCHEMA,
             includeNodes: BOOLEAN_SCHEMA,
             metadata: METADATA_SCHEMA,
@@ -256,7 +261,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         category: 'knowledge',
         scopes: ['read:knowledge'],
         http: { method: 'GET', path: '/api/knowledge/extractions' },
-        inputSchema: objectSchema({ limit: NUMBER_SCHEMA, sourceId: STRING_SCHEMA }),
+        inputSchema: objectSchema({ limit: NUMBER_SCHEMA, sourceId: STRING_SCHEMA, ...KNOWLEDGE_SPACE_INPUT_FIELDS }),
         outputSchema: KNOWLEDGE_EXTRACTIONS_OUTPUT_SCHEMA,
     }),
     methodDescriptor({
@@ -291,6 +296,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
             writeScope: arraySchema(STRING_SCHEMA),
             budgetLimit: NUMBER_SCHEMA,
             detail: KNOWLEDGE_PACKET_DETAIL_SCHEMA,
+            ...KNOWLEDGE_SPACE_INPUT_FIELDS,
         }, ['task']),
         outputSchema: KNOWLEDGE_PACKET_SCHEMA,
     }),
@@ -347,7 +353,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         category: 'knowledge',
         scopes: ['read:knowledge'],
         http: { method: 'GET', path: '/api/knowledge/reports' },
-        inputSchema: objectSchema({ limit: NUMBER_SCHEMA }),
+        inputSchema: objectSchema({ limit: NUMBER_SCHEMA, ...KNOWLEDGE_SPACE_INPUT_FIELDS }),
         outputSchema: KNOWLEDGE_REPORTS_OUTPUT_SCHEMA,
     }),
     methodDescriptor({
@@ -563,6 +569,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
         http: { method: 'GET', path: '/api/knowledge/map' },
         inputSchema: objectSchema({
             limit: NUMBER_SCHEMA,
+            ...KNOWLEDGE_SPACE_INPUT_FIELDS,
             includeSources: BOOLEAN_SCHEMA,
             includeIssues: BOOLEAN_SCHEMA,
             includeGenerated: BOOLEAN_SCHEMA,
@@ -594,6 +601,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
             kind: STRING_SCHEMA,
             id: STRING_SCHEMA,
             limit: NUMBER_SCHEMA,
+            ...KNOWLEDGE_SPACE_INPUT_FIELDS,
         }, ['kind']),
         outputSchema: KNOWLEDGE_PROJECTION_BUNDLE_SCHEMA,
     }),
@@ -609,6 +617,7 @@ export const builtinGatewayKnowledgeMethodDescriptors = [
             kind: STRING_SCHEMA,
             id: STRING_SCHEMA,
             limit: NUMBER_SCHEMA,
+            ...KNOWLEDGE_SPACE_INPUT_FIELDS,
         }, ['kind']),
         outputSchema: KNOWLEDGE_MATERIALIZED_PROJECTION_SCHEMA,
     }),

package/dist/platform/control-plane/operator-contract-schemas-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operator-contract-schemas-runtime.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/operator-contract-schemas-runtime.ts"],"names":[],"mappings":"AA8CA,eAAO,MAAM,iCAAiC,yBAQA,CAAC;AAE/C,eAAO,MAAM,6BAA6B,yBAasB,CAAC;AAEjE,eAAO,MAAM,4BAA4B,yBAmBqI,CAAC;AAE/K,eAAO,MAAM,6BAA6B,yBAYsF,CAAC;AAEjI,eAAO,MAAM,6BAA6B,yBAMa,CAAC;AAExD,eAAO,MAAM,2CAA2C,yBAG7B,CAAC;AAE5B,eAAO,MAAM,mCAAmC,yBAOtB,CAAC;AAE3B,eAAO,MAAM,mCAAmC,yBAGnB,CAAC;AAE9B,eAAO,MAAM,oCAAoC,yBAkB/C,CAAC;AAEH,eAAO,MAAM,kCAAkC,yBAqB0D,CAAC;AAE1G,eAAO,MAAM,uBAAuB,yBAWoE,CAAC;AAEzG,eAAO,MAAM,8BAA8B,yBAOjB,CAAC;AAE3B,eAAO,MAAM,mCAAmC,yBAGrB,CAAC;AAE5B,eAAO,MAAM,iCAAiC,yBAGrB,CAAC;AAE1B,eAAO,MAAM,mCAAmC,yBAEjC,CAAC;AAEhB,eAAO,MAAM,+CAA+C,yBAIlB,CAAC;AAE3C,eAAO,MAAM,2CAA2C,yBAMF,CAAC;AAEvD,eAAO,MAAM,0CAA0C;;CAK7C,CAAC;AAUX,eAAO,MAAM,mBAAmB,yBAqByD,CAAC;AAE1F,eAAO,MAAM,oBAAoB,yBAsBsB,CAAC;AAExD,eAAO,MAAM,wBAAwB,yBAgBO,CAAC;AAE7C,eAAO,MAAM,yBAAyB,yBASc,CAAC;AAErD,eAAO,MAAM,kBAAkB,yBAEnB,CAAC;AAEb,eAAO,MAAM,yBAAyB,yBAIM,CAAC;AAE7C,eAAO,MAAM,yBAAyB,yBAUiE,CAAC;AAWxG,eAAO,MAAM,6BAA6B,yBAgB8C,CAAC;AAEzF,eAAO,MAAM,wBAAwB,yBASuG,CAAC;AAE7I,eAAO,MAAM,4BAA4B,yBAIU,CAAC;AAEpD,eAAO,MAAM,6BAA6B,yBAE1B,CAAC;AA0EjB,eAAO,MAAM,gCAAgC,yBAMkB,CAAC;AAEhE,eAAO,MAAM,8BAA8B,yBAcqD,CAAC;AAqEjG,eAAO,MAAM,gCAAgC,yBAKmB,CAAC;AAEjE,eAAO,MAAM,sBAAsB,yBAcyF,CAAC;AAE7H,eAAO,MAAM,4BAA4B,yBASyG,CAAC;AAqBnJ,eAAO,MAAM,0BAA0B,yBAUyH,CAAC;AAEjK,eAAO,MAAM,2BAA2B,yBAIC,CAAC"}
+{"version":3,"file":"operator-contract-schemas-runtime.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/operator-contract-schemas-runtime.ts"],"names":[],"mappings":"AA+DA,eAAO,MAAM,iCAAiC,yBAQA,CAAC;AAE/C,eAAO,MAAM,6BAA6B,yBAasB,CAAC;AAEjE,eAAO,MAAM,4BAA4B,yBAmBqI,CAAC;AAE/K,eAAO,MAAM,6BAA6B,yBAYsF,CAAC;AAEjI,eAAO,MAAM,6BAA6B,yBAO4B,CAAC;AAEvE,eAAO,MAAM,2CAA2C,yBAG7B,CAAC;AAE5B,eAAO,MAAM,mCAAmC,yBAOtB,CAAC;AAE3B,eAAO,MAAM,mCAAmC,yBAGnB,CAAC;AAE9B,eAAO,MAAM,oCAAoC,yBAkB/C,CAAC;AAEH,eAAO,MAAM,kCAAkC,yBAqB0D,CAAC;AAE1G,eAAO,MAAM,uBAAuB,yBAWoE,CAAC;AAEzG,eAAO,MAAM,8BAA8B,yBAOjB,CAAC;AAE3B,eAAO,MAAM,mCAAmC,yBAGrB,CAAC;AAE5B,eAAO,MAAM,iCAAiC,yBAGrB,CAAC;AAE1B,eAAO,MAAM,mCAAmC,yBAEjC,CAAC;AAEhB,eAAO,MAAM,+CAA+C,yBAIlB,CAAC;AAE3C,eAAO,MAAM,2CAA2C,yBAMF,CAAC;AAEvD,eAAO,MAAM,0CAA0C;;CAK7C,CAAC;AAUX,eAAO,MAAM,mBAAmB,yBAqByD,CAAC;AAE1F,eAAO,MAAM,oBAAoB,yBAsBsB,CAAC;AAExD,eAAO,MAAM,wBAAwB,yBAgBO,CAAC;AAE7C,eAAO,MAAM,yBAAyB,yBASc,CAAC;AAErD,eAAO,MAAM,kBAAkB,yBAEnB,CAAC;AAEb,eAAO,MAAM,yBAAyB,yBAIM,CAAC;AAE7C,eAAO,MAAM,yBAAyB,yBAUiE,CAAC;AAWxG,eAAO,MAAM,6BAA6B,yBAgB8C,CAAC;AAEzF,eAAO,MAAM,wBAAwB,yBASuG,CAAC;AAE7I,eAAO,MAAM,4BAA4B,yBAIU,CAAC;AAEpD,eAAO,MAAM,6BAA6B,yBAE1B,CAAC;AA0EjB,eAAO,MAAM,gCAAgC,yBAMkB,CAAC;AAEhE,eAAO,MAAM,8BAA8B,yBAcqD,CAAC;AAqEjG,eAAO,MAAM,gCAAgC,yBAKmB,CAAC;AAEjE,eAAO,MAAM,sBAAsB,yBAcyF,CAAC;AAE7H,eAAO,MAAM,4BAA4B,yBASyG,CAAC;AAqBnJ,eAAO,MAAM,0BAA0B,yBAUyH,CAAC;AAEjK,eAAO,MAAM,2BAA2B,yBAIC,CAAC"}

package/dist/platform/control-plane/operator-contract-schemas-runtime.js

@@ -24,6 +24,22 @@ const PROVIDER_FAILURE_POLICY_SCHEMA = enumSchema(['ordered-fallbacks', 'fail'])
 const EXECUTION_RISK_CLASS_SCHEMA = enumSchema(['safe', 'elevated', 'dangerous']);
 const EXECUTION_NETWORK_POLICY_SCHEMA = enumSchema(['inherit', 'allow', 'deny', 'scoped']);
 const EXECUTION_FILESYSTEM_POLICY_SCHEMA = enumSchema(['inherit', 'workspace-write', 'read-only', 'isolated']);
+const COMPANION_CHAT_ATTACHMENT_SCHEMA = objectSchema({
+    id: STRING_SCHEMA,
+    artifactId: STRING_SCHEMA,
+    kind: STRING_SCHEMA,
+    mimeType: STRING_SCHEMA,
+    filename: STRING_SCHEMA,
+    sizeBytes: NUMBER_SCHEMA,
+    sha256: STRING_SCHEMA,
+    createdAt: NUMBER_SCHEMA,
+    expiresAt: NUMBER_SCHEMA,
+    sourceUri: STRING_SCHEMA,
+    acquisitionMode: STRING_SCHEMA,
+    fetchMode: STRING_SCHEMA,
+    label: STRING_SCHEMA,
+    metadata: METADATA_SCHEMA,
+}, ['id', 'artifactId', 'kind', 'mimeType', 'sizeBytes', 'sha256', 'createdAt', 'metadata'], { additionalProperties: true });
 export const SHARED_SESSION_PARTICIPANT_SCHEMA = objectSchema({
     surfaceKind: STRING_SCHEMA,
     surfaceId: STRING_SCHEMA,
@@ -85,8 +101,9 @@ export const COMPANION_CHAT_MESSAGE_SCHEMA = objectSchema({
     sessionId: STRING_SCHEMA,
     role: COMPANION_CHAT_MESSAGE_ROLE_SCHEMA,
     content: STRING_SCHEMA,
+    attachments: arraySchema(COMPANION_CHAT_ATTACHMENT_SCHEMA),
     createdAt: NUMBER_SCHEMA,
-}, ['id', 'sessionId', 'role', 'content', 'createdAt']);
+}, ['id', 'sessionId', 'role', 'content', 'attachments', 'createdAt']);
 export const COMPANION_CHAT_SESSION_WITH_MESSAGES_SCHEMA = objectSchema({
     session: COMPANION_CHAT_SESSION_SCHEMA,
     messages: arraySchema(COMPANION_CHAT_MESSAGE_SCHEMA),