agl 1.0.17 → 21.0.2

package/dist_ts/interfaces.gitreversion.d.ts

@@ -0,0 +1,246 @@
+import type * as plugins from './plugins.js';
+import type { IControllerFilesystemIdentity } from './interfaces.projects.js';
+export type TGitReversionDirection = 'undo' | 'redo';
+export type TGitReversionSideName = 'before' | 'after';
+export type TGitReversionWalPhase = 'intent' | 'preflighted' | 'applying' | 'targetVerified' | 'decision' | 'committed' | 'compensating' | 'compensated' | 'fenced';
+export type TGitReversionWorktreeState = 'intent' | 'created' | 'registered' | 'active' | 'removing' | 'retainedDirty' | 'removed' | 'fenced';
+export type TGitReversionFaultPoint = 'intent.before-fsync' | 'intent.after-fsync' | 'intent.before-ref-cas' | 'intent.after-ref-cas' | 'intent.before-commit-fsync' | 'intent.after-commit-fsync' | 'intent.before-remove' | 'intent.after-remove' | 'atomic.after-rename-before-directory-fsync' | 'capture.after-before-scan' | 'capture.before-finalize-record' | 'capture.after-finalize-record-fsync' | 'capture.after-staging-repository' | 'capture.after-intent-repository' | 'capture.after-state-repository' | 'capture.after-manifest-repository' | 'capture.before-store-create' | 'capture.after-store-create' | 'capture.before-generation-enrollment' | 'capture.after-generation-enrollment' | 'capture.after-publication-fsync' | 'capture.before-root-delete' | 'capture.after-root-delete' | 'capture.after-root-delete-fsync' | 'apply.after-intent' | 'apply.after-preflight' | 'apply.after-source-pack-import' | 'apply.after-source-pack-fsync' | 'apply.after-repository' | 'apply.after-target-verification' | 'apply.after-decision-repository' | 'apply.after-decision' | 'apply.after-state-repository' | 'apply.during-compensation' | 'apply.before-source-keep-remove' | 'apply.after-source-keep-quarantine' | 'apply.after-source-keep-remove' | 'apply.after-source-keep-remove-fsync' | 'worktree.after-intent' | 'worktree.after-create' | 'worktree.after-removed-record' | 'worktree.record-read.after-open' | 'index.before-sidecar-fsync' | 'index.after-sidecar-fsync' | 'index.after-link' | 'index.after-link-fsync' | 'index.after-rename' | 'index.after-rename-fsync' | 'index.after-cleanup' | 'index.after-cleanup-fsync';
+export type TGitReversionReference = {
+    schemaVersion: 1;
+    captureKey: string;
+    manifestId: string;
+};
+export type TGitReversionFinalizedOutcome = plugins.flexharness.TFlexTurnReversionFinalizedOutcome;
+export type TGitReversionCaptureInspection = plugins.flexharness.TFlexTurnReversionCaptureInspectionV2;
+export type TGitReversionApplyInspection = plugins.flexharness.IFlexTurnReversionApplyInspection;
+export interface IGitReversionIdentity {
+    projectId: string;
+    sessionId: string;
+    runId: string;
+    captureId: string;
+}
+export interface IGitReversionCaptureRequest extends IGitReversionIdentity {
+    signal?: AbortSignal;
+}
+export interface IGitReversionApplyRequest {
+    identity: IGitReversionIdentity;
+    reference: TGitReversionReference;
+    operationId: string;
+    direction: TGitReversionDirection;
+    signal?: AbortSignal;
+}
+export interface IGitReversionReleaseRequest {
+    identity: IGitReversionIdentity;
+    reference: TGitReversionReference;
+    signal?: AbortSignal;
+}
+export interface IGitReversionMetadataRequest {
+    identity: IGitReversionIdentity;
+    reference: TGitReversionReference;
+    signal?: AbortSignal;
+}
+export interface IGitReversionWorktreeRequest {
+    projectId: string;
+    sessionId: string;
+    signal?: AbortSignal;
+}
+export interface IGitReversionWorktreeRemoveRequest extends IGitReversionWorktreeRequest {
+    worktreeId: string;
+}
+export interface IGitReversionLimits {
+    maximumProjects: number;
+    maximumRepositories: number;
+    maximumScannedDirectories: number;
+    maximumScanDepth: number;
+    maximumPaths: number;
+    maximumPathBytes: number;
+    maximumMetadataBytes: number;
+    maximumPrivateRefs: number;
+    maximumPrivateMetadataAggregateBytes: number;
+    maximumIntentFiles: number;
+    maximumIntentEntries: number;
+    maximumIntentFileBytes: number;
+    maximumIntentAggregateBytes: number;
+    maximumScavengeEntries: number;
+    maximumIgnorePolicyFiles: number;
+    maximumIgnorePolicyBytes: number;
+    maximumWorktrees: number;
+    maximumCaptureRecords: number;
+    maximumCaptureRecordBytes: number;
+    maximumCaptureAggregateBytes: number;
+    maximumCaptures: number;
+    maximumGenerationsPerCapture: number;
+    maximumGenerationBytes: number;
+    maximumGenerationObjects: number;
+    maximumCaptureStoreBytes: number;
+    maximumCaptureStoreObjects: number;
+    maximumControllerStoreBytes: number;
+    maximumControllerStoreObjects: number;
+    maximumControllerGenerations: number;
+    maximumMetadataRecordsPerCapture: number;
+    maximumMetadataRecordBytes: number;
+    maximumMetadataAggregateBytes: number;
+    maximumLifecycleEntries: number;
+    maximumLifecycleRecordBytes: number;
+    maximumLifecycleAggregateBytes: number;
+    maximumPrivateRefsPerCapture: number;
+    commandTimeoutMs: number;
+    worktreeCommandTimeoutMs: number;
+    maximumCommandOutputBytes: number;
+    maximumConcurrentGitCommands: number;
+    maximumQueuedGitCommands: number;
+}
+export interface IGitReversionFaultContext {
+    point: TGitReversionFaultPoint;
+    captureKey?: string;
+    operationId?: string;
+    repositoryId?: string;
+    worktreeId?: string;
+    intentId?: string;
+    ref?: string;
+}
+export interface IGitReversionOptions {
+    ownerId: string;
+    /** This path must be exclusively owned by one live controller process. */
+    temporaryRoot?: string;
+    limits?: Partial<IGitReversionLimits>;
+    testOnlyFaultInjector?: (context: IGitReversionFaultContext) => Promise<void> | void;
+}
+export interface IGitReversionRepositoryIdentity {
+    scope: 'project' | 'owned-worktree';
+    repositoryId: string;
+    commonId: string;
+    objectFormat: 'sha1' | 'sha256';
+    root: string;
+    rootIdentity: IControllerFilesystemIdentity;
+    gitEntryPath: string;
+    gitEntryIdentity: IControllerFilesystemIdentity;
+    gitDir: string;
+    gitDirIdentity: IControllerFilesystemIdentity;
+    commonDir: string;
+    commonDirIdentity: IControllerFilesystemIdentity;
+    objectDir: string;
+    objectDirIdentity: IControllerFilesystemIdentity;
+    indexPath: string;
+    indexParentIdentity: IControllerFilesystemIdentity;
+    label: string;
+    excludedRepositoryPaths: string[];
+}
+export interface IGitReversionSide {
+    objectGenerationId?: string;
+    worktreeTree: string;
+    indexTree: string;
+    headOid: string;
+    headRef: string | null;
+    refs: Record<string, string>;
+    symbolicRefs: Record<string, string>;
+    topologyHash: string;
+    ignorePolicyHash: string;
+    operationHash: string;
+    unsupportedReason?: string;
+}
+export interface IGitReversionRepositoryCapture {
+    repository: IGitReversionRepositoryIdentity;
+    before: IGitReversionSide;
+    after?: IGitReversionSide;
+}
+export interface IGitReversionManifest {
+    schemaVersion: 1;
+    kind: 'manifest';
+    ownerKey: string;
+    captureKey: string;
+    identity: IGitReversionIdentity;
+    projectDirectory: string;
+    projectIdentity: IControllerFilesystemIdentity;
+    phase: 'prepared' | 'finalized';
+    repositories: IGitReversionRepositoryCapture[];
+    reasonCode?: string;
+    affectedWorkspaces: Array<{
+        id: string;
+        label: string;
+    }>;
+}
+export interface IGitReversionCaptureState {
+    schemaVersion: 1;
+    kind: 'capture-state';
+    captureKey: string;
+    manifestId: string;
+    currentSide: TGitReversionSideName;
+    revision: number;
+    outcome: TGitReversionFinalizedOutcome;
+}
+export interface IGitReversionSourcePack {
+    generationId: string;
+    packHash: string;
+    packBytes: number;
+    objectCount: number;
+    syntheticRootOid: string;
+    keepToken: string;
+}
+export interface IGitReversionApplyPlan {
+    captureKey: string;
+    repository: IGitReversionRepositoryIdentity;
+    initial: IGitReversionSide;
+    source: IGitReversionSide;
+    target: IGitReversionSide;
+    desiredWorktreeTree: string;
+    desiredIndexTree: string;
+    scopedRefs: string[];
+    sourcePack: IGitReversionSourcePack;
+}
+export interface IGitReversionApplyWal {
+    schemaVersion: 1;
+    kind: 'apply-wal';
+    captureKey: string;
+    manifestId: string;
+    operationId: string;
+    operationKey: string;
+    direction: TGitReversionDirection;
+    attempt: number;
+    sourceSide: TGitReversionSideName;
+    targetSide: TGitReversionSideName;
+    sourceRevision: number;
+    phase: TGitReversionWalPhase;
+    decision?: 'source' | 'target';
+    touchedRepositoryIds: string[];
+    plans: IGitReversionApplyPlan[];
+    generationIds: Record<string, string[]>;
+}
+export interface IGitReversionWorktreeDescriptor {
+    worktreeId: string;
+    projectId: string;
+    sessionId: string;
+    path: string;
+    repositoryId: string;
+    createdAt: string;
+    state: Exclude<TGitReversionWorktreeState, 'intent' | 'created' | 'registered' | 'removed'>;
+}
+export interface IGitReversionWorktreeRecord {
+    schemaVersion: 1;
+    kind: 'worktree';
+    ownerKey: string;
+    worktreeId: string;
+    projectId: string;
+    sessionId: string;
+    path: string;
+    parentPath: string;
+    parentIdentity: IControllerFilesystemIdentity;
+    pathIdentity?: IControllerFilesystemIdentity;
+    sourceRoot: string;
+    sourceCommonDir: string;
+    sourceRepository: IGitReversionRepositoryIdentity;
+    repositoryId: string;
+    createdAt: string;
+    state: TGitReversionWorktreeState;
+}
+export interface IGitReversionMetadata {
+    reference: TGitReversionReference;
+    disposition: TGitReversionFinalizedOutcome['disposition'];
+    currentSide: TGitReversionSideName;
+    revision: number;
+    affectedWorkspaces: Array<{
+        id: string;
+        label: string;
+    }>;
+    reasonCode?: string;
+}

package/dist_ts/interfaces.gitreversion.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5naXRyZXZlcnNpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9pbnRlcmZhY2VzLmdpdHJldmVyc2lvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist_ts/interfaces.lifecycle.d.ts

@@ -0,0 +1,37 @@
+import type { IControllerStatus, TControllerProcessMode } from '../dist_ts_interfaces/index.js';
+import type { IControllerRuntimeOverrides } from './interfaces.config.js';
+export interface IControllerStartOptions {
+    processMode: TControllerProcessMode;
+    runtimeOverrides: IControllerRuntimeOverrides;
+    /** Operator-provided first-start setup code; a random code is minted when absent. */
+    setupCode?: string;
+    /** Private upgrade transaction token received over parent IPC. */
+    upgradeToken?: string;
+    upgradeGlobalRoot?: string;
+    onStartupBlocked?: (errorArg: Error) => Promise<void>;
+}
+export interface IControllerStartResult {
+    status: IControllerStatus;
+    publicUrl: string;
+    setupCode?: string;
+}
+export interface IControllerReadyIpcMessage {
+    type: 'ready';
+    status: IControllerStatus;
+    publicUrl: string;
+    setupCode?: string;
+}
+export interface IControllerStartupErrorIpcMessage {
+    type: 'startupError';
+    message: string;
+    retained?: true;
+}
+export interface IControllerStartIpcMessage {
+    type: 'start';
+    /** Transported over IPC so the code never appears in the detached child's argv. */
+    setupCode?: string;
+    /** Transported over IPC so the token never appears in the detached child's argv. */
+    upgradeToken?: string;
+    upgradeGlobalRoot?: string;
+}
+export type TControllerIpcMessage = IControllerReadyIpcMessage | IControllerStartupErrorIpcMessage | IControllerStartIpcMessage;

package/dist_ts/interfaces.lifecycle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5saWZlY3ljbGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9pbnRlcmZhY2VzLmxpZmVjeWNsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist_ts/interfaces.opencode.d.ts

@@ -0,0 +1,101 @@
+import type * as plugins from './plugins.js';
+import type { IControllerEvent, IControllerMessage, IControllerReasoningUpdate, IControllerRuntimeId, IControllerTextUpdate, IControllerToolExecution, TControllerHarnessLifecycleState } from '../dist_ts_interfaces/index.js';
+export declare const openCodeExpectedVersion: "1.18.15";
+export declare const openCodeUsername: "harness-controller";
+export interface IOpenCodeHealth {
+    healthy: true;
+    version: typeof openCodeExpectedVersion;
+}
+export interface IOpenCodeLogEntry {
+    timestamp: number;
+    stream: 'stdout' | 'stderr';
+    line: string;
+    truncated: boolean;
+}
+export interface IOpenCodeSupervisorStatus {
+    state: TControllerHarnessLifecycleState;
+    healthy: boolean;
+    pid?: number;
+    version?: string;
+    startedAt?: number;
+}
+export interface IOpenCodeConnectionConfig {
+    baseUrl: string;
+    directory: string;
+    username: typeof openCodeUsername;
+    password: string;
+}
+export interface IOpenCodeProcessGroupController {
+    isAlive(processGroupIdArg: number): boolean | Promise<boolean>;
+    signal(processGroupIdArg: number, signalArg: 'SIGTERM' | 'SIGKILL'): void | Promise<void>;
+}
+export interface IOpenCodeSupervisorOptions {
+    directory: string;
+    port: number;
+    startupTimeoutMs?: number;
+    healthRequestTimeoutMs?: number;
+    healthPollIntervalMs?: number;
+    stopTimeoutMs?: number;
+    finalStopTimeoutMs?: number;
+    logEntryLimit?: number;
+    logLineByteLimit?: number;
+    spawnFactory?: typeof plugins.childProcess.spawn;
+    fetchImplementation?: typeof globalThis.fetch;
+    listenerOwnershipVerifier?: (processId: number, port: number) => boolean | Promise<boolean>;
+    processGroupController?: IOpenCodeProcessGroupController;
+    /** Called after the owned child exits and can no longer access operation resources. */
+    onChildExit?: () => void;
+}
+export type TOpenCodeSdkClient = ReturnType<typeof plugins.opencodeSdk.createOpencodeClient>;
+export interface IOpenCodeClientOptions extends IOpenCodeConnectionConfig {
+    clientFactory?: typeof plugins.opencodeSdk.createOpencodeClient;
+    fetchImplementation?: typeof globalThis.fetch;
+    /** Current-generation lease held until each non-streaming SDK response body settles. */
+    acquireRuntimeLease?: () => () => void;
+}
+/** Adapter-internal normalized entries derived from one OpenCode source message. */
+export interface IOpenCodeNormalizedMessageBundle {
+    sourceMessageId: IControllerRuntimeId;
+    structuralDigest: string;
+    sourceRole: 'user' | 'assistant';
+    parentMessageId?: IControllerRuntimeId;
+    terminal: boolean;
+    messages: IControllerMessage[];
+}
+export interface IOpenCodeMessageLifecycle {
+    sessionId: IControllerRuntimeId;
+    messageId: IControllerRuntimeId;
+    role: 'user' | 'assistant';
+    parentMessageId?: IControllerRuntimeId;
+    terminal: boolean;
+}
+/** Adapter-internal page shape; cursors remain opaque OpenCode values. */
+export interface IOpenCodeMessagePage {
+    bundles: IOpenCodeNormalizedMessageBundle[];
+    nextCursor?: string;
+}
+export type TOpenCodeToolExecution = Omit<IControllerToolExecution, 'revision' | 'streamEpoch'>;
+export type TOpenCodeReasoningUpdate = Omit<IControllerReasoningUpdate, 'order' | 'revision' | 'streamEpoch'>;
+export type TOpenCodeTextUpdate = Omit<IControllerTextUpdate, 'order' | 'revision' | 'streamEpoch'>;
+export interface IOpenCodeEventStreamOptions {
+    /** directory is the raw project worktree the event belongs to. */
+    onEvent: (event: IControllerEvent, directory: string) => void | Promise<void>;
+    /** Replace-only tool snapshot; the controller assigns delivery ordering. */
+    onToolExecution?: (execution: TOpenCodeToolExecution, directory: string, timestamp: number) => void | Promise<void>;
+    /** Replace-only Assistant reasoning snapshot; the controller assigns ordering. */
+    onReasoningUpdate?: (update: TOpenCodeReasoningUpdate, directory: string) => void | Promise<void>;
+    /** Replace-only Assistant text snapshot; the controller assigns ordering. */
+    onTextUpdate?: (update: TOpenCodeTextUpdate, directory: string) => void | Promise<void>;
+    /** Exact source-message lifecycle used for controller-owned resource cleanup. */
+    onMessageLifecycle?: (lifecycle: IOpenCodeMessageLifecycle, directory: string) => void | Promise<void>;
+    /** Fires in stream order for the initial connection and every SDK reconnect. */
+    onConnected?: () => void | Promise<void>;
+    /** Signals that live snapshots may have been lost or could not be normalized. */
+    onToolStreamGap?: () => void | Promise<void>;
+    /** Signals that live Assistant snapshots may have been lost or could not be normalized. */
+    onMessageStreamGap?: () => void | Promise<void>;
+    /** Signals that the shared SDK stream ended and both snapshot streams were lost. */
+    onStreamGap?: () => void | Promise<void>;
+    onError?: (error: Error) => void;
+    signal?: AbortSignal;
+}

package/dist_ts/interfaces.opencode.js

@@ -0,0 +1,3 @@
+export const openCodeExpectedVersion = '1.18.15';
+export const openCodeUsername = 'harness-controller';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5vcGVuY29kZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2ludGVyZmFjZXMub3BlbmNvZGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBV0EsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQUcsU0FBa0IsQ0FBQztBQUMxRCxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxvQkFBNkIsQ0FBQyJ9

package/dist_ts/interfaces.projects.d.ts

@@ -0,0 +1,156 @@
+import type { IControllerRuntimeId, TControllerResourceKind, TControllerSessionId, TControllerModelChoice, TControllerScratchpadUpdater, TControllerIntelligenceStatus, IControllerIntelligenceExchange, IControllerSessionScratchpad } from '../dist_ts_interfaces/index.js';
+import type * as plugins from './plugins.js';
+export declare const controllerProjectLimit = 512;
+export declare const controllerResourceLimit = 4096;
+export declare const controllerResourcesPerProjectLimit = 64;
+export declare const controllerFilesystemIdentityMaximumComponents = 512;
+export type TControllerFilesystemObjectType = 'directory' | 'file';
+export interface IControllerFilesystemIdentityComponent {
+    device: string;
+    inode: string;
+    type: TControllerFilesystemObjectType;
+}
+export interface IControllerFilesystemIdentity {
+    /** Ordered filesystem identities from the filesystem root through the target. */
+    ancestry: IControllerFilesystemIdentityComponent[];
+}
+export interface IControllerProjectFilesystemIdentity extends IControllerFilesystemIdentity {
+}
+export interface IControllerPersistedSessionGroup {
+    id: string;
+    name: string;
+    sessionIds: TControllerSessionId[];
+}
+export interface IControllerProjectDocument {
+    /** 16-byte base64url identifier. */
+    id: string;
+    /** `controller:<port>` owner scope. */
+    controllerId: string;
+    /** Directory name under the projects root; doubles as display name. */
+    name: string;
+    /** Absolute resolved path of the project worktree. */
+    directory: string;
+    /** Legacy projects that could not be verified during migration remain permanently unbound. */
+    directoryIdentityState: 'bound' | 'unbound';
+    /** Complete root-to-project filesystem ancestry, present only while bound. */
+    directoryIdentity?: IControllerProjectFilesystemIdentity;
+    createdAt: Date;
+    /** Durable write-before-cleanup intent; startup resumes this removal. */
+    removalStartedAt?: Date;
+    /** Tombstone: set when the project is deregistered; files stay untouched. */
+    removedAt?: Date;
+}
+export interface IControllerSessionGroupsDocument {
+    /** `${controllerId}:groups:${projectId}` — one persisted session layout per project. */
+    id: string;
+    controllerId: string;
+    projectId: string;
+    groups: IControllerPersistedSessionGroup[];
+    /** Present with revision; both are absent on legacy documents. */
+    ungroupedSessionIds?: TControllerSessionId[];
+    /** Present with ungroupedSessionIds; legacy documents are interpreted as revision zero. */
+    revision?: number;
+}
+export interface IControllerPendingResourceAttachment {
+    operationId: string;
+    attachmentRevision: number;
+    sessionId: TControllerSessionId | null;
+    requestedAt: Date;
+}
+export interface IControllerTerminalResourceMetadata {
+    command: string;
+    args: string[];
+    cwd: string;
+    stoppedAt?: Date;
+    lastExitCode?: number;
+}
+export interface IControllerResourceDocument {
+    /** Random stable public identifier. */
+    id: string;
+    controllerId: string;
+    projectId: string;
+    kind: TControllerResourceKind;
+    title: string;
+    /** Stable BrowserRuntime attachment authority for the resource lifetime. */
+    attachmentAuthorityId: string;
+    attachmentRevision: number;
+    sessionId: TControllerSessionId | null;
+    /** Write-before-side-effect attachment obligation. */
+    pendingAttachment?: IControllerPendingResourceAttachment;
+    lifecycle: 'active' | 'retiring' | 'retired';
+    terminal?: IControllerTerminalResourceMetadata;
+    createdAt: Date;
+    updatedAt: Date;
+    retiringAt?: Date;
+    retiredAt?: Date;
+    /** Reconciliation identity for the newest exact write. */
+    updateId: string;
+}
+export interface IControllerSettingsDocument {
+    /** `controller:<port>:settings` — one settings document per controller. */
+    id: string;
+    controllerId: string;
+    /** At most one default per session harness. */
+    defaultModels: TControllerModelChoice[];
+    /** Present only as `true`; absent means permission requests wait for a human. */
+    autoAcceptPermissions?: true;
+    /** Flex provider connection currently installed into the controller-owned OpenCode runtime. */
+    selectedOpenCodeProviderConnectionId?: string;
+}
+export interface IControllerPersistedIntelligenceExchange {
+    id: string;
+    question: string;
+    status: TControllerIntelligenceStatus;
+    answer?: string;
+    error?: string;
+    model?: string;
+    scratchpadConflict?: true;
+    /** Private admission state, present only while status is running. */
+    scratchpadRevisionAtAdmission?: number;
+    /** Cleanup obligation retained until the temporary OpenCode session is confirmed deleted. */
+    temporarySessionId?: string;
+    createdAt: Date;
+    completedAt?: Date;
+}
+export interface IControllerSessionStateDocument {
+    /** Hash of the complete controller/project/qualified-session scope. */
+    id: string;
+    controllerId: string;
+    projectId: string;
+    sessionId: IControllerRuntimeId;
+    scratchpad: {
+        text: string;
+        revision: number;
+        updatedAt?: Date;
+        updatedBy?: TControllerScratchpadUpdater;
+    };
+    intelligenceExchanges: IControllerPersistedIntelligenceExchange[];
+    /** Exact FlexHarness project-management state for Flex sessions. */
+    flexProjectManagement?: plugins.flexharness.TFlexProjectManagementRecord;
+    /** Durable per-session model choice; absent means use the harness default. */
+    modelChoice?: TControllerModelChoice;
+    /** Fixed-size reconciliation identity for the newest exact transition. */
+    updateId: string;
+    /** Content-clearing tombstone; TTL cleanup is best-effort storage maintenance. */
+    deletedAt?: Date;
+}
+export interface IControllerSessionState {
+    scratchpad: IControllerSessionScratchpad;
+    intelligenceExchanges: IControllerIntelligenceExchange[];
+    modelChoice?: TControllerModelChoice;
+}
+export interface IControllerIntelligenceAdmission {
+    exchange: IControllerIntelligenceExchange;
+    scratchpadRevision: number;
+    scratchpadText: string;
+}
+export interface IControllerInterruptedIntelligenceRecovery {
+    recoveredCount: number;
+    exhaustive: boolean;
+    temporarySessionIds: Array<{
+        projectId: string;
+        sessionId: IControllerRuntimeId;
+        exchangeId: string;
+        nativeId: string;
+    }>;
+}

package/dist_ts/interfaces.projects.js

@@ -0,0 +1,5 @@
+export const controllerProjectLimit = 512;
+export const controllerResourceLimit = 4096;
+export const controllerResourcesPerProjectLimit = 64;
+export const controllerFilesystemIdentityMaximumComponents = 512;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5wcm9qZWN0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2ludGVyZmFjZXMucHJvamVjdHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBYUEsTUFBTSxDQUFDLE1BQU0sc0JBQXNCLEdBQUcsR0FBRyxDQUFDO0FBQzFDLE1BQU0sQ0FBQyxNQUFNLHVCQUF1QixHQUFHLElBQUksQ0FBQztBQUM1QyxNQUFNLENBQUMsTUFBTSxrQ0FBa0MsR0FBRyxFQUFFLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sNkNBQTZDLEdBQUcsR0FBRyxDQUFDIn0=

package/dist_ts/plugins.d.ts

@@ -0,0 +1,36 @@
+import * as childProcess from 'node:child_process';
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import { createRequire } from 'node:module';
+import * as net from 'node:net';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as stream from 'node:stream';
+import * as url from 'node:url';
+import * as util from 'node:util';
+export { childProcess, createRequire, crypto, fs, net, os, path, stream, url, util };
+import * as smartcli from '@push.rocks/smartcli';
+import * as smartagent from '@push.rocks/smartagent';
+import * as smartagentCompaction from '@push.rocks/smartagent/compaction';
+import * as smartagentTools from '@push.rocks/smartagent/tools';
+import * as smartai from '@push.rocks/smartai';
+import * as smartaiProviders from '@push.rocks/smartai/providers';
+import * as smartdata from '@push.rocks/smartdata';
+import * as smartdb from '@push.rocks/smartdb';
+import * as smartfs from '@push.rocks/smartfs';
+import * as smartsecret from '@push.rocks/smartsecret';
+import * as smartshell from '@push.rocks/smartshell';
+import * as flexharness from '@modelprofile.com/flexharness';
+import * as browserRuntime from '@modelprofile.com/browser-runtime';
+import * as crossharness from '@modelprofile.com/crossharness-mcp';
+import * as flexharnessMigration from '@modelprofile.com/flexharness/migration';
+import * as typedrequest from '@api.global/typedrequest';
+import * as typedrequestInterfaces from '@api.global/typedrequest-interfaces';
+import * as typedserver from '@api.global/typedserver';
+import * as typedsocket from '@api.global/typedsocket';
+export { flexharness, browserRuntime, crossharness, flexharnessMigration, smartagent, smartagentCompaction, smartagentTools, smartai, smartaiProviders, smartcli, smartdata, smartdb, smartfs, smartsecret, smartshell, typedrequest, typedrequestInterfaces, typedserver, typedsocket, };
+import * as simplewebauthnServer from '@simplewebauthn/server';
+import * as opencodeSdk from '@opencode-ai/sdk/v2';
+import * as systeminformation from 'systeminformation';
+import * as tldts from 'tldts';
+export { opencodeSdk, simplewebauthnServer, systeminformation, tldts };

package/dist_ts/plugins.js

@@ -0,0 +1,40 @@
+// Node native modules
+import * as childProcess from 'node:child_process';
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import { createRequire } from 'node:module';
+import * as net from 'node:net';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as stream from 'node:stream';
+import * as url from 'node:url';
+import * as util from 'node:util';
+export { childProcess, createRequire, crypto, fs, net, os, path, stream, url, util };
+// foss.global modules
+import * as smartcli from '@push.rocks/smartcli';
+import * as smartagent from '@push.rocks/smartagent';
+import * as smartagentCompaction from '@push.rocks/smartagent/compaction';
+import * as smartagentTools from '@push.rocks/smartagent/tools';
+import * as smartai from '@push.rocks/smartai';
+import * as smartaiProviders from '@push.rocks/smartai/providers';
+import * as smartdata from '@push.rocks/smartdata';
+import * as smartdb from '@push.rocks/smartdb';
+import * as smartfs from '@push.rocks/smartfs';
+import * as smartsecret from '@push.rocks/smartsecret';
+import * as smartshell from '@push.rocks/smartshell';
+import * as flexharness from '@modelprofile.com/flexharness';
+import * as browserRuntime from '@modelprofile.com/browser-runtime';
+import * as crossharness from '@modelprofile.com/crossharness-mcp';
+import * as flexharnessMigration from '@modelprofile.com/flexharness/migration';
+import * as typedrequest from '@api.global/typedrequest';
+import * as typedrequestInterfaces from '@api.global/typedrequest-interfaces';
+import * as typedserver from '@api.global/typedserver';
+import * as typedsocket from '@api.global/typedsocket';
+export { flexharness, browserRuntime, crossharness, flexharnessMigration, smartagent, smartagentCompaction, smartagentTools, smartai, smartaiProviders, smartcli, smartdata, smartdb, smartfs, smartsecret, smartshell, typedrequest, typedrequestInterfaces, typedserver, typedsocket, };
+// third-party modules
+import * as simplewebauthnServer from '@simplewebauthn/server';
+import * as opencodeSdk from '@opencode-ai/sdk/v2';
+import * as systeminformation from 'systeminformation';
+import * as tldts from 'tldts';
+export { opencodeSdk, simplewebauthnServer, systeminformation, tldts };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsc0JBQXNCO0FBQ3RCLE9BQU8sS0FBSyxZQUFZLE1BQU0sb0JBQW9CLENBQUM7QUFDbkQsT0FBTyxLQUFLLE1BQU0sTUFBTSxhQUFhLENBQUM7QUFDdEMsT0FBTyxLQUFLLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDOUIsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUM1QyxPQUFPLEtBQUssR0FBRyxNQUFNLFVBQVUsQ0FBQztBQUNoQyxPQUFPLEtBQUssRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUM5QixPQUFPLEtBQUssSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUNsQyxPQUFPLEtBQUssTUFBTSxNQUFNLGFBQWEsQ0FBQztBQUN0QyxPQUFPLEtBQUssR0FBRyxNQUFNLFVBQVUsQ0FBQztBQUNoQyxPQUFPLEtBQUssSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUVsQyxPQUFPLEVBQUUsWUFBWSxFQUFFLGFBQWEsRUFBRSxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxHQUFHLEVBQUUsSUFBSSxFQUFFLENBQUM7QUFFckYsc0JBQXNCO0FBQ3RCLE9BQU8sS0FBSyxRQUFRLE1BQU0sc0JBQXNCLENBQUM7QUFDakQsT0FBTyxLQUFLLFVBQVUsTUFBTSx3QkFBd0IsQ0FBQztBQUNyRCxPQUFPLEtBQUssb0JBQW9CLE1BQU0sbUNBQW1DLENBQUM7QUFDMUUsT0FBTyxLQUFLLGVBQWUsTUFBTSw4QkFBOEIsQ0FBQztBQUNoRSxPQUFPLEtBQUssT0FBTyxNQUFNLHFCQUFxQixDQUFDO0FBQy9DLE9BQU8sS0FBSyxnQkFBZ0IsTUFBTSwrQkFBK0IsQ0FBQztBQUNsRSxPQUFPLEtBQUssU0FBUyxNQUFNLHVCQUF1QixDQUFDO0FBQ25ELE9BQU8sS0FBSyxPQUFPLE1BQU0scUJBQXFCLENBQUM7QUFDL0MsT0FBTyxLQUFLLE9BQU8sTUFBTSxxQkFBcUIsQ0FBQztBQUMvQyxPQUFPLEtBQUssV0FBVyxNQUFNLHlCQUF5QixDQUFDO0FBQ3ZELE9BQU8sS0FBSyxVQUFVLE1BQU0sd0JBQXdCLENBQUM7QUFDckQsT0FBTyxLQUFLLFdBQVcsTUFBTSwrQkFBK0IsQ0FBQztBQUM3RCxPQUFPLEtBQUssY0FBYyxNQUFNLG1DQUFtQyxDQUFDO0FBQ3BFLE9BQU8sS0FBSyxZQUFZLE1BQU0sb0NBQW9DLENBQUM7QUFDbkUsT0FBTyxLQUFLLG9CQUFvQixNQUFNLHlDQUF5QyxDQUFDO0FBQ2hGLE9BQU8sS0FBSyxZQUFZLE1BQU0sMEJBQTBCLENBQUM7QUFDekQsT0FBTyxLQUFLLHNCQUFzQixNQUFNLHFDQUFxQyxDQUFDO0FBQzlFLE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFDdkQsT0FBTyxLQUFLLFdBQVcsTUFBTSx5QkFBeUIsQ0FBQztBQUV2RCxPQUFPLEVBQ0wsV0FBVyxFQUNYLGNBQWMsRUFDZCxZQUFZLEVBQ1osb0JBQW9CLEVBQ3BCLFVBQVUsRUFDVixvQkFBb0IsRUFDcEIsZUFBZSxFQUNmLE9BQU8sRUFDUCxnQkFBZ0IsRUFDaEIsUUFBUSxFQUNSLFNBQVMsRUFDVCxPQUFPLEVBQ1AsT0FBTyxFQUNQLFdBQVcsRUFDWCxVQUFVLEVBQ1YsWUFBWSxFQUNaLHNCQUFzQixFQUN0QixXQUFXLEVBQ1gsV0FBVyxHQUNaLENBQUM7QUFFRixzQkFBc0I7QUFDdEIsT0FBTyxLQUFLLG9CQUFvQixNQUFNLHdCQUF3QixDQUFDO0FBQy9ELE9BQU8sS0FBSyxXQUFXLE1BQU0scUJBQXFCLENBQUM7QUFDbkQsT0FBTyxLQUFLLGlCQUFpQixNQUFNLG1CQUFtQixDQUFDO0FBQ3ZELE9BQU8sS0FBSyxLQUFLLE1BQU0sT0FBTyxDQUFDO0FBRS9CLE9BQU8sRUFBRSxXQUFXLEVBQUUsb0JBQW9CLEVBQUUsaUJBQWlCLEVBQUUsS0FBSyxFQUFFLENBQUMifQ==

package/dist_ts_interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces.js';
+export * from './requests.js';

package/dist_ts_interfaces/index.js

@@ -0,0 +1,3 @@
+export * from './interfaces.js';
+export * from './requests.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxlQUFlLENBQUMifQ==