@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.
- package/AGENTS.md +2913 -0
- package/CHANGELOG.md +5 -0
- package/README.md +1585 -0
- package/dist/adapters/index.d.mts +2 -0
- package/dist/adapters/index.d.ts +2 -0
- package/dist/adapters/index.js +1024 -0
- package/dist/adapters/index.js.map +1 -0
- package/dist/adapters/index.mjs +1021 -0
- package/dist/adapters/index.mjs.map +1 -0
- package/dist/index-CX4IgrRt.d.mts +2181 -0
- package/dist/index-CX4IgrRt.d.ts +2181 -0
- package/dist/index.d.mts +3170 -0
- package/dist/index.d.ts +3170 -0
- package/dist/index.js +4045 -0
- package/dist/index.js.map +1 -0
- package/dist/index.mjs +4011 -0
- package/dist/index.mjs.map +1 -0
- package/dist/shim.d.mts +72 -0
- package/dist/shim.d.ts +72 -0
- package/dist/shim.js +105 -0
- package/dist/shim.js.map +1 -0
- package/dist/shim.mjs +89 -0
- package/dist/shim.mjs.map +1 -0
- package/dist/telemetry/index.d.mts +340 -0
- package/dist/telemetry/index.d.ts +340 -0
- package/dist/telemetry/index.js +157 -0
- package/dist/telemetry/index.js.map +1 -0
- package/dist/telemetry/index.mjs +155 -0
- package/dist/telemetry/index.mjs.map +1 -0
- package/package.json +116 -0
package/dist/shim.d.mts
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.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
|
package/dist/shim.js.map
ADDED
|
@@ -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"]}
|