awen

Moves files and folders of a project the user can edit into one folder, in a single call. Pass each item's entry_id from list_folder, never a media_id, and folder_id "root" for the project root or a folder's entry_id. A memory never moves inside another memory, and no other file named Memory.md moves into one: a memory reads its instructions only from its own Memory.md.

move_file

Prepares the upload of a file you hold that has no public URL: a file the user attached that your code sandbox can read, or a file on this machine. 1) Measure it: its exact size in bytes and its SHA-256 in hex (wc -c < FILE; shasum -a 256 FILE or sha256sum FILE; on Windows, Get-FileHash -Algorithm SHA256). 2) Call this tool with the name it gets in the Drive, its size and its SHA-256. 3) Within 10 minutes, run the returned command with /path/to/file replaced by the file's path, inside its single quotes, with any ' in the path written as '\'', and change nothing else (your host may ask the user to approve it once). If your host cannot run it, ask the user to run it: never send the request another way. It fetches awen's upload script and sends the raw bytes to upload_host, and the upload completes only with the exact file you measured. If it stops at a refusal, next_steps says what to do for its code. Without a POSIX shell, send the same requests to upload_url with the authorization. 4) Within 30 minutes, call import_file with the same project_id and folder_id and this upload_id to place the file; an upload not placed by then is deleted. Send and place one file before preparing the next. The command needs network access to script_host for the script, then to upload_host for the file. If curl cannot reach script_host it prints only its own error: ask the user to allow both hosts. Otherwise, when the command fails, its last line, starting with awen:, says what to do next. Drive takes files up to 512 MB, images up to 95 MB and any video, never programs. Only an MP4 opens as a video in awen: other formats save as plain files.

create_upload

Reads how an image, video or 3D model was made, as awen's Lineage panel shows it: the files it came from, the step that used each one, each file's "Authorized for usage" declaration and audit severity, and the latest lineage audit. The declaration is false until a member confirms a file's rights in awen, which does not mean it is forbidden. unaudited counts the earlier files no audit has read, not this file, and the audit is null until one runs. Pass a file:… id or a media_id. Files come nearest first, up to 50 a page, with the edges from each file to the files made from it; pass next_cursor back as cursor to continue. fetch opens a file whose id is not null and gives its prompt and model. complete is false when the history is too long to read here: audit counts are then left out, and awen shows it whole.

get_lineage

Reads one item by the id that search or a list returned (project:…, folder:…, file:… or conversation:…). A file gives its description, tags, prompt, model and a download link valid 5 minutes; authorized_for_usage false means no member has confirmed its rights in awen yet, not that it is forbidden. With include_preview, an image, video or 3D model also comes as a small picture you can see, when you can't open the link or the user asks what it looks like: metadata.preview says included, pending when a new file's picture is not drawn yet, so ask again in a moment, not_applicable for a text file, whose text is in the answer, or unavailable; a text file (Markdown, text, CSV, HTML) gives its content, 32 KiB at a time. A folder or project gives its listing, a memory its instructions, a conversation its messages, 20 at a time. Pass metadata.next_offset back as offset to continue a file or a conversation.

fetch

Renames a file in a project the user can edit; the name applies to its Drive entry and its content. Pass the file's entry_id from list_folder, never a media_id. Folders can't be renamed. A memory reads its instructions from its Memory.md: that file keeps its name, and no other file in a memory can be named Memory.md; the user edits a memory's instructions in awen.

rename_file

Searches what the user can see in awen: project names, the Library's images, videos, 3D models and canvases (by name, tags, description and prompt), folder and document names, the user's own conversation titles, and their memories. Returns up to 5 results of each kind; pass a result's id to fetch to read it. Use short keywords; list_projects, list_files and list_folder browse everything.

search

Shows a turn on a card that follows it live, where the host draws cards, and answers as get_turn does. Call it once when the user wants to see a turn again; use get_turn to follow one yourself.

show_turn

Starts an empty awen conversation in a project the user can edit, as New conversation does in awen. It sends no message. A person can have at most 100 active conversations in a project: at the limit this is refused until they archive one in the awen app.

start_conversation

Stops a running turn, as Stop does in awen: it saves what the reply wrote so far, charges the model calls that finished and frees the conversation. Generations that already started finish and are charged. A turn that already ended is left as it is. Answers the turn's status.

cancel_turn

Tells awen's team in one sentence what awen could not do for the user: a missing capability, an answer you could not use, or a bug. Call it once, after you tried and the need went unmet, and not for a refusal that explains itself, such as a full project. It fixes nothing and costs no credits, so still tell the user what happened. Describe the gap in general terms: never include the user's words, prompts, names, file names or links.

report_issue

Returns the awen user and the awen organisation this connection works in, what the connection may do, the organisation's plan, and the usage the user sees in awen. usage is null where the organisation hides it from members. plan or usage is null when awen can't read it right now. usage does not say whether a given request fits.

whoami