agl 1.0.17 → 21.0.2

package/ts/interfaces.projects.ts

@@ -0,0 +1,182 @@
+import type {
+  IControllerRuntimeId,
+  TControllerResourceKind,
+  TControllerSessionId,
+  TControllerModelChoice,
+  IControllerSessionGroup,
+  TControllerScratchpadUpdater,
+  TControllerIntelligenceStatus,
+  IControllerIntelligenceExchange,
+  IControllerSessionScratchpad,
+} from '../ts_interfaces/index.js';
+import type * as plugins from './plugins.js';
+
+export const controllerProjectLimit = 512;
+export const controllerResourceLimit = 4096;
+export const controllerResourcesPerProjectLimit = 64;
+export 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/ts/plugins.ts

@@ -0,0 +1,64 @@
+// 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 };

package/ts_interfaces/index.ts

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