@copilotkitnext/core 0.0.2 → 0.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkitnext/core",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Core web utilities for CopilotKit2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,7 +28,7 @@
     "@ag-ui/client": "0.0.36-alpha.1",
     "rxjs": "7.8.1",
     "zod": "^3.25.75",
-    "@copilotkitnext/shared": "0.0.2"
+    "@copilotkitnext/shared": "0.0.4"
   },
   "engines": {
     "node": ">=18"

package/.turbo/turbo-build.log

@@ -1,23 +0,0 @@
-
-
-> @copilotkitnext/core@0.0.1 build /Users/mme/Code/vnext_experimental/packages/core
-> tsup
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.0
-CLI Using tsup config: /Users/mme/Code/vnext_experimental/packages/core/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-CJS Build start
-ESM Build start
-CJS dist/index.js     16.30 KB
-CJS dist/index.js.map 30.55 KB
-CJS ⚡️ Build success in 11ms
-ESM dist/index.mjs     15.02 KB
-ESM dist/index.mjs.map 30.38 KB
-ESM ⚡️ Build success in 11ms
-DTS Build start
-DTS ⚡️ Build success in 1131ms
-DTS dist/index.d.ts  3.38 KB
-DTS dist/index.d.mts 3.38 KB

package/.turbo/turbo-check-types.log

@@ -1,4 +0,0 @@
-
-> @copilotkit/core@0.0.0 check-types /Users/mme/Code/CopilotKit2/packages/core
-> tsc --noEmit
-

package/.turbo/turbo-lint.log

@@ -1,12 +0,0 @@
-
-> @copilotkit/core@0.0.0 lint /Users/mme/Code/CopilotKit2/packages/core
-> eslint . --max-warnings 0
-
-
-/Users/mme/Code/CopilotKit2/packages/core/src/core.ts
-  3:34  warning  'HttpAgent' is defined but never used  @typescript-eslint/no-unused-vars
-
-✖ 1 problem (0 errors, 1 warning)
-
-ESLint found too many warnings (maximum: 0).
- ELIFECYCLE  Command failed with exit code 1.

package/.turbo/turbo-test.log

@@ -1,96 +0,0 @@
-
-> @copilotkitnext/core@0.0.0 test /Users/mme/Code/CopilotKit2/packages/core
-> vitest run
-
-
- RUN  v3.2.4 /Users/mme/Code/CopilotKit2/packages/core
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 4: should handle follow-up with recursion
-TEST 4: Starting follow-up test
-TEST 4: Call count: 1
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 4: should handle follow-up with recursion
-TEST 4: Call count: 2
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 4: should handle follow-up with recursion
-TEST 4: Success - calls: 2
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 5: should handle multiple tools with at least one follow-up
-TEST 5: Starting multiple tools test
-TEST 5: Call count: 1
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 5: should handle multiple tools with at least one follow-up
-TEST 5: Call count: 2
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 5: should handle multiple tools with at least one follow-up
-TEST 5: Success - calls: 2
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 6: should handle tool with undefined follow-up (defaults to true)
-TEST 6: Starting undefined follow-up test
-TEST 6: Call count: 1
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 6: should handle tool with undefined follow-up (defaults to true)
-TEST 6: Call count: 2
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 6: should handle tool with undefined follow-up (defaults to true)
-TEST 6: Success - calls: 2
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 7: should handle invalid JSON in tool arguments
-TEST 7: Starting invalid JSON test
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 7: should handle invalid JSON in tool arguments
-TEST 7: Success - caught error: SyntaxError: Expected property name or '}' in JSON at position 2
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 8: should handle empty string arguments
-TEST 8: Starting empty arguments test
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 8: should handle empty string arguments
-TEST 8: Success - caught error: SyntaxError: Unexpected end of JSON input
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 9: should handle chain of follow-ups
-TEST 9: Starting chain test
-TEST 9: Call count: 1
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 9: should handle chain of follow-ups
-TEST 9: Call count: 2
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 9: should handle chain of follow-ups
-TEST 9: Call count: 3
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 9: should handle chain of follow-ups
-TEST 9: Success - calls: 3
-
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 10: should handle concurrent tool calls
-TEST 10: Starting concurrent tools test
-
- ✓ src/__tests__/core-basic.test.ts (2 tests) 14ms
- ✓ src/__tests__/core-wildcard.test.ts (2 tests) 3ms
- ✓ src/__tests__/core-simple.test.ts (1 test) 2ms
-stdout | src/__tests__/core-tool-simple.test.ts > CopilotKitCore Tool Simple > should execute a simple tool
-Starting simple tool test
-About to run agent
-
-stdout | src/__tests__/core-tool-simple.test.ts > CopilotKitCore Tool Simple > should execute a simple tool
-Tool handler called
-
- ✓ src/__tests__/core-basic-functionality.test.ts (10 tests) 61ms
- ✓ src/__tests__/core-tool-minimal.test.ts (2 tests) 4ms
-stdout | src/__tests__/core-full.test.ts > CopilotKitCore.runAgent - Full Test Suite > Tests that might reveal problems > TEST 10: should handle concurrent tool calls
-TEST 10: Success - duration: 176ms
-
-stdout | src/__tests__/core-tool-simple.test.ts > CopilotKitCore Tool Simple > should execute a simple tool
-Agent run complete
-
- ✓ src/__tests__/core-follow-up.test.ts (7 tests) 16ms
- ✓ src/__tests__/core-full.test.ts (10 tests) 194ms
- ✓ src/__tests__/core-edge-cases.test.ts (7 tests) 23ms
- ✓ src/__tests__/core-tool-simple.test.ts (1 test) 79ms
- ✓ src/__tests__/simple.test.ts (1 test) 4ms
- ✓ src/__tests__/import.test.ts (1 test) 1ms
- ✓ src/__tests__/core-agent-constraints.test.ts (3 tests) 3ms
-
- Test Files  12 passed (12)
-      Tests  47 passed (47)
-   Start at  10:38:15
-   Duration  2.27s (transform 488ms, setup 0ms, collect 5.43s, tests 404ms, environment 1ms, prepare 4.27s)
-

package/src/__tests__/core-agent-constraints.test.ts

@@ -1,86 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { CopilotKitCore } from '../core';
-import { FrontendTool } from '../types';
-import { MockAgent, createAssistantMessage } from './test-utils';
-
-describe('CopilotKitCore - Agent Constraints', () => {
-  it('should add tool with agentId', () => {
-    const core = new CopilotKitCore({
-      headers: {},
-      properties: {},
-    });
-    
-    const tool: FrontendTool = {
-      name: 'testTool',
-      handler: vi.fn(),
-      agentId: 'agent1',
-    };
-    
-    core.addTool(tool);
-    expect(core.tools['testTool']).toBeDefined();
-    expect(core.tools['testTool']?.agentId).toBe('agent1');
-  });
-
-  it('should add multiple tools with different agentIds', () => {
-    const core = new CopilotKitCore({
-      headers: {},
-      properties: {},
-    });
-    
-    const globalTool: FrontendTool = {
-      name: 'globalTool',
-      handler: vi.fn(),
-    };
-    
-    const agent1Tool: FrontendTool = {
-      name: 'agent1Tool',
-      handler: vi.fn(),
-      agentId: 'agent1',
-    };
-    
-    const agent2Tool: FrontendTool = {
-      name: 'agent2Tool',
-      handler: vi.fn(),
-      agentId: 'agent2',
-    };
-    
-    core.addTool(globalTool);
-    core.addTool(agent1Tool);
-    core.addTool(agent2Tool);
-    
-    expect(core.tools['globalTool']).toBeDefined();
-    expect(core.tools['globalTool']?.agentId).toBeUndefined();
-    
-    expect(core.tools['agent1Tool']).toBeDefined();
-    expect(core.tools['agent1Tool']?.agentId).toBe('agent1');
-    
-    expect(core.tools['agent2Tool']).toBeDefined();
-    expect(core.tools['agent2Tool']?.agentId).toBe('agent2');
-  });
-
-  it('should preserve all FrontendTool properties including agentId', () => {
-    const core = new CopilotKitCore({
-      headers: {},
-      properties: {},
-    });
-    
-    const handler = vi.fn(async () => 'result');
-    const tool: FrontendTool = {
-      name: 'fullTool',
-      description: 'A complete tool',
-      handler,
-      followUp: false,
-      agentId: 'specificAgent',
-    };
-    
-    core.addTool(tool);
-    
-    const addedTool = core.tools['fullTool'];
-    expect(addedTool).toBeDefined();
-    expect(addedTool?.name).toBe('fullTool');
-    expect(addedTool?.description).toBe('A complete tool');
-    expect(addedTool?.handler).toBe(handler);
-    expect(addedTool?.followUp).toBe(false);
-    expect(addedTool?.agentId).toBe('specificAgent');
-  });
-});

package/src/__tests__/core-basic-functionality.test.ts

@@ -1,158 +0,0 @@
-import { describe, it, expect, beforeEach, vi, afterEach } from "vitest";
-import { CopilotKitCore } from "../core";
-import {
-  MockAgent,
-  createMessage,
-  createAssistantMessage,
-  createToolCallMessage,
-  createTool,
-} from "./test-utils";
-
-describe("CopilotKitCore.runAgent - Basic Functionality", () => {
-  let copilotKitCore: CopilotKitCore;
-
-  beforeEach(() => {
-    copilotKitCore = new CopilotKitCore({});
-    vi.clearAllMocks();
-  });
-
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  it("should run agent without tools", async () => {
-    const messages = [
-      createMessage({ content: "Hello" }),
-      createAssistantMessage({ content: "Hi there!" }),
-    ];
-    const agent = new MockAgent({ newMessages: messages });
-
-    const result = await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(result.newMessages).toEqual(messages);
-    expect(agent.runAgentCalls).toHaveLength(1);
-    expect(agent.runAgentCalls[0].forwardedProps).toEqual({});
-  });
-
-  it("should pass withMessages to agent.addMessages", async () => {
-    const initialMessages = [createMessage({ content: "Initial" })];
-    const newMessages = [createAssistantMessage({ content: "Response" })];
-    const agent = new MockAgent({ newMessages });
-
-    await copilotKitCore.runAgent({ agent: agent as any, withMessages: initialMessages });
-
-    expect(agent.addMessages).toHaveBeenCalledWith(initialMessages);
-    expect(agent.messages).toContain(initialMessages[0]);
-  });
-
-  it("should work without withMessages parameter", async () => {
-    const newMessages = [createAssistantMessage({ content: "Response" })];
-    const agent = new MockAgent({ newMessages });
-
-    const result = await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(result.newMessages).toEqual(newMessages);
-    expect(agent.addMessages).not.toHaveBeenCalled();
-  });
-
-  it("should forward properties to agent.runAgent", async () => {
-    const properties = { apiKey: "test-key", model: "gpt-4" };
-    copilotKitCore = new CopilotKitCore({ properties });
-    const agent = new MockAgent({ newMessages: [] });
-
-    await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(agent.runAgentCalls[0].forwardedProps).toEqual(properties);
-  });
-
-  it("should handle empty newMessages array", async () => {
-    const agent = new MockAgent({ newMessages: [] });
-
-    const result = await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(result.newMessages).toEqual([]);
-    expect(agent.runAgentCalls).toHaveLength(1);
-  });
-
-  it("should ignore non-assistant messages for tool processing", async () => {
-    const messages = [
-      createMessage({ role: "user", content: "User message" }),
-      createMessage({ role: "system", content: "System message" }),
-      createMessage({ role: "tool", content: "Tool result", toolCallId: "123" }),
-    ];
-    const agent = new MockAgent({ newMessages: messages });
-
-    const result = await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(result.newMessages).toEqual(messages);
-    expect(agent.runAgentCalls).toHaveLength(1);
-  });
-
-  it("should handle messages with undefined toolCalls", async () => {
-    const message = createAssistantMessage({ 
-      content: "Response",
-      toolCalls: undefined 
-    });
-    const agent = new MockAgent({ newMessages: [message] });
-
-    const result = await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(result.newMessages).toEqual([message]);
-    expect(agent.runAgentCalls).toHaveLength(1);
-  });
-
-  it("should handle tool returning undefined as empty string", async () => {
-    const toolName = "undefinedTool";
-    const tool = createTool({
-      name: toolName,
-      handler: vi.fn(async () => undefined),
-    });
-    copilotKitCore.addTool(tool);
-
-    const message = createToolCallMessage(toolName);
-    const agent = new MockAgent({ newMessages: [message] });
-
-    await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(agent.messages).toContainEqual(
-      expect.objectContaining({
-        role: "tool",
-        content: "", // Should be empty string, not "undefined"
-      })
-    );
-  });
-
-  it("should handle tool returning null as empty string", async () => {
-    const toolName = "nullTool";
-    const tool = createTool({
-      name: toolName,
-      handler: vi.fn(async () => null),
-    });
-    copilotKitCore.addTool(tool);
-
-    const message = createToolCallMessage(toolName);
-    const agent = new MockAgent({ newMessages: [message] });
-
-    await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(agent.messages).toContainEqual(
-      expect.objectContaining({
-        role: "tool",
-        content: "", // Should be empty string, not "null"
-      })
-    );
-  });
-
-  it("should return correct result structure", async () => {
-    const newMessages = [
-      createAssistantMessage({ content: "Test" })
-    ];
-    const agent = new MockAgent({ newMessages });
-
-    const result = await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(result).toHaveProperty("newMessages");
-    expect(Array.isArray(result.newMessages)).toBe(true);
-    expect(result.newMessages).toEqual(newMessages);
-  });
-});

package/src/__tests__/core-basic.test.ts

@@ -1,27 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from "vitest";
-import { CopilotKitCore } from "../core";
-
-describe("CopilotKitCore Basic", () => {
-  let copilotKitCore: CopilotKitCore;
-
-  beforeEach(() => {
-    copilotKitCore = new CopilotKitCore({});
-  });
-
-  it("should create an instance", () => {
-    expect(copilotKitCore).toBeDefined();
-    expect(copilotKitCore.agents).toEqual({});
-    expect(copilotKitCore.tools).toEqual({});
-  });
-
-  it("should add a tool", () => {
-    const tool = {
-      name: "testTool",
-      handler: vi.fn(),
-    };
-    
-    copilotKitCore.addTool(tool);
-    
-    expect(copilotKitCore.tools["testTool"]).toBe(tool);
-  });
-});

package/src/__tests__/core-edge-cases.test.ts

@@ -1,166 +0,0 @@
-import { describe, it, expect, beforeEach, vi, afterEach } from "vitest";
-import { CopilotKitCore } from "../core";
-import {
-  MockAgent,
-  createAssistantMessage,
-  createToolCallMessage,
-  createToolResultMessage,
-  createTool,
-} from "./test-utils";
-
-describe("CopilotKitCore.runAgent - Edge Cases", () => {
-  let copilotKitCore: CopilotKitCore;
-
-  beforeEach(() => {
-    copilotKitCore = new CopilotKitCore({});
-    vi.clearAllMocks();
-  });
-
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  it("should skip tool call when result already exists in newMessages", async () => {
-    const tool = createTool({
-      name: "alreadyProcessedTool",
-      handler: vi.fn(async () => "Should not be called"),
-    });
-    copilotKitCore.addTool(tool);
-
-    const toolCallId = "processed-call";
-    const assistantMsg = createToolCallMessage("alreadyProcessedTool");
-    if (assistantMsg.role === 'assistant' && assistantMsg.toolCalls && assistantMsg.toolCalls[0]) {
-      assistantMsg.toolCalls[0].id = toolCallId;
-    }
-    const existingResult = createToolResultMessage(toolCallId, "Already processed");
-
-    const agent = new MockAgent({
-      newMessages: [assistantMsg, existingResult],
-    });
-
-    await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(tool.handler).not.toHaveBeenCalled();
-  });
-
-  it("should handle empty tool function name", async () => {
-    const message = createAssistantMessage({
-      content: "",
-      toolCalls: [{
-        id: "empty-name-call",
-        type: "function",
-        function: {
-          name: "",
-          arguments: "{}",
-        },
-      }],
-    });
-
-    const agent = new MockAgent({ newMessages: [message] });
-
-    await copilotKitCore.runAgent({ agent: agent as any });
-
-    expect(agent.messages.filter(m => m.role === "tool")).toHaveLength(0);
-  });
-
-  it("should handle tool arguments as empty string", async () => {
-    const tool = createTool({
-      name: "emptyArgsTool",
-      handler: vi.fn(async (args) => `Received: ${JSON.stringify(args)}`),
-    });
-    copilotKitCore.addTool(tool);
-
-    const message = createAssistantMessage({
-      content: "",
-      toolCalls: [{
-        id: "empty-args-call",
-        type: "function",
-        function: {
-          name: "emptyArgsTool",
-          arguments: "",
-        },
-      }],
-    });
-
-    const agent = new MockAgent({ newMessages: [message] });
-
-    await expect(copilotKitCore.runAgent({ agent: agent as any })).rejects.toThrow();
-  });
-
-  it("should handle very large tool result", async () => {
-    const largeResult = "x".repeat(100000); // 100KB string
-    const tool = createTool({
-      name: "largeTool",
-      handler: vi.fn(async () => largeResult),
-      followUp: false,
-    });
-    copilotKitCore.addTool(tool);
-
-    const message = createToolCallMessage("largeTool");
-    const agent = new MockAgent({ newMessages: [message] });
-
-    await copilotKitCore.runAgent({ agent: agent as any });
-
-    const toolMessage = agent.messages.find(m => m.role === "tool");
-    expect(toolMessage?.content).toBe(largeResult);
-  });
-
-  it("should handle tool handler modifying agent state", async () => {
-    const tool = createTool({
-      name: "stateTool",
-      handler: vi.fn(async () => {
-        // Try to modify agent messages during execution
-        agent.messages.push(createAssistantMessage({ content: "Injected" }));
-        return "Result";
-      }),
-      followUp: false,
-    });
-    copilotKitCore.addTool(tool);
-
-    const message = createToolCallMessage("stateTool");
-    const agent = new MockAgent({ newMessages: [message] });
-
-    await copilotKitCore.runAgent({ agent: agent as any });
-
-    // The injected message should be present
-    expect(agent.messages.some(m => m.content === "Injected")).toBe(true);
-    // Tool result should still be added correctly
-    expect(agent.messages.some(m => m.role === "tool" && m.content === "Result")).toBe(true);
-  });
-
-  it("should propagate errors from agent.runAgent", async () => {
-    const errorMessage = "Agent execution failed";
-    const agent = new MockAgent({ 
-      error: new Error(errorMessage)
-    });
-
-    await expect(copilotKitCore.runAgent({ agent: agent as any }))
-      .rejects
-      .toThrow(errorMessage);
-  });
-
-  it("should handle tool with invalid JSON arguments", async () => {
-    const toolName = "invalidJsonTool";
-    const tool = createTool({
-      name: toolName,
-      handler: vi.fn(async () => "Should not be called"),
-    });
-    copilotKitCore.addTool(tool);
-
-    const message = createAssistantMessage({
-      content: "",
-      toolCalls: [{
-        id: "tool-call-1",
-        type: "function",
-        function: {
-          name: toolName,
-          arguments: "{ invalid json",
-        },
-      }],
-    });
-    const agent = new MockAgent({ newMessages: [message] });
-
-    await expect(copilotKitCore.runAgent({ agent: agent as any })).rejects.toThrow();
-    expect(tool.handler).not.toHaveBeenCalled();
-  });
-});