@withbuddi/buddi 0.1.0-pre.28 → 0.1.0-pre.30

package/packages/core/dist/queue/retry-policy.js

@@ -249,6 +249,17 @@ export function retryDelayMs(profile, attemptsSpent) {
     const index = Math.min(Math.max(attemptsSpent - 1, 0), delays.length - 1);
     return delays[index];
 }
+/**
+ * How long the provider asked to wait, from the error's `retryAt` (a 429's
+ * window, or a spent daily quota's reset). Undefined when it named none.
+ */
+export function hintedWaitMs(err, now) {
+    const at = readString(err, 'retryAt');
+    if (at === undefined)
+        return undefined;
+    const ms = Date.parse(at) - now.getTime();
+    return Number.isFinite(ms) && ms > 0 ? ms : undefined;
+}
 /**
  * Should this failed attempt be tried again, and when?
  *
@@ -274,12 +285,18 @@ export function decideRetry(input) {
         };
     }
     const age = input.now.getTime() - input.createdAt.getTime();
-    const backoffMs = retryDelayMs(profile, input.attempts);
+    // The provider said when to come back: the job sleeps in the queue until
+    // then rather than waking early to be refused again (the adapter does not
+    // hold a worker through a long window; see the runtime's retry.ts).
+    const hinted = hintedWaitMs(input.error, input.now);
+    const backoffMs = Math.max(retryDelayMs(profile, input.attempts), hinted ?? 0);
     if (age >= profile.maxLifetimeMs || age + backoffMs >= profile.maxLifetimeMs) {
         return {
             retry: false,
             failureClass: verdict.class,
-            reason: `gave up after ${Math.round(profile.maxLifetimeMs / 60_000)} minutes of retrying — ${verdict.reason}`,
+            reason: hinted !== undefined && age + hinted >= profile.maxLifetimeMs
+                ? `the provider asked to wait until ${new Date(input.now.getTime() + hinted).toISOString()}, past this job's ${Math.round(profile.maxLifetimeMs / 60_000)}-minute horizon — ${verdict.reason}`
+                : `gave up after ${Math.round(profile.maxLifetimeMs / 60_000)} minutes of retrying — ${verdict.reason}`,
         };
     }
     return { retry: true, backoffMs, failureClass: verdict.class, reason: verdict.reason };

package/packages/core/dist/queue/retry-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry-policy.js","sourceRoot":"","sources":["../../src/queue/retry-policy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retry-policy.js","sourceRoot":"","sources":["../../src/queue/retry-policy.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/queue/types.d.ts

@@ -22,6 +22,14 @@ export type Job = {
     conversationId: string | null;
     dedupKey: string | null;
     suspendedReason: string | null;
+    /**
+     * When a failed job stopped asking for the owner: dismissed by him, or
+     * quiet on its own once it is AUTO_QUIET_DAYS old. Null for every job that
+     * is not failed, and for a failed one still in the footer's count.
+     */
+    acknowledgedAt: Date | null;
+    /** `owner` when dismissed, `auto` when it went quiet by age. */
+    acknowledgedBy: string | null;
     createdAt: Date;
     updatedAt: Date;
 };
@@ -41,10 +49,22 @@ export type JobRow = {
     conversation_id: string | null;
     dedup_key: string | null;
     suspended_reason: string | null;
+    acknowledged_at: Date | null;
+    acknowledged_by: string | null;
     created_at: Date;
     updated_at: Date;
 };
 export declare function toJob(row: JobRow): Job;
+/**
+ * A failed job older than this stops asking for the owner on its own: it
+ * leaves the footer's count and the Jobs page's list of decisions, and stays
+ * in the history. Read, not written — no sweeper has to have run.
+ */
+export declare const AUTO_QUIET_DAYS = 14;
+/** A failed job that still asks for the owner: not dismissed, not quiet by age. */
+export declare const UNACKNOWLEDGED_FAILED_SQL = "(state = 'failed' and acknowledged_at is null and not (updated_at < now() - interval '14 days'))";
+/** A failed job that no longer asks: dismissed, or quiet by age. */
+export declare const ACKNOWLEDGED_FAILED_SQL = "(state = 'failed' and (acknowledged_at is not null or updated_at < now() - interval '14 days'))";
 export declare const JOB_COLUMNS: string;
 /**
  * Bounded retry with exponential backoff: 1m, 5m, 25m.

package/packages/core/dist/queue/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/queue/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,eAAO,MAAM,UAAU,iFAOb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,EAAE,SAAS,QAAQ,EAAyC,CAAC;AAE7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,MAAM,MAAM,GAAG,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sEAAsE;IACtE,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CAClB,CAAC;AAEF,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAoBtC;AAED,eAAO,MAAM,WAAW,QAGE,CAAC;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAS,CAAC;AACpC,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAgB,GAAG,MAAM,CAG3E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/queue/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,eAAO,MAAM,UAAU,iFAOb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,EAAE,SAAS,QAAQ,EAAyC,CAAC;AAE7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,MAAM,MAAM,GAAG,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sEAAsE;IACtE,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,gEAAgE;IAChE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,IAAI,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CAClB,CAAC;AAEF,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAsBtC;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAIlC,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,qGACsC,CAAC;AAE7E,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,oGACuC,CAAC;AAE5E,eAAO,MAAM,WAAW,QAOE,CAAC;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAS,CAAC;AACpC,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAgB,GAAG,MAAM,CAG3E"}

package/packages/core/dist/queue/types.js

@@ -29,12 +29,29 @@ export function toJob(row) {
         conversationId: row.conversation_id,
         dedupKey: row.dedup_key,
         suspendedReason: row.suspended_reason,
+        acknowledgedAt: row.acknowledged_at ?? null,
+        acknowledgedBy: row.acknowledged_by ?? null,
         createdAt: row.created_at,
         updatedAt: row.updated_at,
     };
 }
+/**
+ * A failed job older than this stops asking for the owner on its own: it
+ * leaves the footer's count and the Jobs page's list of decisions, and stays
+ * in the history. Read, not written — no sweeper has to have run.
+ */
+export const AUTO_QUIET_DAYS = 14;
+const QUIET_BY_AGE = `updated_at < now() - interval '${AUTO_QUIET_DAYS} days'`;
+/** A failed job that still asks for the owner: not dismissed, not quiet by age. */
+export const UNACKNOWLEDGED_FAILED_SQL = `(state = 'failed' and acknowledged_at is null and not (${QUIET_BY_AGE}))`;
+/** A failed job that no longer asks: dismissed, or quiet by age. */
+export const ACKNOWLEDGED_FAILED_SQL = `(state = 'failed' and (acknowledged_at is not null or ${QUIET_BY_AGE}))`;
 export const JOB_COLUMNS = 'id, kind, payload, state, priority, run_after, attempts, max_attempts, lease_owner, ' +
     'lease_until, last_error, result, conversation_id, dedup_key, suspended_reason, ' +
+    `case when state <> 'failed' then null when acknowledged_at is not null then acknowledged_at ` +
+    `when ${QUIET_BY_AGE} then updated_at + interval '${AUTO_QUIET_DAYS} days' end as acknowledged_at, ` +
+    `case when state <> 'failed' then null when acknowledged_at is not null then acknowledged_by ` +
+    `when ${QUIET_BY_AGE} then 'auto' end as acknowledged_by, ` +
     'created_at, updated_at';
 /**
  * Bounded retry with exponential backoff: 1m, 5m, 25m.

package/packages/core/dist/queue/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/queue/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS;IACT,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;IACX,WAAW;CACH,CAAC;AAIX,4CAA4C;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAwB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE7F,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAQ,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AA4CD,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI;QAC1B,cAAc,EAAE,GAAG,CAAC,eAAe;QACnC,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,eAAe,EAAE,GAAG,CAAC,gBAAgB;QACrC,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GACtB,sFAAsF;IACtF,iFAAiF;IACjF,wBAAwB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,MAAM,GAAG,aAAa;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,MAAM,GAAG,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/queue/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS;IACT,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;IACX,WAAW;CACH,CAAC;AAIX,4CAA4C;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAwB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE7F,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAQ,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAsDD,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI;QAC1B,cAAc,EAAE,GAAG,CAAC,eAAe;QACnC,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,eAAe,EAAE,GAAG,CAAC,gBAAgB;QACrC,cAAc,EAAE,GAAG,CAAC,eAAe,IAAI,IAAI;QAC3C,cAAc,EAAE,GAAG,CAAC,eAAe,IAAI,IAAI;QAC3C,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,MAAM,YAAY,GAAG,kCAAkC,eAAe,QAAQ,CAAC;AAE/E,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GACpC,0DAA0D,YAAY,IAAI,CAAC;AAE7E,oEAAoE;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAClC,yDAAyD,YAAY,IAAI,CAAC;AAE5E,MAAM,CAAC,MAAM,WAAW,GACtB,sFAAsF;IACtF,iFAAiF;IACjF,8FAA8F;IAC9F,QAAQ,YAAY,gCAAgC,eAAe,iCAAiC;IACpG,8FAA8F;IAC9F,QAAQ,YAAY,uCAAuC;IAC3D,wBAAwB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,MAAM,GAAG,aAAa;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,MAAM,GAAG,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/packages/core/dist/registry.d.ts

@@ -4,7 +4,10 @@ import { type ViewDescriptor } from './views.js';
 import { type PageDescriptor, type PageQuery, type WorkspaceFiles } from './pages.js';
 import type { HomeContribution } from './home.js';
 import { type RegisteredMetric } from './metrics.js';
+import { type RegisteredWidget } from './widgets.js';
 import { type UntrustedKind } from './learning/types.js';
+import { type HostBinding } from './host/build.js';
+import { type PluginReadiness } from './plugin/requires.js';
 /** Tiers this build executes directly, with no human in the loop. */
 export declare const EXECUTABLE_TIERS: readonly Tier[];
 /** Tiers that become an action and wait for the owner. */
@@ -63,7 +66,7 @@ export type InvokeResult<O = unknown> = {
     message: string;
 } | {
     ok: false;
-    reason: 'unknown-tool' | 'invalid-args' | 'tier-not-executable' | 'tool-error' | 'session-not-authorized';
+    reason: 'unknown-tool' | 'invalid-args' | 'tier-not-executable' | 'tool-error' | 'session-not-authorized' | 'ask-only';
     message: string;
 };
 /**
@@ -109,6 +112,8 @@ type JsonSchema = Record<string, unknown>;
  * plugin can still be named.
  */
 export declare function toolInputSchema(tool: ToolDefinition<any, any>, plugin: string): JsonSchema;
+/** How long a plugin's setup answer or an export call may take. */
+export declare const PLUGIN_CALL_TIMEOUT_MS = 5000;
 export declare class ToolRegistry {
     #private;
     register(manifest: PluginManifest): void;
@@ -203,6 +208,26 @@ export declare class ToolRegistry {
     home(): HomeContribution[];
     /** The plugin that contributes a Home block or glance, by the contribution's id. */
     homePlugin(id: string): string | undefined;
+    /**
+     * Whether `plugin` can do anything yet (host API 1.18): its `setup` answer,
+     * on the read-only pool, within `timeoutMs`. Undefined when the plugin is
+     * not registered or declares no setup — it is simply loaded. A setup that
+     * throws, times out or answers nonsense rejects; the caller decides what
+     * that means (the Plugins page shows the plugin as loaded and logs it).
+     */
+    readiness(plugin: string, ctx: CoreToolContext, timeoutMs?: number): Promise<PluginReadiness | undefined>;
+    /**
+     * The host binding this registry made for `plugin`: the one whose
+     * `plugins.call`, `tools` and runtime network a context outside a tool —
+     * a source, a watcher, a sentinel — must share to act as the same plugin.
+     */
+    hostBinding(plugin: string): HostBinding | undefined;
+    /** The plugins `plugin` requires, with their ranges; empty when none or not registered. */
+    requiresOf(plugin: string): Readonly<Record<string, string>>;
+    /** Every widget the installed plugins export, each carrying its plugin, in registration order. */
+    widgets(): RegisteredWidget[];
+    /** One widget by its id, or undefined. */
+    widget(id: string): RegisteredWidget | undefined;
     /**
      * Every metric the installed plugins contribute, each carrying its plugin,
      * in registration order. The model of `home()`: this is what `goal.metrics`
@@ -236,7 +261,17 @@ export declare class ToolRegistry {
      * bypass is an approval row saying the owner said yes to this precise action.
      */
     lookup(name: string): ExecutableTool | undefined;
-    invoke(name: string, rawArgs: unknown, caller: CoreToolContext): Promise<InvokeResult>;
+    invoke(name: string, rawArgs: unknown, caller: CoreToolContext, 
+    /**
+     * `askOnly`: this caller may record an approval and nothing more — a call
+     * whose tier would run it here (`auto`, `session`) is refused unrun. An
+     * owner API token acting through a plugin page is such a caller: it acts
+     * as the owner, so an `auto` or `ownerOnly` tool would otherwise store a
+     * secret or a standing rule with no person at the dashboard.
+     */
+    opts?: {
+        askOnly?: boolean;
+    }): Promise<InvokeResult>;
 }
 export {};
 //# sourceMappingURL=registry.d.ts.map

package/packages/core/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/registry.js

@@ -21,13 +21,16 @@ import { createAction } from './actions/store.js';
 import { isToolRefusal } from './tools.js';
 import { parseViewDescriptors } from './views.js';
 import { OWNER_AGENT_ID, parsePageContributions } from './pages.js';
-import { parseMetrics } from './metrics.js';
+import { parseMetrics, metricContext } from './metrics.js';
+import { parseWidgets } from './widgets.js';
 import { UNTRUSTED_KINDS } from './learning/types.js';
-import { hostBindingOf, networkAreaOf, registerHostOf, releaseHostBinding, withPluginHost } from './host/build.js';
+import { hostBindingOf, networkAreaOf, readOnlyHostOf, registerHostOf, releaseHostBinding, withPluginHost } from './host/build.js';
 import { registerSecretDestination, unregisterSecretDestinations } from './secrets/destinations.js';
 import { primeSecretScrubber, scrubDeep, scrubText } from './secrets/scrub.js';
 import { compileJsonSchema } from './json-schema.js';
 import { parsePluginAuthor } from './plugin/author.js';
+import { PluginCallRefusal, exportsProblem, readinessOf } from './plugin/requires.js';
+import { satisfiesRange } from './semver.js';
 /** Tiers this build executes directly, with no human in the loop. */
 export const EXECUTABLE_TIERS = ['auto'];
 /** Tiers that become an action and wait for the owner. */
@@ -185,6 +188,15 @@ export function toolInputSchema(tool, plugin) {
         `${describeSchema(schema)}. Tool inputs must be an object schema (or a union of ` +
         `object schemas) — every model provider requires it.`);
 }
+/** How long a plugin's setup answer or an export call may take. */
+export const PLUGIN_CALL_TIMEOUT_MS = 5_000;
+function withinMs(work, ms, what) {
+    let timer;
+    const late = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new PluginCallRefusal(`${what} did not answer within ${Math.round(ms / 1000)} seconds.`)), ms);
+    });
+    return Promise.race([work, late]).finally(() => clearTimeout(timer));
+}
 export class ToolRegistry {
     #tools = new Map();
     #manifests = new Map();
@@ -194,6 +206,8 @@ export class ToolRegistry {
     #pageTools = new Map();
     /** Per plugin, the metrics `parseMetrics` checked and made strict. */
     #metrics = new Map();
+    /** Per plugin, the widgets `parseWidgets` checked, refresh made concrete. */
+    #widgets = new Map();
     /** Per plugin, what its `ctx.buddi` is bound to (docs/plugin-host-api.md §3). */
     #bindings = new Map();
     /**
@@ -251,6 +265,19 @@ export class ToolRegistry {
         const metrics = manifest.metrics === undefined
             ? undefined
             : parseMetrics(manifest.name, manifest.metrics, (id) => [...this.#metrics.values()].some((list) => list.some((m) => m.id === id)));
+        // Widgets the same way: a bad id, size or link names the plugin now.
+        const widgets = manifest.widgets === undefined
+            ? undefined
+            : parseWidgets(manifest.name, manifest.widgets, {
+                pages: (manifest.pages ?? []).map((p) => p.id),
+                taken: (id) => [...this.#widgets.values()].some((list) => list.some((w) => w.id === id)),
+            });
+        const exported = exportsProblem(manifest.name, manifest.exports);
+        if (exported !== undefined)
+            throw new Error(exported);
+        if (manifest.setup !== undefined && typeof manifest.setup?.produce !== 'function') {
+            throw new Error(`plugin ${manifest.name}: setup needs a \`produce(ctx)\` answering { ready, note?, page? }`);
+        }
         if (manifest.files !== undefined) {
             const names = new Set((manifest.queries ?? []).map((q) => q.name));
             for (const [role, name] of Object.entries(manifest.files)) {
@@ -272,6 +299,7 @@ export class ToolRegistry {
             unregister: (names) => this.#removeRuntimeTools(manifest.name, names),
             registered: () => [...this.#tools.values()].filter((e) => e.plugin === manifest.name && e.runtime).map((e) => e.tool.name),
         };
+        binding.callExport = (target, name, args, facts) => this.#callExport(manifest.name, target, name, args, facts);
         this.#bindings.set(manifest.name, binding);
         if (metrics) {
             this.#metrics.set(manifest.name, metrics.map((metric) => ({
@@ -279,6 +307,22 @@ export class ToolRegistry {
                 measure: (params, ctx) => metric.measure(params, this.#host(manifest.name, ctx)),
             })));
         }
+        if (widgets && widgets.length > 0) {
+            this.#widgets.set(manifest.name, widgets.map((widget) => ({
+                ...widget,
+                // Read-only, like a metric: the plugin's db is the page query's pool.
+                produce: (ctx, request) => widget.produce(this.#host(manifest.name, metricContext(ctx)), request),
+                // A setting's choices read when the sheet opens: the same host, the same read-only pool.
+                options: async (key, ctx) => {
+                    const field = widget.settings?.find((f) => f.key === key);
+                    if (!field || (field.kind !== 'select' && field.kind !== 'multiselect'))
+                        return [];
+                    if (Array.isArray(field.options))
+                        return field.options;
+                    return field.options(this.#host(manifest.name, metricContext(ctx)));
+                },
+            })));
+        }
         if (contributions) {
             this.#pages.set(manifest.name, contributions.pages);
             this.#queries.set(manifest.name, contributions.queries.map((query) => ({
@@ -315,6 +359,7 @@ export class ToolRegistry {
         this.#queries.delete(plugin);
         this.#pageTools.delete(plugin);
         this.#metrics.delete(plugin);
+        this.#widgets.delete(plugin);
         const binding = this.#bindings.get(plugin);
         this.#bindings.delete(plugin);
         if (binding !== undefined)
@@ -568,6 +613,84 @@ export class ToolRegistry {
                 return m.name;
         return undefined;
     }
+    /**
+     * Whether `plugin` can do anything yet (host API 1.18): its `setup` answer,
+     * on the read-only pool, within `timeoutMs`. Undefined when the plugin is
+     * not registered or declares no setup — it is simply loaded. A setup that
+     * throws, times out or answers nonsense rejects; the caller decides what
+     * that means (the Plugins page shows the plugin as loaded and logs it).
+     */
+    async readiness(plugin, ctx, timeoutMs = PLUGIN_CALL_TIMEOUT_MS) {
+        const manifest = this.#manifests.get(plugin);
+        if (manifest?.setup === undefined)
+            return undefined;
+        const raw = await withinMs(Promise.resolve().then(() => manifest.setup.produce(this.#host(plugin, metricContext(ctx)))), timeoutMs, `${plugin}'s setup`);
+        const answer = readinessOf(raw, (manifest.pages ?? []).map((p) => p.id));
+        if (answer === undefined)
+            throw new Error(`${plugin}'s setup answered something that is not { ready, note?, page? }`);
+        return answer;
+    }
+    /**
+     * The host binding this registry made for `plugin`: the one whose
+     * `plugins.call`, `tools` and runtime network a context outside a tool —
+     * a source, a watcher, a sentinel — must share to act as the same plugin.
+     */
+    hostBinding(plugin) {
+        return this.#bindings.get(plugin);
+    }
+    /** The plugins `plugin` requires, with their ranges; empty when none or not registered. */
+    requiresOf(plugin) {
+        return this.#bindings.get(plugin)?.requires ?? {};
+    }
+    /**
+     * One plugin calling another's export (`ctx.buddi.plugins.call`). Every
+     * refusal is core's: the target must be in the caller's `requires`,
+     * registered here at a version in range, and export that name; the
+     * arguments pass the export's own parameters; it runs with the target's
+     * own host over the read-only pool, within the timeout. Never a tool.
+     */
+    async #callExport(caller, target, name, args, facts) {
+        const range = this.#bindings.get(caller)?.requires[target];
+        if (range === undefined) {
+            throw new PluginCallRefusal(`${caller} may call only the plugins it requires, and ${target} is not one of them.`);
+        }
+        const manifest = this.#manifests.get(target);
+        if (manifest === undefined)
+            throw new PluginCallRefusal(`${target} is not loaded, so ${caller} cannot call it.`);
+        if (satisfiesRange(manifest.version, range) !== true) {
+            throw new PluginCallRefusal(`${caller} needs ${target} ${range}, and ${manifest.version} is installed.`);
+        }
+        const exported = Object.prototype.hasOwnProperty.call(manifest.exports ?? {}, name) ? manifest.exports[name] : undefined;
+        if (exported === undefined) {
+            const names = Object.keys(manifest.exports ?? {});
+            throw new PluginCallRefusal(`${target} exports no ${JSON.stringify(name)}${names.length === 0 ? '; it exports nothing' : `; it exports ${names.join(', ')}`}.`);
+        }
+        const parsed = exported.params.safeParse(args);
+        if (!parsed.success) {
+            throw new PluginCallRefusal(`${target}.${name}: ${parsed.error.issues.map((i) => `${i.path.join('.') || 'arguments'}: ${i.message}`).join('; ')}`);
+        }
+        const ctx = { ...facts, agentId: OWNER_AGENT_ID };
+        // The target's host with only its reading parts: the caller must not reach
+        // the target's schedule, notices, tools or other effects through it.
+        const exportCtx = () => {
+            const hosted = this.#host(target, metricContext(ctx));
+            return hosted.buddi ? { ...hosted, buddi: readOnlyHostOf(hosted.buddi, `${target}.${name}`) } : hosted;
+        };
+        return withinMs(Promise.resolve().then(() => exported.produce(parsed.data, exportCtx())), PLUGIN_CALL_TIMEOUT_MS, `${target}.${name}`);
+    }
+    /** Every widget the installed plugins export, each carrying its plugin, in registration order. */
+    widgets() {
+        return [...this.#widgets.values()].flat();
+    }
+    /** One widget by its id, or undefined. */
+    widget(id) {
+        for (const list of this.#widgets.values()) {
+            const found = list.find((w) => w.id === id);
+            if (found)
+                return found;
+        }
+        return undefined;
+    }
     /**
      * Every metric the installed plugins contribute, each carrying its plugin,
      * in registration order. The model of `home()`: this is what `goal.metrics`
@@ -649,7 +772,15 @@ export class ToolRegistry {
             execute: (input, ctx) => tool.execute(input, host(ctx)),
         };
     }
-    async invoke(name, rawArgs, caller) {
+    async invoke(name, rawArgs, caller, 
+    /**
+     * `askOnly`: this caller may record an approval and nothing more — a call
+     * whose tier would run it here (`auto`, `session`) is refused unrun. An
+     * owner API token acting through a plugin page is such a caller: it acts
+     * as the owner, so an `auto` or `ownerOnly` tool would otherwise store a
+     * secret or a standing rule with no person at the dashboard.
+     */
+    opts = {}) {
         caller.signal?.throwIfAborted();
         const entry = this.#tools.get(name);
         if (!entry) {
@@ -765,6 +896,9 @@ export class ToolRegistry {
             return { ok: false, reason: 'session-not-authorized',
                 message: 'This tool requires a current owner request and an explicit agent grant; ask the owner directly.' };
         }
+        if (opts.askOnly === true && !GATED_TIERS.includes(tier)) {
+            return { ok: false, reason: 'ask-only', message: `${name} would run without an approval, and this caller may only ask.` };
+        }
         if (GATED_TIERS.includes(tier)) {
             if (tool.reusableApproval && (ctx.delegationDepth ?? 0) > 0) {
                 return { ok: false, reason: 'tool-error', message: 'Host execution requires a direct owner conversation; delegates do not inherit host permissions.' };