@whitesands/agent-player 1.1.0 → 1.3.0

package/dist/{types-DXM_HZHu.d.ts → types-gmAkYoQr.d.cts}

@@ -1,5 +1,5 @@
 import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
-import { TokenUsage, ToolDescriptor, TurnReport } from './protocol.js';
+import { TokenUsage, StepRecord, Relationship, ToolDescriptor, TurnReport } from './protocol.cjs';
 
 type Logger = {
     debug?: (message: string, extra?: unknown) => void;
@@ -14,6 +14,8 @@ type TurnResult = {
     result: unknown;
     attempts: number;
     usage: TokenUsage;
+    /** Every action played, when the turn played more than one. */
+    steps?: StepRecord[];
 };
 type AgentEvent = {
     type: "action";
@@ -32,6 +34,21 @@ type AgentEvent = {
     error: string;
     action?: string;
     args?: Record<string, unknown>;
+} | {
+    /** The character chose to remember a fact. Needs `memory: true`. */
+    type: "memory";
+    sessionId: string;
+    about: string;
+    note: string;
+} | {
+    /** The character's feelings about someone changed. Needs `memory: true`. */
+    type: "relationship";
+    sessionId: string;
+    about: string;
+    affinity: number;
+    label: string;
+    change: number;
+    because: string;
 } | {
     type: "disconnected";
 } | {
@@ -56,18 +73,42 @@ type AgentHandle = {
     stop(): Promise<void>;
     /** Subscribe to this session's action, retry, and failure events. Returns unsubscribe. */
     on(listener: EventListener): () => void;
+    /**
+     * Tell the character about something that happened, without starting a turn.
+     * It is kept in the character's memory. Needs `memory: true`.
+     */
+    observe(text: string, about?: string): void;
+    /** How the character feels about each person it knows, keyed by lower-case name. */
+    relationships(): Record<string, Relationship>;
 };
 type StartOptions = {
+    /**
+     * Character to play. Copy the id from the Players page.
+     * The platform key belongs to the game; this id selects the character.
+     */
+    playerId: string;
     /** Label stored with the session. Defaults to the class name. */
     name?: string;
     /** Added to the model prompt for this player only. */
     goal?: string;
     /** Extra instructions appended to the default agent prompt. */
     instructions?: string;
+    /** Send only `instructions`, without the default agent prompt. */
+    ownInstructions?: boolean;
+    /**
+     * Keep the character's memory and relationships on the platform, between
+     * sessions and servers. The local `done` list is left out of the view.
+     */
+    memory?: boolean;
+    /** How many actions one turn may play, 1 to 4. Default 1. */
+    maxActions?: number;
+    /** false takes the platform's subgoal tools away. */
+    subgoals?: boolean;
 };
 type StartSessionRequest = {
     sessionId: string;
     sessionToken: string;
+    playerId: string;
     name?: string;
     tools: ToolDescriptor[];
     instructions: string;
@@ -121,4 +162,4 @@ type AgentServerOptions = {
     memoryPath?: string | false;
 };
 
-export type { AgentServerOptions as A, EventListener as E, InlinePlatform as I, Logger as L, StartOptions as S, TurnOptions as T, AgentHandle as a, AgentEvent as b, TurnResult as c, StartSessionRequest as d };
+export type { AgentServerOptions as A, EventListener as E, InlinePlatform as I, Logger as L, StartOptions as S, TurnResult as T, AgentHandle as a, AgentEvent as b, TurnOptions as c, StartSessionRequest as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesands/agent-player",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Start a remote game agent from a player class. The SDK owns the MCP server; the model stays on the platform.",
   "repository": {
     "type": "git",
@@ -46,7 +46,7 @@
     "examples/*"
   ],
   "scripts": {
-    "build": "tsup && npm run build -w @wsi/forest-example && npm run build -w @wsi/courier-example && npm run build -w @wsi/ferry-example",
+    "build": "tsup && npm run build -w @wsi/forest-example && npm run build -w @wsi/courier-example && npm run build -w @wsi/ferry-example && npm run build -w @wsi/town-example",
     "docs": "typedoc",
     "clean": "rm -rf dist docs",
     "release": "tsup && node scripts/publish.mjs",
@@ -54,7 +54,8 @@
     "test:watch": "vitest",
     "forest": "npm run start -w @wsi/forest-example --",
     "courier": "npm run start -w @wsi/courier-example --",
-    "ferry": "npm run start -w @wsi/ferry-example --"
+    "ferry": "npm run start -w @wsi/ferry-example --",
+    "town": "npm run start -w @wsi/town-example --"
   },
   "engines": {
     "node": ">=20"