@bluefly/openstandardagents 0.3.3 → 0.3.5

package/spec/v0.3/extensions/langchain/langchain.schema.json

@@ -0,0 +1,243 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.3.5/extensions/langchain/langchain.json",
+  "title": "LangChain Extension",
+  "description": "Native integration with LangChain framework for building LLM applications with chains, agents, memory, and RAG capabilities.",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "Enable LangChain integration"
+    },
+    "chain_type": {
+      "type": "string",
+      "enum": ["llm", "retrieval", "agent", "sequential", "custom"],
+      "description": "Type of LangChain chain"
+    },
+    "memory": {
+      "$ref": "#/definitions/MemoryConfig",
+      "description": "Memory configuration for conversation history"
+    },
+    "retrieval": {
+      "$ref": "#/definitions/RetrievalConfig",
+      "description": "RAG retrieval configuration"
+    },
+    "callbacks": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/CallbackHandler"
+      },
+      "description": "Callback handlers for chain execution"
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/LangChainTool"
+      },
+      "description": "LangChain tools for agent execution"
+    },
+    "verbose": {
+      "type": "boolean",
+      "default": false,
+      "description": "Enable verbose logging"
+    },
+    "return_intermediate_steps": {
+      "type": "boolean",
+      "default": false,
+      "description": "Return intermediate steps in agent execution"
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Tags for tracing and observability"
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Additional metadata for chains"
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "MemoryConfig": {
+      "type": "object",
+      "description": "Memory configuration",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["buffer", "summary", "conversation", "vector"],
+          "description": "Memory type"
+        },
+        "max_token_limit": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum tokens to store in memory"
+        },
+        "return_messages": {
+          "type": "boolean",
+          "default": true,
+          "description": "Return messages as objects vs strings"
+        },
+        "memory_key": {
+          "type": "string",
+          "default": "history",
+          "description": "Key to store memory in chain state"
+        },
+        "input_key": {
+          "type": "string",
+          "description": "Input key for memory"
+        },
+        "output_key": {
+          "type": "string",
+          "description": "Output key for memory"
+        },
+        "vectorstore": {
+          "$ref": "#/definitions/VectorStoreConfig",
+          "description": "Vector store configuration for vector memory"
+        }
+      },
+      "additionalProperties": false
+    },
+    "VectorStoreConfig": {
+      "type": "object",
+      "description": "Vector store configuration",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["qdrant", "pinecone", "chroma", "weaviate", "faiss"],
+          "description": "Vector store type"
+        },
+        "collection_name": {
+          "type": "string",
+          "description": "Collection/index name"
+        },
+        "embedding_model": {
+          "type": "string",
+          "description": "Embedding model name",
+          "examples": ["text-embedding-3-small", "text-embedding-ada-002"]
+        },
+        "dimension": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Embedding dimension"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Vector store specific configuration"
+        }
+      },
+      "additionalProperties": false
+    },
+    "RetrievalConfig": {
+      "type": "object",
+      "description": "RAG retrieval configuration",
+      "required": ["vectorstore"],
+      "properties": {
+        "vectorstore": {
+          "$ref": "#/definitions/VectorStoreConfig",
+          "description": "Vector store configuration"
+        },
+        "search_type": {
+          "type": "string",
+          "enum": ["similarity", "mmr", "similarity_score_threshold"],
+          "default": "similarity",
+          "description": "Search type"
+        },
+        "search_kwargs": {
+          "type": "object",
+          "properties": {
+            "k": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 4,
+              "description": "Number of documents to retrieve"
+            },
+            "score_threshold": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "description": "Minimum similarity score threshold"
+            },
+            "fetch_k": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Number of documents to fetch for MMR"
+            },
+            "lambda_mult": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "description": "MMR diversity parameter"
+            }
+          },
+          "additionalProperties": true
+        },
+        "chain_type": {
+          "type": "string",
+          "enum": ["stuff", "map_reduce", "refine", "map_rerank"],
+          "default": "stuff",
+          "description": "Document processing chain type"
+        }
+      },
+      "additionalProperties": false
+    },
+    "CallbackHandler": {
+      "type": "object",
+      "description": "Callback handler configuration",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["langsmith", "wandb", "comet", "mlflow", "custom"],
+          "description": "Callback handler type"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Handler-specific configuration"
+        }
+      },
+      "additionalProperties": false
+    },
+    "LangChainTool": {
+      "type": "object",
+      "description": "LangChain tool definition",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Tool name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Tool description for LLM"
+        },
+        "func": {
+          "type": "string",
+          "description": "Function reference or code"
+        },
+        "coroutine": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether function is async"
+        },
+        "return_direct": {
+          "type": "boolean",
+          "default": false,
+          "description": "Return tool output directly to user"
+        },
+        "args_schema": {
+          "type": "object",
+          "description": "JSON Schema for tool arguments"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/spec/v0.3/extensions/langgraph/langgraph.schema.json

@@ -0,0 +1,211 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.3.5/extensions/langgraph/langgraph.json",
+  "title": "LangGraph Extension",
+  "description": "Native integration with LangGraph for building stateful, cyclical agent workflows with state machines, checkpoints, and human-in-the-loop capabilities.",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "Enable LangGraph integration"
+    },
+    "graph_config": {
+      "$ref": "#/definitions/GraphConfig",
+      "description": "State graph configuration"
+    },
+    "checkpoint_config": {
+      "$ref": "#/definitions/CheckpointConfig",
+      "description": "Checkpoint configuration for state persistence"
+    },
+    "max_iterations": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Maximum graph iterations"
+    },
+    "interrupt_before": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Node IDs to interrupt before execution"
+    },
+    "interrupt_after": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Node IDs to interrupt after execution"
+    },
+    "recursion_limit": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 25,
+      "description": "Maximum recursion depth"
+    },
+    "stream_mode": {
+      "type": "string",
+      "enum": ["values", "updates", "debug"],
+      "default": "values",
+      "description": "Stream mode for graph execution"
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "GraphConfig": {
+      "type": "object",
+      "description": "State graph configuration",
+      "required": ["nodes", "edges"],
+      "properties": {
+        "nodes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GraphNode"
+          },
+          "description": "Graph nodes"
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GraphEdge"
+          },
+          "description": "Graph edges"
+        },
+        "conditional_edges": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ConditionalEdge"
+          },
+          "description": "Conditional edges for branching"
+        },
+        "entry_point": {
+          "type": "string",
+          "description": "Entry node ID"
+        },
+        "finish_point": {
+          "type": "string",
+          "description": "Finish node ID"
+        },
+        "state_schema": {
+          "type": "object",
+          "description": "JSON Schema for graph state"
+        }
+      },
+      "additionalProperties": false
+    },
+    "GraphNode": {
+      "type": "object",
+      "description": "Graph node definition",
+      "required": ["id", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique node identifier"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["llm", "tool", "retriever", "function", "human", "end"],
+          "description": "Node type"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Node-specific configuration"
+        },
+        "reducer": {
+          "type": "string",
+          "description": "State reducer function"
+        }
+      },
+      "additionalProperties": false
+    },
+    "GraphEdge": {
+      "type": "object",
+      "description": "Graph edge definition",
+      "required": ["from", "to"],
+      "properties": {
+        "from": {
+          "type": "string",
+          "description": "Source node ID"
+        },
+        "to": {
+          "type": "string",
+          "description": "Target node ID"
+        },
+        "label": {
+          "type": "string",
+          "description": "Edge label"
+        }
+      },
+      "additionalProperties": false
+    },
+    "ConditionalEdge": {
+      "type": "object",
+      "description": "Conditional edge for branching",
+      "required": ["from", "condition", "mapping"],
+      "properties": {
+        "from": {
+          "type": "string",
+          "description": "Source node ID"
+        },
+        "condition": {
+          "type": "string",
+          "description": "Condition function or expression"
+        },
+        "mapping": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Condition result to target node mapping"
+        },
+        "default": {
+          "type": "string",
+          "description": "Default target node if condition doesn't match"
+        }
+      },
+      "additionalProperties": false
+    },
+    "CheckpointConfig": {
+      "type": "object",
+      "description": "Checkpoint configuration",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable checkpointing"
+        },
+        "storage": {
+          "type": "string",
+          "enum": ["memory", "sqlite", "postgres", "redis"],
+          "default": "memory",
+          "description": "Checkpoint storage backend"
+        },
+        "namespace": {
+          "type": "string",
+          "description": "Checkpoint namespace"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Storage-specific configuration"
+        },
+        "saver_config": {
+          "type": "object",
+          "properties": {
+            "thread_id": {
+              "type": "string",
+              "description": "Thread identifier for checkpoints"
+            },
+            "checkpoint_ns": {
+              "type": "string",
+              "description": "Checkpoint namespace"
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}