@jaibber/sdk 0.2.0 → 0.3.3
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/README.md +70 -70
- package/dist/cli.js +203 -18
- package/dist/index.cjs +188 -18
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +51 -1
- package/dist/index.d.ts +51 -1
- package/dist/index.js +185 -17
- package/dist/index.js.map +1 -1
- package/package.json +58 -58
package/dist/index.cjs
CHANGED
|
@@ -30,13 +30,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
30
30
|
// src/index.ts
|
|
31
31
|
var index_exports = {};
|
|
32
32
|
__export(index_exports, {
|
|
33
|
+
AGENT_TEMPLATES: () => AGENT_TEMPLATES,
|
|
33
34
|
AnthropicProvider: () => AnthropicProvider,
|
|
34
35
|
ClaudeCLIProvider: () => ClaudeCLIProvider,
|
|
35
36
|
GoogleProvider: () => GoogleProvider,
|
|
36
37
|
JaibberAgent: () => JaibberAgent,
|
|
37
38
|
MessageContext: () => MessageContext,
|
|
38
39
|
OpenAIProvider: () => OpenAIProvider,
|
|
39
|
-
TaskContext: () => TaskContext
|
|
40
|
+
TaskContext: () => TaskContext,
|
|
41
|
+
getTemplate: () => getTemplate
|
|
40
42
|
});
|
|
41
43
|
module.exports = __toCommonJS(index_exports);
|
|
42
44
|
|
|
@@ -189,6 +191,23 @@ var JaibberClient = class {
|
|
|
189
191
|
return data.data;
|
|
190
192
|
}
|
|
191
193
|
// ── Tasks ───────────────────────────────────────────────────────────
|
|
194
|
+
/** POST /api/projects/{id}/tasks — create a task. */
|
|
195
|
+
async createTask(projectId, data) {
|
|
196
|
+
const res = await fetch(
|
|
197
|
+
`${this.serverUrl}/api/projects/${projectId}/tasks`,
|
|
198
|
+
{
|
|
199
|
+
method: "POST",
|
|
200
|
+
headers: this.authHeaders(),
|
|
201
|
+
body: JSON.stringify(data)
|
|
202
|
+
}
|
|
203
|
+
);
|
|
204
|
+
if (!res.ok) {
|
|
205
|
+
const text = await res.text();
|
|
206
|
+
throw new Error(`Failed to create task (${res.status}): ${text}`);
|
|
207
|
+
}
|
|
208
|
+
const result = await res.json();
|
|
209
|
+
return result.data;
|
|
210
|
+
}
|
|
192
211
|
/** PATCH /api/tasks/{taskId} — update task fields. */
|
|
193
212
|
async updateTask(taskId, updates) {
|
|
194
213
|
const res = await fetch(`${this.serverUrl}/api/tasks/${taskId}`, {
|
|
@@ -226,7 +245,11 @@ var AblyManager = class {
|
|
|
226
245
|
callback(err, null);
|
|
227
246
|
}
|
|
228
247
|
},
|
|
229
|
-
clientId: this.userId
|
|
248
|
+
clientId: this.userId,
|
|
249
|
+
disconnectedRetryTimeout: 5e3,
|
|
250
|
+
// 5s initial retry on disconnect
|
|
251
|
+
suspendedRetryTimeout: 3e4
|
|
252
|
+
// 30s retry when suspended
|
|
230
253
|
});
|
|
231
254
|
this.ably.connection.once("connected", () => {
|
|
232
255
|
resolve();
|
|
@@ -238,6 +261,17 @@ var AblyManager = class {
|
|
|
238
261
|
)
|
|
239
262
|
);
|
|
240
263
|
});
|
|
264
|
+
this.ably.connection.on("disconnected", () => {
|
|
265
|
+
console.warn("[sdk] Ably disconnected, will retry...");
|
|
266
|
+
});
|
|
267
|
+
this.ably.connection.on("suspended", () => {
|
|
268
|
+
console.warn("[sdk] Ably connection suspended (extended outage)");
|
|
269
|
+
});
|
|
270
|
+
this.ably.connection.on("connected", () => {
|
|
271
|
+
if (this.channels.size > 0) {
|
|
272
|
+
console.log("[sdk] Ably reconnected");
|
|
273
|
+
}
|
|
274
|
+
});
|
|
241
275
|
});
|
|
242
276
|
}
|
|
243
277
|
/** Enter global presence channel (jaibber:presence). */
|
|
@@ -499,6 +533,18 @@ var TaskContext = class {
|
|
|
499
533
|
}).catch((err) => console.error("[sdk] Failed to persist:", err));
|
|
500
534
|
}
|
|
501
535
|
}
|
|
536
|
+
/**
|
|
537
|
+
* Create a follow-up task assigned to another agent.
|
|
538
|
+
* Automatically sets parentTaskId to the current task's ID.
|
|
539
|
+
*/
|
|
540
|
+
async createFollowUpTask(data) {
|
|
541
|
+
return this.client.createTask(this.projectId, {
|
|
542
|
+
...data,
|
|
543
|
+
parentTaskId: this.task.id,
|
|
544
|
+
createdByType: "agent",
|
|
545
|
+
createdByName: this.agentName
|
|
546
|
+
});
|
|
547
|
+
}
|
|
502
548
|
/** Send a chat message (for progress updates). */
|
|
503
549
|
async sendMessage(text) {
|
|
504
550
|
const msgId = (0, import_uuid.v4)();
|
|
@@ -523,13 +569,6 @@ var TaskContext = class {
|
|
|
523
569
|
};
|
|
524
570
|
|
|
525
571
|
// src/mentions.ts
|
|
526
|
-
function parseMentions(text) {
|
|
527
|
-
const mentions = [];
|
|
528
|
-
for (const match of text.matchAll(/@(\w+(?:\s+\w+)*)/g)) {
|
|
529
|
-
mentions.push(match[1].toLowerCase());
|
|
530
|
-
}
|
|
531
|
-
return mentions;
|
|
532
|
-
}
|
|
533
572
|
function mentionsAgent(text, agentName) {
|
|
534
573
|
const pattern = new RegExp(`@${escapeRegex(agentName)}(?!\\w)`, "i");
|
|
535
574
|
return pattern.test(text);
|
|
@@ -815,10 +854,28 @@ var GoogleProvider = class {
|
|
|
815
854
|
|
|
816
855
|
// src/providers/claude-cli.ts
|
|
817
856
|
var import_child_process = require("child_process");
|
|
857
|
+
var import_readline = require("readline");
|
|
818
858
|
var ClaudeCLIProvider = class {
|
|
819
859
|
projectDir;
|
|
860
|
+
sessionId;
|
|
861
|
+
continueSession;
|
|
862
|
+
/** Last session ID captured from Claude CLI stream-json output. */
|
|
863
|
+
lastSessionId;
|
|
820
864
|
constructor(options = {}) {
|
|
821
865
|
this.projectDir = options.projectDir ?? process.cwd();
|
|
866
|
+
this.sessionId = options.sessionId;
|
|
867
|
+
this.continueSession = options.continueSession ?? false;
|
|
868
|
+
}
|
|
869
|
+
/** Update session ID for future --resume calls. */
|
|
870
|
+
setSessionId(id) {
|
|
871
|
+
this.sessionId = id;
|
|
872
|
+
this.continueSession = false;
|
|
873
|
+
}
|
|
874
|
+
/** Clear session state (e.g. on conversation clear). */
|
|
875
|
+
clearSession() {
|
|
876
|
+
this.sessionId = void 0;
|
|
877
|
+
this.lastSessionId = void 0;
|
|
878
|
+
this.continueSession = false;
|
|
822
879
|
}
|
|
823
880
|
async *generate(prompt, systemPrompt, conversationContext) {
|
|
824
881
|
let fullPrompt = "";
|
|
@@ -834,7 +891,15 @@ ${systemPrompt}
|
|
|
834
891
|
fullPrompt += "\n\n---\n\n";
|
|
835
892
|
}
|
|
836
893
|
fullPrompt += prompt;
|
|
837
|
-
const
|
|
894
|
+
const args = ["--print", "--output-format", "stream-json", "--dangerously-skip-permissions"];
|
|
895
|
+
if (this.sessionId) {
|
|
896
|
+
if (/^[a-zA-Z0-9-]+$/.test(this.sessionId)) {
|
|
897
|
+
args.push("--resume", this.sessionId);
|
|
898
|
+
}
|
|
899
|
+
} else if (this.continueSession) {
|
|
900
|
+
args.push("--continue");
|
|
901
|
+
}
|
|
902
|
+
const child = (0, import_child_process.spawn)("claude", args, {
|
|
838
903
|
cwd: this.projectDir,
|
|
839
904
|
stdio: ["pipe", "pipe", "pipe"],
|
|
840
905
|
shell: false
|
|
@@ -845,16 +910,40 @@ ${systemPrompt}
|
|
|
845
910
|
child.stderr?.on("data", (chunk) => {
|
|
846
911
|
stderr += chunk.toString();
|
|
847
912
|
});
|
|
848
|
-
const
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
|
|
913
|
+
const rl = (0, import_readline.createInterface)({ input: child.stdout, crlfDelay: Infinity });
|
|
914
|
+
let gotOutput = false;
|
|
915
|
+
for await (const line of rl) {
|
|
916
|
+
try {
|
|
917
|
+
const json = JSON.parse(line);
|
|
918
|
+
if (json.session_id && typeof json.session_id === "string") {
|
|
919
|
+
this.lastSessionId = json.session_id;
|
|
920
|
+
}
|
|
921
|
+
if (json.delta?.text) {
|
|
922
|
+
gotOutput = true;
|
|
923
|
+
yield json.delta.text;
|
|
924
|
+
continue;
|
|
925
|
+
}
|
|
926
|
+
const content = json.content ?? json.message?.content;
|
|
927
|
+
if (Array.isArray(content)) {
|
|
928
|
+
for (const item of content) {
|
|
929
|
+
if (item.type === "text" && item.text) {
|
|
930
|
+
gotOutput = true;
|
|
931
|
+
yield item.text;
|
|
932
|
+
}
|
|
933
|
+
}
|
|
934
|
+
}
|
|
935
|
+
} catch {
|
|
936
|
+
if (line.trim()) {
|
|
937
|
+
gotOutput = true;
|
|
938
|
+
yield line + "\n";
|
|
939
|
+
}
|
|
940
|
+
}
|
|
852
941
|
}
|
|
853
942
|
const exitCode = await new Promise((resolve) => {
|
|
854
943
|
child.on("close", resolve);
|
|
855
944
|
});
|
|
856
945
|
if (exitCode !== 0 && exitCode !== null) {
|
|
857
|
-
if (!stderr.trim()) return;
|
|
946
|
+
if (gotOutput || !stderr.trim()) return;
|
|
858
947
|
throw new Error(`Claude CLI exited with code ${exitCode}: ${stderr.trim()}`);
|
|
859
948
|
}
|
|
860
949
|
}
|
|
@@ -878,6 +967,8 @@ var JaibberAgent = class extends import_events.EventEmitter {
|
|
|
878
967
|
history = /* @__PURE__ */ new Map();
|
|
879
968
|
/** Track in-flight responses to prevent double-handling. */
|
|
880
969
|
activeResponses = /* @__PURE__ */ new Set();
|
|
970
|
+
/** Session IDs per project for Claude --resume. */
|
|
971
|
+
sessionIds = /* @__PURE__ */ new Map();
|
|
881
972
|
constructor(config) {
|
|
882
973
|
super();
|
|
883
974
|
this.config = config;
|
|
@@ -988,6 +1079,10 @@ var JaibberAgent = class extends import_events.EventEmitter {
|
|
|
988
1079
|
}
|
|
989
1080
|
if (payload.isTaskNotification) return;
|
|
990
1081
|
if (payload.type !== "message" && payload.type !== "response") return;
|
|
1082
|
+
if (payload.text && payload.text.length > 1e5) {
|
|
1083
|
+
console.warn(`[sdk] Ignoring oversized message (${payload.text.length} chars)`);
|
|
1084
|
+
return;
|
|
1085
|
+
}
|
|
991
1086
|
this.addToHistory(project.id, {
|
|
992
1087
|
sender: payload.isAgentMessage ? "agent" : "user",
|
|
993
1088
|
senderName: payload.fromUsername,
|
|
@@ -1015,8 +1110,7 @@ var JaibberAgent = class extends import_events.EventEmitter {
|
|
|
1015
1110
|
const maxDepth = this.config.maxResponseDepth ?? DEFAULT_MAX_DEPTH;
|
|
1016
1111
|
if (depth >= maxDepth) return false;
|
|
1017
1112
|
if (chain.includes(this.config.agentName.toLowerCase())) return false;
|
|
1018
|
-
|
|
1019
|
-
if (mentions.length > 0 && !mentionsAgent(text, this.config.agentName)) return false;
|
|
1113
|
+
if (!mentionsAgent(text, this.config.agentName)) return false;
|
|
1020
1114
|
return true;
|
|
1021
1115
|
}
|
|
1022
1116
|
async respondToMessage(payload, project, incomingDepth, incomingChain) {
|
|
@@ -1054,10 +1148,12 @@ var JaibberAgent = class extends import_events.EventEmitter {
|
|
|
1054
1148
|
return;
|
|
1055
1149
|
}
|
|
1056
1150
|
if (this.provider) {
|
|
1151
|
+
this.updateProviderSession(project.id);
|
|
1057
1152
|
const systemPrompt = this.config.agentInstructions ?? "";
|
|
1058
1153
|
await ctx.stream(
|
|
1059
1154
|
() => this.provider.generate(payload.text, systemPrompt, conversationHistory)
|
|
1060
1155
|
);
|
|
1156
|
+
this.captureProviderSession(project.id);
|
|
1061
1157
|
return;
|
|
1062
1158
|
}
|
|
1063
1159
|
console.warn(
|
|
@@ -1110,6 +1206,7 @@ var JaibberAgent = class extends import_events.EventEmitter {
|
|
|
1110
1206
|
return;
|
|
1111
1207
|
}
|
|
1112
1208
|
if (this.provider) {
|
|
1209
|
+
this.updateProviderSession(project.id);
|
|
1113
1210
|
const taskPrompt = task.description ? `Task: ${task.title}
|
|
1114
1211
|
|
|
1115
1212
|
${task.description}` : `Task: ${task.title}`;
|
|
@@ -1134,6 +1231,7 @@ ${task.description}` : `Task: ${task.title}`;
|
|
|
1134
1231
|
conversationHistory
|
|
1135
1232
|
)
|
|
1136
1233
|
);
|
|
1234
|
+
this.captureProviderSession(project.id);
|
|
1137
1235
|
await this.client.updateTask(task.id, { status: "completed" });
|
|
1138
1236
|
} catch {
|
|
1139
1237
|
await this.client.updateTask(task.id, { status: "failed" });
|
|
@@ -1151,6 +1249,27 @@ ${task.description}` : `Task: ${task.title}`;
|
|
|
1151
1249
|
}
|
|
1152
1250
|
}
|
|
1153
1251
|
}
|
|
1252
|
+
// ── Session management (Claude --resume) ────────────────────────────
|
|
1253
|
+
/** Pass stored session ID to ClaudeCLIProvider before each invocation. */
|
|
1254
|
+
updateProviderSession(projectId) {
|
|
1255
|
+
if (this.provider instanceof ClaudeCLIProvider) {
|
|
1256
|
+
const sid = this.sessionIds.get(projectId);
|
|
1257
|
+
if (sid) {
|
|
1258
|
+
this.provider.setSessionId(sid);
|
|
1259
|
+
} else {
|
|
1260
|
+
this.provider.clearSession();
|
|
1261
|
+
}
|
|
1262
|
+
}
|
|
1263
|
+
}
|
|
1264
|
+
/** After response, capture the session ID from ClaudeCLIProvider if available. */
|
|
1265
|
+
captureProviderSession(projectId) {
|
|
1266
|
+
if (this.provider instanceof ClaudeCLIProvider) {
|
|
1267
|
+
const sid = this.provider.lastSessionId;
|
|
1268
|
+
if (sid) {
|
|
1269
|
+
this.sessionIds.set(projectId, sid);
|
|
1270
|
+
}
|
|
1271
|
+
}
|
|
1272
|
+
}
|
|
1154
1273
|
// ── Conversation history ────────────────────────────────────────────
|
|
1155
1274
|
async loadHistory(projectId) {
|
|
1156
1275
|
const contextSize = this.config.contextWindowSize ?? DEFAULT_CONTEXT_WINDOW;
|
|
@@ -1194,14 +1313,65 @@ ${task.description}` : `Task: ${task.title}`;
|
|
|
1194
1313
|
}).join("\n\n");
|
|
1195
1314
|
}
|
|
1196
1315
|
};
|
|
1316
|
+
|
|
1317
|
+
// src/templates.ts
|
|
1318
|
+
var AGENT_TEMPLATES = [
|
|
1319
|
+
{
|
|
1320
|
+
id: "code-writer",
|
|
1321
|
+
name: "Code Writer",
|
|
1322
|
+
description: "General-purpose coding agent",
|
|
1323
|
+
agentName: "Coder",
|
|
1324
|
+
instructions: "You are a skilled software engineer. When given a coding task:\n- Write clean, well-structured code that follows the project's existing patterns\n- Keep changes minimal and focused on the request\n- If you need to read files for context, do so before making changes\n- Prefer editing existing files over creating new ones\n- Do not add unnecessary comments, type annotations, or refactoring beyond the scope of the task"
|
|
1325
|
+
},
|
|
1326
|
+
{
|
|
1327
|
+
id: "pr-reviewer",
|
|
1328
|
+
name: "PR Reviewer",
|
|
1329
|
+
description: "Reviews code changes, suggests improvements",
|
|
1330
|
+
agentName: "Reviewer",
|
|
1331
|
+
instructions: "You are a thorough code reviewer. When reviewing changes:\n- Focus on correctness, security, and maintainability\n- Point out potential bugs, edge cases, and performance issues\n- Suggest concrete improvements with code examples\n- Be direct and concise \u2014 no filler praise\n- If the code looks good, say so briefly"
|
|
1332
|
+
},
|
|
1333
|
+
{
|
|
1334
|
+
id: "test-writer",
|
|
1335
|
+
name: "Test Writer",
|
|
1336
|
+
description: "Generates tests for existing code",
|
|
1337
|
+
agentName: "Tester",
|
|
1338
|
+
instructions: "You are a testing specialist. When asked to write tests:\n- Match the project's existing test framework and patterns\n- Cover happy paths, edge cases, and error conditions\n- Write tests that are readable and self-documenting\n- Use descriptive test names that explain the expected behavior\n- Prefer integration tests over unit tests when testing API endpoints"
|
|
1339
|
+
},
|
|
1340
|
+
{
|
|
1341
|
+
id: "devops",
|
|
1342
|
+
name: "DevOps",
|
|
1343
|
+
description: "Infrastructure, deployment, CI/CD tasks",
|
|
1344
|
+
agentName: "DevOps",
|
|
1345
|
+
instructions: "You are a DevOps engineer. When working on infrastructure tasks:\n- Prioritize reliability and security over convenience\n- Use environment variables for secrets \u2014 never hardcode them\n- Write idempotent scripts and configurations\n- Document any manual steps that can't be automated"
|
|
1346
|
+
},
|
|
1347
|
+
{
|
|
1348
|
+
id: "bug-hunter",
|
|
1349
|
+
name: "Bug Hunter",
|
|
1350
|
+
description: "Analyzes errors, traces bugs, suggests fixes",
|
|
1351
|
+
agentName: "BugHunter",
|
|
1352
|
+
instructions: "You are a debugging specialist. When investigating bugs:\n- Start by reading error messages and stack traces carefully\n- Trace the execution path from the error back to the root cause\n- Look at recent changes that might have introduced the bug\n- Propose a minimal fix that addresses the root cause, not just the symptom"
|
|
1353
|
+
},
|
|
1354
|
+
{
|
|
1355
|
+
id: "architect",
|
|
1356
|
+
name: "Architect",
|
|
1357
|
+
description: "High-level design and refactoring guidance",
|
|
1358
|
+
agentName: "Architect",
|
|
1359
|
+
instructions: "You are a software architect. When advising on design:\n- Consider the existing codebase architecture before proposing changes\n- Favor simplicity over cleverness\n- Think about maintainability, testability, and team knowledge\n- Provide concrete file paths and code examples, not just abstract guidance"
|
|
1360
|
+
}
|
|
1361
|
+
];
|
|
1362
|
+
function getTemplate(id) {
|
|
1363
|
+
return AGENT_TEMPLATES.find((t) => t.id === id);
|
|
1364
|
+
}
|
|
1197
1365
|
// Annotate the CommonJS export names for ESM import in node:
|
|
1198
1366
|
0 && (module.exports = {
|
|
1367
|
+
AGENT_TEMPLATES,
|
|
1199
1368
|
AnthropicProvider,
|
|
1200
1369
|
ClaudeCLIProvider,
|
|
1201
1370
|
GoogleProvider,
|
|
1202
1371
|
JaibberAgent,
|
|
1203
1372
|
MessageContext,
|
|
1204
1373
|
OpenAIProvider,
|
|
1205
|
-
TaskContext
|
|
1374
|
+
TaskContext,
|
|
1375
|
+
getTemplate
|
|
1206
1376
|
});
|
|
1207
1377
|
//# sourceMappingURL=index.cjs.map
|