@originaiagent/feedback

origin ツール群の〔これじゃない〕フィードバックを 言語レベルの単一ソース(SoT) で提供する共通パッケージ。 「AI結果への これじゃない」送信の endpoint / payload / verdict / 入力検証を1箇所で定義し、コピペ横展開の ドリフト(=バグ源)を構造的に排除する。SoT = origin-ai。設計: docs/not-this-feedback-loop-design.md。

インストール（consumer = 各ツール）

各ツール repo に .npmrc（設定1回）:

@originaiagent:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NPM_TOKEN}

NPM_TOKEN は GitHub Packages read 権限の PAT を CI / Vercel / Cloud Run の build env に設定。

npm install @originaiagent/feedback

パッケージは compiled JS + .d.ts（dist/）を配布する。Turbopack / webpack / Vite / Node ESM いずれもそのまま解決でき、 consumer 側の transpilePackages 設定は不要。

使い方（import 1行）

3 サブパスに分離（server / client の混在を構造的に禁止）:

// 契約（純粋・依存ゼロ。server / client 両方から安全）
import { EMBED_FEEDBACK_PATH, isValidRunId, normalizeReason } from "@originaiagent/feedback";

// UI ボタン（"use client"。inline style で自己完結＝Tailwind 非依存）
import { NotThisButton } from "@originaiagent/feedback/button";

// 送信クライアント（server-only。鍵注入は呼出側）
import { createEmbedFeedbackSubmit } from "@originaiagent/feedback/server";

server（Server Action / BFF）

const submit = createEmbedFeedbackSubmit({
  baseUrl: process.env.ORIGIN_AI_BASE_URL!,      // https://origin-ai-five.vercel.app
  authHeaders: { "X-Embed-Key": process.env.EMBED_CLIENT_KEY! }, // ブラウザ非露出
});
const r = await submit({ run_id, verdict: "not_this", reason }); // → { ok, error? }

UI（1行）

<NotThisButton runId={result?.runId} submit={submitViaServerAction} />

• runId が null/undefined の時は 描画しない（AI結果が無い所に死にボタンを置かない）。
• submit は tool の Server Action（内部で上記 server helper を呼ぶ）を渡す。鍵は UI に出さない。

認可（BOLA）

• run_id = ai_embed_runs.id。origin-ai submit_embed_feedback RPC が source_tool 所有 を検証。
• source_tool は X-Embed-Key（sha256）から導出。body から自己申告できない。

export 面

| subpath | 中身 | 環境 | | --- | --- | --- | | . / ./contract | endpoint / verdict / validator / 型 | 純粋（server・client・非React 可） | | ./server | createEmbedFeedbackSubmit | server-only（runtime guard） | | ./button | NotThisButton | client（React peer, inline style） |

async 待機（polling）が要る画面は @originaiagent/async-wait を併用（consumer 側で合成。tool-template の 標準部品 EmbedAiResult 参照）。2 パッケージは独立（SoT 分裂を避ける）。