@bifrost-ai/interfaces-work 0.1.1-build.1783540132209

package/dist/index.d.mts

@@ -0,0 +1,71 @@
+//#region src/types.d.ts
+type WorkItem = {
+  workItemId: string;
+  kind: string;
+  name: string;
+  state: Record<string, unknown>;
+  readonly metadata: Record<string, unknown>;
+};
+type WorkItemDependency = {
+  workItemId: string;
+  type: string;
+};
+type CreateDraftWorkItemInput = {
+  kind: string;
+  name: string;
+  state?: Record<string, unknown>;
+  metadata?: Record<string, unknown>;
+};
+type WorkItemSource = {
+  watchWorkItems: () => AsyncGenerator<WorkItem>;
+  completeWorkItem: (workItemId: string) => Promise<void>;
+  failWorkItem: (workItemId: string, error: string) => Promise<void>;
+  pauseWorkItem: (workItemId: string) => Promise<void>;
+  setState: (workItemId: string, state: Record<string, unknown>) => Promise<void>;
+  createDraftWorkItem(input: CreateDraftWorkItemInput): Promise<string>;
+  startWorkItem(workItemId: string): Promise<void>;
+  setDependency(workItemId: string, dependsOnWorkItemId: string, type?: string): Promise<void>;
+  getDependencies(workItemId: string): Promise<WorkItemDependency[]>;
+};
+declare function isWorkItem(value: unknown): value is WorkItem;
+declare function missingWorkItemFields(value: unknown): string[];
+declare function missingWorkItemFieldsMessage(missing: string[]): string;
+type ExecutionStats = {
+  durationMs: number;
+  inputTokens: number;
+  outputTokens: number;
+  cacheReadTokens: number;
+  cacheCreationTokens: number;
+  totalCostUsd: number;
+  numTurns: number;
+};
+type Registry<T> = {
+  get(name: string): T | undefined;
+  has(name: string): boolean;
+  register(name: string, item: T): void;
+};
+type DataRegistry<T extends Record<string, unknown>> = {
+  get<K extends keyof T & string>(type: K): Registry<T[K]>;
+};
+type WorkItemHandlerRegistry = {
+  get(kind: string, name: string): WorkItemHandler | undefined;
+  has(kind: string, name: string): boolean;
+};
+type WorkItemExecutionContext<TData extends Record<string, unknown> = Record<string, unknown>> = {
+  readonly data: DataRegistry<TData>;
+  readonly handlers: WorkItemHandlerRegistry;
+  setState: (state: Record<string, unknown>) => Promise<void>;
+};
+type WorkItemResult = {
+  outcome: "completed" | "failed" | "paused";
+  message?: string;
+  telemetry?: ExecutionStats;
+};
+type WorkItemHandler<TData extends Record<string, unknown> = Record<string, unknown>> = {
+  kind: string;
+  name: string;
+  run: (workItem: WorkItem, ctx: WorkItemExecutionContext<TData>) => Promise<WorkItemResult>;
+};
+declare function isWorkItemHandler(value: unknown): value is WorkItemHandler;
+//#endregion
+export { type CreateDraftWorkItemInput, type DataRegistry, type ExecutionStats, type Registry, type WorkItem, type WorkItemDependency, type WorkItemExecutionContext, type WorkItemHandler, type WorkItemHandlerRegistry, type WorkItemResult, type WorkItemSource, isWorkItemHandler, missingWorkItemFields, missingWorkItemFieldsMessage, isWorkItem as validateWorkItem };

package/dist/index.mjs

@@ -0,0 +1,38 @@
+//#region src/types.ts
+const REQUIRED_WORK_ITEM_FIELDS = [
+	"workItemId",
+	"kind",
+	"name"
+];
+function isWorkItem(value) {
+	if (value === null || typeof value !== "object") return false;
+	const record = value;
+	if (typeof record.workItemId !== "string" || record.workItemId.length === 0 || typeof record.kind !== "string" || record.kind.length === 0 || typeof record.name !== "string" || record.name.length === 0 || record.state === null || typeof record.state !== "object" || record.metadata === null || typeof record.metadata !== "object") return false;
+	return true;
+}
+function missingWorkItemFields(value) {
+	if (value === null || typeof value !== "object") return [
+		...REQUIRED_WORK_ITEM_FIELDS,
+		"state",
+		"metadata"
+	];
+	const record = value;
+	const missing = [];
+	for (const field of REQUIRED_WORK_ITEM_FIELDS) if (!(field in record) || record[field] === void 0) missing.push(field);
+	if (!(record.state !== null && typeof record.state === "object")) missing.push("state");
+	if (!(record.metadata !== null && typeof record.metadata === "object")) missing.push("metadata");
+	if (typeof record.workItemId === "string" && record.workItemId.length === 0) missing.push("workItemId");
+	if (typeof record.name === "string" && record.name.length === 0) missing.push("name");
+	if (typeof record.kind === "string" && record.kind.length === 0) missing.push("kind");
+	return [...new Set(missing)];
+}
+function missingWorkItemFieldsMessage(missing) {
+	return `Work item is missing required fields: ${missing.join(", ")}`;
+}
+function isWorkItemHandler(value) {
+	if (value === null || typeof value !== "object") return false;
+	const record = value;
+	return typeof record.kind === "string" && typeof record.name === "string" && typeof record.run === "function";
+}
+//#endregion
+export { isWorkItemHandler, missingWorkItemFields, missingWorkItemFieldsMessage, isWorkItem as validateWorkItem };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@bifrost-ai/interfaces-work",
+  "version": "0.1.1-build.1783540132209",
+  "description": "Work item contracts for Bifrost orchestrator v2",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "@typescript/native-preview": "latest",
+    "bumpp": "^11.1.0",
+    "typescript": "^6.0.3",
+    "vite-plus": "^0.2.0"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test --passWithNoTests",
+    "check": "vp check"
+  }
+}