gentiq 0.9.0 → 0.10.0

package/dist/src/admin/lib/api.d.ts

@@ -23,11 +23,14 @@ export interface RechargePolicy extends RechargePolicyInput {
     next_recharge_at?: string | null;
     last_recharged_at?: string | null;
 }
+/** Admin list/analytics traffic filter: real humans, external API service accounts, or both. */
+export type AdminSourceFilter = 'human' | 'service' | 'all';
 export interface User {
     id: string;
-    phone: string;
+    phone?: string | null;
     name: string;
-    surname: string;
+    /** Service (API) accounts have no surname; only a single service name in `name`. */
+    surname?: string | null;
     token?: string;
     metadata?: Record<string, any>;
     balance?: {
@@ -37,6 +40,8 @@ export interface User {
         request_limit: number;
     };
     recharge_policy?: RechargePolicy | null;
+    /** 'service' marks an external API consumer; defaults to 'human'. */
+    type?: 'human' | 'service';
 }
 export interface UserUsageSummary {
     input_tokens: number;
@@ -80,14 +85,19 @@ export interface Thread {
     title?: string;
     created_at: string;
     updated_at: string;
+    metadata?: {
+        /** Caller-supplied end-user reference for API traffic. */
+        external_user_id?: string;
+        [key: string]: any;
+    };
     feedback_info?: {
         like: number;
         dislike: number;
     };
     user_info?: {
         name?: string;
-        surname?: string;
-        phone?: string;
+        surname?: string | null;
+        phone?: string | null;
         metadata?: Record<string, any>;
     };
 }
@@ -112,6 +122,50 @@ export interface Job {
     result: unknown;
     error: string | null;
 }
+/** Danger level a registered maintenance job declares. */
+export type JobDanger = 'safe' | 'caution' | 'destructive';
+/** One admin-supplied input declared by a registered job. */
+export interface JobParamSpec {
+    name: string;
+    type: 'str' | 'int' | 'float' | 'bool' | 'text';
+    required: boolean;
+    default: unknown;
+    label?: string | null;
+    help?: string | null;
+    choices?: string[] | null;
+}
+/** A maintenance job the backend has registered as runnable from the admin panel. */
+export interface JobDefinition {
+    id: string;
+    name: string;
+    description?: string | null;
+    danger: JobDanger;
+    params: JobParamSpec[];
+    supports_dry_run: boolean;
+    timeout_seconds?: number | null;
+}
+export type JobRunStatus = 'queued' | 'processing' | 'completed' | 'failed' | 'cancelled';
+/** A single execution of a maintenance job (registered or raw Python). */
+export interface JobRun {
+    id: string;
+    job_id: string | null;
+    name: string;
+    kind: 'registered' | 'raw';
+    danger: JobDanger;
+    status: JobRunStatus;
+    params: Record<string, unknown>;
+    dry_run: boolean;
+    code?: string | null;
+    output?: string;
+    output_truncated?: boolean;
+    result?: Record<string, unknown> | null;
+    error?: string | null;
+    triggered_by_id?: string | null;
+    triggered_by_username?: string | null;
+    created_at: string;
+    updated_at: string;
+    finished_at?: string | null;
+}
 /** Generic `{ status, message }` acknowledgement returned by mutating endpoints. */
 export interface AdminStatusResponse {
     status: string;
@@ -122,12 +176,13 @@ export interface UserCreateResponse {
     status: string;
     user: {
         id: string;
-        phone: string;
+        phone?: string | null;
         name: string;
-        surname: string;
+        surname?: string | null;
         token: string;
         created_at: string;
         recharge_policy?: RechargePolicy | null;
+        type?: 'human' | 'service';
     };
 }
 /** A user's balance as returned after a balance mutation. */
@@ -228,7 +283,7 @@ export declare class AdminAPI {
     listPermissions(): Promise<{
         permissions: string[];
     }>;
-    listThreads(skip?: number, limit?: number, query?: string, feedback?: string): Promise<{
+    listThreads(skip?: number, limit?: number, query?: string, feedback?: string, source?: AdminSourceFilter): Promise<{
         threads: Thread[];
         count: number;
     }>;
@@ -242,11 +297,11 @@ export declare class AdminAPI {
         share_id: string;
         url: string;
     }>;
-    listUsers(skip?: number, limit?: number, query?: string, sortBy?: 'phone' | 'name' | 'surname', sortOrder?: 'asc' | 'desc'): Promise<{
+    listUsers(skip?: number, limit?: number, query?: string, sortBy?: 'phone' | 'name' | 'surname', sortOrder?: 'asc' | 'desc', source?: AdminSourceFilter): Promise<{
         users: User[];
         count: number;
     }>;
-    createUser(phone: string, name: string, surname: string, tokens?: number, requests?: number, token_limit?: number, request_limit?: number, metadata?: Record<string, any>, recharge_policy?: RechargePolicyInput): Promise<UserCreateResponse>;
+    createUser(phone: string | null, name: string, surname: string | null, tokens?: number, requests?: number, token_limit?: number, request_limit?: number, metadata?: Record<string, any>, recharge_policy?: RechargePolicyInput, type?: 'human' | 'service'): Promise<UserCreateResponse>;
     updateUser(userId: string, data: {
         phone?: string;
         name?: string;
@@ -271,12 +326,34 @@ export declare class AdminAPI {
     }>;
     refreshUserToken(userId: string): Promise<UserTokenRefreshResponse>;
     getUserUsageSummary(userId: string): Promise<UserUsageSummary>;
-    getAnalytics(days?: number): Promise<AdminAnalytics>;
+    getAnalytics(days?: number, source?: AdminSourceFilter): Promise<AdminAnalytics>;
     listJobs(limit?: number, type?: string): Promise<{
         jobs: Job[];
         count: number;
     }>;
     cancelJob(jobId: string): Promise<AdminStatusResponse>;
+    listRegisteredJobs(): Promise<{
+        jobs: JobDefinition[];
+    }>;
+    runRegisteredJob(jobId: string, body: {
+        params?: Record<string, unknown>;
+        dry_run?: boolean;
+        confirm?: string;
+    }): Promise<JobRun>;
+    runRawJob(body: {
+        code: string;
+        confirm_phrase: string;
+    }): Promise<JobRun>;
+    listJobRuns(params?: {
+        limit?: number;
+        kind?: string;
+        status?: string;
+    }): Promise<{
+        runs: JobRun[];
+        count: number;
+    }>;
+    getJobRun(runId: string): Promise<JobRun>;
+    cancelJobRun(runId: string): Promise<AdminStatusResponse>;
     getSettings(): Promise<AppSettings>;
     updateSettings(data: AppSettingsUpdateInput): Promise<AppSettings>;
     resetSettings(): Promise<AdminStatusResponse>;

package/dist/src/admin/pages/settings/JobsSection.d.ts

@@ -0,0 +1 @@
+export declare function JobsSection(): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/hooks/useGentiqAdmin.d.ts

@@ -1,14 +1,16 @@
-export declare function useAdminUsers(skip?: number, limit?: number, query?: string, sortBy?: 'phone' | 'name' | 'surname', sortOrder?: 'asc' | 'desc'): import('@tanstack/react-query').UseQueryResult<{
+import { AdminSourceFilter } from '../admin/lib/api';
+export declare function useAdminUsers(skip?: number, limit?: number, query?: string, sortBy?: 'phone' | 'name' | 'surname', sortOrder?: 'asc' | 'desc', source?: AdminSourceFilter): import('@tanstack/react-query').UseQueryResult<{
     users: import('../admin/lib/api').User[];
     count: number;
 }, Error>;
 export declare function useAdminUsersMutations(): {
     createUser: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').UserCreateResponse, Error, {
-        phone: string;
+        phone: string | null;
         name: string;
-        surname: string;
+        surname: string | null;
         tokens?: number;
         requests?: number;
+        type?: "human" | "service";
     }, unknown>;
     updateUser: import('@tanstack/react-query').UseMutationResult<{
         status: string;
@@ -29,7 +31,7 @@ export declare function useAdminUsersMutations(): {
     }, unknown>;
     refreshToken: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').UserTokenRefreshResponse, Error, string, unknown>;
 };
-export declare function useAdminAnalytics(days?: number): import('@tanstack/react-query').UseQueryResult<import('../admin/lib/api').AdminAnalytics, Error>;
+export declare function useAdminAnalytics(days?: number, source?: AdminSourceFilter): import('@tanstack/react-query').UseQueryResult<import('../admin/lib/api').AdminAnalytics, Error>;
 export declare function useAdminAdmins(): import('@tanstack/react-query').UseQueryResult<{
     admins: import('../admin/lib/api').Admin[];
 }, Error>;
@@ -50,7 +52,7 @@ export declare function useAdminAdminsMutations(): {
     }, unknown>;
     deleteAdmin: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').AdminStatusResponse, Error, string, unknown>;
 };
-export declare function useAdminThreads(skip?: number, limit?: number, query?: string, feedback?: string): import('@tanstack/react-query').UseQueryResult<{
+export declare function useAdminThreads(skip?: number, limit?: number, query?: string, feedback?: string, source?: AdminSourceFilter): import('@tanstack/react-query').UseQueryResult<{
     threads: import('../admin/lib/api').Thread[];
     count: number;
 }, Error>;
@@ -66,6 +68,31 @@ export declare function useAdminJobs(limit?: number, type?: string): import('@ta
 export declare function useAdminJobsMutations(): {
     cancelJob: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').AdminStatusResponse, Error, string, unknown>;
 };
+export declare function useRegisteredJobs(enabled?: boolean): import('@tanstack/react-query').UseQueryResult<{
+    jobs: import('../admin/lib/api').JobDefinition[];
+}, Error>;
+export declare function useJobRuns(filters?: {
+    limit?: number;
+    kind?: string;
+    status?: string;
+}, enabled?: boolean): import('@tanstack/react-query').UseQueryResult<{
+    runs: import('../admin/lib/api').JobRun[];
+    count: number;
+}, Error>;
+export declare function useJobRun(runId: string | null, poll?: boolean): import('@tanstack/react-query').UseQueryResult<import('../admin/lib/api').JobRun, Error>;
+export declare function useJobMutations(): {
+    runRegisteredJob: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').JobRun, Error, {
+        jobId: string;
+        params?: Record<string, unknown>;
+        dry_run?: boolean;
+        confirm?: string;
+    }, unknown>;
+    runRawJob: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').JobRun, Error, {
+        code: string;
+        confirm_phrase: string;
+    }, unknown>;
+    cancelJobRun: import('@tanstack/react-query').UseMutationResult<import('../admin/lib/api').AdminStatusResponse, Error, string, unknown>;
+};
 export declare function useAdminAuth(): {
     login: (username: string, password: string) => Promise<import('../admin/lib/api').AdminLoginResponse>;
     logout: () => void;

package/dist/src/locales/en.json.d.ts

@@ -111,6 +111,48 @@ declare const _default: {
     "loading_more": "Loading more...",
     "confirm_delete": "Are you sure you want to delete?",
     "error_loading": "Error loading data",
+    "close": "Close",
+    "jobs": {
+      "section_title": "Maintenance Jobs",
+      "no_jobs": "No jobs are registered for this deployment.",
+      "run": "Run",
+      "run_dry": "Dry run",
+      "run_started": "Started \"{{name}}\"",
+      "run_failed": "Failed to start job",
+      "history": "Run history",
+      "history_help": "Recent runs. Click a row to see its inputs and output.",
+      "view_history": "View run history",
+      "inputs": "Inputs",
+      "no_runs": "No runs yet.",
+      "dry_run": "Dry run",
+      "dry_run_help": "Simulate the job without writing any changes.",
+      "confirm_destructive": "This is a destructive job. Type \"{{name}}\" to confirm.",
+      "output": "Output",
+      "no_output": "(no output)",
+      "output_truncated": "...[output truncated]",
+      "result": "Result",
+      "cancel_run": "Cancel run",
+      "triggered_by": "Triggered by {{user}}",
+      "triggered_by_api": "Triggered via API key",
+      "danger": {
+        "safe": "safe",
+        "caution": "caution",
+        "destructive": "destructive"
+      },
+      "status": {
+        "queued": "Queued",
+        "processing": "Running",
+        "completed": "Completed",
+        "failed": "Failed",
+        "cancelled": "Cancelled"
+      },
+      "raw": {
+        "title": "Run raw Python",
+        "warning": "This executes arbitrary Python on the server with full process privileges. There is no sandbox — only access control and an audit log. Use only when you know exactly what you are doing.",
+        "confirm_label": "Type \"{{phrase}}\" to enable running.",
+        "run": "Execute"
+      }
+    },
     "dashboard": {
       "title": "Admin Panel",
       "logout": "Logout",
@@ -200,6 +242,8 @@ declare const _default: {
     "analytics": {
       "title": "Analytics & Statistics",
       "days": "{{count}} Days",
+      "time_range_label": "Last",
+      "days_unit": "days",
       "total_users": "Total Users",
       "total_threads": "Total Threads",
       "total_messages": "Total Messages",
@@ -220,7 +264,13 @@ declare const _default: {
       "positive": "Positive",
       "negative": "Negative",
       "loading_analytics": "Loading analytics...",
-      "error_loading": "Error loading data"
+      "error_loading": "Error loading data",
+      "source_human": "Users",
+      "source_service": "Service",
+      "source_all": "All",
+      "source_caption_human": "Showing real users only",
+      "source_caption_service": "Showing service traffic only",
+      "source_caption_all": "Showing all traffic"
     },
     "chat_history": {
       "title": "Chat History Management",
@@ -250,7 +300,11 @@ declare const _default: {
       "output_available": "Output Available",
       "running": "Running...",
       "unnamed_file": "Unnamed File",
-      "download_file": "Download File"
+      "download_file": "Download File",
+      "source_human": "Users",
+      "source_service": "Service",
+      "source_all": "All sources",
+      "external_user_id": "Service ref"
     },
     "users": {
       "title": "User Management",
@@ -337,7 +391,17 @@ declare const _default: {
       "bulk_select_change": "Select at least one bulk change to apply.",
       "bulk_renewal_policy": "Renewal Policy",
       "bulk_renewal_policy_help": "Enable or disable automatic renewal for every matched user.",
-      "bulk_renewal_anchor": "First renewal time (optional)"
+      "bulk_renewal_anchor": "First renewal time (optional)",
+      "source_human": "Users",
+      "source_service": "Service",
+      "source_all": "All",
+      "account_type": "Account type",
+      "account_type_human": "Human user",
+      "account_type_service": "Service (external API)",
+      "account_type_service_help": "External API consumer. Phone is optional; share this account’s token with the integrating service.",
+      "service_name": "Service name",
+      "service_name_placeholder": "e.g. Acme CRM integration",
+      "optional": "optional"
     },
     "admins": {
       "title": "Admin Management",

package/dist/src/locales/fa.json.d.ts

@@ -110,6 +110,48 @@ declare const _default: {
     "loading_more": "در حال بارگذاری بیشتر...",
     "confirm_delete": "آیا از حذف اطمینان دارید؟",
     "error_loading": "خطا در بارگذاری داده‌ها",
+    "close": "بستن",
+    "jobs": {
+      "section_title": "کارهای سیستمی",
+      "no_jobs": "هیچ کاری برای این برنامه تعریف نشده است.",
+      "run": "اجرا",
+      "run_dry": "اجرای آزمایشی",
+      "run_started": "کار «{{name}}» اجرا شد",
+      "run_failed": "اجرای کار با خطا مواجه شد",
+      "history": "تاریخچهٔ اجراها",
+      "history_help": "اجراهای اخیر. برای دیدن ورودی‌ها و خروجی هر اجرا روی آن کلیک کنید.",
+      "view_history": "مشاهدهٔ تاریخچهٔ اجراها",
+      "inputs": "ورودی‌ها",
+      "no_runs": "هنوز هیچ کاری اجرا نشده است.",
+      "dry_run": "اجرای آزمایشی",
+      "dry_run_help": "کار را بدون اعمال هیچ تغییری شبیه‌سازی می‌کند.",
+      "confirm_destructive": "این یک کار مخرب است. برای تأیید، نام «{{name}}» را وارد کنید.",
+      "output": "خروجی",
+      "no_output": "(خروجی‌ای ثبت نشد)",
+      "output_truncated": "...[خروجی کوتاه شد]",
+      "result": "نتیجه",
+      "cancel_run": "لغو اجرا",
+      "triggered_by": "اجرا شده توسط {{user}}",
+      "triggered_by_api": "اجرا شده با کلید API",
+      "danger": {
+        "safe": "بی‌خطر",
+        "caution": "نیازمند احتیاط",
+        "destructive": "مخرب"
+      },
+      "status": {
+        "queued": "در صف",
+        "processing": "در حال اجرا",
+        "completed": "انجام شد",
+        "failed": "ناموفق",
+        "cancelled": "لغو شد"
+      },
+      "raw": {
+        "title": "اجرای کد پایتون",
+        "warning": "این بخش کد پایتون دلخواه را با دسترسی کامل روی سرور اجرا می‌کند. هیچ ایزوله‌سازی‌ای در کار نیست؛ تنها محافظت، کنترل دسترسی و ثبت در گزارش است. فقط زمانی استفاده کنید که از کاری که انجام می‌دهید کاملاً مطمئن هستید.",
+        "confirm_label": "برای فعال شدن دکمهٔ اجرا، عبارت «{{phrase}}» را وارد کنید.",
+        "run": "اجرای کد"
+      }
+    },
     "dashboard": {
       "title": "پنل ادمین",
       "logout": "خروج",
@@ -199,6 +241,8 @@ declare const _default: {
     "analytics": {
       "title": "تحلیل و آمار",
       "days": "{{count}} روز",
+      "time_range_label": "بازه",
+      "days_unit": "روز",
       "total_users": "تعداد کاربران",
       "total_threads": "تعداد گفتگوها",
       "total_messages": "تعداد پیام‌ها",
@@ -219,7 +263,13 @@ declare const _default: {
       "positive": "مثبت",
       "negative": "منفی",
       "loading_analytics": "در حال بارگذاری تحلیل‌ها...",
-      "error_loading": "خطا در بارگذاری داده‌ها"
+      "error_loading": "خطا در بارگذاری داده‌ها",
+      "source_human": "کاربران",
+      "source_service": "سرویس",
+      "source_all": "همه",
+      "source_caption_human": "نمایش فقط کاربران واقعی",
+      "source_caption_service": "نمایش فقط ترافیک سرویس",
+      "source_caption_all": "نمایش همهٔ ترافیک"
     },
     "chat_history": {
       "title": "مدیریت تاریخچه گفتگوها",
@@ -249,7 +299,11 @@ declare const _default: {
       "output_available": "خروجی موجود است",
       "running": "در حال اجرا...",
       "unnamed_file": "فایل بدون نام",
-      "download_file": "دانلود فایل"
+      "download_file": "دانلود فایل",
+      "source_human": "کاربران",
+      "source_service": "سرویس",
+      "source_all": "همهٔ منابع",
+      "external_user_id": "شناسهٔ سرویس"
     },
     "users": {
       "title": "مدیریت کاربران",
@@ -336,7 +390,17 @@ declare const _default: {
       "bulk_select_change": "حداقل یک تغییر گروهی را برای اعمال انتخاب کنید.",
       "bulk_renewal_policy": "سیاست تمدید",
       "bulk_renewal_policy_help": "تمدید خودکار را برای همه کاربران مطابق فعال یا غیرفعال کنید.",
-      "bulk_renewal_anchor": "زمان اولین تمدید (اختیاری)"
+      "bulk_renewal_anchor": "زمان اولین تمدید (اختیاری)",
+      "source_human": "کاربران",
+      "source_service": "سرویس",
+      "source_all": "همه",
+      "account_type": "نوع حساب",
+      "account_type_human": "کاربر انسانی",
+      "account_type_service": "سرویس",
+      "account_type_service_help": "مصرف‌کنندهٔ سرویس خارجی. شمارهٔ تلفن اختیاری است؛ توکن این حساب را با سرویس یکپارچه‌شونده به اشتراک بگذارید.",
+      "service_name": "نام سرویس",
+      "service_name_placeholder": "مثلاً یکپارچه‌سازی CRM",
+      "optional": "اختیاری"
     },
     "admins": {
       "title": "مدیریت ادمین‌ها",

package/package.json

@@ -10,7 +10,7 @@
     "provenance": true
   },
   "description": "React UI library for the Gentiq AI framework.",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "files": [
     "dist"