@knowttl/artium-axi 0.0.11 → 0.0.12

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/README.md CHANGED
@@ -37,7 +37,7 @@ Agents keep a command-line interface with TOON discovery rather than implementin
37
37
  ### Supported pinned tools
38
38
  | Tool | Managed access |
39
39
  | --- | --- |
40
- | Falcon | API client; optional guarded RTR read-only commands |
40
+ | Falcon | API client; see [supported capabilities](#safety) |
41
41
  | Vectra | Token or OAuth; optional allow-listed writes |
42
42
  | Azure | Application identity and resource-token broker |
43
43
  | Microsoft Graph | Application identity; optional allow-listed writes |
@@ -160,9 +160,11 @@ Artium's authenticated setup fetches managed skills; a standalone skill installe
160
160
  All tools start disabled; write access defaults to off.
161
161
  Administrator capability alone grants no tool access; upstream permissions remain an additional boundary.
162
162
 
163
+ Falcon investigation reads include detection lineage, process details and trees, existing sandbox reports, FileVantage changes and device-control policy details.
164
+
163
165
  | Tool | Write capability and unlock |
164
166
  | --- | --- |
165
- | Falcon | Optional guarded RTR execution from the standard read-only command allowlist, with profile narrowing. Host changes, scripts and file transfers remain unavailable. See [Falcon execution setup](docs/runbook.md#falcon-rtr-execution). |
167
+ | Falcon | Separate, off-by-default capabilities for guarded RTR execution and bounded MalQuery exact/fuzzy literal search. RTR retains the standard read-only command allowlist and profile narrowing. Host changes, scripts, hunt and file transfers remain unavailable. See [Falcon execution setup](docs/runbook.md#falcon-rtr-execution). |
166
168
  | LDAP | Fixed read-only. |
167
169
  | Azure | Reviewed resource mutations; administrator `allowWrites: true` plus native command gates. |
168
170
  | Graph, Vectra | Native mutations only with administrator `writes.allowWrites: true` and an explicit operations allow-list, plus native gates. |
@@ -20081,7 +20081,11 @@ var nativeSettingsSchemas = {
20081
20081
  allowWrites: external_exports.boolean(),
20082
20082
  operations: external_exports.array(external_exports.string().min(1).max(256)).min(1).max(64)
20083
20083
  }).optional() }),
20084
- "falcon-axi": external_exports.strictObject({ allowWrites: external_exports.boolean().optional(), rtr: falconRtrSettingsSchema.optional() }),
20084
+ "falcon-axi": external_exports.strictObject({
20085
+ allowWrites: external_exports.boolean().optional(),
20086
+ rtr: falconRtrSettingsSchema.optional(),
20087
+ writes: external_exports.strictObject({ allowWrites: external_exports.boolean(), operations: external_exports.array(external_exports.enum(["rtr run", "malquery search"])).min(1).max(2) }).optional()
20088
+ }),
20085
20089
  "vectra-axi": external_exports.strictObject({ writes: external_exports.strictObject({
20086
20090
  allowWrites: external_exports.boolean(),
20087
20091
  operations: external_exports.array(external_exports.string().min(1).refine((value) => value.trim().length > 0)).min(1)
@@ -20627,7 +20631,7 @@ import { resolve } from "node:path";
20627
20631
  // package.json
20628
20632
  var package_default = {
20629
20633
  name: "artium-axi",
20630
- version: "0.0.11",
20634
+ version: "0.0.12",
20631
20635
  private: true,
20632
20636
  license: "MIT",
20633
20637
  type: "module",
@@ -21041,17 +21045,17 @@ var falcon_axi_default = {
21041
21045
  generatedBy: "scripts/falcon-inventory.mjs",
21042
21046
  tool: "falcon-axi",
21043
21047
  repository: "https://github.com/knowttl/falcon-axi.git",
21044
- tag: "v0.6.0",
21045
- commit: "84017f66e72757a8468992c793b3c1095fe6baa3",
21046
- version: "0.6.0",
21048
+ tag: "v0.7.0",
21049
+ commit: "5b860e4899ab2c0961fe2937e04983fe483bc98f",
21050
+ version: "0.7.0",
21047
21051
  distribution: {
21048
- filename: "falcon_axi-0.6.0-py3-none-any.whl",
21049
- sha256: "88bacab2be710432807678f6c710fc5f8d00eb5b1d44680f3807d64398b23781",
21050
- provenance: "https://pypi.org/integrity/falcon-axi/0.6.0/falcon_axi-0.6.0-py3-none-any.whl/provenance"
21052
+ filename: "falcon_axi-0.7.0-py3-none-any.whl",
21053
+ sha256: "553c37002b9ec499b2aedce4161d7144d104c6b2de7ac78b6b9b5417e4486b7c",
21054
+ provenance: "https://pypi.org/integrity/falcon-axi/0.7.0/falcon_axi-0.7.0-py3-none-any.whl/provenance"
21051
21055
  },
21052
21056
  parser: {
21053
21057
  path: "falcon_axi/cli.py",
21054
- sha256: "d8b94b90440d7c538847a7da5dc8b3daa12fbaee09a400144c70539261ae7ec6",
21058
+ sha256: "ef29404b26da085b96ace7ba1f708e928eb40c7aa99e071807d5003a3421b0cd",
21055
21059
  aliases: {},
21056
21060
  shortFlags: {},
21057
21061
  repeats: "last value wins",
@@ -21240,6 +21244,20 @@ var falcon_axi_default = {
21240
21244
  },
21241
21245
  input: "No file or raw URL input; cursors and queries remain native values"
21242
21246
  },
21247
+ {
21248
+ command: "host usb",
21249
+ flags: {
21250
+ help: "boolean",
21251
+ region: "value",
21252
+ "allow-unknown-origin": "boolean",
21253
+ "member-cid": "value",
21254
+ "no-member-cid": "boolean",
21255
+ config: "value",
21256
+ profile: "value",
21257
+ since: "value"
21258
+ },
21259
+ input: "No file or raw URL input; cursors and queries remain native values"
21260
+ },
21243
21261
  {
21244
21262
  command: "account list",
21245
21263
  flags: {
@@ -21902,6 +21920,151 @@ var falcon_axi_default = {
21902
21920
  },
21903
21921
  input: "No file or raw URL input; cursors and queries remain native values"
21904
21922
  },
21923
+ {
21924
+ command: "process show",
21925
+ flags: {
21926
+ help: "boolean",
21927
+ region: "value",
21928
+ "allow-unknown-origin": "boolean",
21929
+ "member-cid": "value",
21930
+ "no-member-cid": "boolean",
21931
+ config: "value",
21932
+ profile: "value",
21933
+ full: "boolean"
21934
+ },
21935
+ input: "No file or raw URL input; cursors and queries remain native values"
21936
+ },
21937
+ {
21938
+ command: "process tree",
21939
+ flags: {
21940
+ help: "boolean",
21941
+ region: "value",
21942
+ "allow-unknown-origin": "boolean",
21943
+ "member-cid": "value",
21944
+ "no-member-cid": "boolean",
21945
+ config: "value",
21946
+ profile: "value",
21947
+ cursor: "value",
21948
+ full: "boolean"
21949
+ },
21950
+ input: "No file or raw URL input; cursors and queries remain native values"
21951
+ },
21952
+ {
21953
+ command: "sandbox list",
21954
+ flags: {
21955
+ help: "boolean",
21956
+ region: "value",
21957
+ "allow-unknown-origin": "boolean",
21958
+ "member-cid": "value",
21959
+ "no-member-cid": "boolean",
21960
+ config: "value",
21961
+ profile: "value",
21962
+ sha256: "value",
21963
+ filter: "value",
21964
+ limit: "value",
21965
+ cursor: "value"
21966
+ },
21967
+ input: "No file or raw URL input; cursors and queries remain native values"
21968
+ },
21969
+ {
21970
+ command: "sandbox show",
21971
+ flags: {
21972
+ help: "boolean",
21973
+ region: "value",
21974
+ "allow-unknown-origin": "boolean",
21975
+ "member-cid": "value",
21976
+ "no-member-cid": "boolean",
21977
+ config: "value",
21978
+ profile: "value"
21979
+ },
21980
+ input: "No file or raw URL input; cursors and queries remain native values"
21981
+ },
21982
+ {
21983
+ command: "file-change list",
21984
+ flags: {
21985
+ help: "boolean",
21986
+ region: "value",
21987
+ "allow-unknown-origin": "boolean",
21988
+ "member-cid": "value",
21989
+ "no-member-cid": "boolean",
21990
+ config: "value",
21991
+ profile: "value",
21992
+ filter: "value",
21993
+ limit: "value",
21994
+ cursor: "value"
21995
+ },
21996
+ input: "No file or raw URL input; cursors and queries remain native values"
21997
+ },
21998
+ {
21999
+ command: "file-change show",
22000
+ flags: {
22001
+ help: "boolean",
22002
+ region: "value",
22003
+ "allow-unknown-origin": "boolean",
22004
+ "member-cid": "value",
22005
+ "no-member-cid": "boolean",
22006
+ config: "value",
22007
+ profile: "value"
22008
+ },
22009
+ input: "No file or raw URL input; cursors and queries remain native values"
22010
+ },
22011
+ {
22012
+ command: "malquery show",
22013
+ flags: {
22014
+ help: "boolean",
22015
+ region: "value",
22016
+ "allow-unknown-origin": "boolean",
22017
+ "member-cid": "value",
22018
+ "no-member-cid": "boolean",
22019
+ config: "value",
22020
+ profile: "value"
22021
+ },
22022
+ input: "No file or raw URL input; cursors and queries remain native values"
22023
+ },
22024
+ {
22025
+ command: "malquery quota",
22026
+ flags: {
22027
+ help: "boolean",
22028
+ region: "value",
22029
+ "allow-unknown-origin": "boolean",
22030
+ "member-cid": "value",
22031
+ "no-member-cid": "boolean",
22032
+ config: "value",
22033
+ profile: "value"
22034
+ },
22035
+ input: "No file or raw URL input; cursors and queries remain native values"
22036
+ },
22037
+ {
22038
+ command: "malquery search",
22039
+ flags: {
22040
+ help: "boolean",
22041
+ region: "value",
22042
+ "allow-unknown-origin": "boolean",
22043
+ "member-cid": "value",
22044
+ "no-member-cid": "boolean",
22045
+ config: "value",
22046
+ profile: "value",
22047
+ string: "value",
22048
+ hex: "value",
22049
+ fuzzy: "boolean",
22050
+ limit: "value"
22051
+ },
22052
+ input: "No file or raw URL input; cursors and queries remain native values"
22053
+ },
22054
+ {
22055
+ command: "malquery status",
22056
+ flags: {
22057
+ help: "boolean",
22058
+ region: "value",
22059
+ "allow-unknown-origin": "boolean",
22060
+ "member-cid": "value",
22061
+ "no-member-cid": "boolean",
22062
+ config: "value",
22063
+ profile: "value",
22064
+ limit: "value"
22065
+ },
22066
+ input: "No file or raw URL input; cursors and queries remain native values"
22067
+ },
21905
22068
  {
21906
22069
  command: "host-group list",
21907
22070
  flags: {
@@ -21968,6 +22131,20 @@ var falcon_axi_default = {
21968
22131
  },
21969
22132
  input: "No file or raw URL input; cursors and queries remain native values"
21970
22133
  },
22134
+ {
22135
+ command: "policy show",
22136
+ flags: {
22137
+ help: "boolean",
22138
+ region: "value",
22139
+ "allow-unknown-origin": "boolean",
22140
+ "member-cid": "value",
22141
+ "no-member-cid": "boolean",
22142
+ config: "value",
22143
+ profile: "value",
22144
+ type: "value"
22145
+ },
22146
+ input: "No file or raw URL input; cursors and queries remain native values"
22147
+ },
21971
22148
  {
21972
22149
  command: "cloud-asset list",
21973
22150
  flags: {
@@ -22533,7 +22710,7 @@ var falcon_axi_default = {
22533
22710
  temporaryFiles: [
22534
22711
  "falcon-axi/config.json"
22535
22712
  ],
22536
- nativeWrites: "RTR read-only command execution requires host permission, profile opt-in and exact confirmation"
22713
+ nativeWrites: "RTR requires host permission, profile opt-in and exact confirmation; MalQuery exact/fuzzy search requires a separate host capability and MalQuery:write; native read-only guards remain enforced"
22537
22714
  },
22538
22715
  healthRead: [
22539
22716
  "auth",
@@ -22565,6 +22742,10 @@ var falcon_axi_default = {
22565
22742
  "identity",
22566
22743
  "search",
22567
22744
  "ioc",
22745
+ "process",
22746
+ "sandbox",
22747
+ "file-change",
22748
+ "malquery",
22568
22749
  "host-group",
22569
22750
  "policy",
22570
22751
  "cloud-asset",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@knowttl/artium-axi",
3
- "version": "0.0.11",
3
+ "version": "0.0.12",
4
4
  "description": "Client CLI and embedded skill for the Artium managed tools server.",
5
5
  "license": "MIT",
6
6
  "type": "module",