client-api.ts

// Public API for programmatic session management.
// Import from "@compoundingtech/pty/client".

// Session management
export {
  listSessions, getSession, gc, pruneOrphanLayoutTags, isGone,
  validateName, updateTags, setDisplayName, patchMetadataById,
  getSessionDir, getSocketPath,
  cleanupSocket, cleanupAll,
  // Exposed for the same reason as `isReservedTagKey`: downstream tools
  // (relay, layout, supervisors) need to answer "is this session exempt
  // from reaping?" without re-deriving which tag values count as set.
  KEEP_TAG, isKeepRequested, shouldReapAtExit,
  type SessionInfo, type SessionMetadata, type MetadataPatch, type MetadataPatchResult,
  type PrunedTagResult, type GcResult,
} from "./sessions.ts";

// Session creation
export { spawnDaemon, resolveCommand, waitForSocket, setServerModulePath, type SpawnDaemonOptions } from "./spawn.ts";

// Session interaction (programmatic — no process.exit, no stdin/stdout)
export {
  SessionConnection, sendData, peekScreen,
  type SessionConnectionOptions, type SendDataOptions, type PeekScreenOptions,
} from "./connection.ts";

// Session interaction (CLI-oriented — uses process.stdin/stdout, may call process.exit)
export {
  attach, peek, send, queryStats,
  TERMINAL_SANITIZE,
  type AttachOptions, type PeekOptions, type SendOptions,
  type StatsResult, type ProcessResources,
} from "./client.ts";

// Harness-neutral activity lease. Codex/Claude-specific adapters live outside
// pty and publish only these generic states.
export {
  ActivityPublisher, connectActivityPublisher,
  type ActivityPublisherOptions, type ActivityPublishOptions,
} from "./activity-client.ts";
export {
  ACTIVITY_STATES,
  type ActivityState, type ActivityStatus,
} from "./activity.ts";
export {
  compareAndSend,
  type CompareAndSendOptions,
} from "./guarded-send-client.ts";
export {
  MAX_GUARDED_DATA_BYTES,
  type GuardedSendCommand, type GuardedSendResponse,
} from "./guarded-send.ts";

// Events
export {
  EventType,
  EventFollower, readRecentEvents, formatEvent,
  emitUserEvent, appendEvent, isUserEvent, validateUserEventType,
  type EventRecord, type EventBase,
  type BellEvent, type TitleChangeEvent, type NotificationEvent,
  type FocusRequestEvent, type CursorVisibleEvent,
  type SessionStartEvent, type SessionExitEvent, type SessionExecEvent,
  type SessionRespawnEvent,
  type UserEvent,
  type DisplayNameChangeEvent, type TagsChangeEvent, type MetadataChangeEvent,
  type FollowerOptions,
} from "./events.ts";

// Project files
export { readPtyFile, type PtyFile, type PtySessionDef } from "./ptyfile.ts";

// Tag filter helpers (used by --filter-tag; shared with pty-relay)
export { extractFilterTags, matchesAllTags, isReservedTagKey } from "./tags.ts";

// Duration parse/format — used by `pty list --older-than/--newer-than`,
// available here so downstream tools can accept the same grammar.
export { parseDuration, formatDuration } from "./duration.ts";

// Keys
export { resolveKey, parseSeqValue } from "./keys.ts";

// Protocol (advanced)
export {
  PacketReader, MessageType, encodeActivity, encodeGuardedData,
  type Packet,
} from "./protocol.ts";