@getmodus/sdk 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,48 +1,35 @@
 # Changelog
 
-**Current npm release:** not yet published. Pre-release via `@beta` dist-tag when available.
+**Current npm release:** [`0.2.0`](https://www.npmjs.com/package/@getmodus/sdk/v/0.2.0).
 
-## [Unreleased]
-
-### Changed
-
-- npm package scope is **`@getmodus/sdk`** (npm org `getmodus`; `@modus` scope was unavailable). Install with `npm install @getmodus/sdk`.
 
-### Changed (BREAKING)
+## [0.2.0] — 2026-07-20
 
-- **MCP `get_context_data` batch + ACL (BREAKING)** — Renamed from `fetch_context_file`. Pass `{ items[], sessionId? }` instead of top-level `itemId`. Response `{ results[] }` with per-item `ok` / errors (max 20). ACL + scope surface authorization; optional `sessionId` for Mongo offload cache.
-- **`/scopes` + `/workflows` are now the only public surface.** `client.scopes` / `client.workflows` and `mgmt.scopes` / `mgmt.workflows` are canonical; they call the `/api/v1/scopes` and `/api/v1/workflows` routes and the `ScopesController_*` / `WorkflowsController_*` operationIds.
-- Run creation: `client.workflows.runs.createScope(scopeId, body)` replaces the old `createSkill(...)` (routes to `/agent/v1/scopes/:id/runs`).
-- Existing tokens that carry the legacy `skills:*` / `agents:*` scopes continue to authorize the renamed routes via server-side scope equivalence — no token re-issuance is required.
+### Added
 
-### Removed (BREAKING)
+- Canonical **`client.scopes` / `client.workflows`** and **`mgmt.scopes` / `mgmt.workflows`** against `/api/v1/scopes` and `/api/v1/workflows`.
+- **`client.suggestions`** — `list()` / `recordEvent()`.
+- **`client.workflows.runs.active()` / `activeBySession(...)`** — active conversation runs.
+- **`mgmt.scopes.evaluations(scopeId)`** — evaluation config, trigger, run history.
+- Bounded conversation windows via optional `{ messageLimit, beforeMessageIndex }` on `conversations(id).get()`.
+- MCP **`get_context_data`** batch + ACL: `{ items[], sessionId? }` → `{ results[] }` (max 20).
+- Shipped examples under `examples/scripts/`.
+- Full public OpenAPI operation coverage (contract-tested). Dual ESM + CJS. Zero runtime dependencies.
 
-- **`client.skills` / `client.agents`** and **`mgmt.skills` / `mgmt.agents`** accessors — use `client.scopes` / `client.workflows` and `mgmt.scopes` / `mgmt.workflows`. The legacy `/api/v1/skills` and `/api/v1/agents` routes (and their `SkillsController_*` / `AgentsController_*` operationIds) no longer exist.
-- Placeholder `SECURITY.md` (no verified security contact yet).
+### Changed
 
-### Added
+- Package name is **`@getmodus/sdk`** (npm org `getmodus`). Install: `npm install @getmodus/sdk`.
+- Run creation: `client.workflows.runs.createScope(scopeId, body)` (not `createSkill`).
+- Public docs use **Scope** / **Workflow** vocabulary.
 
-- Shipped examples under `examples/scripts/` (`quickstart`, `modus_chat`, `chat`, `manage_skill`) with revenue / ARR analyst prompts.
-- `skills.conversations(id).get()` accepts an optional `{ messageLimit, beforeMessageIndex }` to request a bounded message window; the response gains an optional `messageWindow` field describing the returned slice. Omit both for the full conversation (unchanged default behavior).
-- **`client.suggestions`** — `list()` returns approved suggested questions (optional `skillId`/`skillIds` filter), `recordEvent()` records an impression/click/dismiss event against a suggestion.
-- **`client.workflows.runs.active(options)` / `activeBySession(sessionIds)`** — list active (queued/pending/running) conversation runs for the current user, or look up active runs for specific conversation thread ids.
-- **`claude-sonnet-4.6`** restored as an allowed run `model` value (scope/workflow run creation and chat).
-- **`mgmt.scopes.evaluations(scopeId)`** — `getConfig()` / `updateConfig()` manage a scope's evaluation schedule and judge settings; `triggerRun()` starts a manual evaluation run; `listRuns()` / `getRun(runId)` read run history and per-case results.
+### Removed
 
-### Fixed
+- Legacy **`client.skills` / `client.agents`** and **`mgmt.skills` / `mgmt.agents`** accessors — use `scopes` / `workflows`.
 
-- Typed run event streams now recover from interrupted model providers and emit `assistant_content_reset` when previously streamed assistant content is replaced.
+## [Unreleased]
 
-## [0.1.0] — 2026-06-21
+## [0.1.0] — 2026-07-20
 
 ### Added
 
-- **`@getmodus/sdk`** — official TypeScript client for Modus (Node.js 18+).
-- **`Modus`** client — read / invoke: skills, agents, context, connections, Modus assistant chat, runs.
-- **`ModusManagement`** (`@getmodus/sdk/management`) — configure: CRUD, deploy, context creators, usage, org admin.
-- Cursor-based **`Page<T>`** pagination with `autoPagingIter()` (AIP-158 `pageSize` / `pageToken`).
-- Automatic retry on 429 and 5xx with exponential backoff and `Retry-After` support.
-- SSE streaming chat via `ChatStream` (`textStream()`, `eventStream()`).
-- **58/58** public API operations covered; contract tests enforce OpenAPI parity.
-- Dual **ESM + CommonJS** build (`import` and `require()`).
-- Zero runtime dependencies.
+- First public npm release of **`@getmodus/sdk`** (Node.js 18+): `Modus` + `ModusManagement`, pagination, retries, SSE chat, OpenAPI contract coverage.

package/dist/{chunk-VLHNZJBG.js → chunk-7IOU7BOU.js}

@@ -1102,7 +1102,7 @@ function formatConfigForLog(config) {
 }
 
 // src/_http.ts
-var USER_AGENT = `modus-typescript/${"0.1.0"} (node/${process.version}; ${process.platform})`;
+var USER_AGENT = `modus-typescript/${"0.2.0"} (node/${process.version}; ${process.platform})`;
 function buildUrl(baseUrl, path, params) {
   const url = new URL(path.startsWith("/") ? path : `/${path}`, baseUrl);
   if (params) {
@@ -1678,4 +1678,4 @@ export {
   CustomContextItemsResource,
   ScopeConversationsResource
 };
-//# sourceMappingURL=chunk-VLHNZJBG.js.map
+//# sourceMappingURL=chunk-7IOU7BOU.js.map

package/dist/{conversations-nx1ujbiv.d.cts → conversations-DoyTcWk6.d.cts}

@@ -4093,7 +4093,6 @@ interface components {
              */
             streamProtocolVersion?: 2;
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
         };
         AttachmentsDto: {
@@ -4172,7 +4171,6 @@ interface components {
              */
             streamProtocolVersion?: 2;
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
             /** @description Saved scope ids to scope the Modus run to. */
             subordinateSkillIds?: number[];
@@ -4205,7 +4203,6 @@ interface components {
              */
             streamProtocolVersion?: 2;
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
             /**
              * @description Decision that resumes the interrupted run.
@@ -4231,7 +4228,6 @@ interface components {
             toolset?: Record<string, never>;
             strategies?: string[];
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
             /** @description Set false to keep composer output inline. */
             composerFileOffload?: boolean;
@@ -4276,7 +4272,6 @@ interface components {
              */
             streamProtocolVersion?: 2;
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
             /** @description Subordinate scope ids for an unsaved supervisor-scope draft test. */
             subordinateSkillIds?: number[];

package/dist/{conversations-nx1ujbiv.d.ts → conversations-DoyTcWk6.d.ts}

@@ -4093,7 +4093,6 @@ interface components {
              */
             streamProtocolVersion?: 2;
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
         };
         AttachmentsDto: {
@@ -4172,7 +4171,6 @@ interface components {
              */
             streamProtocolVersion?: 2;
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
             /** @description Saved scope ids to scope the Modus run to. */
             subordinateSkillIds?: number[];
@@ -4205,7 +4203,6 @@ interface components {
              */
             streamProtocolVersion?: 2;
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
             /**
              * @description Decision that resumes the interrupted run.
@@ -4231,7 +4228,6 @@ interface components {
             toolset?: Record<string, never>;
             strategies?: string[];
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
             /** @description Set false to keep composer output inline. */
             composerFileOffload?: boolean;
@@ -4276,7 +4272,6 @@ interface components {
              */
             streamProtocolVersion?: 2;
             experimentalFeatures?: boolean;
-            modelOnly?: boolean;
             debug?: boolean;
             /** @description Subordinate scope ids for an unsaved supervisor-scope draft test. */
             subordinateSkillIds?: number[];

package/dist/index.cjs

@@ -1452,7 +1452,7 @@ function formatConfigForLog(config) {
 }
 
 // src/_http.ts
-var USER_AGENT = `modus-typescript/${"0.1.0"} (node/${process.version}; ${process.platform})`;
+var USER_AGENT = `modus-typescript/${"0.2.0"} (node/${process.version}; ${process.platform})`;
 function buildUrl(baseUrl, path, params) {
   const url = new URL(path.startsWith("/") ? path : `/${path}`, baseUrl);
   if (params) {

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-nx1ujbiv.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-nx1ujbiv.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-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';
 
 declare class ModusError extends Error {
     readonly statusCode?: number;

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-nx1ujbiv.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-nx1ujbiv.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-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';
 
 declare class ModusError extends Error {
     readonly statusCode?: number;

package/dist/index.js

@@ -29,7 +29,7 @@ import {
   validateChatModel,
   validateId,
   validatePageSize
-} from "./chunk-VLHNZJBG.js";
+} from "./chunk-7IOU7BOU.js";
 
 // src/_streaming.ts
 var SILENTLY_IGNORED = /* @__PURE__ */ new Set([

package/dist/management/index.cjs

@@ -177,7 +177,7 @@ function formatConfigForLog(config) {
 }
 
 // src/_http.ts
-var USER_AGENT = `modus-typescript/${"0.1.0"} (node/${process.version}; ${process.platform})`;
+var USER_AGENT = `modus-typescript/${"0.2.0"} (node/${process.version}; ${process.platform})`;
 function buildUrl(baseUrl, path, params) {
   const url = new URL(path.startsWith("/") ? path : `/${path}`, baseUrl);
   if (params) {

package/dist/management/index.d.cts

@@ -1,4 +1,4 @@
-import { H as HttpClient, M as ModusConfig, c as components, A as AgentType, m as OperationId, V as VariationView, P as Page, a as Agent, C as ContextItem, t as ContextItemDeletion, d as CustomContextItemsResource, u as CreatedContextItem, S as ScopeConversationsResource, h as Skill, i as ModusClientBase, j as ModusOptions } from '../conversations-nx1ujbiv.cjs';
+import { H as HttpClient, M as ModusConfig, c as components, A as AgentType, m as OperationId, V as VariationView, P as Page, a as Agent, C as ContextItem, t as ContextItemDeletion, d as CustomContextItemsResource, u as CreatedContextItem, S as ScopeConversationsResource, h as Skill, i as ModusClientBase, j as ModusOptions } from '../conversations-DoyTcWk6.cjs';
 
 type AgentInterface = components['schemas']['AgentInterfaceDto'];
 type AddAgentInterface = components['schemas']['AddAgentInterfaceDto'];

package/dist/management/index.d.ts

@@ -1,4 +1,4 @@
-import { H as HttpClient, M as ModusConfig, c as components, A as AgentType, m as OperationId, V as VariationView, P as Page, a as Agent, C as ContextItem, t as ContextItemDeletion, d as CustomContextItemsResource, u as CreatedContextItem, S as ScopeConversationsResource, h as Skill, i as ModusClientBase, j as ModusOptions } from '../conversations-nx1ujbiv.js';
+import { H as HttpClient, M as ModusConfig, c as components, A as AgentType, m as OperationId, V as VariationView, P as Page, a as Agent, C as ContextItem, t as ContextItemDeletion, d as CustomContextItemsResource, u as CreatedContextItem, S as ScopeConversationsResource, h as Skill, i as ModusClientBase, j as ModusOptions } from '../conversations-DoyTcWk6.js';
 
 type AgentInterface = components['schemas']['AgentInterfaceDto'];
 type AddAgentInterface = components['schemas']['AddAgentInterfaceDto'];

package/dist/management/index.js

@@ -9,7 +9,7 @@ import {
   omitUndefined,
   validateId,
   validatePageSize
-} from "../chunk-VLHNZJBG.js";
+} from "../chunk-7IOU7BOU.js";
 
 // src/_query.ts
 function updateMaskQuery(updateMask) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getmodus/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Official TypeScript client for Modus — your organization's context layer for AI",
   "type": "module",
   "license": "MIT",