@inflexa-ai/harness 0.41.0 → 0.41.2

package/dist/schemas/file-metadata.js

@@ -24,16 +24,16 @@ export const FileMetadataSchema = z
  */
 export const SubmittedFileDescriptionSchema = z.object({
     /** Exact path of the file being described, copied from the prompt's list. */
-    path: z.string(),
-    description: z.string(),
-    dataType: z.string(),
-    format: z.string(),
-    rows: z.number().nullish(),
-    cols: z.number().nullish(),
-    tags: z.array(z.string()).optional(),
-    warnings: z.array(z.string()).optional(),
+    path: z.string().describe("The path of the file, copied exactly from the list of files that the harness gave."),
+    description: z.string().describe("One sentence that says what the file contains. A semantic search of the workspace later finds the file by this text."),
+    dataType: z.string().describe('The semantic type of the data, for example "count matrix" or "QC report".'),
+    format: z.string().describe('The file format, for example "csv", "tsv", "h5ad", or "png".'),
+    rows: z.number().nullish().describe("The count of rows, when you know it."),
+    cols: z.number().nullish().describe("The count of columns, when you know it."),
+    tags: z.array(z.string()).optional().describe("Short labels that help a search find the file."),
+    warnings: z.array(z.string()).optional().describe("Known problems of the file that a reader must know before use."),
 });
 /** Input contract for the `submit_file_metadata` tool. */
 export const SubmitFileMetadataInputSchema = z.object({
-    files: z.array(SubmittedFileDescriptionSchema),
+    files: z.array(SubmittedFileDescriptionSchema).describe("One entry per output file. You can cover the files in one call or in several."),
 });

package/dist/schemas/plan-schemas.d.ts

@@ -11,10 +11,10 @@ export declare const PlanStepSchema: z.ZodObject<{
     context: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     id: z.ZodString;
+    constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
     track: z.ZodString;
     step_type: z.ZodString;
     question: z.ZodString;
-    constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
     acceptance_criteria: z.ZodArray<z.ZodString>;
     caveats: z.ZodOptional<z.ZodArray<z.ZodString>>;
     packages: z.ZodNonOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
@@ -44,10 +44,10 @@ export declare const PlannerPlanSchema: z.ZodObject<{
         context: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
         track: z.ZodString;
         step_type: z.ZodString;
         question: z.ZodString;
-        constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
         acceptance_criteria: z.ZodArray<z.ZodString>;
         caveats: z.ZodOptional<z.ZodArray<z.ZodString>>;
         packages: z.ZodNonOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
@@ -86,10 +86,10 @@ export declare const PlanningAgentOutputSchema: z.ZodObject<{
             context: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
             id: z.ZodString;
+            constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
             track: z.ZodString;
             step_type: z.ZodString;
             question: z.ZodString;
-            constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
             acceptance_criteria: z.ZodArray<z.ZodString>;
             caveats: z.ZodOptional<z.ZodArray<z.ZodString>>;
             packages: z.ZodNonOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;

package/dist/state/init.d.ts

@@ -1,15 +1,16 @@
 /**
  * Cortex state table initialization.
  *
- * Creates `cortex_*` tables on startup using `CREATE TABLE IF NOT EXISTS` +
- * additive `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`. The whole flow is
- * serialized across concurrent replicas with a Postgres advisory lock so
- * simultaneous startups don't race on DDL.
+ * The schema of the `cortex_*` tables is a list of versioned migrations
+ * (`./migrations`), which the Kysely migrator applies. It records each applied
+ * migration in `cortex_migration`, and it serializes concurrent runs with a
+ * Postgres advisory lock. A run with no pending migration runs no DDL, thus it
+ * takes no lock on a Cortex table.
  */
 import type { Pool } from "pg";
 import type { Logger } from "../lib/logger.js";
 /**
- * Initialize Cortex state tables. Safe to call on every startup and across
- * concurrent replicas (advisory lock serializes the init flow).
+ * Apply the pending migrations of the Cortex state tables. Safe to call on every
+ * startup and across concurrent replicas.
  */
 export declare function initCortexState(pool: Pool, injected?: Logger): Promise<void>;