@gajae-code/natives 0.9.6 → 0.10.0

package/native/index.d.ts

@@ -12,7 +12,6 @@ export declare class ComputerController {
   keypress(expectedEpoch: number | undefined | null, keys: Array<string>): void
   wait(expectedEpoch: number | undefined | null, ms: number): void
 }
-
 /**
  * Long-lived macOS appearance observer.
  *
@@ -173,19 +172,37 @@ export declare class NotificationServer {
    */
   resolveLocal(id: string, answerJson?: string | undefined | null): void
   /**
-   * Resolve an action answered by a remote client, after TS resolved the real
-   * gate. `answer_json` is an optional JSON `ReplyAnswer`.
+   * Resolve an unclaimed legacy action. Forward-mode replies are
+   * receipt-bound and must use `resolveClaim` instead.
    *
    * # Errors
-   * Fails if not started or `answer_json` is invalid.
+   * Fails if not started, `answer_json` is invalid, or the action is claimed.
    */
   resolveClient(id: string, answerJson?: string | undefined | null, idempotencyKey?: string | undefined | null): void
+  /** Resolve a reply claim after durable semantic settlement. */
+  resolveClaim(replyReceiptId: string, answerJson?: string | undefined | null, idempotencyKey?: string | undefined | null): void
+  /** Close an invalid claim terminally. Retrying must use a fresh action id. */
+  closeClaimInvalid(replyReceiptId: string, reason: string): void
+  /** Cancel a claim as part of abort or shutdown cleanup. */
+  cancelClaim(replyReceiptId: string, reason: string): void
+  /**
+   * Unicast an origin-bound live acknowledgement and resolve with its exact
+   * correlated terminal outcome (or native timeout evidence).
+   */
+  requestAskSelectedAck(replyReceiptId: string, requestJson: string): Promise<AskSelectedAckOutcomeEvent>
+  /**
+   * Select one current capable participant for a recovery acknowledgement and
+   * resolve with its exact terminal outcome.
+   */
+  requestRecoveredAskSelectedAck(requestJson: string): Promise<AskSelectedAckOutcomeEvent>
+  /** Correlate and terminalize an acknowledgement request. */
+  cancelAskSelectedAck(requestId: string, commitKey: string, reason: string): AskSelectedAckOutcomeEvent
   /**
-   * Reject a forwarded reply after TS failed to resolve its gate. `reason` is
-   * one of the protocol reject reasons (default `invalid_answer`).
+   * Reject an unclaimed legacy reply. Claimed forward-mode replies must use
+   * `closeClaimInvalid` with the exact receipt.
    *
    * # Errors
-   * Fails if not started.
+   * Fails if not started or the action is claimed.
    */
   reject(id: string, reason?: string | undefined | null): void
   /**
@@ -298,7 +315,7 @@ export declare class Shell {
  * `packages/natives/native/index.js` (which derives the name from
  * `package.json#version`).
  */
-export declare function __piNativesV0_9_6(): void
+export declare function __piNativesV0_10_0(): void
 
 /**
  * Apply conservative pre-execution rewrites to a bash command.
@@ -309,6 +326,13 @@ export declare function __piNativesV0_9_6(): void
  */
 export declare function applyBashFixups(command: string): BashFixupResult
 
+/** Typed terminal acknowledgement result returned by acknowledgement promises. */
+export interface AskSelectedAckOutcomeEvent {
+  status: string
+  messageId?: number
+  reason?: string
+}
+
 /**
  * Apply ast-grep rewrite rules to matching files; honors `dryRun` and returns
  * a promise.
@@ -1479,6 +1503,8 @@ export interface ReplyEvent {
   answerJson: string
   /** Optional idempotency key supplied by the client. */
   idempotencyKey?: string
+  /** One-shot receipt binding this callback to the atomically claimed reply. */
+  replyReceiptId: string
 }
 
 /**

package/native/index.js

@@ -27,7 +27,7 @@ export const PtySession = nativeBindings.PtySession;
 export const Shell = nativeBindings.Shell;
 
 // functions
-export const __piNativesV0_9_6 = nativeBindings.__piNativesV0_9_6;
+export const __piNativesV0_10_0 = nativeBindings.__piNativesV0_10_0;
 export const applyBashFixups = nativeBindings.applyBashFixups;
 export const astEdit = nativeBindings.astEdit;
 export const astGrep = nativeBindings.astGrep;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gajae-code/natives",
-	"version": "0.9.6",
+	"version": "0.10.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",
@@ -31,7 +31,7 @@
 	"scripts": {
 		"build": "bun scripts/build-native.ts",
 		"check": "biome check . && bun run check:types",
-		"check:types": "tsgo -p tsconfig.json --noEmit",
+		"check:types": "tsc -p tsconfig.json --noEmit",
 		"lint": "biome lint .",
 		"test": "bun test",
 		"fix": "biome check --write --unsafe .",
@@ -61,11 +61,11 @@
 		"README.md"
 	],
 	"optionalDependencies": {
-		"@gajae-code/natives-darwin-arm64": "0.9.6",
-		"@gajae-code/natives-darwin-x64": "0.9.6",
-		"@gajae-code/natives-linux-arm64": "0.9.6",
-		"@gajae-code/natives-linux-x64": "0.9.6",
-		"@gajae-code/natives-win32-x64": "0.9.6"
+		"@gajae-code/natives-darwin-arm64": "0.10.0",
+		"@gajae-code/natives-darwin-x64": "0.10.0",
+		"@gajae-code/natives-linux-arm64": "0.10.0",
+		"@gajae-code/natives-linux-x64": "0.10.0",
+		"@gajae-code/natives-win32-x64": "0.10.0"
 	},
 	"exports": {
 		".": {