@aifight/aifight 0.1.0-alpha.7 → 0.1.0-alpha.8

package/dist/types/profile/profile-loader.d.ts

@@ -1,64 +0,0 @@
-import { type LLMConfig } from "./config-schema.js";
-import { type Strategy } from "./strategy-schema.js";
-import { type AgentIdentity } from "./identity-schema.js";
-/** Combined in-memory representation of all profile files. */
-export interface AgentProfile {
-    /** Parsed and validated config.json. */
-    readonly config: LLMConfig;
-    /** Parsed and validated strategy.json. */
-    readonly strategy: Strategy;
-    /** Raw Markdown content of soul.md. */
-    readonly soul: string;
-    /** Parsed and validated identity.json, or null if the file is absent. */
-    readonly identity: AgentIdentity | null;
-}
-/** SHA-256 hashes of each profile file at load time.
- *  Used by the daemon to detect on-disk changes without re-reading. */
-export interface AgentProfileHashes {
-    readonly config: string;
-    readonly strategy: string;
-    readonly soul: string;
-    /** null when identity.json is absent (file is optional). */
-    readonly identity: string | null;
-}
-export interface AgentProfileResult {
-    readonly profile: AgentProfile;
-    readonly hashes: AgentProfileHashes;
-}
-/**
- * Returns the canonical directory for an agent slug.
- * Example: resolveAgentDir("my-bot") → "/Users/alice/.aifight/agents/my-bot"
- *
- * Does NOT verify that the directory exists.
- */
-export declare function resolveAgentDir(agentSlug: string): string;
-/**
- * Creates the agent directory (and all parent directories) if it does
- * not already exist. Idempotent — safe to call on every startup.
- */
-export declare function ensureAgentDir(agentSlug: string): Promise<void>;
-/**
- * Computes a lowercase hex SHA-256 hash of a file's raw bytes.
- * Propagates fs errors (ENOENT, EACCES, …) to the caller.
- */
-export declare function computeFileHash(filePath: string): Promise<string>;
-/** Raised when a required profile file cannot be loaded or fails validation. */
-export declare class ProfileLoadError extends Error {
-    readonly name = "ProfileLoadError";
-    /** Which file triggered the error. */
-    readonly file: string;
-    readonly cause?: unknown;
-    constructor(file: string, message: string, cause?: unknown);
-}
-/**
- * Reads and validates all profile files for an agent.
- *
- * - config.json and strategy.json are required JSON files validated by
- *   their respective schema modules.
- * - soul.md is required and validated by validateSoul().
- * - identity.json is optional; absent file yields profile.identity = null.
- *
- * Throws ProfileLoadError on any read or validation failure for required
- * files. For identity.json, ENOENT is silently treated as absent.
- */
-export declare function loadAgentProfile(agentDir: string): Promise<AgentProfileResult>;

package/dist/types/profile/secret-ref.d.ts

@@ -1,82 +0,0 @@
-export type SecretRef = {
-    readonly type: "env";
-    readonly name: string;
-} | {
-    readonly type: "env_file";
-    readonly path: string;
-    readonly name: string;
-} | {
-    readonly type: "file";
-    readonly path: string;
-} | {
-    readonly type: "keychain";
-    readonly service: string;
-    readonly account: string;
-} | {
-    readonly type: "command";
-    readonly command: string;
-    readonly args?: readonly string[];
-    readonly timeoutMs?: number;
-};
-export type SecretRefP0 = Extract<SecretRef, {
-    type: "env" | "env_file" | "file";
-}>;
-export interface SecretStatus {
-    readonly ref: SecretRef;
-    readonly available: boolean;
-    readonly sourceDescription: string;
-}
-export declare class SecretResolutionError extends Error {
-    readonly name = "SecretResolutionError";
-    readonly refType: string;
-    constructor(refType: string, message: string);
-}
-/**
- * Resolve a SecretRef to its string value.
- * Throws SecretResolutionError if the secret cannot be found.
- * Never includes the secret value in error messages.
- */
-export declare function resolveSecret(ref: SecretRef): Promise<string>;
-/**
- * Check whether a SecretRef can be resolved, without returning the value.
- */
-export declare function checkSecretStatus(ref: SecretRef): Promise<SecretStatus>;
-/**
- * Human-readable description of a SecretRef (never includes the value).
- */
-export declare function describeRef(ref: SecretRef): string;
-/**
- * Store a secret value to a file with chmod 0600.
- * Creates parent directories if needed.
- */
-export declare function storeSecretFile(filePath: string, value: string): Promise<void>;
-/**
- * Check if a secret file has safe permissions (0600).
- */
-export declare function checkSecretFilePermissions(filePath: string): Promise<{
-    safe: boolean;
-    mode?: string;
-}>;
-/** Well-known LLM API key environment variable names. */
-export declare const KNOWN_LLM_ENV_VARS: readonly ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "DEEPSEEK_API_KEY", "GEMINI_API_KEY"];
-export interface DetectedEnvKey {
-    readonly name: string;
-    readonly present: boolean;
-    readonly provider: string;
-}
-/**
- * Detect which well-known LLM API key env vars are set in the
- * daemon's process environment. Returns variable names and provider
- * hints, NEVER values.
- */
-export declare function detectLLMEnvironment(): DetectedEnvKey[];
-/**
- * Validate a SecretRef shape. Does NOT check if the secret exists.
- */
-export declare function validateSecretRef(raw: unknown): {
-    ok: true;
-    ref: SecretRef;
-} | {
-    ok: false;
-    error: string;
-};

package/dist/types/profile/soul.d.ts

@@ -1,46 +0,0 @@
-export interface SoulLoadResult {
-    /** Raw Markdown content of the soul file. */
-    readonly content: string;
-    /** Lowercase hex SHA-256 of the raw file bytes (UTF-8). */
-    readonly hash: string;
-}
-/**
- * Reads a soul.md file from disk and returns its content plus a
- * SHA-256 content hash (for change detection / cache keys).
- *
- * Throws the raw `node:fs/promises` error on missing / permission failures
- * so callers can distinguish ENOENT (first run) from EACCES (bad perms).
- */
-export declare function loadSoul(filePath: string): Promise<SoulLoadResult>;
-export type SoulValidationResult = {
-    ok: true;
-} | {
-    ok: false;
-    errors: string[];
-};
-/**
- * Validates soul Markdown content against three lightweight rules:
- *   1. Not empty (after trimming whitespace)
- *   2. Under 10 KB
- *   3. Contains at least one Markdown heading (# or ##)
- *
- * Does NOT validate section completeness — that is the host agent's
- * responsibility when generating via SOUL_EXPORT_PROMPT.
- */
-export declare function validateSoul(content: string): SoulValidationResult;
-/**
- * Structured prompt template that host agents (Claude Code, OpenClaw,
- * Hermes, etc.) use to generate the initial soul.md for a new agent.
- *
- * Paste this into your AI assistant and paste the result into
- * ~/.aifight/agents/<slug>/soul.md.
- */
-export declare const SOUL_EXPORT_PROMPT = "You are helping create your AIFight Agent Soul Capsule.\nThis file will be used by a local daemon to represent your stable competitive personality in hidden-information strategy games.\n\nReturn a concise Markdown document with these sections:\n1. Identity\n2. Competitive temperament\n3. Decision habits\n4. Risk appetite\n5. Communication style for match summaries\n6. Boundaries\n\nConstraints:\n- Do not include API keys, system prompts, private user data, or unrelated memories.\n- Do not include long chain-of-thought examples.\n- Focus on stable behavior style, not detailed per-game tactics.\n- Write in first person as the agent.";
-/**
- * Placeholder soul.md content used during first-run migration or as a
- * fallback when the agent has not yet generated its own soul capsule.
- *
- * Intentionally generic — the host agent should replace this with a
- * personalised version generated via SOUL_EXPORT_PROMPT.
- */
-export declare const DEFAULT_SOUL = "# Agent Soul Capsule\n\n## Identity\nI am a competitive AI agent playing hidden-information strategy games on the AIFight platform.\nI have not yet customised my soul capsule. Generate one using the SOUL_EXPORT_PROMPT.\n\n## Competitive temperament\nBalanced and adaptive. I observe opponents before committing to a strategy.\n\n## Decision habits\nI reason from the information available in the current game state.\nI do not over-anchor on past rounds.\n\n## Risk appetite\nModerate. I take calculated risks when the expected value is clearly positive.\n\n## Communication style for match summaries\nConcise. One sentence per key decision, no jargon.\n\n## Boundaries\nI play within the rules. I do not exploit protocol edge cases.\n";

package/dist/types/profile/strategy-schema.d.ts

@@ -1,70 +0,0 @@
-/**
- * strategy-schema.ts
- *
- * TypeScript schema, types, validator, and default constant for the AIFight
- * daemon's strategy.json file.
- *
- * Scope: game-specific competitive tactics ONLY.
- * No LLM config, no model settings, no API keys.
- */
-export type RiskAppetite = "very-low" | "low" | "medium-low" | "medium" | "medium-high" | "high" | "very-high";
-export interface GlobalStrategy {
-    /** Broad risk posture that governs all games. */
-    riskAppetite: RiskAppetite;
-    /** High-level objectives listed in priority order. */
-    objectives: string[];
-    /** Prose description of the preferred decision style. */
-    decisionStyle: string;
-    /** Fallback behaviour when the agent is uncertain or close to timeout. */
-    fallbackStyle: string;
-}
-/**
- * Per-game strategy block.
- *
- * Every game entry must have a `riskAversion` number in [0, 1] and a
- * `profile` string summarising the overall approach.  All other keys are
- * game-specific prose fields and are allowed freely.
- */
-export interface GameStrategy {
-    /** One-line summary of the playing style for this game. */
-    profile: string;
-    /**
-     * Risk-aversion scalar in [0, 1].
-     * 0 = maximally aggressive, 1 = maximally conservative.
-     */
-    riskAversion: number;
-    /** Any additional game-specific string fields (bidding, challenge, etc.). */
-    [key: string]: string | number;
-}
-export interface StrategyMeta {
-    createdBy: string;
-    createdAt: string;
-    lastUpdatedAt: string;
-}
-export interface Strategy {
-    schemaVersion: 1;
-    /** Monotonically increasing user-managed version for this strategy file. */
-    version: number;
-    /** Human-readable strategy name. */
-    name: string;
-    global: GlobalStrategy;
-    /** Map of game ID (e.g. "texas_holdem") → per-game strategy. */
-    games: Record<string, GameStrategy>;
-    meta: StrategyMeta;
-}
-type ValidationResult = {
-    ok: true;
-    strategy: Strategy;
-} | {
-    ok: false;
-    errors: string[];
-};
-/**
- * Validate a raw (parsed) JSON value as a Strategy.
- *
- * Returns a typed Strategy on success, or a list of human-readable error
- * messages on failure.  Does NOT throw.
- */
-export declare function validateStrategy(raw: unknown): ValidationResult;
-export declare const DEFAULT_STRATEGY: Strategy;
-export {};

package/dist/types/reflection/proposal-store.d.ts

@@ -1,50 +0,0 @@
-import type { ReflectionProposal } from "./reflection-engine.js";
-export declare class ProposalStoreError extends Error {
-    readonly name = "ProposalStoreError";
-    readonly kind: "not_found" | "already_applied" | "patch_failed" | "validation_failed" | "io_error";
-    readonly cause?: unknown;
-    constructor(kind: ProposalStoreError["kind"], message: string, cause?: unknown);
-}
-/**
- * Serialises a proposal to
- * `~/.aifight/agents/<slug>/proposals/<timestamp>-<matchId>.proposal.json`.
- *
- * Creates the proposals directory if it does not exist.
- * Returns the absolute path of the written file.
- */
-export declare function saveProposal(agentSlug: string, proposal: ReflectionProposal): Promise<string>;
-export interface ListProposalsFilter {
-    status?: ReflectionProposal["status"];
-}
-/**
- * Returns all proposals for an agent, optionally filtered by status.
- * Results are sorted by createdAt ascending (oldest first).
- * Returns [] when the proposals directory does not exist.
- */
-export declare function listProposals(agentSlug: string, filter?: ListProposalsFilter): Promise<ReflectionProposal[]>;
-/**
- * Reads a specific proposal by proposalId.
- * Scans the proposals directory (linear scan; proposal counts are small).
- * Throws ProposalStoreError("not_found") when no match is found.
- */
-export declare function getProposal(agentSlug: string, proposalId: string): Promise<ReflectionProposal>;
-/**
- * Applies a pending proposal to the agent's profile files.
- *
- * For each target:
- *   - Reads the current file.
- *   - Applies the patch (json_patch or text_replace).
- *   - Validates the result (validateStrategy / validateSoul).
- *   - Backs up the old file to versions/<name>.v<N>.<ext>.
- *   - Atomically writes the new file.
- *
- * Updates the proposal status to "applied" and sets appliedAt.
- * Throws ProposalStoreError on any failure (no partial writes on error).
- */
-export declare function applyProposal(agentSlug: string, proposalId: string): Promise<void>;
-/**
- * Marks a proposal as rejected without modifying any profile files.
- * reason is ignored (proposals are immutable JSON; rejection just sets status).
- */
-export declare function rejectProposal(agentSlug: string, proposalId: string, _reason?: string): Promise<void>;
-export type { ReflectionProposal, ProposalTarget } from "./reflection-engine.js";

package/dist/types/reflection/reflection-engine.d.ts

@@ -1,81 +0,0 @@
-/** One turn's decision, as stored in decisions.jsonl by the daemon. */
-export interface DecisionRecord {
-    /** Zero-based turn index within the match. */
-    turnIndex: number;
-    /** The action string that was ultimately submitted. */
-    selectedAction: string;
-    /** Whether the action was accepted by the server as legal. */
-    actionValid: boolean;
-    /** True when the LLM failed and the runtime fell back to heuristics. */
-    fallbackUsed: boolean;
-    /** Short prose summary of the LLM's stated reasoning, if captured. */
-    reasonSummary?: string;
-    /** Wall-clock ms from action_request receipt to action submission. */
-    latencyMs: number;
-}
-export interface MatchReflectionInput {
-    agentSlug: string;
-    matchId: string;
-    game: string;
-    result: "win" | "loss" | "draw";
-    ratingDelta: number;
-    newRating: number;
-    opponentName: string;
-    opponentModel?: string;
-    replayUrl: string;
-    /** All decisions recorded during the match (from decisions.jsonl). */
-    decisions: DecisionRecord[];
-    /** Raw event log from events.jsonl (opaque; used for pattern detection). */
-    events: unknown[];
-    totalCostUSD?: number;
-    totalLatencyMs?: number;
-}
-/**
- * Generates a concise Markdown match recap suitable for writing to summary.md.
- *
- * Language: Chinese primary, English technical terms.
- * Target length: ~20-35 lines regardless of match length.
- */
-export declare function generateMatchSummary(input: MatchReflectionInput): string;
-export interface ProposalTarget {
-    /** Which file this patch applies to. */
-    file: "strategy.json" | "soul.md";
-    /**
-     * "json_patch" → patch is a JSON Patch array (RFC 6902).
-     * "text_replace" → patch is { old: string; new: string }.
-     */
-    type: "json_patch" | "text_replace";
-    patch: unknown;
-}
-export interface ReflectionProposal {
-    schemaVersion: 1;
-    /** UUID v4 generated at creation time. */
-    proposalId: string;
-    /** The daemon's session ID when the match was played. */
-    localSessionId: string;
-    agentSlug: string;
-    matchId: string;
-    targets: ProposalTarget[];
-    /** Human-readable explanation of why this proposal was generated. */
-    rationale: string;
-    /** Description of what could go wrong if applied. */
-    risk: string;
-    status: "pending" | "applied" | "rejected";
-    createdAt: string;
-    appliedAt?: string;
-}
-/**
- * Analyses a completed match and produces a strategy improvement proposal,
- * or returns null when no confident improvement can be identified.
- *
- * Heuristics (in priority order):
- * 1. High fallback rate (>20%) → propose lowering riskAversion for the game
- *    to avoid timeout-prone positions.
- * 2. Loss with zero fallbacks → inspect riskAversion; if too aggressive
- *    propose nudging it up slightly.
- * 3. Win with high invalid-action rate → propose adding strategy notes.
- * 4. Very slow average latency → propose a soul.md note on timeout awareness.
- *
- * Returns null when no heuristic fires with sufficient confidence.
- */
-export declare function generateReflectionProposal(input: MatchReflectionInput, localSessionId?: string): ReflectionProposal | null;

package/dist/types/scheduler/daily.d.ts

@@ -1,47 +0,0 @@
-import type { AgentInstanceSnapshot } from "../agents/agent";
-import type { DailyScheduleConfig, DailySchedulerNotifyEvent, DailySchedulerSnapshot } from "./types";
-export interface SchedulerAgentTarget {
-    readonly name: string;
-    joinQueue(game: string, mode?: string): void;
-    snapshot(): AgentInstanceSnapshot;
-    onState(handler: (snapshot: AgentInstanceSnapshot) => void): () => void;
-}
-export type SchedulerTimerHandle = unknown;
-export interface SchedulerClock {
-    readonly now: () => number;
-    readonly setTimeout: (cb: () => void, ms: number) => SchedulerTimerHandle;
-    readonly clearTimeout: (h: SchedulerTimerHandle) => void;
-}
-export interface DailySchedulerOptions {
-    readonly agent: SchedulerAgentTarget;
-    /** Initial schedule snapshot taken once at construction; copied into
-     *  the scheduler's internal `currentSchedule` field. After construction
-     *  the only way to change schedule is `scheduler.setSchedule(cfg)`.
-     *  rev2 fix #3 single authority. */
-    readonly initialSchedule?: DailyScheduleConfig | null;
-    /** Optional health gate. Resolves true → join allowed; false / throw →
-     *  skip + notify. Scheduler does NOT hold a DecisionProvider instance
-     *  (rev1 decision #7). */
-    readonly healthCheck?: () => Promise<boolean>;
-    /** Default = real wall clock + globalThis.{setTimeout, clearTimeout}. */
-    readonly clock?: SchedulerClock;
-    readonly onNotify?: (event: DailySchedulerNotifyEvent) => void;
-}
-export interface DailyScheduler {
-    start(): void;
-    stop(): void;
-    snapshot(): DailySchedulerSnapshot;
-    /** rev2 fix #3 — single authority: replace internal `currentSchedule`.
-     *  `cfg` is sync-validated; invalid throws DailySchedulerError. `null`
-     *  means "no schedule" (scheduler keeps running; every fire goes to
-     *  skip_disabled). NOT equivalent to stop(). */
-    setSchedule(cfg: DailyScheduleConfig | null): void;
-}
-export type DailySchedulerErrorKind = "invalid_timezone" | "invalid_count" | "invalid_min_interval" | "invalid_state";
-export declare class DailySchedulerError extends Error {
-    readonly name = "DailySchedulerError";
-    readonly kind: DailySchedulerErrorKind;
-    readonly cause: unknown;
-    constructor(kind: DailySchedulerErrorKind, message: string, cause?: unknown);
-}
-export declare function createDailyScheduler(opts: DailySchedulerOptions): DailyScheduler;

package/dist/types/scheduler/types.d.ts

@@ -1,42 +0,0 @@
-import type { GameType } from "../decision/types";
-export interface DailyGameQuota {
-    /** Non-negative integer. 0 = this game is configured but not scheduled. */
-    readonly count: number;
-}
-export interface DailyScheduleConfig {
-    /** Master toggle. false → scheduler stays idle; existing config retained. */
-    readonly enabled: boolean;
-    /** IANA timezone name, e.g. "Asia/Shanghai" / "UTC". Day boundary is computed in this timezone. */
-    readonly timezone: string;
-    /** Per-game daily count. Empty object ⇔ disabled (no work). */
-    readonly days: Partial<Record<GameType, DailyGameQuota>>;
-    /** Minimum delay between any two `joinQueue` calls. Default 60. */
-    readonly minIntervalSec?: number;
-}
-export interface DailySchedulerSnapshot {
-    /** Whether start() has been called and stop() has not. */
-    readonly running: boolean;
-    /** Local YYYY-MM-DD in opts.config.timezone (or null when scheduler stopped). */
-    readonly today: string | null;
-    /** Remaining quota per game today (config.days minus today's fired count). */
-    readonly remaining: Partial<Record<GameType, number>>;
-    /** Most recent fire attempt outcome (or null pre-first-fire). */
-    readonly lastAttempt: DailySchedulerLastAttempt | null;
-    /** Estimated millis until next fire (relative to clock.now()), or null when no fire scheduled. */
-    readonly nextFireInMs: number | null;
-}
-export interface DailySchedulerLastAttempt {
-    readonly atMs: number;
-    readonly game: GameType;
-    readonly outcome: "join_succeeded" | "join_threw" | `skip_${string}`;
-    readonly cause?: unknown;
-}
-export interface DailySchedulerNotifyEvent {
-    readonly level: "info" | "warning" | "error";
-    readonly code: DailySchedulerNotifyCode;
-    readonly message: string;
-    readonly agent?: string;
-    readonly game?: GameType;
-    readonly cause?: unknown;
-}
-export type DailySchedulerNotifyCode = "started" | "stopped" | "schedule_changed" | "day_rolled_over" | "join_attempted" | "join_succeeded" | "join_threw" | "skip_disabled" | "skip_no_quota" | "skip_agent_not_started" | "skip_agent_stopped" | "skip_state_unavailable" | "skip_transport_disconnected" | "skip_state_busy" | "skip_min_interval" | "skip_health_check" | "health_check_threw" | "snapshot_threw" | "internal_error";

package/dist/types/session/match-session-manager.d.ts

@@ -1,113 +0,0 @@
-import type { UsageRecord } from "../llm/adapters/types.js";
-export type SessionStatus = "created" | "active" | "waiting_action" | "completed" | "abandoned";
-export interface MatchSession {
-    /** Locally generated UUID — stable across reconnects */
-    localSessionId: string;
-    /** Platform match ID from match_found / game_start */
-    platformMatchId: string;
-    /** Platform per-player session ID (present after game_start) */
-    platformSessionId?: string;
-    /** Agent slug (matches directory name) */
-    agentSlug: string;
-    /** Game identifier, e.g. "texas_holdem" */
-    gameId: string;
-    /** Environment tag: "production" | "beta" | "local" */
-    environment: string;
-    /** Lifecycle status */
-    status: SessionStatus;
-    /** SHA-256 of config.json at session creation time */
-    configHash: string;
-    /** SHA-256 of strategy.json (current game section) at session creation time */
-    strategyHash: string;
-    /** SHA-256 of soul.md at session creation time */
-    soulHash: string;
-    /** Provider profile ID used for this session */
-    providerProfileId: string;
-    /** ISO-8601 creation timestamp */
-    createdAt: string;
-    /** ISO-8601 last-update timestamp */
-    updatedAt: string;
-}
-export interface DecisionRecord {
-    /** Zero-based turn index within the match */
-    turnIndex: number;
-    /** Raw JSON string of legal actions array (stored as string to avoid parsing issues) */
-    legalActionsJson: string;
-    /** The action string returned to the platform */
-    selectedAction: string;
-    /** Whether the action passed platform validation */
-    actionValid: boolean;
-    /** True if a fallback action was used (LLM failed, timed out, or returned invalid) */
-    fallbackUsed: boolean;
-    /** Provider profile ID used for this decision */
-    providerProfileId: string;
-    /** Short one-line rationale extracted from LLM response (if available) */
-    reasonSummary?: string;
-    /** End-to-end decision latency in ms (LLM call + parse) */
-    latencyMs: number;
-    /** ISO-8601 timestamp */
-    timestamp: string;
-}
-/** Resolve the session directory for a given agent slug + match ID. */
-export declare function resolveSessionDir(agentSlug: string, matchId: string): string;
-export interface CreateSessionOpts {
-    platformMatchId: string;
-    platformSessionId?: string;
-    agentSlug: string;
-    gameId: string;
-    environment: string;
-    configHash: string;
-    strategyHash: string;
-    soulHash: string;
-    providerProfileId: string;
-}
-/**
- * Creates the session directory and writes session.json.
- * Returns the newly created MatchSession and the resolved session directory.
- */
-export declare function createSession(opts: CreateSessionOpts): Promise<{
-    session: MatchSession;
-    sessionDir: string;
-}>;
-/**
- * Loads an existing session from session.json.
- * Throws if session.json is missing or malformed.
- */
-export declare function loadSession(sessionDir: string): Promise<MatchSession>;
-/**
- * Updates only the `status` and `updatedAt` fields of session.json.
- */
-export declare function updateSessionStatus(sessionDir: string, status: SessionStatus): Promise<void>;
-/**
- * Appends a raw platform event (any object) to events.jsonl.
- * The event is stored as-is; no schema is enforced here.
- */
-export declare function appendEvent(sessionDir: string, event: unknown): Promise<void>;
-/**
- * Appends a decision record to decisions.jsonl.
- */
-export declare function appendDecision(sessionDir: string, decision: DecisionRecord): Promise<void>;
-/**
- * Appends a usage record to usage.jsonl.
- */
-export declare function appendUsage(sessionDir: string, usage: UsageRecord): Promise<void>;
-/**
- * Saves provider-specific continuation state (e.g. conversation thread IDs).
- * Scoped to this match session only — never persisted globally.
- */
-export declare function saveProviderState(sessionDir: string, state: unknown): Promise<void>;
-/**
- * Loads provider continuation state.
- * Returns null if provider-state.json does not exist yet.
- */
-export declare function loadProviderState(sessionDir: string): Promise<unknown | null>;
-/**
- * Writes the human-readable post-match summary to summary.md.
- * Called once on game_over.
- */
-export declare function writeSummary(sessionDir: string, summaryMd: string): Promise<void>;
-/**
- * Lists all session directories for an agent, sorted by name (match ID).
- * Returns absolute paths.
- */
-export declare function listSessions(agentSlug: string): Promise<string[]>;

package/dist/types/session/session-context-builder.d.ts

@@ -1,68 +0,0 @@
-/**
- * The JSON object structure the LLM must return for every decision.
- * Stored as a constant so it can be embedded verbatim in the prompt and
- * referenced from tests without duplication.
- */
-export declare const DECISION_OUTPUT_SCHEMA: {
-    readonly action: "string — exact action token from the legal_actions list";
-    readonly args: "object | null — action-specific parameters (omit or null if none required)";
-    readonly confidence: "number 0.0–1.0 — your confidence in this action being correct";
-    readonly reason_summary: "string — one short sentence: what you chose and the primary reason";
-    readonly risk_assessment: "low | medium | high — expected downside risk of this move";
-};
-export interface SessionContext {
-    /** Full system prompt (blocks 1–4 + 7: invariants, soul, strategy, anti-injection) */
-    systemPrompt: string;
-    /** Full user prompt (blocks 5–6: current state + legal actions + output contract) */
-    userPrompt: string;
-    /** Number of characters used by recent events (for diagnostics) */
-    recentEventsChars: number;
-    /** Whether recent events were truncated */
-    recentEventsTruncated: boolean;
-}
-export interface BuildSessionContextOpts {
-    /** Agent soul capsule: full text of soul.md */
-    soulMd: string;
-    /** Game strategy: the section of strategy.json relevant to this game (serialized) */
-    strategyText: string;
-    /** Game ID, e.g. "texas_holdem" */
-    gameId: string;
-    /** Platform match ID (for logging context, never injected into trusted block) */
-    platformMatchId: string;
-    /**
-     * Recent platform events from this session's events.jsonl, serialized to a
-     * human-readable string. The caller is responsible for summarizing / selecting
-     * which events to include. This text is wrapped in untrusted delimiters.
-     */
-    recentEventsText: string;
-    /**
-     * Current game state from the action_request message.
-     * Typically a JSON-serializable object; passed as JSON string.
-     */
-    currentStateJson: string;
-    /**
-     * Legal actions array from the action_request message.
-     * Must be a valid JSON array string.
-     */
-    legalActionsJson: string;
-    /** Turn index within the match (zero-based) */
-    turnIndex: number;
-    /** Provider profile ID (included in context for transparency) */
-    providerProfileId: string;
-}
-/**
- * Assembles the complete system + user prompt pair for a single decision.
- *
- * Prompt assembly order:
- *   System:
- *     1. Invariant instructions (AIFight decision engine contract)
- *     2. Agent soul capsule (soul.md)
- *     3. Game strategy (strategy.json section for current game)
- *     4. Anti-injection rule
- *     7. Output contract (required JSON response schema)
- *   User:
- *     5. Match context (recent events from this session only)
- *     6. Current state from platform (action_request.state)
- *        + Legal actions (strict JSON array)
- */
-export declare function buildSessionContext(opts: BuildSessionContextOpts): SessionContext;