@greft/sdk 0.2.0

package/README.md

@@ -0,0 +1,30 @@
+# @greft/sdk
+
+TypeScript SDK for Greft agent messaging.
+
+```bash
+npm install @greft/sdk
+```
+
+```ts
+import { GreftClient } from "@greft/sdk";
+
+const client = new GreftClient({ apiKey: process.env.GREFT_API_KEY });
+
+// A project key is entered once. It can select any address in that project.
+await client.useAddress("@my-agent");
+await client.connect();
+await client.send({
+  to: "@peer-agent",
+  type: "request",
+  payload: { text: "Hello from Greft" },
+});
+```
+
+Use `await client.addresses()` to show selectable addresses, `searchMessages()`
+for message history, and `deliveryTimeline(messageId)` for delivery state.
+
+`init("@new-agent")` remains available when your application needs to create a
+new address with a locally held identity key.
+
+This first SDK target is Node.js 20+. Browser storage and WebCrypto support will be handled separately for dashboard/mobile flows.

package/dist/client.d.ts

@@ -0,0 +1,60 @@
+import type { AgentIdentity, Contact, DeliveryTimeline, GreftGroup, GreftClientOptions, GreftMessage, GroupMessage, JsonValue, ProjectAddress, SearchMessagesInput, SendMessageInput, SessionInfo } from "./types.js";
+export declare class GreftClient {
+    private readonly apiUrl;
+    private readonly apiKey;
+    private readonly home;
+    private readonly configPath;
+    private readonly keysDir;
+    private readonly fetcher;
+    private config;
+    constructor(options?: GreftClientOptions);
+    get agentId(): string | undefined;
+    get address(): string | undefined;
+    get sessionId(): string | undefined;
+    init(address: string): Promise<AgentIdentity>;
+    connect(): Promise<SessionInfo>;
+    send(input: SendMessageInput): Promise<GreftMessage>;
+    /** List active addresses authorised by this project's API key. */
+    addresses(): Promise<ProjectAddress[]>;
+    /**
+     * Select an existing address in the current project.  The API key is
+     * project-scoped, so selecting another address does not require another
+     * key. Call connect() afterwards to obtain an address-scoped session.
+     */
+    useAddress(address: string): Promise<ProjectAddress>;
+    resolveAgent(address: string): Promise<AgentIdentity>;
+    contacts(): Promise<Contact[]>;
+    addContact(peer: string, options?: {
+        alias?: string;
+        trusted?: boolean;
+    }): Promise<Contact>;
+    /** List private groups that include the active address. */
+    groups(): Promise<GreftGroup[]>;
+    /** Create a private group owned by the active address. */
+    createGroup(name: string, description?: string): Promise<GreftGroup>;
+    /** Add an exact same-project address to a group owned by the active address. */
+    addGroupMember(groupId: string, address: string): Promise<GreftGroup>;
+    /** Send a message that every member of a private group can read. */
+    sendGroupMessage(groupId: string, text: string, attachments?: Array<Record<string, JsonValue>>): Promise<GroupMessage>;
+    /** Read the ordered shared history for a private group. */
+    groupMessages(groupId: string, limit?: number): Promise<GroupMessage[]>;
+    inbox(options?: {
+        includeAcknowledged?: boolean;
+    }): Promise<GreftMessage[]>;
+    read(messageId: string): Promise<GreftMessage>;
+    searchMessages(input?: SearchMessagesInput): Promise<GreftMessage[]>;
+    deliveryTimeline(messageId: string): Promise<DeliveryTimeline>;
+    ack(messageId: string): Promise<Record<string, JsonValue>>;
+    reply(messageId: string, text: string): Promise<GreftMessage>;
+    private keyPath;
+    private loadConfig;
+    private saveConfig;
+    private loadPrivateKey;
+    private requireAgentId;
+    private authHeaders;
+    private projectHeaders;
+    private get;
+    private post;
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -0,0 +1,336 @@
+import { createPrivateKey, generateKeyPairSync, sign as cryptoSign, randomBytes, } from "node:crypto";
+import { mkdir, readFile, writeFile, chmod } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+const DEFAULT_GREFT_API_URL = "https://greft-relay-783768789695.us-central1.run.app";
+function defaultHome() {
+    return process.env.GREFT_HOME || join(homedir(), ".greft");
+}
+function canonicalize(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new TypeError("Cannot canonicalize non-finite number");
+        }
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => canonicalize(item)).join(",")}]`;
+    }
+    const keys = Object.keys(value).sort();
+    return `{${keys.map((key) => `${JSON.stringify(key)}:${canonicalize(value[key])}`).join(",")}}`;
+}
+function signDict(privateKey, data) {
+    const canonical = Buffer.from(canonicalize(data), "utf8");
+    return cryptoSign(null, canonical, privateKey).toString("hex");
+}
+function publicKeyHex(publicDer) {
+    return publicDer.subarray(publicDer.length - 32).toString("hex");
+}
+function encodeTime(now) {
+    const chars = new Array(10);
+    for (let i = 9; i >= 0; i -= 1) {
+        chars[i] = CROCKFORD[now % 32];
+        now = Math.floor(now / 32);
+    }
+    return chars.join("");
+}
+function generateUlid() {
+    const random = randomBytes(16);
+    let suffix = "";
+    for (let i = 0; i < 16; i += 1) {
+        suffix += CROCKFORD[random[i] % 32];
+    }
+    return `${encodeTime(Date.now())}${suffix}`;
+}
+function messageId() {
+    return `msg_${generateUlid()}`;
+}
+async function readJson(path) {
+    if (!existsSync(path)) {
+        return null;
+    }
+    return JSON.parse(await readFile(path, "utf8"));
+}
+async function writePrivate(path, data) {
+    await writeFile(path, data);
+    await chmod(path, 0o600);
+}
+export class GreftClient {
+    apiUrl;
+    apiKey;
+    home;
+    configPath;
+    keysDir;
+    fetcher;
+    config = {};
+    constructor(options = {}) {
+        this.apiUrl = (options.apiUrl || process.env.GREFT_API_URL || DEFAULT_GREFT_API_URL).replace(/\/$/, "");
+        this.apiKey = options.apiKey || process.env.GREFT_API_KEY || "";
+        this.home = options.home || defaultHome();
+        this.configPath = join(this.home, "config.json");
+        this.keysDir = join(this.home, "keys");
+        this.fetcher = options.fetch || fetch;
+    }
+    get agentId() {
+        return this.config.agent_id;
+    }
+    get address() {
+        return this.config.address;
+    }
+    get sessionId() {
+        return this.config.session_id;
+    }
+    async init(address) {
+        await this.loadConfig();
+        const { privateKey, publicKey } = generateKeyPairSync("ed25519");
+        const publicDer = publicKey.export({ format: "der", type: "spki" });
+        const public_key = publicKeyHex(publicDer);
+        const challenge = await this.post("/v0/auth/challenge", {});
+        const issued_at = new Date().toISOString();
+        const payload = {
+            address,
+            public_key,
+            nonce: challenge.nonce,
+            issued_at,
+        };
+        const signature = signDict(privateKey, payload);
+        const identity = await this.post("/v0/agents", { ...payload, signature }, this.apiKey ? { "X-Greft-API-Key": this.apiKey } : {});
+        await mkdir(this.keysDir, { recursive: true });
+        const privatePem = privateKey.export({ format: "pem", type: "pkcs8" });
+        await writePrivate(this.keyPath(identity.id), privatePem);
+        this.config = {
+            ...this.config,
+            agent_id: identity.id,
+            address,
+            api_url: this.apiUrl,
+        };
+        await this.saveConfig();
+        return identity;
+    }
+    async connect() {
+        await this.loadConfig();
+        const agentId = this.requireAgentId();
+        // A project API key authorizes every active address in its project. This
+        // is the normal path on a fresh device: select an address, connect, and
+        // work without manufacturing or importing a separate identity key.
+        if (this.apiKey && !existsSync(this.keyPath(agentId))) {
+            const session = await this.post("/v0/sessions", { agent_id: agentId, capabilities: { auth: "project_api_key" } }, this.projectHeaders());
+            this.config = { ...this.config, session_id: session.id, token: session.token };
+            await this.saveConfig();
+            return session;
+        }
+        const privateKey = await this.loadPrivateKey(agentId);
+        const challenge = await this.post("/v0/auth/challenge", { agent_id: agentId });
+        const issued_at = new Date().toISOString();
+        const payload = {
+            agent_id: agentId,
+            nonce: challenge.nonce,
+            issued_at,
+        };
+        const signature = signDict(privateKey, payload);
+        const session = await this.post("/v0/sessions", {
+            ...payload,
+            signature,
+        });
+        this.config = {
+            ...this.config,
+            session_id: session.id,
+            token: session.token,
+        };
+        await this.saveConfig();
+        return session;
+    }
+    async send(input) {
+        await this.loadConfig();
+        const agentId = this.requireAgentId();
+        const envelope = {
+            version: "0",
+            message_id: messageId(),
+            from: agentId,
+            to: input.to,
+            type: input.type || "request",
+            timestamp: new Date().toISOString(),
+            payload: input.payload || {},
+            metadata: input.metadata || {},
+        };
+        if (input.conversationId) {
+            envelope.conversation_id = input.conversationId;
+        }
+        if (input.expiresAt) {
+            envelope.expires_at = input.expiresAt;
+        }
+        const hasLocalKey = existsSync(this.keyPath(agentId));
+        if (!hasLocalKey && !this.apiKey) {
+            throw new Error("No local identity key or project API key is available for this address.");
+        }
+        const signature = hasLocalKey ? signDict(await this.loadPrivateKey(agentId), envelope) : undefined;
+        return this.post("/v0/messages", signature ? { ...envelope, signature } : envelope, { ...this.authHeaders(), ...(signature ? {} : this.projectHeaders()) });
+    }
+    /** List active addresses authorised by this project's API key. */
+    async addresses() {
+        const response = await this.get("/v0/agents/project-addresses", this.projectHeaders(true));
+        return response.agents;
+    }
+    /**
+     * Select an existing address in the current project.  The API key is
+     * project-scoped, so selecting another address does not require another
+     * key. Call connect() afterwards to obtain an address-scoped session.
+     */
+    async useAddress(address) {
+        const normalized = address.startsWith("@") ? address.toLowerCase() : `@${address.toLowerCase()}`;
+        const agent = (await this.addresses()).find((item) => item.address.toLowerCase() === normalized);
+        if (!agent) {
+            throw new Error(`Address '${address}' is not active in the project authorized by this API key.`);
+        }
+        this.config = {
+            ...this.config,
+            agent_id: agent.id,
+            address: agent.address,
+            api_url: this.apiUrl,
+            session_id: undefined,
+            token: undefined,
+        };
+        await this.saveConfig();
+        return agent;
+    }
+    async resolveAgent(address) {
+        return this.get(`/v0/agents/resolve?address=${encodeURIComponent(address)}`, this.authHeaders());
+    }
+    async contacts() {
+        return (await this.get(`/v0/agents/${this.requireAgentId()}/contacts`, this.authHeaders())).contacts;
+    }
+    async addContact(peer, options = {}) {
+        return this.post(`/v0/agents/${this.requireAgentId()}/contacts`, { peer, ...(options.alias ? { alias: options.alias } : {}), trusted: options.trusted || false }, this.authHeaders());
+    }
+    /** List private groups that include the active address. */
+    async groups() {
+        return this.get("/v0/groups", this.authHeaders());
+    }
+    /** Create a private group owned by the active address. */
+    async createGroup(name, description = "") {
+        return this.post("/v0/groups", { name, description }, this.authHeaders());
+    }
+    /** Add an exact same-project address to a group owned by the active address. */
+    async addGroupMember(groupId, address) {
+        return this.post(`/v0/groups/${encodeURIComponent(groupId)}/members`, { address }, this.authHeaders());
+    }
+    /** Send a message that every member of a private group can read. */
+    async sendGroupMessage(groupId, text, attachments = []) {
+        return this.post(`/v0/groups/${encodeURIComponent(groupId)}/messages`, { text, attachments }, this.authHeaders());
+    }
+    /** Read the ordered shared history for a private group. */
+    async groupMessages(groupId, limit = 100) {
+        const safeLimit = Math.max(1, Math.min(limit, 250));
+        return this.get(`/v0/groups/${encodeURIComponent(groupId)}/messages?limit=${safeLimit}`, this.authHeaders());
+    }
+    async inbox(options = {}) {
+        await this.loadConfig();
+        const response = await this.get("/v0/messages", this.authHeaders());
+        if (options.includeAcknowledged) {
+            return response.messages;
+        }
+        return response.messages.filter((message) => message.status !== "acknowledged");
+    }
+    async read(messageId) {
+        await this.loadConfig();
+        return this.get(`/v0/messages/${messageId}`, this.authHeaders());
+    }
+    async searchMessages(input = {}) {
+        const params = new URLSearchParams();
+        if (input.query)
+            params.set("q", input.query);
+        if (input.sender)
+            params.set("sender", input.sender);
+        if (input.recipient)
+            params.set("recipient", input.recipient);
+        if (input.status)
+            params.set("status", input.status);
+        if (input.type)
+            params.set("type", input.type);
+        if (input.conversationId)
+            params.set("conversation_id", input.conversationId);
+        if (input.hasAttachments !== undefined)
+            params.set("has_attachments", String(input.hasAttachments));
+        params.set("limit", String(Math.max(1, Math.min(input.limit || 50, 250))));
+        const response = await this.get(`/v0/messages/search?${params.toString()}`, this.authHeaders());
+        return response.messages;
+    }
+    async deliveryTimeline(messageId) {
+        return this.get(`/v0/messages/${messageId}/delivery`, this.authHeaders());
+    }
+    async ack(messageId) {
+        await this.loadConfig();
+        return this.post(`/v0/messages/${messageId}/ack`, {}, this.authHeaders());
+    }
+    async reply(messageId, text) {
+        const message = await this.read(messageId);
+        return this.send({
+            to: message.from_agent_id,
+            type: "status",
+            payload: { text },
+            conversationId: message.conversation_id,
+        });
+    }
+    keyPath(agentId) {
+        return join(this.keysDir, `${agentId}.key`);
+    }
+    async loadConfig() {
+        const data = await readJson(this.configPath);
+        this.config = data || {};
+    }
+    async saveConfig() {
+        await mkdir(this.home, { recursive: true });
+        await writePrivate(this.configPath, `${JSON.stringify(this.config, null, 2)}\n`);
+    }
+    async loadPrivateKey(agentId) {
+        const pem = await readFile(this.keyPath(agentId), "utf8");
+        return createPrivateKey(pem);
+    }
+    requireAgentId() {
+        if (!this.config.agent_id) {
+            throw new Error("No identity configured. Run init(address) first.");
+        }
+        return this.config.agent_id;
+    }
+    authHeaders() {
+        if (!this.config.token) {
+            throw new Error("No active session. Run connect() first.");
+        }
+        return { Authorization: `Bearer ${this.config.token}` };
+    }
+    projectHeaders(required = false) {
+        if (!this.apiKey && required) {
+            throw new Error("A project API key is required. Pass apiKey or set GREFT_API_KEY.");
+        }
+        return this.apiKey ? { "X-Greft-API-Key": this.apiKey } : {};
+    }
+    async get(path, headers = {}) {
+        return this.request("GET", path, undefined, headers);
+    }
+    async post(path, body, headers = {}) {
+        return this.request("POST", path, body, headers);
+    }
+    async request(method, path, body, headers = {}) {
+        const response = await this.fetcher(`${this.apiUrl}${path}`, {
+            method,
+            headers: {
+                ...headers,
+                ...(body === undefined ? {} : { "Content-Type": "application/json" }),
+            },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`Greft request failed: ${response.status} ${response.statusText}${text ? ` — ${text}` : ""}`);
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        return response.json();
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { GreftClient } from "./client.js";
+export type { AgentIdentity, Contact, DeliveryEvent, DeliveryTimeline, GreftClientOptions, GreftGroup, GreftMessage, GroupMember, GroupMessage, MessagePayload, ProjectAddress, SearchMessagesInput, SendMessageInput, SessionInfo, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EACV,aAAa,EACb,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { GreftClient } from "./client.js";

package/dist/types.d.ts

@@ -0,0 +1,115 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type MessagePayload = Record<string, JsonValue>;
+export interface GreftClientOptions {
+    apiUrl?: string;
+    apiKey?: string;
+    home?: string;
+    fetch?: typeof fetch;
+}
+export interface ProjectAddress extends AgentIdentity {
+}
+export interface Contact {
+    agent_id: string;
+    address: string;
+    alias: string;
+    trusted: boolean;
+    presence: "online" | "offline" | string;
+    last_seen_at?: string | null;
+}
+export interface DeliveryEvent {
+    id: string;
+    message_id: string;
+    agent_id?: string | null;
+    status: string;
+    reason: string;
+    detail: string;
+    attempt: number;
+    metadata: MessagePayload;
+    created_at: string;
+}
+export interface DeliveryTimeline {
+    message_id: string;
+    events: DeliveryEvent[];
+}
+export interface AgentIdentity {
+    id: string;
+    address: string;
+    public_key: string;
+    inbound_policy: string;
+    created_at: string;
+}
+export interface SessionInfo {
+    id: string;
+    agent_id: string;
+    token: string;
+    is_primary: boolean;
+    status: string;
+    created_at: string;
+    last_seen_at: string;
+}
+export interface GreftMessage {
+    id: string;
+    seq: number;
+    conversation_id: string;
+    from_agent_id: string;
+    to_agent_id: string;
+    type: string;
+    payload: MessagePayload;
+    metadata: MessagePayload;
+    signature: string;
+    status: string;
+    delivery_attempts: number;
+    envelope_raw: Record<string, JsonValue>;
+    created_at: string;
+    delivered_at?: string | null;
+    acknowledged_at?: string | null;
+    expires_at?: string | null;
+    client_timestamp: string;
+}
+export interface SendMessageInput {
+    to: string;
+    type?: "request" | "status" | "handoff" | "ack" | string;
+    payload?: MessagePayload;
+    conversationId?: string;
+    metadata?: MessagePayload;
+    expiresAt?: string;
+}
+export interface SearchMessagesInput {
+    query?: string;
+    sender?: string;
+    recipient?: string;
+    status?: string;
+    type?: string;
+    conversationId?: string;
+    hasAttachments?: boolean;
+    limit?: number;
+}
+export interface GroupMember {
+    agent_id: string;
+    address: string;
+    role: "owner" | "member" | string;
+    added_at: string;
+}
+export interface GreftGroup {
+    id: string;
+    project_id: string;
+    name: string;
+    description: string;
+    visibility: "private" | string;
+    owner_agent_id: string;
+    members: GroupMember[];
+    created_at: string;
+}
+export interface GroupMessage {
+    id: string;
+    group_id: string;
+    sender_agent_id: string;
+    sender_address: string;
+    payload: MessagePayload;
+    attachments: Array<Record<string, JsonValue>>;
+    created_at: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;CAAG;AAExD,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;IACzD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@greft/sdk",
+  "version": "0.2.0",
+  "description": "TypeScript SDK for Greft agent messaging.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STEIDd/Greft-imp.git",
+    "directory": "packages/greft-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/STEIDd/Greft-imp/issues"
+  },
+  "homepage": "https://greft.ai",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test test/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.11",
+    "typescript": "^5.9.2"
+  }
+}