@kana-ai/edgar-ext-tinyfish 0.0.0-stage → 0.1.1
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/LICENSE +202 -0
- package/README.md +106 -2
- package/dist/src/api/client.d.ts +27 -0
- package/dist/src/api/client.js +53 -0
- package/dist/src/api/failures.d.ts +14 -0
- package/dist/src/api/failures.js +87 -0
- package/dist/src/index.d.ts +81 -0
- package/dist/src/index.js +15 -0
- package/dist/src/schemas/config.d.ts +6 -0
- package/dist/src/schemas/config.js +6 -0
- package/dist/src/schemas/tinyfish.d.ts +99 -0
- package/dist/src/schemas/tinyfish.js +60 -0
- package/dist/src/schemas/tools.d.ts +110 -0
- package/dist/src/schemas/tools.js +66 -0
- package/dist/src/tools/agent.d.ts +56 -0
- package/dist/src/tools/agent.js +129 -0
- package/dist/src/tools/web.d.ts +30 -0
- package/dist/src/tools/web.js +51 -0
- package/edgar-extension.json +107 -0
- package/package.json +41 -3
- package/schemas/cancel_run.in.json +11 -0
- package/schemas/cancel_run.out.json +16 -0
- package/schemas/config.json +17 -0
- package/schemas/fetch.in.json +16 -0
- package/schemas/fetch.out.json +46 -0
- package/schemas/run.in.json +27 -0
- package/schemas/run.out.json +16 -0
- package/schemas/run_state.in.json +11 -0
- package/schemas/run_state.out.json +52 -0
- package/schemas/search.in.json +16 -0
- package/schemas/search.out.json +33 -0
- package/schemas/start_run.in.json +27 -0
- package/schemas/start_run.out.json +10 -0
- package/schemas/step_screenshot.in.json +15 -0
- package/schemas/step_screenshot.out.json +15 -0
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
{
|
|
2
|
+
"contract": 1,
|
|
3
|
+
"name": "tinyfish",
|
|
4
|
+
"version": "0.1.1",
|
|
5
|
+
"config_schema": "schemas/config.json",
|
|
6
|
+
"secrets": [
|
|
7
|
+
{
|
|
8
|
+
"name": "TINYFISH_API_KEY",
|
|
9
|
+
"hosts": ["agent.tinyfish.ai", "api.search.tinyfish.ai", "api.fetch.tinyfish.ai"]
|
|
10
|
+
}
|
|
11
|
+
],
|
|
12
|
+
"capabilities": [
|
|
13
|
+
"network:agent.tinyfish.ai",
|
|
14
|
+
"network:api.search.tinyfish.ai",
|
|
15
|
+
"network:api.fetch.tinyfish.ai"
|
|
16
|
+
],
|
|
17
|
+
"tools": [
|
|
18
|
+
{
|
|
19
|
+
"name": "run",
|
|
20
|
+
"description": "Run a web agent on a goal from a start URL and wait for its result; for runs under about a minute",
|
|
21
|
+
"input_schema": "schemas/run.in.json",
|
|
22
|
+
"output_schema": "schemas/run.out.json",
|
|
23
|
+
"secrets": ["TINYFISH_API_KEY"],
|
|
24
|
+
"capabilities": ["network:agent.tinyfish.ai"],
|
|
25
|
+
"side_effect": true,
|
|
26
|
+
"undo": "none",
|
|
27
|
+
"undo_reason": "a web agent acts on outside websites, and its steps cannot be taken back; cancel_run only stops a started run",
|
|
28
|
+
"approval": "never",
|
|
29
|
+
"disabled": false
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"name": "start_run",
|
|
33
|
+
"description": "Start a web agent run on a goal from a start URL and return its run id at once",
|
|
34
|
+
"input_schema": "schemas/start_run.in.json",
|
|
35
|
+
"output_schema": "schemas/start_run.out.json",
|
|
36
|
+
"secrets": ["TINYFISH_API_KEY"],
|
|
37
|
+
"capabilities": ["network:agent.tinyfish.ai"],
|
|
38
|
+
"side_effect": true,
|
|
39
|
+
"undo": "none",
|
|
40
|
+
"undo_reason": "a web agent acts on outside websites, and its steps cannot be taken back; cancel_run only stops a started run",
|
|
41
|
+
"approval": "never",
|
|
42
|
+
"disabled": false
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "run_state",
|
|
46
|
+
"description": "Read the status, the result and the steps of a web agent run",
|
|
47
|
+
"input_schema": "schemas/run_state.in.json",
|
|
48
|
+
"output_schema": "schemas/run_state.out.json",
|
|
49
|
+
"secrets": ["TINYFISH_API_KEY"],
|
|
50
|
+
"capabilities": ["network:agent.tinyfish.ai"],
|
|
51
|
+
"side_effect": false,
|
|
52
|
+
"approval": "never",
|
|
53
|
+
"disabled": false
|
|
54
|
+
},
|
|
55
|
+
{
|
|
56
|
+
"name": "cancel_run",
|
|
57
|
+
"description": "Stop a started web agent run; a run that already ended keeps its status",
|
|
58
|
+
"input_schema": "schemas/cancel_run.in.json",
|
|
59
|
+
"output_schema": "schemas/cancel_run.out.json",
|
|
60
|
+
"secrets": ["TINYFISH_API_KEY"],
|
|
61
|
+
"capabilities": ["network:agent.tinyfish.ai"],
|
|
62
|
+
"side_effect": false,
|
|
63
|
+
"approval": "never",
|
|
64
|
+
"disabled": false
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"name": "step_screenshot",
|
|
68
|
+
"description": "Check that one step of a run has a screenshot and return its URL, which needs the TinyFish key to open",
|
|
69
|
+
"input_schema": "schemas/step_screenshot.in.json",
|
|
70
|
+
"output_schema": "schemas/step_screenshot.out.json",
|
|
71
|
+
"secrets": ["TINYFISH_API_KEY"],
|
|
72
|
+
"capabilities": ["network:agent.tinyfish.ai"],
|
|
73
|
+
"side_effect": false,
|
|
74
|
+
"approval": "never",
|
|
75
|
+
"disabled": false
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"name": "search",
|
|
79
|
+
"description": "Search the web and return the first results with their title, URL and snippet",
|
|
80
|
+
"input_schema": "schemas/search.in.json",
|
|
81
|
+
"output_schema": "schemas/search.out.json",
|
|
82
|
+
"secrets": ["TINYFISH_API_KEY"],
|
|
83
|
+
"capabilities": ["network:api.search.tinyfish.ai"],
|
|
84
|
+
"side_effect": false,
|
|
85
|
+
"approval": "never",
|
|
86
|
+
"disabled": false
|
|
87
|
+
},
|
|
88
|
+
{
|
|
89
|
+
"name": "fetch",
|
|
90
|
+
"description": "Fetch up to 10 URLs as Markdown; a URL that fails is listed in errors",
|
|
91
|
+
"input_schema": "schemas/fetch.in.json",
|
|
92
|
+
"output_schema": "schemas/fetch.out.json",
|
|
93
|
+
"secrets": ["TINYFISH_API_KEY"],
|
|
94
|
+
"capabilities": ["network:api.fetch.tinyfish.ai"],
|
|
95
|
+
"side_effect": false,
|
|
96
|
+
"approval": "never",
|
|
97
|
+
"disabled": false
|
|
98
|
+
}
|
|
99
|
+
],
|
|
100
|
+
"webhooks": [],
|
|
101
|
+
"workflows": [],
|
|
102
|
+
"roles": [],
|
|
103
|
+
"skills": [],
|
|
104
|
+
"tracker": null,
|
|
105
|
+
"environments": [],
|
|
106
|
+
"hooks": []
|
|
107
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,44 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kana-ai/edgar-ext-tinyfish",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "EDGAR extension for TinyFish: run a web agent on a goal, search the web and fetch pages.",
|
|
5
|
+
"license": "Apache-2.0",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "https://github.com/kana-ai/edgar",
|
|
9
|
+
"directory": "packages/extensions/ext-tinyfish"
|
|
10
|
+
},
|
|
11
|
+
"files": [
|
|
12
|
+
"dist/src",
|
|
13
|
+
"edgar-extension.json",
|
|
14
|
+
"schemas"
|
|
15
|
+
],
|
|
16
|
+
"type": "module",
|
|
17
|
+
"imports": {
|
|
18
|
+
"#*": "./dist/src/*.js"
|
|
19
|
+
},
|
|
20
|
+
"exports": {
|
|
21
|
+
".": "./dist/src/index.js"
|
|
22
|
+
},
|
|
23
|
+
"dependencies": {
|
|
24
|
+
"@kana-ai/edgar-sdk": "0.1.1",
|
|
25
|
+
"zod": "4.6.7"
|
|
26
|
+
},
|
|
27
|
+
"devDependencies": {
|
|
28
|
+
"@kana-ai/edgar-contracts": "0.1.1",
|
|
29
|
+
"@types/node": "24.19.2",
|
|
30
|
+
"ajv": "8.20.0",
|
|
31
|
+
"oxfmt": "0.76.0",
|
|
32
|
+
"oxlint": "1.91.0",
|
|
33
|
+
"oxlint-tsgolint": "7.0.2005",
|
|
34
|
+
"typescript": "7.0.2",
|
|
35
|
+
"undici": "7.30.2"
|
|
36
|
+
},
|
|
37
|
+
"scripts": {
|
|
38
|
+
"build": "edgar-extension-build src/index.ts",
|
|
39
|
+
"check-types": "tsc --noEmit",
|
|
40
|
+
"lint": "oxlint --type-aware --deny-warnings",
|
|
41
|
+
"format:check": "oxfmt --check",
|
|
42
|
+
"test": "node --test"
|
|
43
|
+
}
|
|
6
44
|
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"run_id": {
|
|
6
|
+
"type": "string"
|
|
7
|
+
},
|
|
8
|
+
"status": {
|
|
9
|
+
"type": "string"
|
|
10
|
+
},
|
|
11
|
+
"cancelled": {
|
|
12
|
+
"type": "boolean"
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
"required": ["run_id", "status", "cancelled"]
|
|
16
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"timeout_seconds": {
|
|
6
|
+
"default": 300,
|
|
7
|
+
"type": "integer",
|
|
8
|
+
"exclusiveMinimum": 0,
|
|
9
|
+
"maximum": 9007199254740991
|
|
10
|
+
},
|
|
11
|
+
"capture_screenshots": {
|
|
12
|
+
"default": true,
|
|
13
|
+
"type": "boolean"
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
"additionalProperties": false
|
|
17
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"urls": {
|
|
6
|
+
"minItems": 1,
|
|
7
|
+
"maxItems": 10,
|
|
8
|
+
"type": "array",
|
|
9
|
+
"items": {
|
|
10
|
+
"type": "string",
|
|
11
|
+
"format": "uri"
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
"required": ["urls"]
|
|
16
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"pages": {
|
|
6
|
+
"type": "array",
|
|
7
|
+
"items": {
|
|
8
|
+
"type": "object",
|
|
9
|
+
"properties": {
|
|
10
|
+
"url": {
|
|
11
|
+
"type": "string"
|
|
12
|
+
},
|
|
13
|
+
"final_url": {
|
|
14
|
+
"type": ["string", "null"]
|
|
15
|
+
},
|
|
16
|
+
"title": {
|
|
17
|
+
"type": ["string", "null"]
|
|
18
|
+
},
|
|
19
|
+
"text": {
|
|
20
|
+
"type": ["string", "null"]
|
|
21
|
+
}
|
|
22
|
+
},
|
|
23
|
+
"required": ["url", "final_url", "title", "text"]
|
|
24
|
+
}
|
|
25
|
+
},
|
|
26
|
+
"errors": {
|
|
27
|
+
"type": "array",
|
|
28
|
+
"items": {
|
|
29
|
+
"type": "object",
|
|
30
|
+
"properties": {
|
|
31
|
+
"url": {
|
|
32
|
+
"type": "string"
|
|
33
|
+
},
|
|
34
|
+
"error": {
|
|
35
|
+
"type": "string"
|
|
36
|
+
},
|
|
37
|
+
"status": {
|
|
38
|
+
"type": ["number", "null"]
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
"required": ["url", "error", "status"]
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
},
|
|
45
|
+
"required": ["pages", "errors"]
|
|
46
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"goal": {
|
|
6
|
+
"type": "string",
|
|
7
|
+
"minLength": 1
|
|
8
|
+
},
|
|
9
|
+
"url": {
|
|
10
|
+
"type": "string",
|
|
11
|
+
"format": "uri"
|
|
12
|
+
},
|
|
13
|
+
"output_schema": {
|
|
14
|
+
"type": "object",
|
|
15
|
+
"propertyNames": {
|
|
16
|
+
"type": "string"
|
|
17
|
+
},
|
|
18
|
+
"additionalProperties": {}
|
|
19
|
+
},
|
|
20
|
+
"timeout_seconds": {
|
|
21
|
+
"type": "integer",
|
|
22
|
+
"exclusiveMinimum": 0,
|
|
23
|
+
"maximum": 9007199254740991
|
|
24
|
+
}
|
|
25
|
+
},
|
|
26
|
+
"required": ["goal", "url"]
|
|
27
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"run_id": {
|
|
6
|
+
"type": ["string", "null"]
|
|
7
|
+
},
|
|
8
|
+
"result": {},
|
|
9
|
+
"steps": {
|
|
10
|
+
"type": "integer",
|
|
11
|
+
"minimum": -9007199254740991,
|
|
12
|
+
"maximum": 9007199254740991
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
"required": ["run_id", "result", "steps"]
|
|
16
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"run_id": {
|
|
6
|
+
"type": "string"
|
|
7
|
+
},
|
|
8
|
+
"status": {
|
|
9
|
+
"type": "string",
|
|
10
|
+
"enum": ["PENDING", "RUNNING", "COMPLETED", "FAILED", "CANCELLED"]
|
|
11
|
+
},
|
|
12
|
+
"result": {},
|
|
13
|
+
"error": {
|
|
14
|
+
"anyOf": [
|
|
15
|
+
{
|
|
16
|
+
"type": "object",
|
|
17
|
+
"properties": {
|
|
18
|
+
"category": {
|
|
19
|
+
"type": "string"
|
|
20
|
+
},
|
|
21
|
+
"message": {
|
|
22
|
+
"type": "string"
|
|
23
|
+
}
|
|
24
|
+
},
|
|
25
|
+
"required": ["category", "message"]
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"type": "null"
|
|
29
|
+
}
|
|
30
|
+
]
|
|
31
|
+
},
|
|
32
|
+
"steps": {
|
|
33
|
+
"type": "array",
|
|
34
|
+
"items": {
|
|
35
|
+
"type": "object",
|
|
36
|
+
"properties": {
|
|
37
|
+
"id": {
|
|
38
|
+
"type": "string"
|
|
39
|
+
},
|
|
40
|
+
"status": {
|
|
41
|
+
"type": "string"
|
|
42
|
+
},
|
|
43
|
+
"action": {
|
|
44
|
+
"type": ["string", "null"]
|
|
45
|
+
}
|
|
46
|
+
},
|
|
47
|
+
"required": ["id", "status", "action"]
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
},
|
|
51
|
+
"required": ["run_id", "status", "result", "error", "steps"]
|
|
52
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"query": {
|
|
6
|
+
"type": "string",
|
|
7
|
+
"minLength": 1
|
|
8
|
+
},
|
|
9
|
+
"count": {
|
|
10
|
+
"type": "integer",
|
|
11
|
+
"minimum": 1,
|
|
12
|
+
"maximum": 10
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
"required": ["query"]
|
|
16
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"results": {
|
|
6
|
+
"type": "array",
|
|
7
|
+
"items": {
|
|
8
|
+
"type": "object",
|
|
9
|
+
"properties": {
|
|
10
|
+
"title": {
|
|
11
|
+
"type": "string"
|
|
12
|
+
},
|
|
13
|
+
"url": {
|
|
14
|
+
"type": "string"
|
|
15
|
+
},
|
|
16
|
+
"snippet": {
|
|
17
|
+
"type": "string"
|
|
18
|
+
},
|
|
19
|
+
"site": {
|
|
20
|
+
"type": "string"
|
|
21
|
+
}
|
|
22
|
+
},
|
|
23
|
+
"required": ["title", "url", "snippet", "site"]
|
|
24
|
+
}
|
|
25
|
+
},
|
|
26
|
+
"total": {
|
|
27
|
+
"type": "integer",
|
|
28
|
+
"minimum": -9007199254740991,
|
|
29
|
+
"maximum": 9007199254740991
|
|
30
|
+
}
|
|
31
|
+
},
|
|
32
|
+
"required": ["results", "total"]
|
|
33
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"goal": {
|
|
6
|
+
"type": "string",
|
|
7
|
+
"minLength": 1
|
|
8
|
+
},
|
|
9
|
+
"url": {
|
|
10
|
+
"type": "string",
|
|
11
|
+
"format": "uri"
|
|
12
|
+
},
|
|
13
|
+
"output_schema": {
|
|
14
|
+
"type": "object",
|
|
15
|
+
"propertyNames": {
|
|
16
|
+
"type": "string"
|
|
17
|
+
},
|
|
18
|
+
"additionalProperties": {}
|
|
19
|
+
},
|
|
20
|
+
"timeout_seconds": {
|
|
21
|
+
"type": "integer",
|
|
22
|
+
"exclusiveMinimum": 0,
|
|
23
|
+
"maximum": 9007199254740991
|
|
24
|
+
}
|
|
25
|
+
},
|
|
26
|
+
"required": ["goal", "url"]
|
|
27
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"run_id": {
|
|
6
|
+
"type": "string",
|
|
7
|
+
"minLength": 1
|
|
8
|
+
},
|
|
9
|
+
"step_id": {
|
|
10
|
+
"type": "string",
|
|
11
|
+
"minLength": 1
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"required": ["run_id", "step_id"]
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"url": {
|
|
6
|
+
"type": "string"
|
|
7
|
+
},
|
|
8
|
+
"bytes": {
|
|
9
|
+
"type": "integer",
|
|
10
|
+
"minimum": -9007199254740991,
|
|
11
|
+
"maximum": 9007199254740991
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"required": ["url", "bytes"]
|
|
15
|
+
}
|