@astralform/js 4.5.0 → 4.6.0

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

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

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,