@uniformdev/automations-sdk 20.74.7-alpha.3 → 20.75.0

package/dist/ai/index.d.mts

@@ -33,6 +33,11 @@ interface ScoutClientOptions extends ClientOptions {
      * @default 'https://ai.uniform.global'
      */
     aiApiHost?: string;
+    /**
+     * Default release for every turn this client invokes. See {@link ScoutInvokeParamsCommon.releaseId};
+     * a `releaseId` passed to {@link ScoutClient.invoke} overrides this for that turn.
+     */
+    releaseId?: string;
 }
 /** Shared invoke parameters. */
 interface ScoutInvokeParamsCommon {
@@ -46,6 +51,23 @@ interface ScoutInvokeParamsCommon {
      * text part.
      */
     message: string | ScoutInvokeMessage;
+    /**
+     * Release to work in for this turn. Content Scout reads is the release's version, and content it
+     * edits is staged in the release instead of base — the same behavior an author gets when editing
+     * inside a release in the dashboard. Omit to work on base.
+     *
+     * When reacting to a release-scoped event, pass the release id from the trigger payload. This
+     * seeds the turn; Scout can move off it with `setCurrentRelease` if the task calls for a different
+     * release, but it can never invent one — that tool validates the id before any write happens.
+     *
+     * Must be an *open* release; a save into a locked, launching, or launched release is refused.
+     * Assets are not part of releases and cannot be modified while this is set.
+     *
+     * On a continued thread, a release set on an earlier turn stays in effect: context is merged
+     * across the thread's messages, so omitting this does not reset the thread to base. Use
+     * `setCurrentRelease` from within the conversation to go back to base.
+     */
+    releaseId?: string;
 }
 /** Parameters for a Scout invocation. */
 interface ScoutInvokeParams<S extends ScoutOutputSchema = ScoutOutputSchema> extends ScoutInvokeParamsCommon {

package/dist/ai/index.mjs

@@ -40,9 +40,13 @@ var ScoutClient = class extends ApiClient {
     __privateSet(this, _aiApiHost, ((_a = options.aiApiHost) != null ? _a : DEFAULT_AI_HOST).replace(/\/+$/, ""));
   }
   async invoke(params) {
-    var _a;
+    var _a, _b;
     const threadId = (_a = params.threadId) != null ? _a : crypto.randomUUID();
-    const messages = [normalizeInvokeMessage(params.message)];
+    const messages = [
+      withInvocationContext(normalizeInvokeMessage(params.message), {
+        releaseId: (_b = params.releaseId) != null ? _b : this.options.releaseId
+      })
+    ];
     const outputSchema = params.outputSchema ? toOutputJsonSchema(params.outputSchema) : void 0;
     const result = await this.apiClient(
       new URL(__privateMethod(this, _ScoutClient_instances, endpoint_fn).call(this, threadId)),
@@ -104,6 +108,18 @@ function normalizeInvokeMessage(message) {
   }
   return { ...message, id: (_a = message.id) != null ? _a : crypto.randomUUID() };
 }
+function withInvocationContext(message, context) {
+  if (!context.releaseId) {
+    return message;
+  }
+  return {
+    ...message,
+    metadata: {
+      ...typeof message.metadata === "object" && message.metadata !== null ? message.metadata : {},
+      invocationContextChanges: { releaseId: context.releaseId }
+    }
+  };
+}
 export {
   ScoutClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/automations-sdk",
-  "version": "20.74.7-alpha.3+f1d91835fc",
+  "version": "20.75.0",
   "description": "Uniform Automations SDK",
   "license": "SEE LICENSE IN LICENSE.txt",
   "exports": {
@@ -40,8 +40,8 @@
   ],
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
-    "@uniformdev/context": "20.74.7-alpha.3+f1d91835fc",
-    "@uniformdev/webhooks": "20.74.7-alpha.3+f1d91835fc"
+    "@uniformdev/context": "20.75.0",
+    "@uniformdev/webhooks": "20.75.0"
   },
   "peerDependencies": {
     "ai": "^6.0.0",
@@ -62,5 +62,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "f1d91835fca9645311dde0f546008b1bfc98fbdf"
+  "gitHead": "945b06786c480e1595d06bfc51f539ddcf15f7c5"
 }