Skip to content

Company Brain MCP tools for account resolution and evidence-backed briefings #26

@100yenadmin

Description

@100yenadmin

Upstream epic: electricsheephq/electric-sheep#2029
Related: #24, #25

Summary

Add explicit company_brain_* plugin tools so OpenClaw/evaOS agents consume Company Brain through account-scoped, source-backed contracts instead of generic always-on memory injection.

Tool Scope

Proposed minimum tool set:

  • company_brain_accounts_list / search: resolve stable Cortex account IDs and workspace IDs.
  • company_brain_account_brief: fetch source-backed account context and honest missing-evidence buckets.
  • company_brain_account_timeline: fetch artifact and claim events with source citations.
  • company_brain_query: ask narrow pilot questions such as what_changed, who_needs_follow_up, what_is_blocked, and daily_account_briefing.
  • Optional dry-run helper for action candidates that preserves requires_approval, action_readiness, verification_status, and visibility_scope.

Integration Rules

  • Require deterministic account/workspace resolution before injecting account context into a turn.
  • Preserve source citations and action-readiness metadata in tool output.
  • Do not flatten source-backed account memory into generic personal memory.
  • Treat insufficient_evidence as a first-class successful response, not a tool failure.
  • Do not allow the agent to silently act on approval-gated follow-up/action candidates.

Acceptance Criteria

  • Plugin tools call the live Cortex Company Brain endpoints landed in electricsheephq/electric-sheep #2026, #2027, and #2028.
  • Tool schemas match the Cortex fixture/examples issue electricsheephq/electric-sheep#2033 once available.
  • Tests cover account resolution, missing evidence, cited facts, action-readiness flags, and failure handling.
  • Documentation explains how this relates to Company Brain injection mode #24 injection mode and Action-safety bridge for Company Brain context #25 action safety.

Non-Goals

  • No broad rewrite of the existing Cortex plugin memory model.
  • No autonomous outbound action execution.
  • No dashboard UI work in this repo.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions