@native-marketing/sdk 0.1.1 → 0.2.0

package/README.md

@@ -14,12 +14,21 @@ const accessToken = process.env.CF_AGENT_ACCESS_TOKEN;
 if (!resource || !accessToken) throw new Error('Configure resource-bound OAuth credentials');
 
 await withNativeAgentClient({ resource, accessToken }, async (native) => {
-  const page = await native.findCapabilities({ query: '保存研究结论' });
-  console.log(page);
+  const page = await native.discoverCapabilities({ query: '检查连接状态和当前项目' });
+  const item = page.items[0];
+  if (!item) return; // NO_MATCH applies to the currently authorized catalogue.
+  const exact = await native.describeCapability(item.name, item.schemaSha256);
+  const context = await native.readCapability({
+    name: item.name,
+    expectedSchemaSha256: exact.schemaSha256,
+    arguments: {},
+    delivery: 'ORIGINAL',
+  });
+  console.log(context);
 });
 ```
 
-The server filters discovery using current object, OAuth scopes and business permissions. Read one exact capability definition before constructing its input. Search saved business content with `searchBusiness`; use `getBusinessSummary` for a bounded summary and nextActions. The caller decides whether to continue. Ordinary collaboration and explicitly assigned execution remain separate.
+The server filters discovery using current object, OAuth scopes and business permissions. `discoverCapabilities` uses AGENT_V3 bilingual action/object matching and explicit scoped NO_MATCH. Small results include the exact schema and fingerprint; `describeCapability(name, observedHash)` reuses a verified, bounded connection-local cache or loads the definition on demand. Every execution still checks current authorization and the fingerprint. The existing `findCapabilities` retains its v2 response contract. Search saved business content with `searchBusiness`; use `getBusinessSummary` for a bounded summary and nextActions. Ordinary collaboration and explicitly assigned execution remain separate.
 
 Writes retain exact schema fingerprints, request IDs, human decisions and optimistic concurrency. On `NativeAgentClientError` inspect `code`, `outcome` and `details`. An UNKNOWN outcome is not a rollback: follow the returned original receipt lookup using the same resource and current authorization. Never automatically retry writes, replace the request ID or infer success from the latest document. Refresh current business content separately after recovering the original result.