@wrongstack/runtime 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ECOSTACK TECHNOLOGY OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# @wrongstack/runtime
+
+Default runtime implementations and host composition types for WrongStack.
+
+`@wrongstack/core` should stay focused on the agent kernel, public contracts,
+registries, and lifecycle primitives. This package is the migration target for
+concrete defaults such as storage, config, permissions, metrics, compaction,
+models, skills, and host-level assembly helpers.
+
+In the first refactor slice, runtime re-exports the existing default
+implementations from `@wrongstack/core/defaults`. That lets CLI, TUI, WebUI,
+and future hosts start importing defaults from `@wrongstack/runtime` while the
+physical module moves happen incrementally.
+
+```ts
+import { DefaultSessionStore, DefaultPermissionPolicy } from '@wrongstack/runtime';
+import { Agent, Container, EventBus } from '@wrongstack/core';
+```
+
+The `WrongStackPack` interface in `@wrongstack/runtime/pack` is the target shape
+for extension packages that contribute tools, providers, slash commands, or
+agent lifecycle extensions.

package/dist/host.d.ts

@@ -0,0 +1,45 @@
+import '@wrongstack/core/defaults';
+import '@wrongstack/core/infrastructure';
+import { PluginAPI, Agent, Context, EventBus, ToolRegistry, ProviderRegistry, SlashCommandRegistry, SessionWriter, ExtensionRegistry } from '@wrongstack/core';
+import { WrongStackPack } from './pack.js';
+
+interface RuntimeHost {
+    agent: Agent;
+    context: Context;
+    events: EventBus;
+    tools: ToolRegistry;
+    providers: ProviderRegistry;
+    slashCommands: SlashCommandRegistry;
+    session: SessionWriter;
+    extensions?: ExtensionRegistry;
+    shutdown(): Promise<void>;
+}
+interface RuntimeHostParts {
+    agent: Agent;
+    context: Context;
+    events: EventBus;
+    tools: ToolRegistry;
+    providers: ProviderRegistry;
+    slashCommands: SlashCommandRegistry;
+    session: SessionWriter;
+    extensions?: ExtensionRegistry;
+    shutdown?: () => void | Promise<void>;
+}
+declare function createRuntimeHostFromParts(parts: RuntimeHostParts): RuntimeHost;
+interface ApplyPackOptions {
+    owner?: string;
+    api?: PluginAPI;
+}
+interface AppliedPack {
+    pack: WrongStackPack;
+    owner: string;
+    teardown(): Promise<void>;
+}
+declare function applyWrongStackPack(host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {
+    extensions?: ExtensionRegistry;
+}, pack: WrongStackPack, opts?: ApplyPackOptions): Promise<AppliedPack>;
+declare function applyWrongStackPacks(host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {
+    extensions?: ExtensionRegistry;
+}, packs: readonly WrongStackPack[], opts?: ApplyPackOptions): Promise<AppliedPack[]>;
+
+export { type AppliedPack, type ApplyPackOptions, type RuntimeHost, type RuntimeHostParts, applyWrongStackPack, applyWrongStackPacks, createRuntimeHostFromParts };

package/dist/host.js

@@ -0,0 +1,73 @@
+// src/host.ts
+function createRuntimeHostFromParts(parts) {
+  return {
+    agent: parts.agent,
+    context: parts.context,
+    events: parts.events,
+    tools: parts.tools,
+    providers: parts.providers,
+    slashCommands: parts.slashCommands,
+    session: parts.session,
+    extensions: parts.extensions,
+    async shutdown() {
+      await parts.shutdown?.();
+    }
+  };
+}
+async function applyWrongStackPack(host, pack, opts = {}) {
+  const owner = opts.owner ?? pack.name;
+  const unregisterExtensions = [];
+  if (pack.tools) {
+    host.tools.registerAllOrThrow([...pack.tools], owner);
+  }
+  if (pack.providers) {
+    host.providers.registerAll([...pack.providers]);
+  }
+  if (pack.slashCommands) {
+    host.slashCommands.registerAll([...pack.slashCommands], owner);
+  }
+  if (pack.extensions && host.extensions) {
+    for (const ext of pack.extensions) {
+      unregisterExtensions.push(host.extensions.register(ext));
+    }
+  }
+  if (pack.setup) {
+    if (!opts.api) {
+      throw new Error(`Pack "${pack.name}" defines setup() but no PluginAPI was provided`);
+    }
+    await pack.setup(opts.api);
+  }
+  return {
+    pack,
+    owner,
+    async teardown() {
+      for (const unregister of unregisterExtensions.reverse()) {
+        unregister();
+      }
+      if (pack.teardown) {
+        if (!opts.api) {
+          throw new Error(`Pack "${pack.name}" defines teardown() but no PluginAPI was provided`);
+        }
+        await pack.teardown(opts.api);
+      }
+    }
+  };
+}
+async function applyWrongStackPacks(host, packs, opts = {}) {
+  const applied = [];
+  try {
+    for (const pack of packs) {
+      applied.push(await applyWrongStackPack(host, pack, opts));
+    }
+    return applied;
+  } catch (err) {
+    for (const mounted of applied.reverse()) {
+      await mounted.teardown().catch(() => void 0);
+    }
+    throw err;
+  }
+}
+
+export { applyWrongStackPack, applyWrongStackPacks, createRuntimeHostFromParts };
+//# sourceMappingURL=host.js.map
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/host.ts"],"names":[],"mappings":"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","file":"host.js","sourcesContent":["import type {\n  Agent,\n  Context,\n  EventBus,\n  ExtensionRegistry,\n  PluginAPI,\n  ProviderRegistry,\n  SessionWriter,\n  SlashCommandRegistry,\n  ToolRegistry,\n} from '@wrongstack/core';\nimport type { WrongStackPack } from './pack.js';\n\nexport interface RuntimeHost {\n  agent: Agent;\n  context: Context;\n  events: EventBus;\n  tools: ToolRegistry;\n  providers: ProviderRegistry;\n  slashCommands: SlashCommandRegistry;\n  session: SessionWriter;\n  extensions?: ExtensionRegistry;\n  shutdown(): Promise<void>;\n}\n\nexport interface RuntimeHostParts {\n  agent: Agent;\n  context: Context;\n  events: EventBus;\n  tools: ToolRegistry;\n  providers: ProviderRegistry;\n  slashCommands: SlashCommandRegistry;\n  session: SessionWriter;\n  extensions?: ExtensionRegistry;\n  shutdown?: () => void | Promise<void>;\n}\n\nexport function createRuntimeHostFromParts(parts: RuntimeHostParts): RuntimeHost {\n  return {\n    agent: parts.agent,\n    context: parts.context,\n    events: parts.events,\n    tools: parts.tools,\n    providers: parts.providers,\n    slashCommands: parts.slashCommands,\n    session: parts.session,\n    extensions: parts.extensions,\n    async shutdown() {\n      await parts.shutdown?.();\n    },\n  };\n}\n\nexport interface ApplyPackOptions {\n  owner?: string;\n  api?: PluginAPI;\n}\n\nexport interface AppliedPack {\n  pack: WrongStackPack;\n  owner: string;\n  teardown(): Promise<void>;\n}\n\nexport async function applyWrongStackPack(\n  host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {\n    extensions?: ExtensionRegistry;\n  },\n  pack: WrongStackPack,\n  opts: ApplyPackOptions = {},\n): Promise<AppliedPack> {\n  const owner = opts.owner ?? pack.name;\n  const unregisterExtensions: Array<() => void> = [];\n\n  if (pack.tools) {\n    host.tools.registerAllOrThrow([...pack.tools], owner);\n  }\n  if (pack.providers) {\n    host.providers.registerAll([...pack.providers]);\n  }\n  if (pack.slashCommands) {\n    host.slashCommands.registerAll([...pack.slashCommands], owner);\n  }\n  if (pack.extensions && host.extensions) {\n    for (const ext of pack.extensions) {\n      unregisterExtensions.push(host.extensions.register(ext));\n    }\n  }\n  if (pack.setup) {\n    if (!opts.api) {\n      throw new Error(`Pack \"${pack.name}\" defines setup() but no PluginAPI was provided`);\n    }\n    await pack.setup(opts.api);\n  }\n\n  return {\n    pack,\n    owner,\n    async teardown() {\n      for (const unregister of unregisterExtensions.reverse()) {\n        unregister();\n      }\n      if (pack.teardown) {\n        if (!opts.api) {\n          throw new Error(`Pack \"${pack.name}\" defines teardown() but no PluginAPI was provided`);\n        }\n        await pack.teardown(opts.api);\n      }\n    },\n  };\n}\n\nexport async function applyWrongStackPacks(\n  host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {\n    extensions?: ExtensionRegistry;\n  },\n  packs: readonly WrongStackPack[],\n  opts: ApplyPackOptions = {},\n): Promise<AppliedPack[]> {\n  const applied: AppliedPack[] = [];\n  try {\n    for (const pack of packs) {\n      applied.push(await applyWrongStackPack(host, pack, opts));\n    }\n    return applied;\n  } catch (err) {\n    for (const mounted of applied.reverse()) {\n      await mounted.teardown().catch(() => undefined);\n    }\n    throw err;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from '@wrongstack/core/defaults';
+export { DefaultPathResolver, DefaultTokenCounter } from '@wrongstack/core/infrastructure';
+export { DefaultSystemPromptBuilder, DefaultSystemPromptBuilderOptions } from '@wrongstack/core';
+export { WrongStackPack } from './pack.js';
+export { AppliedPack, ApplyPackOptions, RuntimeHost, RuntimeHostParts, applyWrongStackPack, applyWrongStackPacks, createRuntimeHostFromParts } from './host.js';

package/dist/index.js

@@ -0,0 +1,79 @@
+export * from '@wrongstack/core/defaults';
+export { DefaultPathResolver, DefaultTokenCounter } from '@wrongstack/core/infrastructure';
+export { DefaultSystemPromptBuilder } from '@wrongstack/core';
+
+// src/index.ts
+
+// src/host.ts
+function createRuntimeHostFromParts(parts) {
+  return {
+    agent: parts.agent,
+    context: parts.context,
+    events: parts.events,
+    tools: parts.tools,
+    providers: parts.providers,
+    slashCommands: parts.slashCommands,
+    session: parts.session,
+    extensions: parts.extensions,
+    async shutdown() {
+      await parts.shutdown?.();
+    }
+  };
+}
+async function applyWrongStackPack(host, pack, opts = {}) {
+  const owner = opts.owner ?? pack.name;
+  const unregisterExtensions = [];
+  if (pack.tools) {
+    host.tools.registerAllOrThrow([...pack.tools], owner);
+  }
+  if (pack.providers) {
+    host.providers.registerAll([...pack.providers]);
+  }
+  if (pack.slashCommands) {
+    host.slashCommands.registerAll([...pack.slashCommands], owner);
+  }
+  if (pack.extensions && host.extensions) {
+    for (const ext of pack.extensions) {
+      unregisterExtensions.push(host.extensions.register(ext));
+    }
+  }
+  if (pack.setup) {
+    if (!opts.api) {
+      throw new Error(`Pack "${pack.name}" defines setup() but no PluginAPI was provided`);
+    }
+    await pack.setup(opts.api);
+  }
+  return {
+    pack,
+    owner,
+    async teardown() {
+      for (const unregister of unregisterExtensions.reverse()) {
+        unregister();
+      }
+      if (pack.teardown) {
+        if (!opts.api) {
+          throw new Error(`Pack "${pack.name}" defines teardown() but no PluginAPI was provided`);
+        }
+        await pack.teardown(opts.api);
+      }
+    }
+  };
+}
+async function applyWrongStackPacks(host, packs, opts = {}) {
+  const applied = [];
+  try {
+    for (const pack of packs) {
+      applied.push(await applyWrongStackPack(host, pack, opts));
+    }
+    return applied;
+  } catch (err) {
+    for (const mounted of applied.reverse()) {
+      await mounted.teardown().catch(() => void 0);
+    }
+    throw err;
+  }
+}
+
+export { applyWrongStackPack, applyWrongStackPacks, createRuntimeHostFromParts };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/host.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  Agent,\n  Context,\n  EventBus,\n  ExtensionRegistry,\n  PluginAPI,\n  ProviderRegistry,\n  SessionWriter,\n  SlashCommandRegistry,\n  ToolRegistry,\n} from '@wrongstack/core';\nimport type { WrongStackPack } from './pack.js';\n\nexport interface RuntimeHost {\n  agent: Agent;\n  context: Context;\n  events: EventBus;\n  tools: ToolRegistry;\n  providers: ProviderRegistry;\n  slashCommands: SlashCommandRegistry;\n  session: SessionWriter;\n  extensions?: ExtensionRegistry;\n  shutdown(): Promise<void>;\n}\n\nexport interface RuntimeHostParts {\n  agent: Agent;\n  context: Context;\n  events: EventBus;\n  tools: ToolRegistry;\n  providers: ProviderRegistry;\n  slashCommands: SlashCommandRegistry;\n  session: SessionWriter;\n  extensions?: ExtensionRegistry;\n  shutdown?: () => void | Promise<void>;\n}\n\nexport function createRuntimeHostFromParts(parts: RuntimeHostParts): RuntimeHost {\n  return {\n    agent: parts.agent,\n    context: parts.context,\n    events: parts.events,\n    tools: parts.tools,\n    providers: parts.providers,\n    slashCommands: parts.slashCommands,\n    session: parts.session,\n    extensions: parts.extensions,\n    async shutdown() {\n      await parts.shutdown?.();\n    },\n  };\n}\n\nexport interface ApplyPackOptions {\n  owner?: string;\n  api?: PluginAPI;\n}\n\nexport interface AppliedPack {\n  pack: WrongStackPack;\n  owner: string;\n  teardown(): Promise<void>;\n}\n\nexport async function applyWrongStackPack(\n  host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {\n    extensions?: ExtensionRegistry;\n  },\n  pack: WrongStackPack,\n  opts: ApplyPackOptions = {},\n): Promise<AppliedPack> {\n  const owner = opts.owner ?? pack.name;\n  const unregisterExtensions: Array<() => void> = [];\n\n  if (pack.tools) {\n    host.tools.registerAllOrThrow([...pack.tools], owner);\n  }\n  if (pack.providers) {\n    host.providers.registerAll([...pack.providers]);\n  }\n  if (pack.slashCommands) {\n    host.slashCommands.registerAll([...pack.slashCommands], owner);\n  }\n  if (pack.extensions && host.extensions) {\n    for (const ext of pack.extensions) {\n      unregisterExtensions.push(host.extensions.register(ext));\n    }\n  }\n  if (pack.setup) {\n    if (!opts.api) {\n      throw new Error(`Pack \"${pack.name}\" defines setup() but no PluginAPI was provided`);\n    }\n    await pack.setup(opts.api);\n  }\n\n  return {\n    pack,\n    owner,\n    async teardown() {\n      for (const unregister of unregisterExtensions.reverse()) {\n        unregister();\n      }\n      if (pack.teardown) {\n        if (!opts.api) {\n          throw new Error(`Pack \"${pack.name}\" defines teardown() but no PluginAPI was provided`);\n        }\n        await pack.teardown(opts.api);\n      }\n    },\n  };\n}\n\nexport async function applyWrongStackPacks(\n  host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {\n    extensions?: ExtensionRegistry;\n  },\n  packs: readonly WrongStackPack[],\n  opts: ApplyPackOptions = {},\n): Promise<AppliedPack[]> {\n  const applied: AppliedPack[] = [];\n  try {\n    for (const pack of packs) {\n      applied.push(await applyWrongStackPack(host, pack, opts));\n    }\n    return applied;\n  } catch (err) {\n    for (const mounted of applied.reverse()) {\n      await mounted.teardown().catch(() => undefined);\n    }\n    throw err;\n  }\n}\n"]}

package/dist/pack.d.ts

@@ -0,0 +1,28 @@
+import { Tool, ProviderFactory, SlashCommand, AgentExtension, PluginAPI } from '@wrongstack/core';
+
+/**
+ * A first-party or third-party capability bundle that can be mounted by a
+ * host runtime. Tools, providers, MCP integrations, UI surfaces, and director
+ * features should converge on this shape instead of being hard-wired into CLI
+ * boot code.
+ */
+interface WrongStackPack {
+    /** Stable package/pack id, e.g. "builtin-tools" or "mcp". */
+    name: string;
+    /** Human-readable one-line description for diagnostics and package lists. */
+    description?: string;
+    /** Tools to register into the host ToolRegistry. */
+    tools?: readonly Tool[];
+    /** Provider factories to register into the host ProviderRegistry. */
+    providers?: readonly ProviderFactory[];
+    /** Slash commands to register into REPL/TUI surfaces. */
+    slashCommands?: readonly SlashCommand[];
+    /** Agent lifecycle extensions to register. */
+    extensions?: readonly AgentExtension[];
+    /** Optional imperative setup for packs that need host APIs. */
+    setup?(api: PluginAPI): void | Promise<void>;
+    /** Optional best-effort teardown for resources started by setup(). */
+    teardown?(api: PluginAPI): void | Promise<void>;
+}
+
+export type { WrongStackPack };

package/dist/pack.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=pack.js.map
+//# sourceMappingURL=pack.js.map

package/dist/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"pack.js"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@wrongstack/runtime",
+  "version": "0.2.0",
+  "license": "MIT",
+  "description": "WrongStack default runtime implementations and host-level composition helpers built on @wrongstack/core.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WrongStack/WrongStack.git",
+    "directory": "packages/runtime"
+  },
+  "homepage": "https://github.com/WrongStack/WrongStack#readme",
+  "bugs": "https://github.com/WrongStack/WrongStack/issues",
+  "author": "ECOSTACK TECHNOLOGY OU",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pack": {
+      "types": "./dist/pack.d.ts",
+      "import": "./dist/pack.js"
+    },
+    "./host": {
+      "types": "./dist/host.d.ts",
+      "import": "./dist/host.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@wrongstack/core": "0.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.19",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}