@colineapp/kairo-core 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -1,134 +1,172 @@
 export declare const KAIRO_BASE_URL: "https://coline.app";
 export declare const KAIRO_OAUTH_PATHS: {
-    readonly authorize: "/api/kairo/oauth/authorize";
-    readonly token: "/api/kairo/oauth/token";
-    readonly deviceAuthorize: "/api/kairo/oauth/device/authorize";
-    readonly revoke: "/api/kairo/oauth/revoke";
-    readonly agentStream: "/api/kairo/agent/stream";
-    readonly models: "/api/kairo/models";
-};
-export declare const KAIRO_REQUIRED_SCOPES: readonly ["kairo.agent:stream", "kairo.models:read"];
+  readonly authorize: "/api/kairo/oauth/authorize";
+  readonly token: "/api/kairo/oauth/token";
+  readonly deviceAuthorize: "/api/kairo/oauth/device/authorize";
+  readonly revoke: "/api/kairo/oauth/revoke";
+  readonly agentStream: "/api/kairo/agent/stream";
+  readonly models: "/api/kairo/models";
+};
+export declare const KAIRO_REQUIRED_SCOPES: readonly [
+  "kairo.agent:stream",
+  "kairo.models:read",
+];
 export declare const KAIRO_DEFAULT_SCOPE: string;
-export declare const KAIRO_MODEL_IDS: readonly ["gpt-5-nano", "gpt-5-mini", "gpt-5", "gpt-5.1", "gpt-5.2", "grok-4-fast-reasoning", "grok-4-fast-non-reasoning", "deepseek-v3.2", "deepseek-v3.2-speciale", "kimi-k2-thinking"];
+export declare const KAIRO_MODEL_IDS: readonly [
+  "gpt-5-nano",
+  "gpt-5-mini",
+  "gpt-5",
+  "gpt-5.1",
+  "gpt-5.2",
+  "claude-opus-4.6",
+  "claude-opus-4.5",
+  "claude-sonnet-4.5",
+  "grok-4-fast-reasoning",
+  "grok-4-fast-non-reasoning",
+  "deepseek-v3.2",
+  "deepseek-v3.2-speciale",
+  "kimi-k2-thinking",
+];
 export type KairoModelId = (typeof KAIRO_MODEL_IDS)[number];
 export declare const KAIRO_DEFAULT_MODEL: KairoModelId;
 export type KairoOauthErrorResponse = {
-    error: string;
-    error_description?: string;
-    error_uri?: string;
+  error: string;
+  error_description?: string;
+  error_uri?: string;
 };
 export type KairoTokenResponse = {
-    access_token: string;
-    token_type: string;
-    expires_in: number;
-    scope?: string;
-    refresh_token?: string;
+  access_token: string;
+  token_type: string;
+  expires_in: number;
+  scope?: string;
+  refresh_token?: string;
 };
 export type KairoDeviceAuthorizationResponse = {
-    device_code: string;
-    user_code: string;
-    verification_uri: string;
-    verification_uri_complete?: string;
-    expires_in: number;
-    interval?: number;
-    scope?: string;
+  device_code: string;
+  user_code: string;
+  verification_uri: string;
+  verification_uri_complete?: string;
+  expires_in: number;
+  interval?: number;
+  scope?: string;
 };
 export type KairoRole = "system" | "user" | "model" | "function";
 export type KairoTextPart = {
-    text: string;
+  text: string;
 };
 export type KairoInlineDataPart = {
-    inlineData: {
+  inlineData:
+    | {
         mimeType: string;
         data: string;
-    } | {
+      }
+    | {
         imageUrl: string;
-    } | {
+      }
+    | {
         fileData: string;
         filename?: string;
-    } | {
+      }
+    | {
         fileId: string;
         filename?: string;
-    };
+      };
 };
 export type KairoFunctionCall = {
-    id?: string;
-    name: string;
-    args: Record<string, unknown>;
-    rawArguments?: string;
+  id?: string;
+  name: string;
+  args: Record<string, unknown>;
+  rawArguments?: string;
 };
 export type KairoFunctionCallPart = {
-    functionCall: KairoFunctionCall;
+  functionCall: KairoFunctionCall;
 };
 export type KairoFunctionResponsePart = {
-    functionResponse: {
-        name: string;
-        response: unknown;
-        id?: string;
-    };
+  functionResponse: {
+    name: string;
+    response: unknown;
+    id?: string;
+  };
 };
-export type KairoMessagePart = KairoTextPart | KairoInlineDataPart | KairoFunctionCallPart | KairoFunctionResponsePart;
+export type KairoMessagePart =
+  | KairoTextPart
+  | KairoInlineDataPart
+  | KairoFunctionCallPart
+  | KairoFunctionResponsePart;
 export type KairoContent = {
-    role: KairoRole;
-    parts: KairoMessagePart[];
+  role: KairoRole;
+  parts: KairoMessagePart[];
 };
 export type KairoAgentStreamRequest = {
-    contents: KairoContent[];
-    modelType?: KairoModelId | string;
-    reasoningLevel?: number;
-    thinkingBudget?: number;
-    traceId?: string;
+  contents: KairoContent[];
+  modelType?: KairoModelId | string;
+  reasoningLevel?: number;
+  thinkingBudget?: number;
+  traceId?: string;
 } & Record<string, unknown>;
 export type KairoOauthErrorDetails = {
-    code: string;
-    description: string | null;
-    uri: string | null;
+  code: string;
+  description: string | null;
+  uri: string | null;
 };
 export type KairoErrorOptions = {
-    message: string;
-    status: number | null;
-    code: string;
-    description?: string | null;
-    details?: unknown;
+  message: string;
+  status: number | null;
+  code: string;
+  description?: string | null;
+  details?: unknown;
 };
 export declare class KairoError extends Error {
-    readonly status: number | null;
-    readonly code: string;
-    readonly description: string | null;
-    readonly details: unknown;
-    constructor(options: KairoErrorOptions);
+  readonly status: number | null;
+  readonly code: string;
+  readonly description: string | null;
+  readonly details: unknown;
+  constructor(options: KairoErrorOptions);
 }
 export declare function resolveBaseUrl(baseUrl?: string): string;
-export declare function buildKairoUrl(baseUrl: string | undefined, path: string): string;
+export declare function buildKairoUrl(
+  baseUrl: string | undefined,
+  path: string,
+): string;
 export declare const KAIRO_TOKEN_EXPIRY_SAFETY_MS = 30000;
-export declare function computeExpiresAt(expiresInSeconds: number, nowMs?: number, safetyMs?: number): number;
+export declare function computeExpiresAt(
+  expiresInSeconds: number,
+  nowMs?: number,
+  safetyMs?: number,
+): number;
 export declare function isExpired(expiresAt: number, nowMs?: number): boolean;
 export declare function assertOk(response: Response): Promise<Response>;
 export type KairoSseEvent = {
-    raw: string;
-    data: unknown;
-    event: string | null;
-    parsed: boolean;
-};
-export declare function iterateSse(response: Response): AsyncGenerator<KairoSseEvent>;
+  raw: string;
+  data: unknown;
+  event: string | null;
+  parsed: boolean;
+};
+export declare function iterateSse(
+  response: Response,
+): AsyncGenerator<KairoSseEvent>;
 export declare function extractTextChunks(data: unknown): string[];
-export declare function accumulateText(events: AsyncIterable<KairoSseEvent>): Promise<string>;
+export declare function accumulateText(
+  events: AsyncIterable<KairoSseEvent>,
+): Promise<string>;
 export type KairoTokenSet = {
-    accessToken: string;
-    refreshToken: string | null;
-    expiresAt: number;
-    scope: string | null;
-    tokenType: string;
+  accessToken: string;
+  refreshToken: string | null;
+  expiresAt: number;
+  scope: string | null;
+  tokenType: string;
 };
 export declare function toTokenSet(response: KairoTokenResponse): KairoTokenSet;
 export type KairoModelListOptions = {
-    baseUrl?: string;
-    fetch?: typeof fetch;
-    signal?: AbortSignal;
+  baseUrl?: string;
+  fetch?: typeof fetch;
+  signal?: AbortSignal;
 };
 export type KairoModelListResponse = {
-    defaultModel: string;
-    models: string[];
+  defaultModel: string;
+  models: string[];
 };
-export declare function listKairoModels(options?: KairoModelListOptions): Promise<KairoModelListResponse>;
-//# sourceMappingURL=index.d.ts.map
+export declare function listKairoModels(
+  options?: KairoModelListOptions,
+): Promise<KairoModelListResponse>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,295 +1,282 @@
-import { createParser, } from "eventsource-parser";
+import { createParser } from "eventsource-parser";
 export const KAIRO_BASE_URL = "https://coline.app";
 export const KAIRO_OAUTH_PATHS = {
-    authorize: "/api/kairo/oauth/authorize",
-    token: "/api/kairo/oauth/token",
-    deviceAuthorize: "/api/kairo/oauth/device/authorize",
-    revoke: "/api/kairo/oauth/revoke",
-    agentStream: "/api/kairo/agent/stream",
-    models: "/api/kairo/models",
+  authorize: "/api/kairo/oauth/authorize",
+  token: "/api/kairo/oauth/token",
+  deviceAuthorize: "/api/kairo/oauth/device/authorize",
+  revoke: "/api/kairo/oauth/revoke",
+  agentStream: "/api/kairo/agent/stream",
+  models: "/api/kairo/models",
 };
 export const KAIRO_REQUIRED_SCOPES = [
-    "kairo.agent:stream",
-    "kairo.models:read",
+  "kairo.agent:stream",
+  "kairo.models:read",
 ];
 export const KAIRO_DEFAULT_SCOPE = KAIRO_REQUIRED_SCOPES.join(" ");
 export const KAIRO_MODEL_IDS = [
-    "gpt-5-nano",
-    "gpt-5-mini",
-    "gpt-5",
-    "gpt-5.1",
-    "gpt-5.2",
-    "grok-4-fast-reasoning",
-    "grok-4-fast-non-reasoning",
-    "deepseek-v3.2",
-    "deepseek-v3.2-speciale",
-    "kimi-k2-thinking",
+  "gpt-5-nano",
+  "gpt-5-mini",
+  "gpt-5",
+  "gpt-5.1",
+  "gpt-5.2",
+  "claude-opus-4.6",
+  "claude-opus-4.5",
+  "claude-sonnet-4.5",
+  "grok-4-fast-reasoning",
+  "grok-4-fast-non-reasoning",
+  "deepseek-v3.2",
+  "deepseek-v3.2-speciale",
+  "kimi-k2-thinking",
 ];
 export const KAIRO_DEFAULT_MODEL = "gpt-5.2";
 export class KairoError extends Error {
-    status;
-    code;
-    description;
-    details;
-    constructor(options) {
-        super(options.message);
-        this.name = "KairoError";
-        this.status = options.status;
-        this.code = options.code;
-        this.description = options.description ?? null;
-        this.details = options.details ?? null;
-    }
+  status;
+  code;
+  description;
+  details;
+  constructor(options) {
+    super(options.message);
+    this.name = "KairoError";
+    this.status = options.status;
+    this.code = options.code;
+    this.description = options.description ?? null;
+    this.details = options.details ?? null;
+  }
 }
 function isRecord(value) {
-    return typeof value === "object" && value !== null;
+  return typeof value === "object" && value !== null;
 }
 function readOauthErrorDetails(value) {
-    if (!isRecord(value))
-        return null;
-    const code = typeof value.error === "string" ? value.error : null;
-    if (!code)
-        return null;
-    const description = typeof value.error_description === "string"
-        ? value.error_description
-        : null;
-    const uri = typeof value.error_uri === "string" ? value.error_uri : null;
-    return { code, description, uri };
+  if (!isRecord(value)) return null;
+  const code = typeof value.error === "string" ? value.error : null;
+  if (!code) return null;
+  const description =
+    typeof value.error_description === "string"
+      ? value.error_description
+      : null;
+  const uri = typeof value.error_uri === "string" ? value.error_uri : null;
+  return { code, description, uri };
 }
 export function resolveBaseUrl(baseUrl) {
-    if (!baseUrl)
-        return KAIRO_BASE_URL;
-    const trimmed = baseUrl.trim();
-    return trimmed.length > 0 ? trimmed : KAIRO_BASE_URL;
+  if (!baseUrl) return KAIRO_BASE_URL;
+  const trimmed = baseUrl.trim();
+  return trimmed.length > 0 ? trimmed : KAIRO_BASE_URL;
 }
 function resolveFetch(override) {
-    const fetchImpl = override ?? globalThis.fetch;
-    if (!fetchImpl) {
-        throw new KairoError({
-            message: "No fetch implementation is available",
-            status: null,
-            code: "missing_fetch",
-        });
-    }
-    return fetchImpl;
+  const fetchImpl = override ?? globalThis.fetch;
+  if (!fetchImpl) {
+    throw new KairoError({
+      message: "No fetch implementation is available",
+      status: null,
+      code: "missing_fetch",
+    });
+  }
+  return fetchImpl;
 }
 export function buildKairoUrl(baseUrl, path) {
-    const origin = resolveBaseUrl(baseUrl);
-    return new URL(path, origin).toString();
+  const origin = resolveBaseUrl(baseUrl);
+  return new URL(path, origin).toString();
 }
 export const KAIRO_TOKEN_EXPIRY_SAFETY_MS = 30_000;
-export function computeExpiresAt(expiresInSeconds, nowMs = Date.now(), safetyMs = KAIRO_TOKEN_EXPIRY_SAFETY_MS) {
-    const ttlMs = Math.max(0, expiresInSeconds * 1000 - safetyMs);
-    return nowMs + ttlMs;
+export function computeExpiresAt(
+  expiresInSeconds,
+  nowMs = Date.now(),
+  safetyMs = KAIRO_TOKEN_EXPIRY_SAFETY_MS,
+) {
+  const ttlMs = Math.max(0, expiresInSeconds * 1000 - safetyMs);
+  return nowMs + ttlMs;
 }
 export function isExpired(expiresAt, nowMs = Date.now()) {
-    return expiresAt <= nowMs;
+  return expiresAt <= nowMs;
 }
 export async function assertOk(response) {
-    if (response.ok)
-        return response;
-    let payload = null;
-    try {
-        payload = await response.clone().json();
-    }
-    catch {
-        payload = null;
-    }
-    const oauthError = readOauthErrorDetails(payload);
-    const message = oauthError?.description
-        ? oauthError.description
-        : oauthError?.code
-            ? oauthError.code
-            : `Request failed with status ${response.status}`;
-    throw new KairoError({
-        message,
-        status: response.status,
-        code: oauthError?.code ?? "http_error",
-        description: oauthError?.description ?? null,
-        details: payload,
-    });
+  if (response.ok) return response;
+  let payload = null;
+  try {
+    payload = await response.clone().json();
+  } catch {
+    payload = null;
+  }
+  const oauthError = readOauthErrorDetails(payload);
+  const message = oauthError?.description
+    ? oauthError.description
+    : oauthError?.code
+      ? oauthError.code
+      : `Request failed with status ${response.status}`;
+  throw new KairoError({
+    message,
+    status: response.status,
+    code: oauthError?.code ?? "http_error",
+    description: oauthError?.description ?? null,
+    details: payload,
+  });
 }
 function safeParseJson(raw) {
-    try {
-        return {
-            parsed: true,
-            value: JSON.parse(raw),
-        };
-    }
-    catch {
-        return {
-            parsed: false,
-            value: raw,
-        };
-    }
+  try {
+    return {
+      parsed: true,
+      value: JSON.parse(raw),
+    };
+  } catch {
+    return {
+      parsed: false,
+      value: raw,
+    };
+  }
 }
 function deriveEventName(parsed, fallback) {
-    if (isRecord(parsed) && typeof parsed.event === "string") {
-        return parsed.event;
-    }
-    return fallback ?? null;
+  if (isRecord(parsed) && typeof parsed.event === "string") {
+    return parsed.event;
+  }
+  return fallback ?? null;
 }
 export async function* iterateSse(response) {
-    if (!response.body) {
-        throw new KairoError({
-            message: "Streaming response has no body",
-            status: response.status,
-            code: "missing_stream_body",
-        });
+  if (!response.body) {
+    throw new KairoError({
+      message: "Streaming response has no body",
+      status: response.status,
+      code: "missing_stream_body",
+    });
+  }
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  const queue = [];
+  let pendingResolve = null;
+  let done = false;
+  let pumpError = null;
+  const push = (event) => {
+    if (pendingResolve) {
+      const resolve = pendingResolve;
+      pendingResolve = null;
+      resolve(event);
+      return;
     }
-    const reader = response.body.getReader();
-    const decoder = new TextDecoder();
-    const queue = [];
-    let pendingResolve = null;
-    let done = false;
-    let pumpError = null;
-    const push = (event) => {
-        if (pendingResolve) {
-            const resolve = pendingResolve;
-            pendingResolve = null;
-            resolve(event);
-            return;
-        }
-        if (event) {
-            queue.push(event);
-        }
-        else {
-            done = true;
-        }
-    };
-    const onParseEvent = (event) => {
-        const parsed = safeParseJson(event.data);
-        const eventName = deriveEventName(parsed.value, event.event);
-        push({
-            raw: event.data,
-            data: parsed.value,
-            event: eventName,
-            parsed: parsed.parsed,
-        });
-    };
-    const parser = createParser({
-        onEvent: onParseEvent,
-        onError: (_error) => {
-        },
+    if (event) {
+      queue.push(event);
+    } else {
+      done = true;
+    }
+  };
+  const onParseEvent = (event) => {
+    const parsed = safeParseJson(event.data);
+    const eventName = deriveEventName(parsed.value, event.event);
+    push({
+      raw: event.data,
+      data: parsed.value,
+      event: eventName,
+      parsed: parsed.parsed,
     });
-    const pump = (async () => {
-        try {
-            while (true) {
-                const { done: readerDone, value } = await reader.read();
-                if (readerDone)
-                    break;
-                if (!value)
-                    continue;
-                parser.feed(decoder.decode(value, { stream: true }));
-            }
-            const tail = decoder.decode();
-            if (tail) {
-                parser.feed(tail);
-            }
-        }
-        catch (error) {
-            pumpError = error;
-        }
-        finally {
-            try {
-                reader.releaseLock();
-            }
-            catch {
-            }
-            push(null);
-        }
-    })();
+  };
+  const parser = createParser({
+    onEvent: onParseEvent,
+    onError: (_error) => {},
+  });
+  const pump = (async () => {
     try {
-        while (true) {
-            if (queue.length > 0) {
-                const next = queue.shift();
-                if (next) {
-                    yield next;
-                    continue;
-                }
-            }
-            if (done)
-                break;
-            const awaited = await new Promise((resolve) => {
-                pendingResolve = resolve;
-            });
-            if (!awaited)
-                break;
-            yield awaited;
-        }
-    }
-    finally {
-        await pump;
+      while (true) {
+        const { done: readerDone, value } = await reader.read();
+        if (readerDone) break;
+        if (!value) continue;
+        parser.feed(decoder.decode(value, { stream: true }));
+      }
+      const tail = decoder.decode();
+      if (tail) {
+        parser.feed(tail);
+      }
+    } catch (error) {
+      pumpError = error;
+    } finally {
+      try {
+        reader.releaseLock();
+      } catch {}
+      push(null);
     }
-    if (pumpError) {
-        throw pumpError;
+  })();
+  try {
+    while (true) {
+      if (queue.length > 0) {
+        const next = queue.shift();
+        if (next) {
+          yield next;
+          continue;
+        }
+      }
+      if (done) break;
+      const awaited = await new Promise((resolve) => {
+        pendingResolve = resolve;
+      });
+      if (!awaited) break;
+      yield awaited;
     }
+  } finally {
+    await pump;
+  }
+  if (pumpError) {
+    throw pumpError;
+  }
 }
 function readPartsFromCandidate(value) {
-    if (!isRecord(value))
-        return [];
-    const parts = value.parts;
-    return Array.isArray(parts) ? parts : [];
+  if (!isRecord(value)) return [];
+  const parts = value.parts;
+  return Array.isArray(parts) ? parts : [];
 }
 function extractTextFromPart(part) {
-    if (!isRecord(part))
-        return [];
-    if (typeof part.text === "string" && part.text.length > 0) {
-        return [part.text];
-    }
-    const type = typeof part.type === "string" ? part.type : null;
-    if (!type)
-        return [];
-    if (type === "output_text" || type === "input_text") {
-        return typeof part.text === "string" && part.text.length > 0
-            ? [part.text]
-            : [];
-    }
-    return [];
+  if (!isRecord(part)) return [];
+  if (typeof part.text === "string" && part.text.length > 0) {
+    return [part.text];
+  }
+  const type = typeof part.type === "string" ? part.type : null;
+  if (!type) return [];
+  if (type === "output_text" || type === "input_text") {
+    return typeof part.text === "string" && part.text.length > 0
+      ? [part.text]
+      : [];
+  }
+  return [];
 }
 export function extractTextChunks(data) {
-    if (!isRecord(data))
-        return [];
-    const chunks = [];
-    if (typeof data.text === "string" && data.text.length > 0) {
-        chunks.push(data.text);
-    }
-    const candidate = data.candidate_content;
-    const parts = readPartsFromCandidate(candidate);
-    for (const part of parts) {
-        chunks.push(...extractTextFromPart(part));
-    }
-    return chunks;
+  if (!isRecord(data)) return [];
+  const chunks = [];
+  if (typeof data.text === "string" && data.text.length > 0) {
+    chunks.push(data.text);
+  }
+  const candidate = data.candidate_content;
+  const parts = readPartsFromCandidate(candidate);
+  for (const part of parts) {
+    chunks.push(...extractTextFromPart(part));
+  }
+  return chunks;
 }
 export async function accumulateText(events) {
-    let text = "";
-    for await (const event of events) {
-        const chunks = extractTextChunks(event.data);
-        for (const chunk of chunks) {
-            text += chunk;
-        }
+  let text = "";
+  for await (const event of events) {
+    const chunks = extractTextChunks(event.data);
+    for (const chunk of chunks) {
+      text += chunk;
     }
-    return text;
+  }
+  return text;
 }
 export function toTokenSet(response) {
-    return {
-        accessToken: response.access_token,
-        refreshToken: response.refresh_token ?? null,
-        expiresAt: computeExpiresAt(response.expires_in),
-        scope: response.scope ?? null,
-        tokenType: response.token_type,
-    };
+  return {
+    accessToken: response.access_token,
+    refreshToken: response.refresh_token ?? null,
+    expiresAt: computeExpiresAt(response.expires_in),
+    scope: response.scope ?? null,
+    tokenType: response.token_type,
+  };
 }
 export async function listKairoModels(options = {}) {
-    const fetchImpl = resolveFetch(options.fetch);
-    const url = buildKairoUrl(options.baseUrl, KAIRO_OAUTH_PATHS.models);
-    const response = await fetchImpl(url, {
-        method: "GET",
-        headers: {
-            Accept: "application/json",
-        },
-        signal: options.signal,
-    });
-    await assertOk(response);
-    return (await response.json());
+  const fetchImpl = resolveFetch(options.fetch);
+  const url = buildKairoUrl(options.baseUrl, KAIRO_OAUTH_PATHS.models);
+  const response = await fetchImpl(url, {
+    method: "GET",
+    headers: {
+      Accept: "application/json",
+    },
+    signal: options.signal,
+  });
+  await assertOk(response);
+  return await response.json();
 }
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colineapp/kairo-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Core types and utilities for the Coline Kairo SDK.",
   "license": "Apache-2.0",
   "author": "Coline Technologies, Inc.",