@zhin.js/plugin-lottery 1.0.2 → 1.0.4

package/agent/runtime-tools.ts

@@ -0,0 +1,57 @@
+/**
+ * Bridge agent/tools/* authoring definitions into the Plugin Runtime Agent Host.
+ * Loaded lazily from plugin.ts only when agentToolsHostToken is present, so
+ * IM-only installs never pull @zhin.js/agent into the module graph.
+ * Lives outside src/ (like the other agent/ authoring files) and is therefore
+ * not part of the tsc build — the Plugin Runtime loads it from source.
+ */
+import type { AgentToolsHost } from '@zhin.js/plugin-runtime';
+import syncTool from './tools/sync.js';
+import computeRecommendTool from './tools/compute_recommend.js';
+import historyTool from './tools/history.js';
+import getModelStateTool from './tools/get_model_state.js';
+import listPendingTool from './tools/list_pending.js';
+import savePredictionTool from './tools/save_prediction.js';
+import statsSnapshotTool from './tools/stats_snapshot.js';
+
+interface AuthoringToolLike {
+  readonly description: string;
+  readonly inputSchema?: unknown;
+  readonly keywords?: readonly string[];
+  readonly tags?: readonly string[];
+  readonly platforms?: readonly string[];
+  readonly scopes?: readonly ('private' | 'group' | 'channel')[];
+  readonly permissions?: readonly string[];
+  readonly hidden?: boolean;
+  execute(input: never, ctx?: unknown): unknown | Promise<unknown>;
+}
+
+const TOOLS: ReadonlyArray<readonly [string, AuthoringToolLike]> = [
+  ['lottery_sync', syncTool as AuthoringToolLike],
+  ['lottery_compute_recommend', computeRecommendTool as AuthoringToolLike],
+  ['lottery_history', historyTool as AuthoringToolLike],
+  ['lottery_get_model_state', getModelStateTool as AuthoringToolLike],
+  ['lottery_list_pending', listPendingTool as AuthoringToolLike],
+  ['lottery_save_prediction', savePredictionTool as AuthoringToolLike],
+  ['lottery_stats_snapshot', statsSnapshotTool as AuthoringToolLike],
+];
+
+/** Register every lottery agent tool for this generation; returns disposal. */
+export function registerLotteryAgentTools(host: AgentToolsHost): () => void {
+  const disposers = TOOLS.map(([name, tool]) => host.register({
+    name,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+    source: 'lottery',
+    ...(tool.keywords ? { keywords: tool.keywords } : {}),
+    ...(tool.tags ? { tags: tool.tags } : {}),
+    ...(tool.platforms ? { platforms: tool.platforms } : {}),
+    ...(tool.scopes ? { scopes: tool.scopes } : {}),
+    ...(tool.permissions ? { permissions: tool.permissions } : {}),
+    ...(tool.hidden !== undefined ? { hidden: tool.hidden } : {}),
+    execute: (input) => tool.execute(input as never, { pluginName: 'lottery', runtimeName: name }),
+  }));
+  return () => {
+    for (const dispose of disposers.splice(0)) dispose();
+  };
+}

package/lib/lottery-agent-deps.d.ts

@@ -2,6 +2,7 @@
  * Shared runtime deps for lottery agent/ authoring tools.
  * Set once from plugin index during init — never call getPlugin() from tool execute.
  */
+import { type Dispose } from '@zhin.js/plugin-runtime';
 import type { GameId } from './types.js';
 import type { LotteryDb } from './db.js';
 import type { Kl8Config } from './games/kl8-groups.js';
@@ -18,7 +19,11 @@ export interface LotteryAgentDeps {
     pipelinePush: boolean;
 }
 export declare function setLotteryAgentDeps(deps: LotteryAgentDeps): void;
-/** Generation-owned Agent dependency binding used by Plugin Runtime setup(). */
-export declare function registerLotteryAgentDeps(deps: LotteryAgentDeps): () => void;
+/**
+ * Generation-owned Agent dependency binding used by Plugin Runtime setup().
+ * The fresh lifecycle is detached: callers own the returned dispose (setup()
+ * hooks it into context.lifecycle); provide() does not retain the context.
+ */
+export declare function registerLotteryAgentDeps(deps: LotteryAgentDeps): Dispose;
 export declare function getLotteryAgentDeps(): LotteryAgentDeps;
 //# sourceMappingURL=lottery-agent-deps.d.ts.map

package/lib/lottery-agent-deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lottery-agent-deps.d.ts","sourceRoot":"","sources":["../src/lottery-agent-deps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC;IAC7E,YAAY,EAAE,MAAM,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;CACvB;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAEhE;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAO3E;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAItD"}
+{"version":3,"file":"lottery-agent-deps.d.ts","sourceRoot":"","sources":["../src/lottery-agent-deps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC;IAC7E,YAAY,EAAE,MAAM,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;CACvB;AAMD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAExE;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAItD"}

package/lib/lottery-agent-deps.js

@@ -1,20 +1,23 @@
+/**
+ * Shared runtime deps for lottery agent/ authoring tools.
+ * Set once from plugin index during init — never call getPlugin() from tool execute.
+ */
+import { createGenerationStore, DisposeStack } from '@zhin.js/plugin-runtime';
+const agentDepsStore = createGenerationStore('lottery/agent-deps');
 let _deps = null;
-const registrations = [];
 export function setLotteryAgentDeps(deps) {
     _deps = deps;
 }
-/** Generation-owned Agent dependency binding used by Plugin Runtime setup(). */
+/**
+ * Generation-owned Agent dependency binding used by Plugin Runtime setup().
+ * The fresh lifecycle is detached: callers own the returned dispose (setup()
+ * hooks it into context.lifecycle); provide() does not retain the context.
+ */
 export function registerLotteryAgentDeps(deps) {
-    const registration = Object.freeze({ value: deps });
-    registrations.push(registration);
-    return () => {
-        const index = registrations.lastIndexOf(registration);
-        if (index >= 0)
-            registrations.splice(index, 1);
-    };
+    return agentDepsStore.provide({ lifecycle: new DisposeStack() }, deps);
 }
 export function getLotteryAgentDeps() {
-    const deps = registrations[registrations.length - 1]?.value ?? _deps;
+    const deps = agentDepsStore.tryUse() ?? _deps;
     if (!deps)
         throw new Error('lottery agent deps not initialized');
     return deps;

package/lib/lottery-agent-deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"lottery-agent-deps.js","sourceRoot":"","sources":["../src/lottery-agent-deps.ts"],"names":[],"mappings":"AAiBA,IAAI,KAAK,GAA4B,IAAI,CAAC;AAC1C,MAAM,aAAa,GAAgD,EAAE,CAAC;AAEtE,MAAM,UAAU,mBAAmB,CAAC,IAAsB;IACxD,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,wBAAwB,CAAC,IAAsB;IAC7D,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjC,OAAO,GAAG,EAAE;QACV,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,KAAK,IAAI,CAAC;YAAE,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,KAAK,CAAC;IACrE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"lottery-agent-deps.js","sourceRoot":"","sources":["../src/lottery-agent-deps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAgB,MAAM,yBAAyB,CAAC;AAc5F,MAAM,cAAc,GAAG,qBAAqB,CAAmB,oBAAoB,CAAC,CAAC;AAErF,IAAI,KAAK,GAA4B,IAAI,CAAC;AAE1C,MAAM,UAAU,mBAAmB,CAAC,IAAsB;IACxD,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAsB;IAC7D,OAAO,cAAc,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,YAAY,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-lottery",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Multi-game lottery analysis for Zhin.js (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
@@ -41,18 +41,18 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@zhin.js/plugin-runtime": "1.0.1",
-    "@zhin.js/command": "1.0.1"
+    "@zhin.js/command": "1.0.3",
+    "@zhin.js/plugin-runtime": "1.1.1"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.0.4"
+    "@zhin.js/agent": "1.0.6"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/agent": "1.0.4"
+    "@zhin.js/agent": "1.0.6"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {

package/plugin.ts

@@ -1,5 +1,6 @@
 import {
   definePlugin,
+  agentToolsHostToken,
   databaseHostToken,
   outboundHostToken,
   scheduleHostToken,
@@ -29,7 +30,7 @@ export default definePlugin<LotteryConfig>({
   metadata: {
     displayName: 'Lottery',
   },
-  setup(context) {
+  async setup(context) {
     const config = resolveLotteryConfig(context.config.get());
     const db = context.resources.has(databaseHostToken)
       ? context.resources.use(databaseHostToken)
@@ -74,6 +75,14 @@ export default definePlugin<LotteryConfig>({
       pipelinePush: config.pushTargets.length > 0,
     }));
 
+    // Agent tools (agent/tools/*): register into the Runtime Agent Host when AI
+    // is installed. Lazy import keeps @zhin.js/agent out of IM-only installs.
+    if (context.resources.has(agentToolsHostToken)) {
+      const agentTools = context.resources.use(agentToolsHostToken);
+      const { registerLotteryAgentTools } = await import('./agent/runtime-tools.js');
+      context.lifecycle.add(registerLotteryAgentTools(agentTools));
+    }
+
     if (!context.resources.has(scheduleHostToken) || !config.scheduleEnabled) {
       return;
     }

package/src/lottery-agent-deps.ts

@@ -2,6 +2,7 @@
  * Shared runtime deps for lottery agent/ authoring tools.
  * Set once from plugin index during init — never call getPlugin() from tool execute.
  */
+import { createGenerationStore, DisposeStack, type Dispose } from '@zhin.js/plugin-runtime';
 import type { GameId } from './types.js';
 import type { LotteryDb } from './db.js';
 import type { Kl8Config } from './games/kl8-groups.js';
@@ -15,25 +16,25 @@ export interface LotteryAgentDeps {
   pipelinePush: boolean;
 }
 
+const agentDepsStore = createGenerationStore<LotteryAgentDeps>('lottery/agent-deps');
+
 let _deps: LotteryAgentDeps | null = null;
-const registrations: Array<{ readonly value: LotteryAgentDeps }> = [];
 
 export function setLotteryAgentDeps(deps: LotteryAgentDeps): void {
   _deps = deps;
 }
 
-/** Generation-owned Agent dependency binding used by Plugin Runtime setup(). */
-export function registerLotteryAgentDeps(deps: LotteryAgentDeps): () => void {
-  const registration = Object.freeze({ value: deps });
-  registrations.push(registration);
-  return () => {
-    const index = registrations.lastIndexOf(registration);
-    if (index >= 0) registrations.splice(index, 1);
-  };
+/**
+ * Generation-owned Agent dependency binding used by Plugin Runtime setup().
+ * The fresh lifecycle is detached: callers own the returned dispose (setup()
+ * hooks it into context.lifecycle); provide() does not retain the context.
+ */
+export function registerLotteryAgentDeps(deps: LotteryAgentDeps): Dispose {
+  return agentDepsStore.provide({ lifecycle: new DisposeStack() }, deps);
 }
 
 export function getLotteryAgentDeps(): LotteryAgentDeps {
-  const deps = registrations[registrations.length - 1]?.value ?? _deps;
+  const deps = agentDepsStore.tryUse() ?? _deps;
   if (!deps) throw new Error('lottery agent deps not initialized');
   return deps;
 }