@gajae-code/natives 0.13.2 → 0.14.0

package/native/index.d.ts

@@ -103,56 +103,6 @@ export declare class NativeRetainedBrokerPublication {
   close(): NativeBrokerPublicationOperation
 }
 
-/**
- * In-process, session-independent lifecycle **control** server exposed to TS.
- *
- * Transport-only: it authenticates (handshake + per-frame), forwards valid
- * lifecycle requests to the TS daemon, and routes TS-produced responses back
- * by request id. All policy/spawn/idempotency/rate-limit/audit lives in TS.
- *
- * Call order: construct, [`Self::on_lifecycle_request`] (before start), then
- * [`Self::start`].
- */
-export declare class NotificationControlServer {
-  /**
-   * Create a control server authenticated by `token` and owned by `owner_id`.
-   *
-   * `agent_dir` (when given) is where the control discovery file is written
-   * (e.g. the daemon agent dir).
-   */
-  constructor(token: string, ownerId: string, agentDir?: string | undefined | null)
-  /**
-   * Register the lifecycle-request callback. Must be called before
-   * [`Self::start`].
-   */
-  onLifecycleRequest(callback: (err: null | Error, req: LifecycleRequestEvent) => void): void
-  /**
-   * Bind the loopback control endpoint and start serving. Resolves with the
-   * bound endpoint info once the socket is bound.
-   *
-   * # Errors
-   * Fails if already started, a non-loopback bind is requested, or the socket
-   * cannot be bound.
-   */
-  start(): Promise<ControlEndpoint>
-  /**
-   * Send a host-produced lifecycle response, routed back to the originating
-   * client by request id. `response_json` is a JSON `LifecycleServerMessage`.
-   *
-   * # Errors
-   * Fails if not started or `response_json` is not a valid
-   * `LifecycleServerMessage`.
-   */
-  respond(responseJson: string): void
-  /** Number of currently connected control clients. */
-  clientCount(): number
-  /**
-   * Stop the control server (idempotent) and remove the control discovery
-   * file.
-   */
-  stop(): void
-}
-
 /** In-process notification server handle exposed to TypeScript. */
 export declare class NotificationServer {
   /**
@@ -266,7 +216,7 @@ export declare class NotificationServer {
   /**
    * Publish a replayable `session_ready` readiness signal. `ready_json` is a
    * JSON `SessionReady`. Unlike [`Self::push_frame`], this frame is buffered
-   * and replayed to late-connecting clients, so a lifecycle control client
+   * and replayed to late-connecting clients, so an SDK client
    * can wait for readiness deterministically instead of treating WS-open as
    * readiness.
    *
@@ -396,6 +346,16 @@ export declare class PtySession {
   kill(): void
 }
 
+/** Retained descriptor-relative regular-file authority for streamed imports. */
+export declare class RecoveryFsFile {
+  /** Return the current identity of the retained regular file. */
+  identity(): RecoveryFsResult
+  /** Read one bounded chunk from the retained file descriptor. */
+  readChunk(offset: number, maxBytes: number): RecoveryFsResult
+  /** Close the retained regular-file descriptor. */
+  close(): RecoveryFsResult
+}
+
 /** Retained trusted-root authority for Linux recovery artifacts. */
 export declare class RecoveryFsRoot {
   /** Return the stable identity of the retained root descriptor. */
@@ -405,6 +365,16 @@ export declare class RecoveryFsRoot {
    * identity evidence.
    */
   retainManagedDirectory(relativePath: string, expectedDev: string, expectedIno: string): RecoveryFsRoot
+  /**
+   * Open one regular, single-linked descendant through retained no-follow
+   * traversal.
+   */
+  openFile(relativePath: string): RecoveryFsFile
+  /**
+   * Enumerate regular, single-linked descendants through retained directory
+   * descriptors. The returned data is a JSON array of relative paths.
+   */
+  listFiles(maxEntries: number): RecoveryFsResult
   /** Stat one existing regular, single-linked file without following links. */
   stat(relativePath: string): RecoveryFsResult
   /** Read one existing regular, single-linked file without following links. */
@@ -494,6 +464,14 @@ export declare class Shell {
    * Returns `Ok(())` even when no commands are running.
    */
   abort(): Promise<void>
+  /**
+   * Abort in-flight commands and release the retained shell session.
+   *
+   * `abort` leaves a completed session alive for reuse, so a caller that is
+   * finished with a shell must call this to release the native process and
+   * let the host exit. Returns `Ok(())` even when nothing is retained.
+   */
+  close(): Promise<void>
 }
 
 /**
@@ -523,7 +501,7 @@ export declare function __piNativesPublishOutcomeV1(): void
  * `packages/natives/native/index.js` (which derives the name from
  * `package.json#version`).
  */
-export declare function __piNativesV0_13_2(): void
+export declare function __piNativesV0_14_0(): void
 
 /**
  * Apply conservative pre-execution rewrites to a bash command.
@@ -765,9 +743,10 @@ export interface ClipboardImage {
 /**
  * Capture the primary display for JS callers (macOS).
  *
- * Requires the Screen Recording permission. This is the read-only `screenshot`
- * primitive of the computer-use tool; input primitives land behind the same
- * surface once the Accessibility gate is satisfied in a granted `gjc` process.
+ * Requires the Screen & System Audio Recording permission. This is the
+ * read-only `screenshot` primitive of the computer-use tool; input primitives
+ * land behind the same surface once the Accessibility gate is satisfied in a
+ * granted `gjc` process.
  *
  * # Errors
  * Returns an error when capture fails (e.g. Screen Recording not granted).
@@ -810,18 +789,6 @@ export interface ContextLine {
   line: string
 }
 
-/** Bound endpoint info returned from [`NotificationControlServer::start`]. */
-export interface ControlEndpoint {
-  /** Bind host (loopback). */
-  host: string
-  /** Bound port. */
-  port: number
-  /** `ws://host:port` URL. */
-  url: string
-  /** The daemon owner id this control endpoint serves. */
-  ownerId: string
-}
-
 /**
  * Copy plain text to the system clipboard.
  *
@@ -1471,20 +1438,6 @@ export interface KnownGoodFrameStats {
   fileAttachmentRustBase64Chars: number
 }
 
-/** A lifecycle request forwarded to the TypeScript daemon for orchestration. */
-export interface LifecycleRequestEvent {
-  /** One of `"session_create"`, `"session_close"`, `"session_resume"`. */
-  kind: string
-  /** The request correlation id to echo in the response. */
-  requestId: string
-  /**
-   * JSON-encoded `LifecycleClientMessage` with the control `token` stripped.
-   * The ingress already authenticated the frame, so the secret is never
-   * forwarded into JS; all other (non-token) fields are preserved.
-   */
-  payloadJson: string
-}
-
 /**
  * One diff component, mirroring jsdiff's change object (sans `count`, which
  * the TS `generateDiffString` formatter does not consume).
@@ -1825,6 +1778,13 @@ export interface NativeExactUnlinkResult {
    * neither a stale detached object nor a publisher successor.
    */
   retainedUnknownPath?: string
+  /**
+   * Hex-formatted Windows NTSTATUS of the underlying pre-mutation failure
+   * (e.g. `0xC0000043` for `STATUS_SHARING_VIOLATION`). Path-free by design;
+   * always absent on success, on non-Windows platforms, and after any
+   * namespace mutation.
+   */
+  windowsErrorCode?: string
 }
 
 /** Dedicated result for an atomic no-replace namespace publication. */

package/native/index.js

@@ -21,16 +21,16 @@ export const ComputerController = nativeBindings.ComputerController;
 export const MacAppearanceObserver = nativeBindings.MacAppearanceObserver;
 export const MacOSPowerAssertion = nativeBindings.MacOSPowerAssertion;
 export const NativeRetainedBrokerPublication = nativeBindings.NativeRetainedBrokerPublication;
-export const NotificationControlServer = nativeBindings.NotificationControlServer;
 export const NotificationServer = nativeBindings.NotificationServer;
 export const Process = nativeBindings.Process;
 export const PtySession = nativeBindings.PtySession;
+export const RecoveryFsFile = nativeBindings.RecoveryFsFile;
 export const RecoveryFsRoot = nativeBindings.RecoveryFsRoot;
 export const Shell = nativeBindings.Shell;
 
 // functions
 export const __piNativesPublishOutcomeV1 = nativeBindings.__piNativesPublishOutcomeV1;
-export const __piNativesV0_13_2 = nativeBindings.__piNativesV0_13_2;
+export const __piNativesV0_14_0 = nativeBindings.__piNativesV0_14_0;
 export const applyBashFixups = nativeBindings.applyBashFixups;
 export const applyOwnerOnlyFdSecurity = nativeBindings.applyOwnerOnlyFdSecurity;
 export const applyOwnerOnlyPathSecurity = nativeBindings.applyOwnerOnlyPathSecurity;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gajae-code/natives",
-	"version": "0.13.2",
+	"version": "0.14.0",
 	"description": "Native Rust bindings for grep, clipboard, image processing, syntax highlighting, PTY, and shell operations via N-API",
 	"type": "module",
 	"homepage": "https://gajae-code.com",
@@ -61,11 +61,11 @@
 		"README.md"
 	],
 	"optionalDependencies": {
-		"@gajae-code/natives-darwin-arm64": "0.13.2",
-		"@gajae-code/natives-darwin-x64": "0.13.2",
-		"@gajae-code/natives-linux-arm64": "0.13.2",
-		"@gajae-code/natives-linux-x64": "0.13.2",
-		"@gajae-code/natives-win32-x64": "0.13.2"
+		"@gajae-code/natives-darwin-arm64": "0.14.0",
+		"@gajae-code/natives-darwin-x64": "0.14.0",
+		"@gajae-code/natives-linux-arm64": "0.14.0",
+		"@gajae-code/natives-linux-x64": "0.14.0",
+		"@gajae-code/natives-win32-x64": "0.14.0"
 	},
 	"exports": {
 		".": {