@codespar/sdk 0.1.0 → 0.2.2

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/dist/types.d.ts CHANGED
@@ -4,13 +4,11 @@ export interface CodeSparConfig {
4
4
  apiKey?: string;
5
5
  /** Base URL for CodeSpar API. Defaults to https://api.codespar.dev */
6
6
  baseUrl?: string;
7
- /** Enable managed mode (billing, logging, rate limiting via CodeSpar backend) */
8
- managed?: boolean;
9
7
  }
10
8
  export interface SessionConfig {
11
- /** MCP servers to connect. Use package names or IDs. */
9
+ /** MCP servers to connect, by id (e.g. "zoop", "nuvem-fiscal") */
12
10
  servers?: string[];
13
- /** Preset configurations. "brazilian" enables all BR servers. */
11
+ /** Preset configurations. "brazilian" enables BR commerce servers. */
14
12
  preset?: "brazilian" | "mexican" | "argentinian" | "colombian" | "all";
15
13
  /** Connection management options */
16
14
  manageConnections?: {
@@ -23,62 +21,111 @@ export interface SessionConfig {
23
21
  metadata?: Record<string, string>;
24
22
  }
25
23
  export interface Session {
26
- /** Unique session ID */
24
+ /** Unique session ID (e.g. "ses_HZb4d5yxIAxLawb4") */
27
25
  id: string;
28
26
  /** User ID that owns this session */
29
27
  userId: string;
30
- /** Connected servers */
31
- servers: ServerConnection[];
28
+ /** IDs of the servers attached to this session */
29
+ servers: string[];
32
30
  /** Session creation timestamp */
33
31
  createdAt: Date;
34
- /** Get all available tools from connected servers */
35
- tools(): Tool[];
36
- /** Find tools by intent description */
37
- findTools(intent: string): Tool[];
38
- /** Execute a specific tool */
39
- execute(toolName: string, params: Record<string, unknown>): Promise<ToolResult>;
40
- /** Run a Complete Loop workflow */
41
- loop(config: LoopConfig): Promise<LoopResult>;
42
- /** Send a natural language message for the agent to process */
43
- send(message: string): Promise<SendResult>;
44
- /** Initiate OAuth flow for a server */
45
- authorize(serverId: string, config?: AuthConfig): Promise<AuthResult>;
46
- /** List connected servers and their auth status */
47
- connections(): Promise<ServerConnection[]>;
48
- /** MCP transport URLs for IDE integration */
32
+ /** Session status */
33
+ status: "active" | "closed" | "error";
34
+ /**
35
+ * MCP transport endpoint for this session. Pass to @codespar/mcp helpers
36
+ * (getClaudeDesktopConfig, getCursorConfig) to generate config files for
37
+ * MCP-compatible clients.
38
+ *
39
+ * Note: the runtime MCP endpoint is not yet implemented in the backend
40
+ * (planned for Marco 3). The URL is provided so config generators can
41
+ * produce the correct values today; runtime connection will work once
42
+ * the backend MCP transport ships.
43
+ */
49
44
  mcp: {
50
45
  url: string;
51
46
  headers: Record<string, string>;
52
47
  };
53
- /** Close session and clean up resources */
48
+ /**
49
+ * Get tools available in this session. Loads from the backend on first
50
+ * call and caches. Call connections() to refresh.
51
+ */
52
+ tools(): Promise<Tool[]>;
53
+ /**
54
+ * Find tools by intent description. Loads tools first if not cached.
55
+ */
56
+ findTools(intent: string): Promise<Tool[]>;
57
+ /**
58
+ * Execute a specific tool by name. Tool calls are logged on the
59
+ * backend with input + output for billing and audit.
60
+ */
61
+ execute(toolName: string, params: Record<string, unknown>): Promise<ToolResult>;
62
+ /** Run a Complete Loop workflow. */
63
+ loop(config: LoopConfig): Promise<LoopResult>;
64
+ /**
65
+ * Proxy a raw HTTP request to a connected server's upstream API with
66
+ * credentials injected server-side. Lets an agent call any endpoint of
67
+ * a toolkit — not just pre-defined tools — without ever seeing the
68
+ * provider API key. The backend handles auth injection, rate limiting,
69
+ * and logs the call for audit/billing.
70
+ */
71
+ proxyExecute(request: ProxyRequest): Promise<ProxyResult>;
72
+ /**
73
+ * Send a natural-language message. Drives a Claude tool-use loop on
74
+ * the backend and returns the full transcript when done.
75
+ */
76
+ send(message: string): Promise<SendResult>;
77
+ /**
78
+ * Stream a natural-language message. Yields events as the agent
79
+ * runs (assistant text, tool_use, tool_result, done).
80
+ */
81
+ sendStream(message: string): AsyncIterable<StreamEvent>;
82
+ /**
83
+ * Start a Connect Link OAuth flow for a server. Returns a link token
84
+ * + authorize URL the end-user opens to grant provider access.
85
+ *
86
+ * Pass `config.redirectUri` so the provider redirects back to your
87
+ * UI after the user authorizes — CodeSpar's callback stores the
88
+ * tokens in the vault and forwards the user there with
89
+ * `?status=connected&connection_id=<id>` appended.
90
+ */
91
+ authorize(serverId: string, config: AuthConfig): Promise<AuthResult>;
92
+ /**
93
+ * List server connections + available tools. Refreshes the internal
94
+ * tools cache as a side effect.
95
+ */
96
+ connections(): Promise<ServerConnection[]>;
97
+ /** Close session and release resources. */
54
98
  close(): Promise<void>;
55
99
  }
56
100
  export interface Tool {
57
- /** Fully qualified tool name (e.g., ZOOP_CREATE_CHARGE) */
101
+ /** Tool name (e.g. "codespar_pay") */
58
102
  name: string;
59
- /** Tool slug for execution */
60
- slug: string;
61
- /** Human-readable description */
103
+ /** Human-readable description shown to LLMs */
62
104
  description: string;
63
- /** Server that provides this tool */
105
+ /** JSON Schema for tool inputs */
106
+ input_schema: Record<string, unknown>;
107
+ /** Server that provides this tool (for routing/billing). May be "codespar" for meta-tools. */
64
108
  server: string;
65
- /** Input schema (JSON Schema) */
66
- inputSchema: Record<string, unknown>;
67
109
  }
68
110
  export interface ToolResult {
111
+ /** Whether the call succeeded */
69
112
  success: boolean;
113
+ /** Tool output (varies by tool) */
70
114
  data: unknown;
71
- error?: string;
115
+ /** Error message if failed */
116
+ error: string | null;
72
117
  /** Execution time in ms */
73
118
  duration: number;
74
119
  /** Server that executed the tool */
75
120
  server: string;
76
121
  /** Tool that was executed */
77
122
  tool: string;
123
+ /** Backend tool-call id for cross-referencing logs */
124
+ tool_call_id?: string;
125
+ /** Timestamp the call was logged */
126
+ called_at?: string;
78
127
  }
79
128
  export interface LoopStep {
80
- /** Server ID or package name */
81
- server: string;
82
129
  /** Tool name to execute */
83
130
  tool: string;
84
131
  /** Tool parameters */
@@ -113,43 +160,106 @@ export interface LoopResult {
113
160
  /** Total steps attempted */
114
161
  totalSteps: number;
115
162
  }
163
+ export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
164
+ export interface ProxyRequest {
165
+ /** Server id that owns the upstream API (e.g. "stripe", "asaas"). */
166
+ server: string;
167
+ /** Upstream path, relative to the server's base URL (e.g. "/v1/charges"). */
168
+ endpoint: string;
169
+ /** HTTP method. */
170
+ method: HttpMethod;
171
+ /** JSON body. Ignored for GET. */
172
+ body?: unknown;
173
+ /** Query string parameters. */
174
+ params?: Record<string, string | number | boolean>;
175
+ /** Extra headers to forward. Auth headers are injected by the backend — never send them here. */
176
+ headers?: Record<string, string>;
177
+ }
178
+ export interface ProxyResult {
179
+ /** HTTP status code returned by the upstream API. */
180
+ status: number;
181
+ /** Parsed JSON response body, or raw string if not JSON. */
182
+ data: unknown;
183
+ /** Response headers (lowercased keys). */
184
+ headers: Record<string, string>;
185
+ /** Upstream call duration in ms, as measured by the backend. */
186
+ duration: number;
187
+ /** Backend proxy-call id for cross-referencing logs. */
188
+ proxy_call_id?: string;
189
+ }
116
190
  export interface AuthConfig {
117
- /** API key for direct auth */
118
- token?: string;
119
- /** OAuth2 client credentials */
120
- clientId?: string;
121
- clientSecret?: string;
191
+ /** Where the provider sends the user after authorizing. HTTPS only. */
192
+ redirectUri: string;
193
+ /** Optional scope override (format is provider-specific). */
194
+ scopes?: string;
122
195
  }
123
196
  export interface AuthResult {
124
- /** Whether auth was successful */
125
- connected: boolean;
126
- /** OAuth redirect URL (if OAuth flow required) */
127
- redirectUrl?: string;
128
- /** Error message if failed */
129
- error?: string;
197
+ /** Opaque one-shot state token — echoed back on callback. */
198
+ linkToken: string;
199
+ /** URL the end-user opens to grant access. */
200
+ authorizeUrl: string;
201
+ /** When the state token expires (10min default). */
202
+ expiresAt: string;
130
203
  }
131
204
  export interface ServerConnection {
132
- /** Server ID */
205
+ /** Server id (e.g. "zoop") */
133
206
  id: string;
134
- /** Server display name */
207
+ /** Display name */
135
208
  name: string;
136
- /** npm package name */
137
- pkg: string;
138
- /** Whether the server is connected and ready */
209
+ /** Category (payments, fiscal, ecommerce, etc.) */
210
+ category: string;
211
+ /** Country code (BR, MX, AR, CO, GLOBAL) */
212
+ country: string;
213
+ /** Auth method */
214
+ auth_type: "oauth" | "api_key" | "cert" | "none";
215
+ /** Whether the server is connected and tools are callable */
139
216
  connected: boolean;
140
- /** Auth method used */
141
- auth: "oauth2" | "api_key" | "none";
142
- /** Number of tools available */
143
- toolCount: number;
144
217
  }
145
218
  export interface SendResult {
146
- /** Agent response text */
147
- text: string;
148
- /** Tools that were called */
149
- toolCalls: ToolResult[];
150
- /** Total execution time in ms */
151
- duration: number;
219
+ /** Final agent message text */
220
+ message: string;
221
+ /** Tools called during the run, in order */
222
+ tool_calls: ToolCallRecord[];
223
+ /** How many model iterations the loop ran */
224
+ iterations: number;
225
+ }
226
+ /**
227
+ * Single tool-call record returned by send / sendStream.
228
+ * Mirrors the backend's session_tool_calls row shape.
229
+ */
230
+ export interface ToolCallRecord {
231
+ id: string;
232
+ tool_name: string;
233
+ server_id: string;
234
+ status: "success" | "error";
235
+ duration_ms: number;
236
+ input: unknown;
237
+ output: unknown;
238
+ error_code: string | null;
152
239
  }
240
+ export type StreamEvent = {
241
+ type: "user_message";
242
+ content: string;
243
+ } | {
244
+ type: "assistant_text";
245
+ content: string;
246
+ iteration: number;
247
+ } | {
248
+ type: "tool_use";
249
+ id: string;
250
+ name: string;
251
+ input: Record<string, unknown>;
252
+ } | {
253
+ type: "tool_result";
254
+ toolCall: ToolCallRecord;
255
+ } | {
256
+ type: "done";
257
+ result: SendResult;
258
+ } | {
259
+ type: "error";
260
+ error: string;
261
+ message?: string;
262
+ };
153
263
  export declare const SessionConfigSchema: z.ZodObject<{
154
264
  servers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
155
265
  preset: z.ZodOptional<z.ZodEnum<["brazilian", "mexican", "argentinian", "colombian", "all"]>>;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js CHANGED
@@ -1,12 +1,14 @@
1
1
  import { z } from "zod";
2
- /* ── Validation schemas ── */
2
+ /* ── Validation schemas ───────────────────────────────────────── */
3
3
  export const SessionConfigSchema = z.object({
4
4
  servers: z.array(z.string()).optional(),
5
5
  preset: z.enum(["brazilian", "mexican", "argentinian", "colombian", "all"]).optional(),
6
- manageConnections: z.object({
6
+ manageConnections: z
7
+ .object({
7
8
  waitForConnections: z.boolean().optional(),
8
9
  timeout: z.number().optional(),
9
- }).optional(),
10
+ })
11
+ .optional(),
10
12
  metadata: z.record(z.string()).optional(),
11
13
  });
12
14
  //# sourceMappingURL=types.js.map
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgLxB,8BAA8B;AAE9B,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,CAAC,MAAM,CAAC;QAC1B,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CAAC,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkSxB,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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codespar/sdk",
3
- "version": "0.1.0",
3
+ "version": "0.2.2",
4
4
  "description": "Commerce SDK for AI agents — sessions, managed auth, Complete Loop orchestration for Latin American APIs",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",