@owlmeans/agent-common 0.1.18-rc.15 → 0.1.18-rc.16

package/README.md

@@ -46,7 +46,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills
+npx @owlmeans/agent-skills@^0.1.18-rc.12
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/agent-common",
-  "version": "0.1.18-rc.15",
-  "generatedAt": "2026-09-01T17:39:40.760Z",
+  "version": "0.1.18-rc.16",
+  "generatedAt": "2026-09-04T22:43:25.435Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/agent-common/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agent-common
-description: How to use @owlmeans/agent-common — runtime-free contracts for OwlMeans agents: conversation identity, the run-lifecycle flow, and the record shapes an application persists (conversation events, run state, memory nodes and events). Auto-invoked when importing agent record types, conversationFor, truncateAt, or the agent run flow.
+description: "How to use @owlmeans/agent-common — runtime-free contracts for OwlMeans agents: conversation identity, the run-lifecycle flow, and the record shapes an application persists (conversation events, run state, memory nodes and events). Auto-invoked when importing agent record types, conversationFor, truncateAt, or the agent run flow."
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/agent-common
 
 **Layer:** Cross-cutting domain
-**Install:** `"@owlmeans/agent-common": "^0.1.18-rc.15"` in `dependencies`
+**Install:** `"@owlmeans/agent-common": "^0.1.18-rc.16"` in `dependencies`
 
 Serializable contracts for the agent family. No LangChain, no LangGraph, no storage driver — a
 backend or a browser bundle imports these to read what an agent wrote without pulling the runtime.
@@ -18,7 +18,8 @@ The runtime is `@owlmeans/agent`.
 
 | Export | Description |
 |---|---|
-| `conversationFor(purpose, override?)` | Derives a `ConversationRef` from an `LlmPurpose` dedication. |
+| `ConversationRef` | `{ conversationId, scope }` — the thread a run belongs to, and the wider subject it is about. Two fields, because memory is filed per subject while threads may be finer-grained. |
+| `conversationFor(purpose, override?)` · `SCOPE_SEP` | Derives a `ConversationRef` from an `LlmPurpose` dedication (`<kind>:<id>`, split on `SCOPE_SEP`); either half is overridable. |
 | `truncateAt(text, max)` | Boundary-aware truncation. Every character cap in the family lands here. |
 | `agentRunFlow`, `AgentRunStep`, `AgentRunTransition`, `AGENT_RUN_FLOW` | The `@owlmeans/flow` lifecycle a run is driven through. |
 | `agentFlows` | Every flow this package declares, for a provider to serve. |
@@ -30,6 +31,7 @@ The runtime is `@owlmeans/agent`.
 | `AGENT_*_STORE` | Port names a consumer binds its storage under. |
 | `AgentRunStatus` | `ok` / `failed`, written on a conversation event. |
 | `AgentCommonError`, `AgentRunStateError` | The error family. |
+| `DEFAULT_SUMMARY_CHARS` (1200) · `DEFAULT_ADVICE_CHARS` (400) · `DEFAULT_EVENT_WINDOW` (3) · `DEFAULT_MEMORY_NODE_CHARS` (2000) · `DEFAULT_MEMORY_EVENTS_LIMIT` (50) | The caps the runtime's plugins default to. Override them per plugin; read them here rather than restating a number. |
 
 ## Rules
 
@@ -52,6 +54,10 @@ committed.
 marked `explicit` precisely so it can never become that automatic answer. Adding a second automatic
 edge to any step breaks `next()` for that step.
 
+**Every cap is enforced by truncation after the model answers, never by asking for it.** A cap in a
+prompt is a request; a cap in code is a cap. That is why the defaults live here as numbers rather
+than as prompt text.
+
 **A conversation id degrades to a named default, never to an empty string.** An empty key would
 silently collapse every run of every subject into one thread.
 
@@ -64,3 +70,9 @@ registered.
 Category A (unit, no env, no network). This package's own `tests/flow.spec.ts` covers the flow
 round-trip — which is also the standing check that `@owlmeans/flow` still works server-side, since
 every other consumer of that package is client-side.
+
+## Related
+
+- [[agent]] — the runtime that writes these records
+- [[llm-common]] — `LlmPurpose` and `ExecutionState`, which `AgentRunState` carries
+- [[flow]] — the flow model the run lifecycle is declared against

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/agent-common",
-  "version": "0.1.18-rc.15",
+  "version": "0.1.18-rc.16",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -29,10 +29,10 @@
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "@owlmeans/error": "^0.1.18-rc.7",
-    "@owlmeans/flow": "^0.1.18-rc.13",
-    "@owlmeans/llm-common": "^0.1.18-rc.10",
-    "@owlmeans/resource": "^0.1.18-rc.8"
+    "@owlmeans/error": "^0.1.18-rc.8",
+    "@owlmeans/flow": "^0.1.18-rc.14",
+    "@owlmeans/llm-common": "^0.1.18-rc.12",
+    "@owlmeans/resource": "^0.1.18-rc.9"
   },
   "publishConfig": {
     "access": "public"