flowscript-agents 0.2.2__tar.gz → 0.2.4__tar.gz

flowscript_agents-0.2.4/.github/workflows/test.yml

@@ -0,0 +1,86 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  test-core:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ['3.11', '3.12']
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+
+      - name: Run core tests
+        run: |
+          pytest tests/test_memory.py tests/test_audit.py tests/test_consolidation.py tests/test_embeddings.py tests/test_mcp.py -v --tb=short
+
+  test-mcp-smoke:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install from PyPI (simulates real user)
+        run: pip install flowscript-agents
+
+      - name: Verify import
+        run: python -c "from flowscript_agents import Memory, UnifiedMemory; print('Import OK')"
+
+      - name: MCP server stdio handshake
+        shell: python
+        run: |
+          import subprocess, json, sys, time
+
+          proc = subprocess.Popen(
+              [sys.executable, '-m', 'flowscript_agents.mcp', '--memory', './test-memory.json'],
+              stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
+              text=True
+          )
+          time.sleep(2)
+
+          # Send initialize
+          msg = json.dumps({
+              'jsonrpc': '2.0', 'id': 1, 'method': 'initialize',
+              'params': {
+                  'protocolVersion': '2025-03-26',
+                  'capabilities': {},
+                  'clientInfo': {'name': 'ci-test', 'version': '1.0'}
+              }
+          })
+          proc.stdin.write(msg + '\n')
+          proc.stdin.flush()
+          time.sleep(1)
+
+          response = proc.stdout.readline()
+          assert response, 'No response from MCP server'
+          data = json.loads(response)
+          assert 'result' in data, f'Bad response: {data}'
+
+          info = data['result'].get('serverInfo', {})
+          print(f"MCP server OK: {info.get('name')} v{info.get('version')}")
+
+          tools_count = len(data['result'].get('capabilities', {}).get('tools', {}))
+          print(f"Platform: {sys.platform}")
+          print(f"Python: {sys.version}")
+
+          proc.terminate()
+          print('PASS: MCP stdio handshake works')

{flowscript_agents-0.2.2 → flowscript_agents-0.2.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: flowscript-agents
-Version: 0.2.2
-Summary: Complete agent memory: reasoning queries + vector search + auto-extraction. Decision intelligence for LangGraph, CrewAI, Google ADK, OpenAI Agents SDK, Pydantic AI, smolagents, LlamaIndex, Haystack, CAMEL-AI, and Vercel AI SDK.
+Version: 0.2.4
+Summary: Complete agent memory: reasoning queries + vector search + auto-extraction. Decision intelligence for LangGraph, CrewAI, Google ADK, OpenAI Agents SDK, Pydantic AI, smolagents, LlamaIndex, Haystack, and CAMEL-AI.
 Project-URL: Homepage, https://flowscript.org
 Project-URL: Repository, https://github.com/phillipclapham/flowscript-agents
 Project-URL: Issues, https://github.com/phillipclapham/flowscript-agents/issues
@@ -62,9 +62,13 @@ Provides-Extra: smolagents
 Requires-Dist: smolagents>=1.0.0; extra == 'smolagents'
 Description-Content-Type: text/markdown
 
-# flowscript-agents
+<p align="center">
+  <img src="docs/brand/logo-512.png" alt="FlowScript" width="120" />
+</p>
 
-**Agent memory that tracks why you decided, what conflicts, and what's blocked. Not just what was said.**
+<h1 align="center">flowscript-agents</h1>
+
+<p align="center"><strong>Agent memory that tracks why you decided, what conflicts, and what's blocked. Not just what was said.</strong></p>
 
 [![Tests](https://img.shields.io/badge/tests-581%20passing-brightgreen)](https://github.com/phillipclapham/flowscript-agents) [![PyPI](https://img.shields.io/pypi/v/flowscript-agents)](https://pypi.org/project/flowscript-agents/) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/flowscript-agents/)
 
@@ -107,6 +111,16 @@ Five queries that no vector store can answer — `why()`, `tensions()`, `blocked
 
 ---
 
+## Why FlowScript
+
+Agent memory stores what happened. FlowScript stores why.
+
+Most agent infrastructure is converging on authorization — identity, access control, audit trails for *who did what*. That's necessary. But it leaves a gap: your agent can prove it was *allowed* to make a decision, but not *why* it made it. Researchers call this "[strategic blindness](https://arxiv.org/abs/2603.18718)" — memory that tracks content without tracking reasoning.
+
+FlowScript sits above your memory store, not instead of it. Google Memory Bank, LangGraph checkpointers, Mem0 — they remember what your agent stored. FlowScript remembers why it decided, what it traded off, and what breaks if you change your mind.
+
+---
+
 ## Get Started
 
 ### MCP Server (Claude Code / Cursor — zero code)
@@ -191,6 +205,14 @@ The default is OpenAI `text-embedding-3-small`. To use a different provider, pas
 
 You still need an LLM API key (`OPENAI_API_KEY` or `ANTHROPIC_API_KEY`) for typed extraction and consolidation, even when using local embeddings.
 
+**Using Anthropic instead of OpenAI:**
+
+With `ANTHROPIC_API_KEY` set, the server auto-configures extraction and consolidation using Claude Haiku. No vector search (Anthropic has no embedding API), but keyword + temporal search works well. To use a different Anthropic model:
+
+```json
+"args": ["--memory", "./project-memory.json", "--llm-model", "claude-sonnet-4-6"]
+```
+
 **Then add the [CLAUDE.md snippet](examples/CLAUDE.md.example) to your project.** This is what turns tools into a workflow. It tells your agent *when* to record decisions, surface tensions before new choices, and check blockers at session start. Without it, the tools are available but passive. With it, your agent proactively tracks your project's reasoning.
 
 ### Python SDK
@@ -353,7 +375,7 @@ Under the hood: a local semantic graph with typed nodes, typed relationships, an
 | [flowscript-core](https://www.npmjs.com/package/flowscript-core) | TypeScript SDK — Memory class, 15 tools, token budgeting, audit trail | `npm install flowscript-core` |
 | [flowscript.org](https://flowscript.org) | Web editor, D3 visualization, live query panel | Browser |
 
-**1,272 tests** across Python (581) and TypeScript (691). Same audit trail format and canonical JSON serialization across both languages.
+**1,312 tests** across Python (581) and TypeScript (731). Same audit trail format and canonical JSON serialization across both languages.
 
 ### Docs
 

{flowscript_agents-0.2.2 → flowscript_agents-0.2.4}/README.md

@@ -1,6 +1,10 @@
-# flowscript-agents
+<p align="center">
+  <img src="docs/brand/logo-512.png" alt="FlowScript" width="120" />
+</p>
 
-**Agent memory that tracks why you decided, what conflicts, and what's blocked. Not just what was said.**
+<h1 align="center">flowscript-agents</h1>
+
+<p align="center"><strong>Agent memory that tracks why you decided, what conflicts, and what's blocked. Not just what was said.</strong></p>
 
 [![Tests](https://img.shields.io/badge/tests-581%20passing-brightgreen)](https://github.com/phillipclapham/flowscript-agents) [![PyPI](https://img.shields.io/pypi/v/flowscript-agents)](https://pypi.org/project/flowscript-agents/) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/flowscript-agents/)
 
@@ -43,6 +47,16 @@ Five queries that no vector store can answer — `why()`, `tensions()`, `blocked
 
 ---
 
+## Why FlowScript
+
+Agent memory stores what happened. FlowScript stores why.
+
+Most agent infrastructure is converging on authorization — identity, access control, audit trails for *who did what*. That's necessary. But it leaves a gap: your agent can prove it was *allowed* to make a decision, but not *why* it made it. Researchers call this "[strategic blindness](https://arxiv.org/abs/2603.18718)" — memory that tracks content without tracking reasoning.
+
+FlowScript sits above your memory store, not instead of it. Google Memory Bank, LangGraph checkpointers, Mem0 — they remember what your agent stored. FlowScript remembers why it decided, what it traded off, and what breaks if you change your mind.
+
+---
+
 ## Get Started
 
 ### MCP Server (Claude Code / Cursor — zero code)
@@ -127,6 +141,14 @@ The default is OpenAI `text-embedding-3-small`. To use a different provider, pas
 
 You still need an LLM API key (`OPENAI_API_KEY` or `ANTHROPIC_API_KEY`) for typed extraction and consolidation, even when using local embeddings.
 
+**Using Anthropic instead of OpenAI:**
+
+With `ANTHROPIC_API_KEY` set, the server auto-configures extraction and consolidation using Claude Haiku. No vector search (Anthropic has no embedding API), but keyword + temporal search works well. To use a different Anthropic model:
+
+```json
+"args": ["--memory", "./project-memory.json", "--llm-model", "claude-sonnet-4-6"]
+```
+
 **Then add the [CLAUDE.md snippet](examples/CLAUDE.md.example) to your project.** This is what turns tools into a workflow. It tells your agent *when* to record decisions, surface tensions before new choices, and check blockers at session start. Without it, the tools are available but passive. With it, your agent proactively tracks your project's reasoning.
 
 ### Python SDK
@@ -289,7 +311,7 @@ Under the hood: a local semantic graph with typed nodes, typed relationships, an
 | [flowscript-core](https://www.npmjs.com/package/flowscript-core) | TypeScript SDK — Memory class, 15 tools, token budgeting, audit trail | `npm install flowscript-core` |
 | [flowscript.org](https://flowscript.org) | Web editor, D3 visualization, live query panel | Browser |
 
-**1,272 tests** across Python (581) and TypeScript (691). Same audit trail format and canonical JSON serialization across both languages.
+**1,312 tests** across Python (581) and TypeScript (731). Same audit trail format and canonical JSON serialization across both languages.
 
 ### Docs
 

{flowscript_agents-0.2.2 → flowscript_agents-0.2.4}/flowscript_agents/__init__.py

@@ -3,7 +3,7 @@ FlowScript Agents — Complete agent memory: reasoning + vector + auto-extractio
 
 Decision intelligence memory for AI agent frameworks. Drop-in provider for
 LangGraph, CrewAI, Google ADK, OpenAI Agents SDK, Pydantic AI, smolagents,
-LlamaIndex, Haystack, CAMEL-AI, and Vercel AI SDK.
+LlamaIndex, Haystack, and CAMEL-AI.
 
 What Mem0 does, plus what Mem0 can't: typed semantic queries (why, tensions,
 blocked, alternatives, whatIf) over agent reasoning with temporal intelligence.

{flowscript_agents-0.2.2 → flowscript_agents-0.2.4}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "flowscript-agents"
-version = "0.2.2"
-description = "Complete agent memory: reasoning queries + vector search + auto-extraction. Decision intelligence for LangGraph, CrewAI, Google ADK, OpenAI Agents SDK, Pydantic AI, smolagents, LlamaIndex, Haystack, CAMEL-AI, and Vercel AI SDK."
+version = "0.2.4"
+description = "Complete agent memory: reasoning queries + vector search + auto-extraction. Decision intelligence for LangGraph, CrewAI, Google ADK, OpenAI Agents SDK, Pydantic AI, smolagents, LlamaIndex, Haystack, and CAMEL-AI."
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"