SDK reference for @zindexzero/sdk

npm i @zindexzero/sdk

import { Ziz } from "@zindexzero/sdk";

const ziz = new Ziz({ apiKey: process.env.ZIZ_KEY! }); // ziz_live_…

// simplest form
const { text } = await ziz.chat("Summarize this contract");

// full turn: media (vision keys) + prior turns
const res = await ziz.chat(
  { text: "What's in this?", attachments: [{ type: "image", format: "png", data: b64 }] },
  [{ role: "user", text: "earlier message" }],
);
console.log(res.modelId, res.escalated, res.usage);

// add text or a base64 file (pdf/docx/csv/xlsx/html/txt/md)
await ziz.docs.add({ text: "Internal policy…", title: "Policy" });
await ziz.docs.add({ file: { data: b64, format: "pdf", name: "handbook.pdf" } });

// list + delete
const { documents } = await ziz.docs.list();  // [{ docId, title, format, createdAt, chunks }]
await ziz.docs.delete(documents[0].docId);

import { Ziz } from "@zindexzero/sdk";
const ziz = new Ziz({ apiKey: "ziz_pub_…" }); // safe to ship; locked to your origins
const { text } = await ziz.chat("Hello");

import { ZizHosted } from "@zindexzero/sdk";

const zh = new ZizHosted({ client: "acme" });        // browser: Origin is the gate
// const zh = new ZizHosted({ client: "acme", appToken: "hat_…" }); // native

const { text } = await zh.chat("Summarize my docs");
await zh.docs.add({ text: "Internal note…", title: "note" });

<script type="module">
  import { ZizHosted } from "https://esm.sh/@zindexzero/sdk";
  const zh = new ZizHosted({ client: "acme" });
  console.log(await zh.chat("hi"));
</script>

import { useMemo } from "react";
import { ZizHosted } from "@zindexzero/sdk";
import { useZero } from "@zindexzero/sdk/react";

function Chat() {
  const client = useMemo(() => new ZizHosted({ client: "acme" }), []);
  const { messages, send, status, error, reset } = useZero(client);
  // render messages; call send(text) on submit; status: "idle" | "sending"
}

import { signIn } from "@zindexzero/sdk";

const account = await signIn({ email: process.env.ZIZ_EMAIL!, password: process.env.ZIZ_PW! });

const { keys } = await account.keys.list();
const { key } = await account.keys.create({ kind: "secret", label: "prod server" });
await account.keys.setFeature(key, { smart: true, vision: true });
await account.keys.setPersona(key, "You are Acme's warm, concise support agent.");

const { totalCostUsd } = await account.usage(); // +20% marked up server-side