* feat: add LangGraph integration with tools, nodes, and store patterns Add hindsight-langgraph SDK providing three integration patterns: - Tools: retain/recall/reflect as LangChain tools for ReAct agents - Nodes: automatic memory injection and storage as graph steps - Store: LangGraph BaseStore implementation for checkpoint-based memory Fix: remove `from __future__ import annotations` in nodes.py which prevented LangGraph from passing RunnableConfig to node functions (runtime type inspection saw string annotations instead of actual types). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore: register langgraph with independent versioning system - Set version to 0.1.0 (integrations are versioned independently) - Add langgraph to VALID_INTEGRATIONS in release-integration.sh - Add changelog page for langgraph integration Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore: remove manual cookbook recipe page The sync-cookbook script will auto-generate this from the notebook in hindsight-cookbook once PR #17 is merged. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: comprehensive improvements to langgraph integration Code fixes: - Retain node only stores latest messages instead of all history (prevents duplicates) - Handle multimodal msg.content (list type) in nodes - Fix store docstring separator "/" → "." - Apply search filters before pagination in store - Add ttl parameter to store.aput for LangGraph BaseStore compat - Fix _ensure_bank to not cache failed bank creations - Fix falsy value bugs (or → is not None) in tools - Remove from __future__ import annotations from all files - Consistent default budget="mid" across tools/nodes/store - Bump langgraph floor to >=0.3.0, remove duplicate dev deps Docs fixes: - Fix broken Cloud client example (base_url is required) - Complete API reference tables with all parameters - Add Limitations and Notes section (async-only store, etc.) - Add Requirements section - Fix broken cookbook link and Cloud claim in blog post All 61 unit tests pass. E2E tested against Hindsight Cloud: tools, nodes, store, configure(), multimodal content. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore: remove blog post (lives in hindsight-marketing-content) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore: remove Hindsight Cloud section from langgraph docs Keep OSS docs self-hosted-first, consistent with other integration docs (crewai, pydantic-ai, agno). Cloud setup details live in the cookbook notebooks. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs: explicitly mention LangChain compatibility in langgraph integration The tools pattern (create_hindsight_tools) only depends on langchain-core and works with plain LangChain via bind_tools() — no LangGraph required. Update docs to make this clear with both LangGraph and LangChain quick start examples. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: address PR review findings 1. Guard manual test files with if __name__ == "__main__" so pytest doesn't collect and execute them during test runs 2. Remove semantic fallback in HindsightStore.aget() — only return exact document_id matches, not unrelated semantic search hits 3. Make langgraph an optional dependency — tools pattern only needs langchain-core. Install with pip install hindsight-langgraph[langgraph] for nodes and store patterns. Lazy imports with clear error messages. 4. Clean up README to be self-hosted-first, consistent with other integration docs 5. Update docs requirements section to reflect optional langgraph dep Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: address PR review feedback for langgraph integration - Fix #2: Add per-bank asyncio.Lock to _ensure_bank for concurrency safety - Fix #3: Clamp search score to max(0.0, ...) to prevent negative values - Fix #4: Implement suffix matching in _handle_list_namespaces - Fix #5: Truncate namespaces to max_depth instead of filtering (per BaseStore contract) - Fix #6: Remove list_namespaces/alist_namespaces overrides — let base class handle prefix=/suffix= kwargs - Fix #7: Document ephemeral namespace tracking and get() limitations in class docstring - Fix #8: Add stable ID to recall node SystemMessage, document ordering behavior - Fix #9: Change budget/max_tokens/recall_tags_match defaults to None so global config fallback works - Fix #10: Conditionally populate __all__ so import * works without langgraph installed - Fix #11: Bump langgraph lower bound from >=0.3.0 to >=0.5.0 - Fix #12: Extract _resolve_client to shared _client.py module Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: address remaining review gaps for langgraph integration - Add output_key parameter to create_recall_node for prompt ordering control - Add prefix/suffix/combined filter tests for list_namespaces - Add output_key unit tests (memory text, none on empty, none on error) - Remove unused imports and backward-compat alias in tools.py - Update docs with output_key usage example and API reference Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: relax langgraph version constraint to >=0.3.0 Research confirmed all required APIs (BaseStore, SearchItem, Result, GetOp, PutOp, SearchOp, ListNamespacesOp) are available since langgraph-checkpoint 2.0.7, which maps to langgraph >=0.2.63. Using >=0.3.0 as a clean semver boundary — >=0.5.0 was unnecessarily conservative and excluded many compatible versions. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
148 lines
4.1 KiB
Bash
Executable file
148 lines
4.1 KiB
Bash
Executable file
#!/bin/bash
|
|
set -e
|
|
|
|
cd "$(dirname "$0")/.."
|
|
|
|
# Colors for output
|
|
RED='\033[0;31m'
|
|
GREEN='\033[0;32m'
|
|
YELLOW='\033[1;33m'
|
|
NC='\033[0m' # No Color
|
|
|
|
print_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
|
|
print_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
|
|
print_error() { echo -e "${RED}[ERROR]${NC} $1"; }
|
|
|
|
VALID_INTEGRATIONS=("litellm" "pydantic-ai" "crewai" "ai-sdk" "chat" "openclaw" "langgraph")
|
|
|
|
usage() {
|
|
print_error "Usage: $0 <integration> <version>"
|
|
echo ""
|
|
echo " integration One of: ${VALID_INTEGRATIONS[*]}"
|
|
echo " version Semantic version (e.g. 0.2.0)"
|
|
echo ""
|
|
echo "Examples:"
|
|
echo " $0 litellm 0.2.0"
|
|
echo " $0 pydantic-ai 1.0.0"
|
|
exit 1
|
|
}
|
|
|
|
if [ -z "$1" ] || [ -z "$2" ]; then
|
|
usage
|
|
fi
|
|
|
|
INTEGRATION=$1
|
|
VERSION=$2
|
|
|
|
# Validate integration name
|
|
VALID=false
|
|
for v in "${VALID_INTEGRATIONS[@]}"; do
|
|
if [ "$v" = "$INTEGRATION" ]; then
|
|
VALID=true
|
|
break
|
|
fi
|
|
done
|
|
if [ "$VALID" = "false" ]; then
|
|
print_error "Unknown integration '$INTEGRATION'"
|
|
print_info "Valid integrations: ${VALID_INTEGRATIONS[*]}"
|
|
exit 1
|
|
fi
|
|
|
|
# Validate version format
|
|
if ! [[ $VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
|
|
print_error "Invalid version format. Please use semantic versioning (e.g., 0.2.0)"
|
|
exit 1
|
|
fi
|
|
|
|
TAG="integrations/$INTEGRATION/v$VERSION"
|
|
|
|
print_info "Releasing $INTEGRATION v$VERSION (tag: $TAG)"
|
|
|
|
# Check if we're on main branch
|
|
CURRENT_BRANCH=$(git branch --show-current)
|
|
if [ "$CURRENT_BRANCH" != "main" ]; then
|
|
print_warn "You are not on the main branch (current: $CURRENT_BRANCH)"
|
|
read -p "Do you want to continue? (y/n) " -n 1 -r
|
|
echo
|
|
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
|
print_error "Release cancelled"
|
|
exit 1
|
|
fi
|
|
fi
|
|
|
|
# Check if working directory is clean
|
|
if [[ -n $(git status -s) ]]; then
|
|
print_error "Working directory is not clean. Please commit or stash your changes."
|
|
git status -s
|
|
exit 1
|
|
fi
|
|
|
|
# Check if tag already exists
|
|
if git rev-parse "$TAG" >/dev/null 2>&1; then
|
|
print_error "Tag $TAG already exists"
|
|
exit 1
|
|
fi
|
|
|
|
# Load .env for OPENAI_API_KEY if needed
|
|
if [ -z "$OPENAI_API_KEY" ] && [ -f ".env" ]; then
|
|
print_info "Loading environment from .env"
|
|
set -a
|
|
source ".env"
|
|
set +a
|
|
fi
|
|
|
|
if [ -z "$OPENAI_API_KEY" ]; then
|
|
print_error "OPENAI_API_KEY is not set and no .env file found. Required for changelog generation."
|
|
exit 1
|
|
fi
|
|
|
|
# Determine integration type and update version
|
|
INTEGRATION_DIR="hindsight-integrations/$INTEGRATION"
|
|
|
|
if [ ! -d "$INTEGRATION_DIR" ]; then
|
|
print_error "Integration directory not found: $INTEGRATION_DIR"
|
|
exit 1
|
|
fi
|
|
|
|
if [ -f "$INTEGRATION_DIR/pyproject.toml" ]; then
|
|
print_info "Updating version in $INTEGRATION_DIR/pyproject.toml"
|
|
sed -i.bak "s/^version = \".*\"/version = \"$VERSION\"/" "$INTEGRATION_DIR/pyproject.toml"
|
|
rm "$INTEGRATION_DIR/pyproject.toml.bak"
|
|
elif [ -f "$INTEGRATION_DIR/package.json" ]; then
|
|
print_info "Updating version in $INTEGRATION_DIR/package.json"
|
|
sed -i.bak "s/\"version\": \".*\"/\"version\": \"$VERSION\"/" "$INTEGRATION_DIR/package.json"
|
|
rm "$INTEGRATION_DIR/package.json.bak"
|
|
else
|
|
print_error "No pyproject.toml or package.json found in $INTEGRATION_DIR"
|
|
exit 1
|
|
fi
|
|
|
|
# Generate changelog entry using LLM
|
|
print_info "Generating changelog entry..."
|
|
if cd hindsight-dev && uv run generate-changelog "$VERSION" --integration "$INTEGRATION"; then
|
|
cd ..
|
|
print_info "Changelog generated"
|
|
else
|
|
cd ..
|
|
print_error "Changelog generation failed"
|
|
git checkout .
|
|
exit 1
|
|
fi
|
|
|
|
# Commit version bump + changelog together
|
|
print_info "Committing changes..."
|
|
git add "hindsight-integrations/$INTEGRATION/" "hindsight-docs/src/pages/changelog/integrations/$INTEGRATION.md"
|
|
git commit --no-verify -m "release($INTEGRATION): v$VERSION"
|
|
|
|
# Create annotated tag
|
|
print_info "Creating tag $TAG..."
|
|
git tag -a "$TAG" -m "Release $INTEGRATION v$VERSION"
|
|
|
|
# Push commit and tag
|
|
print_info "Pushing to remote..."
|
|
git push origin "$CURRENT_BRANCH"
|
|
git push origin "$TAG"
|
|
|
|
print_info "✅ Released $INTEGRATION v$VERSION"
|
|
print_info "Tag: $TAG"
|
|
print_info "GitHub Actions will publish to the package registry."
|