@vostride/agent-qa-knowledge-local 0.0.0-stage → 0.2.1

package/dist/worker-registration-C-9spEsf.d.cts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+
+declare const EMBEDDER_WORKER_REGISTRATION_FILE = "embedder-worker.json";
+declare const EMBEDDER_WORKER_REGISTRATION_SCHEMA_VERSION = 2;
+/**
+ * What a worker records when it cannot attribute its own process.
+ *
+ * The field is required rather than optional on purpose: an absent incarnation would let a forged
+ * registration opt out of the check entirely. A worker that genuinely cannot resolve its own start
+ * time says so explicitly, and the host reads that as `unverifiable` — which withholds every
+ * signal, exactly as an unresolvable pid does.
+ */
+declare const EMBEDDER_WORKER_UNVERIFIABLE_INCARNATION = "unresolved";
+/** D-15 provisional request deadline; retune from daemon telemetry without adding config. */
+declare const EMBEDDER_WORKER_REQUEST_TIMEOUT_MS = 30000;
+/** D-15 provisional child-readiness deadline; retune from daemon telemetry without adding config. */
+declare const EMBEDDER_WORKER_START_TIMEOUT_MS = 15000;
+/** D-15 provisional TERM grace; retune from daemon telemetry without adding config. */
+declare const EMBEDDER_WORKER_TERM_GRACE_MS = 5000;
+type EmbedderWorkerTimeoutPhase = 'request' | 'start' | 'terminate';
+/** A bounded worker wait expired; callers can defer by phase without parsing error text. */
+declare class EmbedderWorkerTimeoutError extends Error {
+    readonly phase: EmbedderWorkerTimeoutPhase;
+    readonly timeoutMs: number;
+    constructor(phase: EmbedderWorkerTimeoutPhase, timeoutMs: number);
+}
+declare const embedderWorkerRegistrationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    instanceId: z.ZodString;
+    pid: z.ZodNumber;
+    socketPath: z.ZodString;
+    profile: z.ZodObject<{
+        model_id: z.ZodString;
+        revision: z.ZodString;
+        dim: z.ZodNumber;
+        dtype: z.ZodLiteral<"q8">;
+        pooling: z.ZodLiteral<"mean">;
+        normalize: z.ZodLiteral<true>;
+        query_prefix: z.ZodString;
+        doc_prefix: z.ZodString;
+        backend: z.ZodEnum<{
+            node: "node";
+            static: "static";
+        }>;
+        session_options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        tau_dense: z.ZodNumber;
+    }, z.core.$strict>;
+    startedAtMs: z.ZodNumber;
+    incarnation: z.ZodString;
+}, z.core.$strict>;
+type EmbedderWorkerRegistration = z.infer<typeof embedderWorkerRegistrationSchema>;
+type ReadEmbedderWorkerRegistrationOutcome = {
+    kind: 'absent';
+} | {
+    kind: 'malformed';
+} | {
+    kind: 'parsed';
+    registration: EmbedderWorkerRegistration;
+};
+/** Three-valued because the third value is a refusal, never a permissive default. */
+type EmbedderWorkerIncarnationVerdict = 'match' | 'mismatch' | 'unverifiable';
+/** Resolve an instance-scoped UDS path without crossing conservative POSIX sun_path limits. */
+declare function embedderWorkerSocketPath(agentQaRoot: string, projectRoot: string, instanceId: string): string;
+declare function writeEmbedderWorkerRegistration(agentQaRoot: string, registration: EmbedderWorkerRegistration): void;
+declare function readEmbedderWorkerRegistration(agentQaRoot: string): ReadEmbedderWorkerRegistrationOutcome;
+/** Signal-zero liveness probe: EPERM proves existence; only ESRCH proves a stale pid. */
+declare function embedderWorkerProcessIsAlive(pid: number): boolean;
+interface RemoveEmbedderWorkerRegistrationOptions {
+    /** Test-only barrier after quarantine publication and before ownership verification. */
+    readonly afterQuarantine?: (quarantinePath: string) => void;
+    /** Focused durability seam; production uses the best-effort platform fsync helper. */
+    readonly fsyncDirectory?: (directory: string) => void;
+}
+/** Atomically quarantine and remove only the exact registration owned by the caller. */
+declare function removeEmbedderWorkerRegistration(agentQaRoot: string, expected: EmbedderWorkerRegistration, options?: RemoveEmbedderWorkerRegistrationOptions): boolean;
+declare function probeEmbedderWorkerSocket(socketPath: string): Promise<boolean>;
+
+export { type EmbedderWorkerRegistration as E, type ReadEmbedderWorkerRegistrationOutcome as R, type EmbedderWorkerIncarnationVerdict as a, EMBEDDER_WORKER_REGISTRATION_FILE as b, EMBEDDER_WORKER_REGISTRATION_SCHEMA_VERSION as c, EMBEDDER_WORKER_REQUEST_TIMEOUT_MS as d, EMBEDDER_WORKER_START_TIMEOUT_MS as e, EMBEDDER_WORKER_TERM_GRACE_MS as f, EMBEDDER_WORKER_UNVERIFIABLE_INCARNATION as g, EmbedderWorkerTimeoutError as h, type EmbedderWorkerTimeoutPhase as i, embedderWorkerProcessIsAlive as j, embedderWorkerSocketPath as k, removeEmbedderWorkerRegistration as l, probeEmbedderWorkerSocket as p, readEmbedderWorkerRegistration as r, writeEmbedderWorkerRegistration as w };

package/dist/worker-registration-C-9spEsf.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+
+declare const EMBEDDER_WORKER_REGISTRATION_FILE = "embedder-worker.json";
+declare const EMBEDDER_WORKER_REGISTRATION_SCHEMA_VERSION = 2;
+/**
+ * What a worker records when it cannot attribute its own process.
+ *
+ * The field is required rather than optional on purpose: an absent incarnation would let a forged
+ * registration opt out of the check entirely. A worker that genuinely cannot resolve its own start
+ * time says so explicitly, and the host reads that as `unverifiable` — which withholds every
+ * signal, exactly as an unresolvable pid does.
+ */
+declare const EMBEDDER_WORKER_UNVERIFIABLE_INCARNATION = "unresolved";
+/** D-15 provisional request deadline; retune from daemon telemetry without adding config. */
+declare const EMBEDDER_WORKER_REQUEST_TIMEOUT_MS = 30000;
+/** D-15 provisional child-readiness deadline; retune from daemon telemetry without adding config. */
+declare const EMBEDDER_WORKER_START_TIMEOUT_MS = 15000;
+/** D-15 provisional TERM grace; retune from daemon telemetry without adding config. */
+declare const EMBEDDER_WORKER_TERM_GRACE_MS = 5000;
+type EmbedderWorkerTimeoutPhase = 'request' | 'start' | 'terminate';
+/** A bounded worker wait expired; callers can defer by phase without parsing error text. */
+declare class EmbedderWorkerTimeoutError extends Error {
+    readonly phase: EmbedderWorkerTimeoutPhase;
+    readonly timeoutMs: number;
+    constructor(phase: EmbedderWorkerTimeoutPhase, timeoutMs: number);
+}
+declare const embedderWorkerRegistrationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    instanceId: z.ZodString;
+    pid: z.ZodNumber;
+    socketPath: z.ZodString;
+    profile: z.ZodObject<{
+        model_id: z.ZodString;
+        revision: z.ZodString;
+        dim: z.ZodNumber;
+        dtype: z.ZodLiteral<"q8">;
+        pooling: z.ZodLiteral<"mean">;
+        normalize: z.ZodLiteral<true>;
+        query_prefix: z.ZodString;
+        doc_prefix: z.ZodString;
+        backend: z.ZodEnum<{
+            node: "node";
+            static: "static";
+        }>;
+        session_options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        tau_dense: z.ZodNumber;
+    }, z.core.$strict>;
+    startedAtMs: z.ZodNumber;
+    incarnation: z.ZodString;
+}, z.core.$strict>;
+type EmbedderWorkerRegistration = z.infer<typeof embedderWorkerRegistrationSchema>;
+type ReadEmbedderWorkerRegistrationOutcome = {
+    kind: 'absent';
+} | {
+    kind: 'malformed';
+} | {
+    kind: 'parsed';
+    registration: EmbedderWorkerRegistration;
+};
+/** Three-valued because the third value is a refusal, never a permissive default. */
+type EmbedderWorkerIncarnationVerdict = 'match' | 'mismatch' | 'unverifiable';
+/** Resolve an instance-scoped UDS path without crossing conservative POSIX sun_path limits. */
+declare function embedderWorkerSocketPath(agentQaRoot: string, projectRoot: string, instanceId: string): string;
+declare function writeEmbedderWorkerRegistration(agentQaRoot: string, registration: EmbedderWorkerRegistration): void;
+declare function readEmbedderWorkerRegistration(agentQaRoot: string): ReadEmbedderWorkerRegistrationOutcome;
+/** Signal-zero liveness probe: EPERM proves existence; only ESRCH proves a stale pid. */
+declare function embedderWorkerProcessIsAlive(pid: number): boolean;
+interface RemoveEmbedderWorkerRegistrationOptions {
+    /** Test-only barrier after quarantine publication and before ownership verification. */
+    readonly afterQuarantine?: (quarantinePath: string) => void;
+    /** Focused durability seam; production uses the best-effort platform fsync helper. */
+    readonly fsyncDirectory?: (directory: string) => void;
+}
+/** Atomically quarantine and remove only the exact registration owned by the caller. */
+declare function removeEmbedderWorkerRegistration(agentQaRoot: string, expected: EmbedderWorkerRegistration, options?: RemoveEmbedderWorkerRegistrationOptions): boolean;
+declare function probeEmbedderWorkerSocket(socketPath: string): Promise<boolean>;
+
+export { type EmbedderWorkerRegistration as E, type ReadEmbedderWorkerRegistrationOutcome as R, type EmbedderWorkerIncarnationVerdict as a, EMBEDDER_WORKER_REGISTRATION_FILE as b, EMBEDDER_WORKER_REGISTRATION_SCHEMA_VERSION as c, EMBEDDER_WORKER_REQUEST_TIMEOUT_MS as d, EMBEDDER_WORKER_START_TIMEOUT_MS as e, EMBEDDER_WORKER_TERM_GRACE_MS as f, EMBEDDER_WORKER_UNVERIFIABLE_INCARNATION as g, EmbedderWorkerTimeoutError as h, type EmbedderWorkerTimeoutPhase as i, embedderWorkerProcessIsAlive as j, embedderWorkerSocketPath as k, removeEmbedderWorkerRegistration as l, probeEmbedderWorkerSocket as p, readEmbedderWorkerRegistration as r, writeEmbedderWorkerRegistration as w };

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@vostride/agent-qa-knowledge-local",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "private": false,
+  "description": "StorageImplementation shell for the future local memidex knowledge store in agent-qa.",
+  "keywords": [
+    "agent-qa",
+    "testing",
+    "agent",
+    "ports"
+  ],
+  "license": "SEE LICENSE IN LICENSE.md",
+  "homepage": "https://github.com/vostride/agent-qa#readme",
+  "bugs": {
+    "url": "https://github.com/vostride/agent-qa/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vostride/agent-qa.git",
+    "directory": "packages/knowledge-local"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./reader": {
+      "types": "./dist/reader.d.ts",
+      "import": "./dist/reader.js",
+      "require": "./dist/reader.cjs"
+    }
+  },
+  "files": [
+    "assets",
+    "dist",
+    "LICENSE.md",
+    "NOTICE.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  },
+  "dependencies": {
+    "@huggingface/tokenizers": "0.1.3",
+    "@huggingface/transformers": "4.2.0",
+    "@vostride/agent-qa-agent": "0.2.1",
+    "@vostride/agent-qa-runner": "0.2.1",
+    "@vostride/agent-qa-safety": "0.2.1",
+    "@vostride/agent-qa-schema": "0.2.1",
+    "sqlite-vec": "0.1.9",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "~24.12.2",
+    "@vostride/agent-qa-arch": "0.2.1",
+    "tsup": "~8.5.1",
+    "typescript": "~6.0.3",
+    "vitest": "~4.1.5"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.