@agentvault/grok-bridge 0.3.1 → 0.4.0

package/dist/bridge.d.ts

@@ -136,6 +136,15 @@ export declare function attachLifecycle(channel: LifecycleChannel, opts?: {
     onTerminal?: (reason: string, o: {
         restart: boolean;
     }) => void;
+    /** #913 item 2 — remove this agent's supervised service when its device is
+     *  gone for good. Injected for tests; defaults to the real remover, because
+     *  an opt-in default is a feature nobody gets.
+     *
+     *  Every terminal reason is offered to it and IT decides. Filtering here as
+     *  well would put the same rule in two files, and the two would eventually
+     *  disagree — which is how `session_replaced` (device still alive) would end
+     *  up removing a healthy install. */
+    selfUninstall?: (reason: string, env: NodeJS.ProcessEnv) => boolean;
 }): void;
 /**
  * How a ROOM turn is announced to the model (#366 / #499 Facet A).

package/dist/config.d.ts

@@ -1,16 +1,3 @@
-/**
- * The one-paste install flag: enrol, install the supervised service, then EXIT so
- * the customer's terminal comes back.
- *
- * WIRE LITERAL. `packages/web/lib/framework-install.ts` emits this exact string in
- * the connect command. The two packages cannot import each other, so the only
- * tripwire is a test on each side that names the other — see config.test.ts
- * "freezes the wire literal".
- *
- * Deliberately "-" prefixed: loadConfig's token slot rejects "-" args, so adding a
- * flag can never be mistaken for an invite token.
- */
-export declare const INSTALL_FLAG = "--install";
 /** Informational flags. Handled BEFORE loadConfig in index.ts, because asking
  *  "what version is this?" must not require an invite token. Listed here too so
  *  the strict unknown-flag check does not reject them. */
@@ -35,12 +22,38 @@ export declare function parseInfoFlags(argv: string[]): {
 export declare function isEphemeralEntrypoint(entrypoint: string): boolean;
 /** Throw unless `entrypoint` is durable enough to bake into a supervised service. */
 export declare function assertInstallableEntrypoint(entrypoint: string): void;
+/**
+ * #913 item 3 — the device id inside this data dir's credentials, or null.
+ *
+ * Lives HERE, beside CRED_FILES and BACKUP_FILE, because this module already
+ * owns the knowledge of which files hold credentials. `doctor` reading those
+ * names itself would make a second copy of the list, and the copy that is not
+ * next to the constant is the one that goes stale.
+ *
+ * Checks the same files in the same order as hasPersistedCreds, INCLUDING the
+ * .bak: a device_revoked wipe deletes agentvault.json and leaves the backup, so
+ * the .bak is exactly where the id lives for the machine most likely to be
+ * running doctor.
+ *
+ * Returns null rather than throwing on missing/unreadable/malformed input — a
+ * doctor that dies on one bad file reports nothing about the others.
+ */
+export declare function readPersistedDeviceId(dataDir: string): string | null;
 export declare function hasPersistedCreds(dataDir: string): boolean;
 export declare function slugify(name: string): string;
 export type DataDirSource = "explicit" | "per-agent";
+/** Where the agent name came from.
+ *
+ *  #927's test for a safe default is: can a reader of the output tell the input
+ *  was MISSING? A bare `agentName` cannot answer that — "Grok" reads the same
+ *  whether the customer typed it or the bridge chose it. This field is what
+ *  makes the two distinguishable, so callers can SAY which one happened. */
+export type AgentNameSource = "supplied" | "defaulted";
 export declare function resolveDataDir(env: NodeJS.ProcessEnv): {
     dataDir: string;
     source: DataDirSource;
+    agentName: string;
+    agentNameSource: AgentNameSource;
 };
 export interface BridgeConfig {
     inviteToken: string;
@@ -48,6 +61,8 @@ export interface BridgeConfig {
     dataDirSource: DataDirSource;
     apiUrl: string;
     agentName: string;
+    /** Whether AV_AGENT_NAME was given, or the package default was used (#927). */
+    agentNameSource: AgentNameSource;
     roomFilter?: string;
     /** Per-agent filesystem sandbox. Always set: auto-defaults to a sibling of
      *  the key/data dir unless AV_WORKSPACE_DIR overrides it. */
@@ -78,7 +93,6 @@ export interface BridgeConfig {
     /** Set by --install: enrol in the foreground, install the supervised service,
      *  then EXIT so the customer's terminal returns. False leaves a bare run
      *  byte-for-byte as it behaves today. */
-    installAfterEnroll: boolean;
     /** --version / -v. index.ts answers these before loadConfig runs. */
     showVersion: boolean;
     /** --help / -h. Same. */