@astralform/js 4.5.0 → 4.6.1

package/dist/index.d.cts

@@ -673,6 +673,7 @@ interface ChatStreamRequest {
     upload_ids?: string[];
     agent_name?: string;
     plan_mode?: boolean;
+    image_mode?: boolean;
     /**
      * Start a durable long-horizon goal for this run (goal mode). The backend mints
      * an agent_goal from this text and drives the run under a budget until the
@@ -764,6 +765,20 @@ interface SendOptions$1 extends ModelChoiceOptions {
     uploadIds?: string[];
     agentName?: string;
     planMode?: boolean;
+    /**
+     * Attach the image-generation tool to this turn.
+     *
+     * Off by default and per-message, because generating costs the developer real
+     * money at a third-party provider — the agent does not get to decide on its
+     * own that a picture would be nice. The tool is not attached at all unless
+     * this is set, so an agent with image generation configured still cannot
+     * generate one on an ordinary turn.
+     *
+     * Gate the affordance on `AgentStatus.capabilities` (Astralform ≥ 0.61.0) —
+     * an agent with no provider configured will simply have no tool to call.
+     * The `image_mode` field itself is accepted from Astralform ≥ 0.59.0.
+     */
+    imageMode?: boolean;
     /**
      * Start a durable long-horizon goal for this run (goal mode). The text becomes
      * the goal's objective; the backend keeps the agent working under a budget until
@@ -1263,6 +1278,12 @@ interface SendOptions extends ModelChoiceOptions {
     agentName?: string;
     uploadIds?: string[];
     planMode?: boolean;
+    /**
+     * Attach the image-generation tool to this turn. Per-message and off by
+     * default — generating costs the developer real money at a third-party
+     * provider. Gate the affordance on `AgentStatus.capabilities`.
+     */
+    imageMode?: boolean;
     /**
      * Start a durable long-horizon goal for this run (goal mode) — the text is the
      * goal objective the backend drives to completion. Omit for a normal turn.

package/dist/index.d.ts

@@ -673,6 +673,7 @@ interface ChatStreamRequest {
     upload_ids?: string[];
     agent_name?: string;
     plan_mode?: boolean;
+    image_mode?: boolean;
     /**
      * Start a durable long-horizon goal for this run (goal mode). The backend mints
      * an agent_goal from this text and drives the run under a budget until the
@@ -764,6 +765,20 @@ interface SendOptions$1 extends ModelChoiceOptions {
     uploadIds?: string[];
     agentName?: string;
     planMode?: boolean;
+    /**
+     * Attach the image-generation tool to this turn.
+     *
+     * Off by default and per-message, because generating costs the developer real
+     * money at a third-party provider — the agent does not get to decide on its
+     * own that a picture would be nice. The tool is not attached at all unless
+     * this is set, so an agent with image generation configured still cannot
+     * generate one on an ordinary turn.
+     *
+     * Gate the affordance on `AgentStatus.capabilities` (Astralform ≥ 0.61.0) —
+     * an agent with no provider configured will simply have no tool to call.
+     * The `image_mode` field itself is accepted from Astralform ≥ 0.59.0.
+     */
+    imageMode?: boolean;
     /**
      * Start a durable long-horizon goal for this run (goal mode). The text becomes
      * the goal's objective; the backend keeps the agent working under a budget until
@@ -1263,6 +1278,12 @@ interface SendOptions extends ModelChoiceOptions {
     agentName?: string;
     uploadIds?: string[];
     planMode?: boolean;
+    /**
+     * Attach the image-generation tool to this turn. Per-message and off by
+     * default — generating costs the developer real money at a third-party
+     * provider. Gate the affordance on `AgentStatus.capabilities`.
+     */
+    imageMode?: boolean;
     /**
      * Start a durable long-horizon goal for this run (goal mode) — the text is the
      * goal objective the backend drives to completion. Omit for a normal turn.

package/dist/index.js

@@ -1400,6 +1400,7 @@ var ChatSession = class {
       upload_ids: options?.uploadIds,
       agent_name: options?.agentName,
       plan_mode: options?.planMode,
+      image_mode: options?.imageMode,
       goal: options?.goal,
       // Per-request model choice (client-side model selection).
       provider: options?.provider,
@@ -2084,6 +2085,7 @@ var StreamManager = class {
         agentName: options?.agentName,
         uploadIds: options?.uploadIds,
         planMode: options?.planMode,
+        imageMode: options?.imageMode,
         goal: options?.goal,
         provider: options?.provider,
         model: options?.model,