@cubos/agent-sdk 0.0.1154013 → 0.0.1154312

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5348,7 +5348,7 @@ export interface paths {
5348
5348
  };
5349
5349
  content?: never;
5350
5350
  };
5351
- /** @description Another claimant holds a live lease. */
5351
+ /** @description Another claimant holds a live lease — or, as a plain-text body, the conversation is archived. */
5352
5352
  409: {
5353
5353
  headers: {
5354
5354
  [name: string]: unknown;
@@ -6076,7 +6076,7 @@ export interface paths {
6076
6076
  };
6077
6077
  /**
6078
6078
  * Create or replace a filesystem file
6079
- * @description Writes one file into the conversation's filesystem, creating parent directories and overwriting whatever was at `path`. The body is `multipart/form-data` with a single `file` part. Starts no turn: the agent is told about the change as part of its next request, so send a message or a steer if you want an answer now. 409 when the conversation's agent has `feature_filesystem` off; 413 when the file or the resulting tree is over the size cap.
6079
+ * @description Writes one file into the conversation's filesystem, creating parent directories and overwriting whatever was at `path`. The body is `multipart/form-data` with a single `file` part. Starts no turn: the agent is told about the change as part of its next request, so send a message or a steer if you want an answer now. 409 when the conversation's agent has `feature_filesystem` off or the conversation is archived; 413 when the file or the resulting tree is over the size cap.
6080
6080
  */
6081
6081
  put: {
6082
6082
  parameters: {
@@ -6663,7 +6663,7 @@ export interface paths {
6663
6663
  put?: never;
6664
6664
  /**
6665
6665
  * Steer the agent
6666
- * @description Appends an `agent_directive` — an operator/system instruction (e.g. a failed payment to resolve) the agent acts on and replies to the user about, rendered to the model distinctly from the user's own words — and wakes the dispatcher. Works on any conversation, including channel-backed ones. Empty content returns 400.
6666
+ * @description Appends an `agent_directive` — an operator/system instruction (e.g. a failed payment to resolve) the agent acts on and replies to the user about, rendered to the model distinctly from the user's own words — and wakes the dispatcher. Works on any conversation, including channel-backed ones, as long as it is not archived: an archived conversation takes no new event and returns 409. Empty content returns 400.
6667
6667
  */
6668
6668
  post: {
6669
6669
  parameters: {
@@ -6715,6 +6715,13 @@ export interface paths {
6715
6715
  };
6716
6716
  content?: never;
6717
6717
  };
6718
+ /** @description The conversation is archived. */
6719
+ 409: {
6720
+ headers: {
6721
+ [name: string]: unknown;
6722
+ };
6723
+ content?: never;
6724
+ };
6718
6725
  };
6719
6726
  };
6720
6727
  delete?: never;
@@ -6858,7 +6865,7 @@ export interface paths {
6858
6865
  put?: never;
6859
6866
  /**
6860
6867
  * Send a user message
6861
- * @description Appends a `user_message` to the conversation log with a serialized, monotonically increasing `seq`, and wakes the dispatcher so a turn runs. Only for conversations without a channel — a channel-backed conversation (Telegram/WhatsApp/…) receives the user's words through the channel itself, so injecting one here would forge a message the user never sent; that returns 409. Empty content returns 400.
6868
+ * @description Appends a `user_message` to the conversation log with a serialized, monotonically increasing `seq`, and wakes the dispatcher so a turn runs. Only for conversations without a channel — a channel-backed conversation (Telegram/WhatsApp/…) receives the user's words through the channel itself, so injecting one here would forge a message the user never sent; that returns 409. An archived conversation takes no new event and also returns 409. Empty content returns 400.
6862
6869
  */
6863
6870
  post: {
6864
6871
  parameters: {
@@ -6910,6 +6917,7 @@ export interface paths {
6910
6917
  };
6911
6918
  content?: never;
6912
6919
  };
6920
+ /** @description The conversation is channel-backed, or archived. */
6913
6921
  409: {
6914
6922
  headers: {
6915
6923
  [name: string]: unknown;
@@ -6935,7 +6943,7 @@ export interface paths {
6935
6943
  put?: never;
6936
6944
  /**
6937
6945
  * Send a voice message
6938
- * @description Appends a `user_message` carrying an audio attachment and wakes the dispatcher. `multipart/form-data` with an `audio` part. The bytes are stored content-addressed; the harness transcribes them through the agent's STT model before the turn runs and records a `media_transcription` event, so the reply answers what was said. The message content is empty by design — the transcription is the text. Same channel rule as the text route: a channel-backed conversation returns 409.
6946
+ * @description Appends a `user_message` carrying an audio attachment and wakes the dispatcher. `multipart/form-data` with an `audio` part. The bytes are stored content-addressed; the harness transcribes them through the agent's STT model before the turn runs and records a `media_transcription` event, so the reply answers what was said. The message content is empty by design — the transcription is the text. Same rules as the text route: a channel-backed or archived conversation returns 409.
6939
6947
  */
6940
6948
  post: {
6941
6949
  parameters: {
@@ -6988,7 +6996,7 @@ export interface paths {
6988
6996
  };
6989
6997
  content?: never;
6990
6998
  };
6991
- /** @description The conversation is channel-backed. */
6999
+ /** @description The conversation is channel-backed, or archived. */
6992
7000
  409: {
6993
7001
  headers: {
6994
7002
  [name: string]: unknown;
@@ -7021,7 +7029,7 @@ export interface paths {
7021
7029
  put?: never;
7022
7030
  /**
7023
7031
  * Send a user message with images
7024
- * @description Appends one `user_message` carrying up to 10 image attachments. `multipart/form-data` with repeated `file` parts (any `image/*` type), optional repeated `label` text parts (the i-th label names the i-th file — the model sees it next to that image and can refer to images by name), and an optional `caption` text part shared by the set. The harness shows the images to the model natively when the agent's chat model has vision, or describes them with the agent's fallback vision model — in both cases after the image plugin has normalized them (oriented, downscaled, re-encoded as PNG or JPEG); a type no plugin reads reaches the model as a placeholder. Same channel rule as the plain user-message route: channel-backed conversations return 409.
7032
+ * @description Appends one `user_message` carrying up to 10 image attachments. `multipart/form-data` with repeated `file` parts (any `image/*` type), optional repeated `label` text parts (the i-th label names the i-th file — the model sees it next to that image and can refer to images by name), and an optional `caption` text part shared by the set. The harness shows the images to the model natively when the agent's chat model has vision, or describes them with the agent's fallback vision model — in both cases after the image plugin has normalized them (oriented, downscaled, re-encoded as PNG or JPEG); a type no plugin reads reaches the model as a placeholder. Same channel rule as the plain user-message route: channel-backed conversations return 409, and so do archived ones.
7025
7033
  */
7026
7034
  post: {
7027
7035
  parameters: {
@@ -7074,6 +7082,7 @@ export interface paths {
7074
7082
  };
7075
7083
  content?: never;
7076
7084
  };
7085
+ /** @description The conversation is channel-backed, or archived. */
7077
7086
  409: {
7078
7087
  headers: {
7079
7088
  [name: string]: unknown;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cubos/agent-sdk",
3
- "version": "0.0.1154013",
3
+ "version": "0.0.1154312",
4
4
  "type": "module",
5
5
  "description": "Client for the Cubos Agent conversation API. Runs anywhere fetch does.",
6
6
  "license": "SEE LICENSE IN LICENSE",