@zhivex-ai/harness 1.1.1 → 1.2.0-rc.13

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.
Files changed (119) hide show
  1. package/CHANGELOG.md +160 -0
  2. package/README.md +14 -7
  3. package/SECURITY.md +1 -1
  4. package/SUPPORT.md +3 -3
  5. package/benchmarks/README.md +17 -0
  6. package/contracts/public-api.json +95 -5
  7. package/contracts/stable-api-signatures.json +38 -38
  8. package/dist/acp-cli.d.ts +2 -0
  9. package/dist/acp-cli.js +15938 -0
  10. package/dist/cli/arguments.d.ts +7 -1
  11. package/dist/cli/cli-credentials.d.ts +6 -1
  12. package/dist/cli/cli-options.d.ts +1 -1
  13. package/dist/cli/cli-profiles.d.ts +15 -0
  14. package/dist/cli/cli-stream.d.ts +3 -3
  15. package/dist/cli/console/console-budget.d.ts +9 -0
  16. package/dist/cli/console/console-commands.d.ts +3 -3
  17. package/dist/cli/console/console-compaction.d.ts +18 -0
  18. package/dist/cli/console/console-input.d.ts +22 -3
  19. package/dist/cli/console/console-navigation.d.ts +3 -0
  20. package/dist/cli/console/console-presentation.d.ts +9 -2
  21. package/dist/cli/console/console-progress.d.ts +6 -0
  22. package/dist/cli/console/console-reasoning.d.ts +3 -0
  23. package/dist/cli/doctor.d.ts +2 -2
  24. package/dist/cli/presentation.d.ts +8 -1
  25. package/dist/cli/qwen-connection.d.ts +23 -0
  26. package/dist/cli/run-document.d.ts +4 -4
  27. package/dist/cli/terminal/activity-history.d.ts +15 -0
  28. package/dist/cli/terminal/session-grants.d.ts +4 -0
  29. package/dist/cli/terminal/terminal-markdown.d.ts +7 -4
  30. package/dist/cli/terminal/terminal-table.d.ts +6 -0
  31. package/dist/cli/terminal/terminal-ui.d.ts +3 -0
  32. package/dist/cli/terminal/tool-activity.d.ts +21 -10
  33. package/dist/cli/tool-execution.d.ts +1 -0
  34. package/dist/cli-3jmy4h5h.js +5798 -0
  35. package/dist/cli-entry-1bx83sw4.js +4 -0
  36. package/dist/cli-entry-427869g9.js +2009 -0
  37. package/dist/cli-entry-64pdp3k5.js +17 -0
  38. package/dist/cli-entry-b1mfvmxe.js +376 -0
  39. package/dist/cli-entry-c2f58zj2.js +13602 -0
  40. package/dist/cli-entry.d.ts +2 -0
  41. package/dist/cli.d.ts +1 -0
  42. package/dist/cli.js +15 -19168
  43. package/dist/client/acp-stdio.d.ts +9 -0
  44. package/dist/client/acp.d.ts +18 -0
  45. package/dist/client/index.d.ts +2 -0
  46. package/dist/client/json-contracts.d.ts +22 -8
  47. package/dist/config-1k9t4jhh.js +59 -0
  48. package/dist/context/adaptive-compaction.d.ts +2 -0
  49. package/dist/context/compaction.d.ts +3 -1
  50. package/dist/context/qwen-reasoning.d.ts +5 -0
  51. package/dist/context/scoped-context.d.ts +61 -0
  52. package/dist/context/semantic-compaction.d.ts +21 -0
  53. package/dist/context/task-memory.d.ts +13 -8
  54. package/dist/execution/execution-environment.d.ts +5 -0
  55. package/dist/execution/oci-observability.d.ts +2 -0
  56. package/dist/execution/patch-diagnostics.d.ts +6 -0
  57. package/dist/hostile-repository-demo.js +4614 -1930
  58. package/dist/index.d.ts +13 -1
  59. package/dist/index.js +16435 -12486
  60. package/dist/integrations/mcp.d.ts +23 -3
  61. package/dist/models/catalog.d.ts +76 -0
  62. package/dist/models/compaction-recommendations.d.ts +28 -0
  63. package/dist/models/sdk-catalog-adapter.d.ts +7 -0
  64. package/dist/persistence/operations.d.ts +10 -6
  65. package/dist/persistence/state-backup-stream.d.ts +4 -0
  66. package/dist/persistence/state-backup.d.ts +52 -0
  67. package/dist/persistence/state-gitignore.d.ts +2 -0
  68. package/dist/persistence/workspace-checkpoints.d.ts +149 -0
  69. package/dist/providers/meta-continuation.d.ts +1 -1
  70. package/dist/providers/meta-errors.d.ts +2 -0
  71. package/dist/providers/meta-replay.d.ts +2 -0
  72. package/dist/providers/qwen-context.d.ts +2 -0
  73. package/dist/providers/qwen-hosted-policy.d.ts +5 -0
  74. package/dist/providers/reasoning.d.ts +18 -0
  75. package/dist/runtime/config.d.ts +12 -3
  76. package/dist/runtime/context-runtime.d.ts +12 -0
  77. package/dist/runtime/error-diagnostics.d.ts +641 -0
  78. package/dist/runtime/harness.d.ts +13 -4
  79. package/dist/runtime/model-edit-references.d.ts +8 -0
  80. package/dist/runtime/oci-delivery.d.ts +17 -0
  81. package/dist/runtime/progress-monitor.d.ts +33 -0
  82. package/dist/runtime/provider-diagnostics.d.ts +35 -0
  83. package/dist/runtime/runtime-checkpoints.d.ts +3 -0
  84. package/dist/runtime/runtime-diagnostics.d.ts +5 -5
  85. package/dist/runtime/runtime-policy.d.ts +14 -6
  86. package/dist/runtime/time-to-safe-fix.d.ts +308 -1
  87. package/dist/runtime/tool-execution.d.ts +11 -0
  88. package/dist/runtime/tool-policy.d.ts +55 -0
  89. package/dist/runtime/tool-scheduling.d.ts +5 -0
  90. package/dist/runtime/usage-ledger.d.ts +1 -0
  91. package/dist/service-cli.js +9422 -6622
  92. package/dist/service-client-cli-yx56n0hc.js +1086 -0
  93. package/dist/tools/dependency-read.d.ts +63 -0
  94. package/dist/tools/execution.d.ts +8 -8
  95. package/dist/tools/workspace.d.ts +31 -15
  96. package/dist/verify-historical-migrations.js +5272 -2437
  97. package/dist/workspace/file-security.d.ts +6 -0
  98. package/dist/zhx.js +15 -19168
  99. package/docs/ACP.md +55 -0
  100. package/docs/CLI.md +292 -29
  101. package/docs/CONTEXT_ENGINEERING.md +184 -20
  102. package/docs/CREDENTIALS.md +38 -6
  103. package/docs/DURABLE_OPERATIONS.md +10 -0
  104. package/docs/EXTENSIBILITY.md +101 -4
  105. package/docs/FIRST_USE.md +7 -5
  106. package/docs/MODEL_CATALOG.md +52 -1
  107. package/docs/README.md +1 -0
  108. package/docs/REPOSITORY_EDITING.md +42 -0
  109. package/docs/STABILITY.md +2 -0
  110. package/docs/SUPPORT_MATRIX_1_1.md +17 -0
  111. package/docs/USAGE.md +9 -0
  112. package/docs/WORKSPACE_CHECKPOINTS.md +27 -0
  113. package/docs/images/cli-conversation.png +0 -0
  114. package/docs/support-matrix-1.1.json +29 -0
  115. package/evaluations/golden-expectations.json +5 -0
  116. package/evaluations/representative-assembly-matrix.json +145 -1
  117. package/evaluations/representative-repositories-v2.jsonl +7 -0
  118. package/examples/README.md +2 -2
  119. package/package.json +19 -13
@@ -0,0 +1,63 @@
1
+ import { z } from "zod";
2
+ export declare const dependencyReadSchema: z.ZodObject<{
3
+ package: z.ZodString;
4
+ action: z.ZodDefault<z.ZodEnum<{
5
+ list: "list";
6
+ read: "read";
7
+ search: "search";
8
+ }>>;
9
+ file: z.ZodDefault<z.ZodString>;
10
+ path: z.ZodDefault<z.ZodString>;
11
+ query: z.ZodOptional<z.ZodString>;
12
+ recursive: z.ZodDefault<z.ZodBoolean>;
13
+ caseSensitive: z.ZodDefault<z.ZodBoolean>;
14
+ startLine: z.ZodDefault<z.ZodNumber>;
15
+ limit: z.ZodDefault<z.ZodNumber>;
16
+ offset: z.ZodDefault<z.ZodNumber>;
17
+ }, z.core.$strip>;
18
+ type DependencyInput = z.input<typeof dependencyReadSchema>;
19
+ type DependencyReadResult = {
20
+ package: string;
21
+ file: string;
22
+ startLine: number;
23
+ content: string;
24
+ digest: string;
25
+ truncated: boolean;
26
+ };
27
+ type DependencyPage = {
28
+ package: string;
29
+ path: string;
30
+ skippedFiles: number;
31
+ truncated: boolean;
32
+ nextOffset: number | null;
33
+ notice?: string;
34
+ };
35
+ type DependencyListResult = DependencyPage & {
36
+ action: "list";
37
+ entries: {
38
+ path: string;
39
+ type: "file" | "directory";
40
+ }[];
41
+ };
42
+ type DependencySearchResult = DependencyPage & {
43
+ action: "search";
44
+ matches: {
45
+ file: string;
46
+ line: number;
47
+ text: string;
48
+ }[];
49
+ };
50
+ type DependencyResult = DependencyReadResult | DependencyListResult | DependencySearchResult;
51
+ /** Dedicated read-only package boundary. Reads never execute source, follow links,
52
+ * enter nested dependencies or expose hidden files. Content reads are descriptor-bound. */
53
+ export declare function readDependency(root: string, input: DependencyInput & {
54
+ action?: "read";
55
+ }): Promise<DependencyReadResult>;
56
+ export declare function readDependency(root: string, input: DependencyInput & {
57
+ action: "list";
58
+ }): Promise<DependencyListResult>;
59
+ export declare function readDependency(root: string, input: DependencyInput & {
60
+ action: "search";
61
+ }): Promise<DependencySearchResult>;
62
+ export declare function readDependency(root: string, input: DependencyInput): Promise<DependencyResult>;
63
+ export {};
@@ -4,13 +4,13 @@ import { Workspace } from "../workspace/workspace.js";
4
4
  export declare const createExecutionEnvironmentTools: (workspace: Workspace, execution?: Extract<HarnessConfig["execution"], {
5
5
  backend: "oci";
6
6
  }>) => {
7
- run_environment_command: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
7
+ run_environment_command: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
8
8
  command: z.ZodEnum<{
9
9
  [x: string]: string;
10
10
  }> | z.ZodString;
11
11
  args: z.ZodDefault<z.ZodArray<z.ZodString>>;
12
12
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
13
- run_environment_batch: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
13
+ run_environment_batch: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
14
14
  commands: z.ZodArray<z.ZodObject<{
15
15
  command: z.ZodEnum<{
16
16
  [x: string]: string;
@@ -18,22 +18,22 @@ export declare const createExecutionEnvironmentTools: (workspace: Workspace, exe
18
18
  args: z.ZodDefault<z.ZodArray<z.ZodString>>;
19
19
  }, z.core.$strict>>;
20
20
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
21
- run_environment_shell?: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
21
+ run_environment_shell?: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
22
22
  script: z.ZodString;
23
23
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
24
- environment_status: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{}, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
25
- inspect_environment_patch: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{}, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
26
- apply_environment_patch: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
24
+ environment_status: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
25
+ inspect_environment_patch: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
26
+ apply_environment_patch: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
27
27
  patchId: z.ZodString;
28
28
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
29
- verify_and_apply_environment_patch: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
29
+ verify_and_apply_environment_patch: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
30
30
  patchId: z.ZodString;
31
31
  command: z.ZodEnum<{
32
32
  [x: string]: string;
33
33
  }> | z.ZodString;
34
34
  args: z.ZodDefault<z.ZodArray<z.ZodString>>;
35
35
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
36
- verify_and_apply_reviewed_edits: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
36
+ verify_and_apply_reviewed_edits: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
37
37
  changes: z.ZodArray<z.ZodObject<{
38
38
  path: z.ZodString;
39
39
  expectedDigest: z.ZodNullable<z.ZodString>;
@@ -1,32 +1,48 @@
1
1
  import { z } from "zod";
2
2
  import { Workspace } from "../workspace/workspace.js";
3
3
  export declare const createWorkspaceTools: (workspace: Workspace, allowedChecks: readonly string[]) => {
4
- list_files: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
4
+ read_dependency: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
5
+ package: z.ZodString;
6
+ action: z.ZodDefault<z.ZodEnum<{
7
+ list: "list";
8
+ read: "read";
9
+ search: "search";
10
+ }>>;
11
+ file: z.ZodDefault<z.ZodString>;
12
+ path: z.ZodDefault<z.ZodString>;
13
+ query: z.ZodOptional<z.ZodString>;
14
+ recursive: z.ZodDefault<z.ZodBoolean>;
15
+ caseSensitive: z.ZodDefault<z.ZodBoolean>;
16
+ startLine: z.ZodDefault<z.ZodNumber>;
17
+ limit: z.ZodDefault<z.ZodNumber>;
18
+ offset: z.ZodDefault<z.ZodNumber>;
19
+ }, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
20
+ list_files: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
5
21
  path: z.ZodDefault<z.ZodString>;
6
22
  limit: z.ZodDefault<z.ZodNumber>;
7
23
  includeDigests: z.ZodDefault<z.ZodBoolean>;
8
24
  cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
9
25
  }, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
10
- read_file: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
26
+ read_file: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
11
27
  path: z.ZodString;
12
28
  startLine: z.ZodDefault<z.ZodNumber>;
13
29
  endLine: z.ZodOptional<z.ZodNumber>;
14
30
  }, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
15
- read_files: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
31
+ read_files: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
16
32
  files: z.ZodArray<z.ZodObject<{
17
33
  path: z.ZodString;
18
34
  startLine: z.ZodDefault<z.ZodNumber>;
19
35
  endLine: z.ZodOptional<z.ZodNumber>;
20
36
  }, z.core.$strip>>;
21
37
  }, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
22
- search_files: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
38
+ search_files: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
23
39
  query: z.ZodString;
24
40
  path: z.ZodDefault<z.ZodString>;
25
41
  caseSensitive: z.ZodDefault<z.ZodBoolean>;
26
42
  limit: z.ZodDefault<z.ZodNumber>;
27
43
  cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
28
44
  }, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
29
- search_many: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
45
+ search_many: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
30
46
  queries: z.ZodArray<z.ZodObject<{
31
47
  query: z.ZodString;
32
48
  caseSensitive: z.ZodDefault<z.ZodBoolean>;
@@ -34,14 +50,14 @@ export declare const createWorkspaceTools: (workspace: Workspace, allowedChecks:
34
50
  path: z.ZodDefault<z.ZodString>;
35
51
  limitPerQuery: z.ZodDefault<z.ZodNumber>;
36
52
  }, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
37
- propose_edits: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
53
+ propose_edits: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
38
54
  changes: z.ZodArray<z.ZodObject<{
39
55
  path: z.ZodString;
40
56
  expectedDigest: z.ZodNullable<z.ZodString>;
41
57
  content: z.ZodString;
42
58
  }, z.core.$strict>>;
43
59
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
44
- apply_patch: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
60
+ apply_patch: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
45
61
  proposalId: z.ZodString;
46
62
  changes: z.ZodArray<z.ZodObject<{
47
63
  path: z.ZodString;
@@ -49,37 +65,37 @@ export declare const createWorkspaceTools: (workspace: Workspace, allowedChecks:
49
65
  content: z.ZodString;
50
66
  }, z.core.$strict>>;
51
67
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
52
- apply_reviewed_replacement: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
68
+ apply_reviewed_replacement: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
53
69
  path: z.ZodString;
54
70
  expectedDigest: z.ZodString;
55
71
  oldText: z.ZodString;
56
72
  newText: z.ZodString;
57
73
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
58
- apply_reviewed_edits: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
74
+ apply_reviewed_edits: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
59
75
  changes: z.ZodArray<z.ZodObject<{
60
76
  path: z.ZodString;
61
77
  expectedDigest: z.ZodNullable<z.ZodString>;
62
78
  content: z.ZodString;
63
79
  }, z.core.$strict>>;
64
80
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
65
- move_file: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
81
+ move_file: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
66
82
  source: z.ZodString;
67
83
  destination: z.ZodString;
68
84
  expectedDigest: z.ZodString;
69
85
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
70
- quarantine_file: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
86
+ quarantine_file: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
71
87
  path: z.ZodString;
72
88
  expectedDigest: z.ZodString;
73
89
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
74
- restore_file: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
90
+ restore_file: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
75
91
  quarantineId: z.ZodString;
76
92
  destination: z.ZodOptional<z.ZodString>;
77
93
  expectedDigest: z.ZodOptional<z.ZodString>;
78
94
  }, z.core.$strict>, import("@zhivex-ai/core").JsonValue, unknown>;
79
- run_check: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{
95
+ run_check: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{
80
96
  check: z.ZodString;
81
97
  expectedScript: z.ZodString;
82
98
  }, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
83
- mutation_audit: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{}, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
84
- git_diff: import("@zhivex-ai/agents").ToolDefinition<z.ZodObject<{}, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
99
+ mutation_audit: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
100
+ git_diff: import("@zhivex-ai/core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, import("@zhivex-ai/core").JsonValue, unknown>;
85
101
  };