@cadenya/cadenya 0.43.0 → 0.45.0

package/src/resources/uploads.ts

@@ -0,0 +1,128 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as AccountAPI from './account';
+import * as Shared from './shared';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * UploadService issues short-lived presigned URLs for direct client-to-object-
+ *  storage uploads at the WORKSPACE level. Created uploads can be referenced by
+ *  id when creating or updating resources that accept binary content (e.g.,
+ *  MemoryEntry).
+ *
+ *  Authentication: Bearer token (JWT)
+ *  Scope: Workspace-level operations
+ */
+export class Uploads extends APIResource {
+  /**
+   * Issues a short-lived presigned URL for direct upload to object storage. The
+   * returned id is used to reference the upload from resources that accept binary
+   * content.
+   */
+  create(body: UploadCreateParams, options?: RequestOptions): APIPromise<Upload> {
+    return this._client.post('/v1/uploads', { body, ...options });
+  }
+
+  /**
+   * Retrieves the current state of an upload, including its lifecycle status
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<Upload> {
+    return this._client.get(path`/v1/uploads/${id}`, options);
+  }
+}
+
+/**
+ * Upload is a workspace-scoped handle representing a single file upload flow.
+ * Clients call CreateUpload to receive a short-lived presigned URL, PUT the file
+ * directly to object storage, then reference the upload by id when creating or
+ * updating resources that accept binary content.
+ *
+ * Uploads are one-shot: once consumed by a creating or updating resource, the
+ * upload transitions to UPLOAD_STATUS_CONSUMED and cannot be reused. Unused
+ * uploads expire and are garbage-collected by the runtime.
+ */
+export interface Upload {
+  info: UploadInfo;
+
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata: Shared.ResourceMetadata;
+
+  spec: UploadSpec;
+}
+
+export interface UploadInfo {
+  /**
+   * Profile represents a human user at the account level. Profiles are
+   * account-scoped resources that can be associated with multiple workspaces through
+   * the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).
+   */
+  createdBy?: AccountAPI.Profile;
+
+  /**
+   * Lifecycle state. Transitions PENDING → COMPLETE (storage confirms the object
+   * exists) → CONSUMED (a resource referenced this upload), or → EXPIRED (URL
+   * elapsed without a PUT).
+   */
+  status?:
+    | 'UPLOAD_STATUS_UNSPECIFIED'
+    | 'UPLOAD_STATUS_PENDING'
+    | 'UPLOAD_STATUS_COMPLETE'
+    | 'UPLOAD_STATUS_CONSUMED'
+    | 'UPLOAD_STATUS_EXPIRED';
+
+  /**
+   * Presigned PUT URL. Short-lived. The client must PUT with the exact Content-Type
+   * declared in the spec, and the body length must match size_bytes.
+   */
+  uploadUrl?: string;
+
+  /**
+   * Absolute time at which upload_url stops working.
+   */
+  uploadUrlExpiresAt?: string;
+}
+
+export interface UploadSpec {
+  /**
+   * MIME type the client will send. Baked into the presigned URL's signature — the
+   * PUT must match exactly or object storage will reject it.
+   */
+  contentType: string;
+
+  /**
+   * Client-supplied filename. Used for audit and display only; does not control the
+   * object's storage path.
+   */
+  filename: string;
+
+  /**
+   * Expected size of the upload in bytes. Baked into the presigned URL as a
+   * Content-Length constraint.
+   */
+  sizeBytes: string;
+}
+
+export interface UploadCreateParams {
+  /**
+   * CreateResourceMetadata contains the user-provided fields for creating a
+   * workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+   * profile_id, created_at) are excluded since they are set by the server.
+   */
+  metadata: Shared.CreateResourceMetadata;
+
+  spec: UploadSpec;
+}
+
+export declare namespace Uploads {
+  export {
+    type Upload as Upload,
+    type UploadInfo as UploadInfo,
+    type UploadSpec as UploadSpec,
+    type UploadCreateParams as UploadCreateParams,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.43.0'; // x-release-please-version
+export const VERSION = '0.45.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.43.0";
+export declare const VERSION = "0.45.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.43.0";
+export declare const VERSION = "0.45.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.43.0'; // x-release-please-version
+exports.VERSION = '0.45.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.43.0'; // x-release-please-version
+export const VERSION = '0.45.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map