@app-vitals/agent-admin 0.2.1 → 0.4.0

package/openapi.platform.json

@@ -730,6 +730,15 @@
             ],
             "example": null
           },
+          "runRequestedAt": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time",
+            "example": null,
+            "description": "Set by POST .../run-now; the runtime honours it once while fresh (15 minutes) and run creation with commandVariant run-now clears it."
+          },
           "createdAt": {
             "type": "string",
             "format": "date-time",
@@ -754,6 +763,7 @@
           "name",
           "system",
           "parentCronId",
+          "runRequestedAt",
           "createdAt",
           "updatedAt"
         ]
@@ -1994,6 +2004,127 @@
           "repliedAt"
         ]
       },
+      "CronRunNowResponse": {
+        "type": "object",
+        "properties": {
+          "requestedAt": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2026-10-26T12:00:00.000Z"
+          }
+        },
+        "required": [
+          "requestedAt"
+        ]
+      },
+      "CronRunTranscriptUploadResult": {
+        "type": "object",
+        "properties": {
+          "runId": {
+            "type": "string",
+            "example": "clx1111111111"
+          },
+          "bytes": {
+            "type": "integer",
+            "example": 2048
+          },
+          "truncated": {
+            "type": "boolean",
+            "example": false
+          },
+          "redactions": {
+            "type": "integer",
+            "example": 0
+          }
+        },
+        "required": [
+          "runId",
+          "bytes",
+          "truncated",
+          "redactions"
+        ]
+      },
+      "UploadCronRunTranscriptBody": {
+        "type": "object",
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Claude session id the transcript was read from.",
+            "example": "7c1c8d1e-0000-4000-8000-000000000000"
+          },
+          "body": {
+            "type": "string",
+            "description": "The already-redacted transcript (JSONL text). Over 1 MiB (UTF-8 bytes) is a 413. Never logged."
+          },
+          "truncated": {
+            "type": "boolean",
+            "description": "True when the runtime dropped earlier lines to fit.",
+            "example": false
+          },
+          "redactions": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "How many secrets the runtime redacted.",
+            "example": 0
+          }
+        },
+        "required": [
+          "body",
+          "truncated",
+          "redactions"
+        ]
+      },
+      "CronRunTranscript": {
+        "type": "object",
+        "properties": {
+          "runId": {
+            "type": "string",
+            "example": "clx1111111111"
+          },
+          "cronId": {
+            "type": "string",
+            "example": "clx0987654321"
+          },
+          "sessionId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "example": null
+          },
+          "bytes": {
+            "type": "integer",
+            "example": 2048
+          },
+          "truncated": {
+            "type": "boolean",
+            "example": false
+          },
+          "redactions": {
+            "type": "integer",
+            "example": 0
+          },
+          "createdAt": {
+            "type": "string",
+            "example": "2026-10-26T12:00:00.000Z"
+          },
+          "body": {
+            "type": "string",
+            "description": "Redacted JSONL transcript."
+          }
+        },
+        "required": [
+          "runId",
+          "cronId",
+          "sessionId",
+          "bytes",
+          "truncated",
+          "redactions",
+          "createdAt",
+          "body"
+        ]
+      },
       "PluginWrapper": {
         "type": "object",
         "properties": {
@@ -2895,6 +3026,9 @@
               "deploy": null,
               "dev-task": null
             }
+          },
+          "features": {
+            "$ref": "#/components/schemas/AgentConfigFeatures"
           }
         },
         "required": [
@@ -2932,6 +3066,25 @@
           "plugin"
         ]
       },
+      "AgentConfigFeatures": {
+        "type": "object",
+        "properties": {
+          "transcriptUpload": {
+            "type": "boolean",
+            "description": "True when SHIPWRIGHT_TRANSCRIPT_API_ENABLED is on: the runtime uploads a redacted transcript after each cron run.",
+            "example": false
+          },
+          "repoAccessCheck": {
+            "type": "boolean",
+            "description": "Reserved for the repo-access check (COS-44.1).",
+            "example": false
+          }
+        },
+        "required": [
+          "transcriptUpload",
+          "repoAccessCheck"
+        ]
+      },
       "RuntimeError": {
         "type": "object",
         "properties": {
@@ -4751,6 +4904,245 @@
         }
       }
     },
+    "/agents/{id}/crons/{cronId}/run-now": {
+      "post": {
+        "summary": "Request an immediate run of a cron job",
+        "description": "Asks the agent's runtime to run the cron job once, now, with the job's own stored prompt. Takes no request body (any body is 400). Stamps `runRequestedAt` on the job and writes an AgentCronRunRequest audit row before returning 202; the runtime honours a fresh request (under 15 minutes old) once on its next cron sync. Callers: `*`, `platform.ops`, or the agent's own key. 404 unless SHIPWRIGHT_CRON_RUN_NOW_ENABLED is `enabled`; 409 when the trial-expiry lockdown disabled the cron.",
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "example": "clx1234567890"
+            },
+            "required": true,
+            "name": "id",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "example": "clx0987654321"
+            },
+            "required": true,
+            "name": "cronId",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Run requested",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CronRunNowResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "A request body was sent",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Caller not allowed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Cron not found, or cron run-now disabled",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Cron disabled by lockdown",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/agents/{id}/crons/{cronId}/runs/{runId}/transcript": {
+      "put": {
+        "summary": "Upload a cron run transcript",
+        "description": "Stores (upserts) the runtime's already-redacted session transcript for a cron run, then keeps only the agent's newest 200 transcripts. Callers: the agent's own key, or `*`. `body` over 1 MiB (UTF-8 bytes) is a 413. 404 unless SHIPWRIGHT_TRANSCRIPT_API_ENABLED is `enabled`, or when the run is not owned by the cron/agent.",
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "example": "clx1234567890"
+            },
+            "required": true,
+            "name": "id",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "example": "clx0987654321"
+            },
+            "required": true,
+            "name": "cronId",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "example": "clx1111111111"
+            },
+            "required": true,
+            "name": "runId",
+            "in": "path"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UploadCronRunTranscriptBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Transcript stored",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CronRunTranscriptUploadResult"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Caller not allowed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Run not found, or transcript API disabled",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "413": {
+            "description": "Transcript body over 1 MiB",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      },
+      "get": {
+        "summary": "Get a cron run transcript",
+        "description": "Returns the stored redacted transcript. `*`, `platform.read` and `platform.ops` callers only: an agent key is 403 even for its own runs. Every read writes an AgentTranscriptRead audit row before the response. 404 when SHIPWRIGHT_TRANSCRIPT_API_ENABLED is not `enabled` or no transcript exists.",
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "example": "clx1234567890"
+            },
+            "required": true,
+            "name": "id",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "example": "clx0987654321"
+            },
+            "required": true,
+            "name": "cronId",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "example": "clx1111111111"
+            },
+            "required": true,
+            "name": "runId",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The transcript",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CronRunTranscript"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No transcript, or transcript API disabled",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/agents/{id}/plugins": {
       "post": {
         "summary": "Install a plugin",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@app-vitals/agent-admin",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/app-vitals/agent.git",
@@ -43,7 +43,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.135.0",
-    "@app-vitals/agent-lib": "0.2.1",
+    "@app-vitals/agent-lib": "0.4.0",
     "@hono/zod-openapi": "^1.0.0",
     "@prisma/adapter-pg": "^7.10.0",
     "@prisma/client": "^7.10.0",

package/prisma/client/browser.ts

@@ -112,6 +112,21 @@ export type AgentChatTokenUsageDailyByModel = Prisma.AgentChatTokenUsageDailyByM
  * 
  */
 export type AgentAsk = Prisma.AgentAskModel
+/**
+ * Model AgentCronRunRequest
+ * 
+ */
+export type AgentCronRunRequest = Prisma.AgentCronRunRequestModel
+/**
+ * Model AgentCronRunTranscript
+ * 
+ */
+export type AgentCronRunTranscript = Prisma.AgentCronRunTranscriptModel
+/**
+ * Model AgentTranscriptRead
+ * 
+ */
+export type AgentTranscriptRead = Prisma.AgentTranscriptReadModel
 /**
  * Model AgentGitHubInstallationsSnapshot
  * 

package/prisma/client/client.ts

@@ -136,6 +136,21 @@ export type AgentChatTokenUsageDailyByModel = Prisma.AgentChatTokenUsageDailyByM
  * 
  */
 export type AgentAsk = Prisma.AgentAskModel
+/**
+ * Model AgentCronRunRequest
+ * 
+ */
+export type AgentCronRunRequest = Prisma.AgentCronRunRequestModel
+/**
+ * Model AgentCronRunTranscript
+ * 
+ */
+export type AgentCronRunTranscript = Prisma.AgentCronRunTranscriptModel
+/**
+ * Model AgentTranscriptRead
+ * 
+ */
+export type AgentTranscriptRead = Prisma.AgentTranscriptReadModel
 /**
  * Model AgentGitHubInstallationsSnapshot
  *