promptwallet-sdk 0.1.0

package/README.md

@@ -0,0 +1,94 @@
+# @promptwallet/sdk
+
+TypeScript SDK for PromptWallet — chat, artifacts, and workspace indexing.
+
+## Install
+
+```bash
+npm install @promptwallet/sdk
+```
+
+## Usage
+
+```typescript
+import { PromptWallet } from '@promptwallet/sdk';
+
+const pw = new PromptWallet({
+  baseUrl: 'http://localhost:8080',
+  apiKey: process.env.PROMPTWALLET_API_KEY,
+});
+
+// Chat with RAG context
+const response = await pw.chat({
+  model: 'llama-3.1-70b-versatile',
+  messages: [{ role: 'user', content: 'How does auth work?' }],
+  rag_namespaces: ['codebase', 'chats'],
+});
+
+// Stream chat
+for await (const chunk of pw.chatStream({
+  model: 'llama-3.1-70b-versatile',
+  messages: [{ role: 'user', content: 'Explain the login flow' }],
+  rag_namespaces: ['codebase'],
+})) {
+  if (chunk.content) process.stdout.write(chunk.content);
+}
+
+// Store artifact
+await pw.artifacts.store({
+  type: 'component_tree',
+  title: 'Dashboard',
+  content: JSON.stringify({ components: [...] }),
+  namespace: 'mastercanvas:proj1',
+});
+
+// Search artifacts
+const results = await pw.artifacts.search({
+  query: 'button component',
+  artifact_type: 'component_tree',
+  limit: 5,
+});
+
+// Workspace: preview → index → poll status
+const preview = await pw.workspace.preview({ path: '/projects/my-app' });
+const { job_id } = await pw.workspace.index({ path: '/projects/my-app' });
+const { jobs } = await pw.workspace.status(job_id);
+
+// Search indexed code
+const codeResults = await pw.workspace.search({ q: 'auth middleware', limit: 10 });
+```
+
+## API
+
+- **chat(options)** — Chat with RAG context injection
+- **chatStream(options)** — Async generator for streaming
+- **artifacts.store(options)** — Store artifact (document, code_snippet, component_tree, etc.)
+- **artifacts.search(options)** — Semantic search
+- **artifacts.get(id)** — Get single artifact
+- **artifacts.getFull(id)** — Get all chunks
+- **artifacts.delete(id)** — Delete artifact
+- **workspace.preview(options)** — Estimate indexing
+- **workspace.index(options)** — Start indexing (returns job_id)
+- **workspace.status(jobId?)** — Poll index status
+- **workspace.search(options)** — Search indexed code
+- **workspace.deleteFiles(options)** — Remove files from index
+
+## RAG Namespaces
+
+Use `rag_namespaces` in chat to filter context:
+
+| Namespace | Artifact type |
+|-----------|---------------|
+| `codebase`, `code` | CodeSnippet |
+| `chats`, `chat` | ChatResponse |
+| `docs`, `document` | Document |
+| `mastercanvas`, `component_tree` | ComponentTree |
+| `*` or omit | All types |
+
+## Development
+
+```bash
+cd packages/sdk
+npm install
+npm run build
+```

package/dist/chunk-IKUCY76J.mjs

@@ -0,0 +1,55 @@
+// src/client.ts
+var PromptWalletError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "PromptWalletError";
+  }
+};
+async function createHeaders(config) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  let token = null;
+  if (config.apiKey) {
+    token = config.apiKey;
+  } else if (config.getToken) {
+    token = await config.getToken();
+  }
+  if (token) {
+    headers["Authorization"] = `Bearer ${token}`;
+  }
+  return headers;
+}
+async function fetchApi(config, path, init = {}) {
+  const base = (config.baseUrl ?? "https://api.promptwallet.dev").replace(/\/$/, "");
+  const url = `${base}${path.startsWith("/") ? path : `/${path}`}`;
+  const headers = await createHeaders(config);
+  const res = await fetch(url, {
+    ...init,
+    headers: { ...headers, ...init.headers }
+  });
+  if (!res.ok) {
+    let body;
+    try {
+      body = await res.json();
+    } catch {
+      body = await res.text();
+    }
+    throw new PromptWalletError(
+      `PromptWallet API error: ${res.status} ${res.statusText}`,
+      res.status,
+      body
+    );
+  }
+  const text = await res.text();
+  if (!text) return {};
+  return JSON.parse(text);
+}
+
+export {
+  PromptWalletError,
+  createHeaders,
+  fetchApi
+};

package/dist/client-Q6AFL5TB.mjs

@@ -0,0 +1,10 @@
+import {
+  PromptWalletError,
+  createHeaders,
+  fetchApi
+} from "./chunk-IKUCY76J.mjs";
+export {
+  PromptWalletError,
+  createHeaders,
+  fetchApi
+};

package/dist/index.d.mts

@@ -0,0 +1,258 @@
+/**
+ * Base HTTP client for PromptWallet API
+ */
+type PromptWalletConfig = {
+    baseUrl?: string;
+    apiKey?: string;
+    /** Async function to get auth token (e.g. Clerk session) */
+    getToken?: () => Promise<string | null>;
+};
+declare class PromptWalletError extends Error {
+    status?: number | undefined;
+    body?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, body?: unknown | undefined);
+}
+
+/**
+ * Chat completions - OpenAI-compatible with RAG
+ */
+
+type ChatMessage$1 = {
+    role: "system" | "user" | "assistant";
+    content: string | Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "image_url";
+        image_url: {
+            url: string;
+        };
+    }>;
+};
+type ChatOptions$1 = {
+    model: string;
+    messages: ChatMessage$1[];
+    temperature?: number;
+    max_tokens?: number;
+    stream?: boolean;
+    /** RAG namespaces: codebase, chats, docs, mastercanvas, etc. */
+    rag_namespaces?: string[];
+    /** Max tokens for injected context */
+    max_context_tokens?: number;
+};
+type ChatResponse$1 = {
+    id: string;
+    model: string;
+    choices: Array<{
+        message: {
+            role: string;
+            content: string | null;
+        };
+        finish_reason: string;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+};
+
+/**
+ * Artifact storage and search
+ */
+
+type StoreArtifactOptions$1 = {
+    type: string;
+    title?: string;
+    content: string;
+    namespace?: string;
+    metadata?: Record<string, unknown>;
+};
+type StoreArtifactResponse$1 = {
+    ids: string[];
+    chunks: number;
+    message: string;
+};
+type SearchResult$1 = {
+    id: string;
+    artifact_type: string;
+    title: string | null;
+    content: string;
+    similarity: number;
+    highlights: string[];
+    metadata: Record<string, unknown>;
+    created_at: string;
+};
+type SearchArtifactsOptions$1 = {
+    query: string;
+    namespaces?: string[];
+    limit?: number;
+    minScore?: number;
+    /** Filter by artifact type (e.g. document, code_snippet, component_tree) */
+    artifact_type?: string;
+};
+type SearchArtifactsResponse$1 = {
+    results: SearchResult$1[];
+    total: number;
+    query: string;
+};
+
+/**
+ * Workspace indexing and search
+ */
+
+type WorkspacePreviewResponse$1 = {
+    file_count: number;
+    total_size_bytes: number;
+    estimated_chunks: number;
+    estimated_seconds: number;
+};
+type IndexWorkspaceOptions$1 = {
+    path: string;
+    include_patterns?: string[];
+    exclude_patterns?: string[];
+    watch?: boolean;
+};
+type IndexWorkspaceResponse$1 = {
+    job_id: string;
+    path: string;
+    workspace_id: string;
+    status: IndexStatus$1;
+};
+type IndexStatus$1 = {
+    state: "idle" | "indexing" | "error";
+    total_files?: number;
+    indexed_files?: number;
+    total_chunks?: number;
+    error?: string;
+};
+type WorkspaceSearchResult$1 = {
+    path: string;
+    language: string | null;
+    content: string;
+    chunk_index: number;
+    total_chunks: number;
+    score: number;
+    workspace_path?: string;
+    git_url?: string;
+    repo_name?: string;
+};
+type WorkspaceSearchResponse$1 = {
+    results: WorkspaceSearchResult$1[];
+    total: number;
+    query: string;
+};
+type DeleteWorkspaceFilesOptions = {
+    workspace_path: string;
+    path?: string;
+};
+
+/**
+ * @promptwallet/sdk - PromptWallet TypeScript SDK
+ *
+ * Chat, artifacts, and workspace for MasterCanvas, OpenClaw, and custom apps.
+ */
+
+type ChatMessage = ChatMessage$1;
+type ChatOptions = ChatOptions$1;
+type ChatResponse = ChatResponse$1;
+type StoreArtifactOptions = StoreArtifactOptions$1;
+type StoreArtifactResponse = StoreArtifactResponse$1;
+type SearchResult = SearchResult$1;
+type SearchArtifactsOptions = SearchArtifactsOptions$1;
+type SearchArtifactsResponse = SearchArtifactsResponse$1;
+type WorkspacePreviewResponse = WorkspacePreviewResponse$1;
+type IndexWorkspaceOptions = IndexWorkspaceOptions$1;
+type IndexWorkspaceResponse = IndexWorkspaceResponse$1;
+type IndexStatus = IndexStatus$1;
+type WorkspaceSearchResult = WorkspaceSearchResult$1;
+type WorkspaceSearchResponse = WorkspaceSearchResponse$1;
+/**
+ * PromptWallet client for chat, artifacts, and workspace.
+ *
+ * @example
+ * ```ts
+ * import { PromptWallet } from '@promptwallet/sdk';
+ *
+ * const pw = new PromptWallet({
+ *   baseUrl: 'http://localhost:8080',
+ *   apiKey: process.env.PROMPTWALLET_API_KEY,
+ * });
+ *
+ * const response = await pw.chat({
+ *   model: 'llama-3.1-70b-versatile',
+ *   messages: [{ role: 'user', content: 'How does auth work?' }],
+ *   rag_namespaces: ['codebase', 'chats'],
+ * });
+ *
+ * const results = await pw.artifacts.search({
+ *   query: 'login flow',
+ *   namespaces: ['codebase'],
+ *   limit: 5,
+ * });
+ * ```
+ */
+declare class PromptWallet {
+    private config;
+    constructor(config: PromptWalletConfig);
+    /** Chat with RAG context injection */
+    chat(options: ChatOptions$1): Promise<ChatResponse$1>;
+    /** Stream chat response */
+    chatStream(options: Omit<ChatOptions$1, "stream">): AsyncGenerator<{
+        content?: string;
+        done?: boolean;
+    }>;
+    /** Artifact operations */
+    artifacts: {
+        store: (options: StoreArtifactOptions$1) => Promise<StoreArtifactResponse$1>;
+        search: (options: SearchArtifactsOptions$1) => Promise<SearchArtifactsResponse$1>;
+        get: (id: string) => Promise<{
+            id: string;
+            artifact_type: string;
+            title: string | null;
+            content: string;
+            metadata: Record<string, unknown>;
+            chunk_index: number;
+            total_chunks: number;
+            created_at: string;
+        }>;
+        getFull: (id: string) => Promise<{
+            id: string;
+            content: string;
+            chunk_index: number;
+            total_chunks: number;
+        }[]>;
+        delete: (id: string) => Promise<{
+            success: boolean;
+            message: string;
+        }>;
+    };
+    /** Workspace indexing and search */
+    workspace: {
+        preview: (options: {
+            path: string;
+        }) => Promise<WorkspacePreviewResponse$1>;
+        index: (options: IndexWorkspaceOptions$1) => Promise<IndexWorkspaceResponse$1>;
+        status: (jobId?: string) => Promise<{
+            jobs: Array<{
+                job_id: string;
+                path: string;
+                workspace_id: string;
+                status: IndexStatus$1;
+                created_at: string;
+            }>;
+        }>;
+        search: (options: {
+            q: string;
+            limit?: number;
+            language?: string;
+            path?: string;
+        }) => Promise<WorkspaceSearchResponse$1>;
+        deleteFiles: (options: DeleteWorkspaceFilesOptions) => Promise<{
+            deleted_count: number;
+            message: string;
+        }>;
+    };
+}
+
+export { type ChatMessage, type ChatOptions, type ChatResponse, type IndexStatus, type IndexWorkspaceOptions, type IndexWorkspaceResponse, PromptWallet, type PromptWalletConfig, PromptWalletError, type SearchArtifactsOptions, type SearchArtifactsResponse, type SearchResult, type StoreArtifactOptions, type StoreArtifactResponse, type WorkspacePreviewResponse, type WorkspaceSearchResponse, type WorkspaceSearchResult };

package/dist/index.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Base HTTP client for PromptWallet API
+ */
+type PromptWalletConfig = {
+    baseUrl?: string;
+    apiKey?: string;
+    /** Async function to get auth token (e.g. Clerk session) */
+    getToken?: () => Promise<string | null>;
+};
+declare class PromptWalletError extends Error {
+    status?: number | undefined;
+    body?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, body?: unknown | undefined);
+}
+
+/**
+ * Chat completions - OpenAI-compatible with RAG
+ */
+
+type ChatMessage$1 = {
+    role: "system" | "user" | "assistant";
+    content: string | Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "image_url";
+        image_url: {
+            url: string;
+        };
+    }>;
+};
+type ChatOptions$1 = {
+    model: string;
+    messages: ChatMessage$1[];
+    temperature?: number;
+    max_tokens?: number;
+    stream?: boolean;
+    /** RAG namespaces: codebase, chats, docs, mastercanvas, etc. */
+    rag_namespaces?: string[];
+    /** Max tokens for injected context */
+    max_context_tokens?: number;
+};
+type ChatResponse$1 = {
+    id: string;
+    model: string;
+    choices: Array<{
+        message: {
+            role: string;
+            content: string | null;
+        };
+        finish_reason: string;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+};
+
+/**
+ * Artifact storage and search
+ */
+
+type StoreArtifactOptions$1 = {
+    type: string;
+    title?: string;
+    content: string;
+    namespace?: string;
+    metadata?: Record<string, unknown>;
+};
+type StoreArtifactResponse$1 = {
+    ids: string[];
+    chunks: number;
+    message: string;
+};
+type SearchResult$1 = {
+    id: string;
+    artifact_type: string;
+    title: string | null;
+    content: string;
+    similarity: number;
+    highlights: string[];
+    metadata: Record<string, unknown>;
+    created_at: string;
+};
+type SearchArtifactsOptions$1 = {
+    query: string;
+    namespaces?: string[];
+    limit?: number;
+    minScore?: number;
+    /** Filter by artifact type (e.g. document, code_snippet, component_tree) */
+    artifact_type?: string;
+};
+type SearchArtifactsResponse$1 = {
+    results: SearchResult$1[];
+    total: number;
+    query: string;
+};
+
+/**
+ * Workspace indexing and search
+ */
+
+type WorkspacePreviewResponse$1 = {
+    file_count: number;
+    total_size_bytes: number;
+    estimated_chunks: number;
+    estimated_seconds: number;
+};
+type IndexWorkspaceOptions$1 = {
+    path: string;
+    include_patterns?: string[];
+    exclude_patterns?: string[];
+    watch?: boolean;
+};
+type IndexWorkspaceResponse$1 = {
+    job_id: string;
+    path: string;
+    workspace_id: string;
+    status: IndexStatus$1;
+};
+type IndexStatus$1 = {
+    state: "idle" | "indexing" | "error";
+    total_files?: number;
+    indexed_files?: number;
+    total_chunks?: number;
+    error?: string;
+};
+type WorkspaceSearchResult$1 = {
+    path: string;
+    language: string | null;
+    content: string;
+    chunk_index: number;
+    total_chunks: number;
+    score: number;
+    workspace_path?: string;
+    git_url?: string;
+    repo_name?: string;
+};
+type WorkspaceSearchResponse$1 = {
+    results: WorkspaceSearchResult$1[];
+    total: number;
+    query: string;
+};
+type DeleteWorkspaceFilesOptions = {
+    workspace_path: string;
+    path?: string;
+};
+
+/**
+ * @promptwallet/sdk - PromptWallet TypeScript SDK
+ *
+ * Chat, artifacts, and workspace for MasterCanvas, OpenClaw, and custom apps.
+ */
+
+type ChatMessage = ChatMessage$1;
+type ChatOptions = ChatOptions$1;
+type ChatResponse = ChatResponse$1;
+type StoreArtifactOptions = StoreArtifactOptions$1;
+type StoreArtifactResponse = StoreArtifactResponse$1;
+type SearchResult = SearchResult$1;
+type SearchArtifactsOptions = SearchArtifactsOptions$1;
+type SearchArtifactsResponse = SearchArtifactsResponse$1;
+type WorkspacePreviewResponse = WorkspacePreviewResponse$1;
+type IndexWorkspaceOptions = IndexWorkspaceOptions$1;
+type IndexWorkspaceResponse = IndexWorkspaceResponse$1;
+type IndexStatus = IndexStatus$1;
+type WorkspaceSearchResult = WorkspaceSearchResult$1;
+type WorkspaceSearchResponse = WorkspaceSearchResponse$1;
+/**
+ * PromptWallet client for chat, artifacts, and workspace.
+ *
+ * @example
+ * ```ts
+ * import { PromptWallet } from '@promptwallet/sdk';
+ *
+ * const pw = new PromptWallet({
+ *   baseUrl: 'http://localhost:8080',
+ *   apiKey: process.env.PROMPTWALLET_API_KEY,
+ * });
+ *
+ * const response = await pw.chat({
+ *   model: 'llama-3.1-70b-versatile',
+ *   messages: [{ role: 'user', content: 'How does auth work?' }],
+ *   rag_namespaces: ['codebase', 'chats'],
+ * });
+ *
+ * const results = await pw.artifacts.search({
+ *   query: 'login flow',
+ *   namespaces: ['codebase'],
+ *   limit: 5,
+ * });
+ * ```
+ */
+declare class PromptWallet {
+    private config;
+    constructor(config: PromptWalletConfig);
+    /** Chat with RAG context injection */
+    chat(options: ChatOptions$1): Promise<ChatResponse$1>;
+    /** Stream chat response */
+    chatStream(options: Omit<ChatOptions$1, "stream">): AsyncGenerator<{
+        content?: string;
+        done?: boolean;
+    }>;
+    /** Artifact operations */
+    artifacts: {
+        store: (options: StoreArtifactOptions$1) => Promise<StoreArtifactResponse$1>;
+        search: (options: SearchArtifactsOptions$1) => Promise<SearchArtifactsResponse$1>;
+        get: (id: string) => Promise<{
+            id: string;
+            artifact_type: string;
+            title: string | null;
+            content: string;
+            metadata: Record<string, unknown>;
+            chunk_index: number;
+            total_chunks: number;
+            created_at: string;
+        }>;
+        getFull: (id: string) => Promise<{
+            id: string;
+            content: string;
+            chunk_index: number;
+            total_chunks: number;
+        }[]>;
+        delete: (id: string) => Promise<{
+            success: boolean;
+            message: string;
+        }>;
+    };
+    /** Workspace indexing and search */
+    workspace: {
+        preview: (options: {
+            path: string;
+        }) => Promise<WorkspacePreviewResponse$1>;
+        index: (options: IndexWorkspaceOptions$1) => Promise<IndexWorkspaceResponse$1>;
+        status: (jobId?: string) => Promise<{
+            jobs: Array<{
+                job_id: string;
+                path: string;
+                workspace_id: string;
+                status: IndexStatus$1;
+                created_at: string;
+            }>;
+        }>;
+        search: (options: {
+            q: string;
+            limit?: number;
+            language?: string;
+            path?: string;
+        }) => Promise<WorkspaceSearchResponse$1>;
+        deleteFiles: (options: DeleteWorkspaceFilesOptions) => Promise<{
+            deleted_count: number;
+            message: string;
+        }>;
+    };
+}
+
+export { type ChatMessage, type ChatOptions, type ChatResponse, type IndexStatus, type IndexWorkspaceOptions, type IndexWorkspaceResponse, PromptWallet, type PromptWalletConfig, PromptWalletError, type SearchArtifactsOptions, type SearchArtifactsResponse, type SearchResult, type StoreArtifactOptions, type StoreArtifactResponse, type WorkspacePreviewResponse, type WorkspaceSearchResponse, type WorkspaceSearchResult };

package/dist/index.js

@@ -0,0 +1,283 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  PromptWalletError: () => PromptWalletError,
+  createHeaders: () => createHeaders,
+  fetchApi: () => fetchApi
+});
+async function createHeaders(config) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  let token = null;
+  if (config.apiKey) {
+    token = config.apiKey;
+  } else if (config.getToken) {
+    token = await config.getToken();
+  }
+  if (token) {
+    headers["Authorization"] = `Bearer ${token}`;
+  }
+  return headers;
+}
+async function fetchApi(config, path, init = {}) {
+  const base = (config.baseUrl ?? "https://api.promptwallet.dev").replace(/\/$/, "");
+  const url = `${base}${path.startsWith("/") ? path : `/${path}`}`;
+  const headers = await createHeaders(config);
+  const res = await fetch(url, {
+    ...init,
+    headers: { ...headers, ...init.headers }
+  });
+  if (!res.ok) {
+    let body;
+    try {
+      body = await res.json();
+    } catch {
+      body = await res.text();
+    }
+    throw new PromptWalletError(
+      `PromptWallet API error: ${res.status} ${res.statusText}`,
+      res.status,
+      body
+    );
+  }
+  const text = await res.text();
+  if (!text) return {};
+  return JSON.parse(text);
+}
+var PromptWalletError;
+var init_client = __esm({
+  "src/client.ts"() {
+    "use strict";
+    PromptWalletError = class extends Error {
+      constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "PromptWalletError";
+      }
+    };
+  }
+});
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PromptWallet: () => PromptWallet,
+  PromptWalletError: () => PromptWalletError
+});
+module.exports = __toCommonJS(index_exports);
+init_client();
+
+// src/chat.ts
+init_client();
+async function chat(config, options) {
+  const body = {
+    model: options.model,
+    messages: options.messages,
+    temperature: options.temperature ?? 1,
+    max_tokens: options.max_tokens,
+    stream: false,
+    rag_namespaces: options.rag_namespaces,
+    max_context_tokens: options.max_context_tokens
+  };
+  return fetchApi(config, "/v1/chat/completions", {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function* chatStream(config, options) {
+  const base = (config.baseUrl ?? "https://api.promptwallet.dev").replace(/\/$/, "");
+  const url = `${base}/v1/chat/completions`;
+  const { createHeaders: createHeaders2 } = await Promise.resolve().then(() => (init_client(), client_exports));
+  const headers = await createHeaders2(config);
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { ...headers, "Content-Type": "application/json" },
+    body: JSON.stringify({
+      model: options.model,
+      messages: options.messages,
+      temperature: options.temperature ?? 1,
+      max_tokens: options.max_tokens,
+      stream: true,
+      rag_namespaces: options.rag_namespaces,
+      max_context_tokens: options.max_context_tokens
+    })
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`PromptWallet API error: ${res.status} ${text}`);
+  }
+  const reader = res.body?.getReader();
+  if (!reader) throw new Error("No response body");
+  const decoder = new TextDecoder();
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      if (line.startsWith("data: ")) {
+        const data = line.slice(6);
+        if (data === "[DONE]") return;
+        try {
+          const parsed = JSON.parse(data);
+          const delta = parsed.choices?.[0]?.delta?.content;
+          if (delta) yield { content: delta };
+        } catch {
+        }
+      }
+    }
+  }
+}
+
+// src/artifacts.ts
+init_client();
+async function storeArtifact(config, options) {
+  const metadata = { ...options.metadata };
+  if (options.namespace) {
+    metadata.namespace = options.namespace;
+  }
+  const body = {
+    artifact_type: options.type,
+    title: options.title,
+    content: options.content,
+    metadata
+  };
+  const res = await fetchApi(
+    config,
+    "/v1/artifacts",
+    { method: "POST", body: JSON.stringify(body) }
+  );
+  return {
+    ids: res.ids.map(String),
+    chunks: res.chunks,
+    message: res.message
+  };
+}
+async function searchArtifacts(config, options) {
+  const params = new URLSearchParams();
+  params.set("q", options.query);
+  params.set("limit", String(options.limit ?? 10));
+  if (options.minScore != null) params.set("min_similarity", String(options.minScore));
+  if (options.artifact_type) params.set("artifact_type", options.artifact_type);
+  const res = await fetchApi(config, `/v1/artifacts/search?${params}`);
+  return {
+    results: res.results.map((r) => ({ ...r, id: String(r.id) })),
+    total: res.total,
+    query: res.query
+  };
+}
+async function getArtifact(config, id) {
+  const res = await fetchApi(config, `/v1/artifacts/${id}`);
+  return { ...res, id: String(res.id) };
+}
+async function getFullArtifact(config, id) {
+  const chunks = await fetchApi(config, `/v1/artifacts/${id}/full`);
+  return chunks.map((c) => ({ ...c, id: String(c.id) }));
+}
+async function deleteArtifact(config, id) {
+  return fetchApi(config, `/v1/artifacts/${id}`, { method: "DELETE" });
+}
+
+// src/workspace.ts
+init_client();
+async function previewWorkspace(config, options) {
+  return fetchApi(config, "/v1/workspace/preview", {
+    method: "POST",
+    body: JSON.stringify({ path: options.path })
+  });
+}
+async function indexWorkspace(config, options) {
+  const body = {
+    path: options.path,
+    include_patterns: options.include_patterns,
+    exclude_patterns: options.exclude_patterns,
+    watch: options.watch ?? true
+  };
+  return fetchApi(config, "/v1/workspace/index", {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function workspaceStatus(config, jobId) {
+  const params = jobId ? `?job_id=${encodeURIComponent(jobId)}` : "";
+  return fetchApi(config, `/v1/workspace/status${params}`);
+}
+async function searchWorkspace(config, options) {
+  const params = new URLSearchParams();
+  params.set("q", options.q);
+  params.set("limit", String(options.limit ?? 10));
+  if (options.language) params.set("language", options.language);
+  if (options.path) params.set("path", options.path);
+  return fetchApi(config, `/v1/workspace/search?${params}`);
+}
+async function deleteWorkspaceFiles(config, options) {
+  return fetchApi(config, "/v1/workspace/files", {
+    method: "DELETE",
+    body: JSON.stringify({
+      workspace_path: options.workspace_path,
+      path: options.path
+    })
+  });
+}
+
+// src/index.ts
+var PromptWallet = class {
+  constructor(config) {
+    this.config = config;
+    /** Artifact operations */
+    this.artifacts = {
+      store: (options) => storeArtifact(this.config, options),
+      search: (options) => searchArtifacts(this.config, options),
+      get: (id) => getArtifact(this.config, id),
+      getFull: (id) => getFullArtifact(this.config, id),
+      delete: (id) => deleteArtifact(this.config, id)
+    };
+    /** Workspace indexing and search */
+    this.workspace = {
+      preview: (options) => previewWorkspace(this.config, options),
+      index: (options) => indexWorkspace(this.config, options),
+      status: (jobId) => workspaceStatus(this.config, jobId),
+      search: (options) => searchWorkspace(this.config, options),
+      deleteFiles: (options) => deleteWorkspaceFiles(this.config, options)
+    };
+  }
+  /** Chat with RAG context injection */
+  async chat(options) {
+    return chat(this.config, options);
+  }
+  /** Stream chat response */
+  async *chatStream(options) {
+    yield* chatStream(this.config, options);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PromptWallet,
+  PromptWalletError
+});

package/dist/index.mjs

@@ -0,0 +1,191 @@
+import {
+  PromptWalletError,
+  fetchApi
+} from "./chunk-IKUCY76J.mjs";
+
+// src/chat.ts
+async function chat(config, options) {
+  const body = {
+    model: options.model,
+    messages: options.messages,
+    temperature: options.temperature ?? 1,
+    max_tokens: options.max_tokens,
+    stream: false,
+    rag_namespaces: options.rag_namespaces,
+    max_context_tokens: options.max_context_tokens
+  };
+  return fetchApi(config, "/v1/chat/completions", {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function* chatStream(config, options) {
+  const base = (config.baseUrl ?? "https://api.promptwallet.dev").replace(/\/$/, "");
+  const url = `${base}/v1/chat/completions`;
+  const { createHeaders } = await import("./client-Q6AFL5TB.mjs");
+  const headers = await createHeaders(config);
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { ...headers, "Content-Type": "application/json" },
+    body: JSON.stringify({
+      model: options.model,
+      messages: options.messages,
+      temperature: options.temperature ?? 1,
+      max_tokens: options.max_tokens,
+      stream: true,
+      rag_namespaces: options.rag_namespaces,
+      max_context_tokens: options.max_context_tokens
+    })
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`PromptWallet API error: ${res.status} ${text}`);
+  }
+  const reader = res.body?.getReader();
+  if (!reader) throw new Error("No response body");
+  const decoder = new TextDecoder();
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      if (line.startsWith("data: ")) {
+        const data = line.slice(6);
+        if (data === "[DONE]") return;
+        try {
+          const parsed = JSON.parse(data);
+          const delta = parsed.choices?.[0]?.delta?.content;
+          if (delta) yield { content: delta };
+        } catch {
+        }
+      }
+    }
+  }
+}
+
+// src/artifacts.ts
+async function storeArtifact(config, options) {
+  const metadata = { ...options.metadata };
+  if (options.namespace) {
+    metadata.namespace = options.namespace;
+  }
+  const body = {
+    artifact_type: options.type,
+    title: options.title,
+    content: options.content,
+    metadata
+  };
+  const res = await fetchApi(
+    config,
+    "/v1/artifacts",
+    { method: "POST", body: JSON.stringify(body) }
+  );
+  return {
+    ids: res.ids.map(String),
+    chunks: res.chunks,
+    message: res.message
+  };
+}
+async function searchArtifacts(config, options) {
+  const params = new URLSearchParams();
+  params.set("q", options.query);
+  params.set("limit", String(options.limit ?? 10));
+  if (options.minScore != null) params.set("min_similarity", String(options.minScore));
+  if (options.artifact_type) params.set("artifact_type", options.artifact_type);
+  const res = await fetchApi(config, `/v1/artifacts/search?${params}`);
+  return {
+    results: res.results.map((r) => ({ ...r, id: String(r.id) })),
+    total: res.total,
+    query: res.query
+  };
+}
+async function getArtifact(config, id) {
+  const res = await fetchApi(config, `/v1/artifacts/${id}`);
+  return { ...res, id: String(res.id) };
+}
+async function getFullArtifact(config, id) {
+  const chunks = await fetchApi(config, `/v1/artifacts/${id}/full`);
+  return chunks.map((c) => ({ ...c, id: String(c.id) }));
+}
+async function deleteArtifact(config, id) {
+  return fetchApi(config, `/v1/artifacts/${id}`, { method: "DELETE" });
+}
+
+// src/workspace.ts
+async function previewWorkspace(config, options) {
+  return fetchApi(config, "/v1/workspace/preview", {
+    method: "POST",
+    body: JSON.stringify({ path: options.path })
+  });
+}
+async function indexWorkspace(config, options) {
+  const body = {
+    path: options.path,
+    include_patterns: options.include_patterns,
+    exclude_patterns: options.exclude_patterns,
+    watch: options.watch ?? true
+  };
+  return fetchApi(config, "/v1/workspace/index", {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function workspaceStatus(config, jobId) {
+  const params = jobId ? `?job_id=${encodeURIComponent(jobId)}` : "";
+  return fetchApi(config, `/v1/workspace/status${params}`);
+}
+async function searchWorkspace(config, options) {
+  const params = new URLSearchParams();
+  params.set("q", options.q);
+  params.set("limit", String(options.limit ?? 10));
+  if (options.language) params.set("language", options.language);
+  if (options.path) params.set("path", options.path);
+  return fetchApi(config, `/v1/workspace/search?${params}`);
+}
+async function deleteWorkspaceFiles(config, options) {
+  return fetchApi(config, "/v1/workspace/files", {
+    method: "DELETE",
+    body: JSON.stringify({
+      workspace_path: options.workspace_path,
+      path: options.path
+    })
+  });
+}
+
+// src/index.ts
+var PromptWallet = class {
+  constructor(config) {
+    this.config = config;
+    /** Artifact operations */
+    this.artifacts = {
+      store: (options) => storeArtifact(this.config, options),
+      search: (options) => searchArtifacts(this.config, options),
+      get: (id) => getArtifact(this.config, id),
+      getFull: (id) => getFullArtifact(this.config, id),
+      delete: (id) => deleteArtifact(this.config, id)
+    };
+    /** Workspace indexing and search */
+    this.workspace = {
+      preview: (options) => previewWorkspace(this.config, options),
+      index: (options) => indexWorkspace(this.config, options),
+      status: (jobId) => workspaceStatus(this.config, jobId),
+      search: (options) => searchWorkspace(this.config, options),
+      deleteFiles: (options) => deleteWorkspaceFiles(this.config, options)
+    };
+  }
+  /** Chat with RAG context injection */
+  async chat(options) {
+    return chat(this.config, options);
+  }
+  /** Stream chat response */
+  async *chatStream(options) {
+    yield* chatStream(this.config, options);
+  }
+};
+export {
+  PromptWallet,
+  PromptWalletError
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "promptwallet-sdk",
+  "version": "0.1.0",
+  "description": "PromptWallet TypeScript SDK for chat, artifacts, and workspace",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "promptwallet",
+    "ai",
+    "rag",
+    "llm"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}