@keemakr/agent-sdk 0.19.0-dev-20261014074621 → 0.19.0-dev-20261014094355

package/dist/canvases.d.ts

@@ -47,3 +47,27 @@ export declare function imageCanvas(input: {
     width?: number;
     height?: number;
 }): ImageCanvas;
+/**
+ * An audio clip, shown inline in the chat as a player: speech you made, a recording you fetched.
+ *
+ * Core keeps its own copy of the file when it writes the card, so the clip still plays after your
+ * URL expires, and the URL must be reachable from the public internet for that copy. The file
+ * must be mp3, wav, ogg, flac, m4a or webm audio, up to 25 MB; a card whose file core cannot copy
+ * keeps your URL.
+ */
+export interface AudioCanvas {
+    type: 'audio';
+    url: string;
+    /** A short name for the clip, shown on the card. */
+    title?: string;
+    /** What the clip says. Shown to a person who would rather read, and by a client that cannot play it. */
+    transcript?: string;
+    duration_seconds?: number;
+}
+/** Build an audio card, refusing a URL that would not reach a reader (see `imageCanvas`). */
+export declare function audioCanvas(input: {
+    url: string;
+    title?: string;
+    transcript?: string;
+    duration_seconds?: number;
+}): AudioCanvas;

package/dist/canvases.js

@@ -45,3 +45,23 @@ export function imageCanvas(input) {
         ...(input.height === undefined ? {} : { height: input.height }),
     };
 }
+/** Build an audio card, refusing a URL that would not reach a reader (see `imageCanvas`). */
+export function audioCanvas(input) {
+    let parsed;
+    try {
+        parsed = new URL(input.url);
+    }
+    catch {
+        throw new TypeError(`audioCanvas: not a URL: ${input.url}`);
+    }
+    if (parsed.protocol !== 'https:') {
+        throw new TypeError(`audioCanvas: audio must be https, not "${parsed.protocol}"`);
+    }
+    return {
+        type: 'audio',
+        url: input.url,
+        ...(input.title === undefined ? {} : { title: input.title }),
+        ...(input.transcript === undefined ? {} : { transcript: input.transcript }),
+        ...(input.duration_seconds === undefined ? {} : { duration_seconds: input.duration_seconds }),
+    };
+}

package/dist/index.d.ts

@@ -5,5 +5,5 @@ export { verifyConnectorCall, verifyConnectorRequest, verifyMcpToolCall, memoryR
 export { useKee, MemoryConflictError, RecordConflictError, RecordValidationError, type Kee, type KeeConnection, type KeeContext, type KeeError, type KeeMemory, type KeeRecords, type KeeKb, type KBHit, type KeeTools, type KeeConfig, type KeeProgress, type ProgressFields, type ProgressUpdate, type ProgressReportResult, type KeeState, type StatePublish, type StatePublishResult, type StatePublishReason, type StateEvent, type StateNextAction, type StatePublishField, type MemoryEntry, type MemorySearchHit, type RecordEntry, type KeeRate, type RateDecision, type KeeWriteOptions, } from './client.js';
 export { keemakrToolDirectory } from './tool-directory.js';
 export { refreshGrant, REFRESH_THRESHOLD_SECONDS } from './refresh.js';
-export { imageCanvas, type Canvas, type ImageCanvas, type ReportCanvas } from './canvases.js';
+export { audioCanvas, imageCanvas, type AudioCanvas, type Canvas, type ImageCanvas, type ReportCanvas, } from './canvases.js';
 export { createChannelAgent, assertTrustworthyCore, ChannelReachError, ChannelReplyNotDeliverable, isApprovalRequired, isHoldSettled, isOutcomeUnknown, isWriteDone, type ChannelWriteDone, type ChannelWriteResult, type ChannelWriteOptions, type ChannelApprovalRequired, type ChannelHoldSettled, type ChannelOutcomeUnknown, type HeldActionStatus, type ChannelReach, type ChannelRecord, type ChannelAction, type ChannelAgent, type ChannelAgentOptions, type ChannelContext, type ChannelDelivery, type ChannelEmail, type ChannelMessage, type HandoffReason, type Usage, } from './channel.js';

package/dist/index.js

@@ -15,5 +15,5 @@ export { verifyConnectorCall, verifyConnectorRequest, verifyMcpToolCall, memoryR
 export { useKee, MemoryConflictError, RecordConflictError, RecordValidationError, } from './client.js';
 export { keemakrToolDirectory } from './tool-directory.js';
 export { refreshGrant, REFRESH_THRESHOLD_SECONDS } from './refresh.js';
-export { imageCanvas } from './canvases.js';
+export { audioCanvas, imageCanvas, } from './canvases.js';
 export { createChannelAgent, assertTrustworthyCore, ChannelReachError, ChannelReplyNotDeliverable, isApprovalRequired, isHoldSettled, isOutcomeUnknown, isWriteDone, } from './channel.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keemakr/agent-sdk",
-  "version": "0.19.0-dev-20261014074621",
+  "version": "0.19.0-dev-20261014094355",
   "description": "The floor for keemakr marketplace agents: verify the capability grant and reach tenant connections, memory, and shared platform tools through keemakr-core — without holding raw secrets or resolving the tenant yourself.",
   "license": "MIT",
   "type": "module",