@keemakr/operator-sdk 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keemakr/operator-sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "The keemakr connector contract: defineProvider + ConnectionProvider/ConnectionOperation types + OperationContext (governed fetch) + the connector manifest schema, shared by keemakr-core's built-in adapters and external connector repos. One shape, two consumers.",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -318,6 +318,13 @@ export interface ConnectionOperation {
   // Safe-to-retry marker. Omitted ⇒ false. The platform NEVER auto-retries a
   // non-idempotent operation; callers (agents) read this to know what is safe.
   idempotent?: boolean;
+  // The fields of the RESULT that are files a person should see: generated
+  // images, synthesized audio. `path` names them with dots and `[]` for every
+  // item of a list, e.g. `images[].url` or `audio.url`. When the Operator calls
+  // the operation, each URL becomes an image or audio card in the chat, and
+  // core keeps its own copy, so the card still works after the provider's link
+  // expires. Omitted ⇒ the result holds no media.
+  media?: ReadonlyArray<{ kind: 'image' | 'audio'; path: string }>;
   // A Standard Schema (zod/valibot/…) validating the agent-supplied args. Typed
   // loosely here so the connector contract doesn't hard-depend on zod; adapters
   // pass a zod schema and the route validates with `.parse`/`.safeParse`.