@agentswf/contract 0.0.0-stage → 0.1.0-beta.1

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@agentswf/contract",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-beta.1",
+  "description": "agents.wf: types, schemas and record formats shared by its packages",
+  "license": "MIT",
+  "homepage": "https://github.com/romanlv/agentswf",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/romanlv/agentswf.git",
+    "directory": "packages/contract"
+  },
+  "type": "module",
+  "engines": {
+    "bun": ">=1.4.0"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./schema": "./src/schema.ts",
+    "./records": "./src/records.ts",
+    "./wire": "./src/wire.ts",
+    "./participant": "./src/participant.ts",
+    "./workflow": "./src/workflow/index.ts",
+    "./testing": "./src/testing/fixtures.ts"
+  },
+  "files": [
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.eval.ts",
+    "!src/**/fixtures"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/call.ts

@@ -0,0 +1,6 @@
+/** Only `answered` carries a value: a turn that produced nothing cannot be read as data. */
+export type CallResult =
+  | { kind: "answered"; value: unknown }
+  | { kind: "finished"; reason: string }
+  | { kind: "blocked"; reason: string }
+  | { kind: "failed"; reason: string };

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./call";
+export * from "./records";
+export * from "./schema";
+export * from "./semantic";

package/src/participant.ts

@@ -0,0 +1,15 @@
+import type { ParticipantKey, ParticipantRef } from "./workflow/participants";
+
+/**
+ * What makes a `ParticipantRef` one the engine issued. Exported only through
+ * `@agentswf/contract/participant`, which a workflow cannot import, so a `{ key }` literal does not
+ * type-check as a ref.
+ */
+export const PARTICIPANT: unique symbol = Symbol("agentswf.participant");
+
+/** A ref for a participant the engine opened. */
+export function participantRef<K extends ParticipantKey>(
+  key: K,
+): ParticipantRef & { readonly key: K } {
+  return { key, [PARTICIPANT]: true };
+}