@useorgx/openclaw-plugin 0.4.9 → 0.7.2

package/dist/contracts/client.d.ts

@@ -6,7 +6,7 @@
  *
  * Uses native fetch — no external dependencies.
  */
-import type { OrgSnapshot, SyncPayload, SyncResponse, SpawnGuardResult, QualityScore, Entity, EntityListFilters, EmitActivityRequest, EmitActivityResponse, ApplyChangesetRequest, ApplyChangesetResponse, RecordRunOutcomeRequest, RecordRunOutcomeResponse, RecordRunRetroRequest, RecordRunRetroResponse, LiveActivityItem, SessionTreeResponse, HandoffSummary, CheckpointSummary, RestoreRequest, DelegationPreflightResult, BillingStatus, BillingCheckoutRequest, BillingUrlResult, KickoffContextRequest, KickoffContextResponse, SkillPack } from "./types.js";
+import type { OrgSnapshot, SyncPayload, SyncResponse, SpawnGuardResult, QualityScore, Entity, EntityListFilters, EmitActivityRequest, EmitActivityResponse, ApplyChangesetRequest, ApplyChangesetResponse, RecordRunOutcomeRequest, RecordRunOutcomeResponse, RecordRunRetroRequest, RecordRunRetroResponse, LiveActivityItem, SessionTreeResponse, HandoffSummary, EntityUpdateResult, CheckpointSummary, RestoreRequest, DelegationPreflightResult, BillingStatus, BillingCheckoutRequest, BillingUrlResult, UsageControlPlaneSummary, KickoffContextRequest, KickoffContextResponse, SkillPack, ClientRuntimeSettingsResponse, ClientRuntimeSettingsUpdateRequest } from "./types.js";
 export type DecisionAction = "approve" | "reject";
 export type RunAction = "pause" | "resume" | "cancel" | "rollback";
 export interface DecisionActionResult {
@@ -15,6 +15,10 @@ export interface DecisionActionResult {
     entity?: Entity;
     error?: string;
 }
+export interface DecisionMutationInput {
+    note?: string;
+    optionId?: string;
+}
 export declare class OrgXClient {
     private apiKey;
     private baseUrl;
@@ -40,6 +44,7 @@ export declare class OrgXClient {
     private post;
     private patch;
     private buildQuery;
+    private unwrapSyncResponse;
     getOrgSnapshot(): Promise<OrgSnapshot>;
     syncMemory(payload: SyncPayload): Promise<SyncResponse>;
     getKickoffContext(payload: KickoffContextRequest): Promise<KickoffContextResponse>;
@@ -61,6 +66,12 @@ export declare class OrgXClient {
         status: number;
         error: string;
     }>;
+    getClientAgentRuntimeSettings(input?: {
+        workspaceId?: string | null;
+        /** Legacy alias retained for backward compatibility */
+        projectId?: string | null;
+    }): Promise<ClientRuntimeSettingsResponse>;
+    updateClientAgentRuntimeSettings(payload: ClientRuntimeSettingsUpdateRequest): Promise<ClientRuntimeSettingsResponse>;
     delegationPreflight(payload: {
         intent: string;
         acceptanceCriteria?: string[];
@@ -84,6 +95,11 @@ export declare class OrgXClient {
      * PATCH /api/entities { type, id, ...updates }
      */
     updateEntity(type: string, id: string, updates: Record<string, unknown>): Promise<Entity>;
+    /**
+     * Update an OrgX entity and preserve reassignment metadata when present.
+     * PATCH /api/entities { type, id, ...updates }
+     */
+    updateEntityDetailed(type: string, id: string, updates: Record<string, unknown>): Promise<EntityUpdateResult>;
     /**
      * List OrgX entities.
      * GET /api/entities?type={type}&status={status}&limit={n}
@@ -98,6 +114,9 @@ export declare class OrgXClient {
     getBillingStatus(): Promise<BillingStatus>;
     createBillingCheckout(payload: BillingCheckoutRequest): Promise<BillingUrlResult>;
     createBillingPortal(): Promise<BillingUrlResult>;
+    getUsageControlPlaneSummary(): Promise<UsageControlPlaneSummary>;
+    getUsageUnified(): Promise<UsageControlPlaneSummary>;
+    getUsageForecast(): Promise<Pick<UsageControlPlaneSummary, "generatedAt" | "period" | "predicted" | "risk" | "headroom" | "utilization">>;
     emitActivity(payload: EmitActivityRequest): Promise<EmitActivityResponse>;
     applyChangeset(payload: ApplyChangesetRequest): Promise<ApplyChangesetResponse>;
     recordRunOutcome(payload: RecordRunOutcomeRequest): Promise<RecordRunOutcomeResponse>;
@@ -105,11 +124,17 @@ export declare class OrgXClient {
     getLiveSessions(params?: {
         limit?: number;
         initiative?: string | null;
+        workspaceId?: string | null;
+        /** @deprecated Use workspaceId */
+        projectId?: string | null;
     }): Promise<SessionTreeResponse>;
     getLiveActivity(params?: {
         limit?: number;
         run?: string | null;
         since?: string | null;
+        workspaceId?: string | null;
+        /** @deprecated Use workspaceId */
+        projectId?: string | null;
     }): Promise<{
         activities: LiveActivityItem[];
         total: number;
@@ -117,6 +142,9 @@ export declare class OrgXClient {
     getLiveAgents(params?: {
         initiative?: string | null;
         includeIdle?: boolean;
+        workspaceId?: string | null;
+        /** @deprecated Use workspaceId */
+        projectId?: string | null;
     }): Promise<{
         agents: unknown[];
         summary: Record<string, number>;
@@ -124,9 +152,18 @@ export declare class OrgXClient {
     getLiveInitiatives(params?: {
         id?: string | null;
         limit?: number;
+        offset?: number;
+        workspaceId?: string | null;
+        /** @deprecated Use workspaceId */
+        projectId?: string | null;
     }): Promise<{
         initiatives: unknown[];
         total: number;
+        pagination?: {
+            limit?: number;
+            offset?: number;
+            has_more?: boolean;
+        };
     }>;
     getHandoffs(): Promise<{
         handoffs: HandoffSummary[];
@@ -166,10 +203,13 @@ export declare class OrgXClient {
     getLiveDecisions(params?: {
         status?: string;
         limit?: number;
+        workspaceId?: string | null;
+        /** @deprecated Use workspaceId */
+        projectId?: string | null;
     }): Promise<{
         decisions: Entity[];
         total: number;
     }>;
-    decideDecision(id: string, action: DecisionAction, note?: string): Promise<Entity>;
-    bulkDecideDecisions(ids: string[], action: DecisionAction, note?: string): Promise<DecisionActionResult[]>;
+    decideDecision(id: string, action: DecisionAction, input?: DecisionMutationInput): Promise<Entity>;
+    bulkDecideDecisions(ids: string[], action: DecisionAction, input?: DecisionMutationInput): Promise<DecisionActionResult[]>;
 }

package/dist/contracts/client.js

@@ -12,6 +12,12 @@ const DEFAULT_SYNC_TIMEOUT_MS = 45_000;
 const USER_AGENT = "OrgX-Clawdbot-Plugin/1.0";
 const DECISION_MUTATION_CONCURRENCY = 6;
 const DEFAULT_CLIENT_BASE_URL = "https://www.useorgx.com";
+function normalizeAgentStatus(value) {
+    if (value === "active" || value === "idle" || value === "throttled") {
+        return value;
+    }
+    return "idle";
+}
 function isUserScopedApiKey(apiKey) {
     return apiKey.trim().toLowerCase().startsWith("oxk_");
 }
@@ -184,21 +190,42 @@ export class OrgXClient {
         }
         return `?${search.toString()}`;
     }
+    unwrapSyncResponse(response) {
+        if (response &&
+            typeof response === "object" &&
+            "data" in response &&
+            response.data) {
+            return response.data;
+        }
+        return response;
+    }
     // ===========================================================================
     // Org Snapshot
     // ===========================================================================
     async getOrgSnapshot() {
         // Use the sync endpoint with POST (empty body = pull only)
         const resp = await this.post("/api/client/sync", {});
-        const data = resp.data;
+        const data = this.unwrapSyncResponse(resp);
         // Transform SyncResponse to OrgSnapshot format
+        const syncAgents = Array.isArray(data.agents) ? data.agents : [];
         return {
             initiatives: data.initiatives.map(i => ({
                 id: i.id,
                 title: i.title,
                 status: i.status,
             })),
-            agents: [], // Not returned by sync endpoint
+            agents: syncAgents.map((agent) => ({
+                id: String(agent.id ?? ""),
+                name: String(agent.name ?? ""),
+                domain: String(agent.domain ?? ""),
+                status: normalizeAgentStatus(agent.status),
+                currentTask: typeof agent.currentTask === "string" && agent.currentTask.trim().length > 0
+                    ? agent.currentTask
+                    : undefined,
+                lastActive: typeof agent.lastActive === "string" && agent.lastActive.trim().length > 0
+                    ? agent.lastActive
+                    : undefined,
+            })),
             activeTasks: data.activeTasks.map(t => ({
                 id: t.id,
                 title: t.title,
@@ -219,13 +246,7 @@ export class OrgXClient {
     // ===========================================================================
     async syncMemory(payload) {
         const response = await this.post("/api/client/sync", payload);
-        if (response &&
-            typeof response === "object" &&
-            "data" in response &&
-            response.data) {
-            return response.data;
-        }
-        return response;
+        return this.unwrapSyncResponse(response);
     }
     // ===========================================================================
     // Kickoff Context
@@ -293,6 +314,20 @@ export class OrgXClient {
             clearTimeout(timeout);
         }
     }
+    // ===========================================================================
+    // Client Agent Runtime Settings
+    // ===========================================================================
+    async getClientAgentRuntimeSettings(input) {
+        const workspaceScope = input?.workspaceId ?? input?.projectId ?? null;
+        const query = this.buildQuery({
+            workspace_id: workspaceScope,
+            command_center_id: workspaceScope,
+        });
+        return this.get(`/api/client/agents/runtime-settings${query}`);
+    }
+    async updateClientAgentRuntimeSettings(payload) {
+        return this.patch("/api/client/agents/runtime-settings", payload);
+    }
     async delegationPreflight(payload) {
         return this.post("/api/client/delegation/preflight", payload);
     }
@@ -351,12 +386,34 @@ export class OrgXClient {
      * PATCH /api/entities { type, id, ...updates }
      */
     async updateEntity(type, id, updates) {
+        const result = await this.updateEntityDetailed(type, id, updates);
+        return result.entity;
+    }
+    /**
+     * Update an OrgX entity and preserve reassignment metadata when present.
+     * PATCH /api/entities { type, id, ...updates }
+     */
+    async updateEntityDetailed(type, id, updates) {
         const resp = await this.patch("/api/entities", {
             type,
             id,
             ...updates,
         });
-        return resp.data ?? resp;
+        if (resp && typeof resp === "object") {
+            const envelope = resp;
+            const entity = envelope.entity ?? envelope.data ?? resp;
+            return {
+                entity,
+                reassignment: envelope.reassignment && typeof envelope.reassignment === "object"
+                    ? envelope.reassignment
+                    : null,
+                initiative_reassignment: envelope.initiative_reassignment &&
+                    typeof envelope.initiative_reassignment === "object"
+                    ? envelope.initiative_reassignment
+                    : null,
+            };
+        }
+        return { entity: resp };
     }
     /**
      * List OrgX entities.
@@ -366,10 +423,49 @@ export class OrgXClient {
         const params = new URLSearchParams({ type });
         if (filters?.status)
             params.set("status", filters.status);
+        if (typeof filters?.offset === "number" && Number.isFinite(filters.offset)) {
+            params.set("offset", String(Math.max(0, Math.floor(filters.offset))));
+        }
+        if (filters?.search)
+            params.set("search", String(filters.search));
+        if (filters?.id)
+            params.set("id", String(filters.id));
+        if (filters?.ids) {
+            const values = Array.isArray(filters.ids)
+                ? filters.ids
+                : String(filters.ids)
+                    .split(",")
+                    .map((value) => value.trim())
+                    .filter((value) => value.length > 0);
+            if (values.length > 0) {
+                params.set("ids", values.join(","));
+            }
+        }
         if (filters?.limit)
             params.set("limit", String(filters.limit));
         if (filters?.initiative_id)
             params.set("initiative_id", String(filters.initiative_id));
+        const legacyProjectIdRaw = filters?.project_id != null ? String(filters.project_id) : null;
+        const workspaceIdRaw = filters?.workspace_id != null ? String(filters.workspace_id) : null;
+        const commandCenterIdRaw = filters?.command_center_id != null
+            ? String(filters.command_center_id)
+            : null;
+        if (workspaceIdRaw &&
+            commandCenterIdRaw &&
+            workspaceIdRaw.trim() !== commandCenterIdRaw.trim()) {
+            throw new Error("workspace_id and command_center_id must match when both are provided");
+        }
+        if (legacyProjectIdRaw &&
+            workspaceIdRaw &&
+            legacyProjectIdRaw.trim() !== workspaceIdRaw.trim()) {
+            throw new Error("project_id cannot differ from workspace_id; use workspace_id as canonical scope");
+        }
+        const workspaceId = workspaceIdRaw ?? commandCenterIdRaw ?? legacyProjectIdRaw;
+        if (workspaceId) {
+            // Canonical scope param. Keep legacy alias for backward compatibility.
+            params.set("workspace_id", workspaceId);
+            params.set("command_center_id", workspaceId);
+        }
         return this.get(`/api/entities?${params.toString()}`);
     }
     // ===========================================================================
@@ -397,6 +493,18 @@ export class OrgXClient {
         return response;
     }
     // ===========================================================================
+    // Usage (Control Plane + Forecast)
+    // ===========================================================================
+    async getUsageControlPlaneSummary() {
+        return this.get("/api/usage/control-plane/summary");
+    }
+    async getUsageUnified() {
+        return this.get("/api/usage/unified");
+    }
+    async getUsageForecast() {
+        return this.get("/api/usage/forecast");
+    }
+    // ===========================================================================
     // Reporting Control Plane
     // ===========================================================================
     async emitActivity(payload) {
@@ -443,31 +551,44 @@ export class OrgXClient {
     // Live Sessions + Activity + Handoffs
     // ===========================================================================
     async getLiveSessions(params) {
+        const workspaceScope = params?.workspaceId ?? params?.projectId ?? null;
         const query = this.buildQuery({
             limit: params?.limit,
             initiative: params?.initiative ?? null,
+            workspace_id: workspaceScope,
+            command_center_id: workspaceScope,
         });
         return this.get(`/api/client/live/sessions${query}`);
     }
     async getLiveActivity(params) {
+        const workspaceScope = params?.workspaceId ?? params?.projectId ?? null;
         const query = this.buildQuery({
             limit: params?.limit,
             run: params?.run ?? null,
             since: params?.since ?? null,
+            workspace_id: workspaceScope,
+            command_center_id: workspaceScope,
         });
         return this.get(`/api/client/live/activity${query}`);
     }
     async getLiveAgents(params) {
+        const workspaceScope = params?.workspaceId ?? params?.projectId ?? null;
         const query = this.buildQuery({
             initiative: params?.initiative ?? null,
             include_idle: params?.includeIdle ?? undefined,
+            workspace_id: workspaceScope,
+            command_center_id: workspaceScope,
         });
         return this.get(`/api/client/live/agents${query}`);
     }
     async getLiveInitiatives(params) {
+        const workspaceScope = params?.workspaceId ?? params?.projectId ?? null;
         const query = this.buildQuery({
             id: params?.id ?? null,
             limit: params?.limit ?? null,
+            offset: params?.offset ?? null,
+            workspace_id: workspaceScope,
+            command_center_id: workspaceScope,
         });
         return this.get(`/api/client/live/initiatives${query}`);
     }
@@ -493,9 +614,12 @@ export class OrgXClient {
         return this.post(`/api/client/runs/${encodedRunId}/checkpoints/${encodedCheckpointId}/restore`, { reason: request.reason });
     }
     async getLiveDecisions(params) {
+        const workspaceScope = params?.workspaceId ?? params?.projectId ?? undefined;
         const response = await this.listEntities("decision", {
             status: params?.status,
             limit: params?.limit,
+            workspace_id: workspaceScope,
+            command_center_id: workspaceScope,
         });
         const decisions = Array.isArray(response.data) ? response.data : [];
         return {
@@ -503,32 +627,37 @@ export class OrgXClient {
             total: response.pagination?.total ?? decisions.length,
         };
     }
-    async decideDecision(id, action, note) {
-        const resolvedStatus = action === "approve" ? "approved" : "rejected";
-        const resolvedAt = new Date().toISOString();
+    async decideDecision(id, action, input) {
+        const note = input?.note?.trim() || null;
+        const optionId = input?.optionId?.trim() || null;
+        const resolvedStatus = action === "approve" ? "approved" : "declined";
+        const primaryPatch = {
+            status: resolvedStatus,
+            ...(note ? { resolution_summary: note } : {}),
+            ...(optionId ? { option_id: optionId } : {}),
+        };
         try {
-            return await this.updateEntity("decision", id, {
-                status: resolvedStatus,
-                resolution: resolvedStatus,
-                resolved_at: resolvedAt,
-                decided_at: resolvedAt,
-                decided_by: this.userId || undefined,
-                note: note ?? undefined,
-            });
+            return await this.updateEntity("decision", id, primaryPatch);
         }
         catch {
-            // Fallback for backends that only support generic "resolved" status.
+            // Keep fallback payload schema-safe for strict entity routes.
             return this.updateEntity("decision", id, {
-                status: "resolved",
-                decision_status: resolvedStatus,
-                resolution: resolvedStatus,
-                resolved_at: resolvedAt,
-                decided_at: resolvedAt,
-                note: note ?? undefined,
+                status: resolvedStatus,
+                ...(note
+                    ? {
+                        metadata: {
+                            resolution: {
+                                summary: note,
+                                note,
+                            },
+                        },
+                    }
+                    : {}),
+                ...(optionId ? { option_id: optionId } : {}),
             });
         }
     }
-    async bulkDecideDecisions(ids, action, note) {
+    async bulkDecideDecisions(ids, action, input) {
         const uniqueIds = Array.from(new Set(ids.filter(Boolean)));
         const results = new Array(uniqueIds.length);
         let cursor = 0;
@@ -541,7 +670,7 @@ export class OrgXClient {
                 }
                 const id = uniqueIds[index];
                 try {
-                    const entity = await this.decideDecision(id, action, note);
+                    const entity = await this.decideDecision(id, action, input);
                     results[index] = { id, ok: true, entity };
                 }
                 catch (err) {

package/dist/contracts/practice-exercise-schema.d.ts

@@ -0,0 +1,216 @@
+export declare const PRACTICE_EXERCISE_TEMPLATE_SCHEMA_VERSION: "practice-exercise-template.v1";
+export type PracticeExerciseTemplateSchemaVersion = typeof PRACTICE_EXERCISE_TEMPLATE_SCHEMA_VERSION;
+export type PracticeConstraintSeverity = "hard" | "soft";
+export type PracticeTaskType = "analysis" | "implementation" | "review" | "debugging" | "planning";
+export type PracticeOutputFormat = "json_object" | "markdown" | "text";
+export interface PracticeConstraint {
+    id: string;
+    title: string;
+    description: string;
+    severity: PracticeConstraintSeverity;
+    rationale?: string;
+}
+export interface PracticeScenario {
+    id: string;
+    title: string;
+    input: Record<string, unknown>;
+    context?: string;
+    success_criteria: string[];
+}
+export interface PracticeExpectedOutputField {
+    path: string;
+    type: string;
+    required: boolean;
+    description: string;
+}
+export interface PracticeExpectedOutputShape {
+    format: PracticeOutputFormat;
+    fields: PracticeExpectedOutputField[];
+    example?: Record<string, unknown> | string;
+}
+export interface PracticeExerciseTemplate {
+    schema_version: PracticeExerciseTemplateSchemaVersion;
+    id: string;
+    title: string;
+    summary: string;
+    task_type: PracticeTaskType;
+    scenarios: PracticeScenario[];
+    constraints: PracticeConstraint[];
+    expected_output_shape: PracticeExpectedOutputShape;
+    tags?: string[];
+}
+export declare function validatePracticeExerciseTemplate(input: unknown): {
+    ok: boolean;
+    errors: string[];
+    template: PracticeExerciseTemplate | null;
+};
+export declare const PRACTICE_EXERCISE_TEMPLATE_JSON_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.useorgx.com/practice-exercise-template/v1.json";
+    readonly title: "OrgX Practice Exercise Template v1";
+    readonly description: "Structured exercise template for practice loops with scenarios, constraints, and expected output shape.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["schema_version", "id", "title", "summary", "task_type", "scenarios", "constraints", "expected_output_shape"];
+    readonly properties: {
+        readonly schema_version: {
+            readonly type: "string";
+            readonly const: "practice-exercise-template.v1";
+        };
+        readonly id: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 120;
+        };
+        readonly title: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 300;
+        };
+        readonly summary: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 3000;
+        };
+        readonly task_type: {
+            readonly type: "string";
+            readonly enum: readonly ["analysis", "implementation", "review", "debugging", "planning"];
+        };
+        readonly scenarios: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 25;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "title", "input", "success_criteria"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 120;
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 300;
+                    };
+                    readonly input: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                    readonly context: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 4000;
+                    };
+                    readonly success_criteria: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 20;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 1000;
+                        };
+                    };
+                };
+            };
+        };
+        readonly constraints: {
+            readonly type: "array";
+            readonly maxItems: 25;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "title", "description", "severity"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 120;
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 300;
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 2000;
+                    };
+                    readonly severity: {
+                        readonly type: "string";
+                        readonly enum: readonly ["hard", "soft"];
+                    };
+                    readonly rationale: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 2000;
+                    };
+                };
+            };
+        };
+        readonly expected_output_shape: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["format", "fields"];
+            readonly properties: {
+                readonly format: {
+                    readonly type: "string";
+                    readonly enum: readonly ["json_object", "markdown", "text"];
+                };
+                readonly fields: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 50;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["path", "type", "required", "description"];
+                        readonly properties: {
+                            readonly path: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 400;
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 120;
+                            };
+                            readonly required: {
+                                readonly type: "boolean";
+                            };
+                            readonly description: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 2000;
+                            };
+                        };
+                    };
+                };
+                readonly example: {
+                    readonly oneOf: readonly [{
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 20000;
+                    }, {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    }];
+                };
+            };
+        };
+        readonly tags: {
+            readonly type: "array";
+            readonly maxItems: 30;
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 80;
+            };
+        };
+    };
+};