@husar.ai/cli 0.4.0 → 0.4.2

package/MCP_SERVER.md

@@ -49,6 +49,8 @@ Notes:
 
 ## Available Tools
 
+### Core CLI Tools
+
 - `husar_copy`:
   - Purpose: Parse a CMS file into a shape or model and upsert via CLI.
   - Inputs:
@@ -69,6 +71,96 @@ Notes:
     - `cms/zeus/index.ts`, `cms/zeus/const.ts`
     - `cms/host.ts`, `cms/ssr.ts`, `cms/react.ts`
 
+### Discovery & Schema Tools
+
+These tools help AI agents understand the CMS structure before making updates:
+
+- `listModels`: List all model definitions with their field structures.
+- `listViews`: List all view definitions with their field structures.
+- `listShapes`: List all available shape definitions.
+- `graphQLTypes`: Get the generated GraphQL SDL schema showing all input/output types. Essential for understanding the exact structure expected by `model.upsert` and `view.upsert`.
+
+### Combined "GetWithContent" Tools
+
+**Recommended workflow:** Always call the appropriate `getWithContent` tool BEFORE calling `upsert` to understand the exact data structure expected.
+
+- `model.getWithContent`:
+  - Purpose: Get complete model information including definition, fieldSet (expanded shapes), GraphQL types, and optionally current content.
+  - Inputs:
+    - `name` (required): Model name
+    - `slug` (optional): Document slug to fetch existing content
+    - `filter` (optional): Root params filter (e.g., `{ "_language": "en" }`)
+  - Returns: `{ definition, fieldSet, graphQLTypes, content }`
+
+- `view.getWithContent`:
+  - Purpose: Get complete view information including definition, fieldSet (expanded shapes), GraphQL types, and current content.
+  - Inputs:
+    - `name` (required): View name
+    - `filter` (optional): Root params filter (e.g., `{ "_language": "en" }`)
+  - Returns: `{ definition, fieldSet, graphQLTypes, content }`
+
+- `shape.getWithDefinition`:
+  - Purpose: Get complete shape information including definition, fieldSet (expanded nested shapes), and GraphQL types.
+  - Inputs:
+    - `name` (required): Shape name
+  - Returns: `{ definition, fieldSet, graphQLTypes }`
+
+### Model CRUD Tools
+
+- `model.model`: Return full model configuration
+- `model.previewFields`: Return expanded fields for model
+- `model.fieldSet`: Return admin page fieldset
+- `model.upsert`: Create or update a model content document
+  - **Important:** First call `model.getWithContent` to see the expected structure
+  - Inputs: `name`, `slug`, `args` (document content), `draft_version`, `filter`
+- `model.remove`: Remove a model entry
+- `model.list`: List model entries
+- `model.listPaginated`: List model entries with pagination
+- `model.one`: Get one model entry by slug
+- `model.listById`: Get entries by IDs
+
+### View CRUD Tools
+
+- `view.model`: Return full view configuration
+- `view.previewFields`: Return expanded fields for view
+- `view.fieldSet`: Return admin page fieldset for view
+- `view.upsert`: Create or update a view entry (singleton)
+  - **Important:** First call `view.getWithContent` to see the expected structure
+  - Inputs: `name`, `args` (view content), `draft_version`, `filter`, `formArgs`
+- `view.remove`: Remove a view entry
+- `view.list`: List view entries
+- `view.one`: Get one view entry
+
+### Shape Tools
+
+- `shape.model`: Return full shape configuration
+- `shape.previewFields`: Return expanded fields for shape
+- `shape.fieldSet`: Return admin page fieldset for shape
+
+### Form Tools
+
+- `form.model`, `form.previewFields`, `form.fieldSet`: Form configuration tools
+- `form.upsert`, `form.remove`, `form.list`, `form.one`: Form CRUD operations
+- `form.submitResponse`, `form.responses`, `form.response`, `form.removeResponse`, `form.responseFieldSet`: Form response handling
+
+### Definition Management Tools
+
+These tools manage CMS definitions (schemas), not content:
+
+- `upsertModel`, `removeModel`: Manage model definitions
+- `upsertView`, `removeView`: Manage view definitions
+- `upsertShape`, `removeShape`: Manage shape definitions
+- `upsertForm`, `removeForm`: Manage form definitions
+- `removeModelWithDocuments`: Remove a model and all its documents
+- `removeDocumentsWithParams`: Remove documents matching root params
+
+### AI Generation Tools
+
+- `generateContent`: Generate content using AI
+- `generateImage`: Generate an image
+- `translateDocument`, `translateView`, `translateForm`: Translation tools
+- `husarViewAgent`: Specialized agent for view creation/modification from natural language
+
 ## Troubleshooting
 
 - CLI not found: Ensure `@husar.ai/cli` is installed globally or that `husar.ai` is on PATH.

package/dist/auth/api.d.ts

@@ -0,0 +1,15 @@
+export interface CloudProject {
+    name: string;
+    adminURL: string;
+}
+export interface ProjectsResponse {
+    items: CloudProject[];
+    hasNext: boolean;
+    total: number;
+}
+export declare function getProjects(accessToken: string): Promise<CloudProject[]>;
+export declare function getUserInfo(accessToken: string): Promise<{
+    username: string;
+    fullName?: string;
+} | null>;
+export declare function verifyAccessToken(accessToken: string): Promise<boolean>;

package/dist/auth/api.js

@@ -0,0 +1,86 @@
+const CLOUD_API_URL = process.env.HUSAR_CLOUD_API || 'https://backend.husar.ai/api/graphql';
+export async function getProjects(accessToken) {
+    const response = await fetch(CLOUD_API_URL, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: accessToken,
+        },
+        body: JSON.stringify({
+            query: `
+        query GetUserProjects {
+          users {
+            user {
+              cms {
+                projects(page: { start: 0, limit: 100 }) {
+                  items {
+                    name
+                    adminURL
+                  }
+                  page {
+                    hasNext
+                    total
+                  }
+                }
+              }
+            }
+          }
+        }
+      `,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Cloud API request failed: ${response.status} ${response.statusText}`);
+    }
+    const json = await response.json();
+    if (json.errors) {
+        const errorMessage = json.errors[0]?.message || 'Unknown cloud API error';
+        throw new Error(`Cloud API error: ${errorMessage}`);
+    }
+    const projects = json.data?.users?.user?.cms?.projects?.items;
+    if (!projects) {
+        return [];
+    }
+    return projects;
+}
+export async function getUserInfo(accessToken) {
+    const response = await fetch(CLOUD_API_URL, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: accessToken,
+        },
+        body: JSON.stringify({
+            query: `
+        query GetUserInfo {
+          users {
+            user {
+              me {
+                username
+                fullName
+              }
+            }
+          }
+        }
+      `,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Cloud API request failed: ${response.status} ${response.statusText}`);
+    }
+    const json = await response.json();
+    if (json.errors) {
+        return null;
+    }
+    return json.data?.users?.user?.me ?? null;
+}
+export async function verifyAccessToken(accessToken) {
+    try {
+        const userInfo = await getUserInfo(accessToken);
+        return userInfo !== null;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/auth/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/auth/api.ts"],"names":[],"mappings":"AAKA,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,sCAAsC,CAAC;AAqB5F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB;IACnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE;QAC1C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,WAAW;SAC3B;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE;;;;;;;;;;;;;;;;;;;OAmBN;SACF,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,yBAAyB,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,oBAAoB,YAAY,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC;IAE9D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAA0B,CAAC;AACpC,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB;IACnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE;QAC1C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,WAAW;SAC3B;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE;;;;;;;;;;;OAWN;SACF,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,IAAI,CAAC;AAC5C,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACzD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;QAChD,OAAO,QAAQ,KAAK,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/auth/config.d.ts

@@ -0,0 +1,32 @@
+export interface AuthConfig {
+    email?: string;
+    accessToken?: string;
+    refreshToken?: string;
+    lastRefresh?: number;
+}
+export interface CloudAuth {
+    email?: string;
+    accessToken: string;
+    refreshToken?: string;
+}
+export interface ProjectAuth {
+    projectName: string;
+    host: string;
+    adminToken: string;
+}
+export interface FullAuthConfig extends AuthConfig {
+    projects?: Record<string, ProjectAuth>;
+}
+export declare function readAuthConfig(): Promise<FullAuthConfig>;
+export declare function writeAuthConfig(config: FullAuthConfig): Promise<void>;
+export declare function isLoggedIn(): Promise<boolean>;
+export declare function getCurrentUser(): Promise<{
+    email: string;
+} | null>;
+export declare function saveLogin(email: string, accessToken: string, refreshToken?: string): Promise<void>;
+export declare function saveCloudAuth(cloudAuth: CloudAuth): Promise<void>;
+export declare function getCloudAuth(): Promise<CloudAuth | null>;
+export declare function saveProjectAuth(project: ProjectAuth): Promise<void>;
+export declare function getProjectAuth(projectName: string): Promise<ProjectAuth | null>;
+export declare function clearAuth(): Promise<void>;
+export declare function getConfigPath(): string;

package/dist/auth/config.js

@@ -0,0 +1,95 @@
+import { promises as fs } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const CONFIG_DIR = join(homedir(), '.husar');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const DIR_MODE = 0o700;
+const FILE_MODE = 0o600;
+async function ensureConfigDir() {
+    try {
+        await fs.mkdir(CONFIG_DIR, { recursive: true, mode: DIR_MODE });
+    }
+    catch (err) {
+        try {
+            await fs.chmod(CONFIG_DIR, DIR_MODE);
+        }
+        catch {
+        }
+    }
+}
+export async function readAuthConfig() {
+    try {
+        await ensureConfigDir();
+        const content = await fs.readFile(CONFIG_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+export async function writeAuthConfig(config) {
+    await ensureConfigDir();
+    await fs.writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), { encoding: 'utf-8', mode: FILE_MODE });
+    try {
+        await fs.chmod(CONFIG_FILE, FILE_MODE);
+    }
+    catch {
+    }
+}
+export async function isLoggedIn() {
+    const config = await readAuthConfig();
+    return !!(config.accessToken && config.email);
+}
+export async function getCurrentUser() {
+    const config = await readAuthConfig();
+    if (!config.accessToken || !config.email) {
+        return null;
+    }
+    return { email: config.email };
+}
+export async function saveLogin(email, accessToken, refreshToken) {
+    const config = await readAuthConfig();
+    config.email = email;
+    config.accessToken = accessToken;
+    config.refreshToken = refreshToken;
+    config.lastRefresh = Date.now();
+    await writeAuthConfig(config);
+}
+export async function saveCloudAuth(cloudAuth) {
+    const config = await readAuthConfig();
+    config.email = cloudAuth.email;
+    config.accessToken = cloudAuth.accessToken;
+    config.refreshToken = cloudAuth.refreshToken;
+    config.lastRefresh = Date.now();
+    await writeAuthConfig(config);
+}
+export async function getCloudAuth() {
+    const config = await readAuthConfig();
+    if (!config.accessToken) {
+        return null;
+    }
+    return {
+        email: config.email,
+        accessToken: config.accessToken,
+        refreshToken: config.refreshToken,
+    };
+}
+export async function saveProjectAuth(project) {
+    const config = await readAuthConfig();
+    if (!config.projects) {
+        config.projects = {};
+    }
+    config.projects[project.projectName] = project;
+    await writeAuthConfig(config);
+}
+export async function getProjectAuth(projectName) {
+    const config = await readAuthConfig();
+    return config.projects?.[projectName] ?? null;
+}
+export async function clearAuth() {
+    await writeAuthConfig({});
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+//# sourceMappingURL=config.js.map

package/dist/auth/config.js.map

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

package/dist/auth/login.d.ts

@@ -0,0 +1,30 @@
+import { ProjectAuth } from './config.js';
+export interface CloudLoginResult {
+    success: boolean;
+    email?: string;
+    accessToken?: string;
+    error?: string;
+}
+export interface PanelLoginResult {
+    success: boolean;
+    project?: ProjectAuth;
+    error?: string;
+}
+export interface LoginResult {
+    success: boolean;
+    email?: string;
+    project?: ProjectAuth;
+    error?: string;
+}
+export declare function startCloudLoginFlow(options?: {
+    port?: number;
+    timeout?: number;
+}): Promise<CloudLoginResult>;
+export declare function startPanelLoginFlow(panelHost: string, options?: {
+    port?: number;
+    timeout?: number;
+}): Promise<PanelLoginResult>;
+export declare function startLoginFlow(options?: {
+    port?: number;
+    timeout?: number;
+}): Promise<LoginResult>;