@joai/sdk 0.4.0 → 0.6.0

package/dist/index.d.mts

@@ -360,6 +360,7 @@ type Blueprint = {
   description: string | null;
   avatar: string | null;
   settings: BlueprintSettings;
+  documentCount: number;
   verified: boolean;
   createdAt: string;
   locales: WarpLocale[];
@@ -489,6 +490,7 @@ type Contact = {
   socials: Record<string, string> | null;
   notes: string | null;
   tags: string[] | null;
+  userId: string | null;
   props?: Record<string, string> | null;
 };
 type ContactActivity = {
@@ -611,6 +613,8 @@ type Memory = {
   name: string;
   content: string;
   createdAt: string;
+  contactId: string | null;
+  roomId: string | null;
 }; //#endregion
 //#region src/peerme/types.d.ts
 type ChatClientAction = 'AGENT_DELEGATE' | 'WARP_EXECUTE' | 'WARP_VIEW' | 'WARP_CREATE' | 'WARP_TEST' | 'WARP_INPUT' | 'WARP_APPROVE' | 'WARP_SELECT' | 'WARP_BATCH' | 'WARP_BULK' | 'ENTITY_PROPOSE' | 'ENTITY_SIGN' | 'SECRET_SET' | 'SECRET_AUTHORIZE' | 'HEALTH_QUERY' | 'HEALTH_WRITE' | 'ITEM_VIEW' | 'BOARD_SUMMARY' | 'GOAL_PROGRESS' | 'CONTACT_VIEW' | 'MARKETPLACE_PURCHASE' | 'WARP_CLOUD_EXECUTE' | 'MISSION_VIEW' | 'ACTIVITY' | 'PERSONA_QUESTION' | 'NFC_WRITE' | 'twilio.sms';
@@ -698,6 +702,52 @@ type BrandSiteConfig = {
   logoUrl?: string | null;
 };
 //#endregion
+//#region src/store/types.d.ts
+type StoreVisibility = 'private' | 'team' | 'public';
+type StoreEntry = {
+  value: number | string | boolean;
+  label?: string;
+  at: string;
+};
+type Store = {
+  name: string;
+  description: string;
+  valueType: 'scalar' | 'series';
+  unit?: string;
+  visibility: StoreVisibility;
+  entryCount: number;
+  lastValue?: number | string | boolean;
+  lastAt?: string;
+};
+type StoreWithEntries = {
+  name: string;
+  description: string;
+  unit?: string;
+  entries: StoreEntry[];
+};
+type StoreCreatePayload = {
+  name: string;
+  description?: string;
+  valueType?: 'scalar' | 'series';
+  unit?: string;
+  visibility?: StoreVisibility;
+};
+type StoreEntryPayload = {
+  storeName?: string;
+  value: number | string | boolean;
+  label?: string;
+};
+type StoreEntryResult = {
+  name: string;
+  entryCount: number;
+};
+type StoreToggleResult = {
+  name: string;
+  value: number | string | boolean;
+  previous: number | string | boolean;
+}; //#endregion
+//#region src/swarm/types.d.ts
+//#endregion
 //#region src/resources/agents.d.ts
 declare class AgentsResource {
   private readonly http;
@@ -798,10 +848,18 @@ declare class ContactsResource {
 declare class DocumentsResource {
   private readonly http;
   constructor(http: IHttpService);
-  ingest(payload: {
+  list(agent: string, search?: string): Promise<IAppResponse<Document[]>>;
+  create(agent: string, data: {
     title: string;
     content: string;
+    blueprint?: string;
+  }): Promise<IAppResponse<Document>>;
+  get(id: string): Promise<IAppResponse<Document>>;
+  update(id: string, data: {
+    title?: string;
+    content?: string;
   }): Promise<IAppResponse<Document>>;
+  delete(id: string): Promise<IAppResponse<unknown>>;
 }
 //#endregion
 //#region src/resources/goals.d.ts
@@ -896,11 +954,12 @@ declare class SitesResource {
   private readonly http;
   constructor(http: IHttpService);
   listMine(teamSlug: string): Promise<IAppResponse<Site[]>>;
-  resolve(teamSlug: string, brandSlug: string): Promise<IAppResponse<Site>>;
+  resolve(teamSlug: string, brandSlug?: string): Promise<IAppResponse<Site>>;
   resolveByDomain(domain: string): Promise<IAppResponse<Site>>;
   update(siteSlug: string, data: {
     customDomain?: string | null;
     enabled?: boolean;
+    modules?: string[];
   }): Promise<IAppResponse<{
     updated: boolean;
   }>>;
@@ -917,6 +976,26 @@ declare class TeamsResource {
   }): Promise<IAppResponse<unknown>>;
 }
 //#endregion
+//#region src/resources/stores.d.ts
+declare class StoresResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  list(): Promise<IAppResponse<{
+    data: Store[];
+  }>>;
+  create(payload: StoreCreatePayload): Promise<IAppResponse<Store>>;
+  entries(params?: {
+    storeName?: string;
+    since?: string;
+    until?: string;
+    last?: number;
+  }): Promise<IAppResponse<StoreWithEntries>>;
+  setEntry(payload: StoreEntryPayload): Promise<IAppResponse<StoreEntryResult>>;
+  appendEntry(payload: StoreEntryPayload): Promise<IAppResponse<StoreEntryResult>>;
+  toggle(storeName?: string): Promise<IAppResponse<StoreToggleResult>>;
+  delete(storeName: string): Promise<IAppResponse<unknown>>;
+}
+//#endregion
 //#region src/resources/warps.d.ts
 type WarpResponseData = {
   id: string;
@@ -944,12 +1023,20 @@ declare class WarpsResource {
   destroy(identifier: string): Promise<IAppResponse<unknown>>;
 }
 //#endregion
+//#region src/cache/types.d.ts
+interface CacheConfig {
+  enabled?: boolean;
+  defaultTtl?: number;
+  overrides?: Record<string, number>;
+}
+//#endregion
 //#region src/client.d.ts
 interface JoAiClientConfig {
   apiToken?: string;
   team?: string;
   env?: AppEnv;
   agentAuthKey?: string;
+  cache?: CacheConfig;
 }
 declare class JoAiClient {
   readonly http: IHttpService;
@@ -972,16 +1059,40 @@ declare class JoAiClient {
   readonly sites: SitesResource;
   readonly documents: DocumentsResource;
   readonly meetings: MeetingsResource;
+  readonly stores: StoresResource;
   readonly privateWarps: WarpsResource;
   constructor(config: JoAiClientConfig);
+  clearCache(): void;
   warps(locale?: WarpLocale): WarpClient;
 }
 declare function createClient(config: JoAiClientConfig): JoAiClient;
 //#endregion
+//#region src/cache/cached-http.d.ts
+type TtlMap = Record<string, number>;
+declare class CachedHttpService implements IHttpService {
+  private inner;
+  readonly baseUrl: string;
+  readonly authToken: string | null;
+  private cache;
+  private ttlMap;
+  private defaultTtl;
+  onNetworkError: (error: Error) => void;
+  onUnauthorized: (response: IAppResponse<any>) => void;
+  onSuccessfulResponse: (response: IAppResponse<any>) => void;
+  onMaintenanceMode: (response: IAppResponse<any>) => void;
+  onTooManyRequests: (response: IAppResponse<any>) => void;
+  constructor(inner: IHttpService, overrides?: TtlMap, defaultTtl?: number);
+  clearCache(): void;
+  get<T>(url: string, options?: IRequestOptions): Promise<IAppResponse<T>>;
+  post<T>(url: string, data?: any, options?: IRequestOptions): Promise<IAppResponse<T>>;
+  put<T>(url: string, data?: any, options?: IRequestOptions): Promise<IAppResponse<T>>;
+  delete<T>(url: string, options?: IRequestOptions): Promise<IAppResponse<T>>;
+}
+//#endregion
 //#region src/resources/distribution.d.ts
 declare class DistributionResource {
   getBrandSiteConfig(env: AppEnv, brandSlug: string): Promise<BrandSiteConfig | null>;
   private fetchDistribution;
 }
 //#endregion
-export { BlueprintsResource, DistributionResource, FlowsResource, IngestionsResource, JoAiClient, type JoAiClientConfig, MarketplaceResource, MeetingsResource, ServicesResource, SitesResource, SkillsResource, createClient };
+export { BlueprintsResource, type CacheConfig, CachedHttpService, DistributionResource, FlowsResource, IngestionsResource, JoAiClient, type JoAiClientConfig, MarketplaceResource, MeetingsResource, ServicesResource, SitesResource, SkillsResource, StoresResource, createClient };

package/dist/index.mjs

@@ -288,8 +288,22 @@ var DocumentsResource = class {
 	constructor(http) {
 		this.http = http;
 	}
-	ingest(payload) {
-		return this.http.post("documents", payload);
+	list(agent, search) {
+		const params = new URLSearchParams();
+		if (search) params.set("search", search);
+		return this.http.get(`agents/${agent}/documents?${params.toString()}`);
+	}
+	create(agent, data) {
+		return this.http.post(`agents/${agent}/documents`, data);
+	}
+	get(id) {
+		return this.http.get(`documents/${id}`);
+	}
+	update(id, data) {
+		return this.http.put(`documents/${id}`, data);
+	}
+	delete(id) {
+		return this.http.delete(`documents/${id}`);
 	}
 };
 //#endregion
@@ -420,7 +434,8 @@ var SitesResource = class {
 		return this.http.get(`sites/mine?team=${encodeURIComponent(teamSlug)}`);
 	}
 	resolve(teamSlug, brandSlug) {
-		return this.http.get(`sites/resolve?team=${encodeURIComponent(teamSlug)}&brand=${encodeURIComponent(brandSlug)}`);
+		const query = brandSlug ? `team=${encodeURIComponent(teamSlug)}&brand=${encodeURIComponent(brandSlug)}` : `team=${encodeURIComponent(teamSlug)}`;
+		return this.http.get(`sites/resolve?${query}`);
 	}
 	resolveByDomain(domain) {
 		return this.http.get(`sites/resolve?domain=${encodeURIComponent(domain)}`);
@@ -443,6 +458,40 @@ var TeamsResource = class {
 	}
 };
 //#endregion
+//#region src/resources/stores.ts
+var StoresResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	list() {
+		return this.http.get("stores");
+	}
+	create(payload) {
+		return this.http.post("stores", payload);
+	}
+	entries(params) {
+		const query = new URLSearchParams();
+		if (params?.storeName) query.set("storeName", params.storeName);
+		if (params?.since) query.set("since", params.since);
+		if (params?.until) query.set("until", params.until);
+		if (params?.last != null) query.set("last", String(params.last));
+		const qs = query.toString();
+		return this.http.get(`stores/entries${qs ? "?" + qs : ""}`);
+	}
+	setEntry(payload) {
+		return this.http.post("stores/entries", payload);
+	}
+	appendEntry(payload) {
+		return this.http.post("stores/entries/append", payload);
+	}
+	toggle(storeName) {
+		return this.http.post("stores/toggle", { storeName });
+	}
+	delete(storeName) {
+		return this.http.delete(`stores/${storeName}`);
+	}
+};
+//#endregion
 //#region src/resources/warps.ts
 var WarpsResource = class {
 	constructor(http) {
@@ -463,6 +512,107 @@ var WarpsResource = class {
 	}
 };
 //#endregion
+//#region src/cache/memory-cache.ts
+var MemoryCache = class {
+	constructor() {
+		this.store = /* @__PURE__ */ new Map();
+	}
+	get(key) {
+		const entry = this.store.get(key);
+		if (!entry) return void 0;
+		if (Date.now() > entry.expiresAt) {
+			this.store.delete(key);
+			return;
+		}
+		return entry.data;
+	}
+	set(key, data, ttl) {
+		this.store.set(key, {
+			data,
+			expiresAt: Date.now() + ttl
+		});
+	}
+	clear() {
+		this.store.clear();
+	}
+	bust(prefix) {
+		for (const key of this.store.keys()) if (key.startsWith(prefix)) this.store.delete(key);
+	}
+};
+//#endregion
+//#region src/cache/cached-http.ts
+const DEFAULT_TTL = 15e3;
+const DEFAULTS = {
+	blueprints: 3e5,
+	flows: 3e5,
+	marketplace: 3e5,
+	skills: 3e5,
+	sites: 3e5,
+	stores: 3e4,
+	contacts: 3e4,
+	items: 3e4,
+	goals: 3e4,
+	memories: 3e4,
+	reminders: 3e4,
+	services: 3e4,
+	documents: 3e4,
+	ingestions: 3e4,
+	agents: 1e4,
+	rooms: 1e4
+};
+function getTtl(url, ttlMap, defaultTtl) {
+	for (const [prefix, ttl] of Object.entries(ttlMap)) if (url.startsWith(prefix) || url.startsWith(`/${prefix}`)) return ttl;
+	return defaultTtl;
+}
+function getUrlPrefix(url) {
+	const clean = url.startsWith("/") ? url.slice(1) : url;
+	const slash = clean.indexOf("/");
+	return slash > 0 ? clean.slice(0, slash) : clean;
+}
+var CachedHttpService = class {
+	constructor(inner, overrides, defaultTtl) {
+		this.inner = inner;
+		this.cache = new MemoryCache();
+		this.onNetworkError = () => {};
+		this.onUnauthorized = () => {};
+		this.onSuccessfulResponse = () => {};
+		this.onMaintenanceMode = () => {};
+		this.onTooManyRequests = () => {};
+		this.baseUrl = inner.baseUrl;
+		this.authToken = inner.authToken;
+		this.ttlMap = {
+			...DEFAULTS,
+			...overrides
+		};
+		this.defaultTtl = defaultTtl ?? DEFAULT_TTL;
+	}
+	clearCache() {
+		this.cache.clear();
+	}
+	async get(url, options) {
+		const cached = this.cache.get(url);
+		if (cached !== void 0) return cached;
+		const response = await this.inner.get(url, options);
+		if (response.ok) this.cache.set(url, response, getTtl(url, this.ttlMap, this.defaultTtl));
+		return response;
+	}
+	async post(url, data, options) {
+		const response = await this.inner.post(url, data, options);
+		this.cache.bust(getUrlPrefix(url));
+		return response;
+	}
+	async put(url, data, options) {
+		const response = await this.inner.put(url, data, options);
+		this.cache.bust(getUrlPrefix(url));
+		return response;
+	}
+	async delete(url, options) {
+		const response = await this.inner.delete(url, options);
+		this.cache.bust(getUrlPrefix(url));
+		return response;
+	}
+};
+//#endregion
 //#region src/client.ts
 function toWarpEnv(env) {
 	if (env === "devnet") return "devnet";
@@ -475,7 +625,9 @@ var JoAiClient = class {
 		const headers = {};
 		if (config.team) headers["X-Team"] = config.team;
 		if (config.agentAuthKey) headers["X-Agent-Auth-Key"] = config.agentAuthKey;
-		this.http = new HttpService(`${getApiBaseUrl(config.env ?? "mainnet")}/v1`, void 0, config.apiToken, { headers });
+		const http = new HttpService(`${getApiBaseUrl(config.env ?? "mainnet")}/v1`, void 0, config.apiToken, { headers });
+		const cache = config.cache;
+		this.http = cache?.enabled !== false ? new CachedHttpService(http, cache?.overrides, cache?.defaultTtl) : http;
 		this.hub = new HubResource(this.http);
 		this.teams = new TeamsResource(this.http);
 		this.agents = new AgentsResource(this.http);
@@ -494,8 +646,12 @@ var JoAiClient = class {
 		this.sites = new SitesResource(this.http);
 		this.documents = new DocumentsResource(this.http);
 		this.meetings = new MeetingsResource(this.http);
+		this.stores = new StoresResource(this.http);
 		this.privateWarps = new WarpsResource(this.http);
 	}
+	clearCache() {
+		if (this.http instanceof CachedHttpService) this.http.clearCache();
+	}
 	warps(locale = "en") {
 		return new WarpClient({
 			env: toWarpEnv(this.env),
@@ -535,4 +691,4 @@ var DistributionResource = class {
 	}
 };
 //#endregion
-export { BlueprintsResource, DistributionResource, FlowsResource, IngestionsResource, JoAiClient, MarketplaceResource, MeetingsResource, ServicesResource, SitesResource, SkillsResource, createClient };
+export { BlueprintsResource, CachedHttpService, DistributionResource, FlowsResource, IngestionsResource, JoAiClient, MarketplaceResource, MeetingsResource, ServicesResource, SitesResource, SkillsResource, StoresResource, createClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",