orchestrator-client 5.9.0 → 5.9.2

package/dist/index.d.cts

@@ -29,11 +29,21 @@ interface TaskSummary {
     approvalReason: string;
     ticketId: string | null;
     availableTools: string[] | null;
+    /** Resolved skill references (name + description snapshot) at creation. */
+    skills: {
+        name: string;
+        description: string;
+    }[] | null;
     insight: string | null;
     insightLocalized: string | null;
     createdAt: string;
     updatedAt: string;
     pendingTranslationsForLocales?: string[] | null;
+    /**
+     * Workflow-specific data blob.  Present on list responses (the API's
+     * TaskStatusResponse carries workflow_data); null on legacy rows.
+     */
+    workflowData?: Record<string, unknown> | null;
 }
 /** Per-task feature toggles set at creation time. */
 interface TaskOptions {
@@ -432,6 +442,48 @@ interface CatalogValidationResult {
     totalIssues: number;
 }
 
+/** Skill availability mapping: which workflow/variant/tool a skill needs. */
+interface SkillMapping {
+    id: number;
+    workflowId: string;
+    /** Null matches every variant of the workflow. */
+    variant: string | null;
+    /** Tool the task toolset must contain; null means no tool gate. */
+    requiredTool: string | null;
+}
+/** A skill definition with its availability mappings. */
+interface Skill {
+    id: number;
+    name: string;
+    description: string;
+    content: string;
+    createdAt: string;
+    updatedAt: string;
+    mappings: SkillMapping[];
+}
+/** Result of `GET /skills`. */
+interface SkillsListResult {
+    skills: Skill[];
+    total: number;
+}
+/** Payload for `POST /skills`. */
+interface SkillCreatePayload {
+    name: string;
+    description: string;
+    content: string;
+}
+/** Payload for `PUT /skills/:id` — only provided fields are applied. */
+interface SkillUpdatePayload {
+    description?: string;
+    content?: string;
+}
+/** Payload for `POST /skills/:id/mappings`. */
+interface SkillMappingCreatePayload {
+    workflowId: string;
+    variant?: string | null;
+    requiredTool?: string | null;
+}
+
 interface CompactionEvent {
     id: number;
     taskId: string;
@@ -730,6 +782,19 @@ declare class OrchestratorAsync {
     getToolCatalog(): Promise<ToolCatalogResult>;
     refreshMCPTools(): Promise<MCPRefreshResult>;
     validateToolCatalog(): Promise<CatalogValidationResult>;
+    listSkills(): Promise<SkillsListResult>;
+    getSkill(skillId: number): Promise<Skill>;
+    createSkill(payload: SkillCreatePayload): Promise<Skill>;
+    updateSkill(skillId: number, payload: SkillUpdatePayload): Promise<Skill>;
+    deleteSkill(skillId: number): Promise<{
+        deleted: boolean;
+        skillId: number;
+    }>;
+    addSkillMapping(skillId: number, payload: SkillMappingCreatePayload): Promise<SkillMapping>;
+    deleteSkillMapping(skillId: number, mappingId: number): Promise<{
+        deleted: boolean;
+        mappingId: number;
+    }>;
     getWorkflowStates(): Promise<WorkflowStates>;
     updateTaskModels(taskId: string, models: {
         agentModelId?: string;
@@ -869,6 +934,19 @@ declare class Orchestrator {
     getToolCatalog(): ToolCatalogResult;
     refreshMCPTools(): MCPRefreshResult;
     validateToolCatalog(): CatalogValidationResult;
+    listSkills(): SkillsListResult;
+    getSkill(skillId: number): Skill;
+    createSkill(payload: Parameters<OrchestratorAsync["createSkill"]>[0]): Skill;
+    updateSkill(skillId: number, payload: Parameters<OrchestratorAsync["updateSkill"]>[1]): Skill;
+    deleteSkill(skillId: number): {
+        deleted: boolean;
+        skillId: number;
+    };
+    addSkillMapping(skillId: number, payload: Parameters<OrchestratorAsync["addSkillMapping"]>[1]): SkillMapping;
+    deleteSkillMapping(skillId: number, mappingId: number): {
+        deleted: boolean;
+        mappingId: number;
+    };
     getWorkflowStates(): WorkflowStates;
     updateTaskModels(taskId: string, models: {
         agentModelId?: string;

package/dist/index.d.ts

@@ -29,11 +29,21 @@ interface TaskSummary {
     approvalReason: string;
     ticketId: string | null;
     availableTools: string[] | null;
+    /** Resolved skill references (name + description snapshot) at creation. */
+    skills: {
+        name: string;
+        description: string;
+    }[] | null;
     insight: string | null;
     insightLocalized: string | null;
     createdAt: string;
     updatedAt: string;
     pendingTranslationsForLocales?: string[] | null;
+    /**
+     * Workflow-specific data blob.  Present on list responses (the API's
+     * TaskStatusResponse carries workflow_data); null on legacy rows.
+     */
+    workflowData?: Record<string, unknown> | null;
 }
 /** Per-task feature toggles set at creation time. */
 interface TaskOptions {
@@ -432,6 +442,48 @@ interface CatalogValidationResult {
     totalIssues: number;
 }
 
+/** Skill availability mapping: which workflow/variant/tool a skill needs. */
+interface SkillMapping {
+    id: number;
+    workflowId: string;
+    /** Null matches every variant of the workflow. */
+    variant: string | null;
+    /** Tool the task toolset must contain; null means no tool gate. */
+    requiredTool: string | null;
+}
+/** A skill definition with its availability mappings. */
+interface Skill {
+    id: number;
+    name: string;
+    description: string;
+    content: string;
+    createdAt: string;
+    updatedAt: string;
+    mappings: SkillMapping[];
+}
+/** Result of `GET /skills`. */
+interface SkillsListResult {
+    skills: Skill[];
+    total: number;
+}
+/** Payload for `POST /skills`. */
+interface SkillCreatePayload {
+    name: string;
+    description: string;
+    content: string;
+}
+/** Payload for `PUT /skills/:id` — only provided fields are applied. */
+interface SkillUpdatePayload {
+    description?: string;
+    content?: string;
+}
+/** Payload for `POST /skills/:id/mappings`. */
+interface SkillMappingCreatePayload {
+    workflowId: string;
+    variant?: string | null;
+    requiredTool?: string | null;
+}
+
 interface CompactionEvent {
     id: number;
     taskId: string;
@@ -730,6 +782,19 @@ declare class OrchestratorAsync {
     getToolCatalog(): Promise<ToolCatalogResult>;
     refreshMCPTools(): Promise<MCPRefreshResult>;
     validateToolCatalog(): Promise<CatalogValidationResult>;
+    listSkills(): Promise<SkillsListResult>;
+    getSkill(skillId: number): Promise<Skill>;
+    createSkill(payload: SkillCreatePayload): Promise<Skill>;
+    updateSkill(skillId: number, payload: SkillUpdatePayload): Promise<Skill>;
+    deleteSkill(skillId: number): Promise<{
+        deleted: boolean;
+        skillId: number;
+    }>;
+    addSkillMapping(skillId: number, payload: SkillMappingCreatePayload): Promise<SkillMapping>;
+    deleteSkillMapping(skillId: number, mappingId: number): Promise<{
+        deleted: boolean;
+        mappingId: number;
+    }>;
     getWorkflowStates(): Promise<WorkflowStates>;
     updateTaskModels(taskId: string, models: {
         agentModelId?: string;
@@ -869,6 +934,19 @@ declare class Orchestrator {
     getToolCatalog(): ToolCatalogResult;
     refreshMCPTools(): MCPRefreshResult;
     validateToolCatalog(): CatalogValidationResult;
+    listSkills(): SkillsListResult;
+    getSkill(skillId: number): Skill;
+    createSkill(payload: Parameters<OrchestratorAsync["createSkill"]>[0]): Skill;
+    updateSkill(skillId: number, payload: Parameters<OrchestratorAsync["updateSkill"]>[1]): Skill;
+    deleteSkill(skillId: number): {
+        deleted: boolean;
+        skillId: number;
+    };
+    addSkillMapping(skillId: number, payload: Parameters<OrchestratorAsync["addSkillMapping"]>[1]): SkillMapping;
+    deleteSkillMapping(skillId: number, mappingId: number): {
+        deleted: boolean;
+        mappingId: number;
+    };
     getWorkflowStates(): WorkflowStates;
     updateTaskModels(taskId: string, models: {
         agentModelId?: string;

package/dist/index.js

@@ -80,6 +80,27 @@ function buildPagination(data) {
     hasPrev: p.hasPrev ?? false
   };
 }
+function buildSkillMapping(m) {
+  return {
+    id: m.id ?? 0,
+    workflowId: m.workflowId ?? m.workflow_id ?? "",
+    variant: m.variant ?? null,
+    requiredTool: m.requiredTool ?? m.required_tool ?? null
+  };
+}
+function buildSkill(s) {
+  return {
+    id: s.id ?? 0,
+    name: s.name ?? "",
+    description: s.description ?? "",
+    content: s.content ?? "",
+    createdAt: s.createdAt ?? s.created_at ?? "",
+    updatedAt: s.updatedAt ?? s.updated_at ?? "",
+    mappings: (s.mappings ?? []).map(
+      (m) => buildSkillMapping(m)
+    )
+  };
+}
 function buildTaskSummary(t) {
   return {
     id: t.id ?? "",
@@ -93,11 +114,23 @@ function buildTaskSummary(t) {
     approvalReason: t.approvalReason ?? "",
     ticketId: t.ticketId ?? null,
     availableTools: t.availableTools ?? null,
+    skills: t.skills ?? null,
     insight: t.insight ?? null,
     insightLocalized: t.insightLocalized ?? null,
     createdAt: t.createdAt ?? "",
     updatedAt: t.updatedAt ?? "",
-    pendingTranslationsForLocales: t.pendingTranslationsForLocales ?? null
+    pendingTranslationsForLocales: t.pendingTranslationsForLocales ?? null,
+    workflowData: t.workflowData ?? null
+  };
+}
+function buildVsaTaskList(data) {
+  const raw = Array.isArray(data) ? data : data.tasks ?? [];
+  const tasks = raw.map(
+    (item) => typeof item === "string" ? { id: item } : buildTaskSummary(item)
+  );
+  return {
+    tasks,
+    pagination: buildPagination(data ?? {})
   };
 }
 function parseApiErrorBody(body, fallbackMessage) {
@@ -772,10 +805,7 @@ var OrchestratorAsync = class {
       limit: params?.limit,
       offset: params?.offset
     });
-    const tasks = (data.tasks ?? []).map(
-      buildTaskSummary
-    );
-    return { tasks, pagination: buildPagination(data) };
+    return buildVsaTaskList(data);
   }
   async searchVSATasks(userId, query, limit) {
     const data = await this._get("/task/vsa/search", {
@@ -783,10 +813,7 @@ var OrchestratorAsync = class {
       query,
       limit
     });
-    const tasks = (data.tasks ?? []).map(
-      buildTaskSummary
-    );
-    return { tasks, pagination: buildPagination(data) };
+    return buildVsaTaskList(data);
   }
   async deleteVSATasksBulk(taskIds) {
     const data = await this._post(
@@ -921,6 +948,63 @@ var OrchestratorAsync = class {
     return this._get("/tools/validate");
   }
   // ------------------------------------------------------------------
+  // Skills
+  // ------------------------------------------------------------------
+  async listSkills() {
+    const data = await this._get("/skills");
+    const skills = (data.skills ?? []).map(
+      (s) => buildSkill(s)
+    );
+    return {
+      skills,
+      total: data.total ?? skills.length
+    };
+  }
+  async getSkill(skillId) {
+    const data = await this._get(`/skills/${skillId}`);
+    return buildSkill(data);
+  }
+  async createSkill(payload) {
+    const data = await this._post("/skills", payload);
+    return buildSkill(data);
+  }
+  async updateSkill(skillId, payload) {
+    const data = await this._put(
+      `/skills/${skillId}`,
+      payload
+    );
+    return buildSkill(data);
+  }
+  async deleteSkill(skillId) {
+    const data = await this._delete(
+      `/skills/${skillId}`
+    );
+    return {
+      deleted: data.deleted ?? false,
+      skillId: data.skillId ?? data.skill_id ?? 0
+    };
+  }
+  async addSkillMapping(skillId, payload) {
+    const data = await this._post(
+      `/skills/${skillId}/mappings`,
+      {
+        workflow_id: payload.workflowId,
+        ...payload.variant ? { variant: payload.variant } : {},
+        ...payload.requiredTool ? { required_tool: payload.requiredTool } : {}
+      }
+    );
+    return buildSkillMapping(data);
+  }
+  async deleteSkillMapping(skillId, mappingId) {
+    const data = await this._delete(
+      `/skills/${skillId}/mappings/${mappingId}`
+    );
+    return {
+      deleted: data.deleted ?? false,
+      mappingId: data.mappingId ?? data.mapping_id ?? 0
+    };
+  }
+  // ------------------------------------------------------------------
   // Debug / Admin
   // ------------------------------------------------------------------
   async getWorkflowStates() {
@@ -1521,6 +1605,27 @@ var Orchestrator = class {
   validateToolCatalog() {
     return runSync(this._async.validateToolCatalog());
   }
+  listSkills() {
+    return runSync(this._async.listSkills());
+  }
+  getSkill(skillId) {
+    return runSync(this._async.getSkill(skillId));
+  }
+  createSkill(payload) {
+    return runSync(this._async.createSkill(payload));
+  }
+  updateSkill(skillId, payload) {
+    return runSync(this._async.updateSkill(skillId, payload));
+  }
+  deleteSkill(skillId) {
+    return runSync(this._async.deleteSkill(skillId));
+  }
+  addSkillMapping(skillId, payload) {
+    return runSync(this._async.addSkillMapping(skillId, payload));
+  }
+  deleteSkillMapping(skillId, mappingId) {
+    return runSync(this._async.deleteSkillMapping(skillId, mappingId));
+  }
   // ------------------------------------------------------------------
   // Debug / Admin
   // ------------------------------------------------------------------