@motebit/sdk 0.6.11 → 0.7.0

package/README.md

@@ -1,8 +1,8 @@
 # @motebit/sdk
 
-Core protocol types for the motebit agent identity standard.
+Product types for building on the Motebit runtime — state vectors, creature behavior, rendering spec, memory graph, AI provider interface.
 
-Zero dependencies. Pure TypeScript interfaces, enums, branded ID types, and utility functions for building on the motebit protocol.
+Re-exports all types from [`@motebit/protocol`](https://www.npmjs.com/package/@motebit/protocol) for convenience. If you only need protocol types (identity, receipts, credentials, settlement), use `@motebit/protocol` directly (MIT licensed).
 
 ## Install
 
@@ -10,119 +10,24 @@ Zero dependencies. Pure TypeScript interfaces, enums, branded ID types, and util
 npm install @motebit/sdk
 ```
 
-## Usage
+## What's included
 
-```typescript
-import {
-  type MotebitState,
-  type ExecutionReceipt,
-  type AgentTask,
-  TrustMode,
-  BatteryMode,
-  AgentTrustLevel,
-  RiskLevel,
-} from "@motebit/sdk";
+Everything from `@motebit/protocol` (re-exported), plus:
 
-// Typed agent state vector
-const state: MotebitState = {
-  attention: 0.7,
-  processing: 0.3,
-  confidence: 0.85,
-  affect_valence: 0.6,
-  affect_arousal: 0.2,
-  social_distance: 0.4,
-  curiosity: 0.5,
-  trust_mode: TrustMode.Guarded,
-  battery_mode: BatteryMode.Normal,
-};
-
-// Typed execution receipt (returned by agents after task completion)
-const receipt: ExecutionReceipt = {
-  task_id: "...",
-  motebit_id: "...",
-  device_id: "...",
-  submitted_at: Date.now(),
-  completed_at: Date.now(),
-  status: "completed",
-  result: "...",
-  tools_used: ["web_search"],
-  memories_formed: 2,
-  prompt_hash: "sha256:...",
-  result_hash: "sha256:...",
-  signature: "ed25519:...",
-};
-```
-
-## Branded ID types
-
-The SDK exports branded string types that enforce compile-time safety at API boundaries:
-
-```typescript
-import {
-  type MotebitId,
-  type DeviceId,
-  type GoalId,
-  type PlanId,
-  type NodeId,
-  asMotebitId,
-  asDeviceId,
-} from "@motebit/sdk";
-
-// Prevent accidental ID swaps across API boundaries
-function submitTask(motebitId: MotebitId, deviceId: DeviceId) { ... }
-
-// Explicit branding at system boundaries
-const id = asMotebitId(rawString);
-```
-
-## Trust algebra
-
-```typescript
-import {
-  AgentTrustLevel,
-  trustLevelToScore,
-  composeTrustChain,
-  evaluateTrustTransition,
-  type AgentTrustRecord,
-} from "@motebit/sdk";
-
-// Compose trust through a delegation chain (semiring: max for parallel, multiply for serial)
-const chainTrust = composeTrustChain([0.9, 0.6, 0.8]); // 0.432
-
-// Evaluate whether a trust record should transition levels
-const newLevel = evaluateTrustTransition(record); // AgentTrustLevel | null
-```
-
-## API reference
-
-| Category             | Key exports                                                                                                                                                |
-| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Branded IDs**      | `MotebitId`, `DeviceId`, `NodeId`, `GoalId`, `EventId`, `ConversationId`, `PlanId` + `as*` factory functions                                               |
-| **Identity**         | `MotebitIdentity`, `MotebitType`, `AgentCapabilities`                                                                                                      |
-| **State vector**     | `MotebitState`, `TrustMode`, `BatteryMode`                                                                                                                 |
-| **Behavior**         | `BehaviorCues`, `SPECIES_CONSTRAINTS`                                                                                                                      |
-| **Memory**           | `MemoryNode`, `MemoryEdge`, `MemoryContent`, `MemoryCandidate`, `MemoryType`, `SensitivityLevel`, `RelationType`                                           |
-| **Policy**           | `PolicyDecision`, `ToolRiskProfile`, `RiskLevel`, `DataClass`, `SideEffect`, `TurnContext`, `InjectionWarning`, `ToolAuditEntry`                           |
-| **Tools**            | `ToolDefinition`, `ToolResult`, `ToolHandler`, `ToolRegistry`                                                                                              |
-| **AI provider**      | `ContextPack`, `AIResponse`, `IntelligenceProvider`, `ConversationMessage`, `ToolCall`                                                                     |
-| **Events**           | `EventLogEntry`, `EventType`                                                                                                                               |
-| **Sync**             | `SyncCursor`, `ConflictEdge`, `SyncConversation`, `SyncConversationMessage`                                                                                |
-| **Plans**            | `Plan`, `PlanStep`, `PlanStatus`, `StepStatus`                                                                                                             |
-| **Agent protocol**   | `AgentTask`, `AgentTaskStatus`, `ExecutionReceipt`, `DeviceCapability`                                                                                     |
-| **Trust algebra**    | `AgentTrustLevel`, `AgentTrustRecord`, `trustLevelToScore`, `composeTrustChain`, `joinParallelRoutes`, `evaluateTrustTransition`, `composeDelegationTrust` |
-| **Execution ledger** | `GoalExecutionManifest`, `ExecutionTimelineEntry`, `ExecutionStepSummary`, `DelegationReceiptSummary`                                                      |
-| **Market**           | `BudgetAllocation`, `SettlementRecord`, `RouteScore`, `AgentServiceListing`, `MarketConfig`                                                                |
-| **Credentials**      | `GradientCredentialSubject`, `ReputationCredentialSubject`, `TrustCredentialSubject`, `VC_TYPE_GRADIENT`, `VC_TYPE_REPUTATION`, `VC_TYPE_TRUST`            |
-| **Precision**        | `PrecisionWeights`                                                                                                                                         |
-| **Privacy**          | `AuditRecord`, `ExportManifest`                                                                                                                            |
-| **Render**           | `RenderSpec`, `GeometrySpec`, `MaterialSpec`, `LightingSpec`                                                                                               |
+- **State vector** — `MotebitState`, `TrustMode`, `BatteryMode`
+- **Behavior** — `BehaviorCues`, `SPECIES_CONSTRAINTS`
+- **Memory graph** — `MemoryNode`, `MemoryEdge`, `MemoryQuery`, `MemoryStorageAdapter`
+- **Rendering** — `RenderSpec`, `GeometrySpec`, `MaterialSpec`, `LightingSpec`
+- **AI provider** — `ContextPack`, `AIResponse`, `IntelligenceProvider`, `ConversationMessage`
+- **Gradient** — `GradientSnapshot`, `GradientStoreAdapter`, `PrecisionWeights`
+- **Export** — `ExportManifest`, `StorageAdapters`
 
 ## Related
 
-- [`@motebit/verify`](https://www.npmjs.com/package/@motebit/verify) — verify a `motebit.md` identity file signature
-- [`create-motebit`](https://www.npmjs.com/package/create-motebit) — scaffold a signed agent identity in 30 seconds
-- [motebit/identity@1.0 spec](https://github.com/motebit/motebit/blob/main/spec/identity-v1.md) — the open protocol specification
+- [`@motebit/protocol`](https://www.npmjs.com/package/@motebit/protocol) — network protocol types (MIT, zero deps)
+- [`@motebit/verify`](https://www.npmjs.com/package/@motebit/verify) — signature verification (MIT, zero deps)
+- [`create-motebit`](https://www.npmjs.com/package/create-motebit) — scaffold a signed agent identity
 
 ## License
 
-MIT. Motebit is a trademark of Motebit, Inc.
+MIT

package/dist/approval-presets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared approval presets for tool governance.
+ *
+ * Canonical source — imported by all surfaces (web, desktop, mobile).
+ * Each preset defines the risk thresholds for automatic tool approval.
+ */
+export type ApprovalPreset = "cautious" | "balanced" | "autonomous";
+export interface ApprovalPresetConfig {
+    label: string;
+    description: string;
+    maxRiskLevel: number;
+    requireApprovalAbove: number;
+    denyAbove: number;
+}
+export declare const APPROVAL_PRESET_CONFIGS: Record<string, ApprovalPresetConfig>;
+//# sourceMappingURL=approval-presets.d.ts.map

package/dist/approval-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-presets.d.ts","sourceRoot":"","sources":["../src/approval-presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAsBxE,CAAC"}

package/dist/approval-presets.js

@@ -0,0 +1,30 @@
+/**
+ * Shared approval presets for tool governance.
+ *
+ * Canonical source — imported by all surfaces (web, desktop, mobile).
+ * Each preset defines the risk thresholds for automatic tool approval.
+ */
+export const APPROVAL_PRESET_CONFIGS = {
+    cautious: {
+        label: "Cautious",
+        description: "Approve everything above read-only",
+        maxRiskLevel: 3,
+        requireApprovalAbove: 0,
+        denyAbove: 3,
+    },
+    balanced: {
+        label: "Balanced",
+        description: "Auto-allow low risk, approve medium",
+        maxRiskLevel: 3,
+        requireApprovalAbove: 1,
+        denyAbove: 3,
+    },
+    autonomous: {
+        label: "Autonomous",
+        description: "Auto-allow most, deny only dangerous",
+        maxRiskLevel: 4,
+        requireApprovalAbove: 3,
+        denyAbove: 4,
+    },
+};
+//# sourceMappingURL=approval-presets.js.map

package/dist/approval-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-presets.js","sourceRoot":"","sources":["../src/approval-presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,CAAC,MAAM,uBAAuB,GAAyC;IAC3E,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,oCAAoC;QACjD,YAAY,EAAE,CAAC;QACf,oBAAoB,EAAE,CAAC;QACvB,SAAS,EAAE,CAAC;KACb;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,qCAAqC;QAClD,YAAY,EAAE,CAAC;QACf,oBAAoB,EAAE,CAAC;QACvB,SAAS,EAAE,CAAC;KACb;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,CAAC;QACf,oBAAoB,EAAE,CAAC;QACvB,SAAS,EAAE,CAAC;KACb;CACF,CAAC"}

package/dist/color-presets.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared color presets for the creature's interior.
+ *
+ * Canonical source — imported by all surfaces (web, desktop, mobile, spatial).
+ * The InteriorColor shape matches @motebit/render-engine but is defined inline
+ * here so the SDK stays Layer 0 with zero non-protocol deps.
+ */
+/** Interior color of the droplet creature — tint (glass absorption) + glow (emissive). */
+export interface InteriorColor {
+    tint: [number, number, number];
+    glow: [number, number, number];
+}
+export declare const COLOR_PRESETS: Record<string, InteriorColor>;
+//# sourceMappingURL=color-presets.d.ts.map

package/dist/color-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-presets.d.ts","sourceRoot":"","sources":["../src/color-presets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAQvD,CAAC"}

package/dist/color-presets.js

@@ -0,0 +1,17 @@
+/**
+ * Shared color presets for the creature's interior.
+ *
+ * Canonical source — imported by all surfaces (web, desktop, mobile, spatial).
+ * The InteriorColor shape matches @motebit/render-engine but is defined inline
+ * here so the SDK stays Layer 0 with zero non-protocol deps.
+ */
+export const COLOR_PRESETS = {
+    moonlight: { tint: [0.95, 0.95, 1.0], glow: [0.8, 0.85, 1.0] },
+    amber: { tint: [1.0, 0.85, 0.6], glow: [0.9, 0.7, 0.3] },
+    rose: { tint: [1.0, 0.82, 0.88], glow: [0.9, 0.5, 0.6] },
+    violet: { tint: [0.88, 0.8, 1.0], glow: [0.6, 0.4, 0.9] },
+    cyan: { tint: [0.8, 0.95, 1.0], glow: [0.3, 0.8, 0.9] },
+    ember: { tint: [1.0, 0.75, 0.65], glow: [0.9, 0.35, 0.2] },
+    sage: { tint: [0.82, 0.95, 0.85], glow: [0.4, 0.75, 0.5] },
+};
+//# sourceMappingURL=color-presets.js.map

package/dist/color-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-presets.js","sourceRoot":"","sources":["../src/color-presets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE;IAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IACxD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IACxD,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IACzD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IACvD,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE;IAC1D,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE;CAC3D,CAAC"}

package/dist/governance-config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared governance configuration schema.
+ *
+ * Canonical source — imported by surfaces that persist governance settings.
+ * Platform-specific persistence (localStorage, Tauri, AsyncStorage) stays in each app.
+ */
+import type { ApprovalPreset } from "./approval-presets.js";
+export interface GovernanceConfig {
+    approvalPreset: ApprovalPreset;
+    persistenceThreshold: number;
+    rejectSecrets: boolean;
+    maxCallsPerTurn: number;
+}
+//# sourceMappingURL=governance-config.d.ts.map

package/dist/governance-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-config.d.ts","sourceRoot":"","sources":["../src/governance-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/governance-config.js

@@ -0,0 +1,8 @@
+/**
+ * Shared governance configuration schema.
+ *
+ * Canonical source — imported by surfaces that persist governance settings.
+ * Platform-specific persistence (localStorage, Tauri, AsyncStorage) stays in each app.
+ */
+export {};
+//# sourceMappingURL=governance-config.js.map

package/dist/governance-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-config.js","sourceRoot":"","sources":["../src/governance-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}