@moxxy/sdk 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,239 @@
+<p align="center">
+  <a href="https://moxxy.ai">
+    <img src="https://moxxy.ai/logo-gradient.svg" alt="moxxy" width="160" />
+  </a>
+</p>
+
+<h1 align="center">@moxxy/sdk</h1>
+
+<p align="center">
+  <strong>Typed public surface for the moxxy framework.</strong><br/>
+  Zero runtime deps. The contract every plugin, channel, and provider speaks.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@moxxy/sdk">
+    <img src="https://img.shields.io/npm/v/@moxxy/sdk?logo=npm&logoColor=white" alt="npm" />
+  </a>
+  <a href="https://nodejs.org">
+    <img src="https://img.shields.io/badge/node-%3E%3D20.10-brightgreen?logo=node.js&logoColor=white" alt="Node ≥20.10" />
+  </a>
+  <a href="https://www.typescriptlang.org">
+    <img src="https://img.shields.io/badge/TypeScript-strict-3178C6?logo=typescript&logoColor=white" alt="TypeScript" />
+  </a>
+  <a href="https://github.com/moxxy-ai/new_moxxy/actions/workflows/ci.yml">
+    <img src="https://github.com/moxxy-ai/new_moxxy/actions/workflows/ci.yml/badge.svg" alt="CI" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="#-installation">Install</a>
+  &nbsp;·&nbsp;
+  <a href="#-quickstart">Quickstart</a>
+  &nbsp;·&nbsp;
+  <a href="https://moxxy.ai">Docs</a>
+  &nbsp;·&nbsp;
+  <a href="#-what-the-sdk-gives-you">Surface</a>
+  &nbsp;·&nbsp;
+  <a href="#-authoring-a-plugin">Plugin guide</a>
+</p>
+
+---
+
+## ✨ What this package is
+
+`@moxxy/sdk` is the **typed contract** between moxxy and everything that plugs into it: providers, modes (loop strategies), tools, channels, compactors, cache strategies, isolators, transcribers, view renderers, tunnel providers, agents, commands, skills.
+
+It exports:
+
+- `define*({…})` factories — the only blessed way to author each kind of block.
+- The `MoxxyEvent` union — every event the runtime can emit or replay.
+- `ClientSession`, `SessionLike` — the views channels and modes see.
+- Lifecycle hook signatures (`onTurnStart`, `onAssistantMessage`, …).
+- Helper utilities that don't drag the runtime along — token accounting, compactor helpers, schema → JSON schema, tool gating, embedding cache, retryable-error classification.
+
+It is the **only** moxxy package safe to depend on from a published plugin. `@moxxy/core` is the runtime — plugins never import it.
+
+|   |   |
+|---|---|
+| 🧩 **Zero runtime deps** | The package builds without pulling anything into your bundle. `zod` is a `peerDependency`. |
+| 🔌 **One contract, every block** | Same shape for tools, channels, providers, compactors, … — once you've written one plugin you know how to write the next. |
+| 🛡 **Strict TypeScript** | Types-as-docs. `defineTool` is generic on its zod schema so handlers are fully inferred. |
+| 🪶 **Type-only views** | `SessionLike` exposes what a channel needs without exposing the registry internals — keeps coupling honest. |
+| 📜 **Event-log first** | Every block is reactive over a single typed event stream — no hidden globals, easy to record/replay. |
+
+## 🚀 Installation
+
+```sh
+npm install @moxxy/sdk zod
+# or: pnpm add @moxxy/sdk zod
+# or: yarn add @moxxy/sdk zod
+```
+
+`zod` is declared as a `peerDependency` — the SDK doesn't ship it so your plugin and the host agree on one copy.
+
+**Requirements**: Node.js ≥ 20.10. Strict TypeScript recommended.
+
+## ⚡ Quickstart
+
+A tool plugin in nine lines:
+
+```ts
+import { definePlugin, defineTool, z } from '@moxxy/sdk';
+
+export default definePlugin({
+  name: '@acme/moxxy-plugin-greet',
+  tools: [
+    defineTool({
+      name: 'greet',
+      description: 'Return a greeting for the given name.',
+      inputSchema: z.object({ name: z.string() }),
+      handler: ({ name }) => `Hello, ${name}!`,
+    }),
+  ],
+});
+```
+
+Add a `"moxxy"` block to your `package.json` and moxxy auto-discovers it:
+
+```json
+{
+  "moxxy": { "plugin": { "entry": "./dist/index.js", "kind": "tools" } }
+}
+```
+
+That's it. `moxxy plugins list` (or any TUI session) will see your tool on next launch.
+
+## 🧩 What the SDK gives you
+
+### `define*` factories
+
+| Factory | Defines |
+|---|---|
+| `definePlugin` | A bundle of any of the below, the discoverable unit |
+| `defineTool` | A callable tool, zod-typed input, optional `permission` / `isolation` / `compact` presentation |
+| `defineProvider` | An LLM backend (Anthropic / OpenAI / custom) |
+| `defineMode` | A loop strategy (`tool-use`, `plan-execute`, `bmad`, …) — the agent's iteration topology |
+| `defineCompactor` | Context-window compaction strategy (summarise / drop / hybrid) |
+| `defineCacheStrategy` | Where to place provider cache breakpoints |
+| `defineChannel` | A user-facing surface (TUI / HTTP / Telegram / web / …) |
+| `defineCommand` | A `/slash` command surfaced in every channel that hosts commands |
+| `defineSkill` | A prompt-only Markdown skill (frontmatter + body) |
+| `defineAgent` | A subagent kind dispatchable from the parent loop |
+| `defineTranscriber` | A speech-to-text backend wired into every audio-capable channel |
+| `definePermission` | A permission rule contributed to the resolver chain |
+| `defineViewRenderer` | A target for the agent-authored UI primitives |
+| `defineTunnelProvider` | A public-URL tunnel (cloudflared / ngrok / …) for HTTP channels |
+| `defineIsolator` *(via `@moxxy/plugin-security`)* | A capability sandbox; the SDK exports the `Isolator` interface and the `ISOLATION_RANK` ordering |
+
+### Types & events
+
+```ts
+import type {
+  MoxxyEvent,           // discriminated union of every event in the log
+  EventLogReader,       // stable view over the session's event log
+  ClientSession,        // what channels and slash-commands see
+  SessionLike,          // what modes / providers / tools see
+  PendingToolCall,
+  PermissionDecision,
+  ApprovalRequest, ApprovalDecision,
+  ToolDef, ProviderDef, ModeDef, CompactorDef, CacheStrategyDef,
+  Plugin, PluginSpec,
+  Skill, SkillDef, SkillFrontmatter, SkillScope,
+} from '@moxxy/sdk';
+```
+
+### Helpers
+
+- **`zodToJsonSchema`** — convert a zod schema to JSON Schema for provider tool calls.
+- **`isRetryableError`** / **`toFriendlyError`** — classify provider errors uniformly.
+- **`estimateContextTokens`**, **`runCompactionIfNeeded`** — compactor scaffolding.
+- **`CachedEmbeddingProvider`** — wrap any `EmbeddingProvider` with on-disk caching.
+- **`dispatchToolCall`** — invoke a tool through the full gating + permission + isolation pipeline.
+- **`summarizeSessionTokensFromEvents`**, **`summarizeTokensByModel`** — pure token accounting over the event log.
+
+### Lifecycle hooks
+
+A plugin can declare optional hooks: `onSessionStart`, `onTurnStart`, `onAssistantMessage`, `onToolResult`, `onError`, `onCompact`, `onSessionEnd`. All are strongly typed and fire in plugin-registration order. The SDK exposes the hook context types; the runtime in `@moxxy/core` is responsible for actually invoking them.
+
+## 🛠 Authoring a plugin
+
+A tool plugin (minimum surface):
+
+```ts
+import { definePlugin, defineTool, z } from '@moxxy/sdk';
+
+export default definePlugin({
+  name: '@acme/moxxy-plugin-weather',
+  tools: [
+    defineTool({
+      name: 'get_weather',
+      description: 'Fetch current weather for a city.',
+      inputSchema: z.object({ city: z.string() }),
+      // Handler args are inferred from the zod schema.
+      handler: async ({ city }, ctx) => {
+        const res = await fetch(`https://wttr.in/${encodeURIComponent(city)}?format=j1`);
+        return res.json();
+      },
+      // Optional: gate the call, declare capabilities, customise compact display.
+      permission: { action: 'prompt' },
+      isolation: { capabilities: { net: { allow: ['wttr.in'] } } },
+      compact: { verb: 'Reading weather', subject: ({ city }) => city },
+    }),
+  ],
+});
+```
+
+A provider plugin:
+
+```ts
+import { definePlugin, defineProvider, type ProviderDef } from '@moxxy/sdk';
+
+const myProvider: ProviderDef = defineProvider({
+  name: 'my-llm',
+  models: [{ id: 'flagship', contextWindow: 200_000 }],
+  async *stream(ctx) { /* yield MoxxyEvent values */ },
+});
+
+export default definePlugin({
+  name: '@acme/moxxy-provider-my-llm',
+  providers: [myProvider],
+});
+```
+
+A mode (loop strategy):
+
+```ts
+import { definePlugin, defineMode, type ModeContext, type MoxxyEvent } from '@moxxy/sdk';
+
+async function* runMyMode(ctx: ModeContext): AsyncIterable<MoxxyEvent> {
+  // emit events, call providers, dispatch tools — return when the turn ends.
+}
+
+export default definePlugin({
+  name: '@acme/moxxy-mode-my',
+  modes: [defineMode({
+    name: 'my-mode',
+    description: 'One-line summary surfaced in the /mode picker.',
+    run: runMyMode,
+  })],
+});
+```
+
+Per-block author guides (skill, plugin, tool, channel, provider, loop strategy, compactor, cache strategy) live in the monorepo at [`.claude/agents/`](https://github.com/moxxy-ai/new_moxxy/tree/main/.claude/agents).
+
+## 🏛 Architectural rules
+
+- **`@moxxy/sdk` has zero internal deps.** Enforced in CI via `pnpm check:deps`.
+- **`@moxxy/core` doesn't import any plugin.** Plugins flow into core through the SDK only.
+- **Plugins never import `@moxxy/core`.** If you find yourself wanting to, the missing piece belongs in the SDK.
+
+These three invariants are what keep the framework swappable.
+
+## 📚 Docs
+
+Full docs at **[docs.moxxy.ai](https://docs.moxxy.ai)** — concepts, plugin author guides, channel guides, recipes.
+
+## 📝 License
+
+TBD.

package/dist/command-sync.d.ts

@@ -0,0 +1,23 @@
+export declare const COMMAND_SESSION_ACTION_SUBTYPE: "command.session_action";
+export declare const COMMAND_STATE_CHANGED_SUBTYPE: "command.state_changed";
+export type CommandOriginChannel = 'tui' | 'office' | (string & {});
+export type CommandTarget = 'session';
+export interface CommandSyncBasePayload {
+    readonly command: string;
+    readonly target: CommandTarget;
+    readonly origin_channel: CommandOriginChannel;
+    readonly origin_id: string;
+    readonly notice?: string;
+}
+export interface CommandSessionActionPayload extends CommandSyncBasePayload {
+    readonly action: 'new';
+}
+export interface CommandStateChangedPayload extends CommandSyncBasePayload {
+    readonly action: 'model_changed' | 'loop_changed';
+    readonly provider?: string;
+    readonly model?: string;
+    readonly loop?: string;
+}
+export declare function isCommandSessionActionPayload(value: unknown): value is CommandSessionActionPayload;
+export declare function isCommandStateChangedPayload(value: unknown): value is CommandStateChangedPayload;
+//# sourceMappingURL=command-sync.d.ts.map

package/dist/command-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-sync.d.ts","sourceRoot":"","sources":["../src/command-sync.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,EAAG,wBAAiC,CAAC;AAChF,eAAO,MAAM,6BAA6B,EAAG,uBAAgC,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC;AAEtC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAqBD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CAGtC;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,0BAA0B,CAcrC"}

package/dist/command-sync.js

@@ -0,0 +1,36 @@
+export const COMMAND_SESSION_ACTION_SUBTYPE = 'command.session_action';
+export const COMMAND_STATE_CHANGED_SUBTYPE = 'command.state_changed';
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function hasBasePayload(value) {
+    return (typeof value.command === 'string' &&
+        value.command.trim().length > 0 &&
+        value.target === 'session' &&
+        typeof value.origin_channel === 'string' &&
+        value.origin_channel.trim().length > 0 &&
+        typeof value.origin_id === 'string' &&
+        value.origin_id.trim().length > 0 &&
+        (value.notice === undefined || typeof value.notice === 'string'));
+}
+export function isCommandSessionActionPayload(value) {
+    const record = asRecord(value);
+    return Boolean(record && hasBasePayload(record) && record.action === 'new');
+}
+export function isCommandStateChangedPayload(value) {
+    const record = asRecord(value);
+    if (!record || !hasBasePayload(record))
+        return false;
+    if (record.action === 'model_changed') {
+        return ((record.provider === undefined || typeof record.provider === 'string') &&
+            typeof record.model === 'string' &&
+            record.model.trim().length > 0);
+    }
+    if (record.action === 'loop_changed') {
+        return typeof record.loop === 'string' && record.loop.trim().length > 0;
+    }
+    return false;
+}
+//# sourceMappingURL=command-sync.js.map

package/dist/command-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-sync.js","sourceRoot":"","sources":["../src/command-sync.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,8BAA8B,GAAG,wBAAiC,CAAC;AAChF,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAgC,CAAC;AAwB9E,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,cAAc,CAAC,KAA8B;IACpD,OAAO,CACL,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC/B,KAAK,CAAC,MAAM,KAAK,SAAS;QAC1B,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ;QACxC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACtC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACjC,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAc;IAEd,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;QACtC,OAAO,CACL,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;YACtE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAChC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAC/B,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACrC,OAAO,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/loop-helpers.d.ts

@@ -0,0 +1,68 @@
+import type { ProviderMessage } from './provider.js';
+import type { LoopContext } from './loop.js';
+import type { StopReason } from './provider-utils.js';
+import type { Skill } from './skill.js';
+/**
+ * Shared bits used by every loop strategy: a typed tool-use struct and a
+ * common stream-collection helper that runs `onBeforeProviderCall` hooks
+ * and reduces a provider stream down to `{text, toolUses, stopReason}`.
+ *
+ * Lives in core (not in each loop package) so a new loop strategy stays
+ * consistent — and so behavioral fixes here propagate. Previously
+ * loop-plan-execute had its own copy that skipped the hook (audit bug).
+ */
+export interface CollectedToolUse {
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+}
+/**
+ * Compose a model-facing system prompt that includes any base prompt
+ * plus a COMPACT skill index (name + description + triggers only).
+ *
+ * Lazy-loading design: the body is intentionally NOT inlined. The model
+ * matches user intent against the description/triggers, then calls the
+ * `load_skill` tool to fetch the body of the skill it picked. This keeps
+ * the system prompt small even with many skills installed and avoids
+ * paying for skill bodies the model never actually follows.
+ */
+export declare function buildSystemPromptWithSkills(baseSystemPrompt: string | undefined, skills: ReadonlyArray<Skill>): string | undefined;
+export interface ProjectMessagesOptions {
+    /** Optional system prompt; emitted as the first message when set. */
+    readonly systemPrompt?: string;
+    /** Optional trailing user message — useful for plan-execute's "Focus on this step now: X". */
+    readonly trailingUserText?: string;
+}
+/**
+ * Project the session's event log to a flat list of ProviderMessages
+ * suitable for handing to `provider.stream`. Used by every loop strategy.
+ *
+ * Handles user_prompt, assistant_message, tool_call_requested (grouped
+ * into a single assistant message of tool_use blocks), and tool_result.
+ * Other event types are passed through as a no-op.
+ *
+ * Note: this is the minimal projection used by loop strategies. Core's
+ * `selectMessages` is a richer variant that also honors compaction events
+ * and attachments; the simpler form here lives in the SDK so loop plugins
+ * stay independent of core.
+ */
+export declare function projectMessagesFromLog(ctx: Pick<LoopContext, 'log'>, opts?: ProjectMessagesOptions): ProviderMessage[];
+export interface StreamResult {
+    readonly text: string;
+    readonly toolUses: ReadonlyArray<CollectedToolUse>;
+    readonly stopReason: StopReason;
+    readonly error: {
+        readonly message: string;
+        readonly retryable: boolean;
+    } | null;
+}
+/**
+ * Pulls a provider stream, emits `assistant_chunk` events for text deltas,
+ * collects tool_use blocks, and returns the final `{text, toolUses, stopReason}`.
+ * Runs `onBeforeProviderCall` lifecycle hooks before the call.
+ */
+export declare function collectProviderStream(ctx: LoopContext, messages: ReadonlyArray<ProviderMessage>, opts?: {
+    iteration?: number;
+    includeTools?: boolean;
+}): Promise<StreamResult>;
+//# sourceMappingURL=loop-helpers.d.ts.map

package/dist/loop-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-helpers.d.ts","sourceRoot":"","sources":["../src/loop-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA+B,eAAe,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,GAC3B,MAAM,GAAG,SAAS,CAoBpB;AAED,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAiCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAC7B,IAAI,GAAE,sBAA2B,GAChC,eAAe,EAAE,CAoInB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAClF;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,EACxC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACxD,OAAO,CAAC,YAAY,CAAC,CAoFvB"}

package/dist/loop-helpers.js

@@ -0,0 +1,283 @@
+/**
+ * Compose a model-facing system prompt that includes any base prompt
+ * plus a COMPACT skill index (name + description + triggers only).
+ *
+ * Lazy-loading design: the body is intentionally NOT inlined. The model
+ * matches user intent against the description/triggers, then calls the
+ * `load_skill` tool to fetch the body of the skill it picked. This keeps
+ * the system prompt small even with many skills installed and avoids
+ * paying for skill bodies the model never actually follows.
+ */
+export function buildSystemPromptWithSkills(baseSystemPrompt, skills) {
+    if (skills.length === 0)
+        return baseSystemPrompt;
+    const header = `## Available skills\n\n` +
+        `Each line below is a pre-authored playbook for a specific intent. ` +
+        `When the user's request matches one of these (by name, description, ` +
+        `or triggers), call \`load_skill({ name: "<skill-name>" })\` FIRST to ` +
+        `fetch the full instructions, then follow them verbatim. Prefer using ` +
+        `a skill over re-deriving the workflow with ad-hoc tools.\n`;
+    const entries = skills
+        .map((s) => {
+        const fm = s.frontmatter;
+        const triggerHint = fm.triggers?.length
+            ? ` (triggers: ${fm.triggers.map((t) => `"${t}"`).join(', ')})`
+            : '';
+        return `- **${fm.name}** — ${fm.description}${triggerHint}`;
+    })
+        .join('\n');
+    const skillBlock = `${header}\n${entries}`;
+    return baseSystemPrompt ? `${baseSystemPrompt}\n\n${skillBlock}` : skillBlock;
+}
+function activeCompactionRanges(events) {
+    return events
+        .filter((event) => event.type === 'compaction' &&
+        event.tokensSaved > 0 &&
+        event.summary.trim().length > 0 &&
+        event.replacedRange[0] <= event.replacedRange[1])
+        .map((event) => ({
+        from: event.replacedRange[0],
+        to: event.replacedRange[1],
+        summary: event.summary,
+    }));
+}
+function eventInCompactionRange(seq, ranges) {
+    for (const range of ranges) {
+        if (seq >= range.from && seq <= range.to)
+            return range;
+    }
+    return null;
+}
+/**
+ * Project the session's event log to a flat list of ProviderMessages
+ * suitable for handing to `provider.stream`. Used by every loop strategy.
+ *
+ * Handles user_prompt, assistant_message, tool_call_requested (grouped
+ * into a single assistant message of tool_use blocks), and tool_result.
+ * Other event types are passed through as a no-op.
+ *
+ * Note: this is the minimal projection used by loop strategies. Core's
+ * `selectMessages` is a richer variant that also honors compaction events
+ * and attachments; the simpler form here lives in the SDK so loop plugins
+ * stay independent of core.
+ */
+export function projectMessagesFromLog(ctx, opts = {}) {
+    const messages = [];
+    if (opts.systemPrompt) {
+        messages.push({ role: 'system', content: [{ type: 'text', text: opts.systemPrompt }] });
+    }
+    const allEvents = ctx.log.slice();
+    const compactions = activeCompactionRanges(allEvents);
+    const emittedCompactions = new Set();
+    // Pre-scan: build the set of callIds that have a matching tool_result
+    // (or tool_call_denied) somewhere in the log. Used to synthesize a
+    // fallback `[interrupted]` tool_result for orphan tool_use blocks
+    // when the assistant message gets flushed.
+    //
+    // Without this fallback the provider rejects the whole conversation
+    // with "assistant message with 'tool_calls' must be followed by tool
+    // messages responding to each 'tool_call_id'". Orphans typically
+    // appear after a cancelled turn, an aborted process, or a tool
+    // exception that bypassed the loop's tool_result emit path.
+    const resolvedCallIds = new Set();
+    for (const e of allEvents) {
+        if (e.type === 'tool_result' || e.type === 'tool_call_denied') {
+            resolvedCallIds.add(e.callId);
+        }
+    }
+    let pendingAssistant = null;
+    const flush = () => {
+        if (!pendingAssistant)
+            return;
+        const flushed = pendingAssistant;
+        messages.push(flushed);
+        pendingAssistant = null;
+        // Synthesize fallback tool_result messages for any tool_use blocks
+        // whose callId never resolved in the event log. Has to land
+        // immediately after the assistant message (and before any
+        // subsequent user_prompt / assistant_message) so the provider sees
+        // a clean assistant→tool-result chain.
+        for (const block of flushed.content) {
+            if (block.type === 'tool_use' && !resolvedCallIds.has(block.id)) {
+                messages.push({
+                    role: 'tool_result',
+                    content: [
+                        {
+                            type: 'tool_result',
+                            toolUseId: block.id,
+                            content: '[tool call did not return a result — possibly interrupted or cancelled]',
+                            isError: true,
+                        },
+                    ],
+                });
+                // Mark synthesized so we don't double-emit if the same orphan
+                // appears in multiple groups (defensive — shouldn't normally
+                // happen since each tool_call_requested has a unique callId).
+                resolvedCallIds.add(block.id);
+            }
+        }
+    };
+    for (const e of allEvents) {
+        const compaction = eventInCompactionRange(e.seq, compactions);
+        if (compaction) {
+            if (!emittedCompactions.has(compaction)) {
+                emittedCompactions.add(compaction);
+                flush();
+                messages.push({
+                    role: 'user',
+                    content: [{ type: 'text', text: `[summary of earlier turns]\n${compaction.summary}` }],
+                });
+            }
+            continue;
+        }
+        switch (e.type) {
+            case 'user_prompt': {
+                flush();
+                const blocks = [{ type: 'text', text: e.text }];
+                if (e.attachments) {
+                    for (const att of e.attachments) {
+                        if (att.kind === 'image') {
+                            blocks.push({
+                                type: 'image',
+                                mediaType: att.mediaType ?? 'image/png',
+                                data: att.content,
+                            });
+                        }
+                        else {
+                            blocks.push({
+                                type: 'text',
+                                text: `[${att.kind}${att.name ? ` ${att.name}` : ''}]\n${att.content}`,
+                            });
+                        }
+                    }
+                }
+                messages.push({ role: 'user', content: blocks });
+                break;
+            }
+            case 'assistant_message':
+                flush();
+                messages.push({ role: 'assistant', content: [{ type: 'text', text: e.content }] });
+                break;
+            case 'tool_call_requested': {
+                pendingAssistant ??= { role: 'assistant', content: [] };
+                pendingAssistant.content.push({
+                    type: 'tool_use',
+                    id: e.callId,
+                    name: e.name,
+                    input: e.input,
+                });
+                break;
+            }
+            case 'tool_result': {
+                flush();
+                const text = e.error
+                    ? `[error:${e.error.kind}] ${e.error.message}`
+                    : typeof e.output === 'string'
+                        ? e.output
+                        : JSON.stringify(e.output ?? '');
+                messages.push({
+                    role: 'tool_result',
+                    content: [{ type: 'tool_result', toolUseId: e.callId, content: text, isError: !e.ok }],
+                });
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    flush();
+    if (opts.trailingUserText) {
+        messages.push({ role: 'user', content: [{ type: 'text', text: opts.trailingUserText }] });
+    }
+    return messages;
+}
+/**
+ * Pulls a provider stream, emits `assistant_chunk` events for text deltas,
+ * collects tool_use blocks, and returns the final `{text, toolUses, stopReason}`.
+ * Runs `onBeforeProviderCall` lifecycle hooks before the call.
+ */
+export async function collectProviderStream(ctx, messages, opts = {}) {
+    const req = {
+        model: ctx.model,
+        system: ctx.systemPrompt,
+        messages,
+        ...(opts.includeTools === false ? {} : { tools: ctx.tools.list() }),
+        signal: ctx.signal,
+    };
+    const transformed = await ctx.hooks.dispatchBeforeProviderCall(req, {
+        sessionId: ctx.sessionId,
+        cwd: '',
+        log: ctx.log,
+        env: {},
+        turnId: ctx.turnId,
+        iteration: opts.iteration ?? 0,
+    });
+    let text = '';
+    const toolUses = new Map();
+    let stopReason = 'end_turn';
+    let error = null;
+    let stream;
+    try {
+        stream = ctx.provider.stream(transformed);
+    }
+    catch (err) {
+        return {
+            text: '',
+            toolUses: [],
+            stopReason: 'error',
+            error: { message: err instanceof Error ? err.message : String(err), retryable: false },
+        };
+    }
+    try {
+        for await (const event of stream) {
+            switch (event.type) {
+                case 'text_delta': {
+                    text += event.delta;
+                    await ctx.emit({
+                        type: 'assistant_chunk',
+                        sessionId: ctx.sessionId,
+                        turnId: ctx.turnId,
+                        source: 'model',
+                        delta: event.delta,
+                    });
+                    break;
+                }
+                case 'tool_use_start': {
+                    toolUses.set(event.id, { name: event.name });
+                    break;
+                }
+                case 'tool_use_end': {
+                    const existing = toolUses.get(event.id) ?? {};
+                    toolUses.set(event.id, { ...existing, input: event.input });
+                    break;
+                }
+                case 'message_end': {
+                    stopReason = event.stopReason;
+                    break;
+                }
+                case 'error': {
+                    error = { message: event.message, retryable: event.retryable };
+                    break;
+                }
+                case 'message_start':
+                case 'tool_use_delta':
+                default:
+                    break;
+            }
+        }
+    }
+    catch (err) {
+        error = {
+            message: err instanceof Error ? err.message : String(err),
+            retryable: false,
+        };
+    }
+    const finalToolUses = [];
+    for (const [id, partial] of toolUses) {
+        if (!partial.name)
+            continue;
+        finalToolUses.push({ id, name: partial.name, input: partial.input ?? {} });
+    }
+    return { text, toolUses: finalToolUses, stopReason, error };
+}
+//# sourceMappingURL=loop-helpers.js.map

package/dist/loop-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-helpers.js","sourceRoot":"","sources":["../src/loop-helpers.ts"],"names":[],"mappings":"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"}

package/dist/loop.d.ts

@@ -0,0 +1,106 @@
+import type { CompactorDef } from './compactor.js';
+import type { EmittedEvent, MoxxyEvent } from './events.js';
+import type { HookDispatcher } from './hooks.js';
+import type { SessionId, TurnId } from './ids.js';
+import type { EventLogReader } from './log.js';
+import type { PermissionResolver } from './permission.js';
+import type { LLMProvider } from './provider.js';
+import type { Skill } from './skill.js';
+import type { SubagentSpawner } from './subagent.js';
+import type { ToolDef } from './tool.js';
+export interface ToolRegistry {
+    list(): ReadonlyArray<ToolDef>;
+    get(name: string): ToolDef | undefined;
+    execute(name: string, input: unknown, signal: AbortSignal, opts?: ToolExecuteOpts): Promise<unknown>;
+}
+export interface ToolExecuteOpts {
+    readonly callId?: string;
+    readonly sessionId?: string;
+    readonly turnId?: string;
+    readonly log?: EventLogReader;
+    readonly cwd?: string;
+}
+export interface SkillRegistry {
+    list(): ReadonlyArray<Skill>;
+    get(id: string): Skill | undefined;
+    byName(name: string): Skill | undefined;
+    filterByTriggers(prompt: string): ReadonlyArray<Skill>;
+}
+export interface PluginHostHandle {
+    list(): ReadonlyArray<{
+        name: string;
+        version: string;
+        loaded: boolean;
+    }>;
+    reload(): Promise<void>;
+}
+export interface LoopContext {
+    readonly sessionId: SessionId;
+    readonly turnId: TurnId;
+    readonly model: string;
+    readonly systemPrompt?: string;
+    readonly provider: LLMProvider;
+    readonly tools: ToolRegistry;
+    readonly skills: SkillRegistry;
+    readonly log: EventLogReader;
+    readonly compactor: CompactorDef | null;
+    readonly permissions: PermissionResolver;
+    /**
+     * Optional generic "ask the user a question" gate. Any loop strategy can
+     * call this to surface a checkpoint to the user — plan-execute uses it
+     * after producing a plan, but a code-execution loop could use it for
+     * "run this command?" or a refactor loop for "apply this diff?". When
+     * absent (headless / non-TTY), strategies should proceed as if the user
+     * picked the default option, or fail closed depending on the strategy.
+     */
+    readonly approval?: ApprovalResolver;
+    readonly hooks: HookDispatcher;
+    readonly pluginHost: PluginHostHandle;
+    readonly signal: AbortSignal;
+    readonly maxIterations?: number;
+    /**
+     * Spawn one or more child agents that share the parent's registries
+     * but run in isolation. Children stream their events back to the
+     * parent log as `plugin_event` records with `subagent_*` subtypes.
+     * Absent in synthetic test contexts that don't model a full Session.
+     */
+    readonly subagents?: SubagentSpawner;
+    emit(event: EmittedEvent): Promise<MoxxyEvent>;
+}
+/**
+ * Generic approval-dialog request. The TUI renders `title` as the header,
+ * `body` as a verbatim block (plan text, diff, command preview, etc.), and
+ * a single-select list of `options`. An option may set `requestsText` so
+ * the dialog prompts for follow-up text after selection (e.g. redraft
+ * feedback). `kind` is a loose tag the dialog/CLI can use for styling.
+ */
+export interface ApprovalRequest {
+    readonly title: string;
+    readonly body: string;
+    readonly options: ReadonlyArray<ApprovalOption>;
+    readonly defaultOptionId?: string;
+    readonly kind?: string;
+}
+export interface ApprovalOption {
+    readonly id: string;
+    readonly label: string;
+    readonly hotkey?: string;
+    readonly description?: string;
+    readonly requestsText?: boolean;
+    readonly textPrompt?: string;
+    readonly danger?: boolean;
+}
+export interface ApprovalDecision {
+    readonly optionId: string;
+    /** Free-text follow-up the user typed when the option had `requestsText: true`. */
+    readonly text?: string;
+}
+export interface ApprovalResolver {
+    readonly name: string;
+    confirm(req: ApprovalRequest): Promise<ApprovalDecision>;
+}
+export interface LoopStrategyDef {
+    readonly name: string;
+    run(ctx: LoopContext): AsyncIterable<MoxxyEvent>;
+}
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"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"}

package/dist/loop.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

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

package/dist/plugin-kind.d.ts

@@ -0,0 +1,10 @@
+export declare const PLUGIN_KINDS: readonly ["tools", "provider", "mode", "compactor", "cache-strategy", "view-renderer", "tunnel-provider", "mcp", "cli", "channel", "hooks", "agent", "command", "transcriber", "ui"];
+export type PluginKind = (typeof PLUGIN_KINDS)[number];
+export interface PluginKindCarrier {
+    readonly kind?: PluginKind | ReadonlyArray<PluginKind>;
+}
+export declare function pluginKindList(kind: PluginKindCarrier['kind']): ReadonlyArray<PluginKind>;
+export declare function isPureUiPluginManifest(manifest: PluginKindCarrier): boolean;
+/** True when the manifest declares `kind: 'ui'` (alone or alongside others). */
+export declare function isUiPluginManifest(manifest: PluginKindCarrier): boolean;
+//# sourceMappingURL=plugin-kind.d.ts.map

package/dist/plugin-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-kind.d.ts","sourceRoot":"","sources":["../src/plugin-kind.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,sLAgBf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;CACxD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAGzF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAG3E;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAEvE"}

package/dist/plugin-kind.js

@@ -0,0 +1,31 @@
+export const PLUGIN_KINDS = [
+    'tools',
+    'provider',
+    'mode',
+    'compactor',
+    'cache-strategy',
+    'view-renderer',
+    'tunnel-provider',
+    'mcp',
+    'cli',
+    'channel',
+    'hooks',
+    'agent',
+    'command',
+    'transcriber',
+    'ui',
+];
+export function pluginKindList(kind) {
+    if (!kind)
+        return [];
+    return typeof kind === 'string' ? [kind] : kind;
+}
+export function isPureUiPluginManifest(manifest) {
+    const kinds = pluginKindList(manifest.kind);
+    return kinds.length === 1 && kinds[0] === 'ui';
+}
+/** True when the manifest declares `kind: 'ui'` (alone or alongside others). */
+export function isUiPluginManifest(manifest) {
+    return pluginKindList(manifest.kind).includes('ui');
+}
+//# sourceMappingURL=plugin-kind.js.map

package/dist/plugin-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-kind.js","sourceRoot":"","sources":["../src/plugin-kind.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO;IACP,UAAU;IACV,MAAM;IACN,WAAW;IACX,gBAAgB;IAChB,eAAe;IACf,iBAAiB;IACjB,KAAK;IACL,KAAK;IACL,SAAS;IACT,OAAO;IACP,OAAO;IACP,SAAS;IACT,aAAa;IACb,IAAI;CACI,CAAC;AAQX,MAAM,UAAU,cAAc,CAAC,IAA+B;IAC5D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA2B;IAChE,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AACjD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,QAA2B;IAC5D,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC"}

package/dist/schemas.d.ts

@@ -9,20 +9,20 @@ export declare const requirementSchema: z.ZodObject<{
     hint: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    kind: "tool" | "plugin" | "compactor" | "provider" | "mode" | "channel" | "agent" | "command" | "transcriber" | "runtime";
-    hint?: string | undefined;
-    reason?: string | undefined;
+    kind: "provider" | "mode" | "compactor" | "channel" | "agent" | "command" | "transcriber" | "plugin" | "tool" | "runtime";
     version?: string | undefined;
+    reason?: string | undefined;
     state?: "registered" | "active" | "ready" | undefined;
     optional?: boolean | undefined;
+    hint?: string | undefined;
 }, {
     name: string;
-    kind: "tool" | "plugin" | "compactor" | "provider" | "mode" | "channel" | "agent" | "command" | "transcriber" | "runtime";
-    hint?: string | undefined;
-    reason?: string | undefined;
+    kind: "provider" | "mode" | "compactor" | "channel" | "agent" | "command" | "transcriber" | "plugin" | "tool" | "runtime";
     version?: string | undefined;
+    reason?: string | undefined;
     state?: "registered" | "active" | "ready" | undefined;
     optional?: boolean | undefined;
+    hint?: string | undefined;
 }>;
 /**
  * Optional schedule block on a skill. When present, the scheduler
@@ -135,11 +135,11 @@ export declare const pluginManifestSchema: z.ZodObject<{
     skills: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     entry: string;
-    kind?: "compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
+    kind?: "tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
     skills?: string | undefined;
 }, {
     entry: string;
-    kind?: "compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
+    kind?: "tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
     skills?: string | undefined;
 }>;
 /**
@@ -159,11 +159,11 @@ export declare const moxxyPackageSchema: z.ZodObject<{
         skills: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         entry: string;
-        kind?: "compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
+        kind?: "tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
         skills?: string | undefined;
     }, {
         entry: string;
-        kind?: "compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
+        kind?: "tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
         skills?: string | undefined;
     }>>;
     requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -176,50 +176,50 @@ export declare const moxxyPackageSchema: z.ZodObject<{
         hint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        kind: "tool" | "plugin" | "compactor" | "provider" | "mode" | "channel" | "agent" | "command" | "transcriber" | "runtime";
-        hint?: string | undefined;
-        reason?: string | undefined;
+        kind: "provider" | "mode" | "compactor" | "channel" | "agent" | "command" | "transcriber" | "plugin" | "tool" | "runtime";
         version?: string | undefined;
+        reason?: string | undefined;
         state?: "registered" | "active" | "ready" | undefined;
         optional?: boolean | undefined;
+        hint?: string | undefined;
     }, {
         name: string;
-        kind: "tool" | "plugin" | "compactor" | "provider" | "mode" | "channel" | "agent" | "command" | "transcriber" | "runtime";
-        hint?: string | undefined;
-        reason?: string | undefined;
+        kind: "provider" | "mode" | "compactor" | "channel" | "agent" | "command" | "transcriber" | "plugin" | "tool" | "runtime";
         version?: string | undefined;
+        reason?: string | undefined;
         state?: "registered" | "active" | "ready" | undefined;
         optional?: boolean | undefined;
+        hint?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     plugin?: {
         entry: string;
-        kind?: "compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
+        kind?: "tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
         skills?: string | undefined;
     } | undefined;
     requirements?: {
         name: string;
-        kind: "tool" | "plugin" | "compactor" | "provider" | "mode" | "channel" | "agent" | "command" | "transcriber" | "runtime";
-        hint?: string | undefined;
-        reason?: string | undefined;
+        kind: "provider" | "mode" | "compactor" | "channel" | "agent" | "command" | "transcriber" | "plugin" | "tool" | "runtime";
         version?: string | undefined;
+        reason?: string | undefined;
         state?: "registered" | "active" | "ready" | undefined;
         optional?: boolean | undefined;
+        hint?: string | undefined;
     }[] | undefined;
 }, {
     plugin?: {
         entry: string;
-        kind?: "compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("compactor" | "tools" | "provider" | "mode" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
+        kind?: "tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber" | ("tools" | "provider" | "mode" | "compactor" | "cache-strategy" | "view-renderer" | "tunnel-provider" | "mcp" | "cli" | "channel" | "hooks" | "agent" | "command" | "transcriber")[] | undefined;
         skills?: string | undefined;
     } | undefined;
     requirements?: {
         name: string;
-        kind: "tool" | "plugin" | "compactor" | "provider" | "mode" | "channel" | "agent" | "command" | "transcriber" | "runtime";
-        hint?: string | undefined;
-        reason?: string | undefined;
+        kind: "provider" | "mode" | "compactor" | "channel" | "agent" | "command" | "transcriber" | "plugin" | "tool" | "runtime";
         version?: string | undefined;
+        reason?: string | undefined;
         state?: "registered" | "active" | "ready" | undefined;
         optional?: boolean | undefined;
+        hint?: string | undefined;
     }[] | undefined;
 }>;
 export type SkillFrontmatterInput = z.infer<typeof skillFrontmatterSchema>;

package/package.json

@@ -1,7 +1,42 @@
 {
   "name": "@moxxy/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Typed public surface for the moxxy framework: event types, define* factories, lifecycle hook signatures.",
+  "keywords": [
+    "moxxy",
+    "agent",
+    "agents",
+    "agent-framework",
+    "ai",
+    "llm",
+    "anthropic",
+    "claude",
+    "openai",
+    "gpt",
+    "plugin",
+    "plugin-sdk",
+    "sdk",
+    "tools",
+    "tool-use",
+    "mcp",
+    "typescript",
+    "zero-deps"
+  ],
+  "homepage": "https://moxxy.ai",
+  "bugs": {
+    "url": "https://github.com/moxxy-ai/new_moxxy/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moxxy-ai/new_moxxy.git",
+    "directory": "packages/sdk"
+  },
+  "author": "Michal Makowski <michal.makowski97@gmail.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.10.0"
+  },
+  "sideEffects": false,
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,26 +48,27 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "README.md"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "peerDependencies": {
-    "zod": "^3.24.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.3",
-    "vitest": "^2.1.8",
-    "zod": "^3.24.0",
-    "@moxxy/tsconfig": "0.0.0",
-    "@moxxy/vitest-preset": "0.0.0"
-  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
     "clean": "rm -rf dist .turbo"
+  },
+  "peerDependencies": {
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@moxxy/tsconfig": "workspace:*",
+    "@moxxy/vitest-preset": "workspace:*",
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "zod": "catalog:"
   }
-}
+}