@cogitator-ai/core 0.17.2 → 0.18.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 (79) hide show
  1. package/README.md +1 -1
  2. package/dist/agent-tool.d.ts +1 -1
  3. package/dist/agent-tool.d.ts.map +1 -1
  4. package/dist/cogitator/tool-executor.js +1 -1
  5. package/dist/cogitator/tool-executor.js.map +1 -1
  6. package/dist/cogitator.d.ts +1 -210
  7. package/dist/cogitator.d.ts.map +1 -1
  8. package/dist/cogitator.js +1 -585
  9. package/dist/cogitator.js.map +1 -1
  10. package/dist/cost-routing/model-selector.js +1 -1
  11. package/dist/index.d.ts +2 -2
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +2 -2
  14. package/dist/index.js.map +1 -1
  15. package/dist/llm/azure.d.ts.map +1 -1
  16. package/dist/llm/azure.js +3 -1
  17. package/dist/llm/azure.js.map +1 -1
  18. package/dist/llm/bedrock.d.ts.map +1 -1
  19. package/dist/llm/bedrock.js +8 -5
  20. package/dist/llm/bedrock.js.map +1 -1
  21. package/dist/llm/google.d.ts.map +1 -1
  22. package/dist/llm/google.js +3 -0
  23. package/dist/llm/google.js.map +1 -1
  24. package/dist/llm/index.d.ts.map +1 -1
  25. package/dist/llm/index.js +1 -0
  26. package/dist/llm/index.js.map +1 -1
  27. package/dist/llm/ollama.d.ts +3 -0
  28. package/dist/llm/ollama.d.ts.map +1 -1
  29. package/dist/llm/ollama.js +14 -2
  30. package/dist/llm/ollama.js.map +1 -1
  31. package/dist/llm/openai.d.ts.map +1 -1
  32. package/dist/llm/openai.js +3 -1
  33. package/dist/llm/openai.js.map +1 -1
  34. package/dist/reasoning/thought-tree.d.ts +1 -1
  35. package/dist/reasoning/thought-tree.d.ts.map +1 -1
  36. package/dist/runtime.d.ts +216 -0
  37. package/dist/runtime.d.ts.map +1 -0
  38. package/dist/runtime.js +593 -0
  39. package/dist/runtime.js.map +1 -0
  40. package/dist/time-travel/forker.d.ts +1 -1
  41. package/dist/time-travel/forker.d.ts.map +1 -1
  42. package/dist/time-travel/replayer.d.ts +1 -1
  43. package/dist/time-travel/replayer.d.ts.map +1 -1
  44. package/dist/time-travel/time-travel.d.ts +1 -1
  45. package/dist/time-travel/time-travel.d.ts.map +1 -1
  46. package/dist/tool.d.ts.map +1 -1
  47. package/dist/tool.js +4 -4
  48. package/dist/tool.js.map +1 -1
  49. package/dist/tools/audio-generate.d.ts +2 -2
  50. package/dist/tools/audio-transcribe.d.ts +1 -1
  51. package/dist/tools/datetime.d.ts +1 -1
  52. package/dist/tools/email.d.ts +2 -2
  53. package/dist/tools/exec.d.ts +1 -1
  54. package/dist/tools/exec.js +1 -1
  55. package/dist/tools/exec.js.map +1 -1
  56. package/dist/tools/github.d.ts +3 -3
  57. package/dist/tools/hash.d.ts +3 -3
  58. package/dist/tools/http.d.ts +2 -2
  59. package/dist/tools/http.d.ts.map +1 -1
  60. package/dist/tools/http.js +4 -1
  61. package/dist/tools/http.js.map +1 -1
  62. package/dist/tools/image-analyze.d.ts +15 -28
  63. package/dist/tools/image-analyze.d.ts.map +1 -1
  64. package/dist/tools/image-generate.d.ts +14 -14
  65. package/dist/tools/image-generate.d.ts.map +1 -1
  66. package/dist/tools/index.d.ts +19 -19
  67. package/dist/tools/json.d.ts +1 -1
  68. package/dist/tools/sql-query.d.ts +1 -1
  69. package/dist/tools/vector-search.d.ts +3 -3
  70. package/dist/tools/vector-search.d.ts.map +1 -1
  71. package/dist/tools/vector-search.js +4 -1
  72. package/dist/tools/vector-search.js.map +1 -1
  73. package/dist/tools/web-scrape.d.ts +2 -2
  74. package/dist/utils/audio-fetch.js +1 -1
  75. package/dist/utils/audio-fetch.js.map +1 -1
  76. package/dist/utils/image-fetch.js +1 -1
  77. package/dist/utils/image-fetch.js.map +1 -1
  78. package/package.json +26 -26
  79. package/LICENSE +0 -21
package/README.md CHANGED
@@ -63,7 +63,7 @@ console.log(result.output);
63
63
 
64
64
  ```typescript
65
65
  // Ollama (local, default)
66
- const cog = new Cogitator({ defaultModel: 'ollama/llama3.3:8b' });
66
+ const cog = new Cogitator({ defaultModel: 'ollama/llama3.1:8b' });
67
67
 
68
68
  // OpenAI
69
69
  const cog = new Cogitator({ defaultModel: 'openai/gpt-4o' });
@@ -1,6 +1,6 @@
1
1
  import type { Tool } from '@cogitator-ai/types';
2
2
  import type { Agent } from './agent';
3
- import type { Cogitator } from './cogitator';
3
+ import type { Cogitator } from './runtime';
4
4
  export interface AgentAsToolOptions {
5
5
  name: string;
6
6
  description: string;
@@ -1 +1 @@
1
- {"version":3,"file":"agent-tool.d.ts","sourceRoot":"","sources":["../src/agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACzD;AAMD,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,eAAe,CAAC,CAuCzC"}
1
+ {"version":3,"file":"agent-tool.d.ts","sourceRoot":"","sources":["../src/agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAI3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACzD;AAMD,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,eAAe,CAAC,CAuCzC"}
@@ -138,7 +138,7 @@ async function executeInSandbox(tool, toolCall, runId, agentId, sandboxManager,
138
138
  export function createToolMessage(toolCall, result) {
139
139
  return {
140
140
  role: 'tool',
141
- content: JSON.stringify(result.result),
141
+ content: JSON.stringify(result.result ?? null),
142
142
  toolCallId: toolCall.id,
143
143
  name: toolCall.name,
144
144
  };
@@ -1 +1 @@
1
- {"version":3,"file":"tool-executor.js","sourceRoot":"","sources":["../../src/cogitator/tool-executor.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tool-executor.js","sourceRoot":"","sources":["../../src/cogitator/tool-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAsB,EACtB,QAAkB,EAClB,KAAa,EACb,OAAe,EACf,cAA0C,EAC1C,gBAA8C,EAC9C,eAAwB,EACxB,iBAAsC,EACtC,MAAoB;IAEpB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,mBAAmB,QAAQ,CAAC,IAAI,EAAE;SAC1C,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,sBAAsB,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE;SACzD,CAAC;IACJ,CAAC;IAED,IAAI,gBAAgB,IAAI,eAAe,EAAE,CAAC;QACxC,MAAM,OAAO,GAAgB;YAC3B,OAAO;YACP,KAAK;YACL,MAAM,EAAE,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;SAC/C,CAAC;QACF,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACxF,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC1B,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,iBAAiB,WAAW,CAAC,MAAM,IAAI,kBAAkB,EAAE;aACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;QACrE,OAAO,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,OAAO,GAAgB;QAC3B,OAAO;QACP,KAAK;QACL,MAAM,EAAE,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;KAC/C,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,IAAU,EACV,QAAkB,EAClB,KAAa,EACb,OAAe,EACf,cAA0C,EAC1C,iBAAsC;IAEtC,MAAM,iBAAiB,EAAE,CAAC;IAE1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,SAAS,EAAE,CAAC,IAAI,CAAC,yCAAyC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACjF,MAAM,OAAO,GAAgB;YAC3B,OAAO;YACP,KAAK;YACL,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;SACrC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC/D,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC;IAChC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAQ,CAAC;IAEpC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,KAAK,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM;QACpB,CAAC,CAAC;YACE,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB;QACH,CAAC,CAAC;YACE,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACjD,GAAG,EAAE,IAAI,CAAC,GAAyB;YACnC,GAAG,EAAE,IAAI,CAAC,GAAyC;YACnD,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IAEN,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAEpE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAK,CAAC,MAAM,CAAC,CAAC;YAC/C,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,MAAM,CAAC,IAAK,CAAC,MAAM;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,EAAE;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC,IAAK,CAAC,MAAM;YAC3B,MAAM,EAAE,MAAM,CAAC,IAAK,CAAC,MAAM;YAC3B,QAAQ,EAAE,MAAM,CAAC,IAAK,CAAC,QAAQ;YAC/B,QAAQ,EAAE,MAAM,CAAC,IAAK,CAAC,QAAQ;YAC/B,QAAQ,EAAE,MAAM,CAAC,IAAK,CAAC,QAAQ;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkB,EAAE,MAAkB;IACtE,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;QAC9C,UAAU,EAAE,QAAQ,CAAC,EAAE;QACvB,IAAI,EAAE,QAAQ,CAAC,IAAI;KACpB,CAAC;AACJ,CAAC"}
@@ -1,211 +1,2 @@
1
- import type { CogitatorConfig, RunOptions, RunResult, Constitution, CostSummary, CostEstimate, EstimateOptions } from '@cogitator-ai/types';
2
- import { type Agent } from './agent';
3
- import { ToolRegistry } from './registry';
4
- /**
5
- * Main runtime for executing AI agents.
6
- *
7
- * Cogitator orchestrates agent execution with support for:
8
- * - Multiple LLM providers (OpenAI, Anthropic, Ollama, Google, Azure, etc.)
9
- * - Memory persistence (Redis, PostgreSQL, in-memory)
10
- * - Sandboxed tool execution (Docker, WASM)
11
- * - Reflection and learning from past runs
12
- * - Constitutional AI guardrails
13
- * - Cost-aware model routing
14
- *
15
- * @example Basic usage
16
- * ```ts
17
- * import { Cogitator, Agent } from '@cogitator-ai/core';
18
- *
19
- * const cog = new Cogitator({
20
- * llm: { defaultProvider: 'anthropic' },
21
- * });
22
- *
23
- * const agent = new Agent({
24
- * name: 'assistant',
25
- * model: 'anthropic/claude-sonnet-4-20250514',
26
- * instructions: 'You are a helpful assistant.',
27
- * });
28
- *
29
- * const result = await cog.run(agent, { input: 'Hello!' });
30
- * console.log(result.output);
31
- *
32
- * await cog.close();
33
- * ```
34
- *
35
- * @example With memory and streaming
36
- * ```ts
37
- * const cog = new Cogitator({
38
- * memory: {
39
- * adapter: 'redis',
40
- * redis: { url: 'redis://localhost:6379' },
41
- * },
42
- * });
43
- *
44
- * const result = await cog.run(agent, {
45
- * input: 'Remember my name is Alice',
46
- * threadId: 'conversation-123',
47
- * stream: true,
48
- * onToken: (token) => process.stdout.write(token),
49
- * });
50
- * ```
51
- */
52
- export declare class Cogitator {
53
- private config;
54
- private backends;
55
- /** Global tool registry shared across all runs */
56
- readonly tools: ToolRegistry;
57
- private state;
58
- private costEstimator?;
59
- /**
60
- * Create a new Cogitator runtime.
61
- *
62
- * @param config - Runtime configuration
63
- * @param config.llm - LLM provider settings (API keys, base URLs)
64
- * @param config.memory - Memory adapter configuration
65
- * @param config.sandbox - Sandbox execution settings
66
- * @param config.reflection - Reflection engine settings
67
- * @param config.guardrails - Constitutional AI settings
68
- * @param config.costRouting - Cost-aware routing settings
69
- */
70
- constructor(config?: CogitatorConfig);
71
- /**
72
- * Run an agent with the given input.
73
- *
74
- * Executes the agent's task, handling LLM calls, tool execution,
75
- * memory persistence, and observability callbacks.
76
- *
77
- * @param agent - Agent to execute
78
- * @param options - Run configuration
79
- * @param options.input - User input/prompt for the agent
80
- * @param options.threadId - Thread ID for memory persistence
81
- * @param options.context - Additional context to include in system prompt
82
- * @param options.stream - Enable streaming responses
83
- * @param options.onToken - Callback for each streamed token
84
- * @param options.onToolCall - Callback when a tool is called
85
- * @param options.onToolResult - Callback when a tool returns a result
86
- * @param options.onSpan - Callback for observability spans
87
- * @param options.timeout - Override agent timeout
88
- * @returns Run result with output, usage stats, and trace
89
- *
90
- * @example
91
- * ```ts
92
- * const result = await cog.run(agent, {
93
- * input: 'Search for TypeScript tutorials',
94
- * threadId: 'session-123',
95
- * stream: true,
96
- * onToken: (token) => process.stdout.write(token),
97
- * onToolCall: (call) => console.log('Tool:', call.name),
98
- * });
99
- *
100
- * console.log('Output:', result.output);
101
- * console.log('Tokens:', result.usage.totalTokens);
102
- * console.log('Cost:', result.usage.cost);
103
- * ```
104
- */
105
- run(agent: Agent, options: RunOptions): Promise<RunResult>;
106
- private initializeAll;
107
- private getBackend;
108
- private calculateCost;
109
- /**
110
- * Get accumulated insights from reflection for an agent.
111
- *
112
- * Insights are learnings derived from past runs that can help
113
- * improve future agent performance.
114
- *
115
- * @param agentId - ID of the agent to get insights for
116
- * @returns Array of insights, empty if reflection is not enabled
117
- */
118
- getInsights(agentId: string): Promise<import("@cogitator-ai/types").Insight[]>;
119
- /**
120
- * Get reflection summary for an agent.
121
- *
122
- * Summary includes statistics about total runs, successful tool calls,
123
- * common patterns, and accumulated learnings.
124
- *
125
- * @param agentId - ID of the agent to get summary for
126
- * @returns Reflection summary, null if reflection is not enabled
127
- */
128
- getReflectionSummary(agentId: string): Promise<import("@cogitator-ai/types").ReflectionSummary | null>;
129
- /**
130
- * Get the constitutional AI guardrails instance.
131
- *
132
- * @returns ConstitutionalAI instance, undefined if guardrails not enabled
133
- */
134
- getGuardrails(): import("./constitutional").ConstitutionalAI | undefined;
135
- /**
136
- * Set or update the constitution for guardrails.
137
- *
138
- * The constitution defines principles and rules that the agent
139
- * must follow, filtering both input and output.
140
- *
141
- * @param constitution - New constitution to apply
142
- */
143
- setConstitution(constitution: Constitution): void;
144
- /**
145
- * Get cost tracking summary across all runs.
146
- *
147
- * @returns Cost summary with total spent, runs count, and per-model breakdown
148
- */
149
- getCostSummary(): CostSummary | undefined;
150
- /**
151
- * Get the cost-aware router instance for advanced cost management.
152
- *
153
- * @returns CostAwareRouter instance, undefined if cost routing not enabled
154
- */
155
- getCostRouter(): import("./cost-routing").CostAwareRouter | undefined;
156
- /**
157
- * Estimate the cost of running an agent before execution.
158
- *
159
- * Returns min/max/expected cost estimates based on:
160
- * - Model pricing (from registry)
161
- * - Task complexity analysis
162
- * - Tool usage patterns
163
- * - Estimated iterations
164
- *
165
- * @param params - Estimation parameters
166
- * @param params.agent - Agent to estimate cost for
167
- * @param params.input - User input/prompt
168
- * @param params.options - Optional estimation overrides
169
- * @returns Cost estimate with breakdown and confidence score
170
- *
171
- * @example
172
- * ```ts
173
- * const estimate = await cog.estimateCost({
174
- * agent,
175
- * input: 'Analyze this document and summarize key points',
176
- * options: { assumeIterations: 3, assumeToolCalls: 5 }
177
- * });
178
- *
179
- * console.log(`Expected cost: $${estimate.expectedCost.toFixed(4)}`);
180
- * console.log(`Confidence: ${(estimate.confidence * 100).toFixed(0)}%`);
181
- *
182
- * if (estimate.expectedCost > 0.10) {
183
- * console.log('Warning: This may be an expensive operation');
184
- * }
185
- * ```
186
- */
187
- estimateCost(params: {
188
- agent: Agent;
189
- input: string;
190
- options?: EstimateOptions;
191
- }): Promise<CostEstimate>;
192
- /**
193
- * Close all connections and release resources.
194
- *
195
- * Should be called when done using the Cogitator instance to properly
196
- * disconnect from memory adapters, shut down sandbox containers, and
197
- * clean up internal state.
198
- *
199
- * @example
200
- * ```ts
201
- * const cog = new Cogitator({ ... });
202
- * try {
203
- * await cog.run(agent, { input: 'Hello' });
204
- * } finally {
205
- * await cog.close();
206
- * }
207
- * ```
208
- */
209
- close(): Promise<void>;
210
- }
1
+ export { Cogitator } from './runtime';
211
2
  //# sourceMappingURL=cogitator.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"cogitator.d.ts","sourceRoot":"","sources":["../src/cogitator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,SAAS,EAST,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0B1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAsC;IACtD,kDAAkD;IAClD,SAAgB,KAAK,EAAE,YAAY,CAAsB;IAEzD,OAAO,CAAC,KAAK,CAQX;IAEF,OAAO,CAAC,aAAa,CAAC,CAAgB;IAEtC;;;;;;;;;;OAUG;gBACS,MAAM,GAAE,eAAoB;IAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;YAoclD,aAAa;IA0B3B,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,aAAa;IAWrB;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM;IAKjC;;;;;;;;OAQG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM;IAK1C;;;;OAIG;IACH,aAAa;IAIb;;;;;;;OAOG;IACH,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAIjD;;;;OAIG;IACH,cAAc,IAAI,WAAW,GAAG,SAAS;IAIzC;;;;OAIG;IACH,aAAa;IAIb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,eAAe,CAAC;KAC3B,GAAG,OAAO,CAAC,YAAY,CAAC;IAOzB;;;;;;;;;;;;;;;;OAgBG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}
1
+ {"version":3,"file":"cogitator.d.ts","sourceRoot":"","sources":["../src/cogitator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}