@sipher.dev/agents 0.1.0 → 0.1.2

package/dist/local-control.d.ts

@@ -0,0 +1,355 @@
+import { n as LocalControlStatus, r as LocalControlVersionRange, t as LocalControlCapability } from "./local-control-DKnrc-X8.js";
+
+//#region ../machine-protocol/src/deployment.d.ts
+type ConnectorChannel = "latest" | "next";
+interface DeploymentPolicy {
+  deploymentId: string;
+  canonicalOrigin: string;
+  aliases: string[];
+  connectorChannel: ConnectorChannel;
+  connectorVersionRange: string;
+}
+interface DeploymentWellKnown extends DeploymentPolicy {
+  policyDigest: string;
+}
+//#endregion
+//#region ../machine-protocol/src/connector-release.d.ts
+interface SignedConnectorReleaseTuple {
+  packageName: string;
+  platform: "darwin" | "linux" | "win32";
+  arch: "arm64" | "x64";
+  runtimeVersion: string;
+  releaseId: string;
+  tarballUrl: string;
+  integrity: string;
+  manifestDigest: string;
+}
+//#endregion
+//#region src/connector-profile.d.ts
+interface ConnectorProfileContext {
+  serviceKey: string;
+  serviceName: string;
+  serviceUnitName: string;
+  configPath: string;
+  authStorePath: string;
+  logPath: string;
+  errorLogPath: string;
+  launchAgentPath: string;
+  systemdUnitPath: string;
+  registryPath: string;
+  controlSecretPath: string;
+  controlEndpoint: string;
+  statePath: string;
+  launcherPath: string;
+  currentPath: string;
+  previousPath: string;
+  candidatePath: string;
+  launcherActivationPath: string;
+  rollbackErrorPath: string;
+  signedSnapshotPath: string;
+  updateStatePath: string;
+  launcherJournalPath: string;
+  reconciliationLockPath: string;
+  scheduledTaskXmlPath: string;
+  cacheRoot: string;
+  cacheLockPath: string;
+}
+interface ConnectorRootOverrides {
+  configRoot?: string;
+  stateRoot?: string;
+  cacheRoot?: string;
+  launchAgentsRoot?: string;
+  systemdUserRoot?: string;
+}
+//#endregion
+//#region src/connector-registry.d.ts
+interface ConnectorRegistryEntry {
+  schemaVersion: 1;
+  deploymentId: string;
+  serviceKey: string;
+  endpoint: string;
+  controlMinVersion: number;
+  controlMaxVersion: number;
+  serviceName: string;
+  configPath: string;
+  updatedAt: string;
+}
+type LocalConnectorDiscovery = {
+  state: "ready";
+  entry: ConnectorRegistryEntry;
+  status: LocalControlStatus;
+} | {
+  state: "needs_bootstrap";
+  entry?: ConnectorRegistryEntry;
+} | {
+  state: "ownership_conflict";
+  entry: ConnectorRegistryEntry;
+};
+//#endregion
+//#region src/deployment-discovery.d.ts
+type DeploymentIdentity = DeploymentWellKnown;
+interface DeploymentDiscovery extends DeploymentIdentity {
+  serverUrl: string;
+  serviceKey: string;
+}
+declare function discoverDeployment(serverUrl: string, options?: {
+  fetch?: typeof fetch;
+  candidateFetch?: typeof fetch;
+  canonicalFetch?: typeof fetch;
+  allowInsecureTls?: boolean | undefined;
+  trustedCanonicalOrigin?: string | undefined;
+  expectedDeploymentId?: string | undefined;
+}): Promise<DeploymentDiscovery>;
+//#endregion
+//#region src/release-tooling-bridge.d.mts
+interface ConnectorPlatform {
+  packageName: string;
+  platform: "darwin" | "linux" | "win32";
+  arch: "arm64" | "x64";
+  minimumHost: string;
+}
+interface ConnectorReleaseTuple {
+  packageName: string;
+  platform: "darwin" | "linux" | "win32";
+  arch: "arm64" | "x64";
+  runtimeVersion: string;
+  releaseId: string;
+  tarballUrl: string;
+  integrity: string;
+  manifestDigest: string;
+}
+interface ConnectorReleaseIndex {
+  schemaVersion: 1;
+  indexVersion: string;
+  releaseId: string;
+  sequence: number;
+  runtimeVersion: string;
+  tuples: ConnectorReleaseTuple[];
+}
+//#endregion
+//#region src/release-resolver.d.ts
+interface SignedReleaseSnapshot {
+  channel: "latest" | "next";
+  sequence: number;
+  indexVersion: string;
+  digest: string;
+  index: ConnectorReleaseIndex;
+  signature: string;
+  tuple: ConnectorReleaseTuple;
+}
+interface VerifiedConnectorRelease {
+  snapshot: SignedReleaseSnapshot;
+  packageRoot: string;
+  manifest: Record<string, unknown>;
+  dispose(): Promise<void>;
+}
+declare function resolveVerifiedConnectorRelease(deployment: DeploymentDiscovery, options?: {
+  fetch?: typeof fetch;
+  platform?: NodeJS.Platform;
+  arch?: string;
+  trustAnchor?: ConnectorTrustAnchor;
+  platforms?: Record<string, ConnectorPlatform>;
+  host?: HostCompatibility;
+  etag?: string;
+  onEtag?: (etag: string) => void;
+}): Promise<VerifiedConnectorRelease>;
+declare function resolveVerifiedConnectorSnapshot(snapshot: SignedReleaseSnapshot, options?: {
+  fetch?: typeof fetch;
+  platform?: NodeJS.Platform;
+  arch?: string;
+  trustAnchor?: ConnectorTrustAnchor;
+  platforms?: Record<string, ConnectorPlatform>;
+  host?: HostCompatibility;
+}): Promise<VerifiedConnectorRelease>;
+interface ConnectorTrustAnchor {
+  schemaVersion: 1;
+  releasePackageName: string;
+  npmRegistryOrigin: string;
+  publicKey: string;
+  latest: {
+    sequence: number;
+    indexVersion: string;
+    digest: string;
+  };
+}
+interface HostCompatibility {
+  platform: NodeJS.Platform;
+  release: string;
+  glibcVersion?: string;
+  glibcxxVersion?: string;
+}
+//#endregion
+//#region src/service-manager.d.ts
+declare const SUPPORTED_SERVICE_PLATFORMS: readonly ["darwin", "linux", "win32"];
+type SupportedServicePlatform = (typeof SUPPORTED_SERVICE_PLATFORMS)[number];
+type CommandRunner = (command: string, args: string[], options?: {
+  allowFailure?: boolean;
+  quietFailure?: boolean;
+}) => Promise<void>;
+declare function installConnectorLauncherService(input: {
+  platform: SupportedServicePlatform;
+  context: ConnectorProfileContext;
+  runner?: CommandRunner;
+}): Promise<void>;
+declare function uninstallConnectorLauncherService(input: {
+  platform: SupportedServicePlatform;
+  context: ConnectorProfileContext;
+  runner?: CommandRunner;
+}): Promise<void>;
+declare function connectorLauncherServiceIsRunning(input: {
+  platform: SupportedServicePlatform;
+  context: ConnectorProfileContext;
+  probe?: (command: string, args: string[]) => Promise<number>;
+}): Promise<boolean>;
+//#endregion
+//#region src/connector-installer.d.ts
+interface BootstrapServiceCredentials {
+  receiptId: string;
+  machineId: string;
+  refreshToken: string;
+  accessToken: string;
+  accessTokenExpiresAt: string;
+}
+declare function installDeploymentConnector(input: {
+  deployment: DeploymentDiscovery;
+  release: VerifiedConnectorRelease;
+  credentials: BootstrapServiceCredentials;
+  connectorInstallId: string;
+  challenge: string;
+  allowInsecureTls?: boolean;
+  roots?: ConnectorRootOverrides;
+  platform?: NodeJS.Platform;
+  arch?: string;
+  nodeExtraCaCerts?: string;
+  acknowledge(receiptId: string): Promise<void>;
+  installService?: typeof installConnectorLauncherService;
+  reconciliationLockHeld?: boolean;
+}): Promise<{
+  context: ConnectorProfileContext;
+  runtimeRoot: string;
+}>;
+//#endregion
+//#region src/tls.d.ts
+interface TlsOptions {
+  allowInsecureTls?: boolean | undefined;
+}
+//#endregion
+//#region src/machine-client.d.ts
+interface ClaimedMachine {
+  machineId: string;
+  name: string;
+}
+interface BootstrapServiceGrant {
+  receiptId: string;
+  accessToken: string;
+  refreshToken: string;
+  accessTokenExpiresAt: string;
+}
+interface MachineRetirement {
+  revision: number;
+  token: string;
+  deploymentId: string;
+  connectorInstallId: string;
+  machineId: string;
+  acknowledged: boolean;
+}
+declare class MachineClient {
+  private readonly serverUrl;
+  private readonly tlsOptions;
+  constructor(serverUrl: string, tlsOptions?: TlsOptions);
+  claim(input: {
+    accessToken: string;
+    deploymentId: string;
+    serviceKey: string;
+    challenge: string;
+    connectorInstallId: string;
+    name?: string | undefined;
+    bootstrap?: {
+      policyDigest: string;
+      releaseTuple: SignedConnectorReleaseTuple;
+      receiptId?: string;
+    };
+  }): Promise<ClaimedMachine & {
+    bootstrap?: BootstrapServiceGrant;
+  }>;
+  acknowledgeBootstrap(input: {
+    accessToken: string;
+    receiptId: string;
+  }): Promise<void>;
+  readRetirement(accessToken: string): Promise<MachineRetirement | undefined>;
+  acknowledgeRetirement(input: {
+    accessToken: string;
+    retirement: Pick<MachineRetirement, "revision" | "token">;
+  }): Promise<void>;
+}
+//#endregion
+//#region src/desktop-bootstrap.d.ts
+interface DesktopConnectorSeed {
+  snapshot: SignedReleaseSnapshot;
+  tarball: Uint8Array;
+  verification?: {
+    trustAnchor: ConnectorTrustAnchor;
+    platforms: Record<string, ConnectorPlatform>;
+  };
+  development?: {
+    refreshInstalledRuntime: true;
+  };
+}
+interface DesktopBootstrapRequest {
+  request<T>(path: string, body: Record<string, unknown>): Promise<T>;
+}
+interface DesktopBootstrapResult {
+  serverUrl: string;
+  machineId: string;
+  machineName: string;
+  installedVersion?: string;
+  reused: boolean;
+}
+declare function bootstrapDesktopConnector(input: {
+  serverUrl: string;
+  seed: DesktopConnectorSeed;
+  transport: DesktopBootstrapRequest;
+  roots?: ConnectorRootOverrides;
+  platform?: NodeJS.Platform;
+  arch?: string;
+  discover?: typeof discoverDeployment;
+  resolveLive?: typeof resolveVerifiedConnectorRelease;
+  resolveSnapshot?: typeof resolveVerifiedConnectorSnapshot;
+  claim?: MachineClient["claim"];
+  install?: typeof installDeploymentConnector;
+  uninstall?: typeof uninstallConnectorLauncherService;
+  serviceRunning?: typeof connectorLauncherServiceIsRunning;
+}): Promise<DesktopBootstrapResult>;
+//#endregion
+//#region src/local-control.d.ts
+declare class LocalControlIncompatibleError extends Error {
+  readonly code = "local_control_incompatible";
+}
+declare class LocalControlClient {
+  private readonly options;
+  constructor(options: {
+    endpoint: string;
+    secret: string;
+    versions?: LocalControlVersionRange;
+    timeoutMs?: number;
+  });
+  command(command: "status" | "ensure-installed" | "start" | "restart"): Promise<LocalControlStatus>;
+  command(command: "retry" | "force", capability: LocalControlCapability): Promise<LocalControlStatus>;
+  private exchange;
+}
+declare function discoverLocalConnector(input: {
+  deploymentId: string;
+  serviceKey: string;
+  platform?: NodeJS.Platform;
+  roots?: ConnectorRootOverrides;
+  versions?: LocalControlVersionRange;
+}): Promise<LocalConnectorDiscovery>;
+declare function runLocalControlCommand(input: {
+  deploymentId: string;
+  serviceKey: string;
+  command: "status" | "ensure-installed" | "start" | "restart";
+  platform?: NodeJS.Platform;
+  roots?: ConnectorRootOverrides;
+}): Promise<LocalControlStatus>;
+//#endregion
+export { type DesktopBootstrapRequest, type DesktopBootstrapResult, type DesktopConnectorSeed, LocalControlClient, LocalControlIncompatibleError, bootstrapDesktopConnector, discoverLocalConnector, runLocalControlCommand };

package/dist/local-control.js

@@ -0,0 +1,2 @@
+import { a as bootstrapDesktopConnector, i as runLocalControlCommand, n as LocalControlIncompatibleError, r as discoverLocalConnector, t as LocalControlClient } from "./local-control-Dm6FcXAi.js";
+export { LocalControlClient, LocalControlIncompatibleError, bootstrapDesktopConnector, discoverLocalConnector, runLocalControlCommand };