@wopr-network/defcon 1.0.1 → 1.0.3

package/dist/src/api/server.js

@@ -138,10 +138,11 @@ export function createHttpServer(deps) {
     router.add("POST", "/api/entities", async (req) => {
         const flowName = req.body?.flow;
         const refs = req.body?.refs;
+        const payload = req.body?.payload;
         if (!flowName)
             return { status: 400, body: { error: "Missing required field: flow" } };
         try {
-            const entity = await deps.engine.createEntity(flowName, refs);
+            const entity = await deps.engine.createEntity(flowName, refs, payload);
             return { status: 201, body: entity };
         }
         catch (err) {

package/dist/src/engine/engine.d.ts

@@ -54,7 +54,7 @@ export declare class Engine {
         adapter: string;
         id: string;
         [key: string]: unknown;
-    }>): Promise<Entity>;
+    }>, payload?: Record<string, unknown>): Promise<Entity>;
     claimWork(role: string, flowName?: string, worker_id?: string): Promise<ClaimWorkResult | "all_claimed" | null>;
     private buildPromptForEntity;
     getStatus(): Promise<EngineStatus>;

package/dist/src/engine/engine.js

@@ -241,11 +241,19 @@ export class Engine {
         }
         return result;
     }
-    async createEntity(flowName, refs) {
+    async createEntity(flowName, refs, payload) {
         const flow = await this.flowRepo.getByName(flowName);
         if (!flow)
             throw new NotFoundError(`Flow "${flowName}" not found`);
-        const entity = await this.entityRepo.create(flow.id, flow.initialState, refs);
+        let entity = await this.entityRepo.create(flow.id, flow.initialState, refs);
+        // Store any caller-supplied payload as initial artifacts so prompt templates
+        // can access refs like {{entity.artifacts.refs.linear.id}}.
+        if (payload && Object.keys(payload).length > 0) {
+            await this.entityRepo.updateArtifacts(entity.id, payload);
+            const refreshed = await this.entityRepo.get(entity.id);
+            if (refreshed)
+                entity = refreshed;
+        }
         await this.eventEmitter.emit({
             type: "entity.created",
             entityId: entity.id,

package/dist/src/engine/invocation-builder.js

@@ -30,7 +30,18 @@ export async function buildInvocation(state, entity, adapters, flow, logger = co
             }
         }
     }));
-    const context = { entity, state, refs: resolvedRefs, flow: flow ?? null };
+    // Merge payload-stored refs (entity.artifacts.refs) into entity.refs for template context,
+    // so {{entity.refs.linear.id}} works whether refs were set via formal adapters or via payload.
+    // Normalize to empty object so Handlebars strict mode doesn't throw on missing paths.
+    const artifactRefs = entity.artifacts !== null &&
+        typeof entity.artifacts === "object" &&
+        "refs" in entity.artifacts &&
+        entity.artifacts.refs !== null &&
+        typeof entity.artifacts.refs === "object"
+        ? entity.artifacts.refs
+        : {};
+    const entityForContext = { ...entity, refs: { ...artifactRefs, ...(entity.refs ?? {}) } };
+    const context = { entity: entityForContext, state, refs: resolvedRefs, flow: flow ?? null };
     let prompt = "";
     let systemPrompt = "";
     let userContent = "";

package/dist/src/engine/on-enter.js

@@ -10,8 +10,18 @@ export async function executeOnEnter(onEnter, entity, entityRepo) {
     // Render command via Handlebars
     const hbs = getHandlebars();
     let renderedCommand;
+    // Merge artifact refs into entity.refs so onEnter command templates like
+    // {{entity.refs.github.repo}} resolve correctly for REST-created entities.
+    const artifactRefs = entity.artifacts !== null &&
+        typeof entity.artifacts === "object" &&
+        "refs" in entity.artifacts &&
+        entity.artifacts.refs !== null &&
+        typeof entity.artifacts.refs === "object"
+        ? entity.artifacts.refs
+        : {};
+    const entityForContext = { ...entity, refs: { ...artifactRefs, ...(entity.refs ?? {}) } };
     try {
-        renderedCommand = hbs.compile(onEnter.command)({ entity });
+        renderedCommand = hbs.compile(onEnter.command)({ entity: entityForContext });
     }
     catch (err) {
         const error = `onEnter template error: ${err instanceof Error ? err.message : String(err)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopr-network/defcon",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "packageManager": "pnpm@9.15.4",
   "engines": {