@colin999n9/gworld-agent 0.1.0-alpha.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.
Files changed (86) hide show
  1. package/README.md +127 -0
  2. package/dist/cli.d.ts +12 -0
  3. package/dist/cli.js +256 -0
  4. package/dist/cli.js.map +1 -0
  5. package/dist/client-installer.d.ts +20 -0
  6. package/dist/client-installer.js +48 -0
  7. package/dist/client-installer.js.map +1 -0
  8. package/dist/config.d.ts +37 -0
  9. package/dist/config.js +184 -0
  10. package/dist/config.js.map +1 -0
  11. package/dist/data/indexer-client.d.ts +34 -0
  12. package/dist/data/indexer-client.js +172 -0
  13. package/dist/data/indexer-client.js.map +1 -0
  14. package/dist/data/rpc-reader.d.ts +69 -0
  15. package/dist/data/rpc-reader.js +163 -0
  16. package/dist/data/rpc-reader.js.map +1 -0
  17. package/dist/domain.d.ts +204 -0
  18. package/dist/domain.js +2 -0
  19. package/dist/domain.js.map +1 -0
  20. package/dist/errors.d.ts +10 -0
  21. package/dist/errors.js +16 -0
  22. package/dist/errors.js.map +1 -0
  23. package/dist/factory.d.ts +4 -0
  24. package/dist/factory.js +25 -0
  25. package/dist/factory.js.map +1 -0
  26. package/dist/fs.d.ts +3 -0
  27. package/dist/fs.js +35 -0
  28. package/dist/fs.js.map +1 -0
  29. package/dist/generated/abis.d.ts +7446 -0
  30. package/dist/generated/abis.js +4861 -0
  31. package/dist/generated/abis.js.map +1 -0
  32. package/dist/generated/deployments.d.ts +145 -0
  33. package/dist/generated/deployments.js +150 -0
  34. package/dist/generated/deployments.js.map +1 -0
  35. package/dist/generated/protocol.d.ts +165 -0
  36. package/dist/generated/protocol.js +132 -0
  37. package/dist/generated/protocol.js.map +1 -0
  38. package/dist/geometry.d.ts +24 -0
  39. package/dist/geometry.js +31 -0
  40. package/dist/geometry.js.map +1 -0
  41. package/dist/json.d.ts +3 -0
  42. package/dist/json.js +14 -0
  43. package/dist/json.js.map +1 -0
  44. package/dist/mcp/server.d.ts +4 -0
  45. package/dist/mcp/server.js +134 -0
  46. package/dist/mcp/server.js.map +1 -0
  47. package/dist/mcp/stdio.d.ts +2 -0
  48. package/dist/mcp/stdio.js +23 -0
  49. package/dist/mcp/stdio.js.map +1 -0
  50. package/dist/runner/audit-store.d.ts +27 -0
  51. package/dist/runner/audit-store.js +61 -0
  52. package/dist/runner/audit-store.js.map +1 -0
  53. package/dist/runner/file-state.d.ts +7 -0
  54. package/dist/runner/file-state.js +23 -0
  55. package/dist/runner/file-state.js.map +1 -0
  56. package/dist/runner/legal-actions.d.ts +22 -0
  57. package/dist/runner/legal-actions.js +171 -0
  58. package/dist/runner/legal-actions.js.map +1 -0
  59. package/dist/runner/observation.d.ts +12 -0
  60. package/dist/runner/observation.js +47 -0
  61. package/dist/runner/observation.js.map +1 -0
  62. package/dist/runner/policy.d.ts +10 -0
  63. package/dist/runner/policy.js +68 -0
  64. package/dist/runner/policy.js.map +1 -0
  65. package/dist/runner/runtime.d.ts +73 -0
  66. package/dist/runner/runtime.js +236 -0
  67. package/dist/runner/runtime.js.map +1 -0
  68. package/dist/runner/strategy.d.ts +2 -0
  69. package/dist/runner/strategy.js +19 -0
  70. package/dist/runner/strategy.js.map +1 -0
  71. package/dist/runner/transaction-executor.d.ts +58 -0
  72. package/dist/runner/transaction-executor.js +114 -0
  73. package/dist/runner/transaction-executor.js.map +1 -0
  74. package/dist/runner/writer-lock.d.ts +14 -0
  75. package/dist/runner/writer-lock.js +81 -0
  76. package/dist/runner/writer-lock.js.map +1 -0
  77. package/dist/wallet/keystore.d.ts +18 -0
  78. package/dist/wallet/keystore.js +111 -0
  79. package/dist/wallet/keystore.js.map +1 -0
  80. package/dist/wallet/password-store.d.ts +27 -0
  81. package/dist/wallet/password-store.js +118 -0
  82. package/dist/wallet/password-store.js.map +1 -0
  83. package/package.json +41 -0
  84. package/skill/gworld/SKILL.md +58 -0
  85. package/skill/gworld/references/rules.md +33 -0
  86. package/skill/gworld/references/troubleshooting.md +22 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpc-reader.js","sourceRoot":"","sources":["../../src/data/rpc-reader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,204 @@
1
+ export type Address = `0x${string}`;
2
+ export type Hash = `0x${string}`;
3
+ export type PrivateKey = `0x${string}`;
4
+ export type Coord = {
5
+ q: number;
6
+ r: number;
7
+ };
8
+ export type Risk = 'low' | 'medium' | 'high';
9
+ export type AgentSummary = {
10
+ id: bigint;
11
+ owner: Address;
12
+ lifecycle: 'pending' | 'active';
13
+ position: Coord | null;
14
+ territoryCount: bigint;
15
+ pendingRequest?: {
16
+ rng: Address;
17
+ targetBlock: bigint;
18
+ state: 'waiting' | 'spawnable' | 'expired';
19
+ } | null;
20
+ };
21
+ export type TileView = {
22
+ key: bigint;
23
+ coord: Coord;
24
+ activated: boolean;
25
+ ownerAgentId: bigint | null;
26
+ storedDefense: number;
27
+ effectiveDefense: number;
28
+ lastReinforceRound: bigint;
29
+ };
30
+ export type FragmentView = {
31
+ agentId: bigint;
32
+ jobId: bigint;
33
+ phase: 'union' | 'score' | 'classify' | 'apply';
34
+ cursor: bigint;
35
+ sourceRound: bigint;
36
+ sourceTileCount: bigint;
37
+ classifiedDrops: bigint;
38
+ droppedCount: bigint;
39
+ status: 'pending' | 'completed';
40
+ updatedAtBlock: bigint;
41
+ };
42
+ export type MarketOption = {
43
+ index: bigint;
44
+ agentId: bigint | null;
45
+ poolG: bigint;
46
+ };
47
+ export type MarketView = {
48
+ id: bigint;
49
+ sourceAddress: Address;
50
+ writeState: 'current_writable' | 'retired_read_only';
51
+ currentRound: bigint;
52
+ asOfBlock: bigint;
53
+ tileKey: bigint;
54
+ openRound: bigint;
55
+ closeRound: bigint;
56
+ settleRound: bigint;
57
+ status: 'open' | 'closed' | 'settled';
58
+ totalPoolG: bigint;
59
+ options: MarketOption[];
60
+ winningOption: bigint | null;
61
+ winningPoolG: bigint;
62
+ finalOwnerAgentId: bigint | null;
63
+ refundable: boolean;
64
+ apRewardCap: bigint;
65
+ walletPosition: {
66
+ agentId: bigint;
67
+ optionIndex: bigint;
68
+ stakeG: bigint;
69
+ claimed: boolean;
70
+ payoutG: bigint;
71
+ claimedApRewardCap: bigint;
72
+ } | null;
73
+ };
74
+ export type AgentActionState = {
75
+ blockNumber: bigint;
76
+ blockTimestamp: bigint;
77
+ currentRound: bigint;
78
+ owner: Address;
79
+ active: boolean;
80
+ position: Coord | null;
81
+ apBalanceCap: bigint;
82
+ spentThisRoundCap: bigint;
83
+ lastCheckinAt: bigint;
84
+ actionNonce: bigint;
85
+ fragment: {
86
+ jobId: bigint;
87
+ phase: bigint;
88
+ cursor: bigint;
89
+ sourceRound: bigint;
90
+ sourceTileCount: bigint;
91
+ classifiedDrops: bigint;
92
+ };
93
+ };
94
+ export type IndexerSync = {
95
+ state: 'synced' | 'lagging' | 'rebuilding';
96
+ indexedBlock: bigint;
97
+ finalizedBlock: bigint;
98
+ chainHeadBlock: bigint;
99
+ };
100
+ export type Observation = {
101
+ chainId: number;
102
+ wallet: Address;
103
+ round: bigint;
104
+ asOfBlock: bigint;
105
+ sync: IndexerSync;
106
+ walletGBalance: bigint;
107
+ agent: AgentSummary & AgentActionState;
108
+ agents: AgentSummary[];
109
+ tiles: TileView[];
110
+ fragments: FragmentView[];
111
+ markets: MarketView[];
112
+ marketRequest: {
113
+ round: bigint;
114
+ targetBlock: bigint | null;
115
+ marketId: bigint | null;
116
+ state: 'available' | 'too_late' | 'waiting' | 'finalizable' | 'expired' | 'opened';
117
+ updatedAtBlock: bigint;
118
+ };
119
+ };
120
+ export type GameAction = {
121
+ kind: 'checkin';
122
+ agentId: bigint;
123
+ } | {
124
+ kind: 'claim';
125
+ agentId: bigint;
126
+ tileKey: bigint;
127
+ apCostCap: bigint;
128
+ } | {
129
+ kind: 'move';
130
+ agentId: bigint;
131
+ expectedFrom: Coord;
132
+ path: bigint[];
133
+ expectedNonce: bigint;
134
+ apCostCap: bigint;
135
+ } | {
136
+ kind: 'attack';
137
+ agentId: bigint;
138
+ tileKey: bigint;
139
+ apCap: bigint;
140
+ } | {
141
+ kind: 'reinforce';
142
+ agentId: bigint;
143
+ tileKey: bigint;
144
+ apCap: bigint;
145
+ } | {
146
+ kind: 'continueFragmentResolution';
147
+ agentId: bigint;
148
+ maxSteps: bigint;
149
+ } | {
150
+ kind: 'requestMarket';
151
+ } | {
152
+ kind: 'finalizeMarket';
153
+ round: bigint;
154
+ } | {
155
+ kind: 'bet';
156
+ marketId: bigint;
157
+ agentId: bigint;
158
+ optionIndex: bigint;
159
+ amountG: bigint;
160
+ } | {
161
+ kind: 'settleMarket';
162
+ marketId: bigint;
163
+ } | {
164
+ kind: 'claimMarket';
165
+ marketId: bigint;
166
+ };
167
+ export type ActionKind = GameAction['kind'];
168
+ export type LegalAction = {
169
+ actionId: string;
170
+ action: GameAction;
171
+ risk: Risk;
172
+ reason: string;
173
+ chainId: number;
174
+ round: bigint;
175
+ nonce: bigint;
176
+ createdAt: number;
177
+ expiresAt: number;
178
+ };
179
+ export type RunnerPolicy = {
180
+ maxApPerRoundCap: bigint;
181
+ maxGBetPerAction: bigint;
182
+ maxGSpendPerDay: bigint;
183
+ maxTransactionsPerRound: number;
184
+ allowedAgentIds: bigint[];
185
+ allowedActions: ActionKind[];
186
+ autoExecuteRisk: Risk;
187
+ };
188
+ export type TransactionResult = {
189
+ action: ActionKind;
190
+ hashes: Hash[];
191
+ blockNumber: bigint;
192
+ indexing: 'indexed' | 'lagging';
193
+ };
194
+ export type AuditEvent = {
195
+ id: string;
196
+ at: string;
197
+ type: 'decision' | 'simulation' | 'transaction' | 'error' | 'lifecycle' | 'policy';
198
+ actionId?: string;
199
+ action?: ActionKind;
200
+ round?: string;
201
+ amountG?: string;
202
+ status: string;
203
+ detail?: Record<string, unknown>;
204
+ };
package/dist/domain.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=domain.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":""}
@@ -0,0 +1,10 @@
1
+ export type AgentErrorCode = 'config_invalid' | 'wallet_locked' | 'wallet_missing' | 'wallet_corrupt' | 'wrong_chain' | 'rpc_unavailable' | 'indexer_unavailable' | 'indexer_lagging' | 'agent_missing' | 'agent_pending' | 'not_agent_owner' | 'action_not_found' | 'action_expired' | 'action_stale' | 'policy_denied' | 'simulation_failed' | 'transaction_reverted' | 'runner_busy' | 'runner_paused' | 'unsupported' | 'unknown';
2
+ export declare class AgentError extends Error {
3
+ readonly code: AgentErrorCode;
4
+ readonly cause?: unknown;
5
+ constructor(code: AgentErrorCode, message: string, cause?: unknown);
6
+ }
7
+ export declare function sanitizedError(error: unknown): {
8
+ code: AgentErrorCode;
9
+ message: string;
10
+ };
package/dist/errors.js ADDED
@@ -0,0 +1,16 @@
1
+ export class AgentError extends Error {
2
+ code;
3
+ cause;
4
+ constructor(code, message, cause) {
5
+ super(message);
6
+ this.name = 'AgentError';
7
+ this.code = code;
8
+ this.cause = cause;
9
+ }
10
+ }
11
+ export function sanitizedError(error) {
12
+ if (error instanceof AgentError)
13
+ return { code: error.code, message: error.message };
14
+ return { code: 'unknown', message: 'Unexpected GWorld Agent error' };
15
+ }
16
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,KAAK,CAAW;IAEzB,YAAY,IAAoB,EAAE,OAAe,EAAE,KAAe;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACrF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;AACvE,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentConfig } from './config.js';
2
+ import type { PrivateKey } from './domain.js';
3
+ import { AgentRuntime } from './runner/runtime.js';
4
+ export declare function createAgentRuntime(config: AgentConfig, privateKey: PrivateKey): AgentRuntime;
@@ -0,0 +1,25 @@
1
+ import { createPublicClient, createWalletClient, defineChain, http } from 'viem';
2
+ import { privateKeyToAccount } from 'viem/accounts';
3
+ import { AgentIndexerClient } from './data/indexer-client.js';
4
+ import { AgentRpcReader } from './data/rpc-reader.js';
5
+ import { FileAuditLog } from './runner/audit-store.js';
6
+ import { FileRuntimeState } from './runner/file-state.js';
7
+ import { AgentRuntime } from './runner/runtime.js';
8
+ import { TransactionExecutor } from './runner/transaction-executor.js';
9
+ import { FileWriterLock } from './runner/writer-lock.js';
10
+ export function createAgentRuntime(config, privateKey) {
11
+ const account = privateKeyToAccount(privateKey);
12
+ const chain = defineChain({
13
+ id: config.network.chainId,
14
+ name: config.network.name,
15
+ nativeCurrency: { name: 'G', symbol: 'G', decimals: 18 },
16
+ rpcUrls: { default: { http: [config.network.rpcUrl] } },
17
+ });
18
+ const publicClient = createPublicClient({ chain, transport: http(config.network.rpcUrl) });
19
+ const walletClient = createWalletClient({ account, chain, transport: http(config.network.rpcUrl) });
20
+ const indexer = new AgentIndexerClient(config.network.indexerUrl);
21
+ const rpc = new AgentRpcReader(publicClient, config.network.chainId, config.network.routerAddress);
22
+ const executor = new TransactionExecutor(account.address.toLowerCase(), rpc, indexer, publicClient, walletClient, config.network.confirmations, config.runner.indexingTimeoutMs, new FileWriterLock(`${config.statePath}.writer.lock`));
23
+ return new AgentRuntime(config, account.address.toLowerCase(), indexer, rpc, executor, new FileAuditLog(config.auditPath), new FileRuntimeState(config.statePath));
24
+ }
25
+ //# sourceMappingURL=factory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAA2B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAwD,MAAM,kCAAkC,CAAC;AAC7H,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,UAAU,kBAAkB,CAAC,MAAmB,EAAE,UAAsB;IAC5E,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,WAAW,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;QAC1B,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;QACzB,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE;QACxD,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE;KACxD,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,IAAI,cAAc,CAC5B,YAA6C,EAC7C,MAAM,CAAC,OAAO,CAAC,OAAO,EACtB,MAAM,CAAC,OAAO,CAAC,aAAa,CAC7B,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CACtC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAmB,EAC9C,GAAG,EACH,OAAO,EACP,YAA+C,EAC/C,YAA+C,EAC/C,MAAM,CAAC,OAAO,CAAC,aAAa,EAC5B,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAC/B,IAAI,cAAc,CAAC,GAAG,MAAM,CAAC,SAAS,cAAc,CAAC,CACtD,CAAC;IACF,OAAO,IAAI,YAAY,CACrB,MAAM,EACN,OAAO,CAAC,OAAO,CAAC,WAAW,EAAmB,EAC9C,OAAO,EACP,GAAG,EACH,QAAQ,EACR,IAAI,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,EAClC,IAAI,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CACvC,CAAC;AACJ,CAAC"}
package/dist/fs.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ export declare function atomicWritePrivateFile(path: string, contents: string): Promise<void>;
2
+ export declare function createPrivateFile(path: string, contents: string): Promise<void>;
3
+ export declare function appendPrivateFile(path: string, contents: string): Promise<void>;
package/dist/fs.js ADDED
@@ -0,0 +1,35 @@
1
+ import { chmod, mkdir, open, rename, writeFile } from 'node:fs/promises';
2
+ import { dirname } from 'node:path';
3
+ import { randomUUID } from 'node:crypto';
4
+ export async function atomicWritePrivateFile(path, contents) {
5
+ await mkdir(dirname(path), { recursive: true, mode: 0o700 });
6
+ const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
7
+ const handle = await open(temporary, 'wx', 0o600);
8
+ try {
9
+ await handle.writeFile(contents, 'utf8');
10
+ await handle.sync();
11
+ }
12
+ finally {
13
+ await handle.close();
14
+ }
15
+ await rename(temporary, path);
16
+ await chmod(path, 0o600);
17
+ }
18
+ export async function createPrivateFile(path, contents) {
19
+ await mkdir(dirname(path), { recursive: true, mode: 0o700 });
20
+ const handle = await open(path, 'wx', 0o600);
21
+ try {
22
+ await handle.writeFile(contents, 'utf8');
23
+ await handle.sync();
24
+ }
25
+ finally {
26
+ await handle.close();
27
+ }
28
+ await chmod(path, 0o600);
29
+ }
30
+ export async function appendPrivateFile(path, contents) {
31
+ await mkdir(dirname(path), { recursive: true, mode: 0o700 });
32
+ await writeFile(path, contents, { encoding: 'utf8', flag: 'a', mode: 0o600 });
33
+ await chmod(path, 0o600);
34
+ }
35
+ //# sourceMappingURL=fs.js.map
package/dist/fs.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,QAAgB;IACzE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IACpE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IACpE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9E,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC"}