@crowdedkingdoms/crowdyjs 11.0.0 → 12.0.0

package/dist/player-host/schemas.js

@@ -0,0 +1,347 @@
+import { assertBoundedJsonSchema, deepFreeze, } from '../crowdy-agent/schema.js';
+import { CROWDY_AGENT_ERROR_CODES } from '../crowdy-agent/errors.js';
+const decimal = () => ({
+    type: 'string',
+    minLength: 1,
+    maxLength: 48,
+    pattern: '^-?(0|[1-9][0-9]*)(\\.[0-9]{1,9})?$',
+});
+const text = (maxLength, minLength = 0) => ({
+    type: 'string',
+    minLength,
+    maxLength,
+});
+const enumText = (values) => ({
+    type: 'string',
+    minLength: 1,
+    maxLength: Math.max(...values.map((value) => value.length)),
+    enum: values,
+});
+const integer = (minimum, maximum) => ({
+    type: 'integer',
+    minimum,
+    maximum,
+});
+const number = (minimum, maximum) => ({
+    type: 'number',
+    minimum,
+    maximum,
+});
+const boolean = () => ({ type: 'boolean' });
+const dateTime = () => ({
+    type: 'string',
+    minLength: 20,
+    maxLength: 40,
+    format: 'date-time',
+});
+const array = (items, maxItems, minItems = 0, uniqueItems = false) => ({
+    type: 'array',
+    minItems,
+    maxItems,
+    uniqueItems,
+    items,
+});
+const object = (properties, required = Object.keys(properties)) => ({
+    type: 'object',
+    additionalProperties: false,
+    required,
+    maxProperties: Object.keys(properties).length,
+    properties,
+});
+const vector = object({
+    x: decimal(),
+    y: decimal(),
+    z: decimal(),
+});
+const look = object({
+    yaw: decimal(),
+    pitch: decimal(),
+});
+const scope = enumText([
+    'observe',
+    'locomotion',
+    'interact',
+    'craft',
+    'combat',
+    'communicate',
+    'travel',
+    'grid',
+    'trust_consent',
+    'commerce',
+]);
+const commandKind = enumText([
+    'MOVE',
+    'LOOK',
+    'STOP',
+    'INVENTORY_SELECT',
+    'INVENTORY_CONSUME',
+    'INVENTORY_TRANSFER',
+    'INTERACT',
+    'CRAFT',
+    'MOUNT',
+    'COMBAT_ATTACK',
+    'CHAT_SEND',
+    'TRAVEL_TELEPORT',
+]);
+const planned = {
+    observationId: text(128, 1),
+    capabilityRevision: text(128, 1),
+    controlledEntityId: text(128, 1),
+};
+export const PLAYER_HOST_CAPABILITIES_SCHEMA_V1 = deepFreeze(object({
+    contractVersion: {
+        ...text(20, 20),
+        const: 'crowdy.player-host/1',
+    },
+    gameId: text(128, 1),
+    revision: text(128, 1),
+    controlledEntityId: text(128, 1),
+    commands: array(object({
+        kind: commandKind,
+        toolName: text(128, 3),
+        requiredScope: scope,
+        risk: enumText([
+            'READ_ONLY',
+            'ROUTINE_WRITE',
+            'WORLD_CONTROL',
+            'DESTRUCTIVE',
+            'TRUST_CONSENT',
+            'ECONOMIC',
+            'IRREVERSIBLE',
+        ]),
+        approval: enumText(['NONE', 'REQUIRED', 'CONDITIONAL']),
+        rateLimitPerSecond: integer(1, 100),
+    }, ['kind', 'toolName', 'risk', 'approval', 'rateLimitPerSecond']), 64),
+    observation: object({
+        maxAgeMs: integer(100, 10000),
+        maxNearbyActors: integer(0, 128),
+        maxNearbyVoxels: integer(0, 256),
+    }),
+    advertisedAt: dateTime(),
+}));
+export const OBSERVE_REQUEST_SCHEMA_V1 = deepFreeze(object({
+    detail: enumText(['MINIMAL', 'STANDARD', 'TACTICAL']),
+    maxNearbyActors: integer(0, 64),
+    maxNearbyVoxels: integer(0, 128),
+}));
+const inventory = object({
+    selectedSlot: integer(0, 255),
+    slots: array(object({
+        slot: integer(0, 255),
+        itemId: text(128, 1),
+        quantity: integer(0, 1000000),
+        usable: boolean(),
+    }), 256),
+    craftableRecipeIds: array(text(128, 1), 128, 0, true),
+});
+export const GAME_OBSERVATION_SCHEMA_V1 = deepFreeze(object({
+    contractVersion: {
+        ...text(25, 25),
+        const: 'crowdy.game-observation/1',
+    },
+    observationId: text(128, 1),
+    capabilityRevision: text(128, 1),
+    controlledEntityId: text(128, 1),
+    observedAt: dateTime(),
+    expiresAt: dateTime(),
+    player: object({
+        position: vector,
+        velocity: vector,
+        look,
+        health: decimal(),
+        alive: boolean(),
+    }),
+    controlledEntity: object({
+        kind: enumText(['PLAYER', 'MOUNT', 'VEHICLE']),
+        position: vector,
+        velocity: vector,
+    }),
+    target: object({
+        targetId: text(128, 1),
+        kind: enumText(['ACTOR', 'VOXEL', 'OBJECT', 'NONE']),
+        distance: decimal(),
+    }, ['targetId', 'kind', 'distance']),
+    inventory,
+    grid: object({
+        gridRef: text(128, 1),
+        low: vector,
+        high: vector,
+        effectiveScopes: array(scope, 10, 0, true),
+    }),
+    nearbyActors: array(object({
+        actorId: text(128, 1),
+        kind: enumText(['PLAYER', 'NPC', 'MOB', 'OBJECT', 'VEHICLE']),
+        position: vector,
+        distance: decimal(),
+        disposition: enumText([
+            'SELF',
+            'FRIENDLY',
+            'NEUTRAL',
+            'HOSTILE',
+            'UNKNOWN',
+        ]),
+        label: text(128),
+        health: decimal(),
+    }, ['actorId', 'kind', 'position', 'distance', 'disposition']), 64),
+    nearbyVoxels: array(object({
+        position: vector,
+        material: text(128, 1),
+        interaction: enumText(['NONE', 'MINE', 'PLACE', 'USE']),
+    }), 128),
+    inputState: object({
+        modalOpen: boolean(),
+        textInputFocused: boolean(),
+        humanInputActive: boolean(),
+    }),
+}, [
+    'contractVersion',
+    'observationId',
+    'capabilityRevision',
+    'controlledEntityId',
+    'observedAt',
+    'expiresAt',
+    'player',
+    'controlledEntity',
+    'nearbyActors',
+    'nearbyVoxels',
+    'inputState',
+]));
+const move = object({
+    kind: { ...enumText(['MOVE']), const: 'MOVE' },
+    ...planned,
+    direction: enumText(['FORWARD', 'BACKWARD', 'LEFT', 'RIGHT', 'UP', 'DOWN']),
+    intensity: number(0, 1),
+    durationMs: integer(16, 2000),
+});
+const lookCommand = object({
+    kind: { ...enumText(['LOOK']), const: 'LOOK' },
+    ...planned,
+    deltaYaw: number(-180, 180),
+    deltaPitch: number(-90, 90),
+});
+const stop = object({
+    kind: { ...enumText(['STOP']), const: 'STOP' },
+});
+const inventorySelect = object({
+    kind: { ...enumText(['INVENTORY_SELECT']), const: 'INVENTORY_SELECT' },
+    ...planned,
+    slot: integer(0, 255),
+});
+const inventoryConsume = object({
+    kind: { ...enumText(['INVENTORY_CONSUME']), const: 'INVENTORY_CONSUME' },
+    ...planned,
+    slot: integer(0, 255),
+    quantity: integer(1, 64),
+});
+const inventoryTransfer = object({
+    kind: { ...enumText(['INVENTORY_TRANSFER']), const: 'INVENTORY_TRANSFER' },
+    ...planned,
+    direction: enumText(['TO_CONTAINER', 'FROM_CONTAINER']),
+    slot: integer(0, 255),
+    quantity: integer(1, 64),
+    containerRef: text(128, 1),
+});
+const interact = object({
+    kind: { ...enumText(['INTERACT']), const: 'INTERACT' },
+    ...planned,
+    action: enumText(['MINE', 'PLACE', 'USE', 'FISH', 'NPC_TALK']),
+    targetRef: text(128, 1),
+    inventorySlot: integer(0, 255),
+}, [
+    'kind',
+    'observationId',
+    'capabilityRevision',
+    'controlledEntityId',
+    'action',
+    'targetRef',
+]);
+const craft = object({
+    kind: { ...enumText(['CRAFT']), const: 'CRAFT' },
+    ...planned,
+    recipeId: text(128, 1),
+    quantity: integer(1, 64),
+});
+const mount = object({
+    kind: { ...enumText(['MOUNT']), const: 'MOUNT' },
+    ...planned,
+    action: enumText(['MOUNT', 'DISMOUNT']),
+    mountRef: text(128, 1),
+}, [
+    'kind',
+    'observationId',
+    'capabilityRevision',
+    'controlledEntityId',
+    'action',
+]);
+const attack = object({
+    kind: { ...enumText(['COMBAT_ATTACK']), const: 'COMBAT_ATTACK' },
+    ...planned,
+    targetRef: text(128, 1),
+    attack: enumText(['PRIMARY', 'SECONDARY']),
+});
+const chat = object({
+    kind: { ...enumText(['CHAT_SEND']), const: 'CHAT_SEND' },
+    ...planned,
+    channel: enumText(['LOCAL', 'GROUP']),
+    text: text(280, 1),
+});
+const teleport = object({
+    kind: { ...enumText(['TRAVEL_TELEPORT']), const: 'TRAVEL_TELEPORT' },
+    ...planned,
+    destinationRef: text(128, 1),
+});
+export const GAME_COMMAND_SCHEMAS_V1 = deepFreeze({
+    MOVE: move,
+    LOOK: lookCommand,
+    STOP: stop,
+    INVENTORY_SELECT: inventorySelect,
+    INVENTORY_CONSUME: inventoryConsume,
+    INVENTORY_TRANSFER: inventoryTransfer,
+    INTERACT: interact,
+    CRAFT: craft,
+    MOUNT: mount,
+    COMBAT_ATTACK: attack,
+    CHAT_SEND: chat,
+    TRAVEL_TELEPORT: teleport,
+});
+export const GAME_COMMAND_SCHEMA_V1 = deepFreeze({
+    oneOf: Object.values(GAME_COMMAND_SCHEMAS_V1),
+});
+const error = object({
+    code: {
+        ...text(64, 1),
+        enum: CROWDY_AGENT_ERROR_CODES,
+    },
+    message: text(512, 1),
+    retryable: boolean(),
+    remediation: text(512, 1),
+    field: text(256, 1),
+    requiredScope: text(80, 1),
+}, ['code', 'message', 'retryable']);
+export const GAME_COMMAND_RESULT_SCHEMA_V1 = deepFreeze(object({
+    contractVersion: {
+        ...text(28, 28),
+        const: 'crowdy.game-command-result/1',
+    },
+    status: enumText(['SUCCEEDED', 'FAILED', 'DENIED', 'OUTCOME_UNKNOWN']),
+    commandKind,
+    observationId: text(128, 1),
+    details: array(object({
+        name: text(64, 1),
+        value: text(512),
+    }), 32),
+    error,
+}, ['contractVersion', 'status', 'commandKind']));
+for (const schema of [
+    OBSERVE_REQUEST_SCHEMA_V1,
+    ...Object.values(GAME_COMMAND_SCHEMAS_V1),
+]) {
+    assertBoundedJsonSchema(schema);
+}
+for (const schema of [
+    PLAYER_HOST_CAPABILITIES_SCHEMA_V1,
+    GAME_OBSERVATION_SCHEMA_V1,
+    GAME_COMMAND_RESULT_SCHEMA_V1,
+]) {
+    assertBoundedJsonSchema(schema, { rejectAuthorityFields: false });
+}

package/dist/player-host/tools.d.ts

@@ -0,0 +1,13 @@
+import type { CrowdyAgentBrowserToolHandlersV1 } from '../crowdy-agent/browser-dispatcher.js';
+import type { PlayerHostAdapterV1 } from './types.js';
+import { AgentControlLeaseManager, type AgentControlLeaseManagerOptionsV1 } from './lease-manager.js';
+export interface PlayerHostAgentToolsV1 {
+    readonly leaseManager: AgentControlLeaseManager;
+    readonly handlers: CrowdyAgentBrowserToolHandlersV1;
+}
+/**
+ * Build the exact generic game-tool router used by a game integration such as
+ * Blocks with Friends. Game-specific extensions remain separate descriptors.
+ */
+export declare function createPlayerHostAgentTools(adapter: PlayerHostAdapterV1, options?: AgentControlLeaseManagerOptionsV1): PlayerHostAgentToolsV1;
+//# sourceMappingURL=tools.d.ts.map

package/dist/player-host/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/player-host/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAIV,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,wBAAwB,EACxB,KAAK,iCAAiC,EACvC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,iCAAsC,GAC9C,sBAAsB,CA4DxB"}

package/dist/player-host/tools.js

@@ -0,0 +1,79 @@
+import { CrowdyAgentError, CrowdyAgentOutcomeUnknownError, } from '../crowdy-agent/errors.js';
+import { AgentControlLeaseManager, } from './lease-manager.js';
+/**
+ * Build the exact generic game-tool router used by a game integration such as
+ * Blocks with Friends. Game-specific extensions remain separate descriptors.
+ */
+export function createPlayerHostAgentTools(adapter, options = {}) {
+    const leaseManager = new AgentControlLeaseManager(adapter, options);
+    const control = (kind) => async (argumentsValue, context) => mapGameResult(await runHostOperation(leaseManager, context.signal, () => leaseManager.dispatch({
+        toolCallId: context.invocation.toolCallId,
+        clientEpoch: context.invocation.clientEpoch ?? '',
+        leaseId: context.invocation.leaseId,
+        approvalGrant: context.invocation.approvalGrant,
+        command: {
+            kind,
+            ...argumentsValue,
+        },
+    })));
+    return {
+        leaseManager,
+        handlers: Object.freeze({
+            'game.capabilities.get': (_arguments, context) => runHostOperation(leaseManager, context.signal, () => leaseManager.refreshCapabilities()),
+            'game.observe': (argumentsValue, context) => runHostOperation(leaseManager, context.signal, () => leaseManager.observe(argumentsValue, {
+                clientEpoch: context.invocation.clientEpoch ?? '',
+                leaseId: context.invocation.leaseId,
+            })),
+            'game.control.move': control('MOVE'),
+            'game.control.look': control('LOOK'),
+            'game.control.stop': control('STOP'),
+            'game.inventory.select': control('INVENTORY_SELECT'),
+            'game.inventory.consume': control('INVENTORY_CONSUME'),
+            'game.inventory.transfer': control('INVENTORY_TRANSFER'),
+            'game.interact': control('INTERACT'),
+            'game.craft': control('CRAFT'),
+            'game.mount': control('MOUNT'),
+            'game.combat.attack': control('COMBAT_ATTACK'),
+            'game.chat.send': control('CHAT_SEND'),
+            'game.travel.teleport': control('TRAVEL_TELEPORT'),
+        }),
+    };
+}
+function mapGameResult(result) {
+    if (result.status === 'SUCCEEDED')
+        return result;
+    if (result.status === 'OUTCOME_UNKNOWN') {
+        throw new CrowdyAgentOutcomeUnknownError(result.error?.message ??
+            'The game command outcome could not be confirmed');
+    }
+    throw new CrowdyAgentError(result.error?.code ??
+        (result.status === 'DENIED'
+            ? 'AGENT_SCOPE_DENIED'
+            : 'AGENT_TOOL_FAILED'), result.error?.message ??
+        (result.status === 'DENIED'
+            ? 'The game command was denied'
+            : 'The game command failed'), {
+        retryable: result.error?.retryable ?? false,
+        ...(result.error?.requiredScope
+            ? { requiredScope: result.error.requiredScope }
+            : {}),
+    });
+}
+async function runHostOperation(leaseManager, signal, operation) {
+    const abort = () => leaseManager.preempt('HUMAN_STOP');
+    if (signal.aborted) {
+        abort();
+        throw new CrowdyAgentError('AGENT_CANCELLED', 'Player host operation was cancelled');
+    }
+    signal.addEventListener('abort', abort, { once: true });
+    try {
+        const result = await operation();
+        if (signal.aborted) {
+            throw new CrowdyAgentError('AGENT_CANCELLED', 'Player host operation was cancelled');
+        }
+        return result;
+    }
+    finally {
+        signal.removeEventListener('abort', abort);
+    }
+}

package/dist/player-host/types.d.ts

@@ -0,0 +1,203 @@
+import type { CrowdyAgentApprovalPolicy, CrowdyAgentPreemptionReason, CrowdyAgentToolRisk } from '../crowdy-agent/types.js';
+import type { AgentErrorV1 } from '../crowdy-agent/errors.js';
+/** Decimal strings avoid coordinate precision loss across GraphQL and JSON. */
+export interface PlayerHostVector3V1 {
+    readonly x: string;
+    readonly y: string;
+    readonly z: string;
+}
+export interface PlayerHostLookV1 {
+    readonly yaw: string;
+    readonly pitch: string;
+}
+export type PlayerHostLeaseScope = 'observe' | 'locomotion' | 'interact' | 'craft' | 'combat' | 'communicate' | 'travel' | 'grid' | 'trust_consent' | 'commerce';
+export type PlayerHostCommandKind = 'MOVE' | 'LOOK' | 'STOP' | 'INVENTORY_SELECT' | 'INVENTORY_CONSUME' | 'INVENTORY_TRANSFER' | 'INTERACT' | 'CRAFT' | 'MOUNT' | 'COMBAT_ATTACK' | 'CHAT_SEND' | 'TRAVEL_TELEPORT';
+export interface PlayerHostCommandCapabilityV1 {
+    readonly kind: PlayerHostCommandKind;
+    readonly toolName: string;
+    readonly requiredScope?: PlayerHostLeaseScope;
+    readonly risk: CrowdyAgentToolRisk;
+    readonly approval: CrowdyAgentApprovalPolicy;
+    readonly rateLimitPerSecond: number;
+}
+export interface PlayerHostCapabilitiesV1 {
+    readonly contractVersion: 'crowdy.player-host/1';
+    readonly gameId: string;
+    readonly revision: string;
+    readonly controlledEntityId: string;
+    readonly commands: readonly PlayerHostCommandCapabilityV1[];
+    readonly observation: {
+        readonly maxAgeMs: number;
+        readonly maxNearbyActors: number;
+        readonly maxNearbyVoxels: number;
+    };
+    readonly advertisedAt: string;
+}
+export interface ObserveRequestV1 {
+    readonly detail: 'MINIMAL' | 'STANDARD' | 'TACTICAL';
+    readonly maxNearbyActors: number;
+    readonly maxNearbyVoxels: number;
+}
+export interface GameObservationActorV1 {
+    readonly actorId: string;
+    readonly kind: 'PLAYER' | 'NPC' | 'MOB' | 'OBJECT' | 'VEHICLE';
+    readonly position: PlayerHostVector3V1;
+    readonly distance: string;
+    readonly disposition: 'SELF' | 'FRIENDLY' | 'NEUTRAL' | 'HOSTILE' | 'UNKNOWN';
+    readonly label?: string;
+    readonly health?: string;
+}
+export interface GameObservationInventoryV1 {
+    readonly selectedSlot: number;
+    readonly slots: readonly {
+        readonly slot: number;
+        readonly itemId: string;
+        readonly quantity: number;
+        readonly usable: boolean;
+    }[];
+    readonly craftableRecipeIds: readonly string[];
+}
+export interface GameObservationV1 {
+    readonly contractVersion: 'crowdy.game-observation/1';
+    readonly observationId: string;
+    readonly capabilityRevision: string;
+    readonly controlledEntityId: string;
+    readonly observedAt: string;
+    readonly expiresAt: string;
+    readonly player: {
+        readonly position: PlayerHostVector3V1;
+        readonly velocity: PlayerHostVector3V1;
+        readonly look: PlayerHostLookV1;
+        readonly health: string;
+        readonly alive: boolean;
+    };
+    readonly controlledEntity: {
+        readonly kind: 'PLAYER' | 'MOUNT' | 'VEHICLE';
+        readonly position: PlayerHostVector3V1;
+        readonly velocity: PlayerHostVector3V1;
+    };
+    readonly target?: {
+        readonly targetId: string;
+        readonly kind: 'ACTOR' | 'VOXEL' | 'OBJECT' | 'NONE';
+        readonly distance: string;
+    };
+    readonly inventory?: GameObservationInventoryV1;
+    readonly grid?: {
+        readonly gridRef: string;
+        readonly low: PlayerHostVector3V1;
+        readonly high: PlayerHostVector3V1;
+        readonly effectiveScopes: readonly PlayerHostLeaseScope[];
+    };
+    readonly nearbyActors: readonly GameObservationActorV1[];
+    readonly nearbyVoxels: readonly {
+        readonly position: PlayerHostVector3V1;
+        readonly material: string;
+        readonly interaction: 'NONE' | 'MINE' | 'PLACE' | 'USE';
+    }[];
+    readonly inputState: {
+        readonly modalOpen: boolean;
+        readonly textInputFocused: boolean;
+        readonly humanInputActive: boolean;
+    };
+}
+interface PlannedCommandV1 {
+    readonly observationId: string;
+    readonly capabilityRevision: string;
+    readonly controlledEntityId: string;
+}
+export interface GameMoveCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'MOVE';
+    readonly direction: 'FORWARD' | 'BACKWARD' | 'LEFT' | 'RIGHT' | 'UP' | 'DOWN';
+    readonly intensity: number;
+    readonly durationMs: number;
+}
+export interface GameLookCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'LOOK';
+    readonly deltaYaw: number;
+    readonly deltaPitch: number;
+}
+export interface GameStopCommandV1 {
+    readonly kind: 'STOP';
+}
+export interface GameInventorySelectCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'INVENTORY_SELECT';
+    readonly slot: number;
+}
+export interface GameInventoryConsumeCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'INVENTORY_CONSUME';
+    readonly slot: number;
+    readonly quantity: number;
+}
+export interface GameInventoryTransferCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'INVENTORY_TRANSFER';
+    readonly direction: 'TO_CONTAINER' | 'FROM_CONTAINER';
+    readonly slot: number;
+    readonly quantity: number;
+    readonly containerRef: string;
+}
+export interface GameInteractCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'INTERACT';
+    readonly action: 'MINE' | 'PLACE' | 'USE' | 'FISH' | 'NPC_TALK';
+    readonly targetRef: string;
+    readonly inventorySlot?: number;
+}
+export interface GameCraftCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'CRAFT';
+    readonly recipeId: string;
+    readonly quantity: number;
+}
+export interface GameMountCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'MOUNT';
+    readonly action: 'MOUNT' | 'DISMOUNT';
+    readonly mountRef?: string;
+}
+export interface GameCombatAttackCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'COMBAT_ATTACK';
+    readonly targetRef: string;
+    readonly attack: 'PRIMARY' | 'SECONDARY';
+}
+export interface GameChatSendCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'CHAT_SEND';
+    readonly channel: 'LOCAL' | 'GROUP';
+    readonly text: string;
+}
+export interface GameTravelTeleportCommandV1 extends PlannedCommandV1 {
+    readonly kind: 'TRAVEL_TELEPORT';
+    readonly destinationRef: string;
+}
+export type GameCommandV1 = GameMoveCommandV1 | GameLookCommandV1 | GameStopCommandV1 | GameInventorySelectCommandV1 | GameInventoryConsumeCommandV1 | GameInventoryTransferCommandV1 | GameInteractCommandV1 | GameCraftCommandV1 | GameMountCommandV1 | GameCombatAttackCommandV1 | GameChatSendCommandV1 | GameTravelTeleportCommandV1;
+export interface GameCommandResultV1 {
+    readonly contractVersion: 'crowdy.game-command-result/1';
+    readonly status: 'SUCCEEDED' | 'FAILED' | 'DENIED' | 'OUTCOME_UNKNOWN';
+    readonly commandKind: PlayerHostCommandKind;
+    readonly observationId?: string;
+    readonly details?: readonly {
+        readonly name: string;
+        readonly value: string;
+    }[];
+    readonly error?: AgentErrorV1;
+}
+/** Created only by AgentControlLeaseManager after all local checks pass. */
+export interface ValidatedGateV1 {
+    readonly contractVersion: 'crowdy.validated-gate/1';
+    readonly clientEpoch: string;
+    readonly leaseId?: string;
+    readonly scopes: readonly PlayerHostLeaseScope[];
+    readonly contextVersion: string;
+    readonly observationId?: string;
+    readonly validatedAt: string;
+}
+/**
+ * Game integration boundary. Implementations call the same typed intent
+ * services used by human input; they never expose SDK, DOM, transport, or host
+ * call escape hatches.
+ */
+export interface PlayerHostAdapterV1 {
+    readonly contractVersion: 'crowdy.player-host/1';
+    capabilities(): Promise<PlayerHostCapabilitiesV1>;
+    observe(request: ObserveRequestV1): Promise<GameObservationV1>;
+    dispatch(command: GameCommandV1, gate: ValidatedGateV1): Promise<GameCommandResultV1>;
+    clearAgentIntent(reason: CrowdyAgentPreemptionReason): void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/player-host/types.d.ts.map

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

package/dist/player-host/types.js

@@ -0,0 +1 @@
+export {};