その他の言語 (ABI)

任意の言語で Package を書くための ABI。

SDK は手間を省くためのもので、必須ではありません。WASI preview 1 向けの WebAssembly Module をビルドできる言語なら、ABI 1 を直接実装して Function package を書けます。wasi-sdk を使った C や C++、Zig、AssemblyScript、TinyGo、Swift、自作の言語でもかまいません。

ABI 1 の仕様は小さなものです。Module は MCP の stdio transport で通信する MCP サーバーで、ステートレスなリビジョン 2026-07-28 を使います。HTTP 用には host module を 1 つ import できます。

Module

アップロード時にはこれらがすべてチェックされ、拒否された場合はその理由が示されます。たとえば、Subako が提供しない import がある、export が足りない、Module ではなく component である、などです。

呼び出しの流れ

stderr はログに自由に使えます。stdout はプロトコル専用で、JSON-RPC メッセージでない行が 1 行でもあると呼び出しは失敗します。

プロトコル

どのリクエストにも、_meta にプロトコルのリビジョンとクライアントの capabilities が含まれています。initialize によるハンドシェイクはありません。

{"jsonrpc":"2.0","id":"call-0192f5c4","method":"tools/call","params":{"name":"greet","arguments":{"name":"Ada"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"subako","version":"0.2.3"},"io.modelcontextprotocol/clientCapabilities":{}}}}

レスポンスには、リクエストの id をそのまま入れて返してください。id は文字列か数値で、中身に意味はなく、毎回異なります。

Package をアップロードしたとき

Subako は Tool の一覧を得るために Module を一度実行します。このときは 10 秒以内に応答する必要があり、Volume もネットワークも使えず、マウントされるのは /package だけです。

1. server/discover: 対応しているリビジョンと、Tool を提供することを返します。

   {"jsonrpc":"2.0","id":"discover-1","result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{}}}}

2. tools/list: すべての Tool を返します。nextCursor を返すと、次のページを要求されます (最大 16 ページ)。

   {"jsonrpc":"2.0","id":"tools-list-1","result":{"tools":[{"name":"greet","description":"Greet someone by name.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Who to greet."}},"required":["name"]}}]}}

3. stdin が閉じたら、終了コード 0 で終了します。

tools/list で返した内容が、次のバージョンまでその Package の提供するものになります。決まりは次のとおりです。

Agent が Tool を呼び出したとき

Tool の name と、オブジェクト形式の arguments を持つ tools/call が 1 つ届きます。MCP の CallToolResult で応答してください。

{"jsonrpc":"2.0","id":"call-0192f5c4","result":{"content":[{"type":"text","text":"{\"message\":\"Hello, Ada!\"}"}],"structuredContent":{"message":"Hello, Ada!"}}}

Subako は arguments を Schema に照らしてチェックしないので、Module の側で検証してください。モデルに読ませたい失敗は、JSON-RPC のエラーにせず、isError を付けた結果として返します。

{"jsonrpc":"2.0","id":"call-0192f5c4","result":{"content":[{"type":"text","text":"name must not be empty"}],"isError":true}}

Subako が読む content block は次のとおりです。

volume:/// の URI は /volume より下の Path を表し、各セグメントはパーセントエンコードします。画像は PNG、JPEG、GIF、WebP のいずれかです。これ以外の resource_link はリンク先を示す 1 行として、表にないそのほかの block は省略したことを伝える注記として表示されます。

呼び出しが失敗する場合

Module が次のいずれかに当てはまると、モデルには Function がクラッシュしたことが、stderr の最後の 4 KiB とともに伝えられます。

• JSON-RPC の error で応答した、または resultType が complete 以外だった
• stdout に JSON-RPC メッセージでない行を出力した、または要求されていない id に応答した
• 自分からリクエストを送った (ステートレスなサーバーはリクエストを送りません)
• 応答する前に終了した、0 以外の終了コードで終了した、または stdin が閉じてから 1 秒以内に終了しなかった
• trap した、またはメモリや実行時間を使い切った

通知 (id のないメッセージ) は無視されます。

ファイル

ファイルシステムは WASI の preopen として、/volume/tmp、/volume/data (Agent が有効にしている場合)、/package (Package に Asset がある場合)、/skills と各 /skills/<name> の順に渡されます。ファイルは絶対パスで開いてください。

fd_allocate は ENOTSUP を返します。ファイルへの書き込みが 1 回の呼び出しの上限 1 GiB を超えると、EDQUOT が返ります。sock_* 関数はリンクされていますが、ソケットが渡されることはありません。HTTP は subako_http を通して送ります。

HTTP: subako_http

subako_http Module から import する関数は次の 2 つで、どちらも i32 の値を扱います。

負の戻り値は ABI の使い方の誤りを表します。-1 は Module のメモリ外の範囲を指定した、-2 は保持している応答がない、-3 は長さが一致しない、という意味です。

__attribute__((import_module("subako_http"), import_name("request")))
int32_t subako_http_request(const uint8_t *ptr, int32_t len);

__attribute__((import_module("subako_http"), import_name("read_response")))
int32_t subako_http_read_response(uint8_t *ptr, int32_t len);

リクエストは最大 8 MiB で、次のフィールドだけを受け付けます。

{
  "method": "POST",
  "url": "https://api.example.com/orders",
  "headers": { "accept": "application/json" },
  "body": { "type": "json", "json": { "order": 1042 } },
  "output": { "type": "inline" },
  "follow_redirects": true,
  "timeout_ms": 5000
}

応答は {"ok": ...} か {"error": ...} です。

{"ok":{"status":200,"headers":{"content-type":"application/json"},"body":{"type":"inline","text":"{\"status\":\"shipped\"}"}}}
{"ok":{"status":200,"headers":{},"body":{"type":"file","path":"/volume/tmp/out.bin","bytes":48211}}}
{"error":{"kind":"host_not_allowed","message":"api.example.com is not in this function's network allowlist"}}

インラインの本文は最大 256 KiB で、UTF-8 のテキストでなければなりません。そうでない場合、リクエストは too_large か not_text で失敗するので、本文はファイルに保存するようにしてください。エラーの種類は invalid_request、host_not_allowed、forbidden_destination、credential_header、credential_unavailable、too_many_redirects、timeout、too_large、not_text、write_budget、bad_path、connection、abi です。

ローカルでのテスト

WASI preview 1 の command を実行できるランタイムなら、どれでも手元のマシンで Module を試せます。stdin にリクエストを 1 つ渡し、stdout から応答を読みます。

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}},"name":"greet","arguments":{"name":"Ada"}}}'

Module を読み込むには、ランタイムが subako_http を提供する必要があります。Rust と Go のテンプレートには、Module を別の Module にリンクできるランタイム向けに、すべてのリクエストを失敗させるスタブ tests/subako_http_stub.wat が含まれています。

(module
  (func (export "request") (param i32 i32) (result i32) i32.const -1)
  (func (export "read_response") (param i32 i32) (result i32) i32.const -2))

チェックリスト

1. _start と memory を export する WASI preview 1 の command module を、threads と exceptions なしでビルドします。
2. stdin を 1 行ずつ読み、end of file に達したら終了コード 0 で終了します。
3. id のないメッセージは無視します。
4. server/discover には "supportedVersions": ["2026-07-28"] と tools capability で応答します。
5. tools/list には、Tool の一覧と、それぞれのオブジェクト型の入力 Schema で応答します。
6. tools/call には CallToolResult で応答し、失敗には isError を使います。
7. 応答ごとにコンパクトな JSON を 1 行 stdout に書き、flush します。ログは stderr に書きます。
8. ファイルは /volume/tmp、/volume/data、/package、/skills の下で読み書きします。
9. HTTP は subako_http を通して送ります。

あとは、abi を 1 にした subako-package.json と module.wasm をまとめれば完成です。