@obversa/runtime 0.1.0

package/dist/workflow-support.d.ts

@@ -0,0 +1,36 @@
+import type { Job, JobContext } from './core/types.js';
+import type { TeamSeat } from '@obversa/api';
+type TeamWorkspaceMode = 'read' | 'write';
+export interface TestCommand {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly timeoutMs?: number;
+}
+export interface TeamInput {
+    readonly brief: string;
+    readonly workspace: string;
+    readonly files: readonly string[];
+    readonly test: TestCommand;
+}
+export interface ReviewerSeat {
+    readonly name: string;
+    readonly seat: TeamSeat;
+    readonly scope?: string;
+}
+export declare function seatIdentity(seat: TeamSeat): TeamSeat['identity'];
+export declare function assertDistinctSeats(seats: readonly TeamSeat[]): void;
+export declare function requireNonEmptyFiles(label: string, job: Job, workspace: string, files: readonly string[]): Job;
+export declare function requireNoFiles(label: string, job: Job, workspace: string, files: readonly string[], phase?: 'body' | 'review'): Job;
+export declare function teamAgent(label: string, seat: TeamSeat, input: TeamInput, instructions: string | ((ctx: JobContext) => string), target?: string, decisionFile?: string, workspaceMode?: TeamWorkspaceMode, recordAs?: {
+    readonly role: 'writer' | 'reviewer';
+    readonly stage: string;
+}): Job;
+export declare function panelReviewers(reviewers: readonly ReviewerSeat[], input: TeamInput, reviewTarget?: string, recordAs?: {
+    readonly role: 'writer' | 'reviewer';
+    readonly stage: string;
+}): Array<{
+    name: string;
+    scope?: string;
+    job: Job;
+}>;
+export { INVALID_TEAM_DECISION, outcomeFromAgentText } from './workflow-agent-response.js';

package/dist/workflow-support.js

@@ -0,0 +1,5 @@
+export { INVALID_TEAM_DECISION, assertDistinctSeats, outcomeFromAgentText, panelReviewers, requireNoFiles, requireNonEmptyFiles, seatIdentity, teamAgent } from './chunk-DV5P4QLI.js';
+import './chunk-NIBHM5I5.js';
+import './chunk-5GLEABOU.js';
+//# sourceMappingURL=workflow-support.js.map
+//# sourceMappingURL=workflow-support.js.map

package/dist/workflow-support.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"workflow-support.js"}

package/dist/workflow.d.ts

@@ -0,0 +1,73 @@
+import { type TeamSeat } from '@obversa/api';
+import type { Job, Outcome, ConditionInput } from './core/types.js';
+export interface BriefSource {
+    readonly brief: string;
+    readonly files?: readonly string[];
+}
+export interface PersonRole {
+    readonly kind: 'person';
+    readonly question: string;
+}
+export type WorkflowRole = TeamSeat | readonly TeamSeat[] | PersonRole;
+export interface WorkflowStageBase {
+    readonly writes?: string | readonly string[];
+    readonly desc?: string;
+    readonly gate?: string;
+    readonly when?: ConditionInput;
+    readonly optional?: boolean;
+    readonly needs?: string | readonly string[];
+    readonly sendsBackTo?: string;
+    readonly retry?: number;
+    /** An interrupted attempt may run again without a person's reconciliation. */
+    readonly retrySafe?: boolean;
+}
+export type WorkflowStage = WorkflowStageBase & {} & ({
+    readonly agent: string;
+    readonly reviewedBy?: string;
+    readonly run?: never;
+    readonly panel?: never;
+    readonly input?: never;
+} | {
+    readonly run: string | readonly string[];
+    readonly agent?: never;
+    readonly panel?: never;
+    readonly input?: never;
+} | {
+    readonly panel: string;
+    readonly agree?: number;
+    readonly agent?: never;
+    readonly run?: never;
+    readonly input?: never;
+} | {
+    readonly input: string;
+    readonly agent?: never;
+    readonly run?: never;
+    readonly panel?: never;
+});
+export interface NamedStage {
+    readonly name: string;
+    readonly config: WorkflowStage;
+}
+export interface WorkflowOptions {
+    readonly timeout?: string | number;
+}
+export interface WorkflowRecord {
+    readonly outcome: Outcome;
+    summary(): string;
+}
+export interface WorkflowPostContext {
+    readonly record: WorkflowRecord;
+}
+export interface WorkflowConfig {
+    readonly brief: string | BriefSource;
+    readonly options?: WorkflowOptions;
+    readonly roles: Readonly<Record<string, WorkflowRole>>;
+    readonly stages: readonly NamedStage[];
+    readonly post?: {
+        readonly always?: (context: WorkflowPostContext) => void | Promise<void>;
+    };
+}
+export declare function briefFromFile(path: string | URL): BriefSource;
+export declare function person(question: string): PersonRole;
+export declare function stage(name: string, config: WorkflowStage): NamedStage;
+export declare function workflow(name: string, config: WorkflowConfig): Job;

package/dist/workspace/conformance.d.ts

@@ -0,0 +1 @@
+export { runWorkspaceProviderConformance, assertWorkspaceProviderConformance, type WorkspaceProviderConformanceFixture, type WorkspaceProviderConformanceFailure, type WorkspaceProviderConformanceReport, } from '@obversa/api/testing';

package/dist/workspace/git-provider.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The single-repository Git worktree provider (roadmap D12): the one safe
+ * Git default.
+ *
+ * Capture and verify are read-only — status, head, and content digests.
+ * Fork validates the anchor first; a changed anchor fails before a branch
+ * or worktree exists. A successful fork writes exactly two things into
+ * the bound repository's metadata — a new ref at the anchored revision
+ * and a worktree registration — plus the worktree directory itself at a
+ * deterministic sibling path. The user's checkout, index, and dirty files
+ * are untouched. The create order is fixed: ref first, then the worktree,
+ * so a crash between the two leaves a detectable bare ref that cleanup
+ * can remove or retry; a second fork of the same child id fails at the
+ * existing ref or path instead of duplicating anything.
+ *
+ * The lease lives in private Git refs. Its complete JSON record is a Git blob.
+ * Git's expected-object-id update makes publication, release, and recovery
+ * change only the exact record they checked. Acquisition creates the one ref
+ * with a complete blob, so a kill cannot publish a partial valid owner.
+ */
+import { type WorkspaceProvider } from './provider.js';
+/** Create the single-repository Git worktree provider for one checkout. */
+export declare function createGitWorktreeProvider(options: {
+    readonly repositoryPath: string;
+    readonly signal?: AbortSignal;
+}): WorkspaceProvider;

package/dist/workspace/provider.d.ts

@@ -0,0 +1,2 @@
+export type { WorkspaceAnchor, WorkspaceHeadDrift, WorkspaceFilesDrift, WorkspaceRepositoryDrift, WorkspaceDrift, VerifyResult, ForkOk, ForkChangedAnchor, ForkExists, ForkIncomplete, ForkUnleased, ForkNoRevision, ForkInvalidChild, ForkResult, LeaseClaimed, LeaseHeld, LeaseIncomplete, AcquireResult, WorkspaceReleaseResult, RecoverResult, WorkspaceProvider, } from '@obversa/api';
+export type { GitWorkspaceSnapshot } from '../core/git.js';

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@obversa/runtime",
+  "version": "0.1.0",
+  "description": "Model how your team really works. Durable agent workflows, reviews that send work back, no database needed.",
+  "license": "MIT",
+  "author": "Jonny Neill <jonnyneill@hotmail.com>",
+  "type": "module",
+  "main": "./dist/api.js",
+  "types": "./dist/api.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    },
+    "./memory": {
+      "types": "./dist/memory.d.ts",
+      "import": "./dist/memory.js"
+    },
+    "./workflow-support": {
+      "types": "./dist/workflow-support.d.ts",
+      "import": "./dist/workflow-support.js"
+    },
+    "./env/command": {
+      "types": "./dist/env/command.d.ts",
+      "import": "./dist/env/command.js"
+    },
+    "./storage/local": {
+      "types": "./dist/storage/local.d.ts",
+      "import": "./dist/storage/local.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "dependencies": {
+    "p-limit": "^7.3.0",
+    "toposort": "^2.0.2",
+    "@obversa/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@obversa/api": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.12.0",
+    "@types/toposort": "^2.0.7",
+    "execa": "^9.6.1",
+    "@obversa/api": "0.1.0"
+  },
+  "keywords": [
+    "agent",
+    "graph",
+    "workflow",
+    "runtime",
+    "obversa",
+    "software-factory",
+    "product-factory",
+    "agent-pipeline",
+    "agent-harness",
+    "domain-specific-harness",
+    "multi-agent",
+    "durable-workflow"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jonny981/obversa.git"
+  },
+  "homepage": "https://docs.obversa.ai",
+  "bugs": {
+    "url": "https://github.com/jonny981/obversa/issues"
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "typecheck:ts6": "tsc6 --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}