@getmodus/sdk 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { c as components, H as HttpClient, M as ModusConfig, P as Page, A as AgentType, V as VariationView, a as Agent, C as ContextItem, b as ContextItemLookupRow, d as CustomContextItemsResource, e as ConversationKind, f as ConversationListItem, g as Conversation, S as ScopeConversationsResource, h as Skill, i as ModusClientBase, j as ModusOptions } from './conversations-DoyTcWk6.cjs';
-export { k as ContextType, l as Message, O as OPERATIONS, m as OperationId, n as OperationSpec, o as SkillStatus, p as SkillVariation, q as conversationSkillId, r as operations, s as paths } from './conversations-DoyTcWk6.cjs';
+import { c as components, H as HttpClient, M as ModusConfig, P as Page, A as AgentType, V as VariationView, a as Agent, C as ContextItem, b as ContextItemLookupRow, d as CustomContextItemsResource, e as ConversationKind, f as ConversationListItem, g as Conversation, S as ScopeConversationsResource, h as Skill, i as ModusClientBase, j as ModusOptions } from './conversations-BP2sI3Q5.cjs';
+export { k as ContextType, l as Message, O as OPERATIONS, m as OperationId, n as OperationSpec, o as SkillStatus, p as SkillVariation, q as conversationSkillId, r as operations, s as paths } from './conversations-BP2sI3Q5.cjs';
 
 declare class ModusError extends Error {
     readonly statusCode?: number;
@@ -100,9 +100,10 @@ declare class ChatStream {
     private readonly http;
     private readonly path;
     private readonly body;
+    private readonly baseUrl?;
     private final?;
     private readonly textParts;
-    constructor(http: HttpClient, path: string, body: Record<string, unknown>);
+    constructor(http: HttpClient, path: string, body: Record<string, unknown>, baseUrl?: string | undefined);
     textStream(): AsyncGenerator<string>;
     eventStream(): AsyncGenerator<RunEvent>;
     private events;
@@ -124,7 +125,7 @@ type RunStatus = 'running' | 'awaiting_human' | 'completed' | 'error' | 'cancell
 type RunTimeframe = 'last_hour' | 'last_day' | 'last_week' | (string & {});
 type ApprovalScope = 'mine' | 'all' | (string & {});
 
-interface AgentRunStream {
+interface AgentRunStream extends AsyncIterable<RunEvent> {
     readonly runId: string;
     readonly events: AsyncIterable<RunEvent>;
 }
@@ -146,16 +147,16 @@ declare class WorkflowRunsResource {
     }): Promise<AgentRun>;
     create(workflowId: number | string, body: CreateAgentRunRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     createScope(scopeId: number | string, body: SkillRunCreateRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     createModus(body: ModusRunCreateRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     resume(runId: string, body: ResumeRunRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     cancel(runId: string): Promise<void>;
     events(runId: string): Promise<unknown>;
     interrupt(runId: string): Promise<void>;
@@ -186,7 +187,12 @@ type ModusContextRequest = components['schemas']['ModusContextRequestDto'];
 type SuggestionQuestion = components['schemas']['SuggestionQuestionDto'];
 type SuggestionEventType = components['schemas']['SuggestionEventType'];
 type SuggestionEventSource = components['schemas']['SuggestionEventSource'];
-type RecordSuggestionEventRequest = components['schemas']['RecordSuggestionEventDto'];
+/** Wire format (snake_case) plus camelCase aliases for DX. */
+type RecordSuggestionEventRequest = components['schemas']['RecordSuggestionEventDto'] & {
+    eventType?: components['schemas']['SuggestionEventType'];
+    skillId?: number;
+    threadId?: string;
+};
 
 declare class AgentWorkflowActionsResource {
     private readonly http;
@@ -194,7 +200,7 @@ declare class AgentWorkflowActionsResource {
     constructor(http: HttpClient, config: ModusConfig);
     execute(body: WorkflowActionRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     cancel(runId: string): Promise<void>;
     private parseEvents;
 }
@@ -219,6 +225,15 @@ declare class WorkflowsResource {
         view?: VariationView;
         includeVariation?: boolean;
     }): Promise<Agent>;
+    chat(workflowId: number | string, message: string, options: {
+        model: ChatModel;
+        threadId?: string;
+    }): Promise<ChatResult>;
+    chatStream(workflowId: number | string, message: string, options: {
+        model: ChatModel;
+        threadId?: string;
+        version?: string;
+    }): ChatStream;
 }
 
 declare class ConnectionsResource {
@@ -334,6 +349,7 @@ declare class ScopesResource {
     chatStream(scopeId: number | string, message: string, options: {
         model: ChatModel;
         threadId?: string;
+        version?: string;
     }): ChatStream;
 }
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { c as components, H as HttpClient, M as ModusConfig, P as Page, A as AgentType, V as VariationView, a as Agent, C as ContextItem, b as ContextItemLookupRow, d as CustomContextItemsResource, e as ConversationKind, f as ConversationListItem, g as Conversation, S as ScopeConversationsResource, h as Skill, i as ModusClientBase, j as ModusOptions } from './conversations-DoyTcWk6.js';
-export { k as ContextType, l as Message, O as OPERATIONS, m as OperationId, n as OperationSpec, o as SkillStatus, p as SkillVariation, q as conversationSkillId, r as operations, s as paths } from './conversations-DoyTcWk6.js';
+import { c as components, H as HttpClient, M as ModusConfig, P as Page, A as AgentType, V as VariationView, a as Agent, C as ContextItem, b as ContextItemLookupRow, d as CustomContextItemsResource, e as ConversationKind, f as ConversationListItem, g as Conversation, S as ScopeConversationsResource, h as Skill, i as ModusClientBase, j as ModusOptions } from './conversations-BP2sI3Q5.js';
+export { k as ContextType, l as Message, O as OPERATIONS, m as OperationId, n as OperationSpec, o as SkillStatus, p as SkillVariation, q as conversationSkillId, r as operations, s as paths } from './conversations-BP2sI3Q5.js';
 
 declare class ModusError extends Error {
     readonly statusCode?: number;
@@ -100,9 +100,10 @@ declare class ChatStream {
     private readonly http;
     private readonly path;
     private readonly body;
+    private readonly baseUrl?;
     private final?;
     private readonly textParts;
-    constructor(http: HttpClient, path: string, body: Record<string, unknown>);
+    constructor(http: HttpClient, path: string, body: Record<string, unknown>, baseUrl?: string | undefined);
     textStream(): AsyncGenerator<string>;
     eventStream(): AsyncGenerator<RunEvent>;
     private events;
@@ -124,7 +125,7 @@ type RunStatus = 'running' | 'awaiting_human' | 'completed' | 'error' | 'cancell
 type RunTimeframe = 'last_hour' | 'last_day' | 'last_week' | (string & {});
 type ApprovalScope = 'mine' | 'all' | (string & {});
 
-interface AgentRunStream {
+interface AgentRunStream extends AsyncIterable<RunEvent> {
     readonly runId: string;
     readonly events: AsyncIterable<RunEvent>;
 }
@@ -146,16 +147,16 @@ declare class WorkflowRunsResource {
     }): Promise<AgentRun>;
     create(workflowId: number | string, body: CreateAgentRunRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     createScope(scopeId: number | string, body: SkillRunCreateRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     createModus(body: ModusRunCreateRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     resume(runId: string, body: ResumeRunRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     cancel(runId: string): Promise<void>;
     events(runId: string): Promise<unknown>;
     interrupt(runId: string): Promise<void>;
@@ -186,7 +187,12 @@ type ModusContextRequest = components['schemas']['ModusContextRequestDto'];
 type SuggestionQuestion = components['schemas']['SuggestionQuestionDto'];
 type SuggestionEventType = components['schemas']['SuggestionEventType'];
 type SuggestionEventSource = components['schemas']['SuggestionEventSource'];
-type RecordSuggestionEventRequest = components['schemas']['RecordSuggestionEventDto'];
+/** Wire format (snake_case) plus camelCase aliases for DX. */
+type RecordSuggestionEventRequest = components['schemas']['RecordSuggestionEventDto'] & {
+    eventType?: components['schemas']['SuggestionEventType'];
+    skillId?: number;
+    threadId?: string;
+};
 
 declare class AgentWorkflowActionsResource {
     private readonly http;
@@ -194,7 +200,7 @@ declare class AgentWorkflowActionsResource {
     constructor(http: HttpClient, config: ModusConfig);
     execute(body: WorkflowActionRequest, options?: {
         idempotencyKey?: string;
-    }): Promise<AgentRunStream>;
+    }): AgentRunStream;
     cancel(runId: string): Promise<void>;
     private parseEvents;
 }
@@ -219,6 +225,15 @@ declare class WorkflowsResource {
         view?: VariationView;
         includeVariation?: boolean;
     }): Promise<Agent>;
+    chat(workflowId: number | string, message: string, options: {
+        model: ChatModel;
+        threadId?: string;
+    }): Promise<ChatResult>;
+    chatStream(workflowId: number | string, message: string, options: {
+        model: ChatModel;
+        threadId?: string;
+        version?: string;
+    }): ChatStream;
 }
 
 declare class ConnectionsResource {
@@ -334,6 +349,7 @@ declare class ScopesResource {
     chatStream(scopeId: number | string, message: string, options: {
         model: ChatModel;
         threadId?: string;
+        version?: string;
     }): ChatStream;
 }
 

package/dist/index.js

@@ -29,7 +29,14 @@ import {
   validateChatModel,
   validateId,
   validatePageSize
-} from "./chunk-UOBVSNOW.js";
+} from "./chunk-ZFZQ2UMA.js";
+
+// src/_agent_run_request.ts
+import { randomUUID } from "crypto";
+function resolveAgentRunSessionId(sessionId) {
+  if (typeof sessionId === "string" && sessionId.trim()) return sessionId.trim();
+  return randomUUID();
+}
 
 // src/_streaming.ts
 var SILENTLY_IGNORED = /* @__PURE__ */ new Set([
@@ -121,28 +128,48 @@ function effectiveThreadId(threadId) {
   if (!threadId.trim()) return void 0;
   return threadId;
 }
+function resolveSessionId(threadId) {
+  return resolveAgentRunSessionId(effectiveThreadId(threadId));
+}
 function chatPath(resource, resourceId, options) {
   const safeId = encodeURIComponent(String(resourceId));
-  const suffix = options.stream ? "/stream" : "";
   const tid = effectiveThreadId(options.threadId);
   if (tid !== void 0) {
     const safeTid = encodeURIComponent(tid);
-    return `/api/v1/${resource}/${safeId}/conversations/${safeTid}/chat${suffix}`;
+    return `/api/v1/${resource}/${safeId}/conversations/${safeTid}/chat`;
   }
-  return `/api/v1/${resource}/${safeId}/chat${suffix}`;
+  return `/api/v1/${resource}/${safeId}/chat`;
 }
 function modusChatPath(options) {
-  const suffix = options.stream ? "/stream" : "";
   const tid = effectiveThreadId(options.threadId);
   if (tid !== void 0) {
     validateId(tid, "thread_id");
-    return `/api/v1/modus/conversations/${encodeURIComponent(tid)}/chat${suffix}`;
+    return `/api/v1/modus/conversations/${encodeURIComponent(tid)}/chat`;
   }
-  return `/api/v1/modus/chat${suffix}`;
+  return `/api/v1/modus/chat`;
+}
+function agentHostRunsPath(resource, resourceId) {
+  if (resource === "modus") return "/agent/v1/modus/runs";
+  const safeId = encodeURIComponent(String(resourceId));
+  return `/agent/v1/${resource}/${safeId}/runs`;
 }
 function chatBody(message, model) {
   return { message, model };
 }
+function agentRunsBody(message, model, options) {
+  const body = {
+    message,
+    config: { model },
+    sessionId: options.sessionId
+  };
+  if (options.organizationId !== void 0) {
+    body.organizationId = options.organizationId;
+  }
+  if (options.version !== void 0) {
+    body.version = options.version;
+  }
+  return body;
+}
 function raiseForEvent(event) {
   if (event.type === "error") throw new ModusError(event.message);
   if (event.type === "cancelled") throw new RunCancelledError();
@@ -150,10 +177,11 @@ function raiseForEvent(event) {
   return event;
 }
 var ChatStream = class {
-  constructor(http, path, body) {
+  constructor(http, path, body, baseUrl) {
     this.http = http;
     this.path = path;
     this.body = body;
+    this.baseUrl = baseUrl;
     this.textParts = [];
   }
   async *textStream() {
@@ -166,7 +194,9 @@ var ChatStream = class {
   }
   async *events(supportsReset) {
     const body = supportsReset ? { ...this.body, streamProtocolVersion: 2 } : this.body;
-    for await (const line of this.http.streamPost(this.path, body)) {
+    for await (const line of this.http.streamPost(this.path, body, {
+      baseUrl: this.baseUrl
+    })) {
       for (const event of parseSseStream([line])) {
         const normalized = raiseForEvent(event);
         if (normalized.type === "token") this.textParts.push(normalized.content);
@@ -200,39 +230,58 @@ async function chatBuffered(http, resource, resourceId, message, options) {
   validateId(resourceId, `${resource}_id`);
   validateChatModel(options.model);
   const path = chatPath(resource, resourceId, {
-    threadId: options.threadId,
-    stream: false
+    threadId: options.threadId
   });
   const data = await http.post(path, chatBody(message, options.model));
   return data;
 }
-function chatStreamSession(http, resource, resourceId, message, options) {
+function chatStreamSession(http, config, resource, resourceId, message, options) {
   validateId(resourceId, `${resource}_id`);
   validateChatModel(options.model);
-  const path = chatPath(resource, resourceId, {
-    threadId: options.threadId,
-    stream: true
-  });
-  return new ChatStream(http, path, chatBody(message, options.model));
+  const path = agentHostRunsPath(resource, resourceId);
+  return new ChatStream(
+    http,
+    path,
+    agentRunsBody(message, options.model, {
+      sessionId: resolveSessionId(options.threadId),
+      organizationId: config.organizationId,
+      version: options.version
+    }),
+    config.agentHost
+  );
 }
 async function modusChatBuffered(http, message, options) {
   validateChatModel(options.model);
-  const path = modusChatPath({ threadId: options.threadId, stream: false });
+  const path = modusChatPath({ threadId: options.threadId });
   const data = await http.post(path, chatBody(message, options.model));
   return data;
 }
-function modusChatStreamSession(http, message, options) {
+function modusChatStreamSession(http, config, message, options) {
   validateChatModel(options.model);
-  const path = modusChatPath({ threadId: options.threadId, stream: true });
-  return new ChatStream(http, path, chatBody(message, options.model));
+  return new ChatStream(
+    http,
+    agentHostRunsPath("modus"),
+    agentRunsBody(message, options.model, {
+      sessionId: resolveSessionId(options.threadId),
+      organizationId: config.organizationId
+    }),
+    config.agentHost
+  );
 }
 
+// src/types/agents.ts
+var AgentType = {
+  task: "task",
+  workflow: "workflow"
+};
+
 // src/types/conversations.ts
 function conversationSkillId(item) {
   return item.skillId === 0 ? void 0 : item.skillId;
 }
 
 // src/resources/agents/runs.ts
+import { randomUUID as randomUUID2 } from "crypto";
 var RUNS_MAX_PAGE_SIZE = 100;
 function runsListParams(pageSize, pageToken, status, timeframe, approvalScope, search) {
   const params = { pageSize };
@@ -280,7 +329,19 @@ function parseActiveRunsPage(raw, fetchPage) {
   );
 }
 function randomRunId() {
-  return crypto.randomUUID();
+  return randomUUID2();
+}
+function sessionIdFromBody(body) {
+  return resolveAgentRunSessionId(body.sessionId);
+}
+function makeAgentRunStream(runId, events) {
+  return {
+    runId,
+    events,
+    [Symbol.asyncIterator]() {
+      return events[Symbol.asyncIterator]();
+    }
+  };
 }
 var WorkflowRunsResource = class {
   constructor(http, config) {
@@ -331,18 +392,18 @@ var WorkflowRunsResource = class {
     });
     return parseRun(data);
   }
-  async create(workflowId, body, options = {}) {
+  create(workflowId, body, options = {}) {
     validateId(workflowId, "workflow_id");
     return this.createRun("WorkflowRunsController_create", body, { id: workflowId }, options);
   }
-  async createScope(scopeId, body, options = {}) {
+  createScope(scopeId, body, options = {}) {
     validateId(scopeId, "scope_id");
     return this.createRun("ScopeRunsController_create", body, { id: scopeId }, options);
   }
-  async createModus(body, options = {}) {
+  createModus(body, options = {}) {
     return this.createRun("ModusRunsController_create", body, {}, options);
   }
-  async resume(runId, body, options = {}) {
+  resume(runId, body, options = {}) {
     validateId(runId, "run_id");
     return this.createRun("ResumeRunsController_create", body, { runId }, options);
   }
@@ -405,20 +466,22 @@ var WorkflowRunsResource = class {
       baseUrl: operationBaseUrl(this.http, op),
       headers: options.lastEventId ? { "Last-Event-ID": options.lastEventId } : void 0
     });
-    return { runId, events: this.parseEvents(lines) };
+    return makeAgentRunStream(runId, this.parseEvents(lines));
   }
   createRun(operationId, body, pathParams, options) {
     const runId = options.idempotencyKey?.trim() || body.runId?.trim() || randomRunId();
+    const sessionId = sessionIdFromBody(body);
     const op = getOperation(operationId);
     const path = formatOperationPath(operationId, pathParams);
     const lines = this.http.streamPost(path, {
       ...body,
+      sessionId,
       streamProtocolVersion: 2
     }, {
       baseUrl: operationBaseUrl(this.http, op),
       headers: { "Idempotency-Key": runId }
     });
-    return { runId, events: this.parseEvents(lines) };
+    return makeAgentRunStream(runId, this.parseEvents(lines));
   }
   async *parseEvents(lines) {
     yield* parseSseStream(lines);
@@ -426,15 +489,16 @@ var WorkflowRunsResource = class {
 };
 
 // src/resources/agents/workflow-actions.ts
+import { randomUUID as randomUUID3 } from "crypto";
 function randomRunId2() {
-  return crypto.randomUUID();
+  return randomUUID3();
 }
 var AgentWorkflowActionsResource = class {
   constructor(http, config) {
     this.http = http;
     this.config = config;
   }
-  async execute(body, options = {}) {
+  execute(body, options = {}) {
     const runId = options.idempotencyKey?.trim() || body.runId?.trim() || randomRunId2();
     const op = getOperation("WorkflowActionsController_execute");
     const path = formatOperationPath("WorkflowActionsController_execute");
@@ -442,7 +506,7 @@ var AgentWorkflowActionsResource = class {
       baseUrl: operationBaseUrl(this.http, op),
       headers: { "Idempotency-Key": runId }
     });
-    return { runId, events: this.parseEvents(lines) };
+    return makeAgentRunStream(runId, this.parseEvents(lines));
   }
   async cancel(runId) {
     validateId(runId, "run_id");
@@ -520,6 +584,12 @@ var WorkflowsResource = class {
     });
     return parseWorkflow(data);
   }
+  chat(workflowId, message, options) {
+    return chatBuffered(this.http, "workflows", workflowId, message, options);
+  }
+  chatStream(workflowId, message, options) {
+    return chatStreamSession(this.http, this.config, "workflows", workflowId, message, options);
+  }
 };
 
 // src/resources/connections.ts
@@ -736,7 +806,7 @@ var ModusResource = class {
     return modusChatBuffered(this.http, message, options);
   }
   chatStream(message, options) {
-    return modusChatStreamSession(this.http, message, options);
+    return modusChatStreamSession(this.http, this.config, message, options);
   }
 };
 
@@ -804,10 +874,28 @@ var ScopesResource = class {
     return chatBuffered(this.http, "scopes", scopeId, message, options);
   }
   chatStream(scopeId, message, options) {
-    return chatStreamSession(this.http, "scopes", scopeId, message, options);
+    return chatStreamSession(this.http, this.config, "scopes", scopeId, message, options);
   }
 };
 
+// src/types/suggestions.ts
+function normalizeRecordSuggestionEvent(event) {
+  const eventType = event.event_type ?? event.eventType;
+  if (eventType === void 0) {
+    throw new Error("recordEvent requires event_type (or eventType)");
+  }
+  const body = {
+    event_type: eventType,
+    source: event.source
+  };
+  const skillId = event.skill_id ?? event.skillId;
+  if (skillId !== void 0) body.skill_id = skillId;
+  const threadId = event.thread_id ?? event.threadId;
+  if (threadId !== void 0) body.thread_id = threadId;
+  if (event.metadata !== void 0) body.metadata = event.metadata;
+  return body;
+}
+
 // src/resources/suggestions.ts
 var DEFAULT_SUGGESTIONS_PAGE_SIZE = 5;
 var MAX_SUGGESTIONS_PAGE_SIZE = 12;
@@ -849,7 +937,7 @@ var SuggestionsResource = class {
     validateId(id, "id");
     await invokeWithRetry(this.config, this.http, "SuggestionsController_recordEvent", {
       pathParams: { id },
-      jsonBody: event
+      jsonBody: normalizeRecordSuggestionEvent(event)
     });
   }
 };
@@ -868,6 +956,7 @@ var Modus = class extends ModusClientBase {
 };
 export {
   APIConnectionError,
+  AgentType,
   AuthenticationError,
   ChatStream,
   ConflictError,