veryfront 0.1.810 → 0.1.812

package/esm/src/work/index.js

@@ -0,0 +1,25 @@
+/**
+ * Declare source-backed Work definitions for business process observability.
+ *
+ * @module work
+ *
+ * @example
+ * ```ts
+ * import { work } from "veryfront/work";
+ *
+ * export default work({
+ *   id: "supplier-invoice-processing",
+ *   name: "Supplier invoice processing",
+ *   outcome: "Resolve all open supplier invoices.",
+ *   acceptanceCriteria: [
+ *     {
+ *       id: "invoices_discovered",
+ *       description: "Open supplier invoices have been discovered.",
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { work } from "./factory.js";
+export { workRegistry } from "./registry.js";

package/esm/src/work/prompt-augmentation.d.ts

@@ -0,0 +1,6 @@
+import type { WorkDefinition, WorkReference } from "./types.js";
+/** Resolve agent work references to concrete Work definitions. */
+export declare function resolveWorkReferences(references: WorkReference | WorkReference[]): WorkDefinition[];
+/** Build a concise system-prompt section describing assigned Work outcomes. */
+export declare function buildWorkManifestPrompt(works: Iterable<WorkDefinition>): string;
+//# sourceMappingURL=prompt-augmentation.d.ts.map

package/esm/src/work/prompt-augmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-augmentation.d.ts","sourceRoot":"","sources":["../../../src/src/work/prompt-augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhE,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,aAAa,GAAG,aAAa,EAAE,GAC1C,cAAc,EAAE,CAGlB;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,MAAM,CAwB/E"}

package/esm/src/work/prompt-augmentation.js

@@ -0,0 +1,30 @@
+import { workRegistry } from "./registry.js";
+/** Resolve agent work references to concrete Work definitions. */
+export function resolveWorkReferences(references) {
+    const refs = Array.isArray(references) ? references : [references];
+    return refs.map((ref) => typeof ref === "string" ? workRegistry.getRequired(ref) : ref);
+}
+/** Build a concise system-prompt section describing assigned Work outcomes. */
+export function buildWorkManifestPrompt(works) {
+    const workDefinitions = Array.from(works);
+    if (workDefinitions.length === 0)
+        return "";
+    const sections = workDefinitions.map((definition) => {
+        const criteria = definition.acceptanceCriteria.map((criterion) => {
+            const optionalLabel = criterion.optional ? " (optional)" : "";
+            return `- ${criterion.id}${optionalLabel}: ${criterion.description}`;
+        }).join("\n");
+        return [
+            `### ${definition.name} (${definition.id})`,
+            `Outcome: ${definition.outcome}`,
+            "Acceptance criteria:",
+            criteria,
+        ].join("\n");
+    }).join("\n\n");
+    return [
+        "## Work",
+        "Work is business/process state: pursue the outcome, then use Work execution tools to record durable status and evidence. Work definitions do not prescribe fixed workflow control flow.",
+        "",
+        sections,
+    ].join("\n");
+}

package/esm/src/work/registry.d.ts

@@ -0,0 +1,10 @@
+import type { WorkDefinition } from "./types.js";
+import { ScopedRegistryFacade } from "../registry/scoped-registry-facade.js";
+declare class WorkRegistryClass extends ScopedRegistryFacade<WorkDefinition> {
+    getRequired(id: string): WorkDefinition;
+    list(): string[];
+}
+/** Shared Work registry value. */
+export declare const workRegistry: WorkRegistryClass;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/esm/src/work/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/src/work/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAa7E,cAAM,iBAAkB,SAAQ,oBAAoB,CAAC,cAAc,CAAC;IAClE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc;IAMvC,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED,kCAAkC;AAClC,eAAO,MAAM,YAAY,mBAA6C,CAAC"}

package/esm/src/work/registry.js

@@ -0,0 +1,23 @@
+import { createError, toError } from "../errors/veryfront-error.js";
+import { ProjectScopedRegistryManager } from "../registry/project-scoped-registry-manager.js";
+import { ScopedRegistryFacade } from "../registry/scoped-registry-facade.js";
+const workRegistryManager = new ProjectScopedRegistryManager("work");
+function createMissingWorkError(id) {
+    return toError(createError({
+        type: "agent",
+        message: `Work "${id}" not found`,
+    }));
+}
+class WorkRegistryClass extends ScopedRegistryFacade {
+    getRequired(id) {
+        const registeredWork = this.get(id);
+        if (registeredWork)
+            return registeredWork;
+        throw createMissingWorkError(id);
+    }
+    list() {
+        return this.getAllIds();
+    }
+}
+/** Shared Work registry value. */
+export const workRegistry = new WorkRegistryClass(workRegistryManager);

package/esm/src/work/types.d.ts

@@ -0,0 +1,30 @@
+/** One measurable outcome condition for a Work definition. */
+export interface WorkAcceptanceCriterion {
+    /** Stable identifier used by execution state and cloud persistence. */
+    id: string;
+    /** Human-readable condition that must be satisfied unless optional. */
+    description: string;
+    /** Optional criteria do not block Work execution completion. */
+    optional?: true;
+}
+/** Configuration used by work(). */
+export interface WorkConfig {
+    /** Stable project-local Work identifier. */
+    id: string;
+    /** Human-readable display name. Defaults to the id when omitted. */
+    name?: string;
+    /** Business outcome the execution layer should make true. */
+    outcome: string;
+    /** Outcome criteria tracked as business process state. */
+    acceptanceCriteria: WorkAcceptanceCriterion[];
+}
+/** Public API contract for Work definitions. */
+export interface WorkDefinition {
+    id: string;
+    name: string;
+    outcome: string;
+    acceptanceCriteria: WorkAcceptanceCriterion[];
+}
+/** Agent-level reference to source-declared Work. */
+export type WorkReference = string | WorkDefinition;
+//# sourceMappingURL=types.d.ts.map

package/esm/src/work/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/work/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;CAC/C;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;CAC/C;AAED,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,cAAc,CAAC"}

package/esm/src/work/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.810",
+  "version": "0.1.812",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -105,6 +105,10 @@
       "import": "./esm/src/workflow/discovery/index.js",
       "types": "./esm/src/workflow/discovery/index.d.ts"
     },
+    "./work": {
+      "import": "./esm/src/work/index.js",
+      "types": "./esm/src/work/index.d.ts"
+    },
     "./schemas": {
       "import": "./esm/src/schemas/index.js",
       "types": "./esm/src/schemas/index.d.ts"