@owlmeans/context 0.1.7 → 0.1.8

package/README.md

@@ -90,3 +90,20 @@ CRASH  // error fallback screen
 - [`@owlmeans/server-context`](../server-context) — server-side context extension
 - [`@owlmeans/client-context`](../client-context) — client-side context extension
 - [`@owlmeans/server-app`](../server-app) — top-level server context factory
+
+<!-- owlmeans:agent-guidance:start -->
+## Agent guidance
+
+This package ships embedded Claude Code skills and GitHub Copilot instructions under
+`agent-meta/`. After installing your `@owlmeans/*` packages, run the OwlMeans
+agent-skills installer to place them into your project's native locations
+(`.claude/skills/` and `.github/instructions/`):
+
+```sh
+npx @owlmeans/agent-skills
+```
+
+The embedded files are version-matched to this package release. Do not edit them
+directly — they are regenerated on each publish. To contribute guidance edits,
+open a PR against the source monorepo.
+<!-- owlmeans:agent-guidance:end -->

package/agent-meta/instructions/context.instructions.md

@@ -0,0 +1,41 @@
+---
+description: "How to use @owlmeans/context — base context (DI container) factory, registerService, service<T>() lookups, entrypoint<ClientEntrypoint<T>>() resolution. Use when building a makeContext factory."
+applyTo: "**/context.ts, **/context.tsx, **/*.ts, **/*.tsx"
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/context
+
+**Layer:** Core
+**Install:** `"@owlmeans/context": "^0.1.8"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `Context<C>` types | Generic context interface |
+| `makeBasicContext` | Low-level factory |
+| `registerService`, `service<T>`, `entrypoint<ClientEntrypoint<T>>` | Methods on every Context |
+| `Service` types | Service interface and lifecycle |
+| Constants | Built-in service/entrypoint aliases |
+
+## Usage
+
+```typescript
+import { makeBackendContext } from '@owlmeans/server-context'
+
+export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T => {
+  const context = makeBackendContext<C, T>(cfg)
+  context.registerService(makeMyService())
+  context.makeContext = makeContext as typeof context.makeContext
+  return context
+}
+
+// Cross-service call
+const [response] = await ctx.entrypoint<ClientEntrypoint<ResponseType>>(alias).call({ body: { ... } })
+```
+
+## Depends On
+
+- `@owlmeans/config` — context is parameterized by a Config
+- `@owlmeans/entrypoint` — `ClientEntrypoint<T>` for cross-service calls

package/agent-meta/manifest.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "package": "@owlmeans/context",
+  "version": "0.1.8",
+  "generatedAt": "2026-06-11T16:30:27.186Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "context",
+      "category": "package-specific",
+      "file": "skills/context/SKILL.md",
+      "canonicalPath": ".claude/skills/context/SKILL.md"
+    },
+    {
+      "kind": "instruction",
+      "name": "context",
+      "category": "package-specific",
+      "file": "instructions/context.instructions.md",
+      "canonicalPath": ".github/instructions/context.instructions.md"
+    }
+  ]
+}

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

@@ -0,0 +1,53 @@
+---
+name: context
+description: How to use @owlmeans/context — base context (DI container) factory, registerService(), service<T>() lookups, entrypoint<ClientEntrypoint<T>>() resolution. Auto-invoked when importing context primitives or building a makeContext factory.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/context
+
+**Layer:** Core
+**Install:** `"@owlmeans/context": "^0.1.8"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `Context<C>` types | Generic context interface (typed by Config) |
+| `makeBasicContext` | Low-level factory — usually you extend a layer-specific factory instead |
+| `registerService` (method) | Add a service to the DI container |
+| `service<T>(alias)` (method) | Resolve a service by alias |
+| `entrypoint<ClientEntrypoint<T>>(alias)` (method) | Resolve an entrypoint to call cross-service |
+| `Service` types | Service interface and lifecycle |
+| Constants | Built-in service/entrypoint aliases |
+
+## Usage
+
+Always extend a layer-specific factory (`@owlmeans/server-context`, `@owlmeans/web-panel`, etc.) rather than calling the basic factory directly. Always reassign `context.makeContext` so child contexts inherit the typed factory:
+
+```typescript
+import { makeBackendContext } from '@owlmeans/server-context'
+
+export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T => {
+  const context = makeBackendContext<C, T>(cfg)
+  context.registerService(makeMyService())
+  context.makeContext = makeContext as typeof context.makeContext
+  return context
+}
+```
+
+Resolve services and call cross-service entrypoints from a handler:
+
+```typescript
+const someService = ctx.service<MyService>(MY_SERVICE_ALIAS)
+
+const [response] = await ctx.entrypoint<ClientEntrypoint<ResponseType>>(
+  externalService.action.alias
+).call({ body: { ... } })
+```
+
+## Depends On
+
+- `@owlmeans/config` — context is parameterized by a Config
+- `@owlmeans/entrypoint` — `ClientEntrypoint<T>` type for cross-service calls

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/context",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "license": "MIT",
   "type": "module",
   "scripts": {