Build on
governed state and action authorization

from cogna8 import Cogna8Client

client = Cogna8Client(api_key="sk_live_...")

# Push a state item
item = await client.state.create(
    session_id="sess_abc123",
    key="project.budget",
    value="$4.2M",
    type="fact",
)
print(f"Created: {item.id}")

# Evaluate a gate
result = await client.gates.evaluate(
    session_id="sess_abc123",
    action="send_invoice",
)

if result.verdict == "ALLOW":
    await send_invoice()
elif result.verdict == "BLOCK":
    print(f"Blocked: {result.reason}")

import { Cogna8 } from '@cogna8/sdk';

const client = new Cogna8({ apiKey: 'sk_live_...' });

// Push a state item
const item = await client.state.create({
  sessionId: 'sess_abc123',
  key: 'project.budget',
  value: '$4.2M',
  type: 'fact',
});
console.log(`Created: ${item.id}`);

// Evaluate a gate
const result = await client.gates.evaluate({
  sessionId: 'sess_abc123',
  action: 'send_invoice',
});

if (result.verdict === 'ALLOW') {
  await sendInvoice();
} else if (result.verdict === 'BLOCK') {
  console.log(`Blocked: ${result.reason}`);
}

# cogna8-policy.yaml

policies:
  - name: invoice-gate
    action: send_invoice
    enforcement: strict
    requires:
      - project.budget
      - client.address
      - invoice.approved
    on_block:
      notify: ["ops@company.com"]

  - name: question-gate
    action: ask_question
    enforcement: permissive

# Planned Q2 2026 — integration not yet live
from langchain.agents import AgentExecutor
from cogna8.integrations import LangChainCallback

# Add Cogna8 as a callback handler
cogna8_cb = LangChainCallback(
    api_key="sk_live_...",
    session_id="sess_abc123",
)

agent = AgentExecutor(
    agent=your_agent,
    tools=your_tools,
    callbacks=[cogna8_cb],
)

# State is automatically extracted.
# Tool calls are gated before execution.
result = await agent.ainvoke({
    "input": "Send the invoice for Project Alpha"
})
# → Gate blocks if conflicts exist

PLANNED Q2 2026 — webhooks not yet live
POST /v1/webhooks
Authorization: Bearer sk_live_...

{
  "url": "https://your-app.com/hooks/cogna8",
  "events": [
    "state.created",
    "state.conflict",
    "gate.blocked",
    "conflict.resolved"
  ],
  "secret": "whsec_your_signing_secret"
}

// Incoming webhook payload:
{
  "event": "gate.blocked",
  "timestamp": "2025-01-15T14:23:07Z",
  "data": {
    "action": "send_invoice",
    "session_id": "sess_abc123",
    "verdict": "BLOCK",
    "reasons": ["Unresolved conflict on project.budget"]
  }
}

# .github/workflows/cogna8-gates.yml
# Planned Q2 2026 — CI/CD gate action not yet live
name: Policy Gate Check
on: [push, pull_request]

jobs:
  gate-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Validate policies
        uses: cogna8/gate-action@v1
        with:
          api-key: ${{ secrets.COGNA8_API_KEY }}
          policy-file: cogna8-policy.yaml

      - name: Run gate simulation
        uses: cogna8/gate-action@v1
        with:
          api-key: ${{ secrets.COGNA8_API_KEY }}
          action: deploy_production
          session-id: ci-${{ github.sha }}
          fail-on: block