@amplitude/ai 0.1.1 → 0.2.0

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 (75) hide show
  1. package/AGENTS.md +3 -1
  2. package/README.md +44 -15
  3. package/dist/client.d.ts.map +1 -1
  4. package/dist/client.js +2 -1
  5. package/dist/client.js.map +1 -1
  6. package/dist/index.d.ts +2 -2
  7. package/dist/index.js +2 -2
  8. package/dist/integrations/anthropic-tools.js +2 -1
  9. package/dist/integrations/anthropic-tools.js.map +1 -1
  10. package/dist/integrations/langchain.d.ts.map +1 -1
  11. package/dist/integrations/langchain.js +35 -5
  12. package/dist/integrations/langchain.js.map +1 -1
  13. package/dist/integrations/llamaindex.d.ts.map +1 -1
  14. package/dist/integrations/llamaindex.js +27 -4
  15. package/dist/integrations/llamaindex.js.map +1 -1
  16. package/dist/integrations/openai-agents.js +5 -1
  17. package/dist/integrations/openai-agents.js.map +1 -1
  18. package/dist/integrations/opentelemetry.d.ts.map +1 -1
  19. package/dist/integrations/opentelemetry.js +2 -1
  20. package/dist/integrations/opentelemetry.js.map +1 -1
  21. package/dist/mcp/patterns.d.ts.map +1 -1
  22. package/dist/mcp/patterns.js +6 -0
  23. package/dist/mcp/patterns.js.map +1 -1
  24. package/dist/mcp/server.d.ts.map +1 -1
  25. package/dist/mcp/validate-file.js +1 -1
  26. package/dist/mcp/validate-file.js.map +1 -1
  27. package/dist/patching.d.ts.map +1 -1
  28. package/dist/patching.js +7 -1
  29. package/dist/patching.js.map +1 -1
  30. package/dist/providers/anthropic.d.ts.map +1 -1
  31. package/dist/providers/anthropic.js +11 -20
  32. package/dist/providers/anthropic.js.map +1 -1
  33. package/dist/providers/azure-openai.d.ts +3 -3
  34. package/dist/providers/azure-openai.d.ts.map +1 -1
  35. package/dist/providers/azure-openai.js +2 -2
  36. package/dist/providers/azure-openai.js.map +1 -1
  37. package/dist/providers/base.d.ts +11 -2
  38. package/dist/providers/base.d.ts.map +1 -1
  39. package/dist/providers/base.js +32 -14
  40. package/dist/providers/base.js.map +1 -1
  41. package/dist/providers/bedrock.d.ts.map +1 -1
  42. package/dist/providers/bedrock.js +16 -29
  43. package/dist/providers/bedrock.js.map +1 -1
  44. package/dist/providers/gemini.d.ts.map +1 -1
  45. package/dist/providers/gemini.js +12 -29
  46. package/dist/providers/gemini.js.map +1 -1
  47. package/dist/providers/mistral.d.ts.map +1 -1
  48. package/dist/providers/mistral.js +24 -26
  49. package/dist/providers/mistral.js.map +1 -1
  50. package/dist/providers/openai.d.ts.map +1 -1
  51. package/dist/providers/openai.js +37 -45
  52. package/dist/providers/openai.js.map +1 -1
  53. package/dist/session.d.ts +23 -0
  54. package/dist/session.d.ts.map +1 -1
  55. package/dist/session.js +44 -1
  56. package/dist/session.js.map +1 -1
  57. package/dist/types.d.ts +3 -0
  58. package/dist/types.d.ts.map +1 -1
  59. package/dist/types.js.map +1 -1
  60. package/dist/utils/costs.d.ts +46 -5
  61. package/dist/utils/costs.d.ts.map +1 -1
  62. package/dist/utils/costs.js +115 -26
  63. package/dist/utils/costs.js.map +1 -1
  64. package/dist/utils/providers.d.ts +6 -1
  65. package/dist/utils/providers.d.ts.map +1 -1
  66. package/dist/utils/providers.js +9 -3
  67. package/dist/utils/providers.js.map +1 -1
  68. package/dist/utils/streaming.d.ts +2 -0
  69. package/dist/utils/streaming.d.ts.map +1 -1
  70. package/dist/utils/streaming.js +10 -0
  71. package/dist/utils/streaming.js.map +1 -1
  72. package/llms-full.txt +17 -1
  73. package/llms.txt +1 -1
  74. package/mcp.schema.json +1 -1
  75. package/package.json +1 -1
package/llms-full.txt CHANGED
@@ -1,5 +1,5 @@
1
1
  # llms-full.txt
2
- # @amplitude/ai 0.1.1 — Detailed API Reference for LLM Agents
2
+ # @amplitude/ai 0.2.0 — Detailed API Reference for LLM Agents
3
3
  # Use this file for instrumentation guidance. See llms.txt for discovery.
4
4
 
5
5
  ## Core API
@@ -29,8 +29,10 @@ wrap(azureClient, ai) → AzureOpenAI wrapper
29
29
  Create a bound agent for user/session lineage.
30
30
  ```
31
31
  const agent = ai.agent('my-agent', { userId: 'u1' })
32
+ const child = agent.child('sub-agent')
32
33
  const session = agent.session({ sessionId: 's1' })
33
34
  await session.run(async (s) => { ... })
35
+ await s.runAs(child, async (cs) => { ... }) // delegate to child agent
34
36
  ```
35
37
 
36
38
  ### tool(fn, options) / tool(options)(fn)
@@ -103,6 +105,20 @@ import { createAmplitudeAIMiddleware } from '@amplitude/ai';
103
105
  app.use(createAmplitudeAIMiddleware());
104
106
  ```
105
107
 
108
+ ### 6. Multi-agent orchestration with session.runAs()
109
+ ```typescript
110
+ const orchestrator = ai.agent('orchestrator', { userId: 'u1' });
111
+ const researcher = orchestrator.child('researcher');
112
+ const session = orchestrator.session({ sessionId: 's1' });
113
+ await session.run(async (s) => {
114
+ // Provider calls inside runAs are automatically tagged with the child's agentId
115
+ const result = await s.runAs(researcher, async (cs) => {
116
+ return openai.chat.completions.create({ model: 'gpt-4o', messages: [...] });
117
+ });
118
+ });
119
+ // runAs shares sessionId, traceId, turn counter; does NOT emit Session End
120
+ ```
121
+
106
122
  ## MCP Tools
107
123
 
108
124
  - `get_event_schema(event_type?)` — Return event schema and property definitions
package/llms.txt CHANGED
@@ -1,7 +1,7 @@
1
1
  <!-- GENERATED FILE: do not edit manually -->
2
2
  # llms.txt
3
3
  package=@amplitude/ai
4
- version=0.1.1
4
+ version=0.2.0
5
5
 
6
6
  [mcp.tools]
7
7
  get_event_schema
package/mcp.schema.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "generated": true,
3
3
  "package": "@amplitude/ai",
4
- "version": "0.1.1",
4
+ "version": "0.2.0",
5
5
  "prompt": "instrument_app",
6
6
  "tools": [
7
7
  "get_event_schema",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@amplitude/ai",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
4
4
  "private": false,
5
5
  "description": "Amplitude AI SDK - LLM usage tracking for Amplitude Analytics",
6
6
  "keywords": [