orchestrator-client 5.11.7 → 5.12.2

package/dist/index.d.cts

@@ -1,3 +1,38 @@
+/** A single profile/memory entry (decrypted content). */
+interface ProfileEntry {
+    id: number;
+    docType: "profile" | "memory";
+    content: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Result of `GET /profiles/{userId}/entries`. */
+interface ProfileEntryListResult {
+    entries: ProfileEntry[];
+    total: number;
+}
+/** Payload for `POST /profiles/{userId}/entries`. */
+interface ProfileEntryCreatePayload {
+    docType: "profile" | "memory";
+    content: string;
+}
+/** Per-entry length in a usage listing. */
+interface ProfileUsageEntry {
+    id: number;
+    length: number;
+}
+/** Result of `GET /profiles/{userId}/usage`. */
+interface ProfileUsageResult {
+    usedChars: number;
+    maxChars: number;
+    entries: ProfileUsageEntry[];
+}
+/** Result of `DELETE /profiles/{userId}/entries/{entryId}`. */
+interface ProfileEntryDeleteResult {
+    deleted: boolean;
+    entryId: number;
+}
+
 interface Pagination$1 {
     currentPage: number;
     perPage: number;
@@ -29,10 +64,11 @@ interface TaskSummary {
     approvalReason: string;
     ticketId: string | null;
     availableTools: string[] | null;
-    /** Resolved skill references (name + description snapshot) at creation. */
+    /** Resolved skill references (name + description + user_id snapshot) at creation; user_id is null for system skills. */
     skills: {
         name: string;
         description: string;
+        user_id: string | null;
     }[] | null;
     insight: string | null;
     insightLocalized: string | null;
@@ -49,6 +85,7 @@ interface TaskSummary {
 interface TaskOptions {
     disableSummaries: boolean;
     disableTranslation: boolean;
+    disableStreaming?: boolean;
 }
 /** Full task status including fields returned by GET /task/status. */
 interface TaskDetail extends TaskSummary {
@@ -482,6 +519,8 @@ interface SkillMapping {
 interface Skill {
     id: number;
     name: string;
+    /** Owner: null = system skill, set = personal skill. */
+    user_id: string | null;
     description: string;
     content: string;
     createdAt: string;
@@ -788,6 +827,23 @@ declare class OrchestratorAsync {
         deleted: boolean;
         mappingId: number;
     }>;
+    listPersonalSkills(userId: string): Promise<SkillsListResult>;
+    createPersonalSkill(userId: string, payload: SkillCreatePayload): Promise<Skill>;
+    updatePersonalSkill(userId: string, skillName: string, payload: SkillUpdatePayload): Promise<Skill>;
+    deletePersonalSkill(userId: string, skillName: string): Promise<{
+        deleted: boolean;
+        skillId: number;
+    }>;
+    listProfileUsers(params?: {
+        query?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<string[]>;
+    listProfileEntries(userId: string, docType?: "profile" | "memory"): Promise<ProfileEntryListResult>;
+    getProfileUsage(userId: string, docType?: "profile" | "memory"): Promise<ProfileUsageResult>;
+    createProfileEntry(userId: string, payload: ProfileEntryCreatePayload): Promise<ProfileEntry>;
+    replaceProfileEntry(userId: string, entryId: number, content: string): Promise<ProfileEntry>;
+    deleteProfileEntry(userId: string, entryId: number): Promise<ProfileEntryDeleteResult>;
     getWorkflowStates(): Promise<WorkflowStates>;
     updateTaskModels(taskId: string, models: {
         agentModelId?: string;
@@ -933,6 +989,19 @@ declare class Orchestrator {
         deleted: boolean;
         mappingId: number;
     };
+    listPersonalSkills(userId: string): SkillsListResult;
+    createPersonalSkill(userId: string, payload: Parameters<OrchestratorAsync["createPersonalSkill"]>[1]): Skill;
+    updatePersonalSkill(userId: string, skillName: string, payload: Parameters<OrchestratorAsync["updatePersonalSkill"]>[2]): Skill;
+    deletePersonalSkill(userId: string, skillName: string): {
+        deleted: boolean;
+        skillId: number;
+    };
+    listProfileUsers(params?: Parameters<OrchestratorAsync["listProfileUsers"]>[0]): string[];
+    listProfileEntries(userId: string, docType?: "profile" | "memory"): ProfileEntryListResult;
+    getProfileUsage(userId: string, docType?: "profile" | "memory"): ProfileUsageResult;
+    createProfileEntry(userId: string, payload: Parameters<OrchestratorAsync["createProfileEntry"]>[1]): ProfileEntry;
+    replaceProfileEntry(userId: string, entryId: number, content: string): ProfileEntry;
+    deleteProfileEntry(userId: string, entryId: number): ProfileEntryDeleteResult;
     getWorkflowStates(): WorkflowStates;
     updateTaskModels(taskId: string, models: {
         agentModelId?: string;
@@ -1399,7 +1468,7 @@ declare abstract class Flow<T> {
     get availableTools(): string[] | undefined;
     /**
      * Per-task feature toggles sent in the creation request.
-     * By default summaries and translation are disabled since flow
+     * By default summaries, translation and streaming are disabled since flow
      * output is typically machine-consumed, not human-read.
      * Override in subclasses that produce human-facing content.
      */

package/dist/index.d.ts

@@ -1,3 +1,38 @@
+/** A single profile/memory entry (decrypted content). */
+interface ProfileEntry {
+    id: number;
+    docType: "profile" | "memory";
+    content: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Result of `GET /profiles/{userId}/entries`. */
+interface ProfileEntryListResult {
+    entries: ProfileEntry[];
+    total: number;
+}
+/** Payload for `POST /profiles/{userId}/entries`. */
+interface ProfileEntryCreatePayload {
+    docType: "profile" | "memory";
+    content: string;
+}
+/** Per-entry length in a usage listing. */
+interface ProfileUsageEntry {
+    id: number;
+    length: number;
+}
+/** Result of `GET /profiles/{userId}/usage`. */
+interface ProfileUsageResult {
+    usedChars: number;
+    maxChars: number;
+    entries: ProfileUsageEntry[];
+}
+/** Result of `DELETE /profiles/{userId}/entries/{entryId}`. */
+interface ProfileEntryDeleteResult {
+    deleted: boolean;
+    entryId: number;
+}
+
 interface Pagination$1 {
     currentPage: number;
     perPage: number;
@@ -29,10 +64,11 @@ interface TaskSummary {
     approvalReason: string;
     ticketId: string | null;
     availableTools: string[] | null;
-    /** Resolved skill references (name + description snapshot) at creation. */
+    /** Resolved skill references (name + description + user_id snapshot) at creation; user_id is null for system skills. */
     skills: {
         name: string;
         description: string;
+        user_id: string | null;
     }[] | null;
     insight: string | null;
     insightLocalized: string | null;
@@ -49,6 +85,7 @@ interface TaskSummary {
 interface TaskOptions {
     disableSummaries: boolean;
     disableTranslation: boolean;
+    disableStreaming?: boolean;
 }
 /** Full task status including fields returned by GET /task/status. */
 interface TaskDetail extends TaskSummary {
@@ -482,6 +519,8 @@ interface SkillMapping {
 interface Skill {
     id: number;
     name: string;
+    /** Owner: null = system skill, set = personal skill. */
+    user_id: string | null;
     description: string;
     content: string;
     createdAt: string;
@@ -788,6 +827,23 @@ declare class OrchestratorAsync {
         deleted: boolean;
         mappingId: number;
     }>;
+    listPersonalSkills(userId: string): Promise<SkillsListResult>;
+    createPersonalSkill(userId: string, payload: SkillCreatePayload): Promise<Skill>;
+    updatePersonalSkill(userId: string, skillName: string, payload: SkillUpdatePayload): Promise<Skill>;
+    deletePersonalSkill(userId: string, skillName: string): Promise<{
+        deleted: boolean;
+        skillId: number;
+    }>;
+    listProfileUsers(params?: {
+        query?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<string[]>;
+    listProfileEntries(userId: string, docType?: "profile" | "memory"): Promise<ProfileEntryListResult>;
+    getProfileUsage(userId: string, docType?: "profile" | "memory"): Promise<ProfileUsageResult>;
+    createProfileEntry(userId: string, payload: ProfileEntryCreatePayload): Promise<ProfileEntry>;
+    replaceProfileEntry(userId: string, entryId: number, content: string): Promise<ProfileEntry>;
+    deleteProfileEntry(userId: string, entryId: number): Promise<ProfileEntryDeleteResult>;
     getWorkflowStates(): Promise<WorkflowStates>;
     updateTaskModels(taskId: string, models: {
         agentModelId?: string;
@@ -933,6 +989,19 @@ declare class Orchestrator {
         deleted: boolean;
         mappingId: number;
     };
+    listPersonalSkills(userId: string): SkillsListResult;
+    createPersonalSkill(userId: string, payload: Parameters<OrchestratorAsync["createPersonalSkill"]>[1]): Skill;
+    updatePersonalSkill(userId: string, skillName: string, payload: Parameters<OrchestratorAsync["updatePersonalSkill"]>[2]): Skill;
+    deletePersonalSkill(userId: string, skillName: string): {
+        deleted: boolean;
+        skillId: number;
+    };
+    listProfileUsers(params?: Parameters<OrchestratorAsync["listProfileUsers"]>[0]): string[];
+    listProfileEntries(userId: string, docType?: "profile" | "memory"): ProfileEntryListResult;
+    getProfileUsage(userId: string, docType?: "profile" | "memory"): ProfileUsageResult;
+    createProfileEntry(userId: string, payload: Parameters<OrchestratorAsync["createProfileEntry"]>[1]): ProfileEntry;
+    replaceProfileEntry(userId: string, entryId: number, content: string): ProfileEntry;
+    deleteProfileEntry(userId: string, entryId: number): ProfileEntryDeleteResult;
     getWorkflowStates(): WorkflowStates;
     updateTaskModels(taskId: string, models: {
         agentModelId?: string;
@@ -1399,7 +1468,7 @@ declare abstract class Flow<T> {
     get availableTools(): string[] | undefined;
     /**
      * Per-task feature toggles sent in the creation request.
-     * By default summaries and translation are disabled since flow
+     * By default summaries, translation and streaming are disabled since flow
      * output is typically machine-consumed, not human-read.
      * Override in subclasses that produce human-facing content.
      */

package/dist/index.js

@@ -80,6 +80,12 @@ function buildPagination(data) {
     hasPrev: p.hasPrev ?? false
   };
 }
+function toSnakeCaseOptions(options) {
+  if (!options) return options;
+  return Object.fromEntries(
+    Object.entries(options).map(([key, value]) => [camelToSnake(key), value])
+  );
+}
 function buildSkillMapping(m) {
   return {
     id: m.id ?? 0,
@@ -88,10 +94,20 @@ function buildSkillMapping(m) {
     requiredTool: m.requiredTool ?? m.required_tool ?? null
   };
 }
+function buildProfileEntry(e) {
+  return {
+    id: e.id ?? 0,
+    docType: e.docType ?? e.doc_type ?? "memory",
+    content: e.content ?? "",
+    createdAt: e.createdAt ?? e.created_at ?? "",
+    updatedAt: e.updatedAt ?? e.updated_at ?? ""
+  };
+}
 function buildSkill(s) {
   return {
     id: s.id ?? 0,
     name: s.name ?? "",
+    user_id: s.userId ?? s.user_id ?? null,
     description: s.description ?? "",
     content: s.content ?? "",
     createdAt: s.createdAt ?? s.created_at ?? "",
@@ -412,7 +428,7 @@ var OrchestratorAsync = class {
       orchestrator_model_id: params.orchestratorModelId,
       available_tools: params.availableTools,
       attachment_ids: params.attachmentIds,
-      options: params.options
+      options: toSnakeCaseOptions(params.options)
     });
     return {
       taskId: data.taskId ?? data.task_id ?? "",
@@ -730,7 +746,7 @@ var OrchestratorAsync = class {
       orchestrator_model_id: params.orchestratorModelId,
       available_tools: params.availableTools,
       attachment_ids: params.attachmentIds,
-      options: params.options
+      options: toSnakeCaseOptions(params.options)
     };
     if (params.delegatedToken !== void 0) {
       body.delegated_token = params.delegatedToken;
@@ -927,6 +943,105 @@ var OrchestratorAsync = class {
     };
   }
   // ------------------------------------------------------------------
+  // Personal skills (#789) — per-user ownership
+  // ------------------------------------------------------------------
+  async listPersonalSkills(userId) {
+    const data = await this._get(
+      `/profiles/${userId}/skills`
+    );
+    const skills = (data.skills ?? []).map(
+      (s) => buildSkill(s)
+    );
+    return {
+      skills,
+      total: data.total ?? skills.length
+    };
+  }
+  async createPersonalSkill(userId, payload) {
+    const data = await this._post(
+      `/profiles/${userId}/skills`,
+      payload
+    );
+    return buildSkill(data);
+  }
+  async updatePersonalSkill(userId, skillName, payload) {
+    const data = await this._put(
+      `/profiles/${userId}/skills/${skillName}`,
+      payload
+    );
+    return buildSkill(data);
+  }
+  async deletePersonalSkill(userId, skillName) {
+    const data = await this._delete(
+      `/profiles/${userId}/skills/${skillName}`
+    );
+    return {
+      deleted: data.deleted ?? false,
+      skillId: data.skillId ?? data.skill_id ?? 0
+    };
+  }
+  // ------------------------------------------------------------------
+  // Profile/memory entries (#788)
+  // ------------------------------------------------------------------
+  async listProfileUsers(params) {
+    const data = await this._get("/profiles/users", {
+      query: params?.query,
+      limit: params?.limit,
+      offset: params?.offset
+    });
+    return data ?? [];
+  }
+  async listProfileEntries(userId, docType) {
+    const data = await this._get(
+      `/profiles/${userId}/entries`,
+      docType ? { doc_type: docType } : void 0
+    );
+    const entries = (data.entries ?? []).map(
+      (e) => buildProfileEntry(e)
+    );
+    return {
+      entries,
+      total: data.total ?? entries.length
+    };
+  }
+  async getProfileUsage(userId, docType = "profile") {
+    const data = await this._get(`/profiles/${userId}/usage`, { doc_type: docType });
+    return {
+      usedChars: data.usedChars ?? 0,
+      maxChars: data.maxChars ?? 0,
+      entries: (data.entries ?? []).map(
+        (e) => ({
+          id: e.id ?? 0,
+          length: e.length ?? 0
+        })
+      )
+    };
+  }
+  async createProfileEntry(userId, payload) {
+    const data = await this._post(
+      `/profiles/${userId}/entries`,
+      { doc_type: payload.docType, content: payload.content }
+    );
+    return buildProfileEntry(data);
+  }
+  async replaceProfileEntry(userId, entryId, content) {
+    const data = await this._request(
+      "PATCH",
+      `/profiles/${userId}/entries/${entryId}`,
+      { jsonBody: { content } }
+    );
+    return buildProfileEntry(data);
+  }
+  async deleteProfileEntry(userId, entryId) {
+    const data = await this._delete(
+      `/profiles/${userId}/entries/${entryId}`
+    );
+    return {
+      deleted: data.deleted ?? false,
+      entryId: data.entryId ?? data.entry_id ?? 0
+    };
+  }
+  // ------------------------------------------------------------------
   // Debug / Admin
   // ------------------------------------------------------------------
   async getWorkflowStates() {
@@ -1551,6 +1666,36 @@ var Orchestrator = class {
   deleteSkillMapping(skillId, mappingId) {
     return runSync(this._async.deleteSkillMapping(skillId, mappingId));
   }
+  listPersonalSkills(userId) {
+    return runSync(this._async.listPersonalSkills(userId));
+  }
+  createPersonalSkill(userId, payload) {
+    return runSync(this._async.createPersonalSkill(userId, payload));
+  }
+  updatePersonalSkill(userId, skillName, payload) {
+    return runSync(this._async.updatePersonalSkill(userId, skillName, payload));
+  }
+  deletePersonalSkill(userId, skillName) {
+    return runSync(this._async.deletePersonalSkill(userId, skillName));
+  }
+  listProfileUsers(params) {
+    return runSync(this._async.listProfileUsers(params));
+  }
+  listProfileEntries(userId, docType) {
+    return runSync(this._async.listProfileEntries(userId, docType));
+  }
+  getProfileUsage(userId, docType = "profile") {
+    return runSync(this._async.getProfileUsage(userId, docType));
+  }
+  createProfileEntry(userId, payload) {
+    return runSync(this._async.createProfileEntry(userId, payload));
+  }
+  replaceProfileEntry(userId, entryId, content) {
+    return runSync(this._async.replaceProfileEntry(userId, entryId, content));
+  }
+  deleteProfileEntry(userId, entryId) {
+    return runSync(this._async.deleteProfileEntry(userId, entryId));
+  }
   // ------------------------------------------------------------------
   // Debug / Admin
   // ------------------------------------------------------------------
@@ -2272,12 +2417,16 @@ var Flow = class {
   }
   /**
    * Per-task feature toggles sent in the creation request.
-   * By default summaries and translation are disabled since flow
+   * By default summaries, translation and streaming are disabled since flow
    * output is typically machine-consumed, not human-read.
    * Override in subclasses that produce human-facing content.
    */
   get taskOptions() {
-    return { disableSummaries: true, disableTranslation: true };
+    return {
+      disableSummaries: true,
+      disableTranslation: true,
+      disableStreaming: true
+    };
   }
   /**
    * Override the agent model for this flow.