@codespar/sdk 0.0.1 → 0.2.0

package/README.md

@@ -0,0 +1,79 @@
+# @codespar/sdk
+
+Commerce SDK for AI agents — sessions, managed auth, Complete Loop orchestration for Latin American commercial APIs.
+
+## Install
+
+```bash
+npm install @codespar/sdk
+```
+
+## Usage
+
+```typescript
+import { CodeSpar } from "@codespar/sdk";
+
+const cs = new CodeSpar({ apiKey: "ak_..." });
+
+const session = await cs.create("user_123", {
+  preset: "brazilian",
+  manageConnections: { waitForConnections: true },
+});
+
+// Natural language
+const result = await session.send("Charge R$150 via Pix and issue the NF-e");
+
+// Direct tool execution
+const charge = await session.execute("ZOOP_CREATE_CHARGE", {
+  amount: 150.0,
+  payment_type: "pix",
+});
+
+// Complete Loop
+const loop = await session.loop({
+  steps: [
+    { server: "mcp-zoop", tool: "ZOOP_CREATE_CHARGE", params: { amount: 150, payment_type: "pix" } },
+    { server: "mcp-nuvem-fiscal", tool: "NUVEMFISCAL_EMITIR_NFE", params: (prev) => ({ chargeId: prev[0].data }) },
+    { server: "mcp-melhor-envio", tool: "MELHORENVIO_GENERATE_LABEL", params: {} },
+    { server: "mcp-z-api", tool: "ZAPI_SEND_MESSAGE", params: { text: "Your order is on the way!" } },
+  ],
+  onStepComplete: (step, result) => console.log(`✓ ${step.tool}`),
+  retryPolicy: { maxRetries: 3, backoff: "exponential" },
+});
+```
+
+## API
+
+### `new CodeSpar(config)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | `CODESPAR_API_KEY` env | Your API key |
+| `baseUrl` | `string` | `https://api.codespar.dev` | API base URL |
+| `managed` | `boolean` | `true` | Enable managed billing/logging |
+
+### `cs.create(userId, config)`
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `servers` | `string[]` | MCP servers to connect |
+| `preset` | `string` | `"brazilian"`, `"mexican"`, `"argentinian"`, `"colombian"`, `"all"` |
+| `manageConnections.waitForConnections` | `boolean` | Block until all servers connected |
+
+### Session Methods
+
+| Method | Description |
+|--------|-------------|
+| `session.tools()` | Get all available tools |
+| `session.findTools(intent)` | Search tools by description |
+| `session.execute(tool, params)` | Execute a specific tool |
+| `session.send(message)` | Send natural language message |
+| `session.loop(config)` | Run Complete Loop workflow |
+| `session.authorize(serverId)` | Start OAuth flow for a server |
+| `session.connections()` | List connected servers |
+| `session.mcp` | MCP transport URL and headers |
+| `session.close()` | Close session |
+
+## License
+
+MIT — [codespar.dev](https://codespar.dev)

package/dist/__tests__/codespar.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @codespar/sdk basic tests.
+ *
+ * The 0.1.0 test suite assumed an older client-shaped API and has been
+ * replaced for 0.2.0. Comprehensive integration tests (mocking fetch
+ * against the api.codespar.dev contract) are tracked for a follow-up.
+ */
+export {};
+//# sourceMappingURL=codespar.test.d.ts.map

package/dist/__tests__/codespar.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codespar.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/codespar.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/codespar.test.js

@@ -0,0 +1,135 @@
+/**
+ * @codespar/sdk basic tests.
+ *
+ * The 0.1.0 test suite assumed an older client-shaped API and has been
+ * replaced for 0.2.0. Comprehensive integration tests (mocking fetch
+ * against the api.codespar.dev contract) are tracked for a follow-up.
+ */
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { CodeSpar } from "../index.js";
+import { SessionConfigSchema } from "../types.js";
+describe("CodeSpar constructor", () => {
+    it("requires an API key", () => {
+        const prev = process.env.CODESPAR_API_KEY;
+        delete process.env.CODESPAR_API_KEY;
+        try {
+            expect(() => new CodeSpar({})).toThrow(/API key is required/);
+        }
+        finally {
+            if (prev)
+                process.env.CODESPAR_API_KEY = prev;
+        }
+    });
+    it("accepts apiKey via constructor", () => {
+        const cs = new CodeSpar({ apiKey: "csk_live_test" });
+        expect(cs).toBeDefined();
+    });
+    it("accepts apiKey via env var", () => {
+        process.env.CODESPAR_API_KEY = "csk_live_envtest";
+        try {
+            const cs = new CodeSpar();
+            expect(cs).toBeDefined();
+        }
+        finally {
+            delete process.env.CODESPAR_API_KEY;
+        }
+    });
+    it("defaults baseUrl to api.codespar.dev", () => {
+        process.env.CODESPAR_API_KEY = "csk_live_test";
+        process.env.CODESPAR_BASE_URL = "";
+        try {
+            const cs = new CodeSpar();
+            // baseUrl is private but the constructor logic verifies the default.
+            expect(cs).toBeDefined();
+        }
+        finally {
+            delete process.env.CODESPAR_API_KEY;
+            delete process.env.CODESPAR_BASE_URL;
+        }
+    });
+});
+describe("SessionConfigSchema", () => {
+    it("accepts an empty config", () => {
+        expect(() => SessionConfigSchema.parse({})).not.toThrow();
+    });
+    it("accepts servers as a string array", () => {
+        expect(() => SessionConfigSchema.parse({ servers: ["zoop", "nuvem-fiscal"] })).not.toThrow();
+    });
+    it("accepts known presets", () => {
+        expect(() => SessionConfigSchema.parse({ preset: "brazilian" })).not.toThrow();
+        expect(() => SessionConfigSchema.parse({ preset: "mexican" })).not.toThrow();
+        expect(() => SessionConfigSchema.parse({ preset: "all" })).not.toThrow();
+    });
+    it("rejects unknown presets", () => {
+        expect(() => SessionConfigSchema.parse({ preset: "klingon" })).toThrow();
+    });
+    it("accepts manageConnections options", () => {
+        expect(() => SessionConfigSchema.parse({
+            manageConnections: { waitForConnections: true, timeout: 5000 },
+        })).not.toThrow();
+    });
+    it("accepts metadata", () => {
+        expect(() => SessionConfigSchema.parse({ metadata: { source: "sandbox" } })).not.toThrow();
+    });
+});
+describe("CodeSpar.create wires fetch correctly", () => {
+    const originalFetch = globalThis.fetch;
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    it("POSTs to /v1/sessions with snake_case body", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 201,
+            text: async () => "",
+            json: async () => ({
+                id: "ses_test123",
+                org_id: "org_test",
+                user_id: "user_42",
+                servers: ["zoop"],
+                status: "active",
+                created_at: new Date().toISOString(),
+                closed_at: null,
+            }),
+        });
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        const session = await cs.create("user_42", { servers: ["zoop"] });
+        expect(session.id).toBe("ses_test123");
+        expect(session.userId).toBe("user_42");
+        expect(session.servers).toEqual(["zoop"]);
+        // Assert the request body uses snake_case keys (not userId)
+        const callArgs = fetchMock.mock.calls[0];
+        expect(callArgs[0]).toBe("https://api.example.com/v1/sessions");
+        const init = callArgs[1];
+        expect(init.method).toBe("POST");
+        expect(init.headers.Authorization).toBe("Bearer csk_live_test");
+        const body = JSON.parse(init.body);
+        expect(body.servers).toEqual(["zoop"]);
+        expect(body.user_id).toBe("user_42");
+    });
+    it("populates session.mcp as a placeholder", async () => {
+        globalThis.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 201,
+            text: async () => "",
+            json: async () => ({
+                id: "ses_mcp",
+                org_id: "org_test",
+                user_id: "user_1",
+                servers: [],
+                status: "active",
+                created_at: new Date().toISOString(),
+                closed_at: null,
+            }),
+        });
+        const cs = new CodeSpar({ apiKey: "csk_live_test", baseUrl: "https://api.example.com" });
+        const session = await cs.create("user_1");
+        expect(session.mcp.url).toBe("https://api.example.com/v1/sessions/ses_mcp/mcp");
+        expect(session.mcp.headers.Authorization).toBe("Bearer csk_live_test");
+    });
+});
+//# sourceMappingURL=codespar.test.js.map

package/dist/__tests__/codespar.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codespar.test.js","sourceRoot":"","sources":["../../src/__tests__/codespar.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAChE,CAAC;gBAAS,CAAC;YACT,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kBAAkB,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,eAAe,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC1B,qEAAqE;YACrE,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACpC,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,EAAE,CACV,mBAAmB,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC,CACjE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC/E,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7E,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,EAAE,CACV,mBAAmB,CAAC,KAAK,CAAC;YACxB,iBAAiB,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;SAC/D,CAAC,CACH,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,GAAG,EAAE,CACV,mBAAmB,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAC/D,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,KAAK,GAAG,aAAa,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC1C,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;YACpB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBACjB,EAAE,EAAE,aAAa;gBACjB,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,CAAC,MAAM,CAAC;gBACjB,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,IAAI;aAChB,CAAC;SACH,CAAC,CAAC;QACH,UAAU,CAAC,KAAK,GAAG,SAAoC,CAAC;QAExD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC;YACtB,MAAM,EAAE,eAAe;YACvB,OAAO,EAAE,yBAAyB;SACnC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAElE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAE1C,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAsE,CAAC;QAC9F,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAA2C,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC3C,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;YACpB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBACjB,EAAE,EAAE,SAAS;gBACb,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,IAAI;aAChB,CAAC;SACH,CAA4B,CAAC;QAE9B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC;QACzF,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAChF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @codespar/sdk — Commerce SDK for AI agents
+ *
+ * Sessions, managed auth, Complete Loop orchestration for Latin American
+ * commercial APIs. Talks to api.codespar.dev — see the backend at
+ * codespar/codespar-enterprise (packages/api) for the wire contract.
+ *
+ * @example
+ * ```ts
+ * import { CodeSpar } from "@codespar/sdk";
+ *
+ * const cs = new CodeSpar({ apiKey: "csk_live_..." });
+ * const session = await cs.create("user_123", { preset: "brazilian" });
+ *
+ * // One-shot natural language
+ * const result = await session.send("Charge R$150 via Pix and issue the NF-e");
+ *
+ * // Or stream the agent's thinking + tool calls
+ * for await (const event of session.sendStream("Charge R$150 via Pix")) {
+ *   if (event.type === "tool_result") console.log(event.toolCall);
+ *   if (event.type === "assistant_text") console.log(event.content);
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { CodeSparConfig, Session, SessionConfig, Tool, ToolResult, LoopConfig, LoopStep, LoopResult, AuthConfig, AuthResult, ServerConnection, SendResult, ToolCallRecord, StreamEvent, } from "./types.js";
+export { SessionConfigSchema } from "./types.js";
+import type { CodeSparConfig, Session, SessionConfig } from "./types.js";
+export declare class CodeSpar {
+    private readonly config;
+    constructor(config?: CodeSparConfig);
+    /**
+     * Create a new session for a user.
+     *
+     * @param userId - Unique user identifier
+     * @param config - Session configuration (servers, preset, metadata)
+     */
+    create(userId: string, config?: SessionConfig): Promise<Session>;
+}
+export default CodeSpar;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,YAAY,EACV,cAAc,EACd,OAAO,EACP,aAAa,EACb,IAAI,EACJ,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMzE,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,MAAM,GAAE,cAAmB;IAcvC;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;CAO3E;AAED,eAAe,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+/**
+ * @codespar/sdk — Commerce SDK for AI agents
+ *
+ * Sessions, managed auth, Complete Loop orchestration for Latin American
+ * commercial APIs. Talks to api.codespar.dev — see the backend at
+ * codespar/codespar-enterprise (packages/api) for the wire contract.
+ *
+ * @example
+ * ```ts
+ * import { CodeSpar } from "@codespar/sdk";
+ *
+ * const cs = new CodeSpar({ apiKey: "csk_live_..." });
+ * const session = await cs.create("user_123", { preset: "brazilian" });
+ *
+ * // One-shot natural language
+ * const result = await session.send("Charge R$150 via Pix and issue the NF-e");
+ *
+ * // Or stream the agent's thinking + tool calls
+ * for await (const event of session.sendStream("Charge R$150 via Pix")) {
+ *   if (event.type === "tool_result") console.log(event.toolCall);
+ *   if (event.type === "assistant_text") console.log(event.content);
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { SessionConfigSchema } from "./types.js";
+import { SessionConfigSchema } from "./types.js";
+import { createSession } from "./session.js";
+const DEFAULT_BASE_URL = "https://api.codespar.dev";
+export class CodeSpar {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            apiKey: config.apiKey || process.env.CODESPAR_API_KEY || "",
+            baseUrl: config.baseUrl || process.env.CODESPAR_BASE_URL || DEFAULT_BASE_URL,
+        };
+        if (!this.config.apiKey) {
+            throw new Error("CodeSpar API key is required. Pass { apiKey: '...' } or set CODESPAR_API_KEY env var.\n" +
+                "Get your key at https://codespar.dev/dashboard/settings?tab=api-keys");
+        }
+    }
+    /**
+     * Create a new session for a user.
+     *
+     * @param userId - Unique user identifier
+     * @param config - Session configuration (servers, preset, metadata)
+     */
+    async create(userId, config = {}) {
+        SessionConfigSchema.parse(config);
+        return createSession(userId, config, {
+            baseUrl: this.config.baseUrl,
+            apiKey: this.config.apiKey,
+        });
+    }
+}
+export default CodeSpar;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAmBH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAEpD,MAAM,OAAO,QAAQ;IACF,MAAM,CAA2B;IAElD,YAAY,SAAyB,EAAE;QACrC,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE;YAC3D,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,gBAAgB;SAC7E,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,yFAAyF;gBACvF,sEAAsE,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,SAAwB,EAAE;QACrD,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE;YACnC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC,CAAC;IACL,CAAC;CACF;AAED,eAAe,QAAQ,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Session implementation — talks to api.codespar.dev backend.
+ *
+ * The shape of every request and response in this file matches what the
+ * backend (codespar-enterprise/packages/api) actually exposes. Do not edit
+ * one without the other.
+ */
+import type { Session, SessionConfig } from "./types.js";
+interface SessionDeps {
+    baseUrl: string;
+    apiKey: string;
+}
+export declare function createSession(userId: string, config: SessionConfig, deps: SessionDeps): Promise<Session>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EAUd,MAAM,YAAY,CAAC;AAEpB,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,OAAO,CAAC,CAkNlB"}

package/dist/session.js

@@ -0,0 +1,307 @@
+/**
+ * Session implementation — talks to api.codespar.dev backend.
+ *
+ * The shape of every request and response in this file matches what the
+ * backend (codespar-enterprise/packages/api) actually exposes. Do not edit
+ * one without the other.
+ */
+export async function createSession(userId, config, deps) {
+    const { baseUrl, apiKey } = deps;
+    const headers = {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+    };
+    // Resolve servers from preset if not explicit. The backend doesn't know
+    // about presets — it expects an explicit array of server ids.
+    const servers = config.servers ?? presetToServers(config.preset);
+    const res = await fetch(`${baseUrl}/v1/sessions`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ servers, user_id: userId }),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`createSession failed: ${res.status} ${body}`);
+    }
+    const data = (await res.json());
+    let cachedTools = null;
+    let cachedConnections = null;
+    const session = {
+        id: data.id,
+        userId: data.user_id,
+        servers: data.servers,
+        createdAt: new Date(data.created_at),
+        status: data.status,
+        // Placeholder MCP transport URL — runtime endpoint lands in Marco 3.
+        // Kept here so @codespar/mcp config helpers work today.
+        mcp: {
+            url: `${baseUrl}/v1/sessions/${data.id}/mcp`,
+            headers: { Authorization: `Bearer ${apiKey}` },
+        },
+        async tools() {
+            if (cachedTools)
+                return cachedTools;
+            await session.connections();
+            return cachedTools ?? [];
+        },
+        async findTools(intent) {
+            const all = await session.tools();
+            const q = intent.toLowerCase();
+            return all.filter((t) => t.name.toLowerCase().includes(q) ||
+                t.description.toLowerCase().includes(q));
+        },
+        async execute(toolName, params) {
+            const start = Date.now();
+            const r = await fetch(`${baseUrl}/v1/sessions/${data.id}/execute`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ tool: toolName, input: params }),
+            });
+            if (!r.ok) {
+                const body = await r.text();
+                return {
+                    success: false,
+                    data: null,
+                    error: `${r.status}: ${body}`,
+                    duration: Date.now() - start,
+                    server: "",
+                    tool: toolName,
+                };
+            }
+            const result = (await r.json());
+            return result;
+        },
+        async loop(loopConfig) {
+            const start = Date.now();
+            const results = [];
+            const maxRetries = loopConfig.retryPolicy?.maxRetries ?? 0;
+            const abortOnError = loopConfig.abortOnError ?? true;
+            for (let i = 0; i < loopConfig.steps.length; i++) {
+                const step = loopConfig.steps[i];
+                if (step.when && !step.when(results))
+                    continue;
+                const params = typeof step.params === "function" ? step.params(results) : step.params;
+                let lastError = null;
+                let result = null;
+                for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                    try {
+                        result = await session.execute(step.tool, params);
+                        if (result.success) {
+                            lastError = null;
+                            break;
+                        }
+                        lastError = new Error(result.error || "Tool execution failed");
+                    }
+                    catch (err) {
+                        lastError = err instanceof Error ? err : new Error(String(err));
+                    }
+                    if (attempt < maxRetries) {
+                        const baseDelay = loopConfig.retryPolicy?.baseDelay ?? 1000;
+                        const delay = loopConfig.retryPolicy?.backoff === "exponential"
+                            ? baseDelay * Math.pow(2, attempt)
+                            : baseDelay * (attempt + 1);
+                        await new Promise((resolve) => setTimeout(resolve, delay));
+                    }
+                }
+                if (lastError || !result?.success) {
+                    if (loopConfig.onStepError) {
+                        loopConfig.onStepError(step, lastError || new Error("Unknown error"), i);
+                    }
+                    if (result)
+                        results.push(result);
+                    if (abortOnError) {
+                        return {
+                            success: false,
+                            results,
+                            duration: Date.now() - start,
+                            completedSteps: results.filter((r) => r.success).length,
+                            totalSteps: loopConfig.steps.length,
+                        };
+                    }
+                    continue;
+                }
+                results.push(result);
+                if (loopConfig.onStepComplete) {
+                    loopConfig.onStepComplete(step, result, i);
+                }
+            }
+            return {
+                success: results.every((r) => r.success),
+                results,
+                duration: Date.now() - start,
+                completedSteps: results.filter((r) => r.success).length,
+                totalSteps: loopConfig.steps.length,
+            };
+        },
+        async send(message) {
+            const r = await fetch(`${baseUrl}/v1/sessions/${data.id}/send`, {
+                method: "POST",
+                headers: { ...headers, Accept: "application/json" },
+                body: JSON.stringify({ message }),
+            });
+            if (!r.ok) {
+                const body = await r.text();
+                throw new Error(`send failed: ${r.status} ${body}`);
+            }
+            return (await r.json());
+        },
+        async *sendStream(message) {
+            const r = await fetch(`${baseUrl}/v1/sessions/${data.id}/send`, {
+                method: "POST",
+                headers: { ...headers, Accept: "text/event-stream" },
+                body: JSON.stringify({ message }),
+            });
+            if (!r.ok || !r.body) {
+                const body = await r.text();
+                throw new Error(`sendStream failed: ${r.status} ${body}`);
+            }
+            yield* parseSseStream(r.body);
+        },
+        async authorize(_serverId, _config) {
+            return {
+                connected: false,
+                error: "session.authorize() is not implemented in @codespar/sdk@0.2.0 — coming in Marco 3. " +
+                    "For now, configure auth via the dashboard at https://codespar.dev/dashboard/auth-configs",
+            };
+        },
+        async connections() {
+            const r = await fetch(`${baseUrl}/v1/sessions/${data.id}/connections`, {
+                headers,
+            });
+            if (!r.ok)
+                return cachedConnections ?? [];
+            const payload = (await r.json());
+            cachedConnections = payload.servers;
+            cachedTools = payload.tools;
+            return payload.servers;
+        },
+        async close() {
+            await fetch(`${baseUrl}/v1/sessions/${data.id}`, {
+                method: "DELETE",
+                headers,
+            });
+        },
+    };
+    if (config.manageConnections?.waitForConnections) {
+        const timeout = config.manageConnections.timeout ?? 30000;
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            const conns = await session.connections();
+            if (conns.every((c) => c.connected))
+                break;
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+        }
+    }
+    return session;
+}
+/**
+ * Parse a Server-Sent Events stream into typed StreamEvent objects.
+ *
+ * The backend emits events shaped like:
+ *   event: assistant_text
+ *   data: {"content":"...","iteration":1}
+ *
+ * which we map to discriminated-union StreamEvent values that the SDK
+ * exports. We intentionally keep parsing tiny: split on double newlines,
+ * pick out `event:` and `data:` lines, JSON-parse the data.
+ */
+async function* parseSseStream(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let sep;
+            while ((sep = buffer.indexOf("\n\n")) !== -1) {
+                const chunk = buffer.slice(0, sep);
+                buffer = buffer.slice(sep + 2);
+                const event = parseSseChunk(chunk);
+                if (event)
+                    yield event;
+            }
+        }
+        if (buffer.trim()) {
+            const event = parseSseChunk(buffer);
+            if (event)
+                yield event;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+function parseSseChunk(chunk) {
+    let eventName = "message";
+    let dataLine = "";
+    for (const line of chunk.split("\n")) {
+        if (line.startsWith("event:"))
+            eventName = line.slice(6).trim();
+        else if (line.startsWith("data:"))
+            dataLine += line.slice(5).trim();
+    }
+    if (!dataLine)
+        return null;
+    let data;
+    try {
+        data = JSON.parse(dataLine);
+    }
+    catch {
+        return null;
+    }
+    switch (eventName) {
+        case "user_message":
+            return { type: "user_message", content: data.content };
+        case "assistant_text":
+            return {
+                type: "assistant_text",
+                content: data.content,
+                iteration: data.iteration,
+            };
+        case "tool_use":
+            return {
+                type: "tool_use",
+                id: data.id,
+                name: data.name,
+                input: data.input,
+            };
+        case "tool_result":
+            return { type: "tool_result", toolCall: data };
+        case "done":
+            return { type: "done", result: data };
+        case "error":
+            return {
+                type: "error",
+                error: data.error,
+                message: data.message,
+            };
+        default:
+            return null;
+    }
+}
+const PRESET_SERVERS = {
+    brazilian: ["zoop", "nuvem-fiscal", "melhor-envio", "z-api", "omie"],
+    mexican: ["conekta", "facturapi", "skydropx"],
+    argentinian: ["afip", "andreani"],
+    colombian: ["wompi", "siigo", "coordinadora"],
+    all: [
+        "zoop",
+        "nuvem-fiscal",
+        "melhor-envio",
+        "z-api",
+        "omie",
+        "conekta",
+        "facturapi",
+        "afip",
+        "wompi",
+    ],
+};
+function presetToServers(preset) {
+    if (!preset)
+        return ["zoop", "nuvem-fiscal"]; // sensible default for sandbox
+    return PRESET_SERVERS[preset];
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,255 @@
+import { z } from "zod";
+export interface CodeSparConfig {
+    /** API key for managed mode. Obtain from dashboard.codespar.dev */
+    apiKey?: string;
+    /** Base URL for CodeSpar API. Defaults to https://api.codespar.dev */
+    baseUrl?: string;
+}
+export interface SessionConfig {
+    /** MCP servers to connect, by id (e.g. "zoop", "nuvem-fiscal") */
+    servers?: string[];
+    /** Preset configurations. "brazilian" enables BR commerce servers. */
+    preset?: "brazilian" | "mexican" | "argentinian" | "colombian" | "all";
+    /** Connection management options */
+    manageConnections?: {
+        /** Block until all servers are connected */
+        waitForConnections?: boolean;
+        /** Timeout in ms for connection wait. Default: 30000 */
+        timeout?: number;
+    };
+    /** Metadata attached to every tool call in this session */
+    metadata?: Record<string, string>;
+}
+export interface Session {
+    /** Unique session ID (e.g. "ses_HZb4d5yxIAxLawb4") */
+    id: string;
+    /** User ID that owns this session */
+    userId: string;
+    /** IDs of the servers attached to this session */
+    servers: string[];
+    /** Session creation timestamp */
+    createdAt: Date;
+    /** Session status */
+    status: "active" | "closed" | "error";
+    /**
+     * MCP transport endpoint for this session. Pass to @codespar/mcp helpers
+     * (getClaudeDesktopConfig, getCursorConfig) to generate config files for
+     * MCP-compatible clients.
+     *
+     * Note: the runtime MCP endpoint is not yet implemented in the backend
+     * (planned for Marco 3). The URL is provided so config generators can
+     * produce the correct values today; runtime connection will work once
+     * the backend MCP transport ships.
+     */
+    mcp: {
+        url: string;
+        headers: Record<string, string>;
+    };
+    /**
+     * Get tools available in this session. Loads from the backend on first
+     * call and caches. Call connections() to refresh.
+     */
+    tools(): Promise<Tool[]>;
+    /**
+     * Find tools by intent description. Loads tools first if not cached.
+     */
+    findTools(intent: string): Promise<Tool[]>;
+    /**
+     * Execute a specific tool by name. Tool calls are logged on the
+     * backend with input + output for billing and audit.
+     */
+    execute(toolName: string, params: Record<string, unknown>): Promise<ToolResult>;
+    /** Run a Complete Loop workflow. */
+    loop(config: LoopConfig): Promise<LoopResult>;
+    /**
+     * Send a natural-language message. Drives a Claude tool-use loop on
+     * the backend and returns the full transcript when done.
+     */
+    send(message: string): Promise<SendResult>;
+    /**
+     * Stream a natural-language message. Yields events as the agent
+     * runs (assistant text, tool_use, tool_result, done).
+     */
+    sendStream(message: string): AsyncIterable<StreamEvent>;
+    /**
+     * Initiate OAuth flow for a server.
+     * @deprecated Not implemented in 0.2.0 — coming in Marco 3.
+     */
+    authorize(serverId: string, config?: AuthConfig): Promise<AuthResult>;
+    /**
+     * List server connections + available tools. Refreshes the internal
+     * tools cache as a side effect.
+     */
+    connections(): Promise<ServerConnection[]>;
+    /** Close session and release resources. */
+    close(): Promise<void>;
+}
+export interface Tool {
+    /** Tool name (e.g. "codespar_pay") */
+    name: string;
+    /** Human-readable description shown to LLMs */
+    description: string;
+    /** JSON Schema for tool inputs */
+    input_schema: Record<string, unknown>;
+    /** Server that provides this tool (for routing/billing). May be "codespar" for meta-tools. */
+    server: string;
+}
+export interface ToolResult {
+    /** Whether the call succeeded */
+    success: boolean;
+    /** Tool output (varies by tool) */
+    data: unknown;
+    /** Error message if failed */
+    error: string | null;
+    /** Execution time in ms */
+    duration: number;
+    /** Server that executed the tool */
+    server: string;
+    /** Tool that was executed */
+    tool: string;
+    /** Backend tool-call id for cross-referencing logs */
+    tool_call_id?: string;
+    /** Timestamp the call was logged */
+    called_at?: string;
+}
+export interface LoopStep {
+    /** Tool name to execute */
+    tool: string;
+    /** Tool parameters */
+    params: Record<string, unknown> | ((prevResults: ToolResult[]) => Record<string, unknown>);
+    /** Optional: skip this step if condition returns false */
+    when?: (prevResults: ToolResult[]) => boolean;
+}
+export interface LoopConfig {
+    /** Steps to execute in order */
+    steps: LoopStep[];
+    /** Called after each step completes */
+    onStepComplete?: (step: LoopStep, result: ToolResult, index: number) => void;
+    /** Called if a step fails */
+    onStepError?: (step: LoopStep, error: Error, index: number) => void;
+    /** Retry policy for failed steps */
+    retryPolicy?: {
+        maxRetries?: number;
+        backoff?: "linear" | "exponential";
+        baseDelay?: number;
+    };
+    /** Abort all remaining steps on first failure. Default: true */
+    abortOnError?: boolean;
+}
+export interface LoopResult {
+    success: boolean;
+    /** Results from each step, in order */
+    results: ToolResult[];
+    /** Total execution time in ms */
+    duration: number;
+    /** Number of steps completed */
+    completedSteps: number;
+    /** Total steps attempted */
+    totalSteps: number;
+}
+export interface AuthConfig {
+    /** API key for direct auth */
+    token?: string;
+    /** OAuth2 client credentials */
+    clientId?: string;
+    clientSecret?: string;
+}
+export interface AuthResult {
+    /** Whether auth was successful */
+    connected: boolean;
+    /** OAuth redirect URL (if OAuth flow required) */
+    redirectUrl?: string;
+    /** Error message if failed */
+    error?: string;
+}
+export interface ServerConnection {
+    /** Server id (e.g. "zoop") */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Category (payments, fiscal, ecommerce, etc.) */
+    category: string;
+    /** Country code (BR, MX, AR, CO, GLOBAL) */
+    country: string;
+    /** Auth method */
+    auth_type: "oauth" | "api_key" | "cert" | "none";
+    /** Whether the server is connected and tools are callable */
+    connected: boolean;
+}
+export interface SendResult {
+    /** Final agent message text */
+    message: string;
+    /** Tools called during the run, in order */
+    tool_calls: ToolCallRecord[];
+    /** How many model iterations the loop ran */
+    iterations: number;
+}
+/**
+ * Single tool-call record returned by send / sendStream.
+ * Mirrors the backend's session_tool_calls row shape.
+ */
+export interface ToolCallRecord {
+    id: string;
+    tool_name: string;
+    server_id: string;
+    status: "success" | "error";
+    duration_ms: number;
+    input: unknown;
+    output: unknown;
+    error_code: string | null;
+}
+export type StreamEvent = {
+    type: "user_message";
+    content: string;
+} | {
+    type: "assistant_text";
+    content: string;
+    iteration: number;
+} | {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+} | {
+    type: "tool_result";
+    toolCall: ToolCallRecord;
+} | {
+    type: "done";
+    result: SendResult;
+} | {
+    type: "error";
+    error: string;
+    message?: string;
+};
+export declare const SessionConfigSchema: z.ZodObject<{
+    servers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    preset: z.ZodOptional<z.ZodEnum<["brazilian", "mexican", "argentinian", "colombian", "all"]>>;
+    manageConnections: z.ZodOptional<z.ZodObject<{
+        waitForConnections: z.ZodOptional<z.ZodBoolean>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        waitForConnections?: boolean | undefined;
+        timeout?: number | undefined;
+    }, {
+        waitForConnections?: boolean | undefined;
+        timeout?: number | undefined;
+    }>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    servers?: string[] | undefined;
+    preset?: "brazilian" | "mexican" | "argentinian" | "colombian" | "all" | undefined;
+    manageConnections?: {
+        waitForConnections?: boolean | undefined;
+        timeout?: number | undefined;
+    } | undefined;
+    metadata?: Record<string, string> | undefined;
+}, {
+    servers?: string[] | undefined;
+    preset?: "brazilian" | "mexican" | "argentinian" | "colombian" | "all" | undefined;
+    manageConnections?: {
+        waitForConnections?: boolean | undefined;
+        timeout?: number | undefined;
+    } | undefined;
+    metadata?: Record<string, string> | undefined;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+/* ── Validation schemas ───────────────────────────────────────── */
+export const SessionConfigSchema = z.object({
+    servers: z.array(z.string()).optional(),
+    preset: z.enum(["brazilian", "mexican", "argentinian", "colombian", "all"]).optional(),
+    manageConnections: z
+        .object({
+        waitForConnections: z.boolean().optional(),
+        timeout: z.number().optional(),
+    })
+        .optional(),
+    metadata: z.record(z.string()).optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqPxB,qEAAqE;AAErE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtF,iBAAiB,EAAE,CAAC;SACjB,MAAM,CAAC;QACN,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;SACD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}

package/package.json

@@ -1 +1,57 @@
-{"name":"@codespar/sdk","version":"0.0.1","description":"test"}
+{
+  "name": "@codespar/sdk",
+  "version": "0.2.0",
+  "description": "Commerce SDK for AI agents — sessions, managed auth, Complete Loop orchestration for Latin American APIs",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai-agent",
+    "commerce",
+    "mcp",
+    "pix",
+    "nfe",
+    "latam",
+    "sdk",
+    "codespar"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codespar/codespar-core",
+    "directory": "packages/core"
+  },
+  "homepage": "https://codespar.dev",
+  "bugs": {
+    "url": "https://github.com/codespar/codespar-core/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0"
+  }
+}