boids-sdk 0.1.1 → 0.1.2

package/README.md

@@ -5,18 +5,21 @@ JavaScript SDK and CLI for the Boids API.
 ## Install
 
 ```bash
-npm install boids-sdk
+curl -fsSL https://raw.githubusercontent.com/NevaMind-AI/boids-sdk/main/install.sh | bash
 export BOIDS_API_KEY="..."
 ```
 
+The installer tries `npm install -g boids-sdk` first, then falls back to pipx or
+pip. Use `npm install boids-sdk` for a project-local SDK dependency.
+
 ## CLI
 
 ```bash
-boids agent:@iris-wei-org/my-doppelganger "Introduce yourself in one sentence."
+boids agent:@boids-team/jarvis "Introduce yourself in one sentence."
 boids search "global launch growth agent" --limit 5
 boids run "Create a launch plan for a developer tool."
-boids agent:@iris-wei-org/my-doppelganger "Remember my name is Ada." --show-response-id
-boids agent:@iris-wei-org/my-doppelganger "What is my name?" --prev resp_...
+boids agent:@boids-team/jarvis "Remember my name is Ada." --show-response-id
+boids agent:@boids-team/jarvis "What is my name?" --prev resp_...
 ```
 
 `boids run` searches `/v1/market/search`, selects the first returned agent, and
@@ -30,17 +33,27 @@ import { Boids } from "boids-sdk";
 const client = new Boids();
 
 const response = await client.responses.create({
-  model: "agent:@iris-wei-org/my-doppelganger",
+  model: "agent:@boids-team/jarvis",
   input: "Introduce yourself in one sentence.",
 });
 console.log(response);
 ```
 
+Chat complete:
+
+```js
+const response = await client.chat.complete({
+  model: "agent:@boids-team/jarvis",
+  messages: [{ role: "user", content: "Introduce yourself in one sentence." }],
+});
+console.log(response);
+```
+
 Streaming:
 
 ```js
 for await (const event of client.responses.create({
-  model: "agent:@iris-wei-org/my-doppelganger",
+  model: "agent:@boids-team/jarvis",
   input: "Introduce yourself in one sentence.",
   stream: true,
 })) {
@@ -62,12 +75,12 @@ Conversation context:
 
 ```js
 const first = await client.responses.create({
-  model: "agent:@iris-wei-org/my-doppelganger",
+  model: "agent:@boids-team/jarvis",
   input: "Remember my name is Ada.",
 });
 
 const second = await client.responses.create({
-  model: "agent:@iris-wei-org/my-doppelganger",
+  model: "agent:@boids-team/jarvis",
   input: "What is my name?",
   previous_response_id: first.id,
 });

package/bin/boids.js

@@ -96,6 +96,23 @@ async function main(argv) {
     return 0;
   }
 
+  if (command === "chat") {
+    const options = parseOptions(argv);
+    const model = requireModel(options.model);
+    const input = options.input ?? options._.join(" ");
+
+    const client = makeClient(options);
+    const result = client.chat.complete({
+      model,
+      messages: chatMessages(input, options.messages),
+      stream: Boolean(options.stream),
+    });
+    await printResult(result, Boolean(options.json), {
+      showResponseId: Boolean(options.showResponseId),
+    });
+    return 0;
+  }
+
   throw new Error(`Unknown command: ${command}`);
 }
 
@@ -285,6 +302,9 @@ function parseOptions(args, { envModel = true } = {}) {
       options.searchQuery = args[++index];
     } else if (arg === "--limit") {
       options.limit = args[++index];
+    } else if (arg === "--message") {
+      options.messages ??= [];
+      options.messages.push(args[++index]);
     } else if (arg === "--previous-response-id" || arg === "--prev") {
       options.previousResponseId = args[++index];
     } else if (arg === "--api-key") {
@@ -301,6 +321,9 @@ function parseOptions(args, { envModel = true } = {}) {
       options.searchQuery = arg.slice("--search-query=".length);
     } else if (arg.startsWith("--limit=")) {
       options.limit = arg.slice("--limit=".length);
+    } else if (arg.startsWith("--message=")) {
+      options.messages ??= [];
+      options.messages.push(arg.slice("--message=".length));
     } else if (arg.startsWith("--previous-response-id=")) {
       options.previousResponseId = arg.slice("--previous-response-id=".length);
     } else if (arg.startsWith("--prev=")) {
@@ -327,6 +350,27 @@ function requireModel(model) {
   throw new Error("Missing --model or BOIDS_MODEL.");
 }
 
+function chatMessages(input, rawMessages = []) {
+  const messages = [];
+  for (const rawMessage of rawMessages) {
+    const separator = rawMessage.indexOf(":");
+    const role = separator === -1 ? "" : rawMessage.slice(0, separator);
+    const content = separator === -1 ? "" : rawMessage.slice(separator + 1);
+    if (!role || !content) {
+      throw new Error("--message must be formatted as role:content.");
+    }
+    messages.push({ role, content });
+  }
+
+  if (input) {
+    messages.push({ role: "user", content: input });
+  }
+  if (messages.length === 0) {
+    throw new Error("Missing --input, --message, or input text.");
+  }
+  return messages;
+}
+
 function isAsyncIterable(value) {
   return value && typeof value[Symbol.asyncIterator] === "function";
 }
@@ -354,7 +398,7 @@ function printResponseId(value) {
 
 function looksLikeShortcut(args) {
   const first = firstPositional(args);
-  return first !== undefined && !["ask", "responses", "search", "run", "auto"].includes(first);
+  return first !== undefined && !["ask", "responses", "chat", "search", "run", "auto"].includes(first);
 }
 
 function firstPositional(args) {
@@ -370,6 +414,7 @@ function firstPositional(args) {
     "-q",
     "--search-query",
     "--limit",
+    "--message",
     "--previous-response-id",
     "--prev",
   ]);
@@ -393,6 +438,7 @@ function firstPositional(args) {
       arg.startsWith("--query=") ||
       arg.startsWith("--search-query=") ||
       arg.startsWith("--limit=") ||
+      arg.startsWith("--message=") ||
       arg.startsWith("--previous-response-id=") ||
       arg.startsWith("--prev=")
     ) {
@@ -416,6 +462,7 @@ function usage() {
   boids run <input> [--search-query <query>] [--prev <response-id>]
   boids ask --model <model> [--no-stream] <input>
   boids responses create --model <model> --input <input> [--stream] [--prev <response-id>]
+  boids chat --model <model> --input <input> [--stream]
 
 Environment:
   BOIDS_API_KEY   Required API key

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boids-sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "JavaScript SDK and CLI for the Boids Responses API",
   "type": "module",
   "main": "./src/index.js",

package/src/index.d.ts

@@ -19,6 +19,19 @@ export interface ResponseEvent {
   raw: string;
 }
 
+export interface ChatMessage {
+  role: string;
+  content: unknown;
+  [key: string]: unknown;
+}
+
+export interface ChatCompleteParams {
+  model: string;
+  messages: ChatMessage[];
+  stream?: boolean;
+  [key: string]: unknown;
+}
+
 export interface MarketSearchParams {
   query: string;
   limit?: number;
@@ -37,10 +50,14 @@ export class Boids {
   responses: {
     create(params: ResponseCreateParams): Promise<unknown> | AsyncIterable<ResponseEvent>;
   };
+  chat: {
+    complete(params: ChatCompleteParams): Promise<unknown> | AsyncIterable<ResponseEvent>;
+  };
   market: {
     search(params: MarketSearchParams | string): Promise<unknown>;
   };
   createResponse(params: ResponseCreateParams): Promise<unknown> | AsyncIterable<ResponseEvent>;
+  completeChat(params: ChatCompleteParams): Promise<unknown> | AsyncIterable<ResponseEvent>;
   searchMarket(params: MarketSearchParams | string): Promise<unknown>;
 }
 

package/src/index.js

@@ -1,5 +1,5 @@
 const DEFAULT_BASE_URL = "https://api.boids.so/v1";
-const USER_AGENT = "boids-sdk-js/0.1.1";
+const USER_AGENT = "boids-sdk-js/0.1.2";
 
 export class BoidsError extends Error {
   constructor(message) {
@@ -29,6 +29,9 @@ export class Boids {
     this.responses = {
       create: (params) => this.createResponse(params),
     };
+    this.chat = {
+      complete: (params) => this.completeChat(params),
+    };
     this.market = {
       search: (params) => this.searchMarket(params),
     };
@@ -42,6 +45,14 @@ export class Boids {
     return this.requestJSON("/responses", body);
   }
 
+  completeChat(params = {}) {
+    const body = withoutUndefined({ ...params });
+    if (body.stream) {
+      return this.streamChatCompletion(body);
+    }
+    return this.requestJSON("/chat/complete", body);
+  }
+
   async requestJSON(path, body) {
     const response = await this.request(path, body);
     const text = await response.text();
@@ -67,6 +78,11 @@ export class Boids {
     yield* parseSSE(response);
   }
 
+  async *streamChatCompletion(body) {
+    const response = await this.request("/chat/complete", { ...body, stream: true });
+    yield* parseSSE(response);
+  }
+
   async request(path, body) {
     if (!this.apiKey) {
       throw new BoidsError("Missing BOIDS_API_KEY or apiKey.");