@semiont/cli 0.5.9 → 0.5.10

package/dist/cli.mjs

@@ -21443,7 +21443,7 @@ var require_throwError = __commonJS({
     exports.throwError = void 0;
     var Observable_1 = require_Observable();
     var isFunction_1 = require_isFunction();
-    function throwError2(errorOrErrorFactory, scheduler) {
+    function throwError(errorOrErrorFactory, scheduler) {
       var errorFactory = isFunction_1.isFunction(errorOrErrorFactory) ? errorOrErrorFactory : function() {
         return errorOrErrorFactory;
       };
@@ -21454,7 +21454,7 @@ var require_throwError = __commonJS({
         return scheduler.schedule(init2, 0, subscriber);
       } : init2);
     }
-    exports.throwError = throwError2;
+    exports.throwError = throwError;
   }
 });
 
@@ -23451,13 +23451,13 @@ var require_catchError = __commonJS({
     var innerFrom_1 = require_innerFrom();
     var OperatorSubscriber_1 = require_OperatorSubscriber();
     var lift_1 = require_lift();
-    function catchError2(selector) {
+    function catchError(selector) {
       return lift_1.operate(function(source, subscriber) {
         var innerSub = null;
         var syncUnsub = false;
         var handledResult;
         innerSub = source.subscribe(OperatorSubscriber_1.createOperatorSubscriber(subscriber, void 0, void 0, function(err) {
-          handledResult = innerFrom_1.innerFrom(selector(err, catchError2(selector)(source)));
+          handledResult = innerFrom_1.innerFrom(selector(err, catchError(selector)(source)));
           if (innerSub) {
             innerSub.unsubscribe();
             innerSub = null;
@@ -23473,7 +23473,7 @@ var require_catchError = __commonJS({
         }
       });
     }
-    exports.catchError = catchError2;
+    exports.catchError = catchError;
   }
 });
 
@@ -23960,7 +23960,7 @@ var require_defaultIfEmpty = __commonJS({
     exports.defaultIfEmpty = void 0;
     var lift_1 = require_lift();
     var OperatorSubscriber_1 = require_OperatorSubscriber();
-    function defaultIfEmpty2(defaultValue) {
+    function defaultIfEmpty(defaultValue) {
       return lift_1.operate(function(source, subscriber) {
         var hasValue = false;
         source.subscribe(OperatorSubscriber_1.createOperatorSubscriber(subscriber, function(value) {
@@ -23974,7 +23974,7 @@ var require_defaultIfEmpty = __commonJS({
         }));
       });
     }
-    exports.defaultIfEmpty = defaultIfEmpty2;
+    exports.defaultIfEmpty = defaultIfEmpty;
   }
 });
 
@@ -23987,7 +23987,7 @@ var require_take = __commonJS({
     var empty_1 = require_empty();
     var lift_1 = require_lift();
     var OperatorSubscriber_1 = require_OperatorSubscriber();
-    function take2(count) {
+    function take(count) {
       return count <= 0 ? function() {
         return empty_1.EMPTY;
       } : lift_1.operate(function(source, subscriber) {
@@ -24002,7 +24002,7 @@ var require_take = __commonJS({
         }));
       });
     }
-    exports.take = take2;
+    exports.take = take;
   }
 });
 
@@ -27910,68 +27910,10 @@ var require_operators = __commonJS({
 });
 
 // ../../packages/sdk/dist/index.js
-import { SemiontError, decodeWithCharset, annotationId, resourceId, email as email3, googleCredential, refreshToken, EventBus, baseUrl, accessToken, searchQuery } from "@semiont/core";
-import { SemiontError as SemiontError2, accessToken as accessToken2, annotationId as annotationId2, baseUrl as baseUrl2, entityType, refreshToken as refreshToken2, resourceId as resourceId2, userId } from "@semiont/core";
+import { decodeWithCharset, busRequest, annotationId, resourceId, email as email3, googleCredential, refreshToken, EventBus, baseUrl, accessToken, SemiontError, searchQuery } from "@semiont/core";
+import { BusRequestError, SemiontError as SemiontError2, accessToken as accessToken2, annotationId as annotationId2, baseUrl as baseUrl2, entityType, refreshToken as refreshToken2, resourceId as resourceId2, userId } from "@semiont/core";
 import { HttpTransport, HttpContentTransport, APIError } from "@semiont/http-transport";
 import { APIError as APIError2, HttpContentTransport as HttpContentTransport2, HttpTransport as HttpTransport2 } from "@semiont/http-transport";
-async function busRequest(bus, emitChannel, payload, resultChannel, failureChannel, timeoutMs = 3e4) {
-  const correlationId = crypto.randomUUID();
-  const fullPayload = { ...payload, correlationId };
-  const result$ = (0, import_rxjs.merge)(
-    bus.stream(resultChannel).pipe(
-      (0, import_operators.filter)((e) => e.correlationId === correlationId),
-      (0, import_operators.map)((e) => ({ ok: true, response: e.response }))
-    ),
-    bus.stream(failureChannel).pipe(
-      (0, import_operators.filter)((e) => e.correlationId === correlationId),
-      (0, import_operators.map)((e) => ({
-        ok: false,
-        error: new BusRequestError(e.message ?? "Bus request rejected", "bus.rejected", {
-          channel: failureChannel,
-          correlationId,
-          payload: e
-        })
-      }))
-    )
-  ).pipe(
-    (0, import_operators.take)(1),
-    (0, import_operators.timeout)(timeoutMs),
-    (0, import_operators.catchError)((err) => {
-      if (err instanceof import_rxjs.TimeoutError) {
-        return (0, import_rxjs.throwError)(
-          () => new BusRequestError(
-            `Bus request timed out after ${timeoutMs}ms on ${resultChannel}`,
-            "bus.timeout",
-            { channel: emitChannel, resultChannel, correlationId, timeoutMs }
-          )
-        );
-      }
-      return (0, import_rxjs.throwError)(() => err);
-    }),
-    // If the stream completes with no value — the bus was disposed before a
-    // reply (e.g. during `semiont.dispose()` with a request in flight) —
-    // resolve to a typed `bus.closed` result instead of letting `firstValueFrom`
-    // throw rxjs `EmptyError`. An awaited caller then gets a clean
-    // BusRequestError; an in-flight promise nobody is awaiting simply resolves,
-    // so it can't surface as an unhandled rejection on dispose.
-    // See .plans/bugs/busrequest-emptyerror-on-dispose.md.
-    (0, import_operators.defaultIfEmpty)({
-      ok: false,
-      error: new BusRequestError(
-        `Bus closed before a reply on ${resultChannel}`,
-        "bus.closed",
-        { channel: emitChannel, resultChannel, correlationId }
-      )
-    })
-  );
-  const resultPromise = (0, import_rxjs.firstValueFrom)(result$);
-  await bus.emit(emitChannel, fullPayload);
-  const result = await resultPromise;
-  if (!result.ok) {
-    throw result.error;
-  }
-  return result.response;
-}
 function createCache(fetchFn) {
   const store$ = new import_rxjs.BehaviorSubject(/* @__PURE__ */ new Map());
   const inflight = /* @__PURE__ */ new Map();
@@ -28059,7 +28001,7 @@ function wrapAsStream(source) {
     return () => sub.unsubscribe();
   });
 }
-var import_rxjs, import_operators, StreamObservable, CacheObservable, wrapperCache, UploadObservable, BusRequestError, ENTITY_TYPES_KEY, TAG_SCHEMAS_KEY, BrowseNamespace, MarkNamespace, BindNamespace, GatherNamespace, MatchNamespace, YieldNamespace, BeckonNamespace, FrameNamespace, JobNamespace, AuthNamespace, AdminNamespace, SemiontClient, REFRESH_BEFORE_EXP_MS;
+var import_rxjs, import_operators, StreamObservable, CacheObservable, wrapperCache, UploadObservable, ENTITY_TYPES_KEY, TAG_SCHEMAS_KEY, BrowseNamespace, MarkNamespace, BindNamespace, GatherNamespace, MatchNamespace, YieldNamespace, BeckonNamespace, FrameNamespace, JobNamespace, AuthNamespace, AdminNamespace, SemiontClient, REFRESH_BEFORE_EXP_MS;
 var init_dist = __esm({
   "../../packages/sdk/dist/index.js"() {
     "use strict";
@@ -28069,6 +28011,32 @@ var init_dist = __esm({
       then(onfulfilled, onrejected) {
         return (0, import_rxjs.lastValueFrom)(this).then(onfulfilled, onrejected);
       }
+      /**
+       * Subscribe **once**, delivering every emission to `onNext`, and resolve to
+       * the last emitted value on completion (rejects on error, or with rxjs
+       * `EmptyError` if the stream completes without emitting). The
+       * single-subscription way to consume progress *and* the terminal result from
+       * a job-triggering stream — unlike `.subscribe(...)` + `await`, which re-runs
+       * this cold Observable and fires the underlying job twice.
+       */
+      run(onNext) {
+        return new Promise((resolve9, reject) => {
+          let last;
+          let hasValue = false;
+          this.subscribe({
+            next: (v) => {
+              hasValue = true;
+              last = v;
+              onNext(v);
+            },
+            error: reject,
+            complete: () => {
+              if (hasValue) resolve9(last);
+              else reject(new import_rxjs.EmptyError());
+            }
+          });
+        });
+      }
       /** Wrap an existing Observable's subscribe behavior in a StreamObservable. */
       static from(source) {
         return new _StreamObservable((subscriber) => source.subscribe(subscriber));
@@ -28126,11 +28094,28 @@ var init_dist = __esm({
           return onfulfilled ? onfulfilled(result) : result;
         }, onrejected);
       }
-    };
-    BusRequestError = class extends SemiontError {
-      constructor(message, code, details) {
-        super(message, code, details);
-        this.name = "BusRequestError";
+      /**
+       * Subscribe **once**, delivering every `UploadProgress` event to `onNext`, and
+       * resolve to `{ resourceId }` from the `finished` event (rejects on error, or
+       * if the terminal event isn't `finished`). The single-subscription way to
+       * track upload progress *and* get the resource id — unlike `.subscribe(...)` +
+       * `await`, which re-runs this cold Observable and uploads twice.
+       */
+      run(onNext) {
+        return new Promise((resolve9, reject) => {
+          let last;
+          this.subscribe({
+            next: (e) => {
+              last = e;
+              onNext(e);
+            },
+            error: reject,
+            complete: () => {
+              if (last?.phase === "finished") resolve9({ resourceId: last.resourceId });
+              else reject(new Error(`UploadObservable completed on a non-finished event: ${last?.phase ?? "<none>"}`));
+            }
+          });
+        });
       }
     };
     ENTITY_TYPES_KEY = "_";
@@ -28144,9 +28129,7 @@ var init_dist = __esm({
           const result = await busRequest(
             this.transport,
             "browse:resource-requested",
-            { resourceId: id },
-            "browse:resource-result",
-            "browse:resource-failed"
+            { resourceId: id }
           );
           return result.resource;
         });
@@ -28162,9 +28145,7 @@ var init_dist = __esm({
               entityType: filters.entityType,
               limit: filters.limit ?? 100,
               offset: 0
-            },
-            "browse:resources-result",
-            "browse:resources-failed"
+            }
           );
           return result.resources;
         });
@@ -28172,9 +28153,7 @@ var init_dist = __esm({
           return busRequest(
             this.transport,
             "browse:annotations-requested",
-            { resourceId: resourceId22 },
-            "browse:annotations-result",
-            "browse:annotations-failed"
+            { resourceId: resourceId22 }
           );
         });
         this.annotationDetailCache = createCache(async (annotationId22) => {
@@ -28185,9 +28164,7 @@ var init_dist = __esm({
           const result = await busRequest(
             this.transport,
             "browse:annotation-requested",
-            { resourceId: resourceId22, annotationId: annotationId22 },
-            "browse:annotation-result",
-            "browse:annotation-failed"
+            { resourceId: resourceId22, annotationId: annotationId22 }
           );
           return result.annotation;
         });
@@ -28195,9 +28172,7 @@ var init_dist = __esm({
           const result = await busRequest(
             this.transport,
             "browse:entity-types-requested",
-            {},
-            "browse:entity-types-result",
-            "browse:entity-types-failed"
+            {}
           );
           return result.entityTypes;
         });
@@ -28205,9 +28180,7 @@ var init_dist = __esm({
           const result = await busRequest(
             this.transport,
             "browse:tag-schemas-requested",
-            {},
-            "browse:tag-schemas-result",
-            "browse:tag-schemas-failed"
+            {}
           );
           return result.tagSchemas;
         });
@@ -28215,9 +28188,7 @@ var init_dist = __esm({
           const result = await busRequest(
             this.transport,
             "browse:referenced-by-requested",
-            { resourceId: resourceId22 },
-            "browse:referenced-by-result",
-            "browse:referenced-by-failed"
+            { resourceId: resourceId22 }
           );
           return result.referencedBy;
         });
@@ -28225,9 +28196,7 @@ var init_dist = __esm({
           const result = await busRequest(
             this.transport,
             "browse:events-requested",
-            { resourceId: resourceId22 },
-            "browse:events-result",
-            "browse:events-failed"
+            { resourceId: resourceId22 }
           );
           return result.events;
         });
@@ -28373,9 +28342,7 @@ var init_dist = __esm({
         const result = await busRequest(
           this.transport,
           "browse:events-requested",
-          { resourceId: resourceId22 },
-          "browse:events-result",
-          "browse:events-failed"
+          { resourceId: resourceId22 }
         );
         return result.events;
       }
@@ -28383,9 +28350,7 @@ var init_dist = __esm({
         return busRequest(
           this.transport,
           "browse:annotation-history-requested",
-          { resourceId: resourceId22, annotationId: annotationId22 },
-          "browse:annotation-history-result",
-          "browse:annotation-history-failed"
+          { resourceId: resourceId22, annotationId: annotationId22 }
         );
       }
       async connections(_resourceId) {
@@ -28401,9 +28366,7 @@ var init_dist = __esm({
         return busRequest(
           this.transport,
           "browse:directory-requested",
-          { path: dirPath ?? ".", sort: sort ?? "name" },
-          "browse:directory-result",
-          "browse:directory-failed"
+          { path: dirPath ?? ".", sort: sort ?? "name" }
         );
       }
       // ── UI signals (local bus fan-out) ────────────────────────────────────
@@ -28487,13 +28450,12 @@ var init_dist = __esm({
         this.invalidateResourceLists();
       };
       /**
-       * Handler shared by `yield:create-ok` and `yield:update-ok`. Both
-       * report a resource mutation with the resourceId as a string (not
-       * yet branded), so we brand and apply the same effect as
-       * `onArchiveToggled`.
+       * Invalidate caches for a created/updated resource. `yield:create-ok` and
+       * `yield:update-ok` both drive this and carry the resourceId at the same path
+       * (`response.resourceId`) — both are correlation replies for busRequest.
        */
-      onYieldResourceMutated = (event) => {
-        const rId = resourceId(event.resourceId);
+      invalidateMutatedResource = (resourceId22) => {
+        const rId = resourceId(resourceId22);
         this.invalidateResourceDetail(rId);
         this.invalidateResourceLists();
       };
@@ -28517,7 +28479,7 @@ var init_dist = __esm({
           this.invalidateTagSchemas();
         });
         this.on("mark:delete-ok", (event) => {
-          this.removeAnnotationDetail(annotationId(event.annotationId));
+          this.removeAnnotationDetail(annotationId(event.response.annotationId));
         });
         this.on("mark:added", (stored) => {
           if (stored.resourceId) {
@@ -28545,8 +28507,8 @@ var init_dist = __esm({
             this.invalidateAnnotationList(event.resourceId);
           }
         });
-        this.on("yield:create-ok", this.onYieldResourceMutated);
-        this.on("yield:update-ok", this.onYieldResourceMutated);
+        this.on("yield:create-ok", (event) => this.invalidateMutatedResource(event.response.resourceId));
+        this.on("yield:update-ok", (event) => this.invalidateMutatedResource(event.response.resourceId));
         this.on("mark:archived", this.onArchiveToggled);
         this.on("mark:unarchived", this.onArchiveToggled);
         this.on("frame:entity-type-added", () => this.invalidateEntityTypes());
@@ -28565,20 +28527,30 @@ var init_dist = __esm({
         const result = await busRequest(
           this.transport,
           "mark:create-request",
-          { resourceId: resourceId22, request: input },
-          "mark:create-ok",
-          "mark:create-failed"
+          { resourceId: resourceId22, request: input }
         );
         return { annotationId: annotationId(result.annotationId) };
       }
       async delete(resourceId22, annotationId22) {
-        await this.transport.emit("mark:delete", { annotationId: annotationId22, resourceId: resourceId22 });
+        await busRequest(
+          this.transport,
+          "mark:delete",
+          { annotationId: annotationId22, resourceId: resourceId22 }
+        );
       }
       async archive(resourceId22) {
-        await this.transport.emit("mark:archive", { resourceId: resourceId22 });
+        await busRequest(
+          this.transport,
+          "mark:archive",
+          { resourceId: resourceId22 }
+        );
       }
       async unarchive(resourceId22) {
-        await this.transport.emit("mark:unarchive", { resourceId: resourceId22 });
+        await busRequest(
+          this.transport,
+          "mark:unarchive",
+          { resourceId: resourceId22 }
+        );
       }
       assist(resourceId22, motivation, options) {
         return new StreamObservable((subscriber) => {
@@ -28609,9 +28581,7 @@ var init_dist = __esm({
                 busRequest(
                   this.transport,
                   "job:status-requested",
-                  { jobId },
-                  "job:status-result",
-                  "job:status-failed"
+                  { jobId }
                 ).then((status) => {
                   if (done) return;
                   if (status.status === "complete") {
@@ -28620,7 +28590,7 @@ var init_dist = __esm({
                       kind: "complete",
                       data: {
                         jobId,
-                        jobType: status.jobType ?? "annotation",
+                        jobType: status.type ?? "annotation",
                         resourceId: resourceId22,
                         result: status.result
                       }
@@ -28740,9 +28710,7 @@ var init_dist = __esm({
         return busRequest(
           this.transport,
           "job:create",
-          { jobType, resourceId: resourceId22, params },
-          "job:created",
-          "job:create-failed"
+          { jobType, resourceId: resourceId22, params }
         );
       }
     };
@@ -28754,12 +28722,11 @@ var init_dist = __esm({
       transport;
       bus;
       async body(resourceId22, annotationId22, operations) {
-        await this.transport.emit("bind:update-body", {
-          correlationId: crypto.randomUUID(),
-          annotationId: annotationId22,
-          resourceId: resourceId22,
-          operations
-        });
+        await busRequest(
+          this.transport,
+          "bind:update-body",
+          { annotationId: annotationId22, resourceId: resourceId22, operations }
+        );
       }
       initiate(input) {
         this.bus.get("bind:initiate").next(input);
@@ -28814,8 +28781,30 @@ var init_dist = __esm({
           };
         });
       }
-      resource(_resourceId, _options) {
-        throw new Error("Not implemented: gather.resource() \u2014 no backend route yet");
+      /**
+       * Gather whole-resource LLM context — a request/reply over
+       * `gather:resource-requested` → `gather:resource-complete`/`-failed`. Unlike
+       * `annotation()` there are no progress events, so this is a `Promise`, not a
+       * `StreamObservable`. Resolves to the unified `GatheredContext` (focus.kind:
+       * 'resource') the backend assembled — the resource focus plus the shared
+       * knowledge graph; rejects with a `BusRequestError` on failure. Defaults mirror
+       * the CLI `gather` command (depth 2, maxResources 10, content in, summary out).
+       */
+      resource(resourceId22, options) {
+        return busRequest(
+          this.transport,
+          "gather:resource-requested",
+          {
+            resourceId: resourceId22,
+            options: {
+              depth: options?.depth ?? 2,
+              maxResources: options?.maxResources ?? 10,
+              includeContent: options?.includeContent ?? true,
+              includeSummary: options?.includeSummary ?? false,
+              ...options?.excludeEntityTypes?.length ? { excludeEntityTypes: options.excludeEntityTypes } : {}
+            }
+          }
+        );
       }
     };
     MatchNamespace = class {
@@ -28919,6 +28908,55 @@ var init_dist = __esm({
         });
       }
       fromAnnotation(resourceId22, annotationId22, options) {
+        return this.runGeneration(resourceId22, {
+          referenceId: annotationId22,
+          title: options.title,
+          prompt: options.prompt,
+          entityTypes: options.entityTypes,
+          language: options.language,
+          sourceLanguage: options.sourceLanguage,
+          temperature: options.temperature,
+          maxTokens: options.maxTokens,
+          storageUri: options.storageUri,
+          outputMediaType: options.outputMediaType,
+          context: options.context
+        });
+      }
+      /**
+       * Generate a new resource *derived from* a whole source resource — translate,
+       * summarize, transform, extract, synthesize, rewrite; the role is carried by
+       * `options.prompt` (+ `language`, `outputMediaType`). No annotation anchor — pass a
+       * resource-focus `GatheredContext` (from `gather.resource`) as `options.context` to
+       * ground it. Long-running/LLM-based; on completion the worker mints a navigable
+       * source→derived reference annotation (provenance).
+       *
+       * ⚠️ Cold `StreamObservable`: do NOT both `.subscribe(...)` and `await` the same
+       * instance — that fires the job twice. Use `.run(onNext)` for progress + result.
+       * See `.plans/MULTICAST-JOB-TRIGGERS.md`.
+       */
+      fromResource(resourceId22, options) {
+        return this.runGeneration(resourceId22, {
+          title: options.title,
+          prompt: options.prompt,
+          entityTypes: options.entityTypes,
+          language: options.language,
+          sourceLanguage: options.sourceLanguage,
+          temperature: options.temperature,
+          maxTokens: options.maxTokens,
+          storageUri: options.storageUri,
+          outputMediaType: options.outputMediaType,
+          context: options.context
+        });
+      }
+      /**
+       * Shared job-lifecycle driver for `fromAnnotation`/`fromResource`. Emits
+       * `job:create` (jobType `generation`) with the supplied `params`, then streams the
+       * unified `job:report-progress`/`job:complete`/`job:fail` lifecycle (with a polled
+       * `job:status` fallback) as `YieldGenerationEvent`s, resolving on the terminal
+       * `complete`. The two public methods differ only in `params` (fromAnnotation sets
+       * `referenceId`; fromResource doesn't).
+       */
+      runGeneration(resourceId22, params) {
         return new StreamObservable((subscriber) => {
           let done = false;
           let pollTimer = null;
@@ -28947,9 +28985,7 @@ var init_dist = __esm({
                 busRequest(
                   this.transport,
                   "job:status-requested",
-                  { jobId: jid },
-                  "job:status-result",
-                  "job:status-failed"
+                  { jobId: jid }
                 ).then((status) => {
                   if (done) return;
                   if (status.status === "complete") {
@@ -28958,7 +28994,7 @@ var init_dist = __esm({
                       kind: "complete",
                       data: {
                         jobId: jid,
-                        jobType: status.jobType ?? "generation",
+                        jobType: status.type ?? "generation",
                         resourceId: resourceId22,
                         result: status.result
                       }
@@ -29002,21 +29038,8 @@ var init_dist = __esm({
             {
               jobType: "generation",
               resourceId: resourceId22,
-              params: {
-                referenceId: annotationId22,
-                title: options.title,
-                prompt: options.prompt,
-                entityTypes: options.entityTypes,
-                language: options.language,
-                sourceLanguage: options.sourceLanguage,
-                temperature: options.temperature,
-                maxTokens: options.maxTokens,
-                storageUri: options.storageUri,
-                context: options.context
-              }
-            },
-            "job:created",
-            "job:create-failed"
+              params
+            }
           ).then(({ jobId }) => {
             if (jobId && !done) {
               activeJobId = jobId;
@@ -29039,18 +29062,14 @@ var init_dist = __esm({
         return busRequest(
           this.transport,
           "yield:clone-token-requested",
-          { resourceId: resourceId22 },
-          "yield:clone-token-generated",
-          "yield:clone-token-failed"
+          { resourceId: resourceId22 }
         );
       }
       async fromToken(token) {
         const result = await busRequest(
           this.transport,
           "yield:clone-resource-requested",
-          { token },
-          "yield:clone-resource-result",
-          "yield:clone-resource-failed"
+          { token }
         );
         return result.sourceResource;
       }
@@ -29058,9 +29077,7 @@ var init_dist = __esm({
         const result = await busRequest(
           this.transport,
           "yield:clone-create",
-          options,
-          "yield:clone-created",
-          "yield:clone-create-failed"
+          options
         );
         return { resourceId: resourceId(result.resourceId) };
       }
@@ -29090,16 +29107,32 @@ var init_dist = __esm({
         this.transport = transport;
       }
       transport;
+      // Writes are confirmed: each awaits the backend's correlation-keyed
+      // `*-add-ok`/`*-add-failed` reply (bridged) via busRequest and REJECTS on
+      // failure — a remote add-failure is surfaced to the caller, never silently
+      // dropped (.plans/bugs/BRIDGE-GAPS.md).
       async addEntityType(type) {
-        await this.transport.emit("frame:add-entity-type", { tag: type });
+        await busRequest(
+          this.transport,
+          "frame:add-entity-type",
+          { tag: type }
+        );
       }
       async addEntityTypes(types2) {
         for (const tag of types2) {
-          await this.transport.emit("frame:add-entity-type", { tag });
+          await busRequest(
+            this.transport,
+            "frame:add-entity-type",
+            { tag }
+          );
         }
       }
       async addTagSchema(schema) {
-        await this.transport.emit("frame:add-tag-schema", { schema });
+        await busRequest(
+          this.transport,
+          "frame:add-tag-schema",
+          { schema }
+        );
       }
     };
     JobNamespace = class {
@@ -29133,14 +29166,12 @@ var init_dist = __esm({
         return busRequest(
           this.transport,
           "job:status-requested",
-          { jobId },
-          "job:status-result",
-          "job:status-failed"
+          { jobId }
         );
       }
       async pollUntilComplete(jobId, options) {
         const interval = options?.interval ?? 1e3;
-        const timeout6 = options?.timeout ?? 6e4;
+        const timeout5 = options?.timeout ?? 6e4;
         const startTime = Date.now();
         while (true) {
           const status = await this.status(jobId);
@@ -29148,14 +29179,19 @@ var init_dist = __esm({
           if (status.status === "complete" || status.status === "failed" || status.status === "cancelled") {
             return status;
           }
-          if (Date.now() - startTime > timeout6) {
-            throw new Error(`Job polling timeout after ${timeout6}ms`);
+          if (Date.now() - startTime > timeout5) {
+            throw new Error(`Job polling timeout after ${timeout5}ms`);
           }
           await new Promise((resolve9) => setTimeout(resolve9, interval));
         }
       }
       async cancelByType(jobType) {
-        await this.transport.emit("job:cancel-requested", { jobType });
+        const { cancelled } = await busRequest(
+          this.transport,
+          "job:cancel-requested",
+          { jobType }
+        );
+        return cancelled;
       }
       cancelRequest(jobType) {
         this.bus.get("job:cancel-requested").next({ jobType });
@@ -34772,7 +34808,7 @@ var init_js_yaml = __esm({
         mark.snippet = makeSnippet(mark);
         return new YAMLException2(message, mark);
       }
-      function throwError2(state, message) {
+      function throwError(state, message) {
         throw generateError(state, message);
       }
       function throwWarning(state, message) {
@@ -34838,29 +34874,29 @@ var init_js_yaml = __esm({
       }
       var directiveHandlers = {
         YAML: function handleYamlDirective(state, name, args) {
-          if (state.version !== null) throwError2(state, "duplication of %YAML directive");
-          if (args.length !== 1) throwError2(state, "YAML directive accepts exactly one argument");
+          if (state.version !== null) throwError(state, "duplication of %YAML directive");
+          if (args.length !== 1) throwError(state, "YAML directive accepts exactly one argument");
           const match = /^([0-9]+)\.([0-9]+)$/.exec(args[0]);
-          if (match === null) throwError2(state, "ill-formed argument of the YAML directive");
+          if (match === null) throwError(state, "ill-formed argument of the YAML directive");
           const major = parseInt(match[1], 10);
           const minor = parseInt(match[2], 10);
-          if (major !== 1) throwError2(state, "unacceptable YAML version of the document");
+          if (major !== 1) throwError(state, "unacceptable YAML version of the document");
           state.version = args[0];
           state.checkLineBreaks = minor < 2;
           if (minor !== 1 && minor !== 2) throwWarning(state, "unsupported YAML version of the document");
         },
         TAG: function handleTagDirective(state, name, args) {
           let prefix;
-          if (args.length !== 2) throwError2(state, "TAG directive accepts exactly two arguments");
+          if (args.length !== 2) throwError(state, "TAG directive accepts exactly two arguments");
           const handle = args[0];
           prefix = args[1];
-          if (!PATTERN_TAG_HANDLE.test(handle)) throwError2(state, "ill-formed tag handle (first argument) of the TAG directive");
-          if (_hasOwnProperty.call(state.tagMap, handle)) throwError2(state, 'there is a previously declared suffix for "' + handle + '" tag handle');
-          if (!PATTERN_TAG_URI.test(prefix)) throwError2(state, "ill-formed tag prefix (second argument) of the TAG directive");
+          if (!PATTERN_TAG_HANDLE.test(handle)) throwError(state, "ill-formed tag handle (first argument) of the TAG directive");
+          if (_hasOwnProperty.call(state.tagMap, handle)) throwError(state, 'there is a previously declared suffix for "' + handle + '" tag handle');
+          if (!PATTERN_TAG_URI.test(prefix)) throwError(state, "ill-formed tag prefix (second argument) of the TAG directive");
           try {
             prefix = decodeURIComponent(prefix);
           } catch (err) {
-            throwError2(state, "tag prefix is malformed: " + prefix);
+            throwError(state, "tag prefix is malformed: " + prefix);
           }
           state.tagMap[handle] = prefix;
         }
@@ -34870,14 +34906,14 @@ var init_js_yaml = __esm({
           const _result = state.input.slice(start2, end);
           if (checkJson) for (let _position = 0, _length2 = _result.length; _position < _length2; _position += 1) {
             const _character = _result.charCodeAt(_position);
-            if (!(_character === 9 || _character >= 32 && _character <= 1114111)) throwError2(state, "expected valid JSON character");
+            if (!(_character === 9 || _character >= 32 && _character <= 1114111)) throwError(state, "expected valid JSON character");
           }
-          else if (PATTERN_NON_PRINTABLE.test(_result)) throwError2(state, "the stream contains non-printable characters");
+          else if (PATTERN_NON_PRINTABLE.test(_result)) throwError(state, "the stream contains non-printable characters");
           state.result += _result;
         }
       }
       function mergeMappings(state, destination, source, overridableKeys) {
-        if (!common.isObject(source)) throwError2(state, "cannot merge mappings; the provided source object is unacceptable");
+        if (!common.isObject(source)) throwError(state, "cannot merge mappings; the provided source object is unacceptable");
         const sourceKeys = Object.keys(source);
         for (let index = 0, quantity = sourceKeys.length; index < quantity; index += 1) {
           const key = sourceKeys[index];
@@ -34891,7 +34927,7 @@ var init_js_yaml = __esm({
         if (Array.isArray(keyNode)) {
           keyNode = Array.prototype.slice.call(keyNode);
           for (let index = 0, quantity = keyNode.length; index < quantity; index += 1) {
-            if (Array.isArray(keyNode[index])) throwError2(state, "nested arrays are not supported inside keys");
+            if (Array.isArray(keyNode[index])) throwError(state, "nested arrays are not supported inside keys");
             if (typeof keyNode === "object" && _class(keyNode[index]) === "[object Object]") keyNode[index] = "[object Object]";
           }
         }
@@ -34899,7 +34935,7 @@ var init_js_yaml = __esm({
         keyNode = String(keyNode);
         if (_result === null) _result = {};
         if (keyTag === "tag:yaml.org,2002:merge") if (Array.isArray(valueNode)) {
-          if (valueNode.length > state.maxMergeSeqLength) throwError2(state, "merge sequence length exceeded maxMergeSeqLength (" + state.maxMergeSeqLength + ")");
+          if (valueNode.length > state.maxMergeSeqLength) throwError(state, "merge sequence length exceeded maxMergeSeqLength (" + state.maxMergeSeqLength + ")");
           const seen = /* @__PURE__ */ new Set();
           for (let index = 0, quantity = valueNode.length; index < quantity; index += 1) {
             const src = valueNode[index];
@@ -34913,7 +34949,7 @@ var init_js_yaml = __esm({
             state.line = startLine || state.line;
             state.lineStart = startLineStart || state.lineStart;
             state.position = startPos || state.position;
-            throwError2(state, "duplicated mapping key");
+            throwError(state, "duplicated mapping key");
           }
           setProperty(_result, keyNode, valueNode);
           delete overridableKeys[keyNode];
@@ -34926,7 +34962,7 @@ var init_js_yaml = __esm({
         else if (ch === 13) {
           state.position++;
           if (state.input.charCodeAt(state.position) === 10) state.position++;
-        } else throwError2(state, "a line break is expected");
+        } else throwError(state, "a line break is expected");
         state.line += 1;
         state.lineStart = state.position;
         state.firstTabInLine = -1;
@@ -35049,12 +35085,12 @@ var init_js_yaml = __esm({
           captureSegment(state, captureStart, captureEnd, true);
           writeFoldedLines(state, skipSeparationSpace(state, false, nodeIndent));
           captureStart = captureEnd = state.position;
-        } else if (state.position === state.lineStart && testDocumentSeparator(state)) throwError2(state, "unexpected end of the document within a single quoted scalar");
+        } else if (state.position === state.lineStart && testDocumentSeparator(state)) throwError(state, "unexpected end of the document within a single quoted scalar");
         else {
           state.position++;
           if (!isWhiteSpace(ch)) captureEnd = state.position;
         }
-        throwError2(state, "unexpected end of the stream within a single quoted scalar");
+        throwError(state, "unexpected end of the stream within a single quoted scalar");
       }
       function readDoubleQuotedScalar(state, nodeIndent) {
         let captureStart;
@@ -35083,22 +35119,22 @@ var init_js_yaml = __esm({
             for (; hexLength > 0; hexLength--) {
               ch = state.input.charCodeAt(++state.position);
               if ((tmp = fromHexCode(ch)) >= 0) hexResult = (hexResult << 4) + tmp;
-              else throwError2(state, "expected hexadecimal character");
+              else throwError(state, "expected hexadecimal character");
             }
             state.result += charFromCodepoint(hexResult);
             state.position++;
-          } else throwError2(state, "unknown escape sequence");
+          } else throwError(state, "unknown escape sequence");
           captureStart = captureEnd = state.position;
         } else if (isEol(ch)) {
           captureSegment(state, captureStart, captureEnd, true);
           writeFoldedLines(state, skipSeparationSpace(state, false, nodeIndent));
           captureStart = captureEnd = state.position;
-        } else if (state.position === state.lineStart && testDocumentSeparator(state)) throwError2(state, "unexpected end of the document within a double quoted scalar");
+        } else if (state.position === state.lineStart && testDocumentSeparator(state)) throwError(state, "unexpected end of the document within a double quoted scalar");
         else {
           state.position++;
           if (!isWhiteSpace(ch)) captureEnd = state.position;
         }
-        throwError2(state, "unexpected end of the stream within a double quoted scalar");
+        throwError(state, "unexpected end of the stream within a double quoted scalar");
       }
       function readFlowCollection(state, nodeIndent) {
         let readNext = true;
@@ -35138,8 +35174,8 @@ var init_js_yaml = __esm({
             state.kind = isMapping ? "mapping" : "sequence";
             state.result = _result;
             return true;
-          } else if (!readNext) throwError2(state, "missed comma between flow collection entries");
-          else if (ch === 44) throwError2(state, "expected the node content, but found ','");
+          } else if (!readNext) throwError(state, "missed comma between flow collection entries");
+          else if (ch === 44) throwError(state, "expected the node content, but found ','");
           keyTag = keyNode = valueNode = null;
           isPair = isExplicitPair = false;
           if (ch === 63) {
@@ -35174,7 +35210,7 @@ var init_js_yaml = __esm({
             ch = state.input.charCodeAt(++state.position);
           } else readNext = false;
         }
-        throwError2(state, "unexpected end of the stream within a flow collection");
+        throwError(state, "unexpected end of the stream within a flow collection");
       }
       function readBlockScalar(state, nodeIndent) {
         let folding;
@@ -35194,12 +35230,12 @@ var init_js_yaml = __esm({
         while (ch !== 0) {
           ch = state.input.charCodeAt(++state.position);
           if (ch === 43 || ch === 45) if (CHOMPING_CLIP === chomping) chomping = ch === 43 ? CHOMPING_KEEP : CHOMPING_STRIP;
-          else throwError2(state, "repeat of a chomping mode identifier");
-          else if ((tmp = fromDecimalCode(ch)) >= 0) if (tmp === 0) throwError2(state, "bad explicit indentation width of a block scalar; it cannot be less than one");
+          else throwError(state, "repeat of a chomping mode identifier");
+          else if ((tmp = fromDecimalCode(ch)) >= 0) if (tmp === 0) throwError(state, "bad explicit indentation width of a block scalar; it cannot be less than one");
           else if (!detectedIndent) {
             textIndent = nodeIndent + tmp - 1;
             detectedIndent = true;
-          } else throwError2(state, "repeat of an indentation width identifier");
+          } else throwError(state, "repeat of an indentation width identifier");
           else break;
         }
         if (isWhiteSpace(ch)) {
@@ -35223,7 +35259,7 @@ var init_js_yaml = __esm({
             emptyLines++;
             continue;
           }
-          if (!detectedIndent && textIndent === 0) throwError2(state, "missing indentation for block scalar");
+          if (!detectedIndent && textIndent === 0) throwError(state, "missing indentation for block scalar");
           if (state.lineIndent < textIndent) {
             if (chomping === CHOMPING_KEEP) state.result += common.repeat("\n", didReadContent ? 1 + emptyLines : emptyLines);
             else if (chomping === CHOMPING_CLIP) {
@@ -35261,7 +35297,7 @@ var init_js_yaml = __esm({
         while (ch !== 0) {
           if (state.firstTabInLine !== -1) {
             state.position = state.firstTabInLine;
-            throwError2(state, "tab characters must not be used in indentation");
+            throwError(state, "tab characters must not be used in indentation");
           }
           if (ch !== 45) break;
           if (!isWsOrEol(state.input.charCodeAt(state.position + 1))) break;
@@ -35279,7 +35315,7 @@ var init_js_yaml = __esm({
           _result.push(state.result);
           skipSeparationSpace(state, true, -1);
           ch = state.input.charCodeAt(state.position);
-          if ((state.line === _line || state.lineIndent > nodeIndent) && ch !== 0) throwError2(state, "bad indentation of a sequence entry");
+          if ((state.line === _line || state.lineIndent > nodeIndent) && ch !== 0) throwError(state, "bad indentation of a sequence entry");
           else if (state.lineIndent < nodeIndent) break;
         }
         if (detected) {
@@ -35311,7 +35347,7 @@ var init_js_yaml = __esm({
         while (ch !== 0) {
           if (!atExplicitKey && state.firstTabInLine !== -1) {
             state.position = state.firstTabInLine;
-            throwError2(state, "tab characters must not be used in indentation");
+            throwError(state, "tab characters must not be used in indentation");
           }
           const following = state.input.charCodeAt(state.position + 1);
           const _line = state.line;
@@ -35327,7 +35363,7 @@ var init_js_yaml = __esm({
             } else if (atExplicitKey) {
               atExplicitKey = false;
               allowCompact = true;
-            } else throwError2(state, "incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line");
+            } else throwError(state, "incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line");
             state.position += 1;
             ch = following;
           } else {
@@ -35340,7 +35376,7 @@ var init_js_yaml = __esm({
               while (isWhiteSpace(ch)) ch = state.input.charCodeAt(++state.position);
               if (ch === 58) {
                 ch = state.input.charCodeAt(++state.position);
-                if (!isWsOrEol(ch)) throwError2(state, "a whitespace character is expected after the key-value separator within a block mapping");
+                if (!isWsOrEol(ch)) throwError(state, "a whitespace character is expected after the key-value separator within a block mapping");
                 if (atExplicitKey) {
                   storeMappingPair(state, _result, overridableKeys, keyTag, keyNode, null, _keyLine, _keyLineStart, _keyPos);
                   keyTag = keyNode = valueNode = null;
@@ -35350,13 +35386,13 @@ var init_js_yaml = __esm({
                 allowCompact = false;
                 keyTag = state.tag;
                 keyNode = state.result;
-              } else if (detected) throwError2(state, "can not read an implicit mapping pair; a colon is missed");
+              } else if (detected) throwError(state, "can not read an implicit mapping pair; a colon is missed");
               else {
                 state.tag = _tag;
                 state.anchor = _anchor;
                 return true;
               }
-            } else if (detected) throwError2(state, "can not read a block mapping entry; a multiline key may not be an implicit key");
+            } else if (detected) throwError(state, "can not read a block mapping entry; a multiline key may not be an implicit key");
             else {
               state.tag = _tag;
               state.anchor = _anchor;
@@ -35378,7 +35414,7 @@ var init_js_yaml = __esm({
             skipSeparationSpace(state, true, -1);
             ch = state.input.charCodeAt(state.position);
           }
-          if ((state.line === _line || state.lineIndent > nodeIndent) && ch !== 0) throwError2(state, "bad indentation of a mapping entry");
+          if ((state.line === _line || state.lineIndent > nodeIndent) && ch !== 0) throwError(state, "bad indentation of a mapping entry");
           else if (state.lineIndent < nodeIndent) break;
         }
         if (atExplicitKey) storeMappingPair(state, _result, overridableKeys, keyTag, keyNode, null, _keyLine, _keyLineStart, _keyPos);
@@ -35397,7 +35433,7 @@ var init_js_yaml = __esm({
         let tagName;
         let ch = state.input.charCodeAt(state.position);
         if (ch !== 33) return false;
-        if (state.tag !== null) throwError2(state, "duplication of a tag property");
+        if (state.tag !== null) throwError(state, "duplication of a tag property");
         ch = state.input.charCodeAt(++state.position);
         if (ch === 60) {
           isVerbatim = true;
@@ -35415,41 +35451,41 @@ var init_js_yaml = __esm({
           if (state.position < state.length) {
             tagName = state.input.slice(_position, state.position);
             ch = state.input.charCodeAt(++state.position);
-          } else throwError2(state, "unexpected end of the stream within a verbatim tag");
+          } else throwError(state, "unexpected end of the stream within a verbatim tag");
         } else {
           while (ch !== 0 && !isWsOrEol(ch)) {
             if (ch === 33) if (!isNamed) {
               tagHandle = state.input.slice(_position - 1, state.position + 1);
-              if (!PATTERN_TAG_HANDLE.test(tagHandle)) throwError2(state, "named tag handle cannot contain such characters");
+              if (!PATTERN_TAG_HANDLE.test(tagHandle)) throwError(state, "named tag handle cannot contain such characters");
               isNamed = true;
               _position = state.position + 1;
-            } else throwError2(state, "tag suffix cannot contain exclamation marks");
+            } else throwError(state, "tag suffix cannot contain exclamation marks");
             ch = state.input.charCodeAt(++state.position);
           }
           tagName = state.input.slice(_position, state.position);
-          if (PATTERN_FLOW_INDICATORS.test(tagName)) throwError2(state, "tag suffix cannot contain flow indicator characters");
+          if (PATTERN_FLOW_INDICATORS.test(tagName)) throwError(state, "tag suffix cannot contain flow indicator characters");
         }
-        if (tagName && !PATTERN_TAG_URI.test(tagName)) throwError2(state, "tag name cannot contain such characters: " + tagName);
+        if (tagName && !PATTERN_TAG_URI.test(tagName)) throwError(state, "tag name cannot contain such characters: " + tagName);
         try {
           tagName = decodeURIComponent(tagName);
         } catch (err) {
-          throwError2(state, "tag name is malformed: " + tagName);
+          throwError(state, "tag name is malformed: " + tagName);
         }
         if (isVerbatim) state.tag = tagName;
         else if (_hasOwnProperty.call(state.tagMap, tagHandle)) state.tag = state.tagMap[tagHandle] + tagName;
         else if (tagHandle === "!") state.tag = "!" + tagName;
         else if (tagHandle === "!!") state.tag = "tag:yaml.org,2002:" + tagName;
-        else throwError2(state, 'undeclared tag handle "' + tagHandle + '"');
+        else throwError(state, 'undeclared tag handle "' + tagHandle + '"');
         return true;
       }
       function readAnchorProperty(state) {
         let ch = state.input.charCodeAt(state.position);
         if (ch !== 38) return false;
-        if (state.anchor !== null) throwError2(state, "duplication of an anchor property");
+        if (state.anchor !== null) throwError(state, "duplication of an anchor property");
         ch = state.input.charCodeAt(++state.position);
         const _position = state.position;
         while (ch !== 0 && !isWsOrEol(ch) && !isFlowIndicator(ch)) ch = state.input.charCodeAt(++state.position);
-        if (state.position === _position) throwError2(state, "name of an anchor node must contain at least one character");
+        if (state.position === _position) throwError(state, "name of an anchor node must contain at least one character");
         state.anchor = state.input.slice(_position, state.position);
         return true;
       }
@@ -35459,9 +35495,9 @@ var init_js_yaml = __esm({
         ch = state.input.charCodeAt(++state.position);
         const _position = state.position;
         while (ch !== 0 && !isWsOrEol(ch) && !isFlowIndicator(ch)) ch = state.input.charCodeAt(++state.position);
-        if (state.position === _position) throwError2(state, "name of an alias node must contain at least one character");
+        if (state.position === _position) throwError(state, "name of an alias node must contain at least one character");
         const alias = state.input.slice(_position, state.position);
-        if (!_hasOwnProperty.call(state.anchorMap, alias)) throwError2(state, 'unidentified alias "' + alias + '"');
+        if (!_hasOwnProperty.call(state.anchorMap, alias)) throwError(state, 'unidentified alias "' + alias + '"');
         state.result = state.anchorMap[alias];
         skipSeparationSpace(state, true, -1);
         return true;
@@ -35492,7 +35528,7 @@ var init_js_yaml = __esm({
         let type;
         let flowIndent;
         let blockIndent;
-        if (state.depth >= state.maxDepth) throwError2(state, "nesting exceeded maxDepth (" + state.maxDepth + ")");
+        if (state.depth >= state.maxDepth) throwError(state, "nesting exceeded maxDepth (" + state.maxDepth + ")");
         state.depth += 1;
         if (state.listener !== null) state.listener("open", state);
         state.tag = null;
@@ -35534,7 +35570,7 @@ var init_js_yaml = __esm({
             else if (allowBlockScalars && readBlockScalar(state, flowIndent) || readSingleQuotedScalar(state, flowIndent) || readDoubleQuotedScalar(state, flowIndent)) hasContent = true;
             else if (readAlias(state)) {
               hasContent = true;
-              if (state.tag !== null || state.anchor !== null) throwError2(state, "alias node should not have any properties");
+              if (state.tag !== null || state.anchor !== null) throwError(state, "alias node should not have any properties");
             } else if (readPlainScalar(state, flowIndent, CONTEXT_FLOW_IN === nodeContext)) {
               hasContent = true;
               if (state.tag === null) state.tag = "?";
@@ -35546,7 +35582,7 @@ var init_js_yaml = __esm({
         if (state.tag === null) {
           if (state.anchor !== null) storeAnchor(state, state.anchor, state.result);
         } else if (state.tag === "?") {
-          if (state.result !== null && state.kind !== "scalar") throwError2(state, 'unacceptable node kind for !<?> tag; it should be "scalar", not "' + state.kind + '"');
+          if (state.result !== null && state.kind !== "scalar") throwError(state, 'unacceptable node kind for !<?> tag; it should be "scalar", not "' + state.kind + '"');
           for (let typeIndex = 0, typeQuantity = state.implicitTypes.length; typeIndex < typeQuantity; typeIndex += 1) {
             type = state.implicitTypes[typeIndex];
             if (type.resolve(state.result)) {
@@ -35566,9 +35602,9 @@ var init_js_yaml = __esm({
               break;
             }
           }
-          if (!type) throwError2(state, "unknown tag !<" + state.tag + ">");
-          if (state.result !== null && type.kind !== state.kind) throwError2(state, "unacceptable node kind for !<" + state.tag + '> tag; it should be "' + type.kind + '", not "' + state.kind + '"');
-          if (!type.resolve(state.result, state.tag)) throwError2(state, "cannot resolve a node with !<" + state.tag + "> explicit tag");
+          if (!type) throwError(state, "unknown tag !<" + state.tag + ">");
+          if (state.result !== null && type.kind !== state.kind) throwError(state, "unacceptable node kind for !<" + state.tag + '> tag; it should be "' + type.kind + '", not "' + state.kind + '"');
+          if (!type.resolve(state.result, state.tag)) throwError(state, "cannot resolve a node with !<" + state.tag + "> explicit tag");
           else {
             state.result = type.construct(state.result, state.tag);
             if (state.anchor !== null) storeAnchor(state, state.anchor, state.result);
@@ -35596,7 +35632,7 @@ var init_js_yaml = __esm({
           while (ch !== 0 && !isWsOrEol(ch)) ch = state.input.charCodeAt(++state.position);
           const directiveName = state.input.slice(_position, state.position);
           const directiveArgs = [];
-          if (directiveName.length < 1) throwError2(state, "directive name must not be less than one character in length");
+          if (directiveName.length < 1) throwError(state, "directive name must not be less than one character in length");
           while (ch !== 0) {
             while (isWhiteSpace(ch)) ch = state.input.charCodeAt(++state.position);
             if (ch === 35) {
@@ -35618,7 +35654,7 @@ var init_js_yaml = __esm({
         if (state.lineIndent === 0 && state.input.charCodeAt(state.position) === 45 && state.input.charCodeAt(state.position + 1) === 45 && state.input.charCodeAt(state.position + 2) === 45) {
           state.position += 3;
           skipSeparationSpace(state, true, -1);
-        } else if (hasDirectives) throwError2(state, "directives end mark is expected");
+        } else if (hasDirectives) throwError(state, "directives end mark is expected");
         composeNode(state, state.lineIndent - 1, CONTEXT_BLOCK_OUT, false, true);
         skipSeparationSpace(state, true, -1);
         if (state.checkLineBreaks && PATTERN_NON_ASCII_LINE_BREAKS.test(state.input.slice(documentStart, state.position))) throwWarning(state, "non-ASCII line breaks are interpreted as content");
@@ -35630,7 +35666,7 @@ var init_js_yaml = __esm({
           }
           return;
         }
-        if (state.position < state.length - 1) throwError2(state, "end of the stream or a document separator is expected");
+        if (state.position < state.length - 1) throwError(state, "end of the stream or a document separator is expected");
       }
       function loadDocuments(input, options) {
         input = String(input);
@@ -35643,7 +35679,7 @@ var init_js_yaml = __esm({
         const nullpos = input.indexOf("\0");
         if (nullpos !== -1) {
           state.position = nullpos;
-          throwError2(state, "null byte is not allowed in input");
+          throwError(state, "null byte is not allowed in input");
         }
         state.input += "\0";
         while (state.input.charCodeAt(state.position) === 32) {
@@ -41457,135 +41493,6 @@ var init_platforms = __esm({
   }
 });
 
-// ../../node_modules/smol-toml/dist/error.js
-function getLineColFromPtr(string4, ptr) {
-  let lines = string4.slice(0, ptr).split(/\r\n|\n|\r/g);
-  return [lines.length, lines.pop().length + 1];
-}
-function makeCodeBlock(string4, line, column) {
-  let lines = string4.split(/\r\n|\n|\r/g);
-  let codeblock = "";
-  let numberLen = (Math.log10(line + 1) | 0) + 1;
-  for (let i = line - 1; i <= line + 1; i++) {
-    let l = lines[i - 1];
-    if (!l)
-      continue;
-    codeblock += i.toString().padEnd(numberLen, " ");
-    codeblock += ":  ";
-    codeblock += l;
-    codeblock += "\n";
-    if (i === line) {
-      codeblock += " ".repeat(numberLen + column + 2);
-      codeblock += "^\n";
-    }
-  }
-  return codeblock;
-}
-var TomlError;
-var init_error = __esm({
-  "../../node_modules/smol-toml/dist/error.js"() {
-    TomlError = class extends Error {
-      line;
-      column;
-      codeblock;
-      constructor(message, options) {
-        const [line, column] = getLineColFromPtr(options.toml, options.ptr);
-        const codeblock = makeCodeBlock(options.toml, line, column);
-        super(`Invalid TOML document: ${message}
-
-${codeblock}`, options);
-        this.line = line;
-        this.column = column;
-        this.codeblock = codeblock;
-      }
-    };
-  }
-});
-
-// ../../node_modules/smol-toml/dist/util.js
-function isEscaped(str, ptr) {
-  let i = 0;
-  while (str[ptr - ++i] === "\\")
-    ;
-  return --i && i % 2;
-}
-function indexOfNewline(str, start2 = 0, end = str.length) {
-  let idx = str.indexOf("\n", start2);
-  if (str[idx - 1] === "\r")
-    idx--;
-  return idx <= end ? idx : -1;
-}
-function skipComment(str, ptr) {
-  for (let i = ptr; i < str.length; i++) {
-    let c = str[i];
-    if (c === "\n")
-      return i;
-    if (c === "\r" && str[i + 1] === "\n")
-      return i + 1;
-    if (c < " " && c !== "	" || c === "\x7F") {
-      throw new TomlError("control characters are not allowed in comments", {
-        toml: str,
-        ptr
-      });
-    }
-  }
-  return str.length;
-}
-function skipVoid(str, ptr, banNewLines, banComments) {
-  let c;
-  while (1) {
-    while ((c = str[ptr]) === " " || c === "	" || !banNewLines && (c === "\n" || c === "\r" && str[ptr + 1] === "\n"))
-      ptr++;
-    if (banComments || c !== "#")
-      break;
-    ptr = skipComment(str, ptr);
-  }
-  return ptr;
-}
-function skipUntil(str, ptr, sep, end, banNewLines = false) {
-  if (!end) {
-    ptr = indexOfNewline(str, ptr);
-    return ptr < 0 ? str.length : ptr;
-  }
-  for (let i = ptr; i < str.length; i++) {
-    let c = str[i];
-    if (c === "#") {
-      i = indexOfNewline(str, i);
-    } else if (c === sep) {
-      return i + 1;
-    } else if (c === end || banNewLines && (c === "\n" || c === "\r" && str[i + 1] === "\n")) {
-      return i;
-    }
-  }
-  throw new TomlError("cannot find end of structure", {
-    toml: str,
-    ptr
-  });
-}
-function getStringEnd(str, seek) {
-  let first = str[seek];
-  let target = first === str[seek + 1] && str[seek + 1] === str[seek + 2] ? str.slice(seek, seek + 3) : first;
-  seek += target.length - 1;
-  do
-    seek = str.indexOf(target, ++seek);
-  while (seek > -1 && first !== "'" && isEscaped(str, seek));
-  if (seek > -1) {
-    seek += target.length;
-    if (target.length > 1) {
-      if (str[seek] === first)
-        seek++;
-      if (str[seek] === first)
-        seek++;
-    }
-  }
-  return seek;
-}
-var init_util2 = __esm({
-  "../../node_modules/smol-toml/dist/util.js"() {
-    init_error();
-  }
-});
-
 // ../../node_modules/smol-toml/dist/date.js
 var DATE_TIME_RE, TomlDate;
 var init_date = __esm({
@@ -41683,79 +41590,155 @@ var init_date = __esm({
   }
 });
 
+// ../../node_modules/smol-toml/dist/error.js
+function getLineColFromPtr(string4, ptr) {
+  let lines = string4.slice(0, ptr).split(/\r\n|\n|\r/g);
+  return [lines.length, lines.pop().length + 1];
+}
+function makeCodeBlock(string4, line, column) {
+  let lines = string4.split(/\r\n|\n|\r/g);
+  let codeblock = "";
+  let numberLen = (Math.log10(line + 1) | 0) + 1;
+  for (let i = line - 1; i <= line + 1; i++) {
+    let l = lines[i - 1];
+    if (!l)
+      continue;
+    codeblock += i.toString().padEnd(numberLen, " ");
+    codeblock += ":  ";
+    codeblock += l;
+    codeblock += "\n";
+    if (i === line) {
+      codeblock += " ".repeat(numberLen + column + 2);
+      codeblock += "^\n";
+    }
+  }
+  return codeblock;
+}
+var TomlError;
+var init_error = __esm({
+  "../../node_modules/smol-toml/dist/error.js"() {
+    TomlError = class extends Error {
+      line;
+      column;
+      codeblock;
+      constructor(message, options) {
+        const [line, column] = getLineColFromPtr(options.toml, options.ptr);
+        const codeblock = makeCodeBlock(options.toml, line, column);
+        super(`Invalid TOML document: ${message}
+
+${codeblock}`, options);
+        this.line = line;
+        this.column = column;
+        this.codeblock = codeblock;
+      }
+    };
+  }
+});
+
 // ../../node_modules/smol-toml/dist/primitive.js
-function parseString(str, ptr = 0, endPtr = str.length) {
-  let isLiteral = str[ptr] === "'";
-  let isMultiline = str[ptr++] === str[ptr] && str[ptr] === str[ptr + 1];
+function parseString(str, ptr) {
+  let c = str[ptr++];
+  let first = c;
+  let isLiteral = c === "'";
+  let isMultiline = c === str[ptr] && c === str[ptr + 1];
   if (isMultiline) {
-    endPtr -= 2;
-    if (str[ptr += 2] === "\r")
-      ptr++;
-    if (str[ptr] === "\n")
+    if (str[ptr += 2] === "\n")
       ptr++;
+    else if (str[ptr] === "\r" && str[ptr + 1] === "\n")
+      ptr += 2;
   }
-  let tmp = 0;
-  let isEscape;
   let parsed = "";
   let sliceStart = ptr;
-  while (ptr < endPtr - 1) {
-    let c = str[ptr++];
-    if (c === "\n" || c === "\r" && str[ptr] === "\n") {
-      if (!isMultiline) {
-        throw new TomlError("newlines are not allowed in strings", {
-          toml: str,
-          ptr: ptr - 1
-        });
-      }
+  let state = 0;
+  for (let i = ptr; i < str.length; i++) {
+    c = str[i];
+    if (isMultiline && (c === "\n" || c === "\r" && str[i + 1] === "\n")) {
+      state = state && 3;
     } else if (c < " " && c !== "	" || c === "\x7F") {
       throw new TomlError("control characters are not allowed in strings", {
         toml: str,
-        ptr: ptr - 1
+        ptr: i
       });
-    }
-    if (isEscape) {
-      isEscape = false;
+    } else if ((!state || state === 3) && c === first && (!isMultiline || str[i + 1] === first && str[i + 2] === first)) {
+      if (isMultiline) {
+        if (str[i + 3] === first)
+          i++;
+        if (str[i + 3] === first)
+          i++;
+      }
+      return [
+        // If we're in a newline escape still, then there's nothing to add.
+        // Also try to avoid concat if there's nothing to add to parsed, or nothing has been added to parsed.
+        state ? parsed : parsed + str.slice(sliceStart, i),
+        i + (isMultiline ? 3 : 1)
+      ];
+    } else if (!state) {
+      if (!isLiteral && c === "\\") {
+        parsed += str.slice(sliceStart, sliceStart = i);
+        state = 1;
+      }
+    } else if (state === 1) {
       if (c === "x" || c === "u" || c === "U") {
-        let code = str.slice(ptr, ptr += c === "x" ? 2 : c === "u" ? 4 : 8);
-        if (!ESCAPE_REGEX.test(code)) {
-          throw new TomlError("invalid unicode escape", {
-            toml: str,
-            ptr: tmp
-          });
-        }
-        try {
-          parsed += String.fromCodePoint(parseInt(code, 16));
-        } catch {
-          throw new TomlError("invalid unicode escape", {
-            toml: str,
-            ptr: tmp
-          });
-        }
-      } else if (isMultiline && (c === "\n" || c === " " || c === "	" || c === "\r")) {
-        ptr = skipVoid(str, ptr - 1, true);
-        if (str[ptr] !== "\n" && str[ptr] !== "\r") {
-          throw new TomlError("invalid escape: only line-ending whitespace may be escaped", {
-            toml: str,
-            ptr: tmp
-          });
-        }
-        ptr = skipVoid(str, ptr);
-      } else if (c in ESC_MAP) {
-        parsed += ESC_MAP[c];
+        let value = 0;
+        let len = c === "x" ? 2 : c === "u" ? 4 : 8;
+        for (let j = 0; j < len; j++, i++) {
+          let hex3 = str.charCodeAt(i + 1);
+          let digit = (
+            /* 0-9 */
+            hex3 >= 48 && hex3 <= 57 ? hex3 - 48 : (
+              /* A-F */
+              hex3 >= 65 && hex3 <= 70 ? hex3 - 65 + 10 : (
+                /* a-f */
+                hex3 >= 97 && hex3 <= 102 ? hex3 - 97 + 10 : -1
+              )
+            )
+          );
+          if (digit < 0)
+            throw new TomlError("invalid non-hex character in unicode escape", { toml: str, ptr: i + 1 });
+          value = value << 4 | digit;
+        }
+        if (value < 0 || value > 1114111 || value >= 55296 && value <= 57343) {
+          throw new TomlError("invalid unicode escape", { toml: str, ptr: i });
+        }
+        parsed += String.fromCodePoint(value);
+        sliceStart = i + 1;
+        state = 0;
+      } else if (c === " " || c === "	") {
+        state = 2;
       } else {
-        throw new TomlError("unrecognized escape sequence", {
+        if (c === "b")
+          parsed += "\b";
+        else if (c === "t")
+          parsed += "	";
+        else if (c === "n")
+          parsed += "\n";
+        else if (c === "f")
+          parsed += "\f";
+        else if (c === "r")
+          parsed += "\r";
+        else if (c === "e")
+          parsed += "\x1B";
+        else if (c === '"')
+          parsed += '"';
+        else if (c === "\\")
+          parsed += "\\";
+        else
+          throw new TomlError("unrecognized escape sequence", { toml: str, ptr: i });
+        sliceStart = i + 1;
+        state = 0;
+      }
+    } else if (c !== " " && c !== "	") {
+      if (state === 2) {
+        throw new TomlError("invalid escape: only line-ending whitespace may be escaped", {
           toml: str,
-          ptr: tmp
+          ptr: sliceStart
         });
       }
-      sliceStart = ptr;
-    } else if (!isLiteral && c === "\\") {
-      tmp = ptr - 1;
-      isEscape = true;
-      parsed += str.slice(sliceStart, tmp);
+      state = !isLiteral && c === "\\" ? 1 : 0;
+      sliceStart = i;
     }
   }
-  return parsed + str.slice(sliceStart, endPtr - 1);
+  throw new TomlError("unfinished string", { toml: str, ptr });
 }
 function parseValue(value, toml, ptr, integersAsBigInt) {
   if (value === "true")
@@ -41807,26 +41790,74 @@ function parseValue(value, toml, ptr, integersAsBigInt) {
   }
   return date5;
 }
-var INT_REGEX, FLOAT_REGEX, LEADING_ZERO, ESCAPE_REGEX, ESC_MAP;
+var INT_REGEX, FLOAT_REGEX, LEADING_ZERO;
 var init_primitive = __esm({
   "../../node_modules/smol-toml/dist/primitive.js"() {
-    init_util2();
     init_date();
     init_error();
     INT_REGEX = /^((0x[0-9a-fA-F](_?[0-9a-fA-F])*)|(([+-]|0[ob])?\d(_?\d)*))$/;
     FLOAT_REGEX = /^[+-]?\d(_?\d)*(\.\d(_?\d)*)?([eE][+-]?\d(_?\d)*)?$/;
     LEADING_ZERO = /^[+-]?0[0-9_]/;
-    ESCAPE_REGEX = /^[0-9a-f]{2,8}$/i;
-    ESC_MAP = {
-      b: "\b",
-      t: "	",
-      n: "\n",
-      f: "\f",
-      r: "\r",
-      e: "\x1B",
-      '"': '"',
-      "\\": "\\"
-    };
+  }
+});
+
+// ../../node_modules/smol-toml/dist/util.js
+function indexOfNewline(str, start2 = 0, end = str.length) {
+  let idx = str.indexOf("\n", start2);
+  if (str[idx - 1] === "\r")
+    idx--;
+  return idx <= end ? idx : -1;
+}
+function skipComment(str, ptr) {
+  for (let i = ptr; i < str.length; i++) {
+    let c = str[i];
+    if (c === "\n")
+      return i;
+    if (c === "\r" && str[i + 1] === "\n")
+      return i + 1;
+    if (c < " " && c !== "	" || c === "\x7F") {
+      throw new TomlError("control characters are not allowed in comments", {
+        toml: str,
+        ptr
+      });
+    }
+  }
+  return str.length;
+}
+function skipVoid(str, ptr, banNewLines, banComments) {
+  let c;
+  while (1) {
+    while ((c = str[ptr]) === " " || c === "	" || !banNewLines && (c === "\n" || c === "\r" && str[ptr + 1] === "\n"))
+      ptr++;
+    if (banComments || c !== "#")
+      break;
+    ptr = skipComment(str, ptr);
+  }
+  return ptr;
+}
+function skipUntil(str, ptr, sep, end, banNewLines = false) {
+  if (!end) {
+    ptr = indexOfNewline(str, ptr);
+    return ptr < 0 ? str.length : ptr;
+  }
+  for (let i = ptr; i < str.length; i++) {
+    let c = str[i];
+    if (c === "#") {
+      i = indexOfNewline(str, i);
+    } else if (c === sep) {
+      return i + 1;
+    } else if (c === end || banNewLines && (c === "\n" || c === "\r" && str[i + 1] === "\n")) {
+      return i;
+    }
+  }
+  throw new TomlError("cannot find end of structure", {
+    toml: str,
+    ptr
+  });
+}
+var init_util2 = __esm({
+  "../../node_modules/smol-toml/dist/util.js"() {
+    init_error();
   }
 });
 
@@ -41863,24 +41894,23 @@ function extractValue(str, ptr, end, depth, integersAsBigInt) {
     }
     return [value, endPtr2];
   }
-  let endPtr;
   if (c === '"' || c === "'") {
-    endPtr = getStringEnd(str, ptr);
-    let parsed = parseString(str, ptr, endPtr);
+    let [parsed, endPtr2] = parseString(str, ptr);
     if (end) {
-      endPtr = skipVoid(str, endPtr);
-      if (str[endPtr] && str[endPtr] !== "," && str[endPtr] !== end && str[endPtr] !== "\n" && str[endPtr] !== "\r") {
+      endPtr2 = skipVoid(str, endPtr2);
+      if (str[endPtr2] && str[endPtr2] !== "," && str[endPtr2] !== end && str[endPtr2] !== "\n" && str[endPtr2] !== "\r") {
         throw new TomlError("unexpected character encountered", {
           toml: str,
-          ptr: endPtr
+          ptr: endPtr2
         });
       }
-      endPtr += +(str[endPtr] === ",");
+      if (str[endPtr2] === ",")
+        endPtr2++;
     }
-    return [parsed, endPtr];
+    return [parsed, endPtr2];
   }
-  endPtr = skipUntil(str, ptr, ",", end);
-  let slice = sliceAndTrimEndOf(str, ptr, endPtr - +(str[endPtr - 1] === ","));
+  let endPtr = skipUntil(str, ptr, ",", end);
+  let slice = sliceAndTrimEndOf(str, ptr, endPtr - (str[endPtr - 1] === "," ? 1 : 0));
   if (!slice[0]) {
     throw new TomlError("incomplete key-value declaration: no value specified", {
       toml: str,
@@ -41889,7 +41919,8 @@ function extractValue(str, ptr, end, depth, integersAsBigInt) {
   }
   if (end && slice[1] > -1) {
     endPtr = skipVoid(str, ptr + slice[1]);
-    endPtr += +(str[endPtr] === ",");
+    if (str[endPtr] === ",")
+      endPtr++;
   }
   return [
     parseValue(slice[0], str, ptr, integersAsBigInt),
@@ -41926,13 +41957,7 @@ function parseKey(str, ptr, end = "=") {
             ptr
           });
         }
-        let eos = getStringEnd(str, ptr);
-        if (eos < 0) {
-          throw new TomlError("unfinished string encountered", {
-            toml: str,
-            ptr
-          });
-        }
+        let [part, eos] = parseString(str, ptr);
         dot = str.indexOf(".", eos);
         let strEnd = str.slice(eos, dot < 0 || dot > endPtr ? endPtr : dot);
         let newLine = indexOfNewline(strEnd);
@@ -41957,7 +41982,7 @@ function parseKey(str, ptr, end = "=") {
             });
           }
         }
-        parsed.push(parseString(str, ptr, eos));
+        parsed.push(part);
       } else {
         dot = str.indexOf(".", ptr);
         let part = str.slice(ptr, dot < 0 || dot > endPtr ? endPtr : dot);
@@ -43925,7 +43950,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@semiont/cli",
-      version: "0.5.9",
+      version: "0.5.10",
       description: "Semiont CLI - Unified environment management tool",
       _comment: "AWS SDK dependencies (@aws-sdk/*) are only used by platforms/aws",
       type: "module",
@@ -43986,7 +44011,7 @@ var require_package = __commonJS({
         "js-yaml": "^4.2.0",
         "neo4j-driver": "^6.1.0",
         react: "^19.2.6",
-        "smol-toml": "^1.6.1",
+        "smol-toml": "^1.7.0",
         "socket.io": "^4.5.4",
         zod: "^4.4.3"
       },
@@ -44001,21 +44026,21 @@ var require_package = __commonJS({
         vitest: "^4.1.8"
       },
       optionalDependencies: {
-        "@aws-sdk/client-cloudformation": "^3.1065.0",
-        "@aws-sdk/client-cloudwatch": "^3.1065.0",
-        "@aws-sdk/client-cloudwatch-logs": "^3.1065.0",
-        "@aws-sdk/client-cost-explorer": "^3.1065.0",
-        "@aws-sdk/client-ecr": "^3.1065.0",
-        "@aws-sdk/client-ecs": "^3.1065.0",
-        "@aws-sdk/client-efs": "^3.1065.0",
-        "@aws-sdk/client-elastic-load-balancing-v2": "^3.1065.0",
-        "@aws-sdk/client-lambda": "^3.1065.0",
-        "@aws-sdk/client-neptune": "^3.1065.0",
-        "@aws-sdk/client-rds": "^3.1065.0",
-        "@aws-sdk/client-route-53": "^3.1065.0",
-        "@aws-sdk/client-secrets-manager": "^3.1065.0",
-        "@aws-sdk/client-sts": "^3.1065.0",
-        "@aws-sdk/client-wafv2": "^3.1065.0"
+        "@aws-sdk/client-cloudformation": "^3.1075.0",
+        "@aws-sdk/client-cloudwatch": "^3.1075.0",
+        "@aws-sdk/client-cloudwatch-logs": "^3.1075.0",
+        "@aws-sdk/client-cost-explorer": "^3.1075.0",
+        "@aws-sdk/client-ecr": "^3.1075.0",
+        "@aws-sdk/client-ecs": "^3.1075.0",
+        "@aws-sdk/client-efs": "^3.1075.0",
+        "@aws-sdk/client-elastic-load-balancing-v2": "^3.1075.0",
+        "@aws-sdk/client-lambda": "^3.1075.0",
+        "@aws-sdk/client-neptune": "^3.1075.0",
+        "@aws-sdk/client-rds": "^3.1075.0",
+        "@aws-sdk/client-route-53": "^3.1075.0",
+        "@aws-sdk/client-secrets-manager": "^3.1075.0",
+        "@aws-sdk/client-sts": "^3.1075.0",
+        "@aws-sdk/client-wafv2": "^3.1075.0"
       },
       overrides: {
         esbuild: "0.27.2"
@@ -46638,7 +46663,7 @@ init_cli_logger();
 init_config_loader();
 import * as path38 from "path";
 import { promises as nodeFs } from "fs";
-import { resourceId as toResourceId, annotationId as toAnnotationId, mediaTypeForExtension } from "@semiont/core";
+import { resourceId as toResourceId, annotationId as toAnnotationId, mediaTypeForExtension, isSupportedMediaType } from "@semiont/core";
 
 // src/core/client-factory.ts
 init_dist();
@@ -46733,7 +46758,13 @@ var YieldOptionsSchema = ApiOptionsSchema.extend({
   sourceLanguage: external_exports.string().optional(),
   temperature: external_exports.coerce.number().min(0).max(1).optional(),
   maxTokens: external_exports.coerce.number().int().min(100).max(4e3).optional(),
-  contextWindow: external_exports.coerce.number().int().min(100).max(5e3).default(1e3)
+  contextWindow: external_exports.coerce.number().int().min(100).max(5e3).default(1e3),
+  /**
+   * Media type of the generated resource (delegate mode). Validated for
+   * registry membership at the call site; the create route owns the
+   * authorable / role-appropriateness rejection (MEDIA-TYPES).
+   */
+  outputMediaType: external_exports.string().optional()
 }).superRefine((val, ctx) => {
   const hasUpload = val.upload.length > 0;
   const hasDelegate = val.delegate;
@@ -46748,14 +46779,44 @@ var YieldOptionsSchema = ApiOptionsSchema.extend({
   }
   if (hasDelegate) {
     if (!val.resource) ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: "--resource <resourceId> is required with --delegate" });
-    if (!val.annotation) ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: "--annotation <annotationId> is required with --delegate" });
     if (!val.storageUri) ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: "--storage-uri is required with --delegate" });
   }
 });
+function resolveOutputMediaType(raw) {
+  if (raw === void 0) return void 0;
+  if (!isSupportedMediaType(raw)) {
+    throw new Error(`Unknown output media type: ${raw}`);
+  }
+  return raw;
+}
+function extractResult(final) {
+  if (final.kind !== "complete") return {};
+  const r = final.data?.result ?? {};
+  return { resourceId: r.resourceId, resourceName: r.resourceName };
+}
 async function runDelegate(semiont, options) {
   const rawResourceId = options.resource;
-  const rawAnnotationId = options.annotation;
   const rId = toResourceId(rawResourceId);
+  const outputMediaType = resolveOutputMediaType(options.outputMediaType);
+  if (!options.annotation) {
+    const context2 = await semiont.gather.resource(rId, { includeContent: true, includeSummary: true });
+    if (!options.quiet) process.stderr.write(`Deriving from resource ${rawResourceId}...
+`);
+    const final2 = await (0, import_rxjs2.lastValueFrom)(
+      semiont.yield.fromResource(rId, {
+        title: options.title ?? rawResourceId,
+        storageUri: options.storageUri,
+        context: context2,
+        prompt: options.prompt,
+        language: options.language,
+        temperature: options.temperature,
+        maxTokens: options.maxTokens,
+        outputMediaType
+      })
+    );
+    return extractResult(final2);
+  }
+  const rawAnnotationId = options.annotation;
   const aId = toAnnotationId(rawAnnotationId);
   const context = await (0, import_rxjs2.lastValueFrom)(
     semiont.gather.annotation(rId, aId, { contextWindow: options.contextWindow })
@@ -46772,11 +46833,11 @@ async function runDelegate(semiont, options) {
       language: options.language,
       sourceLanguage: options.sourceLanguage ?? ctxSourceLanguage,
       temperature: options.temperature,
-      maxTokens: options.maxTokens
+      maxTokens: options.maxTokens,
+      outputMediaType
     })
   );
-  const r = (final.kind === "complete" ? final.data.result : void 0) ?? {};
-  return { resourceId: r.resourceId, resourceName: r.resourceName };
+  return extractResult(final);
 }
 async function runYield(options) {
   const startTime = Date.now();
@@ -46836,7 +46897,7 @@ async function runYield(options) {
   };
 }
 var yieldCmd = new CommandBuilder().name("yield").description(
-  "Upload a local file as a resource (--upload), or generate a new resource from an annotation's gathered context (--delegate). Delegate mode outputs JSON { resourceId, resourceName, storageUri } to stdout."
+  "Upload a local file as a resource (--upload), or generate a new resource via --delegate: from an annotation's gathered context (with --annotation), or derived from a whole source resource (without --annotation). Delegate mode outputs JSON { resourceId, resourceName, storageUri } to stdout."
 ).requiresEnvironment(true).requiresServices(true).examples(
   "semiont yield --upload docs/overview.md",
   'semiont yield --upload docs/overview.md --name "Overview Document"',
@@ -46844,6 +46905,8 @@ var yieldCmd = new CommandBuilder().name("yield").description(
   "semiont yield --delegate --resource <resourceId> --annotation <annotationId> --storage-uri file://generated/paris.md",
   'semiont yield --delegate --resource <resourceId> --annotation <annotationId> --storage-uri file://generated/paris.md --title "Paris" --language en',
   'semiont yield --delegate --resource <resourceId> --annotation <annotationId> --storage-uri file://generated/paris.md --prompt "Write a brief encyclopedia entry" --temperature 0.3',
+  'semiont yield --delegate --resource <resourceId> --storage-uri file://generated/summary.md --prompt "Summarize this document"',
+  'semiont yield --delegate --resource <resourceId> --storage-uri file://generated/translated.html --prompt "Translate to French" --language fr --output-media-type text/html',
   `NEW_ID=$(semiont yield --delegate --resource <resourceId> --annotation <annotationId> --storage-uri file://generated/loc.md --quiet | jq -r '.resourceId') && semiont bind <resourceId> <annotationId> "$NEW_ID"`
 ).args({
   ...withApiArgs({
@@ -46895,6 +46958,10 @@ var yieldCmd = new CommandBuilder().name("yield").description(
     "--context-window": {
       type: "string",
       description: "Delegate mode: characters of annotation context to gather (100\u20135000, default: 1000)"
+    },
+    "--output-media-type": {
+      type: "string",
+      description: "Delegate mode: media type of the generated resource (e.g. text/markdown, text/html; default: text/markdown)"
     }
   }, {
     "-n": "--name"
@@ -47268,7 +47335,12 @@ async function runGather(options) {
   let result;
   if (subcommand === "resource") {
     const id = toResourceId3(rawResourceId);
-    result = await semiont.gather.resource(id, { contextWindow: options.contextWindow });
+    result = await semiont.gather.resource(id, {
+      depth: options.depth,
+      maxResources: options.maxResources,
+      includeContent: !options.noContent,
+      includeSummary: options.summary
+    });
   } else if (subcommand === "annotation") {
     if (!rawAnnotationId) {
       throw new Error("Usage: semiont gather annotation <resourceId> <annotationId>");
@@ -47339,8 +47411,8 @@ async function runMatch(options) {
   let context = await (0, import_rxjs5.lastValueFrom)(
     semiont.gather.annotation(resourceId3, annotationId3, { contextWindow: options.contextWindow })
   );
-  if (options.userHint) {
-    context = { ...context, userHint: options.userHint };
+  if (options.userHint && context.focus.kind === "annotation") {
+    context = { ...context, focus: { ...context.focus, userHint: options.userHint } };
   }
   const searchResult = await (0, import_rxjs5.firstValueFrom)(
     semiont.match.search(resourceId3, annotationId3, context, {
@@ -48969,7 +49041,7 @@ async function generateGlobalHelp() {
 }
 
 // src/cli.ts
-var VERSION = "0.5.9";
+var VERSION = "0.5.10";
 function printVersion() {
   console.log(`Semiont CLI v${VERSION}`);
 }
@@ -49013,10 +49085,10 @@ main().catch((error51) => {
 js-yaml/dist/js-yaml.mjs:
   (*! js-yaml 4.2.0 https://github.com/nodeca/js-yaml @license MIT *)
 
-smol-toml/dist/error.js:
-smol-toml/dist/util.js:
 smol-toml/dist/date.js:
+smol-toml/dist/error.js:
 smol-toml/dist/primitive.js:
+smol-toml/dist/util.js:
 smol-toml/dist/extract.js:
 smol-toml/dist/struct.js:
 smol-toml/dist/parse.js: