@tangle-network/agent-interface 2.4.0 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -10,6 +10,10 @@ export declare const agentCandidateKnowledgeSchema: z.ZodObject<{
10
10
  evidenceHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
11
11
  promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
12
12
  }, z.core.$strict>;
13
+ stateScope: z.ZodOptional<z.ZodObject<{
14
+ pagesDirectory: z.ZodString;
15
+ researchState: z.ZodBoolean;
16
+ }, z.core.$strict>>;
13
17
  snapshot: z.ZodObject<{
14
18
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
15
19
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -1,6 +1,6 @@
1
1
  import { z } from "zod";
2
2
  import { agentCandidateArtifactRefSchema, agentCandidateCapturedArtifactSchema, agentCandidateWorkspaceSnapshotEvidenceSchema, } from "./agent-candidate-artifact-schema.js";
3
- import { addDuplicateIssues, sha256DigestSchema, } from "./agent-candidate-schema-common.js";
3
+ import { addDuplicateIssues, isSafeRelativePath, sha256DigestSchema, } from "./agent-candidate-schema-common.js";
4
4
  export const agentCandidateKnowledgeSchema = z
5
5
  .object({
6
6
  candidate: z
@@ -15,6 +15,15 @@ export const agentCandidateKnowledgeSchema = z
15
15
  promotionPlanHash: sha256DigestSchema,
16
16
  })
17
17
  .strict(),
18
+ stateScope: z
19
+ .object({
20
+ pagesDirectory: z
21
+ .string()
22
+ .refine((value) => isSafeRelativePath(value, false), "pagesDirectory must be a canonical workspace-relative directory"),
23
+ researchState: z.boolean(),
24
+ })
25
+ .strict()
26
+ .optional(),
18
27
  snapshot: agentCandidateWorkspaceSnapshotEvidenceSchema,
19
28
  retrievalConfig: agentCandidateCapturedArtifactSchema.optional(),
20
29
  evaluation: agentCandidateCapturedArtifactSchema,
@@ -724,6 +724,10 @@ export declare const agentCandidateExperimentSchema: z.ZodObject<{
724
724
  evidenceHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
725
725
  promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
726
726
  }, z.core.$strict>;
727
+ stateScope: z.ZodOptional<z.ZodObject<{
728
+ pagesDirectory: z.ZodString;
729
+ researchState: z.ZodBoolean;
730
+ }, z.core.$strict>>;
727
731
  snapshot: z.ZodObject<{
728
732
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
729
733
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -1557,6 +1561,10 @@ export declare const agentCandidateExperimentSchema: z.ZodObject<{
1557
1561
  evidenceHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1558
1562
  promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1559
1563
  }, z.core.$strict>;
1564
+ stateScope: z.ZodOptional<z.ZodObject<{
1565
+ pagesDirectory: z.ZodString;
1566
+ researchState: z.ZodBoolean;
1567
+ }, z.core.$strict>>;
1560
1568
  snapshot: z.ZodObject<{
1561
1569
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
1562
1570
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -4313,6 +4321,10 @@ export declare const agentImprovementMeasuredComparisonSchema: z.ZodObject<{
4313
4321
  evidenceHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
4314
4322
  promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
4315
4323
  }, z.core.$strict>;
4324
+ stateScope: z.ZodOptional<z.ZodObject<{
4325
+ pagesDirectory: z.ZodString;
4326
+ researchState: z.ZodBoolean;
4327
+ }, z.core.$strict>>;
4316
4328
  snapshot: z.ZodObject<{
4317
4329
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
4318
4330
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -5146,6 +5158,10 @@ export declare const agentImprovementMeasuredComparisonSchema: z.ZodObject<{
5146
5158
  evidenceHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
5147
5159
  promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
5148
5160
  }, z.core.$strict>;
5161
+ stateScope: z.ZodOptional<z.ZodObject<{
5162
+ pagesDirectory: z.ZodString;
5163
+ researchState: z.ZodBoolean;
5164
+ }, z.core.$strict>>;
5149
5165
  snapshot: z.ZodObject<{
5150
5166
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
5151
5167
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -9332,6 +9348,10 @@ export declare const agentImprovementProposalSchema: z.ZodObject<{
9332
9348
  evidenceHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
9333
9349
  promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
9334
9350
  }, z.core.$strict>;
9351
+ stateScope: z.ZodOptional<z.ZodObject<{
9352
+ pagesDirectory: z.ZodString;
9353
+ researchState: z.ZodBoolean;
9354
+ }, z.core.$strict>>;
9335
9355
  snapshot: z.ZodObject<{
9336
9356
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
9337
9357
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -10165,6 +10185,10 @@ export declare const agentImprovementProposalSchema: z.ZodObject<{
10165
10185
  evidenceHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
10166
10186
  promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
10167
10187
  }, z.core.$strict>;
10188
+ stateScope: z.ZodOptional<z.ZodObject<{
10189
+ pagesDirectory: z.ZodString;
10190
+ researchState: z.ZodBoolean;
10191
+ }, z.core.$strict>>;
10168
10192
  snapshot: z.ZodObject<{
10169
10193
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
10170
10194
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -728,6 +728,10 @@ export declare const agentCandidateBundleSchema: z.ZodObject<{
728
728
  evidenceHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
729
729
  promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
730
730
  }, z.core.$strict>;
731
+ stateScope: z.ZodOptional<z.ZodObject<{
732
+ pagesDirectory: z.ZodString;
733
+ researchState: z.ZodBoolean;
734
+ }, z.core.$strict>>;
731
735
  snapshot: z.ZodObject<{
732
736
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
733
737
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -227,8 +227,15 @@ export interface AgentCandidateKnowledgeRef {
227
227
  evidenceHash: Sha256Digest;
228
228
  promotionPlanHash: Sha256Digest;
229
229
  }
230
+ /** Canonical selection of knowledge state included in the candidate hash. */
231
+ export interface AgentCandidateKnowledgeStateScope {
232
+ pagesDirectory: string;
233
+ researchState: boolean;
234
+ }
230
235
  export interface AgentCandidateKnowledge {
231
236
  candidate: AgentCandidateKnowledgeRef;
237
+ /** Absent scopes retain the knowledge provider's default selection. */
238
+ stateScope?: AgentCandidateKnowledgeStateScope;
232
239
  snapshot: AgentCandidateWorkspaceSnapshotEvidence;
233
240
  retrievalConfig?: AgentCandidateCapturedArtifact;
234
241
  evaluation: AgentCandidateCapturedArtifact;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tangle-network/agent-interface",
3
- "version": "2.4.0",
3
+ "version": "2.5.0",
4
4
  "type": "module",
5
5
  "sideEffects": false,
6
6
  "license": "MIT",