@canonmsg/agent-sdk 1.1.3 → 1.1.4

package/dist/canon-agent.js

@@ -2,7 +2,7 @@ import { CanonClient, createRuntimeStatePublisher, FINAL_MESSAGE_HANDOFF_MS, ini
 import { randomUUID } from 'node:crypto';
 import { AuthManager } from './auth.js';
 import { Debouncer } from './debouncer.js';
-import { materializeMessageMedia, uploadMediaFile, } from './media.js';
+import { materializeMessageMedia, sendMediaFileMessage, uploadMediaFile, } from './media.js';
 import { SessionManager } from './session-manager.js';
 const AGENT_RUNTIME_HEARTBEAT_MS = 30_000;
 const SDK_RUNTIME_CAPABILITIES = {
@@ -741,8 +741,7 @@ export class CanonAgent {
                 }
                 catch { }
                 try {
-                    const uploaded = await uploadFile(filePath, options);
-                    const result = await this.apiClient.sendMessage(conversationId, text, {
+                    const result = await sendMediaFileMessage(this.apiClient, conversationId, filePath, text, {
                         ...(options?.replyTo ? { replyTo: options.replyTo } : {}),
                         ...(options?.replyToPosition != null
                             ? { replyToPosition: options.replyToPosition }
@@ -757,8 +756,9 @@ export class CanonAgent {
                             turnSemantics: 'turn_complete',
                             turnComplete: true,
                         },
-                        contentType: uploaded.attachment.kind,
-                        attachments: [uploaded.attachment],
+                        ...(options?.fileName ? { fileName: options.fileName } : {}),
+                        ...(options?.mimeType ? { mimeType: options.mimeType } : {}),
+                        ...(options?.durationMs != null ? { durationMs: options.durationMs } : {}),
                     });
                     await sleep(FINAL_MESSAGE_HANDOFF_MS);
                     return result;

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { AgentContactsAPI, AgentUsersAPI } from './canon-agent.js';
 export { CanonApiError, HOST_ADMISSION_ACTION_CAPABILITIES, HOST_ADMISSION_ACTIONS_DISABLED, } from '@canonmsg/core';
 export type { CanonContact, CanonResolveAdmissionResult, ContactAddedPayload, ContactCardPayload, ContactRemovedPayload, ContactSource, HostAdmissionActionCapabilities, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, } from '@canonmsg/core';
 export { SessionManager } from './session-manager.js';
-export { getCodexImagePath, getMessageAttachments, inferUploadMimeType, isAnthropicImageAttachment, materializeAttachment, materializeMessageMedia, resolveAttachmentMimeType, toAnthropicImageBlock, uploadMediaFile, } from './media.js';
+export { DEFAULT_MEDIA_CACHE_DIR, getCodexImagePath, getMessageAttachments, inferUploadMimeType, isAnthropicImageAttachment, materializeAttachment, materializeMessageMedia, resolveAttachmentMimeType, sendMediaFileMessage, toAnthropicImageBlock, uploadMediaFile, } from './media.js';
 export type { AnthropicImageBlock, AnthropicImageMimeType, MaterializeMediaOptions, MaterializedCanonAttachment, ReplyWithFileOptions, UploadMediaFileOptions, } from './media.js';
 export type { SessionConfig, Session } from './session-manager.js';
 export type { AgentContext, CanonContactRequest, CanonMessage, CanonConversation, CanonSelfContext, SendContextualMessageOptions, SendContextualMessageResult, SendContextualSelfContextInput, SendMessageOptions, CreateConversationOptions, } from '@canonmsg/core';

package/dist/index.js

@@ -1,4 +1,4 @@
 export { CanonAgent } from './canon-agent.js';
 export { CanonApiError, HOST_ADMISSION_ACTION_CAPABILITIES, HOST_ADMISSION_ACTIONS_DISABLED, } from '@canonmsg/core';
 export { SessionManager } from './session-manager.js';
-export { getCodexImagePath, getMessageAttachments, inferUploadMimeType, isAnthropicImageAttachment, materializeAttachment, materializeMessageMedia, resolveAttachmentMimeType, toAnthropicImageBlock, uploadMediaFile, } from './media.js';
+export { DEFAULT_MEDIA_CACHE_DIR, getCodexImagePath, getMessageAttachments, inferUploadMimeType, isAnthropicImageAttachment, materializeAttachment, materializeMessageMedia, resolveAttachmentMimeType, sendMediaFileMessage, toAnthropicImageBlock, uploadMediaFile, } from './media.js';

package/dist/media.d.ts

@@ -10,6 +10,7 @@ export interface MaterializeMediaOptions {
 export interface UploadMediaFileOptions {
     fileName?: string;
     mimeType?: string;
+    durationMs?: number;
 }
 export interface ReplyWithFileOptions extends Omit<SendMessageOptions, 'attachments' | 'contentType'>, UploadMediaFileOptions {
 }
@@ -39,6 +40,7 @@ export interface AnthropicImageBlock {
         data: string;
     };
 }
+export declare const DEFAULT_MEDIA_CACHE_DIR: string;
 export declare function getMessageAttachments(message: Pick<CanonMessage, 'attachments'>): MediaAttachment[];
 export declare function materializeAttachment(attachment: MediaAttachment, options: MaterializeMediaOptions & {
     index?: number;
@@ -49,6 +51,9 @@ export declare function uploadMediaFile(client: CanonClient, conversationId: str
     url: string;
     attachment: MediaAttachment;
 }>;
+export declare function sendMediaFileMessage(client: CanonClient, conversationId: string, filePath: string, text?: string, options?: ReplyWithFileOptions): Promise<{
+    messageId: string;
+}>;
 /**
  * Resolve the effective MIME type of a materialized attachment, falling back
  * to filename/URL extensions when the server didn't tell us explicitly.

package/dist/media.js

@@ -7,7 +7,7 @@ const ANTHROPIC_IMAGE_MIME_TYPES = new Set([
     'image/gif',
     'image/webp',
 ]);
-const DEFAULT_MEDIA_CACHE_DIR = join(CANON_DIR, 'media-cache');
+export const DEFAULT_MEDIA_CACHE_DIR = join(CANON_DIR, 'media-cache');
 const EXTENSION_BY_MIME = {
     'application/json': 'json',
     'application/pdf': 'pdf',
@@ -117,7 +117,7 @@ export async function materializeAttachment(attachment, options) {
         }
         responseMimeType = response.headers.get('content-type');
         const body = Buffer.from(await response.arrayBuffer());
-        await writeFile(path, body);
+        await writeFile(path, body, { mode: 0o644 });
     }
     return {
         ...attachment,
@@ -150,7 +150,33 @@ export async function uploadMediaFile(client, conversationId, filePath, options)
     const buffer = await readFile(filePath);
     const mimeType = inferUploadMimeType(filePath, options?.mimeType);
     const fileName = options?.fileName ?? basename(filePath);
-    return client.uploadMedia(conversationId, buffer.toString('base64'), mimeType, fileName);
+    const uploaded = await client.uploadMedia(conversationId, buffer.toString('base64'), mimeType, fileName);
+    if (uploaded.attachment.kind === 'audio'
+        && typeof options?.durationMs === 'number'
+        && Number.isFinite(options.durationMs)
+        && options.durationMs > 0) {
+        return {
+            ...uploaded,
+            attachment: {
+                ...uploaded.attachment,
+                durationMs: Math.round(options.durationMs),
+            },
+        };
+    }
+    return uploaded;
+}
+export async function sendMediaFileMessage(client, conversationId, filePath, text = '', options) {
+    const { fileName, mimeType, durationMs, ...sendOptions } = options ?? {};
+    const uploaded = await uploadMediaFile(client, conversationId, filePath, {
+        ...(fileName ? { fileName } : {}),
+        ...(mimeType ? { mimeType } : {}),
+        ...(durationMs != null ? { durationMs } : {}),
+    });
+    return client.sendMessage(conversationId, text, {
+        ...sendOptions,
+        contentType: uploaded.attachment.kind,
+        attachments: [uploaded.attachment],
+    });
 }
 /**
  * Resolve the effective MIME type of a materialized attachment, falling back

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Canon Agent SDK — build AI agents that participate in Canon conversations",
   "type": "module",
   "main": "dist/index.js",