integration.ts

import type { AgentDescriptor } from '@garcon/common/agent-integration';
import type { AgentHost } from './host.js';
import type {
  AgentAuth,
  AgentAttachments,
  AgentCatalog,
  AgentCommands,
  AgentEndpoints,
  AgentCompaction,
  AgentLifecycle,
  AgentMigration,
  AgentSettings,
  AgentSingleQuery,
  AgentSteering,
  AgentReadiness,
  AgentLiteralExecution,
} from './services.js';
import type { AgentNativeFork } from './native-fork.js';
import type {
  AgentConfigurationValidation,
  AgentProjectPathUpdates,
  AgentSessionConfigurationUpdates,
} from './execution.js';
import type { AgentExecutionV5 } from './execution-v5.js';
import type { AgentPermissions, AgentProducers } from './producer.js';
import type {
  AgentHistoryImport,
  AgentNativeActivityProbe,
  AgentNativeSessionAccess,
} from './native-history.js';
import type { AgentUsageHistory } from './usage-history.js';

export interface AgentIntegration {
  readonly descriptor: AgentDescriptor;
  readonly literalExecution: AgentLiteralExecution | null;
  readonly readiness: AgentReadiness | null;
  readonly attachments: AgentAttachments | null;
  readonly execution: AgentExecutionV5;
  readonly producers: AgentProducers;
  readonly permissions: AgentPermissions;
  readonly catalog: AgentCatalog;
  readonly settings: AgentSettings;
  readonly lifecycle: AgentLifecycle;
  readonly migration: AgentMigration;
  readonly auth: AgentAuth | null;
  readonly commands: AgentCommands | null;
  readonly compaction: AgentCompaction | null;
  readonly forking: AgentNativeFork | null;
  readonly steering: AgentSteering | null;
  readonly endpoints: AgentEndpoints | null;
  readonly singleQuery: AgentSingleQuery | null;
  // Imports what a chat's recorded native session held before its transcript
  // ledger existed; core skips it for a chat that records no native session.
  readonly legacyHistoryImport: AgentHistoryImport | null;
  readonly nativeHistoryImport: AgentHistoryImport | null;
  readonly nativeActivity: AgentNativeActivityProbe | null;
  readonly nativeSessions: AgentNativeSessionAccess | null;
  readonly configurationValidation: AgentConfigurationValidation | null;
  readonly sessionConfiguration: AgentSessionConfigurationUpdates | null;
  readonly projectPathUpdates: AgentProjectPathUpdates | null;
  readonly usageHistory: AgentUsageHistory | null;
}

export interface AgentIntegrationClass {
  new (host: AgentHost): AgentIntegration;
  readonly integrationId: string;
  readonly apiVersion: 5;
}