@mastra/opencode 0.0.0-feat-change-lifecycle-20260212011237

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# @mastra/opencode
+
+## 0.0.0-feat-change-lifecycle-20260212011237
+
+### Patch Changes
+
+- @mastra/opencode: Add opencode plugin for Observational Memory integration ([#12925](https://github.com/mastra-ai/mastra/pull/12925))
+
+  Added standalone `observe()` API that accepts external messages directly, so integrations can trigger observation without duplicating messages into Mastra's storage.
+
+  **New exports:**
+  - `ObserveHooks` — lifecycle callbacks (`onObservationStart`, `onObservationEnd`, `onReflectionStart`, `onReflectionEnd`) for hooking into observation/reflection cycles
+  - `OBSERVATION_CONTEXT_PROMPT` — preamble that introduces the observations block
+  - `OBSERVATION_CONTEXT_INSTRUCTIONS` — rules for interpreting observations (placed after the `<observations>` block)
+  - `OBSERVATION_CONTINUATION_HINT` — behavioral guidance that prevents models from awkwardly acknowledging the memory system
+  - `getOrCreateRecord()` — now public, allows eager record initialization before the first observation cycle
+
+  ```ts
+  import { ObservationalMemory } from '@mastra/memory/processors';
+
+  const om = new ObservationalMemory({ storage, model: 'google/gemini-2.5-flash' });
+
+  // Eagerly initialize a record
+  await om.getOrCreateRecord(threadId);
+
+  // Pass messages directly with lifecycle hooks
+  await om.observe({
+    threadId,
+    messages: myMessages,
+    hooks: {
+      onObservationStart: () => console.log('Observing...'),
+      onObservationEnd: () => console.log('Done!'),
+      onReflectionStart: () => console.log('Reflecting...'),
+      onReflectionEnd: () => console.log('Reflected!'),
+    },
+  });
+  ```
+
+  **Breaking:** `observe()` now takes an object param instead of positional args. Update calls from `observe(threadId, resourceId)` to `observe({ threadId, resourceId })`.
+
+- Updated dependencies [[`7ef618f`](https://github.com/mastra-ai/mastra/commit/7ef618f3c49c27e2f6b27d7f564c557c0734325b), [`b896b41`](https://github.com/mastra-ai/mastra/commit/b896b41343de7fcc14442fb40fe82d189e65bbe2), [`6415277`](https://github.com/mastra-ai/mastra/commit/6415277a438faa00db2af850ead5dee25f40c428), [`0831bbb`](https://github.com/mastra-ai/mastra/commit/0831bbb5bc750c18e9b22b45f18687c964b70828), [`63f7eda`](https://github.com/mastra-ai/mastra/commit/63f7eda605eb3e0c8c35ee3912ffe7c999c69f69), [`a5b67a3`](https://github.com/mastra-ai/mastra/commit/a5b67a3589a74415feb663a55d1858324a2afde9), [`cb8c38e`](https://github.com/mastra-ai/mastra/commit/cb8c38e6f855ad190383a7112ba95abef072d490), [`eb36bd8`](https://github.com/mastra-ai/mastra/commit/eb36bd8c52fcd6ec9674ac3b7a6412405b5983e1), [`3c7441d`](https://github.com/mastra-ai/mastra/commit/3c7441d6334af60112cc9e4140640ff9091e665f)]:
+  - @mastra/core@0.0.0-feat-change-lifecycle-20260212011237
+  - @mastra/memory@0.0.0-feat-change-lifecycle-20260212011237
+  - @mastra/libsql@0.0.0-feat-change-lifecycle-20260212011237

package/LICENSE.md

@@ -0,0 +1,15 @@
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@mastra/opencode",
+  "version": "0.0.0-feat-change-lifecycle-20260212011237",
+  "description": "OpenCode plugin for Mastra Observational Memory",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "mastra",
+    "opencode",
+    "observational-memory",
+    "plugin"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "integrations/opencode"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "homepage": "https://mastra.ai",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "dependencies": {
+    "@mastra/memory": "0.0.0-feat-change-lifecycle-20260212011237",
+    "@mastra/core": "0.0.0-feat-change-lifecycle-20260212011237",
+    "@mastra/libsql": "0.0.0-feat-change-lifecycle-20260212011237"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "*"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "*",
+    "@opencode-ai/sdk": "*",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "4.0.16",
+    "@internal/lint": "0.0.0-feat-change-lifecycle-20260212011237",
+    "@internal/types-builder": "0.0.0-feat-change-lifecycle-20260212011237"
+  },
+  "scripts": {
+    "build:lib": "tsup --silent --config tsup.config.ts",
+    "build:watch": "pnpm build:lib --watch",
+    "lint": "eslint ."
+  }
+}