bopodev-agent-sdk 0.1.28 → 0.1.29

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
 
-> bopodev-agent-sdk@0.1.28 build /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopodev/packages/agent-sdk
+> bopodev-agent-sdk@0.1.29 build /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopodev/packages/agent-sdk
 > tsc -p tsconfig.json --emitDeclarationOnly
 

package/.turbo/turbo-lint.log

@@ -0,0 +1,4 @@
+
+> bopodev-agent-sdk@0.1.28 lint /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopodev/packages/agent-sdk
+> tsc -p tsconfig.json --noEmit
+

package/dist/agent-sdk/src/types.d.ts

@@ -4,6 +4,10 @@ export interface AgentWorkItem {
     issueId: string;
     projectId: string;
     parentIssueId?: string | null;
+    /** Linked planning goals for this issue, if any. */
+    goalIds?: string[];
+    /** Root-to-leaf chain per linked goal (same order as goalIds). */
+    goalAncestryChains?: string[][];
     childIssueIds?: string[];
     projectName?: string | null;
     title: string;

package/dist/contracts/src/index.d.ts

@@ -127,8 +127,10 @@ export declare const IssueSchema: z.ZodObject<{
     companyId: z.ZodString;
     projectId: z.ZodString;
     parentIssueId: z.ZodNullable<z.ZodString>;
+    goalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
     title: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    externalLink: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodEnum<{
         blocked: "blocked";
         todo: "todo";
@@ -192,8 +194,10 @@ export declare const IssueDetailSchema: z.ZodObject<{
     companyId: z.ZodString;
     projectId: z.ZodString;
     parentIssueId: z.ZodNullable<z.ZodString>;
+    goalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
     title: z.ZodString;
     body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    externalLink: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodEnum<{
         blocked: "blocked";
         todo: "todo";
@@ -310,6 +314,7 @@ export declare const GoalSchema: z.ZodObject<{
     companyId: z.ZodString;
     projectId: z.ZodNullable<z.ZodString>;
     parentGoalId: z.ZodNullable<z.ZodString>;
+    ownerAgentId: z.ZodNullable<z.ZodString>;
     level: z.ZodEnum<{
         agent: "agent";
         company: "company";

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "bopodev-agent-sdk",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "license": "MIT",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "dependencies": {
-    "bopodev-contracts": "0.1.28"
+    "bopodev-contracts": "0.1.29"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json --emitDeclarationOnly",

package/src/adapters.ts

@@ -11,7 +11,11 @@ import type {
   HeartbeatContext,
   HeartbeatPromptMode
 } from "./types";
-import { ExecutionOutcomeSchema, type ExecutionOutcome } from "bopodev-contracts";
+import {
+  ExecutionOutcomeSchema,
+  type AgentFinalRunOutput,
+  type ExecutionOutcome
+} from "bopodev-contracts";
 import {
   checkRuntimeCommandHealth,
   containsUsageLimitHardStopFailure,
@@ -161,6 +165,32 @@ function toNormalizedUsage(usage: RuntimeParsedUsage | undefined): AdapterNormal
   };
 }
 
+/**
+ * Cursor and Gemini CLIs emit stream-json transcripts with usage, not a standalone heartbeat JSON blob.
+ * When structured usage was resolved from the stream but no final JSON object exists, synthesize the
+ * minimal contract shape so downstream heartbeat persistence stays consistent.
+ */
+function synthesizeStreamFinalRunOutput(
+  provider: AgentProviderType,
+  parsedUsage: RuntimeParsedUsage | undefined
+): AgentFinalRunOutput | null {
+  if (provider !== "cursor" && provider !== "gemini_cli") {
+    return null;
+  }
+  if (!parsedUsage) {
+    return null;
+  }
+  const summary =
+    (typeof parsedUsage.summary === "string" && parsedUsage.summary.trim()) ||
+    `${provider} runtime completed.`;
+  return {
+    employee_comment: summary,
+    results: [],
+    errors: [],
+    artifacts: []
+  };
+}
+
 function usageTokenInputTotal(usage: RuntimeParsedUsage | undefined) {
   if (!usage) {
     return 0;
@@ -1850,7 +1880,9 @@ export function toProviderResult(
         nextState: applyProviderSessionState(context, provider, sessionUpdate)
       };
     }
-    if (!runtime.finalRunOutput) {
+    const resolvedFinalRunOutput =
+      runtime.finalRunOutput ?? synthesizeStreamFinalRunOutput(provider, runtime.parsedUsage);
+    if (!resolvedFinalRunOutput) {
       const usage = toNormalizedUsage(runtime.parsedUsage);
       const detail = resolveFinalRunOutputContractDetail({ provider, runtime });
       return createContractInvalidResult({
@@ -1895,7 +1927,7 @@ export function toProviderResult(
       tokenInput: usageTokenInputTotal(runtime.parsedUsage),
       tokenOutput,
       usdCost,
-      finalRunOutput: runtime.finalRunOutput,
+      finalRunOutput: resolvedFinalRunOutput,
       usage,
       pricingProviderType,
       pricingModelId,
@@ -2646,9 +2678,31 @@ function clipPromptText(text: string, max: number | null): string {
 const HEARTBEAT_JSON_SCHEMA_FOOTER = `At the end of your response, output exactly one JSON object on a single line and nothing else. Use this exact schema:
 {"employee_comment":"markdown update to the manager","results":["short concrete outcome"],"errors":[],"artifacts":[{"kind":"file","path":"relative/path"}]}`;
 
+/** Injected every heartbeat when the runtime sets BOPODEV_AGENT_OPERATING_DIR (no need to store paths in bootstrapPrompt). */
+function buildOperatingDirectoryPromptPrefix(context: HeartbeatContext): string {
+  const dir = context.runtime?.env?.BOPODEV_AGENT_OPERATING_DIR?.trim();
+  if (!dir) {
+    return "";
+  }
+  return [
+    "Operating context:",
+    `- Your agent operating directory (read AGENTS.md, HEARTBEAT.md, SOUL.md, TOOLS.md here when they exist): ${dir}`,
+    ""
+  ].join("\n");
+}
+
+function composeBootstrapPreamble(context: HeartbeatContext): string {
+  const operating = buildOperatingDirectoryPromptPrefix(context);
+  const user = context.runtime?.bootstrapPrompt?.trim();
+  if (!user) {
+    return operating;
+  }
+  return operating ? `${operating}${user}\n\n` : `${user}\n\n`;
+}
+
 function buildIdleMicroPrompt(context: HeartbeatContext): string {
-  const bootstrapPrompt = context.runtime?.bootstrapPrompt?.trim();
-  return `${bootstrapPrompt ? `${bootstrapPrompt}\n\n` : ""}Idle heartbeat (micro prompt): agent ${context.agentId} (${context.agent.name}) has no assigned issues this run. Summarize readiness in \`employee_comment\`; leave \`results\` empty unless you completed verifiable work. Use \`BOPODEV_*\` for control-plane API calls when needed.
+  const preamble = composeBootstrapPreamble(context);
+  return `${preamble}Idle heartbeat (micro prompt): agent ${context.agentId} (${context.agent.name}) has no assigned issues this run. Summarize readiness in \`employee_comment\`; leave \`results\` empty unless you completed verifiable work. Use \`BOPODEV_*\` for control-plane API calls when needed.
 
 ${HEARTBEAT_JSON_SCHEMA_FOOTER}
 `;
@@ -2673,7 +2727,7 @@ export function createPrompt(context: HeartbeatContext) {
   if (context.idleMicroPrompt && context.workItems.length === 0 && !isCommentOrderRunEarly) {
     return buildIdleMicroPrompt(context);
   }
-  const bootstrapPrompt = context.runtime?.bootstrapPrompt?.trim();
+  const bootstrapPreamble = composeBootstrapPreamble(context);
   const promptMode = resolveHeartbeatPromptModeForPrompt(context);
   const isCompact = promptMode === "compact";
   const memoryCap = resolveMemorySectionMaxChars(promptMode);
@@ -2696,6 +2750,11 @@ export function createPrompt(context: HeartbeatContext) {
             `- [${item.issueId}] ${item.title}`,
             `  Project: ${item.projectName ?? item.projectId}`,
             item.parentIssueId ? `  Parent issue: ${item.parentIssueId}` : null,
+            ...(item.goalAncestryChains && item.goalAncestryChains.length > 0
+              ? item.goalAncestryChains.map(
+                  (chain, idx) => `  Linked goal ${idx + 1} (root → leaf): ${chain.join(" → ")}`
+                )
+              : []),
             item.childIssueIds?.length ? `  Sub-issues: ${item.childIssueIds.join(", ")}` : null,
             item.status ? `  Status: ${item.status}` : null,
             item.priority ? `  Priority: ${item.priority}` : null,
@@ -2819,7 +2878,7 @@ export function createPrompt(context: HeartbeatContext) {
     "- Do not invent token or cost values; the runtime records usage separately."
   ].join("\n");
 
-  return `${bootstrapPrompt ? `${bootstrapPrompt}\n\n` : ""}You are ${context.agent.name} (${context.agent.role}), agent ${context.agentId}.
+  return `${bootstrapPreamble}You are ${context.agent.name} (${context.agent.role}), agent ${context.agentId}.
 Heartbeat run ${context.heartbeatRunId}.
 ${isCompact ? "Prompt profile: compact (issue bodies are not inlined—use GET /issues/:id to hydrate).\n" : ""}
 Company:

package/src/types.ts

@@ -6,6 +6,10 @@ export interface AgentWorkItem {
   issueId: string;
   projectId: string;
   parentIssueId?: string | null;
+  /** Linked planning goals for this issue, if any. */
+  goalIds?: string[];
+  /** Root-to-leaf chain per linked goal (same order as goalIds). */
+  goalAncestryChains?: string[][];
   childIssueIds?: string[];
   projectName?: string | null;
   title: string;