@unson/brainbase-mcp 0.1.0 → 0.2.2

package/dist/guided-onboarding.d.ts

@@ -94,4 +94,4 @@ export interface GuidedFirstRun {
     completionCheck: string[];
 }
 export declare function buildGuidedFirstRun(input: GuidedFirstRunInput): GuidedFirstRun;
-export declare function renderGuidedFirstRun(input: GuidedFirstRunInput, format: GuidedFormat): string;
+export declare function renderGuidedFirstRun(input: GuidedFirstRunInput, format: GuidedFormat, details?: boolean): string;

package/dist/guided-onboarding.js

@@ -61,6 +61,7 @@ export function buildGuidedFirstRun(input) {
         '--name', input.name || '<あなたの名前>',
         ...values.flatMap((value) => ['--value', value]),
         '--project', input.project?.name || '<最初に登録するプロジェクト>',
+        ...(input.project?.decisionPrinciples ?? []).flatMap((value) => ['--decision-principle', value]),
         '--relationship', firstRelationshipArg
     ]);
     const demoCommand = command([
@@ -69,6 +70,7 @@ export function buildGuidedFirstRun(input) {
         '--dir', input.dataDir,
         '--scenario', firstValueScenario
     ]);
+    const actualAgentPrompt = `Brainbaseのget_contextとsearchを使い、保存済み文脈を根拠に「${firstValueScenario}」へ回答してください。使った前提と未確認事項を分けてください。`;
     const projectDryRunCommand = project
         ? projectCommand(input.dataDir, project.project.name, input.project, project.project.sources, false)
         : undefined;
@@ -118,44 +120,50 @@ export function buildGuidedFirstRun(input) {
         nextCommands: [
             {
                 id: 'self-seed',
-                title: '最初のデモに必要な最小文脈を正本化する',
+                title: '最初の実利用に必要な最小文脈を正本化する',
                 when: '名前、価値観、最初のプロジェクト、関係者文脈を本人が確認した後',
                 command: selfSeedCommand
             },
+            {
+                id: 'install',
+                title: `${targetLabel(input.target)} 用のMCP設定を実configへmergeする`,
+                when: '最小文脈のseed直後。dry-runを確認し、承認後に実configへ反映する',
+                command: operationalization.pending.find((item) => item.id === 'mcp-config')?.command ?? command(['brainbase', 'onboard:install', '--target', input.target, '--dir', input.dataDir, '--dry-run'])
+            },
+            {
+                id: 'doctor',
+                title: 'doctor と MCP get_context/search で確認する',
+                when: 'MCP設定を実configへmergeし、対象エージェントを再起動した後',
+                command: operationalization.pending.find((item) => item.id === 'verification')?.command ?? command(['brainbase', 'doctor', '--dir', input.dataDir])
+            },
+            {
+                id: 'actual-agent-value',
+                title: '実エージェントで現実の依頼を試し、本人が価値を判断する',
+                when: 'MCP設定反映後の新しいエージェントセッション',
+                command: actualAgentPrompt
+            },
             {
                 id: 'first-value-demo',
-                title: '最初の価値体験を実行する',
-                when: '最小文脈のseed直後。接続診断より先に実行する',
+                title: '必要ならCLI文脈プレビューを見る',
+                when: '実接続前に保存文脈から作れるサンプルだけ確認したい時。完了証拠にはしない',
                 command: demoCommand
             },
             {
                 id: 'skills',
                 title: '公開オンボーディングskillsを配置する',
-                when: 'first value demoを見せた後。agentが次回も同じ運用を辿れるようにする',
+                when: '実エージェントの回答を本人が役立つと確認した後',
                 command: operationalization.pending.find((item) => item.id === 'public-skills')?.command ?? 'brainbase onboard:skills --target codex'
             },
             {
                 id: 'routines',
                 title: 'ohayo / oyasumi / retroを確認付きで登録する',
-                when: 'first value demoを見せた後。最初はPAUSEDまたは確認付きで登録する',
+                when: '初回価値確認後、継続運用が必要になった時',
                 command: operationalization.pending.find((item) => item.id === 'routines')?.command ?? 'brainbase onboard:routines --target codex --cwd <brainbase-checkout>'
             },
-            {
-                id: 'install',
-                title: `${targetLabel(input.target)} 用のMCP設定を実configへmergeする`,
-                when: 'first value demoとskills/routines確認後。dry-runをプレビューにして承認後に実configへ反映する',
-                command: operationalization.pending.find((item) => item.id === 'mcp-config')?.command ?? command(['brainbase', 'onboard:install', '--target', input.target, '--dir', input.dataDir, '--dry-run'])
-            },
-            {
-                id: 'doctor',
-                title: 'doctor と MCP get_context/search で確認する',
-                when: 'MCP設定を実configへmergeし、対象エージェントを再起動した後',
-                command: operationalization.pending.find((item) => item.id === 'verification')?.command ?? command(['brainbase', 'doctor', '--dir', input.dataDir])
-            },
             ...(projectDryRunCommand ? [{
                     id: 'project-dry-run',
                     title: 'プロジェクト登録内容を確認する',
-                    when: '最初のデモ後、プロジェクト詳細を追加したい時',
+                    when: '実エージェントの回答確認後、プロジェクト詳細を追加したい時',
                     command: projectDryRunCommand
                 }] : []),
             ...(projectWriteCommand ? [{
@@ -167,13 +175,13 @@ export function buildGuidedFirstRun(input) {
             {
                 id: 'source-diagnosis',
                 title: 'メール・カレンダー・ドライブ・タスクの接続準備を診断する',
-                when: '最初の価値体験の後、追加文脈が必要だと分かった時',
+                when: '実エージェントの回答を確認した後、追加文脈が必要だと分かった時',
                 command: diagnoseCommand
             },
             {
                 id: 'candidates',
                 title: '候補ファクトをレビュー用に作る',
-                when: '最初のデモ後、聞き取り内容をまだ正本化せずレビュー材料にしたい時',
+                when: '実エージェントの回答を確認した後、聞き取り内容をまだ正本化せずレビュー材料にしたい時',
                 command: command([
                     'brainbase',
                     'onboard:candidates',
@@ -186,16 +194,16 @@ export function buildGuidedFirstRun(input) {
         ],
         approvalGates: [
             'OAuth token、password、API key、refresh tokenはチャットへ貼らない。',
-            '接続診断や候補JSONを初回オンボーディングの完了扱いにしない。最初の価値体験を先に見る。',
+            '接続診断や候補JSONを初回オンボーディングの完了扱いにしない。実エージェントの回答と本人の価値判断を先に確認する。',
             'メール、カレンダー、ドライブ、タスクは最初はmetadata-firstで扱う。',
             'Google Driveとローカルファイルは明示されたfolder allowlistだけを見る。',
             'sources/ と candidates/ は二次材料であり、本人承認前にMCPの正本文脈へ入れない。',
             'プロジェクト、関係者、判断基準はdry-run確認後だけ --write または onboard:seed で正本化する。'
         ],
         completionCheck: [
-            'brainbase onboard:demo が、保存済み文脈を使った自然なプロンプトとサンプル回答を返す。',
-            'ready=true / first_value_demo_ready だけで完了扱いにせず、ユーザーが「説明し直さなくてよい」と分かる回答を見る。',
-            'doctor の valueDemo.ready が true になる。',
+            'CLIサンプルは接続前プレビューであり、初回価値の達成証拠にしない。',
+            '新しい実エージェントがBrainbase MCPのget_context/searchを使って現実の依頼へ回答する。',
+            '実回答を見た本人が役立ったかを判断する。',
             '完了報告には、公開skills、ohayo/oyasumi/retro、MCP実config merge、source allowlist/import/candidate review、MCP get_context/search確認の未完了タスクを必ず出す。',
             `${targetLabel(input.target)} のMCP設定に Brainbase が実登録されている。`,
             '最初のプロジェクトが get_context/search で見える。',
@@ -203,11 +211,33 @@ export function buildGuidedFirstRun(input) {
         ]
     };
 }
-export function renderGuidedFirstRun(input, format) {
+export function renderGuidedFirstRun(input, format, details = false) {
     const guide = buildGuidedFirstRun(input);
     if (format === 'json') {
         return `${JSON.stringify(guide, null, 2)}\n`;
     }
+    if (!details) {
+        const next = guide.currentStatus.missing.length > 0
+            ? guide.nextCommands.find((item) => item.id === 'self-seed')
+            : guide.nextCommands.find((item) => item.id === 'install');
+        return [
+            '# Brainbase 初回オンボーディング',
+            '',
+            `- 状態: ${guide.currentStatus.missing.length > 0 ? '最小文脈の保存待ち' : '実エージェント接続待ち'}`,
+            `- データ: \`${guide.dataDir}\``,
+            `- 不足: ${guide.currentStatus.missing.length > 0 ? guide.currentStatus.missing.map(canonicalAreaLabel).join('、') : 'なし'}`,
+            '',
+            '## 次に実行',
+            next ? `\`${next.command}\`` : '次の操作はありません。',
+            '',
+            '## 確認できる価値',
+            guide.firstValueExperience.expectedValue,
+            '',
+            '- この案内だけではデータを書き込みません。seed実行時も既存データは削除しません。',
+            `- 詳細を見る: \`${command(['brainbase', 'onboard:start', '--target', guide.target, '--dir', guide.dataDir, '--details'])}\``,
+            ''
+        ].join('\n');
+    }
     const lines = [
         '# Brainbase 初回オンボーディング開始',
         '',
@@ -216,15 +246,15 @@ export function renderGuidedFirstRun(input, format) {
         `- 対象エージェント: ${targetLabel(guide.target)}`,
         `- データディレクトリ: \`${guide.dataDir}\``,
         `- 正本ファクト書き込み: ${guide.initialized.canonicalFactWrites ? 'あり' : 'なし'}`,
-        `- 現在の不足: ${guide.currentStatus.missing.length > 0 ? guide.currentStatus.missing.join(', ') : 'なし'}`,
+        `- 現在の不足: ${guide.currentStatus.missing.length > 0 ? guide.currentStatus.missing.map(canonicalAreaLabel).join('、') : 'なし'}`,
         '',
-        '## まず試すこと',
+        '## 接続後に実エージェントで試すこと',
         guide.firstValueExperience.title,
         '',
         `- 試すプロンプト: 「${guide.firstValueExperience.tryPrompt}」`,
         `- 期待する価値: ${guide.firstValueExperience.expectedValue}`,
         '',
-        '### サンプル回答',
+        '### 回答イメージ（接続前プレビュー）',
         guide.firstValueExperience.sampleResult,
         '',
         '## まだ残っている運用化',
@@ -243,7 +273,7 @@ export function renderGuidedFirstRun(input, format) {
             ...section.questions.map((question) => `- ${question}`)
         ]),
         '',
-        '## 接続準備（デモ後の任意ステップ）',
+        '## 追加接続（初回価値確認後の任意ステップ）',
         ...guide.sourceReadiness.flatMap((source) => [
             '',
             `### ${source.title}`,
@@ -277,11 +307,11 @@ function buildJapaneseInterview() {
     return [
         {
             id: 'value_target',
-            title: '最初の価値体験',
+            title: '本人が価値を判断できる最初の実利用',
             questions: [
                 'Codex / Claude Code に毎回説明し直したくない仕事文脈は何ですか？',
                 '今日のオンボーディングで「これは便利」と判断できる実リクエストは何ですか？',
-                '最初のデモは仕事前提、関係者、判断基準、プロジェクトのどれを使えれば成功ですか？'
+                '最初の実回答は仕事前提、関係者、判断基準、プロジェクトのどれを使えれば役立ったと判断できますか？'
             ]
         },
         {
@@ -290,7 +320,7 @@ function buildJapaneseInterview() {
             questions: [
                 'あなたの名前、呼ばれ方、Codex / Claude Code に覚えてほしい仕事上の前提は何ですか？',
                 '判断基準、重視する価値観、避けたい進め方は何ですか？',
-                '最初のデモに必要な関係者は誰で、どういう文脈を覚えておくべきですか？'
+                '最初の実利用に必要な関係者は誰で、どういう文脈を覚えておくべきですか？'
             ]
         },
         {
@@ -306,24 +336,24 @@ function buildJapaneseInterview() {
             id: 'approval',
             title: '正本化の承認',
             questions: [
-                '最初のデモに必要な本人、仕事、関係性の事実をこのままローカル正本に入れてよいですか？',
+                '最初の実利用に必要な本人、仕事、関係性の事実をこのままローカル正本に入れてよいですか？',
                 '候補JSONではなく、会話上の要約として承認できますか？',
                 'まだ正本化しない事実や除外したい文脈はありますか？'
             ]
         },
         {
             id: 'first_value_demo',
-            title: 'デモ確認',
+            title: '実エージェント回答の確認',
             questions: [
-                'seed直後に brainbase onboard:demo を実行し、説明し直しが減ったか確認してください。',
-                'デモが足りない場合、どの文脈が不足していましたか？'
+                'MCP設定反映と再起動後、実エージェントへ現実の依頼を送り、説明し直しが減ったか確認してください。',
+                '実回答が役立たない場合、どの文脈が不足していましたか？'
             ]
         },
         {
             id: 'sources',
-            title: 'デモ後のメール・カレンダー・ドライブ・タスク',
+            title: '初回価値確認後のメール・カレンダー・ドライブ・タスク',
             questions: [
-                '最初のデモ後に追加文脈が必要なら、メールは Gmail / Google Workspace / Outlook / Apple Mail / その他のどれですか？',
+                '初回価値確認後に追加文脈が必要なら、メールは Gmail / Google Workspace / Outlook / Apple Mail / その他のどれですか？',
                 'カレンダーは Google Calendar / Outlook Calendar / Apple Calendar / その他のどれですか？',
                 'ドキュメントは Google Drive / OneDrive / Dropbox / Notion / ローカルフォルダのどこにありますか？',
                 'タスク管理は Notion / Todoist / Linear / GitHub Issues / NocoDB / CSV / カレンダーやメモ散在 / なし のどれですか？',
@@ -358,7 +388,7 @@ function buildFirstValueExperience(projectName, person) {
             '背景説明をもう一度求めず、保存した仕事メモを前提に最初の作業メモを出します。'
         ].join('\n');
     return {
-        title: '最小メモを保存したら、まずこの一問で価値を確認します。',
+        title: '最小メモを保存して接続したら、実エージェントへこの一問を依頼します。',
         tryPrompt,
         expectedValue,
         sampleResult
@@ -449,6 +479,15 @@ function statusLabel(status) {
         return '追加の許可範囲が必要';
     return '未設定';
 }
+function canonicalAreaLabel(area) {
+    if (area === 'self')
+        return '本人の前提';
+    if (area === 'work')
+        return '今の仕事';
+    if (area === 'relationships')
+        return '関係者';
+    return area;
+}
 function translateRequiredInput(value) {
     if (value.includes('GoG'))
         return value.replace('Install or configure local GoG command', 'ローカルGoGコマンドをインストールまたは設定する');

package/dist/import-extract.d.ts

@@ -102,6 +102,7 @@ export interface ApplyResult {
         id: string;
         kind: string;
         summary: string;
+        canonicalIds: string[];
     }[];
     skipped: {
         id: string;

package/dist/import-extract.js

@@ -328,7 +328,7 @@ export function planApply(candidates, selection, base, now) {
                 ownerName = name;
                 upsertEntity(graphEntities, { id: 'self', type: 'person', name, summary: 'Owner of this local Brainbase Personal OS.', tags: ['self'] });
                 personalKgAdditions.push({ id: `self-${stableHash(name)}`, type: 'self', text: `I am ${name}.`, tags: ['self'], source: candidate.id, updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: name });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: name, canonicalIds: ['self', `self-${stableHash(name)}`] });
                 break;
             }
             case 'person':
@@ -344,7 +344,14 @@ export function planApply(candidates, selection, base, now) {
                 if (candidate.kind === 'relationship' && !relationships.some((relationship) => relationship.person === person && relationship.context === context)) {
                     relationships.push({ id: `relationship-${stableHash(`${person}|${context}`)}`, person, role: role || undefined, context, tags: ['relationship'], updatedAt: now });
                 }
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: person });
+                applied.push({
+                    id: candidate.id,
+                    kind: candidate.kind,
+                    summary: person,
+                    canonicalIds: candidate.kind === 'relationship'
+                        ? [`person-${stableHash(person)}`, `relationship-${stableHash(`${person}|${context}`)}`]
+                        : [`person-${stableHash(person)}`]
+                });
                 break;
             }
             case 'org': {
@@ -354,7 +361,7 @@ export function planApply(candidates, selection, base, now) {
                     break;
                 }
                 upsertEntity(graphEntities, { id: `org-${stableHash(name)}`, type: 'org', name, summary: 'Imported from onboarding sources.', tags: ['org'] });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: name });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: name, canonicalIds: [`org-${stableHash(name)}`] });
                 break;
             }
             case 'project': {
@@ -365,7 +372,7 @@ export function planApply(candidates, selection, base, now) {
                 }
                 upsertEntity(graphEntities, { id: `project-${stableHash(name)}`, type: 'project', name, summary: 'Imported from onboarding sources.', tags: ['work'] });
                 personalKgAdditions.push({ id: `work-${stableHash(name)}`, type: 'work', text: name, tags: ['work'], source: candidate.id, updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: name });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: name, canonicalIds: [`project-${stableHash(name)}`, `work-${stableHash(name)}`] });
                 break;
             }
             case 'value': {
@@ -375,7 +382,7 @@ export function planApply(candidates, selection, base, now) {
                     break;
                 }
                 personalKgAdditions.push({ id: `value-${stableHash(text)}`, type: 'value', text, tags: ['onboarding'], source: candidate.id, updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: text });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: text, canonicalIds: [`value-${stableHash(text)}`] });
                 break;
             }
             case 'next_action': {
@@ -385,7 +392,7 @@ export function planApply(candidates, selection, base, now) {
                     break;
                 }
                 personalKgAdditions.push({ id: `next-action-${stableHash(text)}`, type: 'work', text, tags: ['next-action'], source: candidate.id, updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: text });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: text, canonicalIds: [`next-action-${stableHash(text)}`] });
                 break;
             }
             case 'decision': {
@@ -394,8 +401,23 @@ export function planApply(candidates, selection, base, now) {
                     skipped.push({ id: candidate.id, reason: 'decision candidate missing decision text' });
                     break;
                 }
-                decisionAdditions.push({ id: `decision-${stableHash(text)}`, title: 'Promoted decision principle', decision: text, tags: ['principle'], updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: text });
+                const topic = payloadString(payload, 'topic');
+                const effectiveAt = payloadString(payload, 'effectiveAt');
+                const rationale = payloadString(payload, 'rationale');
+                const supersedes = readStringArray(payload, ['supersedes']);
+                const tags = readStringArray(payload, ['tags']);
+                decisionAdditions.push({
+                    id: `decision-${stableHash(text)}`,
+                    title: payloadString(payload, 'title') || 'Promoted decision principle',
+                    decision: text,
+                    topic: topic || undefined,
+                    supersedes: supersedes.length > 0 ? supersedes : undefined,
+                    effectiveAt: effectiveAt || undefined,
+                    rationale: rationale || undefined,
+                    tags: tags.length > 0 ? tags : ['principle'],
+                    updatedAt: now
+                });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: text, canonicalIds: [`decision-${stableHash(text)}`] });
                 break;
             }
             default:

package/dist/judgment-host.d.ts

@@ -0,0 +1,205 @@
+type Environment = Record<string, string | undefined>;
+export interface ConversationMessage {
+    sequence?: number;
+    turn_id?: string | null;
+    role: 'user' | 'assistant';
+    phase?: string | null;
+    text: string;
+}
+export interface JudgmentHookPayload {
+    hook_event_name?: string;
+    hookEventName?: string;
+    prompt?: string;
+    session_id?: string;
+    turn_id?: string;
+    transcript_path?: string;
+    cwd?: string;
+    model?: string;
+    permission_mode?: string;
+    tool_use_id?: string;
+    tool_name?: string;
+    tool_input?: unknown;
+    tool_response?: unknown;
+    last_assistant_message?: string;
+    stop_hook_active?: boolean;
+}
+export interface JudgmentRequest {
+    request: string;
+    turn_id: string;
+    project_code?: string;
+    conversation_context: {
+        schema_version: 'brainbase-conversation-context-v1';
+        session_ref: string;
+        messages: Required<ConversationMessage>[];
+        prior_receipts: Array<Record<string, unknown>>;
+        runtime: {
+            host: string;
+            model: string | null;
+            permission_mode: string | null;
+            project_binding: string | null;
+        };
+        instruction_bindings: Array<{
+            scope: string;
+            source_ref: string;
+            digest: string;
+        }>;
+        completeness: 'complete' | 'partial';
+        source_digest: string;
+    };
+}
+export interface JudgmentClassification {
+    intent: 'answer' | 'investigate' | 'diagnose' | 'design' | 'implement' | 'review' | 'operate';
+    domains: Array<'general' | 'knowledge' | 'engineering' | 'organization' | 'operations' | 'personal_judgment'>;
+    confidence: 'confirmed' | 'inferred';
+}
+export interface JudgmentNodeDefinition {
+    id: string;
+    kind: 'common' | 'judgment' | 'constraint' | 'clarification';
+    instruction: string;
+}
+export interface JudgmentReceipt {
+    resolution_id: string;
+    resolved_at: string;
+    turn_id: string;
+    request_digest: string;
+    context_digest: string;
+    plan_digest: string;
+    status: 'resolved' | 'needs_clarification';
+    runtime_version: string;
+    manifest_digest: string;
+    host_binding: {
+        adapter_id: 'brainbase-local';
+        adapter_version: '1';
+        status: 'managed';
+        enforcement_level: 'host_contract';
+    };
+    project_code?: string;
+    classification: JudgmentClassification | null;
+    classification_evidence: {
+        source: 'current_request' | 'prior_message' | 'prior_receipt' | 'resolver';
+        source_turn_ids: string[];
+        matcher_ids: string[];
+    };
+    reconciliation_reasons: string[];
+    selected_dag_ids: string[];
+    applicable_policies: Array<{
+        id: string;
+        instruction: string;
+    }>;
+    active_nodes: string[];
+    active_edges: Array<[string, string]>;
+    active_node_definitions: JudgmentNodeDefinition[];
+    unresolved: string[];
+    rationale: string[];
+}
+export interface JudgmentHookOutput {
+    continue: true;
+    suppressOutput: true;
+    receipt: JudgmentReceipt;
+    hookSpecificOutput: {
+        hookEventName: 'UserPromptSubmit';
+        additionalContext: string;
+    };
+}
+export interface JudgmentHostOptions {
+    env?: Environment;
+    resolver?: (request: JudgmentRequest) => Promise<JudgmentReceipt>;
+    trustedConversationMessages?: ConversationMessage[];
+}
+interface LocalResolverOptions {
+    now?: () => Date;
+    id?: () => string;
+}
+export interface JudgmentOwnerAudit {
+    schema_version: 'brainbase-owner-audit-v1';
+    renderer_version: '1';
+    locale: 'ja-JP';
+    historical_exact: boolean;
+    source_receipt_digest: string;
+    source_kind: 'current_request' | 'prior_turn' | 'prior_turn_fallback' | 'prior_turn_unavailable';
+    source_turn_ids: string[];
+    source_excerpt: string;
+    decision: string;
+    display_line: string;
+    text_digest: string;
+}
+interface JudgmentAdoptionEntry {
+    schema_version: 'brainbase-judgment-adoption-v1' | 'brainbase-judgment-adoption-v2';
+    accepted_at: string;
+    request_text_digest: string;
+    request: JudgmentRequest;
+    receipt: JudgmentReceipt;
+    receipt_digest?: string;
+    owner_audit: JudgmentOwnerAudit;
+}
+export interface JudgmentEpisode {
+    schema_version: 'brainbase-judgment-episode-v1';
+    session_ref: string;
+    turn_id: string;
+    started_at: string;
+    request_text_digest: string;
+    initial_receipt_digest: string;
+    adoption: JudgmentAdoptionEntry;
+    audit_contract: {
+        schema_version: 'brainbase-owner-audit-contract-v1';
+        repair_body_policy: 'preserve';
+        zero_call_display_line: string | null;
+        zero_call_display_line_digest: string | null;
+    };
+    episode_digest: string;
+}
+export interface JudgmentToolEvent {
+    schema_version: 'brainbase-judgment-tool-event-v1';
+    session_ref: string;
+    turn_id: string;
+    sequence: number;
+    recorded_at: string;
+    tool_use_id: string;
+    tool_name: string;
+    tool_input: unknown;
+    tool_response: unknown;
+    audit_kind: 'routing' | 'search' | 'retrieval';
+    success: boolean;
+    satisfies: string[];
+    display_line: string;
+    event_fingerprint: string;
+    event_digest: string;
+}
+export interface JudgmentFinalReceipt {
+    schema_version: 'brainbase-judgment-final-v1';
+    session_ref: string;
+    turn_id: string;
+    finalized_at: string;
+    initial_receipt_digest: string;
+    event_count: number;
+    event_set_digest: string;
+    answer_digest: string;
+    completion_status?: 'complete';
+    owner_audit_complete?: boolean;
+    owner_audit_line_count?: number;
+    final_digest: string;
+}
+export interface JudgmentStopBlock {
+    decision: 'block';
+    reason: string;
+}
+export declare function canonicalJson(value: unknown): string;
+export declare function buildJudgmentRequest(payload: JudgmentHookPayload, { env, trustedConversationMessages }?: {
+    env?: Environment;
+    trustedConversationMessages?: ConversationMessage[];
+}): JudgmentRequest;
+export declare function resolveLocalJudgment(request: JudgmentRequest, options?: LocalResolverOptions): Promise<JudgmentReceipt>;
+export declare function buildOwnerAudit(request: JudgmentRequest, receipt: JudgmentReceipt, { historicalExact }?: {
+    historicalExact?: boolean;
+}): JudgmentOwnerAudit;
+export declare function buildOwnerReferenceLine(request: JudgmentRequest, receipt: JudgmentReceipt): string;
+export declare function runJudgmentHost(payload: JudgmentHookPayload, options?: JudgmentHostOptions): Promise<JudgmentHookOutput>;
+export declare function processJudgmentHook(payload: JudgmentHookPayload, options?: JudgmentHostOptions): Promise<JudgmentHookOutput | JudgmentFinalReceipt | JudgmentStopBlock | {
+    systemMessage: string;
+} | Record<string, never>>;
+export declare function blockedJudgmentOutput(reason: string): {
+    continue: false;
+    suppressOutput: false;
+    stopReason: string;
+};
+export {};