@joai/core 4.5.0 → 4.7.0

package/dist/index.mjs

@@ -42,6 +42,7 @@ const getAgentsBaseUrl = (env) => {
 	if (env === "testnet") return "https://testnet-agents.joai.ai";
 	return "https://agents.joai.ai";
 };
+const getMcpServerUrl = (env) => `${getCortexBaseUrl(env)}/mcp`;
 const getMcpServerAgentUrl = (env, agent) => `${getCortexBaseUrl(env)}/mcp/agents/${agent}`;
 const getSitesBaseUrl = (env) => {
 	if (env === "local") return "http://sites.joai--api.test:3007";
@@ -370,10 +371,29 @@ const ContractCategoryDisplayNames = {
 };
 //#endregion
 //#region src/mcp/agent-setup.ts
+const UNIFIED_MCP_SERVER_NAME = "joai";
+const AGENT_UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const isUnifiedMcpUrl = (mcpUrl) => {
+	try {
+		return (new URL(mcpUrl).pathname.replace(/\/+$/, "") || "/") === "/mcp";
+	} catch {
+		return false;
+	}
+};
 const getAgentSetupPromptUrl = (env) => `${getAppBaseUrl(env)}/prompts/setup-agent.md`;
 const buildAgentSetupClipboardText = (env, target) => {
+	const promptUrl = getAgentSetupPromptUrl(env);
+	if (isUnifiedMcpUrl(target.mcpUrl)) return [
+		`Fetch and execute the appropriate instructions to set me up for JoAi from ${promptUrl}`,
+		"",
+		"Connect me to JoAi MCP:",
+		`- MCP: ${target.mcpUrl}`,
+		`- Agent: ${target.agentName}`,
+		"",
+		"Authenticate with OAuth. The agent in the MCP URL is preselected and can be changed."
+	].join("\n");
 	return [
-		`Fetch and execute the appropriate instructions to set me up for JoAi from ${getAgentSetupPromptUrl(env)}`,
+		`Fetch and execute the appropriate instructions to set me up for JoAi from ${promptUrl}`,
 		"",
 		"Connect me to this JoAi agent:",
 		`- Agent: ${target.agentName}`,
@@ -396,6 +416,16 @@ const createCursorMcpInstallLink = (mcpServerUrl, serverName) => {
 	const encodedConfig = encodeURIComponent(btoa(configJson));
 	return `https://cursor.com/en-US/install-mcp?name=${encodeURIComponent(serverName)}&config=${encodedConfig}`;
 };
+/** Default owner/connect MCP URL. Optional agent UUID soft-prefills OAuth via `?agent=`. */
+const resolveConnectMcpUrl = (env, mcpEndpoint, preferredAgentUuid) => {
+	const trimmed = mcpEndpoint?.trim();
+	const base = trimmed && isUnifiedMcpUrl(trimmed) ? `${new URL(trimmed).origin}${new URL(trimmed).pathname.replace(/\/+$/, "") || "/mcp"}` : `${getCortexBaseUrl(env)}/mcp`;
+	const fromUrl = trimmed && isUnifiedMcpUrl(trimmed) ? new URL(trimmed).searchParams.get("agent") || new URL(trimmed).searchParams.get("agent_uuid") : null;
+	const preferred = preferredAgentUuid?.trim() || fromUrl;
+	if (preferred && AGENT_UUID_RE.test(preferred)) return `${base}?agent=${encodeURIComponent(preferred)}`;
+	return base;
+};
+/** Agent-scoped MCP URL for public/direct addressing (Agent0, x402, marketplace). */
 const resolveAgentMcpUrl = (env, agentUuid, mcpEndpoint) => mcpEndpoint?.trim() || `${getCortexBaseUrl(env)}/mcp/agents/${agentUuid}`;
 const slugifyMcpSegment = (value) => value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "agent";
 const buildMcpServerName = (slug, teamName) => {
@@ -500,6 +530,8 @@ const UserPermissions = {
 	BillingManage: "billing-manage",
 	TeamManage: "team-manage",
 	TeamView: "team-view",
+	ContentEdit: "content-edit",
+	ContentPublish: "content-publish",
 	TeamMemberInvite: "team-member-invite",
 	TeamMemberRemove: "team-member-remove",
 	TeamSecretView: "team-secret-view",
@@ -585,4 +617,4 @@ const DefaultInviteTeamRole = UserRoles.Member;
 const inviteableTeamRoles = () => [...InviteableTeamRoles];
 const defaultInviteTeamRole = () => DefaultInviteTeamRole;
 //#endregion
-export { AddressTypes, AgentToolingAccess, BillingManageAccess, ContractCategoryDisplayNames, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, OgImageColors, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, TeamManageAccess, TeamViewAccess, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildMcpServerName, cartLineTotal, createCursorMcpInstallLink, defaultInviteTeamRole, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, inviteableTeamRoles, isCompleteAddressInput, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUserRole, localize, nativeAppSlugs, ogImageUrl, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };
+export { AddressTypes, AgentToolingAccess, BillingManageAccess, ContractCategoryDisplayNames, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, OgImageColors, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildMcpServerName, cartLineTotal, createCursorMcpInstallLink, defaultInviteTeamRole, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, inviteableTeamRoles, isCompleteAddressInput, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, ogImageUrl, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };

package/dist/react/index.d.mts

@@ -1,4 +1,4 @@
-import { n as IHttpService } from "../types-CWSaEVa7.mjs";
+'use client';
 import * as _$react from "react";
 import { ReactNode } from "react";
 
@@ -72,6 +72,37 @@ declare function EmbedChatInput({
   renderSendButton
 }: EmbedChatInputProps): _$react.JSX.Element;
 //#endregion
+//#region src/http/types.d.ts
+interface IHttpService {
+  readonly baseUrl: string;
+  readonly authToken: string | null;
+  onNetworkError: (error: Error) => void;
+  onUnauthorized: (response: IAppResponse<any>) => void;
+  onSuccessfulResponse: (response: IAppResponse<any>) => void;
+  onMaintenanceMode: (response: IAppResponse<any>) => 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>>;
+  patch: <T>(url: string, data?: any, options?: IRequestOptions) => Promise<IAppResponse<T>>;
+  delete: <T>(url: string, options?: IRequestOptions) => Promise<IAppResponse<T>>;
+}
+interface IAppResponse<T> {
+  data: T;
+  meta?: any;
+  body: any;
+  errors: any;
+  ok: boolean;
+  paymentRequired: boolean;
+  noContent: boolean;
+  original: Response;
+}
+interface IRequestOptions {
+  isJson?: boolean;
+  headers?: {
+    [name: string]: string;
+  };
+}
+//#endregion
 //#region src/react/use-embed-chat.d.ts
 type Options = {
   agentUuid: string | null;
@@ -101,4 +132,229 @@ declare function useEmbedChat({
   connectionError: boolean;
 };
 //#endregion
-export { EmbedChatInput, EmbedChatItem, EmbedChatList, StreamDataHandler, clearRoom, getOrCreateGuestId, loadRoom, openEventSourceStream, saveRoom, useEmbedChat };
+//#region src/content/types.d.ts
+type ContentStatus = 'draft' | 'published' | 'archived';
+type ContentFieldType = 'text' | 'richText' | 'number' | 'boolean' | 'url' | 'image' | 'media' | 'list' | 'object' | 'reference';
+type ContentField = {
+  key: string;
+  type: ContentFieldType;
+  label?: string;
+  required?: boolean;
+};
+type ContentDefinition = {
+  fields: ContentField[];
+};
+type ContentValue = string | number | boolean | null | ContentValue[] | {
+  [key: string]: ContentValue;
+};
+type ContentEntry = {
+  key: string;
+  value: ContentValue;
+  updatedAt: string;
+};
+type ContentVersion = {
+  id: string;
+  number: number;
+  status: ContentStatus;
+  entries: ContentEntry[];
+  snapshotHash: string;
+  origin: string;
+  createdAt: string;
+  updatedAt: string;
+  publishedAt: string | null;
+};
+type Content = {
+  id: string;
+  name: string;
+  slug: string;
+  schema: string | null;
+  definition: ContentDefinition;
+  metadata: Record<string, ContentValue>;
+  version: ContentVersion | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type ContentPatch = {
+  key: string;
+  value: ContentValue;
+};
+type PatchContentInput = {
+  expectedVersion: number;
+  patches: ContentPatch[];
+  origin?: 'api' | 'inlineEditor' | 'joai' | 'mcp';
+};
+//#endregion
+//#region src/json/types.d.ts
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+//#endregion
+//#region src/media/types.d.ts
+type MediaLibraryAttributes = {
+  uuid: string;
+  order: number;
+  name: string;
+  custom_properties: {
+    [key: string]: JsonValue;
+  };
+  preview_url: null | string;
+  original_url: null | string;
+  extension?: string;
+  size?: number;
+};
+type MediaMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'video/mp4' | 'video/webm' | 'video/quicktime' | 'video/x-msvideo' | 'audio/mpeg' | 'audio/mp3' | 'audio/ogg' | 'audio/wav' | 'audio/webm' | 'audio/aac' | 'audio/m4a' | 'audio/m4b' | 'audio/m4p' | 'audio/m4v' | 'application/pdf' | 'application/json';
+type Media = {
+  id: string;
+  name: string;
+  mime: MediaMime;
+  url: string;
+  library: MediaLibraryAttributes;
+  tags?: string[];
+  copyright?: string | null;
+  aiGenerated?: boolean;
+};
+//#endregion
+//#region src/react/content/types.d.ts
+type ContentResource = {
+  get: (contentId: string) => Promise<{
+    ok: boolean;
+    data?: Content;
+  }>;
+  getPublic: (slug: string) => Promise<{
+    ok: boolean;
+    data?: Content;
+  }>;
+  patch: (contentId: string, input: PatchContentInput) => Promise<{
+    ok: boolean;
+    data?: ContentVersion;
+  }>;
+  publish: (contentId: string, expectedVersion: number) => Promise<{
+    ok: boolean;
+    data?: ContentVersion;
+  }>;
+};
+type ContentClient = {
+  content: ContentResource;
+  media?: {
+    list: (team: string, params?: {
+      page?: number;
+      mime?: string;
+    }) => Promise<{
+      ok: boolean;
+      data?: Media[];
+    }>;
+    upload: (data: {
+      team: string;
+      file: File;
+      type: 'output';
+      label?: string;
+    }) => Promise<{
+      ok: boolean;
+      data?: Media;
+    }>;
+  };
+};
+type ContentContextValue = {
+  content: Content | null;
+  values: Record<string, ContentValue>;
+  isLoading: boolean;
+  isSaving: boolean;
+  isEditing: boolean;
+  isDirty: boolean;
+  canEdit: boolean;
+  canPublish: boolean;
+  teamSlug?: string;
+  media?: ContentClient['media'];
+  error: string | null;
+  setEditing: (editing: boolean) => void;
+  setValue: (key: string, value: ContentValue) => void;
+  save: () => Promise<boolean>;
+  publish: () => Promise<boolean>;
+};
+type ContentProviderProp = {
+  children: ReactNode;
+  client: ContentClient;
+  contentId?: string;
+  publicSlug?: string;
+  initialContent?: Content;
+  canEdit?: boolean;
+  canPublish?: boolean;
+  teamSlug?: string;
+};
+type EditableContentProp = {
+  field: string;
+  as?: 'span' | 'p' | 'div' | 'h1' | 'h2' | 'h3';
+  className?: string;
+  placeholder?: string;
+  multiline?: boolean;
+};
+type EditableImageProp = {
+  field: string;
+  alt?: string;
+  className?: string;
+  onSelect?: () => void;
+  inputClassName?: string;
+  placeholder?: string;
+};
+type ContentToolbarProp = {
+  className?: string;
+  confirmPublish?: () => boolean | Promise<boolean>;
+  labels?: {
+    edit?: string;
+    save?: string;
+    publish?: string;
+    cancel?: string;
+  };
+};
+//#endregion
+//#region src/react/content/provider.d.ts
+declare function ContentProvider({
+  children,
+  client,
+  contentId,
+  publicSlug,
+  initialContent,
+  canEdit,
+  canPublish,
+  teamSlug
+}: ContentProviderProp): _$react.JSX.Element;
+//#endregion
+//#region src/react/content/editable-content.d.ts
+declare function EditableContent({
+  field,
+  as: Tag,
+  className,
+  placeholder,
+  multiline
+}: EditableContentProp): _$react.JSX.Element;
+declare function useContentValue<T extends ContentValue = ContentValue>(key: string): T | undefined;
+//#endregion
+//#region src/react/content/editable-image.d.ts
+declare function EditableImage({
+  field,
+  alt,
+  className,
+  inputClassName,
+  placeholder,
+  onSelect
+}: EditableImageProp): _$react.JSX.Element | null;
+//#endregion
+//#region src/react/content/toolbar.d.ts
+declare function ContentToolbar({
+  className,
+  labels,
+  confirmPublish
+}: ContentToolbarProp): _$react.JSX.Element | null;
+//#endregion
+//#region src/react/content/content-editor.d.ts
+type Prop = ContentProviderProp & {
+  children: ReactNode;
+  title?: string;
+};
+declare function ContentEditor({
+  children,
+  title,
+  ...provider
+}: Prop): _$react.JSX.Element;
+//#endregion
+export { ContentClient, ContentContextValue, ContentEditor, ContentProvider, ContentProviderProp, ContentResource, ContentToolbar, ContentToolbarProp, EditableContent, EditableContentProp, EditableImage, EditableImageProp, EmbedChatInput, EmbedChatItem, EmbedChatList, StreamDataHandler, clearRoom, getOrCreateGuestId, loadRoom, openEventSourceStream, saveRoom, useContentValue, useEmbedChat };