forge-openclaw-plugin 0.2.44 → 0.2.45

package/dist/index.html

@@ -13,7 +13,7 @@
     />
     <link rel="icon" type="image/png" href="/forge/assets/favicon-BCHm9dUV.ico" />
     <link rel="alternate icon" href="/forge/assets/favicon-BCHm9dUV.ico" />
-    <script type="module" crossorigin src="/forge/assets/index-s24CefIb.js"></script>
+    <script type="module" crossorigin src="/forge/assets/index-BejDHw1R.js"></script>
     <link rel="modulepreload" crossorigin href="/forge/assets/vendor-D_NZFJze.js">
     <link rel="modulepreload" crossorigin href="/forge/assets/board-CAszQU7Y.js">
     <link rel="modulepreload" crossorigin href="/forge/assets/ui-B5MjRjKe.js">

package/dist/openclaw/api-client.d.ts

@@ -9,6 +9,7 @@ export type ForgePluginConfig = {
     dataRoot: string;
     apiToken: string;
     actorLabel: string;
+    injectBootstrapContext: boolean;
     timeoutMs: number;
 };
 export type CallForgeApiArgs = {

package/dist/openclaw/plugin-entry-shared.js

@@ -55,6 +55,9 @@ function normalizeDataRoot(value) {
 function normalizeOptionalString(value) {
     return typeof value === "string" ? value.trim() : "";
 }
+function normalizeBoolean(value, fallback) {
+    return typeof value === "boolean" ? value : fallback;
+}
 function isLocalOrigin(origin) {
     try {
         return LOCAL_HOSTNAMES.has(new URL(origin).hostname.toLowerCase());
@@ -98,6 +101,7 @@ export function resolveForgePluginConfig(pluginConfig) {
         dataRoot: normalizeDataRoot(raw.dataRoot),
         apiToken: typeof raw.apiToken === "string" ? raw.apiToken.trim() : "",
         actorLabel: normalizeOptionalString(raw.actorLabel),
+        injectBootstrapContext: normalizeBoolean(raw.injectBootstrapContext, true),
         timeoutMs: normalizeTimeout(raw.timeoutMs, 15_000)
     };
 }
@@ -136,6 +140,11 @@ export const forgePluginConfigSchema = {
                 default: DEFAULT_OPENCLAW_ACTOR_LABEL,
                 description: "Optional acting user label recorded in Forge provenance headers. Leave blank to inherit the local operator session label automatically."
             },
+            injectBootstrapContext: {
+                type: "boolean",
+                default: true,
+                description: "Whether OpenClaw should inject a preseeded Forge BOOTSTRAP.md file into new agent sessions. Disable this to conserve context or model-token budget."
+            },
             timeoutMs: {
                 type: "integer",
                 default: 15000,
@@ -173,6 +182,10 @@ export const forgePluginConfigSchema = {
             help: "Optional acting user label for provenance. Leave blank to inherit the local operator session label, or set one when a child agent should announce itself under a specific user.",
             placeholder: "Inherited from Forge operator session"
         },
+        injectBootstrapContext: {
+            label: "Inject Bootstrap Context",
+            help: "Enabled by default. Turn this off when you want OpenClaw sessions to start without a preseeded Forge BOOTSTRAP.md context file to conserve token budget."
+        },
         timeoutMs: {
             label: "Request Timeout (ms)",
             help: "Maximum time to wait before the plugin aborts an upstream Forge request.",

package/dist/openclaw/session-bootstrap.d.ts

@@ -62,7 +62,18 @@ type ForgeOperatorOverview = {
     warnings?: string[];
     operator?: ForgeOperatorContext | null;
 };
+type ForgeBootstrapPolicy = {
+    mode: "disabled" | "active_only" | "scoped" | "full";
+    goalsLimit: number;
+    projectsLimit: number;
+    tasksLimit: number;
+    habitsLimit: number;
+    strategiesLimit: number;
+    peoplePageLimit: number;
+    includePeoplePages: boolean;
+};
 type ForgeSessionBootstrapPayload = {
+    bootstrapPolicy: ForgeBootstrapPolicy;
     overview: ForgeOperatorOverview | null;
     goals: ForgeGoalRecord[];
     projects: ForgeProjectRecord[];

package/dist/openclaw/session-bootstrap.js

@@ -3,6 +3,16 @@ import { isAgentBootstrapEvent } from "openclaw/plugin-sdk/hook-runtime";
 import { callConfiguredForgeApi, expectForgeSuccess } from "./api-client.js";
 const FORGE_SESSION_BOOTSTRAP_PATH = ".forge/generated/FORGE_SESSION_BOOTSTRAP.md";
 const FORGE_SESSION_BOOTSTRAP_NAME = "forge-session-bootstrap";
+const DEFAULT_BOOTSTRAP_POLICY = {
+    mode: "active_only",
+    goalsLimit: 5,
+    projectsLimit: 8,
+    tasksLimit: 10,
+    habitsLimit: 6,
+    strategiesLimit: 4,
+    peoplePageLimit: 4,
+    includePeoplePages: true
+};
 function isRecord(value) {
     return typeof value === "object" && value !== null;
 }
@@ -12,6 +22,33 @@ function asArray(value) {
 function cleanInline(value) {
     return (value ?? "").replace(/\s+/g, " ").trim();
 }
+function clampBudget(value, fallback, max) {
+    const numeric = typeof value === "number" ? value : Number(value);
+    return Math.min(Math.max(Number.isFinite(numeric) ? numeric : fallback, 0), max);
+}
+function sanitizeBootstrapPolicy(value) {
+    if (!isRecord(value)) {
+        return { ...DEFAULT_BOOTSTRAP_POLICY };
+    }
+    const mode = value.mode === "disabled" ||
+        value.mode === "active_only" ||
+        value.mode === "scoped" ||
+        value.mode === "full"
+        ? value.mode
+        : DEFAULT_BOOTSTRAP_POLICY.mode;
+    return {
+        mode,
+        goalsLimit: clampBudget(value.goalsLimit, DEFAULT_BOOTSTRAP_POLICY.goalsLimit, 100),
+        projectsLimit: clampBudget(value.projectsLimit, DEFAULT_BOOTSTRAP_POLICY.projectsLimit, 100),
+        tasksLimit: clampBudget(value.tasksLimit, DEFAULT_BOOTSTRAP_POLICY.tasksLimit, 100),
+        habitsLimit: clampBudget(value.habitsLimit, DEFAULT_BOOTSTRAP_POLICY.habitsLimit, 100),
+        strategiesLimit: clampBudget(value.strategiesLimit, DEFAULT_BOOTSTRAP_POLICY.strategiesLimit, 100),
+        peoplePageLimit: clampBudget(value.peoplePageLimit, DEFAULT_BOOTSTRAP_POLICY.peoplePageLimit, 50),
+        includePeoplePages: typeof value.includePeoplePages === "boolean"
+            ? value.includePeoplePages
+            : DEFAULT_BOOTSTRAP_POLICY.includePeoplePages
+    };
+}
 function excerpt(value, maxLength) {
     const normalized = cleanInline(value);
     if (!normalized) {
@@ -105,6 +142,7 @@ export function buildForgeSessionBootstrapContext(payload) {
     if (payload.overview?.generatedAt) {
         lines.push(`Generated at: ${payload.overview.generatedAt}`, "");
     }
+    lines.push(`Bootstrap mode: ${payload.bootstrapPolicy.mode.replaceAll("_", " ")}`, "");
     if (overview) {
         lines.push("## Current Forge Snapshot", "");
         lines.push(`- Active projects in operator view: ${overview.activeProjects?.length ?? 0}`);
@@ -177,38 +215,138 @@ async function readForgePayload(config, pathName) {
     });
     return expectForgeSuccess(result);
 }
+function withQuery(pathName, query) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined) {
+            continue;
+        }
+        search.set(key, String(value));
+    }
+    const encoded = search.toString();
+    return encoded ? `${pathName}?${encoded}` : pathName;
+}
+function resolveBootstrapPolicy(onboardingResponse) {
+    const onboarding = onboardingResponse && isRecord(onboardingResponse) && "onboarding" in onboardingResponse
+        ? onboardingResponse.onboarding
+        : null;
+    if (isRecord(onboarding) && isRecord(onboarding.effectiveBootstrapPolicy)) {
+        return sanitizeBootstrapPolicy(onboarding.effectiveBootstrapPolicy);
+    }
+    if (isRecord(onboarding) && isRecord(onboarding.defaultBootstrapPolicy)) {
+        return sanitizeBootstrapPolicy(onboarding.defaultBootstrapPolicy);
+    }
+    return { ...DEFAULT_BOOTSTRAP_POLICY };
+}
 async function loadForgeSessionBootstrapPayload(config) {
+    const onboardingResponse = await readForgePayload(config, "/api/v1/agents/onboarding");
+    const bootstrapPolicy = resolveBootstrapPolicy(onboardingResponse);
+    if (bootstrapPolicy.mode === "disabled") {
+        return {
+            bootstrapPolicy,
+            overview: null,
+            goals: [],
+            projects: [],
+            tasks: [],
+            habits: [],
+            strategies: [],
+            peoplePages: []
+        };
+    }
+    const goalsPath = bootstrapPolicy.mode === "full"
+        ? withQuery("/api/v1/goals", { limit: 100 })
+        : withQuery("/api/v1/goals", {
+            status: bootstrapPolicy.mode === "active_only" ? "active" : undefined,
+            limit: bootstrapPolicy.goalsLimit
+        });
+    const projectsPath = bootstrapPolicy.mode === "full"
+        ? withQuery("/api/v1/projects", { limit: 100 })
+        : withQuery("/api/v1/projects", {
+            status: bootstrapPolicy.mode === "active_only" ? "active" : undefined,
+            limit: bootstrapPolicy.projectsLimit
+        });
+    const tasksPath = bootstrapPolicy.mode === "full"
+        ? withQuery("/api/v1/tasks", { limit: 100 })
+        : withQuery("/api/v1/tasks", {
+            status: bootstrapPolicy.mode === "active_only" ? "focus" : undefined,
+            limit: bootstrapPolicy.tasksLimit
+        });
+    const habitsPath = bootstrapPolicy.mode === "full"
+        ? withQuery("/api/v1/habits", { limit: 100 })
+        : withQuery("/api/v1/habits", {
+            dueToday: bootstrapPolicy.mode === "active_only" ? true : undefined,
+            limit: bootstrapPolicy.habitsLimit
+        });
+    const strategiesPath = bootstrapPolicy.mode === "full"
+        ? withQuery("/api/v1/strategies", { limit: 100 })
+        : withQuery("/api/v1/strategies", {
+            status: bootstrapPolicy.mode === "active_only" ? "active" : undefined,
+            limit: bootstrapPolicy.strategiesLimit
+        });
+    const wikiPagesPath = bootstrapPolicy.includePeoplePages && bootstrapPolicy.peoplePageLimit > 0
+        ? withQuery("/api/v1/wiki/pages", {
+            kind: "wiki",
+            limit: bootstrapPolicy.mode === "full"
+                ? 200
+                : Math.max(bootstrapPolicy.peoplePageLimit * 4, 25)
+        })
+        : null;
     const [overviewResponse, goalsResponse, projectsResponse, tasksResponse, habitsResponse, strategiesResponse, wikiPagesResponse] = await Promise.all([
         readForgePayload(config, "/api/v1/operator/overview"),
-        readForgePayload(config, "/api/v1/goals"),
-        readForgePayload(config, "/api/v1/projects"),
-        readForgePayload(config, "/api/v1/tasks"),
-        readForgePayload(config, "/api/v1/habits"),
-        readForgePayload(config, "/api/v1/strategies"),
-        readForgePayload(config, "/api/v1/wiki/pages")
+        readForgePayload(config, goalsPath),
+        readForgePayload(config, projectsPath),
+        readForgePayload(config, tasksPath),
+        readForgePayload(config, habitsPath),
+        readForgePayload(config, strategiesPath),
+        wikiPagesPath
+            ? readForgePayload(config, wikiPagesPath)
+            : Promise.resolve({ pages: [] })
     ]);
     const wikiPages = asArray(wikiPagesResponse.pages).filter((page) => isRecord(page) &&
         typeof page.slug === "string" &&
         typeof page.title === "string");
     return {
+        bootstrapPolicy,
         overview: overviewResponse && isRecord(overviewResponse) && "overview" in overviewResponse
             ? (overviewResponse.overview ?? null)
             : null,
-        goals: asArray(goalsResponse.goals),
-        projects: asArray(projectsResponse.projects),
-        tasks: asArray(tasksResponse.tasks),
-        habits: asArray(habitsResponse.habits),
-        strategies: asArray(strategiesResponse.strategies),
-        peoplePages: listPeopleBranchPages(wikiPages)
+        goals: bootstrapPolicy.mode === "full"
+            ? asArray(goalsResponse.goals)
+            : asArray(goalsResponse.goals).slice(0, bootstrapPolicy.goalsLimit),
+        projects: bootstrapPolicy.mode === "full"
+            ? asArray(projectsResponse.projects)
+            : asArray(projectsResponse.projects).slice(0, bootstrapPolicy.projectsLimit),
+        tasks: bootstrapPolicy.mode === "full"
+            ? asArray(tasksResponse.tasks)
+            : asArray(tasksResponse.tasks).slice(0, bootstrapPolicy.tasksLimit),
+        habits: bootstrapPolicy.mode === "full"
+            ? asArray(habitsResponse.habits)
+            : asArray(habitsResponse.habits).slice(0, bootstrapPolicy.habitsLimit),
+        strategies: bootstrapPolicy.mode === "full"
+            ? asArray(strategiesResponse.strategies)
+            : asArray(strategiesResponse.strategies).slice(0, bootstrapPolicy.strategiesLimit),
+        peoplePages: bootstrapPolicy.includePeoplePages
+            ? listPeopleBranchPages(wikiPages).slice(0, bootstrapPolicy.peoplePageLimit)
+            : []
     };
 }
 export async function buildLiveForgeSessionBootstrapContext(config) {
-    return buildForgeSessionBootstrapContext(await loadForgeSessionBootstrapPayload(config));
+    if (!config.injectBootstrapContext) {
+        return "";
+    }
+    const payload = await loadForgeSessionBootstrapPayload(config);
+    if (payload.bootstrapPolicy.mode === "disabled") {
+        return "";
+    }
+    return buildForgeSessionBootstrapContext(payload);
 }
 export function registerForgeSessionBootstrapHook(api, config) {
     if (!api.registerHook) {
         return;
     }
+    if (!config.injectBootstrapContext) {
+        return;
+    }
     api.registerHook("agent:bootstrap", async (event) => {
         if (!isAgentBootstrapEvent(event)) {
             return;

package/dist/server/server/migrations/050_agent_token_bootstrap_policy.sql

@@ -0,0 +1,2 @@
+ALTER TABLE agent_tokens
+  ADD COLUMN bootstrap_policy_json TEXT NOT NULL DEFAULT '{"mode":"full","goalsLimit":25,"projectsLimit":25,"tasksLimit":25,"habitsLimit":20,"strategiesLimit":20,"peoplePageLimit":12,"includePeoplePages":true}';

package/dist/server/server/migrations/051_agent_token_scope_policy.sql

@@ -0,0 +1,2 @@
+ALTER TABLE agent_tokens
+  ADD COLUMN scope_policy_json TEXT NOT NULL DEFAULT '{"userIds":[],"projectIds":[],"tagIds":[]}';