@forg3t/sdk 0.1.5 → 0.1.6

package/README.md

@@ -35,6 +35,25 @@ There is now also a live bearer-token bootstrap path for first-time tenant creat
 
 This closes the biggest admin-led onboarding gap. The published npm package now includes the bootstrap flow and request-creation surface, but the overall product is still not fully self-serve enterprise onboarding because tenant lifecycle cleanup, whitebox activation, and some runtime specialization paths remain operator-led.
 
+## Execution Modes
+
+Forg3t now has three materially different execution lanes. Keeping them separate is important:
+
+1. **Managed black-box lane**
+   - default baseline path for API-only and retrieval-style first runs
+   - request enters via `https://api.forg3t.io`
+   - control-plane managed worker claims the job
+   - a private executor service runs the black-box workload
+   - this is the path verified by the published SDK cleanroom smoke
+
+2. **Customer-scoped generic worker**
+   - used when a customer wants execution tied to their own project-scoped worker runtime
+   - not the same thing as the default managed black-box lane
+
+3. **Customer-side whitebox worker**
+   - required when the customer wants staged model-weight intervention
+   - this remains a separate install and acceptance path
+
 ## Local Development
 1. **Build**: `npm run build`
 2. **Typecheck**: `node ../../node_modules/typescript/bin/tsc -p tsconfig.json --noEmit`
@@ -63,6 +82,9 @@ This validates:
 - API key creation
 - unlearning request creation
 - request detail fetch
+- terminal job success
+- evidence readiness
+- artifact download readiness
 - API key revoke
 - job contract correctness
 - first-customer path through the public API hostname
@@ -78,7 +100,7 @@ export SUPABASE_ANON_KEY=...
 npm run smoke:cleanroom
 ```
 
-This installs the package into a fresh temporary directory, runs bootstrap, creates a first request, fetches request detail, and revokes the temporary API key. It is the release-candidate gate we use before claiming the SDK package is ready to publish.
+This installs the package into a fresh temporary directory, runs bootstrap, creates a first request, verifies terminal job success plus evidence/artifact readiness, and revokes the temporary API key. It is the release-candidate gate we use before claiming the SDK package is ready to publish.
 
 ### First-Time Tenant Bootstrap
 

package/dist/index.d.mts

@@ -269,6 +269,8 @@ declare enum IntegrationType {
     LANGCHAIN = "langchain",
     OPENROUTER = "openrouter",
     OPENAI = "openai",
+    PGVECTOR = "pgvector",
+    ADAPTER = "adapter",
     CUSTOM = "custom"
 }
 declare enum IntegrationMode {
@@ -290,6 +292,29 @@ interface OpenRouterAdapterConfig extends BaseAdapterConfig {
     routingStrategy: 'cost' | 'latency' | 'quality';
     fallbackModels?: string[];
 }
+interface PgVectorIntegrationConfig extends BaseAdapterConfig {
+    backend: 'pgvector_postgres';
+    schema?: string;
+    table: string;
+    document_id_column?: string;
+    metadata_column?: string;
+    metadata_document_id_key?: string;
+    content_column?: string;
+    embedding_column?: string;
+    database_url_env_var?: string;
+    healthcheck_url?: string;
+    healthcheck_method?: 'GET' | 'POST';
+    worker_mode?: 'rag';
+}
+interface AdapterIntegrationConfig extends BaseAdapterConfig {
+    backend: 'peft_lora_safetensors';
+    format?: 'safetensors';
+    adapter_uri?: string;
+    adapter_uri_env_var?: string;
+    healthcheck_url?: string;
+    healthcheck_method?: 'GET' | 'POST';
+    worker_mode?: 'adapter';
+}
 interface Integration {
     id: string;
     projectId: string;
@@ -297,7 +322,7 @@ interface Integration {
     name: string;
     description?: string;
     status: 'active' | 'disconnected' | 'error' | 'pending';
-    config: BaseAdapterConfig | LangChainAdapterConfig | OpenRouterAdapterConfig | Record<string, unknown>;
+    config: BaseAdapterConfig | LangChainAdapterConfig | OpenRouterAdapterConfig | PgVectorIntegrationConfig | AdapterIntegrationConfig | Record<string, unknown>;
     capabilities: string[];
     createdAt: string;
     updatedAt: string;
@@ -353,9 +378,29 @@ interface UnlearningExecutionTargetSpec {
     responsePath?: string;
     apiKey?: string;
 }
+interface UnlearningExecutionRagSpec {
+    backend: 'pgvector_postgres';
+    mode?: 'delete_documents';
+    integrationId?: string;
+    dryRun?: boolean;
+}
+interface UnlearningExecutionAdapterSpec {
+    backend: 'peft_lora_safetensors';
+    integrationId?: string;
+    method?: 'disable_adapter' | 'attenuate_adapter';
+    scaleFactor?: number;
+    dryRun?: boolean;
+    updatedAdapterUri?: string;
+}
+interface UnlearningExecutionRoutingSpec {
+    lane?: 'managed' | 'project_scoped';
+}
 interface UnlearningExecutionSpec {
     target?: UnlearningExecutionTargetSpec;
+    rag?: UnlearningExecutionRagSpec;
+    adapter?: UnlearningExecutionAdapterSpec;
     model?: UnlearningExecutionModelRef;
+    routing?: UnlearningExecutionRoutingSpec;
     plan?: UnlearningExecutionPlanSpec;
 }
 interface UnlearningJobSummary {
@@ -480,6 +525,7 @@ declare class Forg3tClient {
     }, requestId?: string): Promise<void>;
     private assertCreateUnlearningRequest;
     private assertModelUnlearnPreflight;
+    private assertAdapterUnlearnPreflight;
 }
 
 declare class Forg3tError extends Error {
@@ -759,4 +805,4 @@ declare const ENTERPRISE_STRICT_QUALITY_GATE_POLICY: Required<WhiteboxQualityGat
 declare function assertDeploymentCompatibility(options: DeploymentCompatibilityOptions): void;
 declare function buildWhiteboxWorkerOptions(profile: Forg3tDeploymentProfile, baseOptions: WhiteboxWorkerBaseOptions): WhiteboxWorkerOptions;
 
-export { AccessLevel, type AdapterCommandSpec, type ApiKey, type AuditEvent, type AuditEventFilters, type AuditEventListResponse, type BaseAdapterConfig, type BootstrapTenantRequest, type BootstrapTenantResponse, type BuildModelUnlearningJobInput, type ClaimAssertion, type ClaimJobsRequest, type ClaimScope, type ClaimType, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateIntegrationRequest, type CreateUnlearningRequestParams, type CreateWebhookRequest, type CurrentUserResponse, DEFAULT_WHITEBOX_QUALITY_GATE_POLICY, type DeploymentCompatibilityOptions, ENTERPRISE_STRICT_QUALITY_GATE_POLICY, type EvidenceArtifact, type EvidencePdfResponse, type EvidenceStatusResponse, type ExecutionPlan, type ExecutionStep, type Forg3tAdapterMode, Forg3tApiConnectionError, Forg3tAuthenticationError, Forg3tClient, type Forg3tClientOptions, type Forg3tDeploymentProfile, Forg3tError, Forg3tNotFoundError, Forg3tNotImplementedError, Forg3tRateLimitError, HttpTrainingAdapter, type HttpTrainingAdapterOptions, type Integration, IntegrationMode, IntegrationType, type Job, type JobConfig, type JobError, type JobMutationOptions, type JobResult, type JobStatus, type JobType, type LangChainAdapterConfig, type LocalCommandAdapterOptions, LocalCommandTrainingAdapter, type ModelArtifactReference, type NativeAdapterConfig, type OpenRouterAdapterConfig, type PaginationParams, type Project, type RevokeApiKeyResponse, type SubmitJobRequest, type TrainingBackendAdapter, type UnlearningClaim, type UnlearningExecutionModelRef, type UnlearningExecutionPlanSpec, type UnlearningExecutionSpec, type UnlearningExecutionTargetSpec, type UnlearningJobSummary, type UnlearningRequest, type UnlearningScope, type UnlearningTarget, type UpdateWebhookRequest, WHITEBOX_QUALITY_GATE_PRESETS, WHITEBOX_QUALITY_GATE_PRESET_EXPLANATIONS, type Webhook, type WebhookDelivery, type WebhookDeliveryFilters, type WhiteboxEvaluationInput, type WhiteboxEvaluationOutput, type WhiteboxJobContext, type WhiteboxQualityGateDecision, type WhiteboxQualityGatePolicy, type WhiteboxQualityGatePreset, type WhiteboxTargetSpec, type WhiteboxUnlearningInput, type WhiteboxUnlearningOutput, type WhiteboxUnlearningPlan, WhiteboxWorker, type WhiteboxWorkerBaseOptions, type WhiteboxWorkerLogger, type WhiteboxWorkerOptions, assertDeploymentCompatibility, buildModelUnlearningPayload, buildWhiteboxWorkerOptions, createNativeTrainingAdapter, evaluateWhiteboxQualityGate, resolveWhiteboxQualityGatePolicy };
+export { AccessLevel, type AdapterCommandSpec, type AdapterIntegrationConfig, type ApiKey, type AuditEvent, type AuditEventFilters, type AuditEventListResponse, type BaseAdapterConfig, type BootstrapTenantRequest, type BootstrapTenantResponse, type BuildModelUnlearningJobInput, type ClaimAssertion, type ClaimJobsRequest, type ClaimScope, type ClaimType, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateIntegrationRequest, type CreateUnlearningRequestParams, type CreateWebhookRequest, type CurrentUserResponse, DEFAULT_WHITEBOX_QUALITY_GATE_POLICY, type DeploymentCompatibilityOptions, ENTERPRISE_STRICT_QUALITY_GATE_POLICY, type EvidenceArtifact, type EvidencePdfResponse, type EvidenceStatusResponse, type ExecutionPlan, type ExecutionStep, type Forg3tAdapterMode, Forg3tApiConnectionError, Forg3tAuthenticationError, Forg3tClient, type Forg3tClientOptions, type Forg3tDeploymentProfile, Forg3tError, Forg3tNotFoundError, Forg3tNotImplementedError, Forg3tRateLimitError, HttpTrainingAdapter, type HttpTrainingAdapterOptions, type Integration, IntegrationMode, IntegrationType, type Job, type JobConfig, type JobError, type JobMutationOptions, type JobResult, type JobStatus, type JobType, type LangChainAdapterConfig, type LocalCommandAdapterOptions, LocalCommandTrainingAdapter, type ModelArtifactReference, type NativeAdapterConfig, type OpenRouterAdapterConfig, type PaginationParams, type PgVectorIntegrationConfig, type Project, type RevokeApiKeyResponse, type SubmitJobRequest, type TrainingBackendAdapter, type UnlearningClaim, type UnlearningExecutionAdapterSpec, type UnlearningExecutionModelRef, type UnlearningExecutionPlanSpec, type UnlearningExecutionRagSpec, type UnlearningExecutionRoutingSpec, type UnlearningExecutionSpec, type UnlearningExecutionTargetSpec, type UnlearningJobSummary, type UnlearningRequest, type UnlearningScope, type UnlearningTarget, type UpdateWebhookRequest, WHITEBOX_QUALITY_GATE_PRESETS, WHITEBOX_QUALITY_GATE_PRESET_EXPLANATIONS, type Webhook, type WebhookDelivery, type WebhookDeliveryFilters, type WhiteboxEvaluationInput, type WhiteboxEvaluationOutput, type WhiteboxJobContext, type WhiteboxQualityGateDecision, type WhiteboxQualityGatePolicy, type WhiteboxQualityGatePreset, type WhiteboxTargetSpec, type WhiteboxUnlearningInput, type WhiteboxUnlearningOutput, type WhiteboxUnlearningPlan, WhiteboxWorker, type WhiteboxWorkerBaseOptions, type WhiteboxWorkerLogger, type WhiteboxWorkerOptions, assertDeploymentCompatibility, buildModelUnlearningPayload, buildWhiteboxWorkerOptions, createNativeTrainingAdapter, evaluateWhiteboxQualityGate, resolveWhiteboxQualityGatePolicy };

package/dist/index.d.ts

@@ -269,6 +269,8 @@ declare enum IntegrationType {
     LANGCHAIN = "langchain",
     OPENROUTER = "openrouter",
     OPENAI = "openai",
+    PGVECTOR = "pgvector",
+    ADAPTER = "adapter",
     CUSTOM = "custom"
 }
 declare enum IntegrationMode {
@@ -290,6 +292,29 @@ interface OpenRouterAdapterConfig extends BaseAdapterConfig {
     routingStrategy: 'cost' | 'latency' | 'quality';
     fallbackModels?: string[];
 }
+interface PgVectorIntegrationConfig extends BaseAdapterConfig {
+    backend: 'pgvector_postgres';
+    schema?: string;
+    table: string;
+    document_id_column?: string;
+    metadata_column?: string;
+    metadata_document_id_key?: string;
+    content_column?: string;
+    embedding_column?: string;
+    database_url_env_var?: string;
+    healthcheck_url?: string;
+    healthcheck_method?: 'GET' | 'POST';
+    worker_mode?: 'rag';
+}
+interface AdapterIntegrationConfig extends BaseAdapterConfig {
+    backend: 'peft_lora_safetensors';
+    format?: 'safetensors';
+    adapter_uri?: string;
+    adapter_uri_env_var?: string;
+    healthcheck_url?: string;
+    healthcheck_method?: 'GET' | 'POST';
+    worker_mode?: 'adapter';
+}
 interface Integration {
     id: string;
     projectId: string;
@@ -297,7 +322,7 @@ interface Integration {
     name: string;
     description?: string;
     status: 'active' | 'disconnected' | 'error' | 'pending';
-    config: BaseAdapterConfig | LangChainAdapterConfig | OpenRouterAdapterConfig | Record<string, unknown>;
+    config: BaseAdapterConfig | LangChainAdapterConfig | OpenRouterAdapterConfig | PgVectorIntegrationConfig | AdapterIntegrationConfig | Record<string, unknown>;
     capabilities: string[];
     createdAt: string;
     updatedAt: string;
@@ -353,9 +378,29 @@ interface UnlearningExecutionTargetSpec {
     responsePath?: string;
     apiKey?: string;
 }
+interface UnlearningExecutionRagSpec {
+    backend: 'pgvector_postgres';
+    mode?: 'delete_documents';
+    integrationId?: string;
+    dryRun?: boolean;
+}
+interface UnlearningExecutionAdapterSpec {
+    backend: 'peft_lora_safetensors';
+    integrationId?: string;
+    method?: 'disable_adapter' | 'attenuate_adapter';
+    scaleFactor?: number;
+    dryRun?: boolean;
+    updatedAdapterUri?: string;
+}
+interface UnlearningExecutionRoutingSpec {
+    lane?: 'managed' | 'project_scoped';
+}
 interface UnlearningExecutionSpec {
     target?: UnlearningExecutionTargetSpec;
+    rag?: UnlearningExecutionRagSpec;
+    adapter?: UnlearningExecutionAdapterSpec;
     model?: UnlearningExecutionModelRef;
+    routing?: UnlearningExecutionRoutingSpec;
     plan?: UnlearningExecutionPlanSpec;
 }
 interface UnlearningJobSummary {
@@ -480,6 +525,7 @@ declare class Forg3tClient {
     }, requestId?: string): Promise<void>;
     private assertCreateUnlearningRequest;
     private assertModelUnlearnPreflight;
+    private assertAdapterUnlearnPreflight;
 }
 
 declare class Forg3tError extends Error {
@@ -759,4 +805,4 @@ declare const ENTERPRISE_STRICT_QUALITY_GATE_POLICY: Required<WhiteboxQualityGat
 declare function assertDeploymentCompatibility(options: DeploymentCompatibilityOptions): void;
 declare function buildWhiteboxWorkerOptions(profile: Forg3tDeploymentProfile, baseOptions: WhiteboxWorkerBaseOptions): WhiteboxWorkerOptions;
 
-export { AccessLevel, type AdapterCommandSpec, type ApiKey, type AuditEvent, type AuditEventFilters, type AuditEventListResponse, type BaseAdapterConfig, type BootstrapTenantRequest, type BootstrapTenantResponse, type BuildModelUnlearningJobInput, type ClaimAssertion, type ClaimJobsRequest, type ClaimScope, type ClaimType, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateIntegrationRequest, type CreateUnlearningRequestParams, type CreateWebhookRequest, type CurrentUserResponse, DEFAULT_WHITEBOX_QUALITY_GATE_POLICY, type DeploymentCompatibilityOptions, ENTERPRISE_STRICT_QUALITY_GATE_POLICY, type EvidenceArtifact, type EvidencePdfResponse, type EvidenceStatusResponse, type ExecutionPlan, type ExecutionStep, type Forg3tAdapterMode, Forg3tApiConnectionError, Forg3tAuthenticationError, Forg3tClient, type Forg3tClientOptions, type Forg3tDeploymentProfile, Forg3tError, Forg3tNotFoundError, Forg3tNotImplementedError, Forg3tRateLimitError, HttpTrainingAdapter, type HttpTrainingAdapterOptions, type Integration, IntegrationMode, IntegrationType, type Job, type JobConfig, type JobError, type JobMutationOptions, type JobResult, type JobStatus, type JobType, type LangChainAdapterConfig, type LocalCommandAdapterOptions, LocalCommandTrainingAdapter, type ModelArtifactReference, type NativeAdapterConfig, type OpenRouterAdapterConfig, type PaginationParams, type Project, type RevokeApiKeyResponse, type SubmitJobRequest, type TrainingBackendAdapter, type UnlearningClaim, type UnlearningExecutionModelRef, type UnlearningExecutionPlanSpec, type UnlearningExecutionSpec, type UnlearningExecutionTargetSpec, type UnlearningJobSummary, type UnlearningRequest, type UnlearningScope, type UnlearningTarget, type UpdateWebhookRequest, WHITEBOX_QUALITY_GATE_PRESETS, WHITEBOX_QUALITY_GATE_PRESET_EXPLANATIONS, type Webhook, type WebhookDelivery, type WebhookDeliveryFilters, type WhiteboxEvaluationInput, type WhiteboxEvaluationOutput, type WhiteboxJobContext, type WhiteboxQualityGateDecision, type WhiteboxQualityGatePolicy, type WhiteboxQualityGatePreset, type WhiteboxTargetSpec, type WhiteboxUnlearningInput, type WhiteboxUnlearningOutput, type WhiteboxUnlearningPlan, WhiteboxWorker, type WhiteboxWorkerBaseOptions, type WhiteboxWorkerLogger, type WhiteboxWorkerOptions, assertDeploymentCompatibility, buildModelUnlearningPayload, buildWhiteboxWorkerOptions, createNativeTrainingAdapter, evaluateWhiteboxQualityGate, resolveWhiteboxQualityGatePolicy };
+export { AccessLevel, type AdapterCommandSpec, type AdapterIntegrationConfig, type ApiKey, type AuditEvent, type AuditEventFilters, type AuditEventListResponse, type BaseAdapterConfig, type BootstrapTenantRequest, type BootstrapTenantResponse, type BuildModelUnlearningJobInput, type ClaimAssertion, type ClaimJobsRequest, type ClaimScope, type ClaimType, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateIntegrationRequest, type CreateUnlearningRequestParams, type CreateWebhookRequest, type CurrentUserResponse, DEFAULT_WHITEBOX_QUALITY_GATE_POLICY, type DeploymentCompatibilityOptions, ENTERPRISE_STRICT_QUALITY_GATE_POLICY, type EvidenceArtifact, type EvidencePdfResponse, type EvidenceStatusResponse, type ExecutionPlan, type ExecutionStep, type Forg3tAdapterMode, Forg3tApiConnectionError, Forg3tAuthenticationError, Forg3tClient, type Forg3tClientOptions, type Forg3tDeploymentProfile, Forg3tError, Forg3tNotFoundError, Forg3tNotImplementedError, Forg3tRateLimitError, HttpTrainingAdapter, type HttpTrainingAdapterOptions, type Integration, IntegrationMode, IntegrationType, type Job, type JobConfig, type JobError, type JobMutationOptions, type JobResult, type JobStatus, type JobType, type LangChainAdapterConfig, type LocalCommandAdapterOptions, LocalCommandTrainingAdapter, type ModelArtifactReference, type NativeAdapterConfig, type OpenRouterAdapterConfig, type PaginationParams, type PgVectorIntegrationConfig, type Project, type RevokeApiKeyResponse, type SubmitJobRequest, type TrainingBackendAdapter, type UnlearningClaim, type UnlearningExecutionAdapterSpec, type UnlearningExecutionModelRef, type UnlearningExecutionPlanSpec, type UnlearningExecutionRagSpec, type UnlearningExecutionRoutingSpec, type UnlearningExecutionSpec, type UnlearningExecutionTargetSpec, type UnlearningJobSummary, type UnlearningRequest, type UnlearningScope, type UnlearningTarget, type UpdateWebhookRequest, WHITEBOX_QUALITY_GATE_PRESETS, WHITEBOX_QUALITY_GATE_PRESET_EXPLANATIONS, type Webhook, type WebhookDelivery, type WebhookDeliveryFilters, type WhiteboxEvaluationInput, type WhiteboxEvaluationOutput, type WhiteboxJobContext, type WhiteboxQualityGateDecision, type WhiteboxQualityGatePolicy, type WhiteboxQualityGatePreset, type WhiteboxTargetSpec, type WhiteboxUnlearningInput, type WhiteboxUnlearningOutput, type WhiteboxUnlearningPlan, WhiteboxWorker, type WhiteboxWorkerBaseOptions, type WhiteboxWorkerLogger, type WhiteboxWorkerOptions, assertDeploymentCompatibility, buildModelUnlearningPayload, buildWhiteboxWorkerOptions, createNativeTrainingAdapter, evaluateWhiteboxQualityGate, resolveWhiteboxQualityGatePolicy };

package/dist/index.js

@@ -431,6 +431,8 @@ var Forg3tClient = class {
     };
     if (data.type === "MODEL_UNLEARN") {
       this.assertModelUnlearnPreflight(normalizedPayload);
+    } else if (data.type === "ADAPTER_UNLEARN") {
+      this.assertAdapterUnlearnPreflight(normalizedPayload);
     }
     const res = await this.transport.request(`/v1/projects/${projectId}/jobs`, {
       method: "POST",
@@ -655,18 +657,67 @@ var Forg3tClient = class {
       }
     }
     if (data.accessLevel === "layer_a_only") {
+      const rag = data.execution?.rag;
       const target = data.execution?.target;
-      if (!target) {
-        throw new Error("createUnlearningRequest: execution.target is required for layer_a_only.");
+      const adapter = data.execution?.adapter;
+      if (adapter) {
+        throw new Error("createUnlearningRequest: execution.adapter is only valid for layer_a_and_b.");
       }
-      if ((target.provider === "openai" || target.provider === "groq") && !target.model?.trim()) {
-        throw new Error(`createUnlearningRequest: execution.target.model is required when provider=${target.provider}.`);
+      if (target && rag) {
+        throw new Error("createUnlearningRequest: execution.target and execution.rag are mutually exclusive for layer_a_only.");
       }
-      if ((target.provider === "http_generic" || target.provider === "custom") && !target.endpoint?.trim()) {
-        throw new Error(`createUnlearningRequest: execution.target.endpoint is required when provider=${target.provider}.`);
+      if (rag) {
+        if (rag.backend !== "pgvector_postgres") {
+          throw new Error("createUnlearningRequest: execution.rag.backend must be pgvector_postgres.");
+        }
+        if (data.target.type !== "document_id") {
+          throw new Error("createUnlearningRequest: the official RAG lane currently supports target.type=document_id only.");
+        }
+        if (!Array.isArray(data.scope?.integrationIds) || data.scope.integrationIds.length !== 1) {
+          throw new Error("createUnlearningRequest: the official RAG lane requires exactly one scope.integrationIds entry.");
+        }
+        if (data.execution?.routing?.lane && data.execution.routing.lane !== "project_scoped") {
+          throw new Error("createUnlearningRequest: execution.routing.lane must be project_scoped for the official RAG lane.");
+        }
+      } else {
+        if (!target) {
+          throw new Error("createUnlearningRequest: execution.target is required for layer_a_only unless execution.rag is provided.");
+        }
+        if ((target.provider === "openai" || target.provider === "groq") && !target.model?.trim()) {
+          throw new Error(`createUnlearningRequest: execution.target.model is required when provider=${target.provider}.`);
+        }
+        if ((target.provider === "http_generic" || target.provider === "custom") && !target.endpoint?.trim()) {
+          throw new Error(`createUnlearningRequest: execution.target.endpoint is required when provider=${target.provider}.`);
+        }
       }
     }
     if (data.accessLevel === "layer_a_and_b") {
+      const adapter = data.execution?.adapter;
+      if (adapter) {
+        if (adapter.backend !== "peft_lora_safetensors") {
+          throw new Error("createUnlearningRequest: execution.adapter.backend must be peft_lora_safetensors.");
+        }
+        if (data.execution?.model?.uri?.trim()) {
+          throw new Error("createUnlearningRequest: execution.adapter and execution.model are mutually exclusive for layer_a_and_b.");
+        }
+        if (!Array.isArray(data.scope?.integrationIds) || data.scope.integrationIds.length !== 1) {
+          throw new Error("createUnlearningRequest: the official adapter lane requires exactly one scope.integrationIds entry.");
+        }
+        if (data.execution?.routing?.lane && data.execution.routing.lane !== "project_scoped") {
+          throw new Error("createUnlearningRequest: execution.routing.lane must be project_scoped for the official adapter lane.");
+        }
+        const method = String(adapter.method || "attenuate_adapter").trim();
+        if (!["disable_adapter", "attenuate_adapter"].includes(method)) {
+          throw new Error("createUnlearningRequest: execution.adapter.method must be disable_adapter or attenuate_adapter.");
+        }
+        if (method === "attenuate_adapter") {
+          const scaleFactor = Number(adapter.scaleFactor);
+          if (!Number.isFinite(scaleFactor) || scaleFactor <= 0 || scaleFactor >= 1) {
+            throw new Error("createUnlearningRequest: execution.adapter.scaleFactor must be a finite number between 0 and 1 for attenuate_adapter.");
+          }
+        }
+        return;
+      }
       if (!data.execution?.model?.uri?.trim()) {
         throw new Error("createUnlearningRequest: execution.model.uri is required for layer_a_and_b.");
       }
@@ -738,6 +789,40 @@ var Forg3tClient = class {
       );
     }
   }
+  assertAdapterUnlearnPreflight(payload) {
+    if (!payload || typeof payload !== "object") {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload must be an object.");
+    }
+    const asRecord = payload;
+    const config = asRecord.config && typeof asRecord.config === "object" && !Array.isArray(asRecord.config) ? asRecord.config : null;
+    if (!config) {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload.config is required.");
+    }
+    const targetConfig = config.target_config && typeof config.target_config === "object" && !Array.isArray(config.target_config) ? config.target_config : null;
+    const parameters = config.parameters && typeof config.parameters === "object" && !Array.isArray(config.parameters) ? config.parameters : null;
+    const adapter = parameters?.adapter && typeof parameters.adapter === "object" && !Array.isArray(parameters.adapter) ? parameters.adapter : null;
+    if (!targetConfig) {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload.config.target_config is required.");
+    }
+    if (String(targetConfig.backend || "").trim() !== "peft_lora_safetensors") {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload.config.target_config.backend must be peft_lora_safetensors.");
+    }
+    const adapterUri = String(targetConfig.adapter_uri || "").trim();
+    const adapterUriEnvVar = String(targetConfig.adapter_uri_env_var || "").trim();
+    if (!adapterUri && !adapterUriEnvVar) {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload.config.target_config requires adapter_uri or adapter_uri_env_var.");
+    }
+    const method = String(adapter?.method || "attenuate_adapter").trim();
+    if (!["disable_adapter", "attenuate_adapter"].includes(method)) {
+      throw new Error("ADAPTER_UNLEARN preflight failed: parameters.adapter.method must be disable_adapter or attenuate_adapter.");
+    }
+    if (method === "attenuate_adapter") {
+      const scaleFactor = Number(adapter?.scaleFactor);
+      if (!Number.isFinite(scaleFactor) || scaleFactor <= 0 || scaleFactor >= 1) {
+        throw new Error("ADAPTER_UNLEARN preflight failed: parameters.adapter.scaleFactor must be between 0 and 1 for attenuate_adapter.");
+      }
+    }
+  }
 };
 
 // src/types.ts
@@ -750,6 +835,8 @@ var IntegrationType = /* @__PURE__ */ ((IntegrationType2) => {
   IntegrationType2["LANGCHAIN"] = "langchain";
   IntegrationType2["OPENROUTER"] = "openrouter";
   IntegrationType2["OPENAI"] = "openai";
+  IntegrationType2["PGVECTOR"] = "pgvector";
+  IntegrationType2["ADAPTER"] = "adapter";
   IntegrationType2["CUSTOM"] = "custom";
   return IntegrationType2;
 })(IntegrationType || {});
@@ -1453,10 +1540,19 @@ var ENTERPRISE_STRICT_QUALITY_GATE_POLICY = {
   ...WHITEBOX_QUALITY_GATE_PRESETS.strict
 };
 function assertDeploymentCompatibility(options) {
-  const normalizedHost = parseHost(options.apiUrl);
-  if (!normalizedHost) {
+  const parsedApiUrl = parseApiUrl(options.apiUrl);
+  if (!parsedApiUrl) {
     throw new Error(`Invalid FORG3T_API_URL: ${options.apiUrl}`);
   }
+  const normalizedHost = parsedApiUrl.hostname.toLowerCase();
+  if (options.profile === "customer_online") {
+    const publicHost = !isPrivateHost(normalizedHost);
+    if (publicHost && parsedApiUrl.protocol !== "https:") {
+      throw new Error(
+        `Customer online profile requires HTTPS for public control-plane hosts. Received ${options.apiUrl}.`
+      );
+    }
+  }
   if (options.profile !== "customer_airgapped") {
     return;
   }
@@ -1487,10 +1583,9 @@ function buildWhiteboxWorkerOptions(profile, baseOptions) {
     logger: baseOptions.logger
   };
 }
-function parseHost(apiUrl) {
+function parseApiUrl(apiUrl) {
   try {
-    const parsed = new URL(apiUrl);
-    return parsed.hostname.toLowerCase();
+    return new URL(apiUrl);
   } catch {
     return null;
   }

package/dist/index.mjs

@@ -373,6 +373,8 @@ var Forg3tClient = class {
     };
     if (data.type === "MODEL_UNLEARN") {
       this.assertModelUnlearnPreflight(normalizedPayload);
+    } else if (data.type === "ADAPTER_UNLEARN") {
+      this.assertAdapterUnlearnPreflight(normalizedPayload);
     }
     const res = await this.transport.request(`/v1/projects/${projectId}/jobs`, {
       method: "POST",
@@ -597,18 +599,67 @@ var Forg3tClient = class {
       }
     }
     if (data.accessLevel === "layer_a_only") {
+      const rag = data.execution?.rag;
       const target = data.execution?.target;
-      if (!target) {
-        throw new Error("createUnlearningRequest: execution.target is required for layer_a_only.");
+      const adapter = data.execution?.adapter;
+      if (adapter) {
+        throw new Error("createUnlearningRequest: execution.adapter is only valid for layer_a_and_b.");
       }
-      if ((target.provider === "openai" || target.provider === "groq") && !target.model?.trim()) {
-        throw new Error(`createUnlearningRequest: execution.target.model is required when provider=${target.provider}.`);
+      if (target && rag) {
+        throw new Error("createUnlearningRequest: execution.target and execution.rag are mutually exclusive for layer_a_only.");
       }
-      if ((target.provider === "http_generic" || target.provider === "custom") && !target.endpoint?.trim()) {
-        throw new Error(`createUnlearningRequest: execution.target.endpoint is required when provider=${target.provider}.`);
+      if (rag) {
+        if (rag.backend !== "pgvector_postgres") {
+          throw new Error("createUnlearningRequest: execution.rag.backend must be pgvector_postgres.");
+        }
+        if (data.target.type !== "document_id") {
+          throw new Error("createUnlearningRequest: the official RAG lane currently supports target.type=document_id only.");
+        }
+        if (!Array.isArray(data.scope?.integrationIds) || data.scope.integrationIds.length !== 1) {
+          throw new Error("createUnlearningRequest: the official RAG lane requires exactly one scope.integrationIds entry.");
+        }
+        if (data.execution?.routing?.lane && data.execution.routing.lane !== "project_scoped") {
+          throw new Error("createUnlearningRequest: execution.routing.lane must be project_scoped for the official RAG lane.");
+        }
+      } else {
+        if (!target) {
+          throw new Error("createUnlearningRequest: execution.target is required for layer_a_only unless execution.rag is provided.");
+        }
+        if ((target.provider === "openai" || target.provider === "groq") && !target.model?.trim()) {
+          throw new Error(`createUnlearningRequest: execution.target.model is required when provider=${target.provider}.`);
+        }
+        if ((target.provider === "http_generic" || target.provider === "custom") && !target.endpoint?.trim()) {
+          throw new Error(`createUnlearningRequest: execution.target.endpoint is required when provider=${target.provider}.`);
+        }
       }
     }
     if (data.accessLevel === "layer_a_and_b") {
+      const adapter = data.execution?.adapter;
+      if (adapter) {
+        if (adapter.backend !== "peft_lora_safetensors") {
+          throw new Error("createUnlearningRequest: execution.adapter.backend must be peft_lora_safetensors.");
+        }
+        if (data.execution?.model?.uri?.trim()) {
+          throw new Error("createUnlearningRequest: execution.adapter and execution.model are mutually exclusive for layer_a_and_b.");
+        }
+        if (!Array.isArray(data.scope?.integrationIds) || data.scope.integrationIds.length !== 1) {
+          throw new Error("createUnlearningRequest: the official adapter lane requires exactly one scope.integrationIds entry.");
+        }
+        if (data.execution?.routing?.lane && data.execution.routing.lane !== "project_scoped") {
+          throw new Error("createUnlearningRequest: execution.routing.lane must be project_scoped for the official adapter lane.");
+        }
+        const method = String(adapter.method || "attenuate_adapter").trim();
+        if (!["disable_adapter", "attenuate_adapter"].includes(method)) {
+          throw new Error("createUnlearningRequest: execution.adapter.method must be disable_adapter or attenuate_adapter.");
+        }
+        if (method === "attenuate_adapter") {
+          const scaleFactor = Number(adapter.scaleFactor);
+          if (!Number.isFinite(scaleFactor) || scaleFactor <= 0 || scaleFactor >= 1) {
+            throw new Error("createUnlearningRequest: execution.adapter.scaleFactor must be a finite number between 0 and 1 for attenuate_adapter.");
+          }
+        }
+        return;
+      }
       if (!data.execution?.model?.uri?.trim()) {
         throw new Error("createUnlearningRequest: execution.model.uri is required for layer_a_and_b.");
       }
@@ -680,6 +731,40 @@ var Forg3tClient = class {
       );
     }
   }
+  assertAdapterUnlearnPreflight(payload) {
+    if (!payload || typeof payload !== "object") {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload must be an object.");
+    }
+    const asRecord = payload;
+    const config = asRecord.config && typeof asRecord.config === "object" && !Array.isArray(asRecord.config) ? asRecord.config : null;
+    if (!config) {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload.config is required.");
+    }
+    const targetConfig = config.target_config && typeof config.target_config === "object" && !Array.isArray(config.target_config) ? config.target_config : null;
+    const parameters = config.parameters && typeof config.parameters === "object" && !Array.isArray(config.parameters) ? config.parameters : null;
+    const adapter = parameters?.adapter && typeof parameters.adapter === "object" && !Array.isArray(parameters.adapter) ? parameters.adapter : null;
+    if (!targetConfig) {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload.config.target_config is required.");
+    }
+    if (String(targetConfig.backend || "").trim() !== "peft_lora_safetensors") {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload.config.target_config.backend must be peft_lora_safetensors.");
+    }
+    const adapterUri = String(targetConfig.adapter_uri || "").trim();
+    const adapterUriEnvVar = String(targetConfig.adapter_uri_env_var || "").trim();
+    if (!adapterUri && !adapterUriEnvVar) {
+      throw new Error("ADAPTER_UNLEARN preflight failed: payload.config.target_config requires adapter_uri or adapter_uri_env_var.");
+    }
+    const method = String(adapter?.method || "attenuate_adapter").trim();
+    if (!["disable_adapter", "attenuate_adapter"].includes(method)) {
+      throw new Error("ADAPTER_UNLEARN preflight failed: parameters.adapter.method must be disable_adapter or attenuate_adapter.");
+    }
+    if (method === "attenuate_adapter") {
+      const scaleFactor = Number(adapter?.scaleFactor);
+      if (!Number.isFinite(scaleFactor) || scaleFactor <= 0 || scaleFactor >= 1) {
+        throw new Error("ADAPTER_UNLEARN preflight failed: parameters.adapter.scaleFactor must be between 0 and 1 for attenuate_adapter.");
+      }
+    }
+  }
 };
 
 // src/types.ts
@@ -692,6 +777,8 @@ var IntegrationType = /* @__PURE__ */ ((IntegrationType2) => {
   IntegrationType2["LANGCHAIN"] = "langchain";
   IntegrationType2["OPENROUTER"] = "openrouter";
   IntegrationType2["OPENAI"] = "openai";
+  IntegrationType2["PGVECTOR"] = "pgvector";
+  IntegrationType2["ADAPTER"] = "adapter";
   IntegrationType2["CUSTOM"] = "custom";
   return IntegrationType2;
 })(IntegrationType || {});
@@ -1395,10 +1482,19 @@ var ENTERPRISE_STRICT_QUALITY_GATE_POLICY = {
   ...WHITEBOX_QUALITY_GATE_PRESETS.strict
 };
 function assertDeploymentCompatibility(options) {
-  const normalizedHost = parseHost(options.apiUrl);
-  if (!normalizedHost) {
+  const parsedApiUrl = parseApiUrl(options.apiUrl);
+  if (!parsedApiUrl) {
     throw new Error(`Invalid FORG3T_API_URL: ${options.apiUrl}`);
   }
+  const normalizedHost = parsedApiUrl.hostname.toLowerCase();
+  if (options.profile === "customer_online") {
+    const publicHost = !isPrivateHost(normalizedHost);
+    if (publicHost && parsedApiUrl.protocol !== "https:") {
+      throw new Error(
+        `Customer online profile requires HTTPS for public control-plane hosts. Received ${options.apiUrl}.`
+      );
+    }
+  }
   if (options.profile !== "customer_airgapped") {
     return;
   }
@@ -1429,10 +1525,9 @@ function buildWhiteboxWorkerOptions(profile, baseOptions) {
     logger: baseOptions.logger
   };
 }
-function parseHost(apiUrl) {
+function parseApiUrl(apiUrl) {
   try {
-    const parsed = new URL(apiUrl);
-    return parsed.hostname.toLowerCase();
+    return new URL(apiUrl);
   } catch {
     return null;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@forg3t/sdk",
-    "version": "0.1.5",
+    "version": "0.1.6",
     "description": "Official TypeScript SDK for Forg3t Protocol",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",