fourmis-agents-sdk 0.1.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 (105) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +309 -0
  3. package/dist/agent-loop.d.ts +36 -0
  4. package/dist/agent-loop.d.ts.map +1 -0
  5. package/dist/agent-loop.js +387 -0
  6. package/dist/agents/index.d.ts +8 -0
  7. package/dist/agents/index.d.ts.map +1 -0
  8. package/dist/agents/index.js +2309 -0
  9. package/dist/agents/task-manager.d.ts +14 -0
  10. package/dist/agents/task-manager.d.ts.map +1 -0
  11. package/dist/agents/task-manager.js +67 -0
  12. package/dist/agents/tools.d.ts +24 -0
  13. package/dist/agents/tools.d.ts.map +1 -0
  14. package/dist/agents/tools.js +2257 -0
  15. package/dist/agents/types.d.ts +22 -0
  16. package/dist/agents/types.d.ts.map +1 -0
  17. package/dist/agents/types.js +1 -0
  18. package/dist/api.d.ts +35 -0
  19. package/dist/api.d.ts.map +1 -0
  20. package/dist/api.js +2983 -0
  21. package/dist/auth/login-openai.d.ts +10 -0
  22. package/dist/auth/login-openai.d.ts.map +1 -0
  23. package/dist/auth/login-openai.js +316 -0
  24. package/dist/auth/openai-oauth.d.ts +45 -0
  25. package/dist/auth/openai-oauth.d.ts.map +1 -0
  26. package/dist/auth/openai-oauth.js +308 -0
  27. package/dist/hooks.d.ts +71 -0
  28. package/dist/hooks.d.ts.map +1 -0
  29. package/dist/hooks.js +87 -0
  30. package/dist/index.d.ts +27 -0
  31. package/dist/index.d.ts.map +1 -0
  32. package/dist/index.js +3025 -0
  33. package/dist/mcp/client.d.ts +24 -0
  34. package/dist/mcp/client.d.ts.map +1 -0
  35. package/dist/mcp/client.js +176 -0
  36. package/dist/mcp/index.d.ts +8 -0
  37. package/dist/mcp/index.d.ts.map +1 -0
  38. package/dist/mcp/index.js +203 -0
  39. package/dist/mcp/server.d.ts +25 -0
  40. package/dist/mcp/server.d.ts.map +1 -0
  41. package/dist/mcp/server.js +42 -0
  42. package/dist/mcp/types.d.ts +47 -0
  43. package/dist/mcp/types.d.ts.map +1 -0
  44. package/dist/mcp/types.js +1 -0
  45. package/dist/permissions.d.ts +29 -0
  46. package/dist/permissions.d.ts.map +1 -0
  47. package/dist/permissions.js +157 -0
  48. package/dist/providers/anthropic.d.ts +26 -0
  49. package/dist/providers/anthropic.d.ts.map +1 -0
  50. package/dist/providers/anthropic.js +382 -0
  51. package/dist/providers/openai.d.ts +42 -0
  52. package/dist/providers/openai.d.ts.map +1 -0
  53. package/dist/providers/openai.js +871 -0
  54. package/dist/providers/registry.d.ts +11 -0
  55. package/dist/providers/registry.d.ts.map +1 -0
  56. package/dist/providers/registry.js +1118 -0
  57. package/dist/providers/types.d.ts +79 -0
  58. package/dist/providers/types.d.ts.map +1 -0
  59. package/dist/providers/types.js +1 -0
  60. package/dist/query.d.ts +9 -0
  61. package/dist/query.d.ts.map +1 -0
  62. package/dist/query.js +36 -0
  63. package/dist/settings.d.ts +28 -0
  64. package/dist/settings.d.ts.map +1 -0
  65. package/dist/settings.js +143 -0
  66. package/dist/tools/bash.d.ts +6 -0
  67. package/dist/tools/bash.d.ts.map +1 -0
  68. package/dist/tools/bash.js +88 -0
  69. package/dist/tools/edit.d.ts +6 -0
  70. package/dist/tools/edit.d.ts.map +1 -0
  71. package/dist/tools/edit.js +108 -0
  72. package/dist/tools/glob.d.ts +6 -0
  73. package/dist/tools/glob.d.ts.map +1 -0
  74. package/dist/tools/glob.js +70 -0
  75. package/dist/tools/grep.d.ts +7 -0
  76. package/dist/tools/grep.d.ts.map +1 -0
  77. package/dist/tools/grep.js +183 -0
  78. package/dist/tools/index.d.ts +18 -0
  79. package/dist/tools/index.d.ts.map +1 -0
  80. package/dist/tools/index.js +595 -0
  81. package/dist/tools/mcp-resources.d.ts +8 -0
  82. package/dist/tools/mcp-resources.d.ts.map +1 -0
  83. package/dist/tools/mcp-resources.js +87 -0
  84. package/dist/tools/presets.d.ts +6 -0
  85. package/dist/tools/presets.d.ts.map +1 -0
  86. package/dist/tools/presets.js +32 -0
  87. package/dist/tools/read.d.ts +6 -0
  88. package/dist/tools/read.d.ts.map +1 -0
  89. package/dist/tools/read.js +81 -0
  90. package/dist/tools/registry.d.ts +31 -0
  91. package/dist/tools/registry.d.ts.map +1 -0
  92. package/dist/tools/registry.js +52 -0
  93. package/dist/tools/write.d.ts +6 -0
  94. package/dist/tools/write.d.ts.map +1 -0
  95. package/dist/tools/write.js +62 -0
  96. package/dist/types.d.ts +201 -0
  97. package/dist/types.d.ts.map +1 -0
  98. package/dist/types.js +39 -0
  99. package/dist/utils/cost.d.ts +35 -0
  100. package/dist/utils/cost.d.ts.map +1 -0
  101. package/dist/utils/cost.js +176 -0
  102. package/dist/utils/system-prompt.d.ts +11 -0
  103. package/dist/utils/system-prompt.d.ts.map +1 -0
  104. package/dist/utils/system-prompt.js +89 -0
  105. package/package.json +66 -0
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Subagent types.
3
+ */
4
+ export type AgentDefinition = {
5
+ description: string;
6
+ prompt: string;
7
+ tools?: string[];
8
+ model?: string;
9
+ /** fourmis-exclusive: use a different provider per agent */
10
+ provider?: string;
11
+ maxTurns?: number;
12
+ };
13
+ export type BackgroundTask = {
14
+ id: string;
15
+ agentType: string;
16
+ status: "running" | "completed" | "failed" | "stopped";
17
+ result?: string;
18
+ error?: string;
19
+ abortController: AbortController;
20
+ promise: Promise<void>;
21
+ };
22
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC"}
@@ -0,0 +1 @@
1
+ // @bun
package/dist/api.d.ts ADDED
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Public query() function — the main entry point.
3
+ */
4
+ import type { QueryOptions, Query } from "./types.js";
5
+ /**
6
+ * Start an agent conversation.
7
+ *
8
+ * Returns a Query (AsyncGenerator<AgentMessage>) that streams events
9
+ * as the agent thinks, calls tools, and produces results.
10
+ *
11
+ * @example
12
+ * ```ts
13
+ * const conversation = query({
14
+ * prompt: "Read package.json and tell me the project name",
15
+ * options: {
16
+ * provider: "anthropic",
17
+ * model: "claude-sonnet-4-5-20250929",
18
+ * cwd: "/my/project",
19
+ * tools: "coding",
20
+ * maxTurns: 5,
21
+ * },
22
+ * });
23
+ *
24
+ * for await (const msg of conversation) {
25
+ * if (msg.type === "text") process.stdout.write(msg.text);
26
+ * if (msg.type === "tool_use") console.log(`\n[tool] ${msg.name}`);
27
+ * if (msg.type === "result") console.log(`\nDone: $${msg.costUsd}`);
28
+ * }
29
+ * ```
30
+ */
31
+ export declare function query(params: {
32
+ prompt: string;
33
+ options?: QueryOptions;
34
+ }): Query;
35
+ //# sourceMappingURL=api.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AAkBzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,GAAG,KAAK,CAuHR"}