案件
MCP で必要な共有状態だけを materialize します。
仕事の共同作業者に対する epismo_case_get は、案件本体、現在のタスク、その案件の最新 5 件の記録(新しい順)、直接の引き継ぎ関係、読み取り可能な開始元プレイブックと固定した Version を返します。公開アクセスだけを持つ閲覧者には、現在のタイトル、入力、その案件の最新 5 件の記録、読み取り可能な引き継ぎ関係を返し、タスク・担当・共同作業者の識別情報は返しません。Public にすると、後から追加する記録も含めて現在の内容が即座に公開されます。古い記録は epismo_case_record_list (cursor: recordsNextCursor, scope: recordsScope) と返された records_scope(self)で続けて取得します。CLI 出力は snake_case、API/MCP は recordsNextCursor と recordsScope を使います。
公開案件の読み取りは Web・CLI・API・MCP でログインなしでも 0 credits です。API / CLI / MCP の仕事の詳細取得は補助取得を 案件 get 1 回分の 1 credit にまとめ、通常の Web 閲覧は無料です。
結果を共有または再開する必要があるときにepismo_case_startを使います。プレイブック Version を指定する方法と、title だけの都度作成の案件があります。
- ローカルな途中作業は agent runtime に保つ。
- 結果、判断、判定(
kind=reviewとdata.verdict)、引き継ぎの要約はepismo_case_record_appendで append する。 - 自分が作った記録の訂正・削除はepismo_case_record_updateまたはepismo_case_record_deleteで行う。
- 明示的な担当や承認が必要なときだけepismo_case_task_createでタスクを作る。
- 案件の編集者はepismo_case_reviewで共有証拠の Epismo AI review を依頼できます。呼び出しはキューして即座に返り、記録は
kinds=reviewとorigins=systemの一覧で確認します。任意のpromptで固定のレビュー規則のあとに呼び出し側の指示を追加できます。手動レビューとautoReviewによる自動レビューは、開始時に固定した案件の billing account から課金されます。 - 案件の編集者はepismo_case_overviewで一発の状況ブリーフも取れます。同期で応答に本文が返ります。同じ idempotency key を再送すると再生成せず前回のブリーフを受け取ります。クレジットは開始時に固定した案件の billing account から課金されます。
- 関連する案件はepismo_case_handoff_createで接続し、epismo_case_handoff_graph_getで DAG を確認する。
- epismo_case_handoff_candidates_list(
direction=outgoingまたはdirection=incoming)でループや重複のない有効な接続候補を取得する。 - mutation ごとに新しい idempotency key を生成する。
- 案件/タスクの変更前に最新 lock version を取得する。
conflict 時は案件またはタスクを再取得し、新しい state で意図がまだ正しいか判断します。古い request を lock version だけ差し替えて再送しません。
agent 自身を暗黙の担当者にせず、User の割り当てが必要な場合だけ users resource から ID を選びます。割り当て前に案件 ACL へその User が含まれていることを確認します。
案件 ID を指定してepismo_case_record_listを使い、その案件の時系列から作業を再開します。scope(self、ancestors、descendants、neighbors、connected)を指定することで、各案件の ACL を維持したまま接続された案件の記録も含めて取得できます。絞り込みは時系列を絞るだけで、ACL の絞り込み自体が認可になることはありません。