File データ構造

File オブジェクト

upload、get、list エンドポイントで File オブジェクトが返却されます。

フィールド	型	説明
`id`	string	`file_` プレフィックス付きの File ID
`type`	string	常に `"file"`
`filename`	string	保存されたファイル名
`size_bytes`	integer	ファイルサイズ（バイト）
`mime_type`	string	アップロード時に指定された、またはファイル名から検出された MIME タイプ
`downloadable`	boolean	このファイルを `GET /api/v1/cloud/files/{file_id}/content` 経由でダウンロードできるかどうか
`scope`	object \| null	他のリソースに関連付けられている場合のスコープオブジェクト。例: `{ "id": "sess_...", "type": "session" }`
`metadata`	object	アップロード時に指定するカスタムメタデータオブジェクト。デフォルトは `{}`
`created_at`	string	RFC 3339 形式の UTC 作成時刻

GET /api/v1/cloud/files/{file_id}/content はこのオブジェクトを返します。

フィールド	型	説明
`url`	string	署名付きダウンロード URL
`expires_at`	string	RFC 3339 形式の UTC での URL 有効期限

POST /api/v1/cloud/files は multipart/form-data を使用します。

フィールド	型	必須	説明
`file`	file	はい	テキストベースのファイルコンテンツ
`name`	string	いいえ	保存されるファイル名。デフォルトはアップロードされたファイル名。サーバーのサニタイズ後、長さは 1-255 バイトで、`.` または `..` は使用できません
`metadata`	JSON string	いいえ	フォームフィールドとしてエンコードされた有効な JSON。最大生データ長は 8 KB。デフォルトは `{}`

アップロードエンドポイントはテキストベースのファイルのみを受け付けます。

カテゴリ	受け入れ可能な値
MIME タイプ	すべての `text/*` MIME タイプに加え、`application/json`、`application/xml`、`application/javascript`、`application/x-yaml`、`application/x-toml`
拡張子	`.txt`, `.md`, `.csv`, `.json`, `.xml`, `.yaml`, `.yml`, `.toml`, `.ini`, `.conf`, `.cfg`, `.env`, `.log`, `.html`, `.htm`, `.css`, `.scss`, `.less`, `.js`, `.jsx`, `.ts`, `.tsx`, `.vue`, `.svelte`, `.py`, `.go`, `.rs`, `.java`, `.kt`, `.scala`, `.c`, `.cpp`, `.cc`, `.h`, `.hpp`, `.rb`, `.php`, `.swift`, `.r`, `.lua`, `.pl`, `.sh`, `.bash`, `.zsh`, `.fish`, `.ps1`, `.sql`, `.graphql`, `.gql`, `.proto`, `.dockerfile`, `.makefile`, `.gitignore`, `.editorconfig`, `.eslintrc`, `.prettierrc`, `.tex`, `.rst`, `.adoc`, `.org`, `.svg`
拡張子なしファイル名	`dockerfile`, `makefile`, `gemfile`, `rakefile`, `procfile`, `vagrantfile`, `justfile`, `brewfile`

Agent にコンテキストを提供するファイルをアップロードし、Agent が生成したファイルをダウンロードします。