@asc-agent/runtime 0.7.1 → 0.8.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.
@@ -1,4 +1,5 @@
1
1
  import type { CanonicalSnapshot } from '../core/model/entities.ts';
2
+ import type { RemoteFacts } from '../core/execution/remote-review.ts';
2
3
  /** 스레드(Issue/PR/Review 등) 하나의 현재 상태. Drift Guard가 대조하는 값이다. */
3
4
  export type ThreadSnapshot = {
4
5
  reference: string;
@@ -40,6 +41,33 @@ export interface ScmPort {
40
41
  supports?(action: string): boolean;
41
42
  getThread(reference: string): Promise<ThreadSnapshot>;
42
43
  getBaselines(queries: readonly BaselineQuery[]): Promise<CanonicalSnapshot[]>;
44
+ /**
45
+ * 이 행위를 하기 전에 밖에서 읽히는 사실 (0.8.0 §D). **mutation 0** 이다.
46
+ *
47
+ * 판정은 하지 않는다 — 본 것을 그대로 돌려주고, 판정은 Core 의 Remote Review 가 한다.
48
+ * 그래야 사람이 보는 검수와 Agent 가 따르는 검수가 같은 판정이 된다.
49
+ */
50
+ review?(action: ExternalAction): Promise<RemoteFacts>;
51
+ /**
52
+ * 이 행위를 **되돌려 읽을 수 있는가** (0.8.0 보정 P1-2).
53
+ *
54
+ * 읽어 확인할 수 없는 쓰기를 자율 실행 가능한 것으로 광고하지 않기 위한 질문이다.
55
+ * 답하지 않는 통로는 "모른다" 이고, 그때 호출자는 확인했다고 적지 않는다.
56
+ */
57
+ verifies?(action: string): boolean;
58
+ /**
59
+ * 행위 뒤의 되돌려 읽기 (0.8.0 §L·§M·§N). **mutation 0** 이다.
60
+ *
61
+ * 명령이 0 으로 끝났다는 것과 밖에 그것이 있다는 것은 다르다. 여기서 읽은 사실이
62
+ * 기대치와 다르면 호출자는 성공이라고 적지 않는다.
63
+ */
64
+ verify?(action: ExternalAction, result: {
65
+ resultRef: string;
66
+ }): Promise<{
67
+ observed: Record<string, string | undefined>;
68
+ /** 이 통로가 이 행위의 되돌림을 지원하지 않으면 그 사실을 그대로 말한다. */
69
+ unsupported?: boolean;
70
+ }>;
43
71
  /**
44
72
  * 외부 쓰기. Grant를 검증하고 Drift Guard를 통과시킨 Executor만 호출한다 —
45
73
  * Port 자체는 권한을 판단하지 않으므로, 호출 지점이 좁게 유지되는 것이 계약이다.
@@ -212,20 +212,20 @@ export declare const ProjectProfile: z.ZodPipeline<z.ZodEffects<z.ZodUnknown, un
212
212
  resource: z.ZodString;
213
213
  }, "strip", z.ZodTypeAny, {
214
214
  role: string;
215
- adapter: string;
216
215
  resource: string;
216
+ adapter: string;
217
217
  }, {
218
218
  role: string;
219
- adapter: string;
220
219
  resource: string;
220
+ adapter: string;
221
221
  }>, "many">>, {
222
222
  role: string;
223
- adapter: string;
224
223
  resource: string;
224
+ adapter: string;
225
225
  }[] | undefined, {
226
226
  role: string;
227
- adapter: string;
228
227
  resource: string;
228
+ adapter: string;
229
229
  }[] | undefined>;
230
230
  /** 프로젝트 용어를 Core 개념에 붙인다. 사람이 읽는 문서에만 쓰인다. */
231
231
  terminology: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -280,8 +280,8 @@ export declare const ProjectProfile: z.ZodPipeline<z.ZodEffects<z.ZodUnknown, un
280
280
  }> | undefined;
281
281
  bindings?: {
282
282
  role: string;
283
- adapter: string;
284
283
  resource: string;
284
+ adapter: string;
285
285
  }[] | undefined;
286
286
  }, {
287
287
  id: string;
@@ -318,8 +318,8 @@ export declare const ProjectProfile: z.ZodPipeline<z.ZodEffects<z.ZodUnknown, un
318
318
  }> | undefined;
319
319
  bindings?: {
320
320
  role: string;
321
- adapter: string;
322
321
  resource: string;
322
+ adapter: string;
323
323
  }[] | undefined;
324
324
  policy?: {
325
325
  hardDeny?: string[] | undefined;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@asc-agent/runtime",
3
- "version": "0.7.1",
3
+ "version": "0.8.0",
4
4
  "description": "ASC (Agent Session Control) \u2014 local-first human-in-the-loop agent control plane: core, CLI, and adapters",
5
5
  "keywords": [
6
6
  "agent",