@opengeni/contracts 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -2680,6 +2680,7 @@ declare const Session: z.ZodObject<{
         user: "user";
         agent: "agent";
     }>>;
+    instructions: z.ZodNullable<z.ZodString>;
     resources: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"repository">;
         uri: z.ZodString;
@@ -3587,6 +3588,7 @@ declare const SessionEvent: z.ZodObject<{
 type SessionEvent = z.infer<typeof SessionEvent>;
 declare const CreateSessionRequest: z.ZodObject<{
     initialMessage: z.ZodString;
+    instructions: z.ZodOptional<z.ZodString>;
     resources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"repository">;
         uri: z.ZodString;

package/dist/index.js

@@ -1564,6 +1564,10 @@ var Session = z.object({
   initialMessage: z.string(),
   title: z.string().nullable(),
   titleSource: z.enum(["user", "agent"]).nullable(),
+  // Per-session agent persona/system instructions supplied at create. Org-visible
+  // metadata (exposed like title/goal), never a secret and never a timeline event.
+  // null when the session carried none.
+  instructions: z.string().nullable(),
   resources: z.array(ResourceRef),
   tools: z.array(ToolRef),
   metadata: z.record(z.string(), z.unknown()),
@@ -2090,6 +2094,15 @@ var SessionEvent = z.object({
 });
 var CreateSessionRequest = z.object({
   initialMessage: z.string().min(1),
+  // Per-session agent persona/system instructions (org-visible metadata, NOT a
+  // secret). Rides the SAME system-level instructions channel the per-workspace
+  // agentInstructions rides, composed AFTER the workspace persona so it refines
+  // it for this one session — how a host delivers per-agent-type prompts without
+  // leaking them into the user-visible timeline (it is NEVER emitted as an
+  // event, unlike goal/initialMessage). Trimmed, non-empty. The 32768-char cap
+  // matches the codebase's largest free-form string convention (workspace
+  // environment variable values). Absent ⇒ byte-identical to today.
+  instructions: z.string().trim().min(1).max(32768).optional(),
   resources: z.array(ResourceRef).default([]),
   tools: z.array(ToolRef).default([]),
   metadata: z.record(z.string(), z.unknown()).default({}),