Addness

GoalのOWNERを別メンバーへ移譲する。既存OWNERがいるGoalでは assign_member(role=OWNER) ではなくこれを使う。同一オーナーの未完了子孫Goalにも移譲が連鎖する。旧オーナーはアサインから除去され、そのassignment_idは無効になる（例外は actor_as_editor 参照）。

change_owner

Goalを完了/未完了にする。完了時はstatusがNONEにリセットされる。子が未完了のうちは親を完了できない（葉から順に完了する）。エージェントだけで完了できない親Goalは完了せず、ハンドオフ分解（サーバー指示8）に従う。

complete_goal

create_send_shareが返したcurlをすべて実行した後、各ファイルのPUT完了を通知して便を公開する。再実行可能。

complete_send_share

語彙v2のwidgetをダッシュボードとしてまとめる。作成者がownerになり、section以外が参照する全recipeへ将来のmetric pointsも含む明示grantを作る。privateは認可enforcement有効化後に作成でき、OFF中は409になる。 語彙v2のwidgetsは1〜100件。number_cardは {"type":"number_card","recipe_id":"<UUID>","compare":"prev_week"}。 heroカード: {"type":"number_card","recipe_id":"<UUID>","compare":"none","size":"hero"}。sparkline: {"type":"number_card","recipe_id":"<UUID>","compare":"none","sparkline":{"window":30}}。 compactカード（数字を小さく密に並べる・1行に4枚、円は万円/億円表記）: {"type":"number_card","recipe_id":"<UUID>","compare":"prev_week","size":"compact","target":true} number_cardもmetric_seriesと同じwidth（full/half、既定full）を指定できる。half幅カード: {"type":"number_card","recipe_id":"<UUID>","compare":"prev_week","width":"half"}。 section: {"type":"section","title":"売上","note":"9月目標"}。metrics_table: {"type":"metrics_table","rows":[{"recipe_id":"<UUID>","compare":"prev_week"}],"show_target":true}。 placeholder: {"type":"placeholder","title":"商談化率","target_note":"月次20%","requested_from":"営業企画","requested_at":"2026-09-02"}。値は取得せず、widthはfull/halfを指定できる。 metric_seriesはrecipe_id 1件、またはseries 1〜4件のどちらか一方を使う。既定はchart=line、grain=day、compare_offset=none、width=full、window省略時last_30d。aggregate省略時はレシピのkindに従う（flow→sum、cumulative/stock→last、rate→avg）。月次目標を表示する場合はshow_target=true。 月次bar・half幅: {"type":"metric_series","recipe_id":"<UUID>","chart":"bar","grain":"month","aggregate":"sum","window":{"preset":"last_365d"},"width":"half"}。 7日移動平均: {"type":"metric_series","recipe_id":"<UUID>","moving_average":{"window":7},"window":{"preset":"last_90d"}}。 前週ゴースト: {"type":"metric_series","recipe_id":"<UUID>","compare_offset":"prev_week","window":{"preset":"last_30d"}}。ghost_pointsは過去値を現在窓の日付へ写像して返す。 旧形式 {"type":"metric_series","recipe_id":"<UUID>","config":{"range_days":30}} もそのまま有効。config.range_daysとwindow、recipe_idとseriesは併用しない。moving_averageはgrain=dayだけ。custom windowはfrom<=toかつ両端を含め366日以内。sectionとplaceholderはrecipeを参照せず、metrics_tableはrowsの全recipeについてeditor以上が必要。

create_analytics_dashboard

公開可能なデータ源、日次の取得方法、更新契約をversion 1のレシピとして登録する。作成者がowner、初期visibilityはorgになる。資格情報は渡さず手元の環境に置く。作成後はget_analytics_recipeでowner・access・対象期間を確認する。

create_analytics_recipe

指定メンバーとのDMルームを作成する。既存DMがある場合はそのルームを返し、メッセージは送信しない。非表示になった既存DMは、メッセージを送信するまで一覧に戻らない。

create_chat_dm

Addnessチャットのグループを作成する。作成者はownerになり、member_idsのメンバーが初期参加者になる。

create_chat_group

Goalまたは型ノードにリソース(document/link/folder/file)を追加する。file はテキスト内容なら content に本文を渡すだけでアップロードまで完結する。バイナリは content なしで呼ぶと、curl 手順とアプリで手動アップロードする URL が結果に返る(上限50MB)。調査メモ等の資料はゴール本文(write_goal_detail)へ、ファイル・リンクの保管はこちら。

create_deliverable

Driveのdirect scopeにフォルダまたはファイルを作成する。テキストファイルはcontentを渡すとアップロードまで完結し、バイナリはcontentを省略するとactive化まで行うcurl手順を返す（上限50MiB）。

create_drive_resource

新しいGoalを作成する。parent_idは実質必須（指定した親の子Goalとして作成）。省略はルートGoalの新規作成で、ルートGoalは組織にひとつのため、既にルートがある組織では失敗する。parent_idの親が呼び出し者の今日のToDoに入っている時は、作成した子も今日のToDoへ追加する（実行タブの作成と同じ挙動）。追加できなかった時は作成成功のまま応答に理由を添える。

create_goal

組織の招待リンクを発行する。重複発行を避けるため先に list_invite_links を確認する。招待コードは自動生成し、isExternal=falseで固定する。expires_at省略時はAPI既定の7日後、max_uses省略時は無制限。goal_id指定時のassignment_role省略はMEMBERで、OWNERはmax_uses=1が必須。

create_invite_link

ユーザーが新規プロジェクト用組織の作成を明示した場合に使う。同じユーザー・同じ正規化名では冪等に既存組織を返し、workspace情報があれば組織対応も同時保存する。

create_organization

手元のファイルをaddness-sendへ直接PUTする便を作成し、ファイルごとのcurl手順を返す。complete_send_shareを呼ぶまで公開されない。

create_send_share

型（テンプレート）を作る。作り方は2モードあり、どちらか一方だけを指定する。（1）ゼロから作る: titleがルートノードの名前になり、説明・完了基準・本文も同時に設定できる。子ノードの追加はcreate_template_node。（2）実績ゴールから型化する: from_goal_idを指定すると、そのゴールのサブツリーを丸ごと型として保存する（説明・完了基準・本文・コメント・リソース込み。期日・担当・ステータスは型に持たず、元のゴールは変更されない）。from_goal_idとtitle等は同時に指定できない。型化後の名前や内容の調整はupdate_template_nodeで行う。

create_template

型に子ノードを追加する。親ノードの子の末尾に追加され、説明・完了基準・本文も同時に設定できる。ツリー構造はget_templateで確認する。

create_template_node

今日のToDoに既存のゴールを追加する（べき等）。objective_idは必須で、ゴールに紐づかない行はこのツールでは作れない。新しい仕事は先にcreate_goalで親ゴールの下にゴールを作り、そのIDを渡す。objective_idで追加できるのは実行タブ下段「すべてのゴール」に出るゴール（自分が担当または所有しているゴールと、その上位のゴール）だけ。DFO行の欠損はbackendが自己修復し、範囲外のゴールは400になる。

create_today_todo

owner/adminがレシピまたはダッシュボードを復元できないソフト削除にする。以後の取得は404。レシピを削除すると、そのレシピを使うダッシュボードのwidgetはrecipe_deletedになり、ゴールとの結びつきとwidget共有は解除される。迷う場合は先にarchive_analytics_resourceで様子を見る。

delete_analytics_resource

顧客と生存所属を論理削除する。人と会社の所属も終了し、その相手顧客すべてに書き込み権限が要る。30日以内はrestore_crm_customerで戻せる。関連データへ広く影響するため、必ずユーザー承認後に実行する。

delete_crm_customer

顧客リストを削除する。所属・現在地・履歴は消えず、30日以内はrestore_crm_listで戻せる。実行中の更新（run）があると削除できない。必ずユーザー承認後に実行する。

delete_crm_list

Addnessチャットで自分が投稿したメッセージ（root・返信）を削除する。権限判定はAddnessチャットの既存ルールに従う。

delete_chat_message

コメントを削除する。投稿者本人のみ削除可。返信も一緒に削除される。

delete_comment

リソースを削除する(folderは配下も再帰削除)。取り消せない。

delete_deliverable

Goalをゴミ箱に入れる（ソフトデリート、restore_goalで復元可）。子Goalがあると拒否される（先に子を整理）。表示順を破棄する点で、保ったまま片付けるarchive_goalとは別物。

delete_goal

型（テンプレート）を削除する（論理削除）。この型の繰り返し設定（template schedule）は停止し、共有公開中なら自動で公開停止される。stamp済みのゴールは影響を受けない。一時的な退避はarchive_templateを使う。

delete_template

型ノードを配下のサブツリーごと削除する。元に戻せない。ルートノードは削除できない。

delete_template_node

chat由来の今日のTODO（自由記述行）を削除する。

delete_today_todo

重複候補（get_crm_customer の duplicate_candidates）を『別の相手』として閉じる。両方の顧客を編集できる人だけ実行でき、open の候補だけ閉じられる（dismissed／merged は409）。同じ相手なら閉じずに merge_crm_customers を使う。

dismiss_crm_duplicate_candidate

Addnessチャットで自分が投稿したテキストメッセージ（root・返信）を編集する。権限判定はAddnessチャットの既存ルールに従う。

edit_chat_message

ゴール詳細ページ本文（body）内の既存テキストをold_textからnew_textへ1箇所だけ置換する。他のブロック・ウィジェット・画像は変更しない。新しいブロックの追加・全置換はwrite_goal_detail、DoDの修正はupdate_goalまたはpatch_objective_textを使う。

edit_goal_detail

標準MCPの既存Addnessツールを、隔離JavaScriptまたは最大16ステップのワークフローとして実行する。中間結果を会話へ返さず、必要な最終値だけを返したい定型処理に使う。途中でモデルの判断が必要な処理は個別ツールを直接使う。execute内の書き込みは途中失敗時もロールバックされないため、対象と内容を確定してから実行する。

execute

run開始者本人かつ現在のrecipe editor以上がrunをsuccess/partial/failedで終端する。success/partialはpending値と証憑を一括有効化する。owner/adminによる強制中断はabort_analytics_runを使う。

finish_analytics_run

開始者本人がCRM runを終了し、pending更新を確定または破棄する。異なるstatusでの再送は競合する。

finish_crm_run

誰がいつ何をしたかの活動を取得する。scopeで対象を選ぶ（member=メンバーの操作履歴、goal=Goalの変更履歴、org=組織全体）。mode=eventsは1件ずつの履歴を新しい順で返し、mode=summaryは集計を返す。summaryはorgでカテゴリ別件数・アクティブメンバー・直近ログ、goalでメンバー別の作成数と完了数。scope=member × mode=summaryは非対応で、メンバーの集計値はget_member_stats。

get_activity

viewer以上がdashboardのowner・access・語彙v2の正規化widgetsと現在値を読む。返るwidgets JSONはupdate_analytics_dashboardへそのまま渡せるため、全置換更新前の退避に使う。削除済みデータ定義を参照するwidgetはdeleted_recipesで示し、widgets JSONからはその参照を外す（保存内容と異なる）。sectionは見出し、metrics_tableはrow単位の値を返す。include_points=falseで構造だけ、widget_indexで1枚だけ値を深掘りできる。window_presetまたはfrom/toはmetric_seriesの表示窓だけを一時上書きし保存しない。from/toは両方を指定し、window_presetとは併用しない。

get_analytics_dashboard

専属recipeのviewer以上がdatasetのactiveなParquet証憑と600秒有効の署名GET URLを取得する。レイクを直接globせず、返ったURL列をDuckDBのread_parquetへ渡す。

get_analytics_dataset_manifest

viewer以上がレシピの現行定義、visibility、owner、呼び出し者access、最新完了runと次の取得期間を読む。run開始にはeditor以上が必要。長いバックフィルは期間を割って複数runにする。

get_analytics_recipe

CRM顧客（会社か人）の共有項目と、閲覧できるリスト内の現在地・関連ゴール・数値・履歴を読む。関連ゴール本文はread_goal_detail、LINE履歴はread_line_messagesを使う。削除済みの顧客もdeleted_at／restore_until付きで読める。統合で閉じた側のcustomer_idを指定して取得すると、残す側に解決され（resolved_from）、両方が入っていたリストの閉じた側の履歴が lists[].merged_history に入る（残す側のIDで取得した時は空）。

get_crm_customer

顧客リストの設定と顧客表を読む。段階の『やること』本文は返らないためtemplate_idをget_templateへ渡す。include_rows=falseで設定だけ確認できる。

get_crm_list

リソースの詳細を取得する。document の本文・file の Download URL などを含み、テキスト系ファイル(.txt/.md/.csv 等)は本文もインライン返却する。

get_deliverable

閲覧可能なDriveリソース1件の詳細と本文、リンク、または短命Download URLを取得する。direct scopeでは取得できた場合に共有状態も返す。

get_drive_resource