agno 1.8.1__py3-none-any.whl → 2.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (590) hide show
  1. agno/__init__.py +8 -0
  2. agno/agent/__init__.py +19 -27
  3. agno/agent/agent.py +3143 -4170
  4. agno/api/agent.py +11 -67
  5. agno/api/api.py +5 -46
  6. agno/api/evals.py +8 -19
  7. agno/api/os.py +17 -0
  8. agno/api/routes.py +6 -41
  9. agno/api/schemas/__init__.py +9 -0
  10. agno/api/schemas/agent.py +5 -21
  11. agno/api/schemas/evals.py +7 -16
  12. agno/api/schemas/os.py +14 -0
  13. agno/api/schemas/team.py +5 -21
  14. agno/api/schemas/utils.py +21 -0
  15. agno/api/schemas/workflows.py +11 -7
  16. agno/api/settings.py +53 -0
  17. agno/api/team.py +11 -66
  18. agno/api/workflow.py +28 -0
  19. agno/cloud/aws/base.py +214 -0
  20. agno/cloud/aws/s3/__init__.py +2 -0
  21. agno/cloud/aws/s3/api_client.py +43 -0
  22. agno/cloud/aws/s3/bucket.py +195 -0
  23. agno/cloud/aws/s3/object.py +57 -0
  24. agno/db/__init__.py +24 -0
  25. agno/db/base.py +245 -0
  26. agno/db/dynamo/__init__.py +3 -0
  27. agno/db/dynamo/dynamo.py +1743 -0
  28. agno/db/dynamo/schemas.py +278 -0
  29. agno/db/dynamo/utils.py +684 -0
  30. agno/db/firestore/__init__.py +3 -0
  31. agno/db/firestore/firestore.py +1432 -0
  32. agno/db/firestore/schemas.py +130 -0
  33. agno/db/firestore/utils.py +278 -0
  34. agno/db/gcs_json/__init__.py +3 -0
  35. agno/db/gcs_json/gcs_json_db.py +1001 -0
  36. agno/db/gcs_json/utils.py +194 -0
  37. agno/db/in_memory/__init__.py +3 -0
  38. agno/db/in_memory/in_memory_db.py +882 -0
  39. agno/db/in_memory/utils.py +172 -0
  40. agno/db/json/__init__.py +3 -0
  41. agno/db/json/json_db.py +1045 -0
  42. agno/db/json/utils.py +196 -0
  43. agno/db/migrations/v1_to_v2.py +162 -0
  44. agno/db/mongo/__init__.py +3 -0
  45. agno/db/mongo/mongo.py +1416 -0
  46. agno/db/mongo/schemas.py +77 -0
  47. agno/db/mongo/utils.py +204 -0
  48. agno/db/mysql/__init__.py +3 -0
  49. agno/db/mysql/mysql.py +1719 -0
  50. agno/db/mysql/schemas.py +124 -0
  51. agno/db/mysql/utils.py +297 -0
  52. agno/db/postgres/__init__.py +3 -0
  53. agno/db/postgres/postgres.py +1710 -0
  54. agno/db/postgres/schemas.py +124 -0
  55. agno/db/postgres/utils.py +280 -0
  56. agno/db/redis/__init__.py +3 -0
  57. agno/db/redis/redis.py +1367 -0
  58. agno/db/redis/schemas.py +109 -0
  59. agno/db/redis/utils.py +288 -0
  60. agno/db/schemas/__init__.py +3 -0
  61. agno/db/schemas/evals.py +33 -0
  62. agno/db/schemas/knowledge.py +40 -0
  63. agno/db/schemas/memory.py +46 -0
  64. agno/db/singlestore/__init__.py +3 -0
  65. agno/db/singlestore/schemas.py +116 -0
  66. agno/db/singlestore/singlestore.py +1712 -0
  67. agno/db/singlestore/utils.py +326 -0
  68. agno/db/sqlite/__init__.py +3 -0
  69. agno/db/sqlite/schemas.py +119 -0
  70. agno/db/sqlite/sqlite.py +1676 -0
  71. agno/db/sqlite/utils.py +268 -0
  72. agno/db/utils.py +88 -0
  73. agno/eval/__init__.py +14 -0
  74. agno/eval/accuracy.py +154 -48
  75. agno/eval/performance.py +88 -23
  76. agno/eval/reliability.py +73 -20
  77. agno/eval/utils.py +23 -13
  78. agno/integrations/discord/__init__.py +3 -0
  79. agno/{app → integrations}/discord/client.py +15 -11
  80. agno/knowledge/__init__.py +2 -2
  81. agno/{document → knowledge}/chunking/agentic.py +2 -2
  82. agno/{document → knowledge}/chunking/document.py +2 -2
  83. agno/{document → knowledge}/chunking/fixed.py +3 -3
  84. agno/{document → knowledge}/chunking/markdown.py +2 -2
  85. agno/{document → knowledge}/chunking/recursive.py +2 -2
  86. agno/{document → knowledge}/chunking/row.py +2 -2
  87. agno/knowledge/chunking/semantic.py +59 -0
  88. agno/knowledge/chunking/strategy.py +121 -0
  89. agno/knowledge/content.py +74 -0
  90. agno/knowledge/document/__init__.py +5 -0
  91. agno/{document → knowledge/document}/base.py +12 -2
  92. agno/knowledge/embedder/__init__.py +5 -0
  93. agno/{embedder → knowledge/embedder}/aws_bedrock.py +127 -1
  94. agno/{embedder → knowledge/embedder}/azure_openai.py +65 -1
  95. agno/{embedder → knowledge/embedder}/base.py +6 -0
  96. agno/{embedder → knowledge/embedder}/cohere.py +72 -1
  97. agno/{embedder → knowledge/embedder}/fastembed.py +17 -1
  98. agno/{embedder → knowledge/embedder}/fireworks.py +1 -1
  99. agno/{embedder → knowledge/embedder}/google.py +74 -1
  100. agno/{embedder → knowledge/embedder}/huggingface.py +36 -2
  101. agno/{embedder → knowledge/embedder}/jina.py +48 -2
  102. agno/knowledge/embedder/langdb.py +22 -0
  103. agno/knowledge/embedder/mistral.py +139 -0
  104. agno/{embedder → knowledge/embedder}/nebius.py +1 -1
  105. agno/{embedder → knowledge/embedder}/ollama.py +54 -3
  106. agno/knowledge/embedder/openai.py +223 -0
  107. agno/{embedder → knowledge/embedder}/sentence_transformer.py +16 -1
  108. agno/{embedder → knowledge/embedder}/together.py +1 -1
  109. agno/{embedder → knowledge/embedder}/voyageai.py +49 -1
  110. agno/knowledge/knowledge.py +1551 -0
  111. agno/knowledge/reader/__init__.py +7 -0
  112. agno/{document → knowledge}/reader/arxiv_reader.py +32 -4
  113. agno/knowledge/reader/base.py +88 -0
  114. agno/{document → knowledge}/reader/csv_reader.py +47 -65
  115. agno/knowledge/reader/docx_reader.py +83 -0
  116. agno/{document → knowledge}/reader/firecrawl_reader.py +42 -21
  117. agno/{document → knowledge}/reader/json_reader.py +30 -9
  118. agno/{document → knowledge}/reader/markdown_reader.py +58 -9
  119. agno/{document → knowledge}/reader/pdf_reader.py +71 -126
  120. agno/knowledge/reader/reader_factory.py +268 -0
  121. agno/knowledge/reader/s3_reader.py +101 -0
  122. agno/{document → knowledge}/reader/text_reader.py +31 -10
  123. agno/knowledge/reader/url_reader.py +128 -0
  124. agno/knowledge/reader/web_search_reader.py +366 -0
  125. agno/{document → knowledge}/reader/website_reader.py +37 -10
  126. agno/knowledge/reader/wikipedia_reader.py +59 -0
  127. agno/knowledge/reader/youtube_reader.py +78 -0
  128. agno/knowledge/remote_content/remote_content.py +88 -0
  129. agno/{reranker → knowledge/reranker}/base.py +1 -1
  130. agno/{reranker → knowledge/reranker}/cohere.py +2 -2
  131. agno/{reranker → knowledge/reranker}/infinity.py +2 -2
  132. agno/{reranker → knowledge/reranker}/sentence_transformer.py +2 -2
  133. agno/knowledge/types.py +30 -0
  134. agno/knowledge/utils.py +169 -0
  135. agno/media.py +269 -268
  136. agno/memory/__init__.py +2 -10
  137. agno/memory/manager.py +1003 -148
  138. agno/models/aimlapi/__init__.py +2 -2
  139. agno/models/aimlapi/aimlapi.py +6 -6
  140. agno/models/anthropic/claude.py +131 -131
  141. agno/models/aws/bedrock.py +110 -182
  142. agno/models/aws/claude.py +64 -18
  143. agno/models/azure/ai_foundry.py +73 -23
  144. agno/models/base.py +346 -290
  145. agno/models/cerebras/cerebras.py +84 -27
  146. agno/models/cohere/chat.py +106 -98
  147. agno/models/google/gemini.py +105 -46
  148. agno/models/groq/groq.py +97 -35
  149. agno/models/huggingface/huggingface.py +92 -27
  150. agno/models/ibm/watsonx.py +72 -13
  151. agno/models/litellm/chat.py +85 -13
  152. agno/models/message.py +46 -151
  153. agno/models/meta/llama.py +85 -49
  154. agno/models/metrics.py +120 -0
  155. agno/models/mistral/mistral.py +90 -21
  156. agno/models/ollama/__init__.py +0 -2
  157. agno/models/ollama/chat.py +85 -47
  158. agno/models/openai/chat.py +154 -37
  159. agno/models/openai/responses.py +178 -105
  160. agno/models/perplexity/perplexity.py +26 -2
  161. agno/models/portkey/portkey.py +0 -7
  162. agno/models/response.py +15 -9
  163. agno/models/utils.py +20 -0
  164. agno/models/vercel/__init__.py +2 -2
  165. agno/models/vercel/v0.py +1 -1
  166. agno/models/vllm/__init__.py +2 -2
  167. agno/models/vllm/vllm.py +3 -3
  168. agno/models/xai/xai.py +10 -10
  169. agno/os/__init__.py +3 -0
  170. agno/os/app.py +497 -0
  171. agno/os/auth.py +47 -0
  172. agno/os/config.py +103 -0
  173. agno/os/interfaces/agui/__init__.py +3 -0
  174. agno/os/interfaces/agui/agui.py +31 -0
  175. agno/{app/agui/async_router.py → os/interfaces/agui/router.py} +16 -16
  176. agno/{app → os/interfaces}/agui/utils.py +77 -33
  177. agno/os/interfaces/base.py +21 -0
  178. agno/os/interfaces/slack/__init__.py +3 -0
  179. agno/{app/slack/async_router.py → os/interfaces/slack/router.py} +3 -5
  180. agno/os/interfaces/slack/slack.py +32 -0
  181. agno/os/interfaces/whatsapp/__init__.py +3 -0
  182. agno/{app/whatsapp/async_router.py → os/interfaces/whatsapp/router.py} +4 -7
  183. agno/os/interfaces/whatsapp/whatsapp.py +29 -0
  184. agno/os/mcp.py +235 -0
  185. agno/os/router.py +1400 -0
  186. agno/os/routers/__init__.py +3 -0
  187. agno/os/routers/evals/__init__.py +3 -0
  188. agno/os/routers/evals/evals.py +393 -0
  189. agno/os/routers/evals/schemas.py +142 -0
  190. agno/os/routers/evals/utils.py +161 -0
  191. agno/os/routers/knowledge/__init__.py +3 -0
  192. agno/os/routers/knowledge/knowledge.py +850 -0
  193. agno/os/routers/knowledge/schemas.py +118 -0
  194. agno/os/routers/memory/__init__.py +3 -0
  195. agno/os/routers/memory/memory.py +410 -0
  196. agno/os/routers/memory/schemas.py +58 -0
  197. agno/os/routers/metrics/__init__.py +3 -0
  198. agno/os/routers/metrics/metrics.py +178 -0
  199. agno/os/routers/metrics/schemas.py +47 -0
  200. agno/os/routers/session/__init__.py +3 -0
  201. agno/os/routers/session/session.py +536 -0
  202. agno/os/schema.py +945 -0
  203. agno/{app/playground → os}/settings.py +7 -15
  204. agno/os/utils.py +270 -0
  205. agno/reasoning/azure_ai_foundry.py +4 -4
  206. agno/reasoning/deepseek.py +4 -4
  207. agno/reasoning/default.py +6 -11
  208. agno/reasoning/groq.py +4 -4
  209. agno/reasoning/helpers.py +4 -6
  210. agno/reasoning/ollama.py +4 -4
  211. agno/reasoning/openai.py +4 -4
  212. agno/run/agent.py +633 -0
  213. agno/run/base.py +53 -77
  214. agno/run/cancel.py +81 -0
  215. agno/run/team.py +243 -96
  216. agno/run/workflow.py +550 -12
  217. agno/session/__init__.py +10 -0
  218. agno/session/agent.py +244 -0
  219. agno/session/summary.py +225 -0
  220. agno/session/team.py +262 -0
  221. agno/{storage/session/v2 → session}/workflow.py +47 -24
  222. agno/team/__init__.py +15 -16
  223. agno/team/team.py +3260 -4824
  224. agno/tools/agentql.py +14 -5
  225. agno/tools/airflow.py +9 -4
  226. agno/tools/api.py +7 -3
  227. agno/tools/apify.py +2 -46
  228. agno/tools/arxiv.py +8 -3
  229. agno/tools/aws_lambda.py +7 -5
  230. agno/tools/aws_ses.py +7 -1
  231. agno/tools/baidusearch.py +4 -1
  232. agno/tools/bitbucket.py +4 -4
  233. agno/tools/brandfetch.py +14 -11
  234. agno/tools/bravesearch.py +4 -1
  235. agno/tools/brightdata.py +43 -23
  236. agno/tools/browserbase.py +13 -4
  237. agno/tools/calcom.py +12 -10
  238. agno/tools/calculator.py +10 -27
  239. agno/tools/cartesia.py +20 -17
  240. agno/tools/{clickup_tool.py → clickup.py} +12 -25
  241. agno/tools/confluence.py +8 -8
  242. agno/tools/crawl4ai.py +7 -1
  243. agno/tools/csv_toolkit.py +9 -8
  244. agno/tools/dalle.py +22 -12
  245. agno/tools/daytona.py +13 -16
  246. agno/tools/decorator.py +6 -3
  247. agno/tools/desi_vocal.py +17 -8
  248. agno/tools/discord.py +11 -8
  249. agno/tools/docker.py +30 -42
  250. agno/tools/duckdb.py +34 -53
  251. agno/tools/duckduckgo.py +8 -7
  252. agno/tools/e2b.py +62 -62
  253. agno/tools/eleven_labs.py +36 -29
  254. agno/tools/email.py +4 -1
  255. agno/tools/evm.py +7 -1
  256. agno/tools/exa.py +19 -14
  257. agno/tools/fal.py +30 -30
  258. agno/tools/file.py +9 -8
  259. agno/tools/financial_datasets.py +25 -44
  260. agno/tools/firecrawl.py +22 -22
  261. agno/tools/function.py +127 -18
  262. agno/tools/giphy.py +23 -11
  263. agno/tools/github.py +48 -126
  264. agno/tools/gmail.py +45 -61
  265. agno/tools/google_bigquery.py +7 -6
  266. agno/tools/google_maps.py +11 -26
  267. agno/tools/googlesearch.py +7 -2
  268. agno/tools/googlesheets.py +21 -17
  269. agno/tools/hackernews.py +9 -5
  270. agno/tools/jina.py +5 -4
  271. agno/tools/jira.py +18 -9
  272. agno/tools/knowledge.py +31 -32
  273. agno/tools/linear.py +19 -34
  274. agno/tools/linkup.py +5 -1
  275. agno/tools/local_file_system.py +8 -5
  276. agno/tools/lumalab.py +32 -20
  277. agno/tools/mcp.py +1 -2
  278. agno/tools/mem0.py +18 -12
  279. agno/tools/memori.py +14 -10
  280. agno/tools/mlx_transcribe.py +3 -2
  281. agno/tools/models/azure_openai.py +33 -15
  282. agno/tools/models/gemini.py +59 -32
  283. agno/tools/models/groq.py +30 -23
  284. agno/tools/models/nebius.py +28 -12
  285. agno/tools/models_labs.py +40 -16
  286. agno/tools/moviepy_video.py +7 -6
  287. agno/tools/neo4j.py +10 -8
  288. agno/tools/newspaper.py +7 -2
  289. agno/tools/newspaper4k.py +8 -3
  290. agno/tools/openai.py +58 -32
  291. agno/tools/openbb.py +12 -11
  292. agno/tools/opencv.py +63 -47
  293. agno/tools/openweather.py +14 -12
  294. agno/tools/pandas.py +11 -3
  295. agno/tools/postgres.py +4 -12
  296. agno/tools/pubmed.py +4 -1
  297. agno/tools/python.py +9 -22
  298. agno/tools/reasoning.py +35 -27
  299. agno/tools/reddit.py +11 -26
  300. agno/tools/replicate.py +55 -42
  301. agno/tools/resend.py +4 -1
  302. agno/tools/scrapegraph.py +15 -14
  303. agno/tools/searxng.py +10 -23
  304. agno/tools/serpapi.py +6 -3
  305. agno/tools/serper.py +13 -4
  306. agno/tools/shell.py +9 -2
  307. agno/tools/slack.py +12 -11
  308. agno/tools/sleep.py +3 -2
  309. agno/tools/spider.py +24 -4
  310. agno/tools/sql.py +7 -6
  311. agno/tools/tavily.py +6 -4
  312. agno/tools/telegram.py +12 -4
  313. agno/tools/todoist.py +11 -31
  314. agno/tools/toolkit.py +1 -1
  315. agno/tools/trafilatura.py +22 -6
  316. agno/tools/trello.py +9 -22
  317. agno/tools/twilio.py +10 -3
  318. agno/tools/user_control_flow.py +6 -1
  319. agno/tools/valyu.py +34 -5
  320. agno/tools/visualization.py +19 -28
  321. agno/tools/webbrowser.py +4 -3
  322. agno/tools/webex.py +11 -7
  323. agno/tools/website.py +15 -46
  324. agno/tools/webtools.py +12 -4
  325. agno/tools/whatsapp.py +5 -9
  326. agno/tools/wikipedia.py +20 -13
  327. agno/tools/x.py +14 -13
  328. agno/tools/yfinance.py +13 -40
  329. agno/tools/youtube.py +26 -20
  330. agno/tools/zendesk.py +7 -2
  331. agno/tools/zep.py +10 -7
  332. agno/tools/zoom.py +10 -9
  333. agno/utils/common.py +1 -19
  334. agno/utils/events.py +100 -123
  335. agno/utils/gemini.py +32 -2
  336. agno/utils/knowledge.py +29 -0
  337. agno/utils/log.py +54 -4
  338. agno/utils/mcp.py +68 -10
  339. agno/utils/media.py +39 -0
  340. agno/utils/message.py +12 -1
  341. agno/utils/models/aws_claude.py +1 -1
  342. agno/utils/models/claude.py +47 -4
  343. agno/utils/models/cohere.py +1 -1
  344. agno/utils/models/mistral.py +8 -7
  345. agno/utils/models/schema_utils.py +3 -3
  346. agno/utils/models/watsonx.py +1 -1
  347. agno/utils/openai.py +1 -1
  348. agno/utils/pprint.py +33 -32
  349. agno/utils/print_response/agent.py +779 -0
  350. agno/utils/print_response/team.py +1669 -0
  351. agno/utils/print_response/workflow.py +1451 -0
  352. agno/utils/prompts.py +14 -14
  353. agno/utils/reasoning.py +87 -0
  354. agno/utils/response.py +42 -42
  355. agno/utils/streamlit.py +481 -0
  356. agno/utils/string.py +8 -22
  357. agno/utils/team.py +50 -0
  358. agno/utils/timer.py +2 -2
  359. agno/vectordb/base.py +33 -21
  360. agno/vectordb/cassandra/cassandra.py +287 -23
  361. agno/vectordb/chroma/chromadb.py +482 -59
  362. agno/vectordb/clickhouse/clickhousedb.py +270 -63
  363. agno/vectordb/couchbase/couchbase.py +309 -29
  364. agno/vectordb/lancedb/lance_db.py +360 -21
  365. agno/vectordb/langchaindb/__init__.py +5 -0
  366. agno/vectordb/langchaindb/langchaindb.py +145 -0
  367. agno/vectordb/lightrag/__init__.py +5 -0
  368. agno/vectordb/lightrag/lightrag.py +374 -0
  369. agno/vectordb/llamaindex/llamaindexdb.py +127 -0
  370. agno/vectordb/milvus/milvus.py +242 -32
  371. agno/vectordb/mongodb/mongodb.py +200 -24
  372. agno/vectordb/pgvector/pgvector.py +319 -37
  373. agno/vectordb/pineconedb/pineconedb.py +221 -27
  374. agno/vectordb/qdrant/qdrant.py +334 -14
  375. agno/vectordb/singlestore/singlestore.py +286 -29
  376. agno/vectordb/surrealdb/surrealdb.py +187 -7
  377. agno/vectordb/upstashdb/upstashdb.py +342 -26
  378. agno/vectordb/weaviate/weaviate.py +227 -165
  379. agno/workflow/__init__.py +17 -13
  380. agno/workflow/{v2/condition.py → condition.py} +135 -32
  381. agno/workflow/{v2/loop.py → loop.py} +115 -28
  382. agno/workflow/{v2/parallel.py → parallel.py} +138 -108
  383. agno/workflow/{v2/router.py → router.py} +133 -32
  384. agno/workflow/{v2/step.py → step.py} +207 -49
  385. agno/workflow/{v2/steps.py → steps.py} +147 -66
  386. agno/workflow/types.py +482 -0
  387. agno/workflow/workflow.py +2410 -696
  388. agno-2.0.0.dist-info/METADATA +494 -0
  389. agno-2.0.0.dist-info/RECORD +515 -0
  390. agno-2.0.0.dist-info/licenses/LICENSE +201 -0
  391. agno/agent/metrics.py +0 -107
  392. agno/api/app.py +0 -35
  393. agno/api/playground.py +0 -92
  394. agno/api/schemas/app.py +0 -12
  395. agno/api/schemas/playground.py +0 -22
  396. agno/api/schemas/user.py +0 -35
  397. agno/api/schemas/workspace.py +0 -46
  398. agno/api/user.py +0 -160
  399. agno/api/workflows.py +0 -33
  400. agno/api/workspace.py +0 -175
  401. agno/app/agui/__init__.py +0 -3
  402. agno/app/agui/app.py +0 -17
  403. agno/app/agui/sync_router.py +0 -120
  404. agno/app/base.py +0 -186
  405. agno/app/discord/__init__.py +0 -3
  406. agno/app/fastapi/__init__.py +0 -3
  407. agno/app/fastapi/app.py +0 -107
  408. agno/app/fastapi/async_router.py +0 -457
  409. agno/app/fastapi/sync_router.py +0 -448
  410. agno/app/playground/app.py +0 -228
  411. agno/app/playground/async_router.py +0 -1050
  412. agno/app/playground/deploy.py +0 -249
  413. agno/app/playground/operator.py +0 -183
  414. agno/app/playground/schemas.py +0 -220
  415. agno/app/playground/serve.py +0 -55
  416. agno/app/playground/sync_router.py +0 -1042
  417. agno/app/playground/utils.py +0 -46
  418. agno/app/settings.py +0 -15
  419. agno/app/slack/__init__.py +0 -3
  420. agno/app/slack/app.py +0 -19
  421. agno/app/slack/sync_router.py +0 -92
  422. agno/app/utils.py +0 -54
  423. agno/app/whatsapp/__init__.py +0 -3
  424. agno/app/whatsapp/app.py +0 -15
  425. agno/app/whatsapp/sync_router.py +0 -197
  426. agno/cli/auth_server.py +0 -249
  427. agno/cli/config.py +0 -274
  428. agno/cli/console.py +0 -88
  429. agno/cli/credentials.py +0 -23
  430. agno/cli/entrypoint.py +0 -571
  431. agno/cli/operator.py +0 -357
  432. agno/cli/settings.py +0 -96
  433. agno/cli/ws/ws_cli.py +0 -817
  434. agno/constants.py +0 -13
  435. agno/document/__init__.py +0 -5
  436. agno/document/chunking/semantic.py +0 -45
  437. agno/document/chunking/strategy.py +0 -31
  438. agno/document/reader/__init__.py +0 -5
  439. agno/document/reader/base.py +0 -47
  440. agno/document/reader/docx_reader.py +0 -60
  441. agno/document/reader/gcs/pdf_reader.py +0 -44
  442. agno/document/reader/s3/pdf_reader.py +0 -59
  443. agno/document/reader/s3/text_reader.py +0 -63
  444. agno/document/reader/url_reader.py +0 -59
  445. agno/document/reader/youtube_reader.py +0 -58
  446. agno/embedder/__init__.py +0 -5
  447. agno/embedder/langdb.py +0 -80
  448. agno/embedder/mistral.py +0 -82
  449. agno/embedder/openai.py +0 -78
  450. agno/file/__init__.py +0 -5
  451. agno/file/file.py +0 -16
  452. agno/file/local/csv.py +0 -32
  453. agno/file/local/txt.py +0 -19
  454. agno/infra/app.py +0 -240
  455. agno/infra/base.py +0 -144
  456. agno/infra/context.py +0 -20
  457. agno/infra/db_app.py +0 -52
  458. agno/infra/resource.py +0 -205
  459. agno/infra/resources.py +0 -55
  460. agno/knowledge/agent.py +0 -702
  461. agno/knowledge/arxiv.py +0 -33
  462. agno/knowledge/combined.py +0 -36
  463. agno/knowledge/csv.py +0 -144
  464. agno/knowledge/csv_url.py +0 -124
  465. agno/knowledge/document.py +0 -223
  466. agno/knowledge/docx.py +0 -137
  467. agno/knowledge/firecrawl.py +0 -34
  468. agno/knowledge/gcs/__init__.py +0 -0
  469. agno/knowledge/gcs/base.py +0 -39
  470. agno/knowledge/gcs/pdf.py +0 -125
  471. agno/knowledge/json.py +0 -137
  472. agno/knowledge/langchain.py +0 -71
  473. agno/knowledge/light_rag.py +0 -273
  474. agno/knowledge/llamaindex.py +0 -66
  475. agno/knowledge/markdown.py +0 -154
  476. agno/knowledge/pdf.py +0 -164
  477. agno/knowledge/pdf_bytes.py +0 -42
  478. agno/knowledge/pdf_url.py +0 -148
  479. agno/knowledge/s3/__init__.py +0 -0
  480. agno/knowledge/s3/base.py +0 -64
  481. agno/knowledge/s3/pdf.py +0 -33
  482. agno/knowledge/s3/text.py +0 -34
  483. agno/knowledge/text.py +0 -141
  484. agno/knowledge/url.py +0 -46
  485. agno/knowledge/website.py +0 -179
  486. agno/knowledge/wikipedia.py +0 -32
  487. agno/knowledge/youtube.py +0 -35
  488. agno/memory/agent.py +0 -423
  489. agno/memory/classifier.py +0 -104
  490. agno/memory/db/__init__.py +0 -5
  491. agno/memory/db/base.py +0 -42
  492. agno/memory/db/mongodb.py +0 -189
  493. agno/memory/db/postgres.py +0 -203
  494. agno/memory/db/sqlite.py +0 -193
  495. agno/memory/memory.py +0 -22
  496. agno/memory/row.py +0 -36
  497. agno/memory/summarizer.py +0 -201
  498. agno/memory/summary.py +0 -19
  499. agno/memory/team.py +0 -415
  500. agno/memory/v2/__init__.py +0 -2
  501. agno/memory/v2/db/__init__.py +0 -1
  502. agno/memory/v2/db/base.py +0 -42
  503. agno/memory/v2/db/firestore.py +0 -339
  504. agno/memory/v2/db/mongodb.py +0 -196
  505. agno/memory/v2/db/postgres.py +0 -214
  506. agno/memory/v2/db/redis.py +0 -187
  507. agno/memory/v2/db/schema.py +0 -54
  508. agno/memory/v2/db/sqlite.py +0 -209
  509. agno/memory/v2/manager.py +0 -437
  510. agno/memory/v2/memory.py +0 -1097
  511. agno/memory/v2/schema.py +0 -55
  512. agno/memory/v2/summarizer.py +0 -215
  513. agno/memory/workflow.py +0 -38
  514. agno/models/ollama/tools.py +0 -430
  515. agno/models/qwen/__init__.py +0 -5
  516. agno/playground/__init__.py +0 -10
  517. agno/playground/deploy.py +0 -3
  518. agno/playground/playground.py +0 -3
  519. agno/playground/serve.py +0 -3
  520. agno/playground/settings.py +0 -3
  521. agno/reranker/__init__.py +0 -0
  522. agno/run/response.py +0 -467
  523. agno/run/v2/__init__.py +0 -0
  524. agno/run/v2/workflow.py +0 -567
  525. agno/storage/__init__.py +0 -0
  526. agno/storage/agent/__init__.py +0 -0
  527. agno/storage/agent/dynamodb.py +0 -1
  528. agno/storage/agent/json.py +0 -1
  529. agno/storage/agent/mongodb.py +0 -1
  530. agno/storage/agent/postgres.py +0 -1
  531. agno/storage/agent/singlestore.py +0 -1
  532. agno/storage/agent/sqlite.py +0 -1
  533. agno/storage/agent/yaml.py +0 -1
  534. agno/storage/base.py +0 -60
  535. agno/storage/dynamodb.py +0 -673
  536. agno/storage/firestore.py +0 -297
  537. agno/storage/gcs_json.py +0 -261
  538. agno/storage/in_memory.py +0 -234
  539. agno/storage/json.py +0 -237
  540. agno/storage/mongodb.py +0 -328
  541. agno/storage/mysql.py +0 -685
  542. agno/storage/postgres.py +0 -682
  543. agno/storage/redis.py +0 -336
  544. agno/storage/session/__init__.py +0 -16
  545. agno/storage/session/agent.py +0 -64
  546. agno/storage/session/team.py +0 -63
  547. agno/storage/session/v2/__init__.py +0 -5
  548. agno/storage/session/workflow.py +0 -61
  549. agno/storage/singlestore.py +0 -606
  550. agno/storage/sqlite.py +0 -646
  551. agno/storage/workflow/__init__.py +0 -0
  552. agno/storage/workflow/mongodb.py +0 -1
  553. agno/storage/workflow/postgres.py +0 -1
  554. agno/storage/workflow/sqlite.py +0 -1
  555. agno/storage/yaml.py +0 -241
  556. agno/tools/thinking.py +0 -73
  557. agno/utils/defaults.py +0 -57
  558. agno/utils/filesystem.py +0 -39
  559. agno/utils/git.py +0 -52
  560. agno/utils/json_io.py +0 -30
  561. agno/utils/load_env.py +0 -19
  562. agno/utils/py_io.py +0 -19
  563. agno/utils/pyproject.py +0 -18
  564. agno/utils/resource_filter.py +0 -31
  565. agno/workflow/v2/__init__.py +0 -21
  566. agno/workflow/v2/types.py +0 -357
  567. agno/workflow/v2/workflow.py +0 -3312
  568. agno/workspace/__init__.py +0 -0
  569. agno/workspace/config.py +0 -325
  570. agno/workspace/enums.py +0 -6
  571. agno/workspace/helpers.py +0 -52
  572. agno/workspace/operator.py +0 -757
  573. agno/workspace/settings.py +0 -158
  574. agno-1.8.1.dist-info/METADATA +0 -982
  575. agno-1.8.1.dist-info/RECORD +0 -566
  576. agno-1.8.1.dist-info/entry_points.txt +0 -3
  577. agno-1.8.1.dist-info/licenses/LICENSE +0 -375
  578. /agno/{app → db/migrations}/__init__.py +0 -0
  579. /agno/{app/playground/__init__.py → db/schemas/metrics.py} +0 -0
  580. /agno/{cli → integrations}/__init__.py +0 -0
  581. /agno/{cli/ws → knowledge/chunking}/__init__.py +0 -0
  582. /agno/{document/chunking → knowledge/remote_content}/__init__.py +0 -0
  583. /agno/{document/reader/gcs → knowledge/reranker}/__init__.py +0 -0
  584. /agno/{document/reader/s3 → os/interfaces}/__init__.py +0 -0
  585. /agno/{app → os/interfaces}/slack/security.py +0 -0
  586. /agno/{app → os/interfaces}/whatsapp/security.py +0 -0
  587. /agno/{file/local → utils/print_response}/__init__.py +0 -0
  588. /agno/{infra → vectordb/llamaindex}/__init__.py +0 -0
  589. {agno-1.8.1.dist-info → agno-2.0.0.dist-info}/WHEEL +0 -0
  590. {agno-1.8.1.dist-info → agno-2.0.0.dist-info}/top_level.txt +0 -0
agno/storage/postgres.py DELETED
@@ -1,682 +0,0 @@
1
- import time
2
- from typing import List, Literal, Optional
3
-
4
- from agno.storage.base import Storage
5
- from agno.storage.session import Session
6
- from agno.storage.session.agent import AgentSession
7
- from agno.storage.session.team import TeamSession
8
- from agno.storage.session.v2.workflow import WorkflowSession as WorkflowSessionV2
9
- from agno.storage.session.workflow import WorkflowSession
10
- from agno.utils.log import log_debug, log_info, log_warning, logger
11
-
12
- try:
13
- from sqlalchemy.dialects import postgresql
14
- from sqlalchemy.engine import Engine, create_engine
15
- from sqlalchemy.inspection import inspect
16
- from sqlalchemy.orm import scoped_session, sessionmaker
17
- from sqlalchemy.schema import Column, MetaData, Table
18
- from sqlalchemy.sql.expression import select, text
19
- from sqlalchemy.types import BigInteger, String
20
- except ImportError:
21
- raise ImportError("`sqlalchemy` not installed. Please install it using `pip install sqlalchemy`")
22
-
23
-
24
- class PostgresStorage(Storage):
25
- def __init__(
26
- self,
27
- table_name: str,
28
- schema: Optional[str] = "ai",
29
- db_url: Optional[str] = None,
30
- db_engine: Optional[Engine] = None,
31
- schema_version: int = 1,
32
- auto_upgrade_schema: bool = False,
33
- mode: Optional[Literal["agent", "team", "workflow", "workflow_v2"]] = "agent",
34
- ):
35
- """
36
- This class provides agent storage using a PostgreSQL table.
37
-
38
- The following order is used to determine the database connection:
39
- 1. Use the db_engine if provided
40
- 2. Use the db_url
41
- 3. Raise an error if neither is provided
42
-
43
- Args:
44
- table_name (str): Name of the table to store Agent sessions.
45
- schema (Optional[str]): The schema to use for the table. Defaults to "ai".
46
- db_url (Optional[str]): The database URL to connect to.
47
- db_engine (Optional[Engine]): The SQLAlchemy database engine to use.
48
- schema_version (int): Version of the schema. Defaults to 1.
49
- auto_upgrade_schema (bool): Whether to automatically upgrade the schema.
50
- mode (Optional[Literal["agent", "team", "workflow"]]): The mode of the storage.
51
- Raises:
52
- ValueError: If neither db_url nor db_engine is provided.
53
- """
54
- super().__init__(mode)
55
- _engine: Optional[Engine] = db_engine
56
- if _engine is None and db_url is not None:
57
- _engine = create_engine(db_url)
58
-
59
- if _engine is None:
60
- raise ValueError("Must provide either db_url or db_engine")
61
-
62
- # Database attributes
63
- self.table_name: str = table_name
64
- self.schema: Optional[str] = schema
65
- self.db_url: Optional[str] = db_url
66
- self.db_engine: Engine = _engine
67
- self.metadata: MetaData = MetaData(schema=self.schema)
68
- self.inspector = inspect(self.db_engine)
69
-
70
- # Table schema version
71
- self.schema_version: int = schema_version
72
- # Automatically upgrade schema if True
73
- self.auto_upgrade_schema: bool = auto_upgrade_schema
74
- self._schema_up_to_date: bool = False
75
-
76
- # Database session
77
- self.Session: scoped_session = scoped_session(sessionmaker(bind=self.db_engine))
78
- # Database table for storage
79
- self.table: Table = self.get_table()
80
- log_debug(f"Created PostgresStorage: '{self.schema}.{self.table_name}'")
81
-
82
- @property
83
- def mode(self) -> Literal["agent", "team", "workflow", "workflow_v2"]:
84
- """Get the mode of the storage."""
85
- return super().mode
86
-
87
- @mode.setter
88
- def mode(self, value: Optional[Literal["agent", "team", "workflow", "workflow_v2"]]) -> None:
89
- """Set the mode and refresh the table if mode changes."""
90
- super(PostgresStorage, type(self)).mode.fset(self, value) # type: ignore
91
- if value is not None:
92
- self.table = self.get_table()
93
-
94
- def get_table_v1(self) -> Table:
95
- """
96
- Define the table schema for version 1.
97
-
98
- Returns:
99
- Table: SQLAlchemy Table object representing the schema.
100
- """
101
- # Common columns for both agent and workflow modes
102
- common_columns = [
103
- Column("session_id", String, primary_key=True),
104
- Column("user_id", String, index=True),
105
- Column("memory", postgresql.JSONB),
106
- Column("session_data", postgresql.JSONB),
107
- Column("extra_data", postgresql.JSONB),
108
- Column("created_at", BigInteger, server_default=text("(extract(epoch from now()))::bigint")),
109
- Column("updated_at", BigInteger, server_onupdate=text("(extract(epoch from now()))::bigint")),
110
- ]
111
-
112
- # Mode-specific columns
113
- specific_columns = []
114
- if self.mode == "agent":
115
- specific_columns = [
116
- Column("agent_id", String, index=True),
117
- Column("team_session_id", String, index=True, nullable=True),
118
- Column("agent_data", postgresql.JSONB),
119
- ]
120
- elif self.mode == "team":
121
- specific_columns = [
122
- Column("team_id", String, index=True),
123
- Column("team_session_id", String, index=True, nullable=True),
124
- Column("team_data", postgresql.JSONB),
125
- ]
126
- elif self.mode == "workflow":
127
- specific_columns = [
128
- Column("workflow_id", String, index=True),
129
- Column("workflow_data", postgresql.JSONB),
130
- ]
131
- elif self.mode == "workflow_v2":
132
- specific_columns = [
133
- Column("workflow_id", String, index=True),
134
- Column("workflow_name", String, index=True),
135
- Column("workflow_data", postgresql.JSONB),
136
- Column("runs", postgresql.JSONB),
137
- ]
138
-
139
- # Create table with all columns
140
- table = Table(
141
- self.table_name,
142
- self.metadata,
143
- *common_columns,
144
- *specific_columns,
145
- extend_existing=True,
146
- schema=self.schema, # type: ignore
147
- )
148
-
149
- return table
150
-
151
- def get_table(self) -> Table:
152
- """
153
- Get the table schema based on the schema version.
154
-
155
- Returns:
156
- Table: SQLAlchemy Table object for the current schema version.
157
-
158
- Raises:
159
- ValueError: If an unsupported schema version is specified.
160
- """
161
- if self.schema_version == 1:
162
- return self.get_table_v1()
163
- else:
164
- raise ValueError(f"Unsupported schema version: {self.schema_version}")
165
-
166
- def table_exists(self) -> bool:
167
- """
168
- Check if the table exists in the database.
169
-
170
- Returns:
171
- bool: True if the table exists, False otherwise.
172
- """
173
- try:
174
- # Use a direct SQL query to check if the table exists
175
- with self.Session() as sess:
176
- if self.schema is not None:
177
- exists_query = text(
178
- "SELECT 1 FROM information_schema.tables WHERE table_schema = :schema AND table_name = :table"
179
- )
180
- exists = (
181
- sess.execute(exists_query, {"schema": self.schema, "table": self.table_name}).scalar()
182
- is not None
183
- )
184
- else:
185
- exists_query = text("SELECT 1 FROM information_schema.tables WHERE table_name = :table")
186
- exists = sess.execute(exists_query, {"table": self.table_name}).scalar() is not None
187
-
188
- log_debug(f"Table '{self.table.fullname}' does{' not ' if not exists else ' '}exist")
189
- return exists
190
-
191
- except Exception as e:
192
- logger.error(f"Error checking if table exists: {e}")
193
- return False
194
-
195
- def create(self) -> None:
196
- """
197
- Create the table if it does not exist.
198
- """
199
- self.table = self.get_table()
200
- if not self.table_exists():
201
- try:
202
- with self.Session() as sess, sess.begin():
203
- if self.schema is not None:
204
- log_debug(f"Creating schema: {self.schema}")
205
- sess.execute(text(f"CREATE SCHEMA IF NOT EXISTS {self.schema};"))
206
-
207
- log_debug(f"Creating table: {self.table_name}")
208
-
209
- # First create the table without indexes
210
- table_without_indexes = Table(
211
- self.table_name,
212
- MetaData(schema=self.schema),
213
- *[c.copy() for c in self.table.columns],
214
- schema=self.schema,
215
- )
216
- table_without_indexes.create(self.db_engine, checkfirst=True)
217
-
218
- # Then create each index individually with error handling
219
- for idx in self.table.indexes:
220
- try:
221
- idx_name = idx.name
222
- log_debug(f"Creating index: {idx_name}")
223
-
224
- # Check if index already exists
225
- with self.Session() as sess:
226
- if self.schema:
227
- exists_query = text(
228
- "SELECT 1 FROM pg_indexes WHERE schemaname = :schema AND indexname = :index_name"
229
- )
230
- exists = (
231
- sess.execute(exists_query, {"schema": self.schema, "index_name": idx_name}).scalar()
232
- is not None
233
- )
234
- else:
235
- exists_query = text("SELECT 1 FROM pg_indexes WHERE indexname = :index_name")
236
- exists = sess.execute(exists_query, {"index_name": idx_name}).scalar() is not None
237
-
238
- if not exists:
239
- idx.create(self.db_engine)
240
- else:
241
- log_debug(f"Index {idx_name} already exists, skipping creation")
242
-
243
- except Exception as e:
244
- # Log the error but continue with other indexes
245
- logger.warning(f"Error creating index {idx.name}: {e}")
246
-
247
- except Exception as e:
248
- logger.error(f"Could not create table: '{self.table.fullname}': {e}")
249
- raise
250
-
251
- def read(self, session_id: str, user_id: Optional[str] = None) -> Optional[Session]:
252
- """
253
- Read an Session from the database.
254
-
255
- Args:
256
- session_id (str): ID of the session to read.
257
- user_id (Optional[str]): User ID to filter by. Defaults to None.
258
-
259
- Returns:
260
- Optional[Session]: Session object if found, None otherwise.
261
- """
262
- try:
263
- with self.Session() as sess:
264
- stmt = select(self.table).where(self.table.c.session_id == session_id)
265
- if user_id:
266
- stmt = stmt.where(self.table.c.user_id == user_id)
267
- result = sess.execute(stmt).fetchone()
268
- if self.mode == "agent":
269
- return AgentSession.from_dict(result._mapping) if result is not None else None
270
- elif self.mode == "team":
271
- return TeamSession.from_dict(result._mapping) if result is not None else None
272
- elif self.mode == "workflow":
273
- return WorkflowSession.from_dict(result._mapping) if result is not None else None
274
- elif self.mode == "workflow_v2":
275
- return WorkflowSessionV2.from_dict(result._mapping) if result is not None else None
276
- except Exception as e:
277
- if "does not exist" in str(e):
278
- log_debug(f"Table does not exist: {self.table.name}")
279
- log_debug("Creating table for future transactions")
280
- self.create()
281
- else:
282
- log_debug(f"Exception reading from table: {e}")
283
- return None
284
-
285
- def get_all_session_ids(self, user_id: Optional[str] = None, entity_id: Optional[str] = None) -> List[str]:
286
- """
287
- Get all session IDs, optionally filtered by user_id and/or entity_id.
288
-
289
- Args:
290
- user_id (Optional[str]): The ID of the user to filter by.
291
- entity_id (Optional[str]): The ID of the agent / workflow to filter by.
292
-
293
- Returns:
294
- List[str]: List of session IDs matching the criteria.
295
- """
296
- try:
297
- with self.Session() as sess, sess.begin():
298
- # get all session_ids
299
- stmt = select(self.table.c.session_id)
300
- if user_id is not None:
301
- stmt = stmt.where(self.table.c.user_id == user_id)
302
- if entity_id is not None:
303
- if self.mode == "agent":
304
- stmt = stmt.where(self.table.c.agent_id == entity_id)
305
- elif self.mode == "team":
306
- stmt = stmt.where(self.table.c.team_id == entity_id)
307
- elif self.mode == "workflow":
308
- stmt = stmt.where(self.table.c.workflow_id == entity_id)
309
- elif self.mode == "workflow_v2":
310
- stmt = stmt.where(self.table.c.workflow_id == entity_id)
311
- # order by created_at desc
312
- stmt = stmt.order_by(self.table.c.created_at.desc())
313
- # execute query
314
- rows = sess.execute(stmt).fetchall()
315
- return [row[0] for row in rows] if rows is not None else []
316
- except Exception as e:
317
- log_debug(f"Exception reading from table: {e}")
318
- log_debug(f"Table does not exist: {self.table.name}")
319
- log_debug("Creating table for future transactions")
320
- self.create()
321
- return []
322
-
323
- def get_all_sessions(self, user_id: Optional[str] = None, entity_id: Optional[str] = None) -> List[Session]:
324
- """
325
- Get all sessions, optionally filtered by user_id and/or entity_id.
326
-
327
- Args:
328
- user_id (Optional[str]): The ID of the user to filter by.
329
- entity_id (Optional[str]): The ID of the agent / workflow to filter by.
330
-
331
- Returns:
332
- List[Session]: List of Session objects matching the criteria.
333
- """
334
- try:
335
- with self.Session() as sess, sess.begin():
336
- # get all sessions
337
- stmt = select(self.table)
338
- if user_id is not None:
339
- stmt = stmt.where(self.table.c.user_id == user_id)
340
- if entity_id is not None:
341
- if self.mode == "agent":
342
- stmt = stmt.where(self.table.c.agent_id == entity_id)
343
- elif self.mode == "team":
344
- stmt = stmt.where(self.table.c.team_id == entity_id)
345
- elif self.mode == "workflow":
346
- stmt = stmt.where(self.table.c.workflow_id == entity_id)
347
- elif self.mode == "workflow_v2":
348
- stmt = stmt.where(self.table.c.workflow_id == entity_id)
349
- # order by created_at desc
350
- stmt = stmt.order_by(self.table.c.created_at.desc())
351
- # execute query
352
- rows = sess.execute(stmt).fetchall()
353
- if rows is not None:
354
- if self.mode == "agent":
355
- return [AgentSession.from_dict(row._mapping) for row in rows] # type: ignore
356
- elif self.mode == "team":
357
- return [TeamSession.from_dict(row._mapping) for row in rows] # type: ignore
358
- else:
359
- return [WorkflowSession.from_dict(row._mapping) for row in rows] # type: ignore
360
- else:
361
- return []
362
- except Exception as e:
363
- log_debug(f"Exception reading from table: {e}")
364
- log_debug(f"Table does not exist: {self.table.name}")
365
- log_debug("Creating table for future transactions")
366
- self.create()
367
- return []
368
-
369
- def get_recent_sessions(
370
- self,
371
- user_id: Optional[str] = None,
372
- entity_id: Optional[str] = None,
373
- limit: Optional[int] = 2,
374
- ) -> List[Session]:
375
- """Get the last N sessions, ordered by created_at descending.
376
-
377
- Args:
378
- num_history_sessions: Number of most recent sessions to return
379
- user_id: Filter by user ID
380
- entity_id: Filter by entity ID (agent_id, team_id, or workflow_id)
381
-
382
- Returns:
383
- List[Session]: List of most recent sessions
384
- """
385
- try:
386
- with self.Session() as sess, sess.begin():
387
- # Build the base query
388
- stmt = select(self.table)
389
-
390
- # Add filters
391
- if user_id is not None:
392
- stmt = stmt.where(self.table.c.user_id == user_id)
393
- if entity_id is not None:
394
- if self.mode == "agent":
395
- stmt = stmt.where(self.table.c.agent_id == entity_id)
396
- elif self.mode == "team":
397
- stmt = stmt.where(self.table.c.team_id == entity_id)
398
- elif self.mode == "workflow":
399
- stmt = stmt.where(self.table.c.workflow_id == entity_id)
400
- elif self.mode == "workflow_v2":
401
- stmt = stmt.where(self.table.c.workflow_id == entity_id)
402
- # Order by created_at desc and limit results
403
- stmt = stmt.order_by(self.table.c.created_at.desc())
404
- if limit is not None:
405
- stmt = stmt.limit(limit)
406
-
407
- # Execute query
408
- rows = sess.execute(stmt).fetchall()
409
- if rows is not None:
410
- sessions: List[Session] = []
411
- for row in rows:
412
- session: Optional[Session] = None
413
- if self.mode == "agent":
414
- session = AgentSession.from_dict(row._mapping) # type: ignore
415
- elif self.mode == "team":
416
- session = TeamSession.from_dict(row._mapping) # type: ignore
417
- elif self.mode == "workflow":
418
- session = WorkflowSession.from_dict(row._mapping) # type: ignore
419
- elif self.mode == "workflow_v2":
420
- session = WorkflowSessionV2.from_dict(row._mapping) # type: ignore
421
- if session is not None:
422
- sessions.append(session)
423
- return sessions
424
- return []
425
-
426
- except Exception as e:
427
- if "does not exist" in str(e):
428
- log_debug(f"Table does not exist: {self.table.name}")
429
- log_debug("Creating table for future transactions")
430
- self.create()
431
- else:
432
- log_debug(f"Exception reading from table: {e}")
433
- return []
434
-
435
- def upgrade_schema(self) -> None:
436
- """
437
- Upgrade the schema to the latest version.
438
- Currently handles adding the team_session_id column for agent mode.
439
- """
440
- if not self.auto_upgrade_schema:
441
- log_debug("Auto schema upgrade disabled. Skipping upgrade.")
442
- return
443
-
444
- try:
445
- if self.mode == "agent" and self.table_exists():
446
- with self.Session() as sess:
447
- # Check if team_session_id column exists
448
- column_exists_query = text(
449
- """
450
- SELECT 1 FROM information_schema.columns
451
- WHERE table_schema = :schema AND table_name = :table
452
- AND column_name = 'team_session_id'
453
- """
454
- )
455
- column_exists = (
456
- sess.execute(column_exists_query, {"schema": self.schema, "table": self.table_name}).scalar()
457
- is not None
458
- )
459
-
460
- if not column_exists:
461
- log_info(f"Adding 'team_session_id' column to {self.schema}.{self.table_name}")
462
- alter_table_query = text(
463
- f"ALTER TABLE {self.schema}.{self.table_name} ADD COLUMN team_session_id TEXT"
464
- )
465
- sess.execute(alter_table_query)
466
- sess.commit()
467
- self._schema_up_to_date = True
468
- log_info("Schema upgrade completed successfully")
469
- except Exception as e:
470
- logger.error(f"Error during schema upgrade: {e}")
471
- raise
472
-
473
- def upsert(self, session: Session, create_and_retry: bool = True) -> Optional[Session]:
474
- """
475
- Insert or update an Session in the database.
476
-
477
- Args:
478
- session (Session): The session data to upsert.
479
- create_and_retry (bool): Retry upsert if table does not exist.
480
-
481
- Returns:
482
- Optional[Session]: The upserted Session, or None if operation failed.
483
- """
484
- # Perform schema upgrade if auto_upgrade_schema is enabled
485
- if self.auto_upgrade_schema and not self._schema_up_to_date:
486
- self.upgrade_schema()
487
-
488
- try:
489
- with self.Session() as sess, sess.begin():
490
- # Create an insert statement
491
- if self.mode == "agent":
492
- stmt = postgresql.insert(self.table).values(
493
- session_id=session.session_id,
494
- agent_id=session.agent_id, # type: ignore
495
- team_session_id=session.team_session_id, # type: ignore
496
- user_id=session.user_id,
497
- memory=getattr(session, "memory", None),
498
- agent_data=session.agent_data, # type: ignore
499
- session_data=session.session_data,
500
- extra_data=session.extra_data,
501
- )
502
- # Define the upsert if the session_id already exists
503
- # See: https://docs.sqlalchemy.org/en/20/dialects/postgresql.html#postgresql-insert-on-conflict
504
- stmt = stmt.on_conflict_do_update(
505
- index_elements=["session_id"],
506
- set_=dict(
507
- agent_id=session.agent_id, # type: ignore
508
- team_session_id=session.team_session_id, # type: ignore
509
- user_id=session.user_id,
510
- memory=getattr(session, "memory", None),
511
- agent_data=session.agent_data, # type: ignore
512
- session_data=session.session_data,
513
- extra_data=session.extra_data,
514
- updated_at=int(time.time()),
515
- ), # The updated value for each column
516
- )
517
- elif self.mode == "team":
518
- stmt = postgresql.insert(self.table).values(
519
- session_id=session.session_id,
520
- team_id=session.team_id, # type: ignore
521
- user_id=session.user_id,
522
- team_session_id=session.team_session_id, # type: ignore
523
- memory=getattr(session, "memory", None),
524
- team_data=session.team_data, # type: ignore
525
- session_data=session.session_data,
526
- extra_data=session.extra_data,
527
- )
528
- # Define the upsert if the session_id already exists
529
- # See: https://docs.sqlalchemy.org/en/20/dialects/postgresql.html#postgresql-insert-on-conflict
530
- stmt = stmt.on_conflict_do_update(
531
- index_elements=["session_id"],
532
- set_=dict(
533
- team_id=session.team_id, # type: ignore
534
- user_id=session.user_id,
535
- team_session_id=session.team_session_id, # type: ignore
536
- memory=getattr(session, "memory", None),
537
- team_data=session.team_data, # type: ignore
538
- session_data=session.session_data,
539
- extra_data=session.extra_data,
540
- updated_at=int(time.time()),
541
- ), # The updated value for each column
542
- )
543
- elif self.mode == "workflow":
544
- stmt = postgresql.insert(self.table).values(
545
- session_id=session.session_id,
546
- workflow_id=session.workflow_id, # type: ignore
547
- user_id=session.user_id,
548
- memory=getattr(session, "memory", None),
549
- workflow_data=session.workflow_data, # type: ignore
550
- session_data=session.session_data,
551
- extra_data=session.extra_data,
552
- )
553
- # Define the upsert if the session_id already exists
554
- # See: https://docs.sqlalchemy.org/en/20/dialects/postgresql.html#postgresql-insert-on-conflict
555
- stmt = stmt.on_conflict_do_update(
556
- index_elements=["session_id"],
557
- set_=dict(
558
- workflow_id=session.workflow_id, # type: ignore
559
- user_id=session.user_id,
560
- memory=getattr(session, "memory", None),
561
- workflow_data=session.workflow_data, # type: ignore
562
- session_data=session.session_data,
563
- extra_data=session.extra_data,
564
- updated_at=int(time.time()),
565
- ), # The updated value for each column
566
- )
567
- elif self.mode == "workflow_v2":
568
- # Convert session to dict to ensure proper serialization
569
- session_dict = session.to_dict()
570
-
571
- stmt = postgresql.insert(self.table).values(
572
- session_id=session.session_id,
573
- workflow_id=session.workflow_id, # type: ignore
574
- user_id=session.user_id,
575
- runs=session_dict.get("runs"),
576
- workflow_name=session.workflow_name, # type: ignore
577
- workflow_data=session.workflow_data, # type: ignore
578
- session_data=session.session_data,
579
- extra_data=session.extra_data,
580
- )
581
- # Define the upsert if the session_id already exists
582
- # See: https://docs.sqlalchemy.org/en/20/dialects/postgresql.html#postgresql-insert-on-conflict
583
- stmt = stmt.on_conflict_do_update(
584
- index_elements=["session_id"],
585
- set_=dict(
586
- workflow_id=session.workflow_id, # type: ignore
587
- user_id=session.user_id,
588
- runs=session_dict.get("runs"),
589
- workflow_name=session.workflow_name, # type: ignore
590
- workflow_data=session.workflow_data, # type: ignore
591
- session_data=session.session_data,
592
- extra_data=session.extra_data,
593
- updated_at=int(time.time()),
594
- ),
595
- )
596
-
597
- sess.execute(stmt)
598
- except Exception as e:
599
- if create_and_retry and not self.table_exists():
600
- log_debug(f"Table does not exist: {self.table.name}")
601
- log_debug("Creating table and retrying upsert")
602
- self.create()
603
- return self.upsert(session, create_and_retry=False)
604
- else:
605
- log_warning(f"Exception upserting into table: {e}")
606
- log_warning(
607
- "A table upgrade might be required, please review these docs for more information: https://agno.link/upgrade-schema"
608
- )
609
- return None
610
- return self.read(session_id=session.session_id)
611
-
612
- def delete_session(self, session_id: Optional[str] = None):
613
- """
614
- Delete a session from the database.
615
-
616
- Args:
617
- session_id (Optional[str], optional): ID of the session to delete. Defaults to None.
618
-
619
- Raises:
620
- Exception: If an error occurs during deletion.
621
- """
622
- if session_id is None:
623
- logger.warning("No session_id provided for deletion.")
624
- return
625
-
626
- try:
627
- with self.Session() as sess, sess.begin():
628
- # Delete the session with the given session_id
629
- delete_stmt = self.table.delete().where(self.table.c.session_id == session_id)
630
- result = sess.execute(delete_stmt)
631
- if result.rowcount == 0:
632
- log_debug(f"No session found with session_id: {session_id}")
633
- else:
634
- log_debug(f"Successfully deleted session with session_id: {session_id}")
635
- except Exception as e:
636
- logger.error(f"Error deleting session: {e}")
637
-
638
- def drop(self) -> None:
639
- """
640
- Drop the table from the database if it exists.
641
- """
642
- if self.table_exists():
643
- log_debug(f"Deleting table: {self.table_name}")
644
- # Drop with checkfirst=True to avoid errors if the table doesn't exist
645
- self.table.drop(self.db_engine, checkfirst=True)
646
- # Clear metadata to ensure indexes are recreated properly
647
- self.metadata = MetaData(schema=self.schema)
648
- self.table = self.get_table()
649
-
650
- def __deepcopy__(self, memo):
651
- """
652
- Create a deep copy of the PostgresStorage instance, handling unpickleable attributes.
653
-
654
- Args:
655
- memo (dict): A dictionary of objects already copied during the current copying pass.
656
-
657
- Returns:
658
- PostgresStorage: A deep-copied instance of PostgresStorage.
659
- """
660
- from copy import deepcopy
661
-
662
- # Create a new instance without calling __init__
663
- cls = self.__class__
664
- copied_obj = cls.__new__(cls)
665
- memo[id(self)] = copied_obj
666
-
667
- # Deep copy attributes
668
- for k, v in self.__dict__.items():
669
- if k in {"metadata", "table", "inspector"}:
670
- continue
671
- # Reuse db_engine and Session without copying
672
- elif k in {"db_engine", "SqlSession"}:
673
- setattr(copied_obj, k, v)
674
- else:
675
- setattr(copied_obj, k, deepcopy(v, memo))
676
-
677
- # Recreate metadata and table for the copied instance
678
- copied_obj.metadata = MetaData(schema=copied_obj.schema)
679
- copied_obj.inspector = inspect(copied_obj.db_engine)
680
- copied_obj.table = copied_obj.get_table()
681
-
682
- return copied_obj