@motebit/sdk 2.5.2 → 2.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +20 -2
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @motebit/sdk
2
2
 
3
- The developer contract for building Motebit-powered agents, services, and integrations. Apache-2.0, zero runtime dependencies.
3
+ The developer contract for building Motebit-powered agents, services, and integrations. Apache-2.0. One runtime dependency — [`@motebit/protocol`](https://www.npmjs.com/package/@motebit/protocol), itself zero-dep.
4
4
 
5
5
  ## Why this exists
6
6
 
@@ -57,7 +57,7 @@ const state: MotebitState = {
57
57
 
58
58
  Everything from `@motebit/protocol` (re-exported), plus:
59
59
 
60
- - **State vector** — `MotebitState`, `TrustMode`, `BatteryMode`
60
+ - **State vector** — `MotebitState` (SDK-local; its `TrustMode` / `BatteryMode` fields use protocol enums, re-exported here)
61
61
  - **Behavior** — `BehaviorCues`, `SPECIES_CONSTRAINTS`
62
62
  - **Memory graph** — `MemoryNode`, `MemoryEdge`, `MemoryQuery`, `MemoryStorageAdapter`
63
63
  - **Rendering** — `RenderSpec`, `GeometrySpec`, `MaterialSpec`, `LightingSpec`
@@ -65,6 +65,24 @@ Everything from `@motebit/protocol` (re-exported), plus:
65
65
  - **Gradient** — `GradientSnapshot`, `GradientStoreAdapter`, `PrecisionWeights`
66
66
  - **Export** — `ExportManifest`, `StorageAdapters`
67
67
 
68
+ ## What the SDK adds over the protocol
69
+
70
+ The developer-contract vocabularies — the package's reason to exist as its own namespace rather than a pure re-export:
71
+
72
+ - **Model registry** (`models.ts`) — the canonical model-identifier constants surfaces route against, so integrators reason about capability classes without tracking provider SKUs
73
+ - **Provider mode** (`provider-mode.ts`) — the three-mode provider vocabulary (user picks the capability class, the system resolves the concrete vendor)
74
+ - **Provider resolver** (`provider-resolver.ts`) — the pure dispatcher from a provider config to a concrete provider choice; the copy-paste-stable logic an alternative runtime needs to match motebit's
75
+ - **Color presets** (`color-presets.ts`) — the canonical interior palettes every surface renders
76
+ - **Approval presets** (`approval-presets.ts`) — risk-threshold presets for automatic tool approval
77
+ - **Risk labels** (`risk-labels.ts`) — canonical labels for the five governance risk levels the `PolicyGate` scores against
78
+ - **Surface options** (`surface-options.ts`) — shared option lists for settings UIs (TTS voices, theme preferences)
79
+ - **Governance config** (`governance-config.ts`) — the persisted governance-settings shape, stable across protocol minors so config on disk survives internal churn
80
+ - **Voice config** (`voice-config.ts`) — the canonical voice-configuration shape, one field vocabulary across surfaces
81
+ - **Appearance config** (`appearance-config.ts`) — the canonical appearance / theme configuration shape
82
+ - **Pixel consent** (`pixel-consent.ts`) — the visual-perception consent vocabulary; pixels cross a different sovereignty boundary than text
83
+ - **Session state** (`session-state.ts`) — the per-turn runtime-state snapshot injected into the system prompt's `[Session]` block
84
+ - **Identity sigil** (`identity-sigil.ts`) — deterministic visual recognition parameters derived from a `motebit_id`
85
+
68
86
  ## Related
69
87
 
70
88
  - [`@motebit/protocol`](https://www.npmjs.com/package/@motebit/protocol) — the protocol subset (Apache-2.0, zero deps)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@motebit/sdk",
3
- "version": "2.5.2",
3
+ "version": "2.5.4",
4
4
  "description": "Developer contract for building Motebit-powered agents, services, and integrations — stable types, adapter interfaces, governance config. Re-exports @motebit/protocol.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -47,10 +47,10 @@
47
47
  "access": "public"
48
48
  },
49
49
  "dependencies": {
50
- "@motebit/protocol": "3.14.0"
50
+ "@motebit/protocol": "3.15.1"
51
51
  },
52
52
  "devDependencies": {
53
- "@types/node": "^22.20.0",
53
+ "@types/node": "^22.20.1",
54
54
  "typescript": "^5.6.0",
55
55
  "vitest": "^4.1.10"
56
56
  },