agent-docs 1.0.2 → 1.2.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.
package/PLAN.md CHANGED
@@ -11,8 +11,8 @@ AI agent instruction documents ("docs") for AI-enabled IDEs.
11
11
  - **Primary contents**: Markdown documentation in `docs/`
12
12
  - **Code formatting**: Prettier (via `pnpm format` / `pnpm format:check`)
13
13
  - **CI**: GitHub Actions workflow that runs `pnpm format:check` on push/PR
14
- - **Postinstall script**: `postinstall.mjs` that creates symlinks/junctions to
15
- `docs/` in consuming projects
14
+ - **Postinstall script**: `postinstall.mjs` that copies the `docs/` directory to
15
+ consuming projects if they don't already have one
16
16
  - **AI Agent Guidance**: `.cursor/plans/` contains structured workflows and
17
17
  instructions for AI coding assistants
18
18
  - **IDE Rules**: `.cursor/rules/` contains agent rules for Cursor IDE
@@ -52,19 +52,15 @@ The README.md should contain:
52
52
  - When `agent-docs` is installed into another project, a `postinstall`
53
53
  script will run in the consuming project.
54
54
  - If the consuming project does **not** already have a `docs/`
55
- directory, the script will create a single symlink/junction from the
56
- consuming project's `docs/` directory to this package's `docs/`
57
- directory:
58
- - On Unix/macOS, a directory symlink is created
59
- - On Windows, a junction is created
55
+ directory, the script will copy this package's `docs/` directory to
56
+ the consuming project's root directory.
60
57
  - If the consuming project **already has** a `docs/` directory, the
61
- script does nothing and you can instead manage your own docs layout.
62
- - Optional manual instructions for symlinking (Unix/macOS) or junction
63
- linking (Windows) if you prefer not to rely on `postinstall`, or need a
64
- custom layout:
65
- - Individual files from the `docs/` folder to the root of the actual
66
- project, OR
67
- - The entire `docs` folder to the root of the actual project
58
+ script does nothing, and your existing docs layout is left unchanged.
59
+ - Optional manual instructions for copying files if you prefer not to rely
60
+ on `postinstall`, or need a custom layout:
61
+ - Copy individual files from the `docs/` folder to the root of the
62
+ actual project, OR
63
+ - Copy the entire `docs` folder to the root of the actual project
68
64
  - Explanation of how to update IDE agent rules (e.g., Cursor's
69
65
  `.cursor/rules/` or similar) to reference the linked docs using
70
66
  `@filename` syntax or relative paths, so the AI agent can access the
@@ -369,13 +365,14 @@ Add any other context, examples, or screenshots about the feature request here.
369
365
  ### `postinstall.mjs`
370
366
 
371
367
  The postinstall script that runs when this package is installed in another
372
- project. It should copy this package's `docs/` directory to the consuming
373
- project's root directory, but only if the consuming project doesn't already have
374
- a `docs/` directory.
368
+ project. It copies this package's `docs/` directory to the consuming project's
369
+ root directory, but only if the consuming project doesn't already have a `docs/`
370
+ directory. The script uses file copying instead of symlinks/junctions for better
371
+ cross-platform reliability.
375
372
 
376
373
  ```js
377
374
  // postinstall.mjs
378
- // Implementation details for creating cross-platform symlinks/junctions
375
+ // Implementation details for copying docs directory cross-platform
379
376
  ```
380
377
 
381
378
  ### `prettier.config.js`
@@ -610,7 +607,7 @@ Standard MIT license with copyright holder: starch-uk
610
607
 
611
608
  - Name: `agent-docs`
612
609
  - Type: module
613
- - Version: `1.0.0`
610
+ - Version: `1.1.0` (current)
614
611
  - Scripts: `format`, `format:fix`, `format:check`, `postinstall`
615
612
  - Dev dependencies: `prettier`
616
613
  - Engines: Node.js >= 20.0.0
@@ -640,16 +637,16 @@ The plan should:
640
637
  - **Major version bump** - Sections replaced or removed from a file compared
641
638
  to the version in the latest commit in the `main` branch
642
639
  - Document that the project as a whole maintains a version in `package.json`
643
- (currently `1.0.0`)
640
+ (currently `1.1.0`)
644
641
  - Explain that changes to docs files should increment the project version
645
642
  (patch/minor/major based on the greatest change in any docs file) compared to
646
643
  the version in the latest commit in the `main` branch
647
644
  - **Document initialization of existing docs:** The existing documentation files
648
- in the `docs/` directory (APEXANNOTATIONS.md, APEXDOC.md, CODEANALYZER.md,
649
- CPD.md, ESLINT.md, ESLINTJSDOC.md, FLOWSCANNER.md, GRAPHBINARY.md,
650
- GRAPHENGINE.md, GRAPHML.md, GRAPHSON.md, GREMLIN.md, GRYO.md, HUSKY.md,
651
- JEST30.md, JORJE.md, JSDOC.md, PMD.md, PMDAPEXAST.md, PMDSUPPRESSWARNINGS.md,
652
- PNPM.md, PRETTIER.md, PRETTIERAPEX.md, REGEX.md, RETIREJS.md, SFCLI.md,
645
+ in the `docs/` directory (A4DRULES.md, A4DWORKFLOWS.md, APEXANNOTATIONS.md,
646
+ APEXDOC.md, CML.md, CODEANALYZER.md, CONTEXTDEFINITIONS.md, ESLINT.md,
647
+ ESLINTJSDOC.md, FIELDSERVICE.md, GRAPHBINARY.md, GRAPHENGINE.md, GRAPHML.md,
648
+ GRAPHSON.md, GREMLIN.md, GRYO.md, HUSKY.md, JEST.md, JORJE.md, JSDOC.md,
649
+ PMD.md, PNPM.md, PRETTIER.md, PRETTIERAPEX.md, REVENUETRANSACTIONMANAGEMENT.md,
653
650
  TINKERPOP.md, VITEST.md, XPATH31.md) need to be initialized with version
654
651
  `1.0.0` (or appropriate version based on their current state) when the
655
652
  versioning system is first implemented. These existing docs will be tracked
package/README.md CHANGED
@@ -76,6 +76,8 @@ with any technology.
76
76
  The `docs/` directory contains generated documentation files. Each doc follows a
77
77
  structured format optimized for AI agent consumption:
78
78
 
79
+ - **[A4DRULES.md](docs/A4DRULES.md)** - Agentforce Rules Reference
80
+ - **[A4DWORKFLOWS.md](docs/A4DWORKFLOWS.md)** - Agentforce Workflows reference
79
81
  - **[APEXANNOTATIONS.md](docs/APEXANNOTATIONS.md)** - Apex annotations reference
80
82
  - **[APEXDOC.md](docs/APEXDOC.md)** - ApexDoc documentation tool reference
81
83
  - **[CML.md](docs/CML.md)** - Constraint Modeling Language (CML) reference for
@@ -109,10 +111,58 @@ structured format optimized for AI agent consumption:
109
111
  - **[TINKERPOP.md](docs/TINKERPOP.md)** - Apache TinkerPop graph computing
110
112
  framework reference
111
113
  - **[VITEST.md](docs/VITEST.md)** - Vitest testing framework reference
112
- - **[CODEANALYZER.md#vs-code-integration](docs/CODEANALYZER.md#vs-code-integration)** -
113
- VS Code editor integration
114
114
  - **[XPATH31.md](docs/XPATH31.md)** - XPath 3.1 query language reference
115
115
 
116
+ ## Usage
117
+
118
+ ### Creating and Maintaining Docs
119
+
120
+ To create new documentation files:
121
+
122
+ 1. **Create a new markdown file** in the `docs/` directory following the naming
123
+ convention:
124
+ - Uppercase, no spaces, no dots
125
+ - Version numbers become part of the name (e.g., "XPath 3.1" → `XPATH31.md`)
126
+ - Remove redundant words like "plugin" when they appear between other words
127
+ (e.g., "prettier-plugin-apex" → `PRETTIERAPEX.md`)
128
+
129
+ 2. **Follow the structured format** optimized for AI agent consumption:
130
+ - Overview section with brief context
131
+ - Core Concepts / Key Features (bulleted lists)
132
+ - Configuration / Setup (tables when possible)
133
+ - Usage / Examples (minimal, essential code only)
134
+ - API Reference (condensed, often in tables)
135
+ - Patterns & Best Practices
136
+ - Important Notes (critical gotchas, limitations)
137
+
138
+ 3. **Apply optimization guidelines**:
139
+ - Keep token count low - be terse but precise
140
+ - Use bullet points over prose for scannability
141
+ - Prefer tables for structured data (config options, APIs, properties)
142
+ - Include code snippets only when essential
143
+ - Cross-reference related docs using `[Name](FILENAME.md)` format
144
+ - Include a document in a prompt or rule with @FILENAME.md
145
+
146
+ ### AI Agent Guidance
147
+
148
+ This repository includes AI Agent Guidance files in `.cursor/plans/` that
149
+ provide structured instructions and workflows for AI coding assistants (like
150
+ Cursor's Agent). These plan files document processes, best practices, and
151
+ step-by-step workflows for various tasks, making them accessible to AI agents
152
+ through the `.cursor/plans/` directory structure.
153
+
154
+ When AI agents need guidance on how to perform specific tasks or follow certain
155
+ workflows, they can reference these plan files to understand the expected
156
+ process and provide accurate assistance. Key plan files include:
157
+
158
+ - **VERSIONING.md** - Semantic versioning rules and workflows for documentation
159
+ files
160
+ - **OPTIMISE.md** - Strategies and best practices for maintaining low token
161
+ counts and efficient documentation formats
162
+
163
+ These plans are used by AI-powered IDEs to optimize docs and maintain
164
+ consistency across the documentation set.
165
+
116
166
  ## Contributing
117
167
 
118
168
  See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on contributing to this
@@ -0,0 +1,145 @@
1
+ # Agentforce Rules Reference
2
+
3
+ > **Version**: 1.0.0
4
+
5
+ Purpose
6
+
7
+ - Provide persistent system‑level guidance Agentforce follows during Salesforce
8
+ development.
9
+ - Enforce coding, metadata, org and team conventions across sessions.
10
+
11
+ Key concepts
12
+
13
+ - Rules are persistent instructions that influence Agentforce behavior.
14
+ - Two scopes:
15
+ - Global — companywide standards applied to all projects.
16
+ - Workspace — project/org specific; stored in the project’s .a4drules
17
+ folder.
18
+ - Out‑of‑the‑box global rules exist and can be toggled; shipped rules may be
19
+ overwritten by extension updates.
20
+
21
+ Where to manage
22
+
23
+ - Open Rules & Workflows (justice icon) in Agentforce chat.
24
+ - Create: click + in Rules tab or use `/newrule` in chat.
25
+ - Popover UI: view active rules, enable/disable, add, delete.
26
+ - Workspace rules: project/.a4drules. Global rules: OS‑dependent location.
27
+
28
+ Minimal file template (low‑token)
29
+
30
+ ```text
31
+ # Rule: [Name]
32
+
33
+ Description: [one-line purpose]
34
+
35
+ Applies to: `[file pattern]`
36
+
37
+ Guidelines:
38
+ - [short guideline 1]
39
+ - [short guideline 2]
40
+ ```
41
+
42
+ Rule design patterns
43
+
44
+ - Scope: choose Global for org‑wide policies (naming, security) or Workspace for
45
+ repo/org specifics.
46
+ - One file type per rule when possible to reduce ambiguity.
47
+ - Keep guidelines short, precise, and actionable (3–6 lines is ideal).
48
+ - Version‑gate rules for fields/features that require a minimum API version.
49
+
50
+ Validation checklist pattern (use inside rules)
51
+
52
+ - File suffix & location (e.g., `folder/*.ext`, include generated meta filenames
53
+ like `*.ext-meta.xml`).
54
+ - Required fields present and follow naming/format rules.
55
+ - Mutually exclusive fields: only one of a defined set is present.
56
+ - Enumerations: value belongs to allowed list.
57
+ - Numeric fields: in allowed range and type (int/float).
58
+ - Cross‑field constraints (e.g., boolean toggle requires another field match).
59
+ - API version: ensure package API supports any fields used.
60
+ - Manifest behavior: wildcard support and retrieval side effects.
61
+
62
+ Common guideline examples (generic)
63
+
64
+ - File naming & location
65
+ - Suffix must match the metadata type (e.g., `.ext` and optionally
66
+ `.ext-meta.xml`) and files stored in the corresponding folder.
67
+
68
+ - Identity / fullName rules
69
+ - fullName must use only letters, numbers and underscores; start with a
70
+ letter; no spaces; not end with `_`; not contain `__`; unique within
71
+ package.
72
+
73
+ - Exclusive content fields
74
+ - Exactly one of [fieldA, fieldB, fieldC, fieldD] may be set. Enforce count
75
+ == 1.
76
+
77
+ - Required / conditional fields
78
+ - FieldX is required.
79
+ - If FieldY = true then FieldZ must equal the related resource name.
80
+ - If FieldType ∈ {type1, type2} then NumericHeight must be present and > 0.
81
+
82
+ - Enumerations & presets
83
+ - Validate enumerated fields against the allowed list (store the list
84
+ centrally in the rule).
85
+
86
+ - API gating
87
+ - Only allow fields introduced in API ≥ N when package.xml version >= N.
88
+
89
+ - Manifest & retrieval
90
+ - Support for wildcard (\*) in package.xml — note older API versions may
91
+ behave differently.
92
+ - Retrieving a component can cause related Profile/PermissionSet entries to
93
+ include references; warn about side effects.
94
+
95
+ Example minimal templates
96
+
97
+ - Generic metadata file template
98
+
99
+ ```xml
100
+ <MetadataType xmlns="http://soap.sforce.com/2006/04/metadata">
101
+ <fullName>MyResource</fullName>
102
+ <requiredField>value</requiredField>
103
+ <optionalField>value</optionalField>
104
+ </MetadataType>
105
+ ```
106
+
107
+ - Example rule pseudocode checks
108
+
109
+ ```text
110
+ # Rule: SingleContentField
111
+
112
+ Description: Ensure exactly one content source is defined.
113
+
114
+ Applies to: `**/*.ext`
115
+
116
+ Guidelines:
117
+ - Count([fieldA, fieldB, fieldC, fieldD]) == 1
118
+ - If fieldC set -> ensure frameHeight is present and integer > 0
119
+ - Package API version must be >= 14 when using iconField
120
+ ```
121
+
122
+ Best practices
123
+
124
+ - Make rules atomic and single‑purpose to simplify enforcement and debugging.
125
+ - Prefer short lines and plain tokens to keep rules compact for AI processing.
126
+ - Store enumerations centrally to avoid duplication and speed validation.
127
+ - Version‑gate rules for fields that depend on API releases.
128
+ - Test rule behavior by toggling and running typical retrieve/deploy scenarios.
129
+ - Review and update rules whenever package/API versions or team conventions
130
+ change.
131
+
132
+ Rule lifecycle checklist
133
+
134
+ - Create: Name + one-line Description + Applies pattern.
135
+ - Add 3–6 precise Guidelines (format/validators/version gates).
136
+ - Save to workspace .a4drules or global rules UI.
137
+ - Enable and test with representative metadata files and package.xml.
138
+
139
+ Usage notes for agents
140
+
141
+ - Apply rules as filters during generation and validation steps.
142
+ - Prefer minimal, deterministic responses based on active rules.
143
+ - When multiple rules conflict, enforce Global rules last modified earlier than
144
+ Workspace (or use a defined precedence ordering).
145
+ - Emit succinct validation errors with line/field hints to aid quick fixes.
@@ -0,0 +1,121 @@
1
+ # Agentforce Workflows — Agent Guide
2
+
3
+ > **Version**: 1.0.0
4
+
5
+ ## Overview
6
+
7
+ Workflows are reusable `.md` files defining multi-step Salesforce dev tasks. Invoke with `/[workflow-name.md]` in chat.
8
+
9
+ **Benefits:** Automation, consistency, error reduction, time savings, team sharing.
10
+
11
+ ---
12
+
13
+ ## Creating & Managing
14
+
15
+ | Action | Method |
16
+ |--------|--------|
17
+ | Access | Click **Rules & Workflows** (justice icon) in chat |
18
+ | Scope | Choose **Global** or **Workspace** workflows |
19
+ | Create | Click **+** |
20
+ | Storage | Workspace: `.a4drules/workflows/` folder |
21
+
22
+ Interface allows: view active workflows, toggle on/off, add/delete.
23
+
24
+ ---
25
+
26
+ ## Workflow Capabilities
27
+
28
+ - **Built-in tools:** `ask_followup_question`, `read_file`, `search_files`, `new_task`
29
+ - **CLI tools:** `sf` (Salesforce CLI), `git`
30
+ - **External:** MCP tool calls
31
+ - **Chaining:** Sequential action execution
32
+
33
+ ---
34
+
35
+ ## Common Workflow Types
36
+
37
+ | Type | Purpose |
38
+ |------|---------|
39
+ | Deployment | Deploy/validate components across orgs |
40
+ | Testing | Run test suites, analyze results |
41
+ | Release | Package, validate, deploy releases |
42
+ | Component | Create/test/deploy Lightning components |
43
+ | Integration | Set up/validate external integrations |
44
+
45
+ ---
46
+
47
+ ## Example: `salesforce-deploy.md`
48
+
49
+ ```text
50
+ You have access to the `sf` terminal command. Deploy components following this process:
51
+
52
+ 1. **Gather Info**
53
+ <ask_followup_question>
54
+ <question>Which components to deploy and to which org?</question>
55
+ <options>["Specific files/folders", "All local changes", "Specific metadata types"]</options>
56
+ </ask_followup_question>
57
+
58
+ sf org display --target-org <target-org>
59
+
60
+ 2. **Pre-Deployment Validation**
61
+ sf project retrieve start --dry-run --target-org <target-org>
62
+ sf apex test run --code-coverage --result-format human
63
+ sf project deploy start --dry-run --target-org <target-org>
64
+
65
+ 3. **Confirm**
66
+ <ask_followup_question>
67
+ <question>Validation complete. Proceed with deployment?</question>
68
+ <options>["Yes, deploy now", "No, make changes first", "Show details"]</options>
69
+ </ask_followup_question>
70
+
71
+ 4. **Execute**
72
+ sf project deploy start --target-org <target-org>
73
+ sf project deploy report --target-org <target-org>
74
+
75
+ 5. **Post-Validation**
76
+ sf apex test run --target-org <target-org> --code-coverage --result-format human
77
+ ```
78
+
79
+ ---
80
+
81
+ ## SF CLI Quick Reference
82
+
83
+ ### Org Commands
84
+ ```bash
85
+ sf org list # List authorized orgs
86
+ sf org display --target-org <alias> # Display org info
87
+ sf config set target-org <alias> # Set default org
88
+ ```
89
+
90
+ ### Deployment
91
+ ```bash
92
+ sf project deploy start --target-org <alias> # Deploy
93
+ sf project deploy start --dry-run --target-org <alias> # Validate only
94
+ sf project deploy report --target-org <alias> # Check status
95
+ sf project retrieve start --target-org <alias> # Retrieve metadata
96
+ ```
97
+
98
+ ### Testing
99
+ ```bash
100
+ sf apex test run --target-org <alias> --code-coverage --result-format human
101
+ sf apex test run --class-names "Test1,Test2" --target-org <alias>
102
+ sf apex test report --target-org <alias>
103
+ ```
104
+
105
+ ### Data
106
+ ```bash
107
+ sf data query --query "SELECT Id FROM Account LIMIT 10" --target-org <alias>
108
+ sf data import tree --plan data/plan.json --target-org <alias>
109
+ sf data export tree --query "SELECT Id FROM Account" --target-org <alias>
110
+ ```
111
+
112
+ ---
113
+
114
+ ## Custom Workflow Ideas
115
+
116
+ | Workflow | Key Steps |
117
+ |----------|-----------|
118
+ | **Release** | Gather merged changes → Build changelog → Bump version → Create/validate package |
119
+ | **New Component** | Create folder structure → Generate boilerplate files → Set up Jest tests → Deploy to dev |
120
+ | **Integration Test** | Validate credentials → Test endpoints → Check error handling → Generate reports |
121
+ | **Code Quality** | Run PMD analysis → Check accessibility → Validate naming → Generate reports |
@@ -1,6 +1,6 @@
1
1
  # Salesforce Revenue Cloud: Transaction Management
2
2
 
3
- > v1.0.1 | Editions: Enterprise, Unlimited, Developer (Lightning Experience)
3
+ > v1.0.2 | Editions: Enterprise, Unlimited, Developer (Lightning Experience)
4
4
 
5
5
  ## Quick Reference
6
6
 
@@ -106,12 +106,14 @@ configuration.
106
106
  | `RecordResource` | Create record object from sales transaction field values |
107
107
  | `RecordWithReferenceRequest` | Associate record object with reference identifier |
108
108
 
109
- **ConfigurationOptionsInput Properties:** | Property | Type | Description |
110
- |----------|------|-------------| | `addDefaultConfiguration` | Boolean |
111
- Auto-add default configuration (bundle/product attributes) | |
112
- `executeConfigurationRules` | Boolean | Require adherence to configuration rules
113
- | | `validateAmendRenewCancel` | Boolean | Run amend/renew/cancel validations |
114
- | `validateProductCatalog` | Boolean | Validate against product catalog |
109
+ **ConfigurationOptionsInput Properties:**
110
+
111
+ | Property | Type | Description |
112
+ | --------------------------- | ------- | ---------------------------------------------------------- |
113
+ | `addDefaultConfiguration` | Boolean | Auto-add default configuration (bundle/product attributes) |
114
+ | `executeConfigurationRules` | Boolean | Require adherence to configuration rules |
115
+ | `validateAmendRenewCancel` | Boolean | Run amend/renew/cancel validations |
116
+ | `validateProductCatalog` | Boolean | Validate against product catalog |
115
117
 
116
118
  **PlaceSalesTransactionExecutor.execute() Parameters:**
117
119
 
@@ -124,34 +126,39 @@ Auto-add default configuration (bundle/product attributes) | |
124
126
  - `catalogRatesPreferenceEnum` (CatalogRatesPreferenceEnum) — Rate card entries
125
127
  preference (optional)
126
128
 
127
- **Enums:** | Enum | Values | Description | |------|--------|-------------| |
128
- `CatalogRatesPreferenceEnum` | `Fetch`, `Skip` | Rate card entries for
129
- usage-based selling | | `ConfigurationExecutionEnum` | `RunAndAllowErrors`,
130
- `RunAndBlockErrors`, `Skip` | Configuration execution mode | |
131
- `PricingPreferenceEnum` | `Force`, `Skip`, `System` | Pricing preference during
132
- transaction |
129
+ **Enums:**
130
+
131
+ | Enum | Values | Description |
132
+ | ---------------------------- | ------------------------------------------------ | ----------------------------------------- |
133
+ | `CatalogRatesPreferenceEnum` | `Fetch`, `Skip` | Rate card entries for usage-based selling |
134
+ | `ConfigurationExecutionEnum` | `RunAndAllowErrors`, `RunAndBlockErrors`, `Skip` | Configuration execution mode |
135
+ | `PricingPreferenceEnum` | `Force`, `Skip`, `System` | Pricing preference during transaction |
133
136
 
134
137
  ### CommerceTax
135
138
 
136
139
  Manages communication between Salesforce and external tax engines.
137
140
 
138
- **Classes:** | Class | Purpose | |-------|---------| | `AddressesResponse` |
139
- Ship To, Ship From, Sold To address responses | | `AmountDetailsResponse` | Tax
140
- amount, total with tax, exempt amount | | `CustomTaxAttributesResponse` |
141
- Additional custom tax attributes | | `DocumentCodeRequest` | Document code for
142
- tax calculation | | `ExemptDetailsResponse` | Exemption ID, number, reason | |
143
- `ImpositionResponse` | Tax imposition details (id, name, type, subType) | |
144
- `JurisdictionResponse` | Tax jurisdiction (country, region, state, level) | |
145
- `LineItemResponse` | Line item tax calculation results | |
146
- `LineTaxAddressesRequest` | Per-line-item addresses for tax calculation | |
147
- `RuleDetailsResponse` | Tax rules used (nonTaxableRuleId, rateRuleId,
148
- rateSourceId) | | `TaxAddressesRequest` | Ship From/To, Sold To, Bill To
149
- addresses | | `TaxAddressRequest` | Address details (city, country, state,
150
- postalCode, lat/long) | | `TaxApiException` | Tax calculation exceptions | |
151
- `TaxCustomerDetailsRequest` | Customer details (accountId, code,
152
- exemptionNo/Reason) | | `TaxDetailsResponse` | Tax calculation details per line
153
- | | `TaxEngineRequest` | Tax engine request payload | | `TaxEngineResponse` |
154
- Tax engine response |
141
+ **Classes:**
142
+
143
+ | Class | Purpose |
144
+ | ----------------------------- | ------------------------------------------------------------ |
145
+ | `AddressesResponse` | Ship To, Ship From, Sold To address responses |
146
+ | `AmountDetailsResponse` | Tax amount, total with tax, exempt amount |
147
+ | `CustomTaxAttributesResponse` | Additional custom tax attributes |
148
+ | `DocumentCodeRequest` | Document code for tax calculation |
149
+ | `ExemptDetailsResponse` | Exemption ID, number, reason |
150
+ | `ImpositionResponse` | Tax imposition details (id, name, type, subType) |
151
+ | `JurisdictionResponse` | Tax jurisdiction (country, region, state, level) |
152
+ | `LineItemResponse` | Line item tax calculation results |
153
+ | `LineTaxAddressesRequest` | Per-line-item addresses for tax calculation |
154
+ | `RuleDetailsResponse` | Tax rules used (nonTaxableRuleId, rateRuleId, rateSourceId) |
155
+ | `TaxAddressesRequest` | Ship From/To, Sold To, Bill To addresses |
156
+ | `TaxAddressRequest` | Address details (city, country, state, postalCode, lat/long) |
157
+ | `TaxApiException` | Tax calculation exceptions |
158
+ | `TaxCustomerDetailsRequest` | Customer details (accountId, code, exemptionNo/Reason) |
159
+ | `TaxDetailsResponse` | Tax calculation details per line |
160
+ | `TaxEngineRequest` | Tax engine request payload |
161
+ | `TaxEngineResponse` | Tax engine response |
155
162
 
156
163
  **TaxAddressRequest Properties:** `city`, `country`, `countryCode`, `latitude`,
157
164
  `locationCode`, `longitude`, `postalCode`, `state`, `stateCode`, `street`
@@ -169,10 +176,13 @@ Tax engine response |
169
176
  - `RecordResource` — Create record from quote field values
170
177
  - `RecordWithReferenceRequest` — Associate record with reference ID
171
178
 
172
- **Enums:** | Enum | Values | |------|--------| | `CatalogRatesPreferenceEnum` |
173
- `Fetch`, `Skip` | | `ConfigurationInputEnum` | `RunAndAllowErrors`,
174
- `RunAndBlockErrors`, `Skip` | | `PricingPreferenceEnum` | `Force`, `Skip`,
175
- `System` |
179
+ **Enums:**
180
+
181
+ | Enum | Values |
182
+ | ---------------------------- | ------------------------------------------------ |
183
+ | `CatalogRatesPreferenceEnum` | `Fetch`, `Skip` |
184
+ | `ConfigurationInputEnum` | `RunAndAllowErrors`, `RunAndBlockErrors`, `Skip` |
185
+ | `PricingPreferenceEnum` | `Force`, `Skip`, `System` |
176
186
 
177
187
  ---
178
188
 
package/docs/XPATH31.md CHANGED
@@ -1,4 +1,3 @@
1
- ````markdown
2
1
  # XPath 3.1 Reference
3
2
 
4
3
  > **Version**: 1.0.0
@@ -207,7 +206,3 @@ $seq ! (./child/@attr) # apply to each, flatten
207
206
  - Document order preserved
208
207
  - Namespaces: prefixes or `Q{uri}local`
209
208
  - Errors: `try/catch` in 3.1
210
-
211
- ```
212
-
213
- ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-docs",
3
- "version": "1.0.2",
3
+ "version": "1.2.0",
4
4
  "type": "module",
5
5
  "description": "A tool for generating reusable, low-token AI agent instruction documents",
6
6
  "keywords": [