rscapexai 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# @rsc/rms
+
+Official dependency-free TypeScript/JavaScript client for the RMS public API.
+
+The SDK is a protocol client. It does not implement relational memory, reconstruction, OBS, persistence, or cognition.
+
+```js
+import {RMS} from "@rsc/rms";
+
+const rms=new RMS({
+  apiKey:process.env.RMS_API_KEY,
+  baseUrl:process.env.RMS_BASE_URL,
+  organizationId:process.env.RMS_ORGANIZATION_ID,
+  projectId:process.env.RMS_PROJECT_ID,
+  environmentId:process.env.RMS_ENVIRONMENT_ID,
+});
+
+const participant=await rms.createParticipant();
+const relationship=await rms.createRelationship({humanParticipantId:participant.participant.id});
+
+const before=await rms.getContext(relationship.relationship.id);
+await rms.addContribution(relationship.relationship.id,{content:"The deployment review happens on Friday."});
+const after=await rms.getContext(relationship.relationship.id);
+```
+
+## Initial surfaces
+
+- Participants: create, get.
+- Relationships: create, get, context, history.
+- Contributions: add to a relationship.
+- Artifacts: upload relationship-bound images with an idempotency key.
+- Migrations: validate, stage, commit, get.
+- Verification: list current public verification state or read one test/property.
+
+Participants, relationships, contributions and verification use the versioned `/v1` RMS API. Artifact and migration methods currently call their existing supported public `/api/apex` routes; the SDK does not invent unavailable `/v1` endpoints.
+
+## Boundary
+
+`@rsc/rms` owns HTTP concerns: authentication headers, API version headers, tenant-scope serialization, multipart construction, idempotency headers, response parsing and structured errors.
+
+RMS behavior remains server-side.

package/index.d.ts

@@ -0,0 +1,25 @@
+export type TenantScope={organizationId:string;projectId:string;environmentId:string};
+export type RMSOptions=TenantScope&{apiKey:string;baseUrl:string;apiVersion?:string;fetch?:typeof globalThis.fetch};
+export type ContributionInput={content:string;episodeId?:string};
+export type RelationshipInput={humanParticipantId:string;aiParticipantId?:string};
+export type MigrationInput={sourceSystem:string;records:unknown[]};
+export type ImageArtifactInput={file:File;accountId:string;humanParticipantId:string;relationshipId:string;aiParticipantId?:string;episodeId?:string;idempotencyKey:string};
+export declare class RMSError extends Error{status:number;body:unknown;constructor(message:string,status:number,body:unknown);}
+export declare class RMS{
+ constructor(options:RMSOptions);
+ request<T=unknown>(path:string,options?:{method?:string;body?:unknown;headers?:Record<string,string>;rawBody?:BodyInit}):Promise<T>;
+ createParticipant<T=unknown>():Promise<T>;
+ getParticipant<T=unknown>(id:string):Promise<T>;
+ createRelationship<T=unknown>(input:RelationshipInput):Promise<T>;
+ getRelationship<T=unknown>(id:string):Promise<T>;
+ addContribution<T=unknown>(relationshipId:string,input:ContributionInput):Promise<T>;
+ getContext<T=unknown>(relationshipId:string):Promise<T>;
+ getHistory<T=unknown>(relationshipId:string):Promise<T>;
+ uploadImageArtifact<T=unknown>(input:ImageArtifactInput):Promise<T>;
+ validateMigration<T=unknown>(input:MigrationInput):Promise<T>;
+ stageMigration<T=unknown>(input:MigrationInput&{idempotencyKey:string}):Promise<T>;
+ commitMigration<T=unknown>(input:{migrationId:string;idempotencyKey:string}):Promise<T>;
+ getMigration<T=unknown>(migrationId:string):Promise<T>;
+ listVerification<T=unknown>():Promise<T>;
+ getVerification<T=unknown>(testId:string):Promise<T>;
+}

package/index.js

@@ -0,0 +1,32 @@
+export class RMSError extends Error {
+  constructor(message,status,body){super(message);this.name="RMSError";this.status=status;this.body=body;}
+}
+function query(scope,extra={}){return new URLSearchParams({...scope,...extra}).toString();}
+export class RMS {
+  constructor({apiKey,baseUrl,organizationId,projectId,environmentId,apiVersion="2026-09-21",fetch:fetchImpl=globalThis.fetch}){
+    if(!apiKey)throw new Error("apiKey is required.");if(!baseUrl)throw new Error("baseUrl is required.");if(!organizationId||!projectId||!environmentId)throw new Error("organizationId, projectId, and environmentId are required.");if(!fetchImpl)throw new Error("A fetch implementation is required.");
+    this.apiKey=apiKey;this.baseUrl=baseUrl.replace(/\/$/,"");this.scope={organizationId,projectId,environmentId};this.apiVersion=apiVersion;this.fetch=fetchImpl;
+  }
+  async request(path,{method="GET",body,headers={},rawBody}={}){
+    const response=await this.fetch(`${this.baseUrl}${path}`,{method,headers:{authorization:`Bearer ${this.apiKey}`,"RSC-APEX-Version":this.apiVersion,...(body===undefined&&rawBody===undefined?{}:rawBody!==undefined?{}:{"content-type":"application/json"}),...headers},...(rawBody!==undefined?{body:rawBody}:body===undefined?{}:{body:JSON.stringify(body)})});
+    const text=await response.text();let payload=null;try{payload=text?JSON.parse(text):null;}catch{payload=text;}
+    if(!response.ok)throw new RMSError(payload?.error?.message||payload?.reason||`RMS request failed with HTTP ${response.status}.`,response.status,payload);return payload;
+  }
+  createParticipant(){return this.request("/v1/participants",{method:"POST",body:this.scope});}
+  getParticipant(id){return this.request(`/v1/participants/${encodeURIComponent(id)}?${query(this.scope)}`);}
+  createRelationship({humanParticipantId,aiParticipantId}){return this.request("/v1/relationships",{method:"POST",body:{...this.scope,humanParticipantId,...(aiParticipantId?{aiParticipantId}:{})}});}
+  getRelationship(id){return this.request(`/v1/relationships/${encodeURIComponent(id)}?${query(this.scope)}`);}
+  addContribution(relationshipId,{content,episodeId}){return this.request(`/v1/relationships/${encodeURIComponent(relationshipId)}/contributions`,{method:"POST",body:{...this.scope,content,...(episodeId?{episodeId}:{})}});}
+  getContext(relationshipId){return this.request(`/v1/relationships/${encodeURIComponent(relationshipId)}/context?${query(this.scope)}`);}
+  getHistory(relationshipId){return this.request(`/v1/relationships/${encodeURIComponent(relationshipId)}/history?${query(this.scope)}`);}
+  uploadImageArtifact({file,accountId,humanParticipantId,relationshipId,aiParticipantId="ai-apex",episodeId,idempotencyKey}){
+    if(!idempotencyKey)throw new Error("idempotencyKey is required.");const form=new FormData();for(const[k,v]of Object.entries({...this.scope,accountId,humanParticipantId,relationshipId,aiParticipantId,...(episodeId?{episodeId}:{})}))form.set(k,v);form.set("file",file);
+    return this.request("/api/apex/artifacts/image",{method:"POST",rawBody:form,headers:{"idempotency-key":idempotencyKey}});
+  }
+  validateMigration({sourceSystem,records}){return this.request("/api/apex/migrations",{method:"POST",body:{...this.scope,sourceSystem,records,dryRun:true}});}
+  stageMigration({sourceSystem,records,idempotencyKey}){if(!idempotencyKey)throw new Error("idempotencyKey is required.");return this.request("/api/apex/migrations",{method:"POST",body:{...this.scope,sourceSystem,records,dryRun:false},headers:{"idempotency-key":idempotencyKey}});}
+  commitMigration({migrationId,idempotencyKey}){if(!idempotencyKey)throw new Error("idempotencyKey is required.");return this.request("/api/apex/migrations",{method:"PATCH",body:{...this.scope,migrationId,action:"commit"},headers:{"idempotency-key":idempotencyKey}});}
+  getMigration(migrationId){return this.request(`/api/apex/migrations?${query(this.scope,{migrationId})}`);}
+  listVerification(){return this.request("/v1/verification");}
+  getVerification(testId){return this.request(`/v1/verification?testId=${encodeURIComponent(testId)}`);}
+}

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "rscapexai",
+  "version": "0.1.0",
+  "description": "APEXAI relational memory SDK with the RSCAPEX cognition bridge.",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": { ".": { "types": "./index.d.ts", "import": "./index.js", "default": "./index.js" } },
+  "engines": { "node": ">=18" },
+  "files": ["index.js", "index.d.ts", "README.md"],
+  "dependencies": { "rscapex": "^0.1.0" },
+  "license": "UNLICENSED"
+}