@igniter-js/agents 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.
@@ -0,0 +1,72 @@
1
+ /**
2
+ * @fileoverview Browser/client-side shim for @igniter-js/agents
3
+ * @module @igniter-js/agents/shim
4
+ *
5
+ * @description
6
+ * This module prevents @igniter-js/agents from being used in browser environments.
7
+ * The agent package is server-only as it relies on Node.js APIs, MCP protocols,
8
+ * and should not be bundled into client-side code.
9
+ *
10
+ * If you're seeing this error, you're likely:
11
+ * 1. Importing @igniter-js/agents in client-side code
12
+ * 2. Using it in a React/Vue/Svelte component without proper server boundaries
13
+ * 3. Not using "use server" directive in frameworks that support it
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * // WRONG - Don't import in client components
18
+ * import { IgniterAgent } from '@igniter-js/agents'; // Will throw error
19
+ *
20
+ * // CORRECT - Use in server-side code only
21
+ * // In Next.js, use Server Actions or API routes
22
+ * // In other frameworks, use server-side rendering or API endpoints
23
+ * ```
24
+ */
25
+ /**
26
+ * Throws an error when attempting to use the agent package in a browser environment.
27
+ * @throws {Error} Always throws with server-only message
28
+ */
29
+ declare function throwServerOnlyError(): never;
30
+ declare const IgniterAgent: {
31
+ create: typeof throwServerOnlyError;
32
+ };
33
+ declare const IgniterAgentBuilder: {
34
+ create: typeof throwServerOnlyError;
35
+ };
36
+ declare const IgniterAgentToolsetBuilder: {
37
+ create: typeof throwServerOnlyError;
38
+ };
39
+ declare const IgniterAgentMCPBuilder: {
40
+ create: typeof throwServerOnlyError;
41
+ };
42
+ declare const IgniterAgentPromptBuilder: {
43
+ create: typeof throwServerOnlyError;
44
+ };
45
+ declare const IgniterAgentToolBuilder: {
46
+ create: typeof throwServerOnlyError;
47
+ };
48
+ declare const IgniterAgentManager: {
49
+ create: typeof throwServerOnlyError;
50
+ };
51
+ declare const IgniterAgentToolset: {
52
+ create: typeof throwServerOnlyError;
53
+ };
54
+ declare const IgniterAgentTool: {
55
+ create: typeof throwServerOnlyError;
56
+ };
57
+ declare const IgniterAgentMCPClient: {
58
+ create: typeof throwServerOnlyError;
59
+ };
60
+ declare const IgniterAgentPrompt: {
61
+ create: typeof throwServerOnlyError;
62
+ };
63
+ declare const IgniterAgentInMemoryAdapter: {
64
+ create: typeof throwServerOnlyError;
65
+ };
66
+ declare class IgniterAgentError extends Error {
67
+ constructor();
68
+ }
69
+ declare const IgniterAgentErrorCode: {};
70
+ declare const isIgniterAgentError: () => boolean;
71
+
72
+ export { IgniterAgent, IgniterAgentBuilder, IgniterAgentError, IgniterAgentErrorCode, IgniterAgentInMemoryAdapter, IgniterAgentMCPBuilder, IgniterAgentMCPClient, IgniterAgentManager, IgniterAgentPrompt, IgniterAgentPromptBuilder, IgniterAgentTool, IgniterAgentToolBuilder, IgniterAgentToolset, IgniterAgentToolsetBuilder, isIgniterAgentError };
package/dist/shim.d.ts ADDED
@@ -0,0 +1,72 @@
1
+ /**
2
+ * @fileoverview Browser/client-side shim for @igniter-js/agents
3
+ * @module @igniter-js/agents/shim
4
+ *
5
+ * @description
6
+ * This module prevents @igniter-js/agents from being used in browser environments.
7
+ * The agent package is server-only as it relies on Node.js APIs, MCP protocols,
8
+ * and should not be bundled into client-side code.
9
+ *
10
+ * If you're seeing this error, you're likely:
11
+ * 1. Importing @igniter-js/agents in client-side code
12
+ * 2. Using it in a React/Vue/Svelte component without proper server boundaries
13
+ * 3. Not using "use server" directive in frameworks that support it
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * // WRONG - Don't import in client components
18
+ * import { IgniterAgent } from '@igniter-js/agents'; // Will throw error
19
+ *
20
+ * // CORRECT - Use in server-side code only
21
+ * // In Next.js, use Server Actions or API routes
22
+ * // In other frameworks, use server-side rendering or API endpoints
23
+ * ```
24
+ */
25
+ /**
26
+ * Throws an error when attempting to use the agent package in a browser environment.
27
+ * @throws {Error} Always throws with server-only message
28
+ */
29
+ declare function throwServerOnlyError(): never;
30
+ declare const IgniterAgent: {
31
+ create: typeof throwServerOnlyError;
32
+ };
33
+ declare const IgniterAgentBuilder: {
34
+ create: typeof throwServerOnlyError;
35
+ };
36
+ declare const IgniterAgentToolsetBuilder: {
37
+ create: typeof throwServerOnlyError;
38
+ };
39
+ declare const IgniterAgentMCPBuilder: {
40
+ create: typeof throwServerOnlyError;
41
+ };
42
+ declare const IgniterAgentPromptBuilder: {
43
+ create: typeof throwServerOnlyError;
44
+ };
45
+ declare const IgniterAgentToolBuilder: {
46
+ create: typeof throwServerOnlyError;
47
+ };
48
+ declare const IgniterAgentManager: {
49
+ create: typeof throwServerOnlyError;
50
+ };
51
+ declare const IgniterAgentToolset: {
52
+ create: typeof throwServerOnlyError;
53
+ };
54
+ declare const IgniterAgentTool: {
55
+ create: typeof throwServerOnlyError;
56
+ };
57
+ declare const IgniterAgentMCPClient: {
58
+ create: typeof throwServerOnlyError;
59
+ };
60
+ declare const IgniterAgentPrompt: {
61
+ create: typeof throwServerOnlyError;
62
+ };
63
+ declare const IgniterAgentInMemoryAdapter: {
64
+ create: typeof throwServerOnlyError;
65
+ };
66
+ declare class IgniterAgentError extends Error {
67
+ constructor();
68
+ }
69
+ declare const IgniterAgentErrorCode: {};
70
+ declare const isIgniterAgentError: () => boolean;
71
+
72
+ export { IgniterAgent, IgniterAgentBuilder, IgniterAgentError, IgniterAgentErrorCode, IgniterAgentInMemoryAdapter, IgniterAgentMCPBuilder, IgniterAgentMCPClient, IgniterAgentManager, IgniterAgentPrompt, IgniterAgentPromptBuilder, IgniterAgentTool, IgniterAgentToolBuilder, IgniterAgentToolset, IgniterAgentToolsetBuilder, isIgniterAgentError };
package/dist/shim.js ADDED
@@ -0,0 +1,105 @@
1
+ 'use strict';
2
+
3
+ // src/shim.ts
4
+ var SERVER_ONLY_ERROR = `
5
+ ================================================================================
6
+ @igniter-js/agents: Server-Only Package
7
+ ================================================================================
8
+
9
+ This package cannot be used in browser/client environments.
10
+
11
+ The @igniter-js/agents package is designed exclusively for server-side usage
12
+ because it:
13
+ - Uses Node.js-specific APIs
14
+ - Connects to MCP (Model Context Protocol) servers
15
+ - Handles sensitive AI model credentials
16
+ - Requires server-side process management
17
+
18
+ SOLUTIONS:
19
+
20
+ 1. Next.js App Router:
21
+ - Use Server Components (default in app/ directory)
22
+ - Use Server Actions with "use server" directive
23
+ - Use API routes (app/api/*)
24
+
25
+ 2. Next.js Pages Router:
26
+ - Use getServerSideProps
27
+ - Use API routes (pages/api/*)
28
+
29
+ 3. Other Frameworks:
30
+ - Move agent logic to server-side endpoints
31
+ - Use tRPC, GraphQL, or REST APIs
32
+
33
+ 4. Development/Testing:
34
+ - Run agent code in Node.js directly
35
+ - Use server-side test runners
36
+
37
+ For documentation, visit: https://igniterjs.com/docs/agents
38
+
39
+ ================================================================================
40
+ `;
41
+ function throwServerOnlyError() {
42
+ throw new Error(SERVER_ONLY_ERROR);
43
+ }
44
+ var IgniterAgent = {
45
+ create: throwServerOnlyError
46
+ };
47
+ var IgniterAgentBuilder = {
48
+ create: throwServerOnlyError
49
+ };
50
+ var IgniterAgentToolsetBuilder = {
51
+ create: throwServerOnlyError
52
+ };
53
+ var IgniterAgentMCPBuilder = {
54
+ create: throwServerOnlyError
55
+ };
56
+ var IgniterAgentPromptBuilder = {
57
+ create: throwServerOnlyError
58
+ };
59
+ var IgniterAgentToolBuilder = {
60
+ create: throwServerOnlyError
61
+ };
62
+ var IgniterAgentManager = {
63
+ create: throwServerOnlyError
64
+ };
65
+ var IgniterAgentToolset = {
66
+ create: throwServerOnlyError
67
+ };
68
+ var IgniterAgentTool = {
69
+ create: throwServerOnlyError
70
+ };
71
+ var IgniterAgentMCPClient = {
72
+ create: throwServerOnlyError
73
+ };
74
+ var IgniterAgentPrompt = {
75
+ create: throwServerOnlyError
76
+ };
77
+ var IgniterAgentInMemoryAdapter = {
78
+ create: throwServerOnlyError
79
+ };
80
+ var IgniterAgentError = class extends Error {
81
+ constructor() {
82
+ super(SERVER_ONLY_ERROR);
83
+ this.name = "IgniterAgentError";
84
+ }
85
+ };
86
+ var IgniterAgentErrorCode = {};
87
+ var isIgniterAgentError = () => false;
88
+
89
+ exports.IgniterAgent = IgniterAgent;
90
+ exports.IgniterAgentBuilder = IgniterAgentBuilder;
91
+ exports.IgniterAgentError = IgniterAgentError;
92
+ exports.IgniterAgentErrorCode = IgniterAgentErrorCode;
93
+ exports.IgniterAgentInMemoryAdapter = IgniterAgentInMemoryAdapter;
94
+ exports.IgniterAgentMCPBuilder = IgniterAgentMCPBuilder;
95
+ exports.IgniterAgentMCPClient = IgniterAgentMCPClient;
96
+ exports.IgniterAgentManager = IgniterAgentManager;
97
+ exports.IgniterAgentPrompt = IgniterAgentPrompt;
98
+ exports.IgniterAgentPromptBuilder = IgniterAgentPromptBuilder;
99
+ exports.IgniterAgentTool = IgniterAgentTool;
100
+ exports.IgniterAgentToolBuilder = IgniterAgentToolBuilder;
101
+ exports.IgniterAgentToolset = IgniterAgentToolset;
102
+ exports.IgniterAgentToolsetBuilder = IgniterAgentToolsetBuilder;
103
+ exports.isIgniterAgentError = isIgniterAgentError;
104
+ //# sourceMappingURL=shim.js.map
105
+ //# sourceMappingURL=shim.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/shim.ts"],"names":[],"mappings":";;;AAyBA,IAAM,iBAAA,GAAoB;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA,CAAA;AA0C1B,SAAS,oBAAA,GAA8B;AACrC,EAAA,MAAM,IAAI,MAAM,iBAAiB,CAAA;AACnC;AAGO,IAAM,YAAA,GAAe;AAAA,EAC1B,MAAA,EAAQ;AACV;AAEO,IAAM,mBAAA,GAAsB;AAAA,EACjC,MAAA,EAAQ;AACV;AAEO,IAAM,0BAAA,GAA6B;AAAA,EACxC,MAAA,EAAQ;AACV;AAEO,IAAM,sBAAA,GAAyB;AAAA,EACpC,MAAA,EAAQ;AACV;AAEO,IAAM,yBAAA,GAA4B;AAAA,EACvC,MAAA,EAAQ;AACV;AAEO,IAAM,uBAAA,GAA0B;AAAA,EACrC,MAAA,EAAQ;AACV;AAEO,IAAM,mBAAA,GAAsB;AAAA,EACjC,MAAA,EAAQ;AACV;AAEO,IAAM,mBAAA,GAAsB;AAAA,EACjC,MAAA,EAAQ;AACV;AAEO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,MAAA,EAAQ;AACV;AAEO,IAAM,qBAAA,GAAwB;AAAA,EACnC,MAAA,EAAQ;AACV;AAEO,IAAM,kBAAA,GAAqB;AAAA,EAChC,MAAA,EAAQ;AACV;AAEO,IAAM,2BAAA,GAA8B;AAAA,EACzC,MAAA,EAAQ;AACV;AAGO,IAAM,iBAAA,GAAN,cAAgC,KAAA,CAAM;AAAA,EAC3C,WAAA,GAAc;AACZ,IAAA,KAAA,CAAM,iBAAiB,CAAA;AACvB,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AAAA,EACd;AACF;AAEO,IAAM,wBAAwB;AAC9B,IAAM,sBAAsB,MAAM","file":"shim.js","sourcesContent":["/**\n * @fileoverview Browser/client-side shim for @igniter-js/agents\n * @module @igniter-js/agents/shim\n *\n * @description\n * This module prevents @igniter-js/agents from being used in browser environments.\n * The agent package is server-only as it relies on Node.js APIs, MCP protocols,\n * and should not be bundled into client-side code.\n *\n * If you're seeing this error, you're likely:\n * 1. Importing @igniter-js/agents in client-side code\n * 2. Using it in a React/Vue/Svelte component without proper server boundaries\n * 3. Not using \"use server\" directive in frameworks that support it\n *\n * @example\n * ```typescript\n * // WRONG - Don't import in client components\n * import { IgniterAgent } from '@igniter-js/agents'; // Will throw error\n *\n * // CORRECT - Use in server-side code only\n * // In Next.js, use Server Actions or API routes\n * // In other frameworks, use server-side rendering or API endpoints\n * ```\n */\n\nconst SERVER_ONLY_ERROR = `\n================================================================================\n@igniter-js/agents: Server-Only Package\n================================================================================\n\nThis package cannot be used in browser/client environments.\n\nThe @igniter-js/agents package is designed exclusively for server-side usage\nbecause it:\n- Uses Node.js-specific APIs\n- Connects to MCP (Model Context Protocol) servers\n- Handles sensitive AI model credentials\n- Requires server-side process management\n\nSOLUTIONS:\n\n1. Next.js App Router:\n - Use Server Components (default in app/ directory)\n - Use Server Actions with \"use server\" directive\n - Use API routes (app/api/*)\n\n2. Next.js Pages Router:\n - Use getServerSideProps\n - Use API routes (pages/api/*)\n\n3. Other Frameworks:\n - Move agent logic to server-side endpoints\n - Use tRPC, GraphQL, or REST APIs\n\n4. Development/Testing:\n - Run agent code in Node.js directly\n - Use server-side test runners\n\nFor documentation, visit: https://igniterjs.com/docs/agents\n\n================================================================================\n`;\n\n/**\n * Throws an error when attempting to use the agent package in a browser environment.\n * @throws {Error} Always throws with server-only message\n */\nfunction throwServerOnlyError(): never {\n throw new Error(SERVER_ONLY_ERROR);\n}\n\n// Export shim versions that throw errors\nexport const IgniterAgent = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentToolsetBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentMCPBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentPromptBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentToolBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentManager = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentToolset = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentTool = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentMCPClient = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentPrompt = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentInMemoryAdapter = {\n create: throwServerOnlyError,\n};\n\n// Error exports (these are safe to use in browser for type checking)\nexport class IgniterAgentError extends Error {\n constructor() {\n super(SERVER_ONLY_ERROR);\n this.name = \"IgniterAgentError\";\n }\n}\n\nexport const IgniterAgentErrorCode = {};\nexport const isIgniterAgentError = () => false;\n"]}
package/dist/shim.mjs ADDED
@@ -0,0 +1,89 @@
1
+ // src/shim.ts
2
+ var SERVER_ONLY_ERROR = `
3
+ ================================================================================
4
+ @igniter-js/agents: Server-Only Package
5
+ ================================================================================
6
+
7
+ This package cannot be used in browser/client environments.
8
+
9
+ The @igniter-js/agents package is designed exclusively for server-side usage
10
+ because it:
11
+ - Uses Node.js-specific APIs
12
+ - Connects to MCP (Model Context Protocol) servers
13
+ - Handles sensitive AI model credentials
14
+ - Requires server-side process management
15
+
16
+ SOLUTIONS:
17
+
18
+ 1. Next.js App Router:
19
+ - Use Server Components (default in app/ directory)
20
+ - Use Server Actions with "use server" directive
21
+ - Use API routes (app/api/*)
22
+
23
+ 2. Next.js Pages Router:
24
+ - Use getServerSideProps
25
+ - Use API routes (pages/api/*)
26
+
27
+ 3. Other Frameworks:
28
+ - Move agent logic to server-side endpoints
29
+ - Use tRPC, GraphQL, or REST APIs
30
+
31
+ 4. Development/Testing:
32
+ - Run agent code in Node.js directly
33
+ - Use server-side test runners
34
+
35
+ For documentation, visit: https://igniterjs.com/docs/agents
36
+
37
+ ================================================================================
38
+ `;
39
+ function throwServerOnlyError() {
40
+ throw new Error(SERVER_ONLY_ERROR);
41
+ }
42
+ var IgniterAgent = {
43
+ create: throwServerOnlyError
44
+ };
45
+ var IgniterAgentBuilder = {
46
+ create: throwServerOnlyError
47
+ };
48
+ var IgniterAgentToolsetBuilder = {
49
+ create: throwServerOnlyError
50
+ };
51
+ var IgniterAgentMCPBuilder = {
52
+ create: throwServerOnlyError
53
+ };
54
+ var IgniterAgentPromptBuilder = {
55
+ create: throwServerOnlyError
56
+ };
57
+ var IgniterAgentToolBuilder = {
58
+ create: throwServerOnlyError
59
+ };
60
+ var IgniterAgentManager = {
61
+ create: throwServerOnlyError
62
+ };
63
+ var IgniterAgentToolset = {
64
+ create: throwServerOnlyError
65
+ };
66
+ var IgniterAgentTool = {
67
+ create: throwServerOnlyError
68
+ };
69
+ var IgniterAgentMCPClient = {
70
+ create: throwServerOnlyError
71
+ };
72
+ var IgniterAgentPrompt = {
73
+ create: throwServerOnlyError
74
+ };
75
+ var IgniterAgentInMemoryAdapter = {
76
+ create: throwServerOnlyError
77
+ };
78
+ var IgniterAgentError = class extends Error {
79
+ constructor() {
80
+ super(SERVER_ONLY_ERROR);
81
+ this.name = "IgniterAgentError";
82
+ }
83
+ };
84
+ var IgniterAgentErrorCode = {};
85
+ var isIgniterAgentError = () => false;
86
+
87
+ export { IgniterAgent, IgniterAgentBuilder, IgniterAgentError, IgniterAgentErrorCode, IgniterAgentInMemoryAdapter, IgniterAgentMCPBuilder, IgniterAgentMCPClient, IgniterAgentManager, IgniterAgentPrompt, IgniterAgentPromptBuilder, IgniterAgentTool, IgniterAgentToolBuilder, IgniterAgentToolset, IgniterAgentToolsetBuilder, isIgniterAgentError };
88
+ //# sourceMappingURL=shim.mjs.map
89
+ //# sourceMappingURL=shim.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/shim.ts"],"names":[],"mappings":";AAyBA,IAAM,iBAAA,GAAoB;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA,CAAA;AA0C1B,SAAS,oBAAA,GAA8B;AACrC,EAAA,MAAM,IAAI,MAAM,iBAAiB,CAAA;AACnC;AAGO,IAAM,YAAA,GAAe;AAAA,EAC1B,MAAA,EAAQ;AACV;AAEO,IAAM,mBAAA,GAAsB;AAAA,EACjC,MAAA,EAAQ;AACV;AAEO,IAAM,0BAAA,GAA6B;AAAA,EACxC,MAAA,EAAQ;AACV;AAEO,IAAM,sBAAA,GAAyB;AAAA,EACpC,MAAA,EAAQ;AACV;AAEO,IAAM,yBAAA,GAA4B;AAAA,EACvC,MAAA,EAAQ;AACV;AAEO,IAAM,uBAAA,GAA0B;AAAA,EACrC,MAAA,EAAQ;AACV;AAEO,IAAM,mBAAA,GAAsB;AAAA,EACjC,MAAA,EAAQ;AACV;AAEO,IAAM,mBAAA,GAAsB;AAAA,EACjC,MAAA,EAAQ;AACV;AAEO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,MAAA,EAAQ;AACV;AAEO,IAAM,qBAAA,GAAwB;AAAA,EACnC,MAAA,EAAQ;AACV;AAEO,IAAM,kBAAA,GAAqB;AAAA,EAChC,MAAA,EAAQ;AACV;AAEO,IAAM,2BAAA,GAA8B;AAAA,EACzC,MAAA,EAAQ;AACV;AAGO,IAAM,iBAAA,GAAN,cAAgC,KAAA,CAAM;AAAA,EAC3C,WAAA,GAAc;AACZ,IAAA,KAAA,CAAM,iBAAiB,CAAA;AACvB,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AAAA,EACd;AACF;AAEO,IAAM,wBAAwB;AAC9B,IAAM,sBAAsB,MAAM","file":"shim.mjs","sourcesContent":["/**\n * @fileoverview Browser/client-side shim for @igniter-js/agents\n * @module @igniter-js/agents/shim\n *\n * @description\n * This module prevents @igniter-js/agents from being used in browser environments.\n * The agent package is server-only as it relies on Node.js APIs, MCP protocols,\n * and should not be bundled into client-side code.\n *\n * If you're seeing this error, you're likely:\n * 1. Importing @igniter-js/agents in client-side code\n * 2. Using it in a React/Vue/Svelte component without proper server boundaries\n * 3. Not using \"use server\" directive in frameworks that support it\n *\n * @example\n * ```typescript\n * // WRONG - Don't import in client components\n * import { IgniterAgent } from '@igniter-js/agents'; // Will throw error\n *\n * // CORRECT - Use in server-side code only\n * // In Next.js, use Server Actions or API routes\n * // In other frameworks, use server-side rendering or API endpoints\n * ```\n */\n\nconst SERVER_ONLY_ERROR = `\n================================================================================\n@igniter-js/agents: Server-Only Package\n================================================================================\n\nThis package cannot be used in browser/client environments.\n\nThe @igniter-js/agents package is designed exclusively for server-side usage\nbecause it:\n- Uses Node.js-specific APIs\n- Connects to MCP (Model Context Protocol) servers\n- Handles sensitive AI model credentials\n- Requires server-side process management\n\nSOLUTIONS:\n\n1. Next.js App Router:\n - Use Server Components (default in app/ directory)\n - Use Server Actions with \"use server\" directive\n - Use API routes (app/api/*)\n\n2. Next.js Pages Router:\n - Use getServerSideProps\n - Use API routes (pages/api/*)\n\n3. Other Frameworks:\n - Move agent logic to server-side endpoints\n - Use tRPC, GraphQL, or REST APIs\n\n4. Development/Testing:\n - Run agent code in Node.js directly\n - Use server-side test runners\n\nFor documentation, visit: https://igniterjs.com/docs/agents\n\n================================================================================\n`;\n\n/**\n * Throws an error when attempting to use the agent package in a browser environment.\n * @throws {Error} Always throws with server-only message\n */\nfunction throwServerOnlyError(): never {\n throw new Error(SERVER_ONLY_ERROR);\n}\n\n// Export shim versions that throw errors\nexport const IgniterAgent = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentToolsetBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentMCPBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentPromptBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentToolBuilder = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentManager = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentToolset = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentTool = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentMCPClient = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentPrompt = {\n create: throwServerOnlyError,\n};\n\nexport const IgniterAgentInMemoryAdapter = {\n create: throwServerOnlyError,\n};\n\n// Error exports (these are safe to use in browser for type checking)\nexport class IgniterAgentError extends Error {\n constructor() {\n super(SERVER_ONLY_ERROR);\n this.name = \"IgniterAgentError\";\n }\n}\n\nexport const IgniterAgentErrorCode = {};\nexport const isIgniterAgentError = () => false;\n"]}