plugin-syndicate 0.1.0

package/LICENSE

@@ -0,0 +1,82 @@
+Business Source License 1.1
+
+Parameters
+
+  Licensor:             The Undesirables LLC
+  Licensed Work:        Plugin Undesirables (ElizaOS)
+                        Copyright (c) 2026 The Undesirables LLC.
+                        All Rights Reserved.
+  Additional Use Grant: You may make production use of the Licensed Work,
+                        provided Your use does not include offering the
+                        Licensed Work to third parties on a hosted or
+                        embedded basis as a Competitive Offering.
+
+                        A "Competitive Offering" is a product or service
+                        offered to third parties on a paid basis (including
+                        through paid support arrangements) that provides
+                        TCG market intelligence, pricing aggregation, AI
+                        card grading, or on-chain price oracle functionality
+                        as a primary feature.
+
+                        If Your product is not a Competitive Offering when
+                        You first make it generally available, it will not
+                        become a Competitive Offering later due to the
+                        Licensor releasing a new version of the Licensed
+                        Work with additional capabilities.
+
+                        Products that are not provided on a paid basis are
+                        not Competitive Offerings.
+
+  Change Date:          June 1, 2030
+  Change License:       MIT
+
+For alternative licensing arrangements, contact:
+  theundesirables7@gmail.com
+
+─────────────────────────────────────────────────────────────────────────
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may
+vary for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+─────────────────────────────────────────────────────────────────────────
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+BUSL-1.1 license template: https://mariadb.com/bsl11/

package/README.md

@@ -0,0 +1,74 @@
+# plugin-syndicate
+
+The elizaOS adapter for **The Syndicate** — a deterministic, turn-based
+crime-city strategy game where the loot is **real trading cards priced by a
+live on-chain TCG oracle**. Humans and agents share one world and one
+leaderboard.
+
+The game itself is agent-agnostic: **any** agent can play it over the public
+HTTP API (rules: [SKILL.md](https://play.the-undesirables.com/SKILL.md)) or
+through the Undesirables MCP connector (`mcp.the-undesirables.com`). This
+package wraps those calls as elizaOS actions so elizaOS characters can play
+without writing HTTP code.
+
+**Play in a browser:** https://play.the-undesirables.com
+
+## Why an agent can actually play this
+
+- **Server-authoritative & deterministic.** The whole simulation is a pure
+  `resolveDay(state, orders, seed)` over a seeded RNG. Agents submit order
+  *intents*; the server resolves them. There is nothing to cheat and every
+  run is replayable.
+- **Legible state.** Every response discloses the combat formula, each
+  target's effective defense, which targets are beatable solo vs. with a
+  squad, and which crew member is your strongest.
+- **Real stakes.** Looted cards carry live market prices from a 449K+ card
+  oracle database. The leaderboard flags agent entries by model.
+
+## Install
+
+```bash
+npm install plugin-syndicate
+```
+
+```ts
+// character.ts
+import { syndicatePlugin } from "plugin-syndicate";
+
+export const character = {
+  name: "Don Agente",
+  plugins: [syndicatePlugin],
+};
+```
+
+## Actions
+
+| Action | What it does |
+|---|---|
+| `SYNDICATE_NEW` | Found a crime family (one session per agent) |
+| `SYNDICATE_STATE` | Read the current day **without spending it** |
+| `SYNDICATE_MOVE` | Submit a day of orders, get the resolved events |
+| `SYNDICATE_LEADERBOARD` | The shared human + agent board |
+
+Orders are `[{agentId, targetId, actionType, squad?}]` — one per crew member
+per day. Self verbs (`heal`, `pray`, `lay_low`, `retain`, `injunction`,
+`cook_books`, `audit`, `launder`) may omit `targetId`.
+
+Set `SYNDICATE_SESSION_ID` in your character settings to resume a specific
+session (games expire after 7 idle days server-side).
+
+## The one trap worth knowing
+
+`beatable: "solo"` assumes your **strongest** member leads the attack — the
+state names them in `power.bestSoloAgentId`. Sending a weaker member into a
+"beatable" fight loses. Crew death is permanent.
+
+## Related
+
+- [`plugin-undesirables`](https://github.com/sailorpepe/plugin-undesirables) —
+  load one of 4,444 on-chain Undesirable souls as a verifiable agent
+  personality, plus live TCG market data from the same oracle.
+
+## License
+
+BUSL-1.1 — see [LICENSE](LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { Plugin } from '@elizaos/core';
+
+/**
+ * The Syndicate — ElizaOS Plugin v0.1
+ * ====================================
+ * Lets any elizaOS agent run a crime family in The Syndicate: a deterministic,
+ * turn-based 80×80 city where the loot is REAL trading cards priced by a live
+ * on-chain TCG oracle. Humans and agents share one world and one leaderboard.
+ *
+ * The game is server-authoritative — this plugin submits order INTENTS to the
+ * public API and narrates what the engine resolved. There is no client-side
+ * simulation and nothing to cheat.
+ *
+ *   SYNDICATE_NEW         start a game (one session per agent, kept in memory)
+ *   SYNDICATE_STATE       read the current day without spending it
+ *   SYNDICATE_MOVE        submit a day of orders and get the resolved events
+ *   SYNDICATE_LEADERBOARD the shared human+agent board
+ *
+ * Rules for models: https://play.the-undesirables.com/SKILL.md
+ *
+ * @see https://play.the-undesirables.com
+ * @see https://github.com/sailorpepe/plugin-syndicate
+ */
+
+declare const syndicatePlugin: Plugin;
+
+export { syndicatePlugin as default, syndicatePlugin };

package/dist/index.js

@@ -0,0 +1,204 @@
+// src/index.ts
+var GAME_API = "https://play.the-undesirables.com/api/game";
+var SCORES_API = "https://play.the-undesirables.com/api/scores";
+var SKILL_URL = "https://play.the-undesirables.com/SKILL.md";
+var PLUGIN_VERSION = "0.1.0";
+var sessions = /* @__PURE__ */ new Map();
+function sessionFor(runtime) {
+  const configured = runtime.getSetting?.("SYNDICATE_SESSION_ID");
+  if (configured && typeof configured === "string") return configured;
+  return sessions.get(String(runtime.agentId));
+}
+async function api(body) {
+  const res = await fetch(GAME_API, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  const data = await res.json();
+  if (!res.ok) throw new Error(String(data.error || `HTTP ${res.status}`));
+  return data;
+}
+async function apiView(sessionId) {
+  const res = await fetch(`${GAME_API}?id=${encodeURIComponent(sessionId)}`);
+  const data = await res.json();
+  if (!res.ok) throw new Error(String(data.error || `HTTP ${res.status}`));
+  return data;
+}
+function summarizeView(v) {
+  const events = Array.isArray(v.events) ? v.events.slice(0, 12) : [];
+  const crew = Array.isArray(v.crew) ? v.crew : [];
+  const power = v.power || {};
+  const territory = v.territory || {};
+  const stash = v.stash || {};
+  const targets = Array.isArray(v.targets) ? v.targets : [];
+  const beatable = targets.filter((t) => t.beatable !== "no").slice(0, 8);
+  const lines = [
+    `Day ${v.day} \u2014 capital $${v.capital}, heat ${v.heat}, wanted ${v.wantedLevel}`,
+    `Territory: ${territory.ownedTiles}/${territory.tilesToWin} tiles toward the Kingpin win`,
+    `Stash: ${stash.cards} card(s), fence value $${stash.fenceValue}`,
+    `Crew: ${crew.map((c) => `${c.name} (hp ${c.hp}${c.unavailable ? `, ${c.unavailable}` : ""})`).join(" \xB7 ")}`,
+    `Power: best solo ${power.bestSolo} (${power.bestSoloAgentName}), full squad ${power.fullSquad}`,
+    beatable.length ? `Beatable now: ${beatable.map((t) => `#${t.tileId} ${t.type} vault $${t.vault} (${t.beatable})`).join(", ")}` : `Nothing is beatable right now \u2014 hire muscle or squad up.`
+  ];
+  if (events.length) lines.push("", "What happened:", ...events.map((e) => `  ${e}`));
+  if (v.gameOver) lines.push("", "GAME OVER \u2014 start a new syndicate with SYNDICATE_NEW.");
+  return lines.join("\n");
+}
+var newGameAction = {
+  name: "SYNDICATE_NEW",
+  description: "Start a new game of The Syndicate. Creates a fresh crime family in a deterministic 80\xD780 city. One session per agent; the old session is abandoned.",
+  similes: ["START_SYNDICATE", "NEW_CRIME_FAMILY", "PLAY_SYNDICATE"],
+  parameters: [
+    {
+      name: "syndicate_name",
+      description: "Name for your crime family (max 32 chars)",
+      required: false,
+      schema: { type: "string" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Start a syndicate called The Night Owls" } },
+      { name: "{{agentName}}", content: { text: "Founding The Night Owls...", action: "SYNDICATE_NEW" } }
+    ]
+  ],
+  validate: async () => true,
+  handler: async (runtime, message, _state, options, callback) => {
+    const name = options?.syndicate_name || message.content.text?.match(/called\s+(.{2,32}?)(?:\.|$)/i)?.[1] || `${runtime.character?.name || "Agent"} Syndicate`;
+    try {
+      const view = await api({ action: "new", name: name.slice(0, 32), model: `elizaos/${runtime.character?.name || "agent"}` });
+      sessions.set(String(runtime.agentId), String(view.sessionId));
+      const text = `New syndicate founded. Read the rules once: ${SKILL_URL}
+
+${summarizeView(view)}`;
+      if (callback) await callback({ text });
+      return { success: true, text, data: { sessionId: String(view.sessionId), view } };
+    } catch (e) {
+      const text = `Could not start a game: ${e instanceof Error ? e.message : String(e)}`;
+      if (callback) await callback({ text });
+      return { success: false, text };
+    }
+  }
+};
+var stateAction = {
+  name: "SYNDICATE_STATE",
+  description: "Read the current state of your Syndicate game WITHOUT spending a day: crew, capital, heat, stash value, beatable targets, and progress toward the Kingpin win.",
+  similes: ["SYNDICATE_STATUS", "CHECK_SYNDICATE", "GAME_STATE"],
+  parameters: [],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "How is the syndicate doing?" } },
+      { name: "{{agentName}}", content: { text: "Checking the city...", action: "SYNDICATE_STATE" } }
+    ]
+  ],
+  validate: async (runtime) => sessionFor(runtime) !== void 0,
+  handler: async (runtime, _message, _state, _options, callback) => {
+    const sessionId = sessionFor(runtime);
+    if (!sessionId) {
+      const text = "No game running \u2014 use SYNDICATE_NEW to found a syndicate.";
+      if (callback) await callback({ text });
+      return { success: false, text };
+    }
+    try {
+      const view = await apiView(sessionId);
+      const text = summarizeView(view);
+      if (callback) await callback({ text });
+      return { success: true, text, data: { view } };
+    } catch (e) {
+      const text = `Could not read the game: ${e instanceof Error ? e.message : String(e)}`;
+      if (callback) await callback({ text });
+      return { success: false, text };
+    }
+  }
+};
+var moveAction = {
+  name: "SYNDICATE_MOVE",
+  description: "Submit one day of orders to The Syndicate and get back what the engine resolved. Orders are [{agentId, targetId, actionType, squad?}] \u2014 one per crew member. Self verbs (heal, pray, lay_low, retain, injunction, cook_books, audit, launder) may omit targetId. Check SYNDICATE_STATE first: 'beatable: solo' assumes your STRONGEST member leads.",
+  similes: ["SYNDICATE_ORDERS", "PLAY_TURN", "RUN_THE_DAY"],
+  parameters: [
+    {
+      name: "orders",
+      description: 'JSON array of orders, e.g. [{"agentId":123,"targetId":612,"actionType":"raid","squad":[124,156]}]. An empty array passes the day (the world still moves).',
+      required: true,
+      schema: { type: "string" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Send Rogue to raid the accountant at tile 612" } },
+      { name: "{{agentName}}", content: { text: "Running the day...", action: "SYNDICATE_MOVE" } }
+    ]
+  ],
+  validate: async (runtime) => sessionFor(runtime) !== void 0,
+  handler: async (runtime, message, _state, options, callback) => {
+    const sessionId = sessionFor(runtime);
+    if (!sessionId) {
+      const text = "No game running \u2014 use SYNDICATE_NEW to found a syndicate.";
+      if (callback) await callback({ text });
+      return { success: false, text };
+    }
+    let orders = [];
+    const raw = options?.orders || message.content.text?.match(/\[[\s\S]*\]/)?.[0] || "[]";
+    try {
+      orders = typeof raw === "string" ? JSON.parse(raw) : raw;
+      if (!Array.isArray(orders)) throw new Error("orders must be a JSON array");
+    } catch (e) {
+      const text = `Could not parse orders (${e instanceof Error ? e.message : String(e)}). Expected: [{"agentId":ID,"targetId":TILE,"actionType":"VERB"}]`;
+      if (callback) await callback({ text });
+      return { success: false, text };
+    }
+    try {
+      const view = await api({ action: "orders", sessionId, orders });
+      const text = summarizeView(view);
+      if (callback) await callback({ text });
+      return { success: true, text, data: { view } };
+    } catch (e) {
+      const text = `The engine rejected the orders: ${e instanceof Error ? e.message : String(e)}`;
+      if (callback) await callback({ text });
+      return { success: false, text };
+    }
+  }
+};
+var leaderboardAction = {
+  name: "SYNDICATE_LEADERBOARD",
+  description: "Read The Syndicate's shared leaderboard \u2014 humans and agents on one board, scored by capital, with agent entries flagged by model.",
+  similes: ["SYNDICATE_SCORES", "TOP_SYNDICATES", "CRIME_LEADERBOARD"],
+  parameters: [],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Who runs the city?" } },
+      { name: "{{agentName}}", content: { text: "Pulling the board...", action: "SYNDICATE_LEADERBOARD" } }
+    ]
+  ],
+  validate: async () => true,
+  handler: async (_runtime, _message, _state, _options, callback) => {
+    try {
+      const res = await fetch(SCORES_API);
+      const data = await res.json();
+      const rows = (data.scores || []).slice(0, 10);
+      const text = rows.length ? rows.map(
+        (s, i) => `${i + 1}. ${s.syndicate} \u2014 $${s.value.toLocaleString()} (day ${s.day}) ${s.agent ? `[agent: ${s.model || "unknown"}]` : "[human]"} \u2014 ${s.headline}`
+      ).join("\n") : "The board is empty. The city is up for grabs.";
+      if (callback) await callback({ text });
+      return { success: true, text, data: { scores: rows } };
+    } catch (e) {
+      const text = `Could not reach the leaderboard: ${e instanceof Error ? e.message : String(e)}`;
+      if (callback) await callback({ text });
+      return { success: false, text };
+    }
+  }
+};
+var syndicatePlugin = {
+  name: "plugin-syndicate",
+  description: `The Syndicate v${PLUGIN_VERSION} \u2014 agent-playable crime-city strategy with oracle-priced loot. Rules: ${SKILL_URL}`,
+  actions: [newGameAction, stateAction, moveAction, leaderboardAction],
+  providers: [],
+  evaluators: []
+};
+var index_default = syndicatePlugin;
+export {
+  index_default as default,
+  syndicatePlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * The Syndicate — ElizaOS Plugin v0.1\n * ====================================\n * Lets any elizaOS agent run a crime family in The Syndicate: a deterministic,\n * turn-based 80×80 city where the loot is REAL trading cards priced by a live\n * on-chain TCG oracle. Humans and agents share one world and one leaderboard.\n *\n * The game is server-authoritative — this plugin submits order INTENTS to the\n * public API and narrates what the engine resolved. There is no client-side\n * simulation and nothing to cheat.\n *\n *   SYNDICATE_NEW         start a game (one session per agent, kept in memory)\n *   SYNDICATE_STATE       read the current day without spending it\n *   SYNDICATE_MOVE        submit a day of orders and get the resolved events\n *   SYNDICATE_LEADERBOARD the shared human+agent board\n *\n * Rules for models: https://play.the-undesirables.com/SKILL.md\n *\n * @see https://play.the-undesirables.com\n * @see https://github.com/sailorpepe/plugin-syndicate\n */\n\nimport type {\n  Plugin,\n  Action,\n  IAgentRuntime,\n  Memory,\n  State,\n  HandlerCallback,\n  ActionExample,\n  ActionResult,\n} from \"@elizaos/core\";\n\nconst GAME_API = \"https://play.the-undesirables.com/api/game\";\nconst SCORES_API = \"https://play.the-undesirables.com/api/scores\";\nconst SKILL_URL = \"https://play.the-undesirables.com/SKILL.md\";\nconst PLUGIN_VERSION = \"0.1.0\";\n\n// ============================================================\n// Session bookkeeping — one live game per agent, in-process.\n// The server holds all state; losing this map only means the\n// agent starts a fresh syndicate (sessions expire in 7 idle\n// days server-side anyway).\n// ============================================================\n\nconst sessions = new Map<string, string>(); // agentId -> sessionId\n\nfunction sessionFor(runtime: IAgentRuntime): string | undefined {\n  const configured = runtime.getSetting?.(\"SYNDICATE_SESSION_ID\");\n  if (configured && typeof configured === \"string\") return configured;\n  return sessions.get(String(runtime.agentId));\n}\n\nasync function api(body: Record<string, unknown>): Promise<Record<string, unknown>> {\n  const res = await fetch(GAME_API, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\" },\n    body: JSON.stringify(body),\n  });\n  const data = (await res.json()) as Record<string, unknown>;\n  if (!res.ok) throw new Error(String((data as { error?: string }).error || `HTTP ${res.status}`));\n  return data;\n}\n\nasync function apiView(sessionId: string): Promise<Record<string, unknown>> {\n  const res = await fetch(`${GAME_API}?id=${encodeURIComponent(sessionId)}`);\n  const data = (await res.json()) as Record<string, unknown>;\n  if (!res.ok) throw new Error(String((data as { error?: string }).error || `HTTP ${res.status}`));\n  return data;\n}\n\n// Compact narration so the model sees the day without drowning in JSON.\nfunction summarizeView(v: Record<string, unknown>): string {\n  const events = Array.isArray(v.events) ? (v.events as string[]).slice(0, 12) : [];\n  const crew = Array.isArray(v.crew) ? (v.crew as Record<string, unknown>[]) : [];\n  const power = (v.power || {}) as Record<string, unknown>;\n  const territory = (v.territory || {}) as Record<string, unknown>;\n  const stash = (v.stash || {}) as Record<string, unknown>;\n  const targets = Array.isArray(v.targets) ? (v.targets as Record<string, unknown>[]) : [];\n  const beatable = targets.filter((t) => t.beatable !== \"no\").slice(0, 8);\n  const lines = [\n    `Day ${v.day} — capital $${v.capital}, heat ${v.heat}, wanted ${v.wantedLevel}`,\n    `Territory: ${territory.ownedTiles}/${territory.tilesToWin} tiles toward the Kingpin win`,\n    `Stash: ${stash.cards} card(s), fence value $${stash.fenceValue}`,\n    `Crew: ${crew.map((c) => `${c.name} (hp ${c.hp}${(c as { unavailable?: string }).unavailable ? `, ${(c as { unavailable?: string }).unavailable}` : \"\"})`).join(\" · \")}`,\n    `Power: best solo ${power.bestSolo} (${power.bestSoloAgentName}), full squad ${power.fullSquad}`,\n    beatable.length\n      ? `Beatable now: ${beatable.map((t) => `#${t.tileId} ${t.type} vault $${t.vault} (${t.beatable})`).join(\", \")}`\n      : `Nothing is beatable right now — hire muscle or squad up.`,\n  ];\n  if (events.length) lines.push(\"\", \"What happened:\", ...events.map((e) => `  ${e}`));\n  if (v.gameOver) lines.push(\"\", \"GAME OVER — start a new syndicate with SYNDICATE_NEW.\");\n  return lines.join(\"\\n\");\n}\n\n// ============================================================\n// Actions\n// ============================================================\n\nconst newGameAction: Action = {\n  name: \"SYNDICATE_NEW\",\n  description:\n    \"Start a new game of The Syndicate. Creates a fresh crime family in a deterministic 80×80 city. One session per agent; the old session is abandoned.\",\n  similes: [\"START_SYNDICATE\", \"NEW_CRIME_FAMILY\", \"PLAY_SYNDICATE\"],\n  parameters: [\n    {\n      name: \"syndicate_name\",\n      description: \"Name for your crime family (max 32 chars)\",\n      required: false,\n      schema: { type: \"string\" },\n    },\n  ],\n  examples: [\n    [\n      { name: \"{{user1}}\", content: { text: \"Start a syndicate called The Night Owls\" } } as ActionExample,\n      { name: \"{{agentName}}\", content: { text: \"Founding The Night Owls...\", action: \"SYNDICATE_NEW\" } } as ActionExample,\n    ],\n  ],\n  validate: async () => true,\n  handler: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state?: State,\n    options?: Record<string, unknown>,\n    callback?: HandlerCallback\n  ): Promise<ActionResult | undefined> => {\n    const name =\n      (options?.syndicate_name as string) ||\n      message.content.text?.match(/called\\s+(.{2,32}?)(?:\\.|$)/i)?.[1] ||\n      `${runtime.character?.name || \"Agent\"} Syndicate`;\n    try {\n      const view = await api({ action: \"new\", name: name.slice(0, 32), model: `elizaos/${runtime.character?.name || \"agent\"}` });\n      sessions.set(String(runtime.agentId), String(view.sessionId));\n      const text = `New syndicate founded. Read the rules once: ${SKILL_URL}\\n\\n${summarizeView(view)}`;\n      if (callback) await callback({ text });\n      return { success: true, text, data: { sessionId: String(view.sessionId), view } };\n    } catch (e) {\n      const text = `Could not start a game: ${e instanceof Error ? e.message : String(e)}`;\n      if (callback) await callback({ text });\n      return { success: false, text };\n    }\n  },\n};\n\nconst stateAction: Action = {\n  name: \"SYNDICATE_STATE\",\n  description:\n    \"Read the current state of your Syndicate game WITHOUT spending a day: crew, capital, heat, stash value, beatable targets, and progress toward the Kingpin win.\",\n  similes: [\"SYNDICATE_STATUS\", \"CHECK_SYNDICATE\", \"GAME_STATE\"],\n  parameters: [],\n  examples: [\n    [\n      { name: \"{{user1}}\", content: { text: \"How is the syndicate doing?\" } } as ActionExample,\n      { name: \"{{agentName}}\", content: { text: \"Checking the city...\", action: \"SYNDICATE_STATE\" } } as ActionExample,\n    ],\n  ],\n  validate: async (runtime: IAgentRuntime) => sessionFor(runtime) !== undefined,\n  handler: async (\n    runtime: IAgentRuntime,\n    _message: Memory,\n    _state?: State,\n    _options?: Record<string, unknown>,\n    callback?: HandlerCallback\n  ): Promise<ActionResult | undefined> => {\n    const sessionId = sessionFor(runtime);\n    if (!sessionId) {\n      const text = \"No game running — use SYNDICATE_NEW to found a syndicate.\";\n      if (callback) await callback({ text });\n      return { success: false, text };\n    }\n    try {\n      const view = await apiView(sessionId);\n      const text = summarizeView(view);\n      if (callback) await callback({ text });\n      return { success: true, text, data: { view } };\n    } catch (e) {\n      const text = `Could not read the game: ${e instanceof Error ? e.message : String(e)}`;\n      if (callback) await callback({ text });\n      return { success: false, text };\n    }\n  },\n};\n\nconst moveAction: Action = {\n  name: \"SYNDICATE_MOVE\",\n  description:\n    \"Submit one day of orders to The Syndicate and get back what the engine resolved. Orders are [{agentId, targetId, actionType, squad?}] — one per crew member. Self verbs (heal, pray, lay_low, retain, injunction, cook_books, audit, launder) may omit targetId. Check SYNDICATE_STATE first: 'beatable: solo' assumes your STRONGEST member leads.\",\n  similes: [\"SYNDICATE_ORDERS\", \"PLAY_TURN\", \"RUN_THE_DAY\"],\n  parameters: [\n    {\n      name: \"orders\",\n      description:\n        'JSON array of orders, e.g. [{\"agentId\":123,\"targetId\":612,\"actionType\":\"raid\",\"squad\":[124,156]}]. An empty array passes the day (the world still moves).',\n      required: true,\n      schema: { type: \"string\" },\n    },\n  ],\n  examples: [\n    [\n      { name: \"{{user1}}\", content: { text: \"Send Rogue to raid the accountant at tile 612\" } } as ActionExample,\n      { name: \"{{agentName}}\", content: { text: \"Running the day...\", action: \"SYNDICATE_MOVE\" } } as ActionExample,\n    ],\n  ],\n  validate: async (runtime: IAgentRuntime) => sessionFor(runtime) !== undefined,\n  handler: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state?: State,\n    options?: Record<string, unknown>,\n    callback?: HandlerCallback\n  ): Promise<ActionResult | undefined> => {\n    const sessionId = sessionFor(runtime);\n    if (!sessionId) {\n      const text = \"No game running — use SYNDICATE_NEW to found a syndicate.\";\n      if (callback) await callback({ text });\n      return { success: false, text };\n    }\n    let orders: unknown = [];\n    const raw = (options?.orders as string) || message.content.text?.match(/\\[[\\s\\S]*\\]/)?.[0] || \"[]\";\n    try {\n      orders = typeof raw === \"string\" ? JSON.parse(raw) : raw;\n      if (!Array.isArray(orders)) throw new Error(\"orders must be a JSON array\");\n    } catch (e) {\n      const text = `Could not parse orders (${e instanceof Error ? e.message : String(e)}). Expected: [{\"agentId\":ID,\"targetId\":TILE,\"actionType\":\"VERB\"}]`;\n      if (callback) await callback({ text });\n      return { success: false, text };\n    }\n    try {\n      const view = await api({ action: \"orders\", sessionId, orders });\n      const text = summarizeView(view);\n      if (callback) await callback({ text });\n      return { success: true, text, data: { view } };\n    } catch (e) {\n      const text = `The engine rejected the orders: ${e instanceof Error ? e.message : String(e)}`;\n      if (callback) await callback({ text });\n      return { success: false, text };\n    }\n  },\n};\n\nconst leaderboardAction: Action = {\n  name: \"SYNDICATE_LEADERBOARD\",\n  description:\n    \"Read The Syndicate's shared leaderboard — humans and agents on one board, scored by capital, with agent entries flagged by model.\",\n  similes: [\"SYNDICATE_SCORES\", \"TOP_SYNDICATES\", \"CRIME_LEADERBOARD\"],\n  parameters: [],\n  examples: [\n    [\n      { name: \"{{user1}}\", content: { text: \"Who runs the city?\" } } as ActionExample,\n      { name: \"{{agentName}}\", content: { text: \"Pulling the board...\", action: \"SYNDICATE_LEADERBOARD\" } } as ActionExample,\n    ],\n  ],\n  validate: async () => true,\n  handler: async (\n    _runtime: IAgentRuntime,\n    _message: Memory,\n    _state?: State,\n    _options?: Record<string, unknown>,\n    callback?: HandlerCallback\n  ): Promise<ActionResult | undefined> => {\n    try {\n      const res = await fetch(SCORES_API);\n      const data = (await res.json()) as { scores?: { syndicate: string; headline: string; day: number; value: number; agent?: boolean; model?: string }[] };\n      const rows = (data.scores || []).slice(0, 10);\n      const text = rows.length\n        ? rows\n            .map(\n              (s, i) =>\n                `${i + 1}. ${s.syndicate} — $${s.value.toLocaleString()} (day ${s.day}) ${s.agent ? `[agent: ${s.model || \"unknown\"}]` : \"[human]\"} — ${s.headline}`\n            )\n            .join(\"\\n\")\n        : \"The board is empty. The city is up for grabs.\";\n      if (callback) await callback({ text });\n      return { success: true, text, data: { scores: rows } };\n    } catch (e) {\n      const text = `Could not reach the leaderboard: ${e instanceof Error ? e.message : String(e)}`;\n      if (callback) await callback({ text });\n      return { success: false, text };\n    }\n  },\n};\n\n// ============================================================\n// Plugin\n// ============================================================\n\nexport const syndicatePlugin: Plugin = {\n  name: \"plugin-syndicate\",\n  description: `The Syndicate v${PLUGIN_VERSION} — agent-playable crime-city strategy with oracle-priced loot. Rules: ${SKILL_URL}`,\n  actions: [newGameAction, stateAction, moveAction, leaderboardAction],\n  providers: [],\n  evaluators: [],\n};\n\nexport default syndicatePlugin;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "plugin-syndicate",
+  "version": "0.1.0",
+  "description": "Play The Syndicate from any elizaOS agent — a deterministic, turn-based crime-city game where the loot is real trading cards priced by a live on-chain TCG oracle. Humans and agents share one world and one leaderboard.",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "elizaos",
+    "elizaos-plugin",
+    "eliza",
+    "ai-agents",
+    "game",
+    "agent-gameplay",
+    "strategy",
+    "trading-cards",
+    "tcg",
+    "oracle-api",
+    "the-syndicate",
+    "undesirables"
+  ],
+  "author": "The Undesirables LLC (sailorpepe)",
+  "license": "BUSL-1.1",
+  "homepage": "https://play.the-undesirables.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sailorpepe/plugin-syndicate.git"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "2.0.3-beta.7"
+  },
+  "devDependencies": {
+    "@elizaos/core": "2.0.3-beta.7",
+    "@types/node": "^25.6.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
+  }
+}