@opengeni/contracts 0.50.0 → 1.0.0

package/dist/agent-authored-durable-text.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Budgets and authoring style for durable text an **agent** writes on a user's
+ * behalf.
+ *
+ * The budget follows the cost, and the cost differs per destination:
+ *
+ * - A workspace instruction policy is composed verbatim into the prompt of
+ *   every session it applies to, for as long as it stays active. A global
+ *   charter or global policy applies to every session in the workspace; a role
+ *   policy applies to every session bound to that role. At most three entries
+ *   compose at once (charter, global policy, matching role policy), so the
+ *   storage limit is shared with the human editor; prompt composition retains
+ *   its separate UTF-8 byte bound.
+ * - A preference is cheaper and in a different way: only its short title and
+ *   description descriptors are prompt-composed, while the full content is
+ *   retrieved on demand behind the exact attempt's retrieval handle. Its length
+ *   is therefore retrieval cost, not standing prompt cost.
+ * - Organization identity and mission are always-on context for root sessions
+ *   across the whole organization. Historical company-profile list fields stay
+ *   in the storage contract for compatibility; nonempty values on an already-
+ *   active historical revision remain composed with an explicit compatibility
+ *   label until an organization owner replaces the profile.
+ * - Knowledge is retrieval evidence and never joins the always-composed prefix.
+ *
+ * Instruction writes share the human limit so localized edits can preserve
+ * existing long policies. The other caps bind only agent-authored writes.
+ * The human-facing limits (`PREFERENCE_REGISTRY_CONTENT_MAX_CHARS`, `COMPANY_PROFILE_SCALAR_MAX_CHARS`,
+ * `COMPANY_PROFILE_ENTRY_MAX_CHARS`, `COMPANY_PROFILE_CONTENT_MAX_UTF8_BYTES`)
+ * are unchanged: a person editing in the UI is making a deliberate, visible
+ * choice, and lowering their limit would reject text they already typed.
+ * Existing stored revisions are never rewritten; only new agent writes are
+ * bounded.
+ */
+/** Compatibility export: agents and humans use the same instruction storage limit. */
+export declare const AGENT_AUTHORED_INSTRUCTION_POLICY_CONTENT_MAX_CHARS = 262144;
+/** Retrieved on demand rather than always composed. */
+export declare const AGENT_AUTHORED_PREFERENCE_CONTENT_MAX_CHARS = 1200;
+/** `identity` and `mission`: a couple of sentences, not a positioning document. */
+export declare const AGENT_AUTHORED_COMPANY_PROFILE_SCALAR_MAX_CHARS = 400;
+/** Legacy company-profile list entry bound; retained for stored-revision compatibility. */
+export declare const AGENT_AUTHORED_COMPANY_PROFILE_ENTRY_MAX_CHARS = 200;
+/** Whole canonical compatibility profile; current agent tools submit only identity and mission. */
+export declare const AGENT_AUTHORED_COMPANY_PROFILE_CONTENT_MAX_UTF8_BYTES = 4096;
+export declare const AGENT_AUTHORED_INSTRUCTION_POLICY_CONTENT_TOO_LONG_MESSAGE: string;
+export declare const AGENT_AUTHORED_PREFERENCE_CONTENT_TOO_LONG_MESSAGE: string;
+export declare const AGENT_AUTHORED_COMPANY_PROFILE_TOO_LONG_MESSAGE: string;
+/**
+ * Lane-agnostic guidance for the one `remember` content field, whose schema
+ * bound has to admit the widest lane. Without it an over-long rule would be
+ * refused with a generic "expected length <= 4000" that points at the wrong
+ * number entirely.
+ */
+export declare const AGENT_AUTHORED_REMEMBER_CONTENT_TOO_LONG_MESSAGE: string;
+/**
+ * The shape rule the model reads on every tool that authors a durable *rule or
+ * preference*. Deliberately not reused for the company profile, which is a
+ * descriptive profile rather than an instruction and needs its own wording.
+ */
+export declare const AGENT_AUTHORED_INSTRUCTION_POLICY_STYLE: string;
+export declare const AGENT_AUTHORED_SKILL_STYLE: string;
+/** @deprecated Use the destination-specific instruction or Skill style. */
+export declare const AGENT_AUTHORED_DURABLE_TEXT_STYLE: string;
+/**
+ * Actionable over-budget message including the text the caller actually sent,
+ * so the model can see how far over it is instead of guessing.
+ */
+export declare function agentAuthoredDurableTextTooLongMessage(input: {
+    kind: "instruction_policy" | "preference";
+    actualChars: number;
+}): string;