@owlmeans/llm-common 0.1.16-rc.0 → 0.1.16
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.
package/README.md
CHANGED
|
@@ -91,10 +91,9 @@ export interface MyExecutionState extends ExecutionState {
|
|
|
91
91
|
<!-- owlmeans:agent-guidance:start -->
|
|
92
92
|
## Agent guidance
|
|
93
93
|
|
|
94
|
-
This package ships embedded
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
(`.claude/skills/` and `.github/instructions/`):
|
|
94
|
+
This package ships embedded agent skills under `agent-meta/`. After installing your
|
|
95
|
+
`@owlmeans/*` packages, run the OwlMeans agent-skills installer to place them into
|
|
96
|
+
your project's skill store (`.agents/skills/`):
|
|
98
97
|
|
|
99
98
|
```sh
|
|
100
99
|
npx @owlmeans/agent-skills
|
package/agent-meta/manifest.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
|
-
"schemaVersion":
|
|
2
|
+
"schemaVersion": 2,
|
|
3
3
|
"package": "@owlmeans/llm-common",
|
|
4
|
-
"version": "0.1.16
|
|
5
|
-
"generatedAt": "2026-08-
|
|
4
|
+
"version": "0.1.16",
|
|
5
|
+
"generatedAt": "2026-08-14T10:14:48.856Z",
|
|
6
6
|
"canonicalRepo": "https://github.com/owlmeans/common",
|
|
7
7
|
"entries": [
|
|
8
8
|
{
|
|
@@ -10,14 +10,7 @@
|
|
|
10
10
|
"name": "llm-common",
|
|
11
11
|
"category": "package-specific",
|
|
12
12
|
"file": "skills/llm-common/SKILL.md",
|
|
13
|
-
"canonicalPath": ".
|
|
14
|
-
},
|
|
15
|
-
{
|
|
16
|
-
"kind": "instruction",
|
|
17
|
-
"name": "llm-common",
|
|
18
|
-
"category": "package-specific",
|
|
19
|
-
"file": "instructions/llm-common.instructions.md",
|
|
20
|
-
"canonicalPath": ".github/instructions/llm-common.instructions.md"
|
|
13
|
+
"canonicalPath": ".agents/skills/llm-common/SKILL.md"
|
|
21
14
|
}
|
|
22
15
|
]
|
|
23
16
|
}
|
|
@@ -8,7 +8,7 @@ user-invocable: false
|
|
|
8
8
|
# @owlmeans/llm-common
|
|
9
9
|
|
|
10
10
|
**Layer:** Core
|
|
11
|
-
**Install:** `"@owlmeans/llm-common": "^0.1.16
|
|
11
|
+
**Install:** `"@owlmeans/llm-common": "^0.1.16"` in `dependencies`
|
|
12
12
|
|
|
13
13
|
The contracts half of the LLM stack. **No `@langchain/*` runtime dependency** — importable
|
|
14
14
|
from a browser bundle, a queue worker, or any package that must not pull an inference SDK.
|
package/package.json
CHANGED
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: "How to use @owlmeans/llm-common — runtime-free serializable contracts for LLM inference and execution, and how to extend them for a domain."
|
|
3
|
-
applyTo: "**/*.ts, **/*.tsx"
|
|
4
|
-
---
|
|
5
|
-
<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
|
|
6
|
-
|
|
7
|
-
# @owlmeans/llm-common
|
|
8
|
-
|
|
9
|
-
**Layer:** Core
|
|
10
|
-
**Install:** `"@owlmeans/llm-common": "^0.1.16-rc.0"` in `dependencies`
|
|
11
|
-
|
|
12
|
-
The contracts half of the LLM stack. **No `@langchain/*` runtime dependency** — importable
|
|
13
|
-
from a browser bundle or a queue worker. Dependency direction is one-way: a domain contracts
|
|
14
|
-
package extends these; `@owlmeans/llm` implements against them.
|
|
15
|
-
|
|
16
|
-
## Key Exports
|
|
17
|
-
|
|
18
|
-
| Export | Description |
|
|
19
|
-
|--------|-------------|
|
|
20
|
-
| `ModelProvider` | `OpenAI` · `Anthropic` · `Compatible` — each is an `LlmPlugin.type`. |
|
|
21
|
-
| `ExecutionLevel` / `ExecutionEffort` | `Project`→`Task`→`Helper`; `Economy`/`Standard`/`High`/`Max`. |
|
|
22
|
-
| `StructuredMode` | `Native` vs `Tool` structured output. |
|
|
23
|
-
| `ModelRole` | Open `string` — declare your own enum. |
|
|
24
|
-
| `ModelConfigPatch` / `ModelConfigOverride` / `ModelPolicy` | JSON-safe model selection. |
|
|
25
|
-
| `ExecutionState` / `TaskExecutionState` | The persistable execution core + resumable fields. |
|
|
26
|
-
| `LlmPurpose` | `{ type?, dedication? }` observability metadata. |
|
|
27
|
-
| `NullCapture`, `NullKind` | Diagnostics of a call that returned nothing usable. |
|
|
28
|
-
| `SpectatorArgument` / `SpectatorEntry` / `SpectatorEntryLogged` / `SpectatorEntryMessage`, `SpectatorContentType` | Observability records. |
|
|
29
|
-
|
|
30
|
-
## Rules
|
|
31
|
-
|
|
32
|
-
- Extend, never fork: `interface MyPurpose extends LlmPurpose`,
|
|
33
|
-
`interface MyExecutionState extends ExecutionState`.
|
|
34
|
-
- For a domain task state, take the base fields from your own `ExecutionState` and mix in
|
|
35
|
-
only the resumable half: `Omit<TaskExecutionState, keyof ExecutionState>`.
|
|
36
|
-
- `ModelRole` and `SpectatorEntry.kind` are open strings so a consumer's enum stays
|
|
37
|
-
assignable — narrow them on your own interfaces.
|
|
38
|
-
- Nothing that fails `JSON.stringify` belongs here: no model instances, credentials, file
|
|
39
|
-
handles or callbacks. `ModelConfig` (with `secret`/`headers`/`fallback`) lives in
|
|
40
|
-
`@owlmeans/llm`.
|
|
41
|
-
|
|
42
|
-
## Usage
|
|
43
|
-
|
|
44
|
-
```typescript
|
|
45
|
-
import { ExecutionEffort } from '@owlmeans/llm-common'
|
|
46
|
-
import type { ModelPolicy } from '@owlmeans/llm-common'
|
|
47
|
-
|
|
48
|
-
export const DEFAULT_POLICY: ModelPolicy = { effort: ExecutionEffort.Standard }
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
## Depends On
|
|
52
|
-
|
|
53
|
-
Nothing at runtime (`@langchain/core` is a dev dependency, for one type).
|