anbaric-tsapi 1.21.4 → 1.22.0

package/dist/api/state-machine/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../src/api/state-machine/Queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAEtD,UAAU,KAAK;IAEX,OAAO,CAAC,KAAK,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,SAAS,EAAE,UAAU,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,QAAQ,CAAC,KAAK,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,SAAS,EAAE,UAAU,EAAG,MAAM,EAAE,GAAG,EAAG,IAAI,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAEzG;AAED,UAAU,OAAQ,SAAQ,KAAK;IAE3B,WAAW,IAAK,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;CAEhD;AAED,QAAA,MAAM,OAAO;IACT,QAAQ,QAAS,KAAK,GAAI,KAAK,IAAI,OAAO;CAG7C,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA"}

package/dist/api/state-machine/Queue.js

@@ -0,0 +1,7 @@
+const Dequeue = {
+    supports(queue) {
+        return "dequeueSome" in queue;
+    },
+};
+export { Dequeue };
+//# sourceMappingURL=Queue.js.map

package/dist/api/state-machine/Queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../../src/api/state-machine/Queue.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,GAAG;IACZ,QAAQ,CAAC,KAAa;QAClB,OAAO,aAAa,IAAI,KAAK,CAAC;IAClC,CAAC;CACJ,CAAC;AAEF,OAAO,EAAS,OAAO,EAAE,CAAA"}

package/dist/api/states/State.d.ts

@@ -0,0 +1,13 @@
+import { Action } from "../actions/Action.js";
+import { Await } from "../actions/Await.js";
+import { Transition } from "../transitions/Transition.js";
+declare class State {
+    readonly id: string;
+    actions: Array<Action | Await>;
+    transitions: Array<Transition>;
+    readonly isTerminal: boolean;
+    constructor(id: string, actions?: Array<Action | Await>, transitions?: Array<Transition>, isTerminal?: boolean);
+    subscribe(action: Action | Await): void;
+}
+export { State };
+//# sourceMappingURL=State.d.ts.map

package/dist/api/states/State.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"State.d.ts","sourceRoot":"","sources":["../../../src/api/states/State.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAC,UAAU,EAAC,MAAM,8BAA8B,CAAC;AAExD,cAAM,KAAK;IAEP,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,OAAO,EAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IAChC,WAAW,EAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAG,OAAO,CAAC;IAE9B,YAAY,EAAE,EAAG,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAM,EAAE,WAAW,GAAG,KAAK,CAAC,UAAU,CAAM,EAAE,UAAU,GAAG,OAAe,EAKhI;IAED,SAAS,CAAC,MAAM,EAAG,MAAM,GAAG,KAAK,GAAI,IAAI,CAExC;CAEJ;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/api/states/State.js

@@ -0,0 +1,17 @@
+class State {
+    id;
+    actions;
+    transitions;
+    isTerminal;
+    constructor(id, actions = [], transitions = [], isTerminal = false) {
+        this.id = id;
+        this.actions = actions;
+        this.transitions = transitions;
+        this.isTerminal = isTerminal;
+    }
+    subscribe(action) {
+        this.actions.push(action);
+    }
+}
+export { State };
+//# sourceMappingURL=State.js.map

package/dist/api/states/State.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"State.js","sourceRoot":"","sources":["../../../src/api/states/State.ts"],"names":[],"mappings":"AAIA,MAAM,KAAK;IAEE,EAAE,CAAU;IACrB,OAAO,CAAyB;IAChC,WAAW,CAAqB;IACvB,UAAU,CAAW;IAE9B,YAAY,EAAW,EAAE,OAAO,GAA2B,EAAE,EAAE,WAAW,GAAuB,EAAE,EAAE,UAAU,GAAa,KAAK;QAC7H,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,MAAuB;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CAEJ;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/api/states/Terminal.d.ts

@@ -0,0 +1,13 @@
+import { State } from "./State.js";
+declare class Terminal extends State {
+    readonly outcome: Terminal.Outcome;
+    constructor(id: string, outcome: Terminal.Outcome);
+}
+declare namespace Terminal {
+    enum Outcome {
+        SUCCESS = "SUCCESS",
+        FAILURE = "FAILURE"
+    }
+}
+export { Terminal };
+//# sourceMappingURL=Terminal.d.ts.map

package/dist/api/states/Terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../../../src/api/states/Terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AAIjC,cAAM,QAAS,SAAQ,KAAK;IAExB,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAC,OAAO,CAAC;IAEpC,YAAY,EAAE,EAAG,MAAM,EAAE,OAAO,EAAG,QAAQ,CAAC,OAAO,EAGlD;CAEJ;AAED,kBAAU,QAAQ,CAAC;IAEf,KAAY,OAAO;QACf,OAAO,YAAY;QACnB,OAAO,YAAY;KACtB;CAEJ;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/api/states/Terminal.js

@@ -0,0 +1,19 @@
+import { State } from "./State.js";
+/* An end state: a job that reaches a Terminal stops progressing and is never
+   re-enqueued. The outcome records whether the workflow succeeded or failed. */
+class Terminal extends State {
+    outcome;
+    constructor(id, outcome) {
+        super(id, [], [], true);
+        this.outcome = outcome;
+    }
+}
+(function (Terminal) {
+    let Outcome;
+    (function (Outcome) {
+        Outcome["SUCCESS"] = "SUCCESS";
+        Outcome["FAILURE"] = "FAILURE";
+    })(Outcome = Terminal.Outcome || (Terminal.Outcome = {}));
+})(Terminal || (Terminal = {}));
+export { Terminal };
+//# sourceMappingURL=Terminal.js.map

package/dist/api/states/Terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.js","sourceRoot":"","sources":["../../../src/api/states/Terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AAEjC;gFACgF;AAChF,MAAM,QAAS,SAAQ,KAAK;IAEf,OAAO,CAAoB;IAEpC,YAAY,EAAW,EAAE,OAA0B;QAC/C,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CAEJ;AAED,WAAU,QAAQ;IAEd,IAAY,OAGX;IAHD,WAAY,OAAO;QACf,8BAAmB,CAAA;QACnB,8BAAmB,CAAA;IACvB,CAAC,EAHW,OAAO,GAAP,SAAA,OAAO,KAAP,SAAA,OAAO,QAGlB;AAEL,CAAC,EAPS,QAAQ,KAAR,QAAQ,QAOjB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/api/transitions/Transition.d.ts

@@ -0,0 +1,8 @@
+import { Job } from "../jobs/Job.js";
+declare class Transition {
+    to: string;
+    predicate: (job: Job) => boolean;
+    constructor(to: string, predicate: (job: Job) => boolean);
+}
+export { Transition };
+//# sourceMappingURL=Transition.d.ts.map

package/dist/api/transitions/Transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transition.d.ts","sourceRoot":"","sources":["../../../src/api/transitions/Transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,gBAAgB,CAAC;AAEnC,cAAM,UAAU;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;IAEjC,YAAY,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,EAGvD;CACJ;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/api/transitions/Transition.js

@@ -0,0 +1,10 @@
+class Transition {
+    to;
+    predicate;
+    constructor(to, predicate) {
+        this.to = to;
+        this.predicate = predicate;
+    }
+}
+export { Transition };
+//# sourceMappingURL=Transition.js.map

package/dist/api/transitions/Transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transition.js","sourceRoot":"","sources":["../../../src/api/transitions/Transition.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU;IACZ,EAAE,CAAS;IACX,SAAS,CAAwB;IAEjC,YAAY,EAAU,EAAE,SAAgC;QACpD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;CACJ;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export * from "./api/jobs/Job.js";
+export * from "./api/jobs/JobPersistence.js";
+export * from "./api/jobs/JobSerialization.js";
+export * from "./api/jobs/PropertyDefinition.js";
+export * from "./api/states/State.js";
+export * from "./api/states/Terminal.js";
+export * from "./api/actions/Action.js";
+export * from "./api/actions/Await.js";
+export * from "./api/actions/WaitForInput.js";
+export * from "./api/actions/AgenticAction.js";
+export * from "./api/actors/agents/AgentMessage.js";
+export * from "./api/actors/agents/AgentRequest.js";
+export * from "./api/actors/agents/Agent.js";
+export * from "./api/auditing/Auditor.js";
+export * from "./api/auditing/NoOpAuditor.js";
+export * from "./api/transitions/Transition.js";
+export * from "./api/actors/Actor.js";
+export * from "./api/actors/SystemActor.js";
+export * from "./api/sessions/SessionResolver.js";
+export * from "./api/documents/JsonStore.js";
+export * from "./api/secrets/SecretStore.js";
+export * from "./api/sql/SqlStore.js";
+export * from "./api/documents/JsonSchema.js";
+export * from "./api/state-machine/Queue.js";
+export * from "./api/state-machine/Consumer.js";
+export * from "./api/cloud/QueueMessage.js";
+export * from "./api/cloud/WorkflowDefinition.js";
+export * from "./api/cloud/AuditRecord.js";
+export * from "./api/cloud/AppAware.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,30 @@
+export * from "./api/jobs/Job.js";
+export * from "./api/jobs/JobPersistence.js";
+export * from "./api/jobs/JobSerialization.js";
+export * from "./api/jobs/PropertyDefinition.js";
+export * from "./api/states/State.js";
+export * from "./api/states/Terminal.js";
+export * from "./api/actions/Action.js";
+export * from "./api/actions/Await.js";
+export * from "./api/actions/WaitForInput.js";
+export * from "./api/actions/AgenticAction.js";
+export * from "./api/actors/agents/AgentMessage.js";
+export * from "./api/actors/agents/AgentRequest.js";
+export * from "./api/actors/agents/Agent.js";
+export * from "./api/auditing/Auditor.js";
+export * from "./api/auditing/NoOpAuditor.js";
+export * from "./api/transitions/Transition.js";
+export * from "./api/actors/Actor.js";
+export * from "./api/actors/SystemActor.js";
+export * from "./api/sessions/SessionResolver.js";
+export * from "./api/documents/JsonStore.js";
+export * from "./api/secrets/SecretStore.js";
+export * from "./api/sql/SqlStore.js";
+export * from "./api/documents/JsonSchema.js";
+export * from "./api/state-machine/Queue.js";
+export * from "./api/state-machine/Consumer.js";
+export * from "./api/cloud/QueueMessage.js";
+export * from "./api/cloud/WorkflowDefinition.js";
+export * from "./api/cloud/AuditRecord.js";
+export * from "./api/cloud/AppAware.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}

package/package.json

@@ -1,20 +1,29 @@
 {
   "name": "anbaric-tsapi",
-  "version": "1.21.4",
+  "version": "1.22.0",
   "description": "These are the shared libraries - types, classes, etc - that both the public state-machine and hosting services share",
   "license": "MIT",
   "author": "chris@anbaric.ai",
   "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
-    "test": "vitest run"
+    "test": "vitest run",
+    "build": "tsc -b tsconfig.build.json",
+    "prepublishOnly": "npm run build"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
     "typescript": "^7.0.2"
   },
   "files": [
-    "src"
+    "dist"
   ]
 }

package/src/api/actions/Action.ts

@@ -1,25 +0,0 @@
-import {Actor} from "../actors/Actor";
-import {Job} from "../jobs/Job";
-
-type CodeRun = (job : Job) => Promise<Map<string, any>>;
-
-class Action {
-
-    readonly id : string;
-    name : string;
-    description : string;
-    actor : Actor;
-
-    constructor(name : string, actor : Actor, description : string = "", id : string = crypto.randomUUID()) {
-        this.name = name;
-        this.actor = actor;
-        this.description = description;
-        this.id = id;
-    }
-
-    predicate = (_job : Job) => true;
-    run : CodeRun = async (_job : Job) => new Map();
-
-}
-
-export { Action }

package/src/api/actions/AgenticAction.ts

@@ -1,24 +0,0 @@
-import {Agent} from "../actors/agents/Agent";
-import {AgentRequest} from "../actors/agents/AgentRequest";
-import {Job} from "../jobs/Job";
-import {Action} from "./Action";
-
-/* An action whose properties are generated by an agent. run builds a request
-   from the job and hands it to the agent's client; the structured result
-   becomes the property map. Subclasses decide how the request is composed. */
-abstract class AgenticAction extends Action {
-
-    protected agent : Agent;
-
-    constructor(name : string, agent : Agent, description : string = "", id? : string) {
-        super(name, agent, description, id);
-        this.agent = agent;
-        this.run = async (job : Job) =>
-            new Map(Object.entries(await this.agent.client.generate(this.requestFor(job))));
-    }
-
-    protected abstract requestFor(job : Job) : AgentRequest;
-
-}
-
-export { AgenticAction }

package/src/api/actions/WaitForInput.ts

@@ -1,43 +0,0 @@
-type AwaitParty = "HUMAN" | "EXTERNAL_SYSTEM";
-
-/* What an Await is waiting for: which kind of party (a human or an external
-   system), the input fields it expects, a URL a client can send the user to in
-   order to provide them, and any extra metadata. A pure data class - it carries
-   no behaviour. */
-class WaitForInput {
-
-    fields : Array<string>;
-    resolveUrl : string;
-    metadataMap : Map<string, any>;
-    waitingFor? : AwaitParty;
-
-    constructor(fields : Array<string> = [], resolveUrl : string = "",
-                metadataMap : Map<string, any> = new Map(), waitingFor? : AwaitParty) {
-        this.fields = fields;
-        this.resolveUrl = resolveUrl;
-        this.metadataMap = metadataMap;
-        this.waitingFor = waitingFor;
-    }
-
-}
-
-type SerializedWaitForInput = {
-    fields : Array<string>,
-    resolveUrl : string,
-    metadataMap : Record<string, any>,
-    waitingFor? : AwaitParty,
-};
-
-const serializeWaitForInput = (wait : WaitForInput) : SerializedWaitForInput => ({
-    fields: wait.fields,
-    resolveUrl: wait.resolveUrl,
-    metadataMap: Object.fromEntries(wait.metadataMap),
-    waitingFor: wait.waitingFor,
-});
-
-const deserializeWaitForInput = (serialized : SerializedWaitForInput) : WaitForInput =>
-    new WaitForInput(serialized.fields ?? [], serialized.resolveUrl ?? "",
-        new Map(Object.entries(serialized.metadataMap ?? {})), serialized.waitingFor);
-
-export { WaitForInput, serializeWaitForInput, deserializeWaitForInput };
-export type { SerializedWaitForInput, AwaitParty };

package/src/api/actors/Actor.ts

@@ -1,11 +0,0 @@
-type ActorType = "HUMAN" | "CODE" | "AGENT" | "SYSTEM";
-
-interface Actor {
-
-    type : ActorType;
-    id : string;
-    roles : Array<string>;
-
-}
-
-export type { Actor, ActorType }

package/src/api/actors/SystemActor.ts

@@ -1,13 +0,0 @@
-import {Actor, ActorType} from "./Actor";
-
-class SystemActor implements Actor {
-
-    type : ActorType = "SYSTEM";
-    id = "_SYSTEM";
-    roles = ["_SYSTEM"];
-
-    static actor = new SystemActor();
-
-}
-
-export { SystemActor }

package/src/api/actors/agents/Agent.ts

@@ -1,32 +0,0 @@
-import {Actor} from "../Actor";
-import {AgentRequest} from "./AgentRequest";
-
-/* An agent is a light actor: identity only, used for auditing and
-   authorization like any other actor. The functional model detail lives in
-   its Client collaborator, keeping the actor itself pure data. */
-class Agent implements Actor {
-
-    readonly type = "AGENT" as const;
-    readonly id : string;
-    readonly roles : Array<string>;
-    readonly client : Agent.Client;
-
-    constructor(id : string, roles : Array<string> | string, client : Agent.Client) {
-        this.id = id;
-        this.roles = typeof roles === "string" ? [roles] : roles;
-        this.client = client;
-    }
-
-}
-
-namespace Agent {
-
-    export abstract class Client {
-
-        abstract generate(request : AgentRequest) : Promise<Record<string, any>>;
-
-    }
-
-}
-
-export { Agent }

package/src/api/actors/agents/AgentMessage.ts

@@ -1,8 +0,0 @@
-type AgentMessage = {
-
-    role : "system" | "user" | "assistant";
-    content : string;
-
-};
-
-export type { AgentMessage }

package/src/api/actors/agents/AgentRequest.ts

@@ -1,10 +0,0 @@
-import {AgentMessage} from "./AgentMessage";
-
-type AgentRequest = {
-
-    messages : Array<AgentMessage>;
-    outputSchema : object;
-
-};
-
-export type { AgentRequest }

package/src/api/auditing/Auditor.ts

@@ -1,13 +0,0 @@
-import {Actor} from "../actors/Actor";
-
-/* Records an interaction with a resource. The interaction is one or more plain
-   strings chosen by the persistence class that calls it - the auditor itself
-   defines no vocabulary. */
-interface Auditor {
-
-    audit(appId : string | undefined, resourceType : string, resourceId : string, actor : Actor,
-          interaction : Array<string>, description : string, details : any) : Promise<void>;
-
-}
-
-export { Auditor }

package/src/api/auditing/NoOpAuditor.ts

@@ -1,15 +0,0 @@
-import {Actor} from "../actors/Actor";
-import {Auditor} from "./Auditor";
-
-/* An auditor that records nothing. Used by the persistence instances that sit
-   behind the HTTP API, where the app-facing store on the other side has
-   already audited the interaction. */
-class NoOpAuditor implements Auditor {
-
-    async audit(_appId : string | undefined, _resourceType : string, _resourceId : string, _actor : Actor,
-                _interaction : Array<string>, _description : string, _details : any) : Promise<void> {
-    }
-
-}
-
-export { NoOpAuditor }

package/src/api/cloud/AppAware.ts

@@ -1,14 +0,0 @@
-/* A service that knows which deployed app it belongs to. The id always comes
-   from the environment (ANBARIC_APP_ID), never a constructor argument, so a
-   developer never has to supply it. Hosted services (the state machine, the
-   cloud/Postgres stores) implement this; purely local in-memory ones do not. */
-interface AppAware {
-    getAppId() : string;
-}
-
-// The current app's id from the environment, or "" when running outside a
-// deployed app (locally). The single source for every AppAware implementation.
-const currentAppId = () : string => process.env.ANBARIC_APP_ID ?? "";
-
-export { currentAppId };
-export type { AppAware };

package/src/api/cloud/AuditRecord.ts

@@ -1,14 +0,0 @@
-type AuditRecord = {
-    id? : string,
-    appId? : string,
-    resourceType : string,
-    resourceId : string,
-    actorId : string,
-    actorType : string,
-    interaction : Array<string>,
-    description : string,
-    details : any,
-    at? : string,
-};
-
-export type { AuditRecord }

package/src/api/cloud/QueueMessage.ts

@@ -1,8 +0,0 @@
-type QueueMessage = {
-    jobId : string,
-    appId? : string,
-    workflowId : string,
-    position? : number,
-};
-
-export type { QueueMessage }

package/src/api/cloud/WorkflowDefinition.ts

@@ -1,49 +0,0 @@
-import {State} from "../states/State";
-import {PropertyDefinition} from "../jobs/PropertyDefinition";
-import {Await} from "../actions/Await";
-
-/* The serialisable graph of a state machine: its states, each state's actions
-   (identity only — the run/predicate bodies aren't persistable) and
-   transitions. Recorded as the details of an audit record when a state machine
-   initialises. Awaits are pause points rather than actors acting, so they are
-   not part of the graph - awaiting jobs are surfaced separately. */
-type WorkflowDefinition = {
-
-    appId? : string,
-    workflowId : string,
-    startState : string,
-    dataSchema : Array<{ id : string, required : boolean }>,
-    states : Array<{
-        id : string,
-        isTerminal : boolean,
-        actions : Array<{ name : string, description : string, actor : { id : string, type : string, roles : Array<string> } }>,
-        transitions : Array<{ to : string }>,
-    }>,
-
-};
-
-namespace WorkflowDefinition {
-
-    export const describe = (appId : string | undefined, workflowId : string, startState : string,
-                             states : Array<State>, dataSchema : Array<PropertyDefinition>) : WorkflowDefinition => ({
-        appId,
-        workflowId,
-        startState,
-        dataSchema: dataSchema.map(property => ({ id: property.id, required: property.required })),
-        states: states.map(state => ({
-            id: state.id,
-            isTerminal: state.isTerminal,
-            actions: state.actions
-                .filter((action) : action is Exclude<typeof action, Await> => ! (action instanceof Await))
-                .map(action => ({
-                    name: action.name,
-                    description: action.description,
-                    actor: { id: action.actor.id, type: action.actor.type, roles: action.actor.roles },
-                })),
-            transitions: state.transitions.map(transition => ({ to: transition.to })),
-        })),
-    });
-
-}
-
-export { WorkflowDefinition }

package/src/api/documents/JsonSchema.ts

@@ -1,53 +0,0 @@
-type JsonSchema = {
-    type? : "object" | "array" | "string" | "number" | "integer" | "boolean" | "null",
-    properties? : Record<string, JsonSchema>,
-    required? : Array<string>,
-    items? : JsonSchema,
-    enum? : Array<any>,
-};
-
-const jsonTypeOf = (value : any) : string => {
-    if (value === null) return "null";
-    if (Array.isArray(value)) return "array";
-    if (typeof value === "number") return Number.isInteger(value) ? "integer" : "number";
-    return typeof value;
-};
-
-const matchesType = (value : any, expected : string) : boolean => {
-    const actual = jsonTypeOf(value);
-    return expected === "number" ? actual === "number" || actual === "integer" : actual === expected;
-};
-
-const isPlainObject = (value : any) : boolean => jsonTypeOf(value) === "object";
-
-const validateDocument = (document : any, schema : JsonSchema, path : string = "$") : Array<string> => {
-    const violations : Array<string> = [];
-
-    if (schema.type && !matchesType(document, schema.type)) {
-        violations.push(`${path} should be ${schema.type} but was ${jsonTypeOf(document)}`);
-        return violations;
-    }
-
-    if (schema.enum && !schema.enum.some(allowed => JSON.stringify(allowed) === JSON.stringify(document))) {
-        violations.push(`${path} must be one of ${JSON.stringify(schema.enum)}`);
-    }
-
-    if (isPlainObject(document)) {
-        for (const key of schema.required ?? []) {
-            if (!(key in document)) violations.push(`${path}.${key} is required`);
-        }
-        for (const [key, propertySchema] of Object.entries(schema.properties ?? {})) {
-            if (key in document) violations.push(...validateDocument(document[key], propertySchema, `${path}.${key}`));
-        }
-    }
-
-    if (Array.isArray(document) && schema.items) {
-        document.forEach((item, index) =>
-            violations.push(...validateDocument(item, schema.items!, `${path}[${index}]`)));
-    }
-
-    return violations;
-};
-
-export { validateDocument };
-export type { JsonSchema };

package/src/api/documents/JsonStore.ts

@@ -1,56 +0,0 @@
-import {Actor} from "../actors/Actor";
-import {Auditor} from "../auditing/Auditor";
-import {currentAppId} from "../cloud/AppAware";
-
-/* A schema-validated JSON document store that audits every interaction, keyed
-   by collection and id. Public methods audit then defer to ...Internal. */
-abstract class JsonStore {
-
-    constructor(protected auditor : Auditor, protected collection : string = "documents") {
-    }
-
-    async create(actor : Actor, id : string, document : any) : Promise<void> {
-        await this.auditor.audit(currentAppId(), "document", `${this.collection}/${id}`, actor, [JsonStore.Interaction.CREATE], "Document created", document);
-        await this.saveInternal(id, document);
-    }
-
-    async save(actor : Actor, changeDescription : string, id : string, document : any) : Promise<void> {
-        await this.auditor.audit(currentAppId(), "document", `${this.collection}/${id}`, actor, [JsonStore.Interaction.SAVE], changeDescription, document);
-        await this.saveInternal(id, document);
-    }
-
-    async retrieve(id : string, actor : Actor) : Promise<any> {
-        await this.auditor.audit(currentAppId(), "document", `${this.collection}/${id}`, actor, [JsonStore.Interaction.READ], "", null);
-        return this.retrieveInternal(id);
-    }
-
-    async delete(id : string, actor : Actor) : Promise<void> {
-        await this.auditor.audit(currentAppId(), "document", `${this.collection}/${id}`, actor, [JsonStore.Interaction.DELETE], "", null);
-        await this.deleteInternal(id);
-    }
-
-    async list(actor : Actor, pageSize? : number, page? : number) : Promise<Array<any>> {
-        await this.auditor.audit(currentAppId(), "document", `${this.collection}/*`, actor, [JsonStore.Interaction.LIST], "", null);
-        return this.listInternal(pageSize, page);
-    }
-
-    protected abstract saveInternal(id : string, document : any) : Promise<void>;
-    protected abstract retrieveInternal(id : string) : Promise<any>;
-    protected abstract deleteInternal(id : string) : Promise<void>;
-    protected abstract listInternal(pageSize? : number, page? : number) : Promise<Array<any>>;
-
-}
-
-namespace JsonStore {
-
-    export enum Interaction {
-        CREATE = "CREATE",
-        SAVE = "SAVE",
-        READ = "READ",
-        DELETE = "DELETE",
-        LIST = "LIST",
-    }
-
-}
-
-export { JsonStore }